🏫 ElearnON - E-Learning REST API

📌 Project Overview

ElearnON is a REST API built using Spring Boot, PostgreSQL, and JWT authentication for an E-Learning System. It allows students to enroll in courses, instructors to manage content, and provides authentication and role-based access control.

🚀 Features

• ✅ User Authentication & Authorization (Spring Security + JWT)
• ✅ Role-Based Access Control (Admin, Instructor, Student)
• ✅ Course & Lesson Management
• ❌ Enrollment & Progress Tracking (In Progress ⏳)
• ❌ Certificate Generation (Not Started 🚧)
• ❌ Reviews & Ratings (Not Started 🚧)
• ✅ OpenAPI Documentation (Swagger UI)

🏗 Tech Stack

Technology	Description
Java 21	Backend language
Spring Boot 3.4.3	Application framework
Spring Security & JWT	Authentication & Authorization
Spring Data JPA	ORM for database interaction
PostgreSQL	Relational database
MapStruct	DTO mapping
Lombok	Reduces boilerplate code
SpringDoc OpenAPI	API Documentation

📂 Project Structure

📦 src/main/java/com/system/training  
 ┣ 📂 config         # Security & configurations  
 ┣ 📂 controller     # REST controllers  
 ┣ 📂 DTO           # Data Transfer Objects  
 ┣ 📂 enums         # Enum types  
 ┣ 📂 exception     # Custom exception handling  
 ┣ 📂 mappers       # DTO to entity mappers  
 ┣ 📂 model         # Entity models  
 ┣ 📂 repository    # Database repositories  
 ┣ 📂 service       # Business logic layer  
 ┗ 📜 TrainingApplication.java  # Main Spring Boot Application  

⚙️ Setup & Installation

1️⃣ Clone the Repository

git clone https://github.com/devcom33/ElearnON.git  
cd ElearnON  

2️⃣ Configure Database

Update application.properties with your PostgreSQL credentials:

spring.datasource.url=jdbc:postgresql://localhost:5432/elearnon  
spring.datasource.username=your_db_user  
spring.datasource.password=your_db_password  
spring.jpa.hibernate.ddl-auto=update  
spring.security.jwt.secret=your-secret-key  

3️⃣ Build & Run the Project

mvn clean install  
mvn spring-boot:run  

4️⃣ API Documentation

After running the app, visit:

🔗 Swagger UI: http://localhost:8080/swagger-ui/index.html

🔐 Authentication

To access secured endpoints, generate a JWT token by logging in:

POST /api/auth/login

{
  "email": "mouad@gmail.com",
  "password": "password"
}

Use the received JWT token in headers:

Authorization: Bearer <your-token>

🛠 API Endpoints

Endpoint	Description	Access
POST /api/auth/register	Register new user	Public
POST /api/auth/login	Authenticate & get JWT	Public
GET /api/courses	Get all courses	Public
POST /api/courses	Create a new course	Instructor
POST /api/enrollments	Enroll a student (In Progress ⏳)	Student
GET /api/progress	Get user progress (In Progress ⏳)	Student
POST /api/reviews	Add course review (Not Started 🚧)	Student

📜 License

This project is open-source and available under the MIT License.

---

💡 Contributions & Issues
Feel free to open issues or submit pull requests! 🚀

🔗 Author: Devcom33