Skip to content

Conversation

@sbafsk
Copy link
Collaborator

@sbafsk sbafsk commented Dec 1, 2025

Phase 4: Aula Virtual (LMS Module)

This PR implements the complete Learning Management System with courses, modules, lessons, enrollments, and student progress tracking.

🎯 Components Implemented

Entities:

  • Course entity (with slug, levels, pricing, capacity)
  • CourseModule entity (course organization)
  • Lesson entity (6 types: VIDEO, TEXT, QUIZ, ASSIGNMENT, RESOURCE, LIVE_SESSION)
  • Enrollment entity (with status workflow and progress)
  • StudentProgress entity (detailed lesson tracking)
  • Payment entity (simplified for courses)

API Endpoints:

Public:

  • GET /api/v1/courses - List courses (filters: level, search)
  • GET /api/v1/courses/{slug} - Get course by slug

Authenticated (Students):

  • POST /api/v1/enrollments - Enroll in course
  • GET /api/v1/enrollments/my - My enrollments
  • POST /api/v1/enrollments/{id}/progress - Update progress
  • GET /api/v1/enrollments/{id}/progress - Get progress
  • POST /api/v1/enrollments/{id}/lessons/{lessonId}/complete - Mark complete

Admin/Instructor:

  • POST /api/v1/courses - Create course
  • PUT /api/v1/courses/{id} - Update course
  • DELETE /api/v1/courses/{id} - Delete course
  • GET /api/v1/enrollments/course/{courseId} - Course enrollments
  • POST /api/v1/enrollments/{id}/activate - Activate enrollment

Features:

  • Automatic unique slug generation
  • Nested structure (Course → Modules → Lessons)
  • Capacity control
  • Dynamic pricing by membership
  • Automatic progress calculation
  • Auto-complete enrollment when finished
  • Video progress tracking (seconds)
  • Free preview lessons
  • 4 course levels
  • 5 enrollment states

Database:

  • Flyway migration V5
  • 6 tables with cascade operations
  • Unique enrollment constraint

📊 Files Changed

29 files added:

  • 6 entities
  • 10 DTOs (5 request, 5 response)
  • 6 repositories
  • 3 services
  • 2 controllers
  • 1 Flyway migration
  • 1 completion doc

✅ Checklist

  • Course CRUD with slug generation
  • Module & lesson structure
  • Enrollment system
  • Progress tracking
  • Capacity validation
  • Price calculation
  • Auto-completion

Ready for review and merge to phase-3

Implement complete Learning Management System with courses, modules, lessons, enrollments, and student progress tracking.

## Components Implemented

### Entities
- Course entity with complete course management (title, slug, levels, pricing, capacity)
- CourseModule entity with structured course organization
- Lesson entity with multiple types (VIDEO, TEXT, QUIZ, ASSIGNMENT, RESOURCE, LIVE_SESSION)
- Enrollment entity with status workflow and progress tracking
- StudentProgress entity for detailed lesson completion tracking
- Payment entity (simplified for course payments)
- Enums: CourseLevel, CourseStatus, LessonType, EnrollmentStatus, PaymentType, PaymentStatus

### API Endpoints
#### Public
- GET /api/v1/courses - List published courses (with filters: level, search)
- GET /api/v1/courses/{slug} - Get course by slug

#### Authenticated (Students)
- POST /api/v1/enrollments - Enroll in course
- GET /api/v1/enrollments/my - My enrollments
- GET /api/v1/enrollments/{id} - Get enrollment details
- POST /api/v1/enrollments/{id}/progress - Update lesson progress
- GET /api/v1/enrollments/{id}/progress - Get my progress
- POST /api/v1/enrollments/{id}/lessons/{lessonId}/complete - Mark lesson complete

#### Admin/Instructor
- GET /api/v1/courses/id/{id} - Get course by ID
- POST /api/v1/courses - Create course
- PUT /api/v1/courses/{id} - Update course
- DELETE /api/v1/courses/{id} - Delete course
- GET /api/v1/enrollments/course/{courseId} - Course enrollments
- POST /api/v1/enrollments/{id}/activate - Activate enrollment
- POST /api/v1/enrollments/{id}/complete - Complete enrollment

### Services
- CourseService with CRUD, slug generation, filtering, and search
- EnrollmentService with enrollment management, capacity validation, price calculation
- StudentProgressService with progress tracking and auto-completion

### Features
- Automatic slug generation from course titles
- Unique slug validation
- Nested course structure (Course → Modules → Lessons)
- Enrollment capacity control
- Duplicate enrollment prevention
- Dynamic pricing based on user membership
- Automatic progress percentage calculation
- Auto-complete enrollment when all lessons finished
- Video progress tracking (seconds watched)
- Free lesson support for previews
- Course levels (BEGINNER, INTERMEDIATE, ADVANCED, EXPERT)
- Enrollment states (PENDING_PAYMENT, ACTIVE, COMPLETED, DROPPED, EXPIRED)

### Database
- Flyway migration V5 (courses, modules, lessons, enrollments, progress, payments tables)
- Proper foreign key relationships with cascade operations
- Indexes for performance optimization
- Unique constraints for enrollment prevention

## Technical Details
- Slug generation with uniqueness guarantee
- Progress auto-calculation on lesson completion
- Payment integration placeholder
- Support for instructor course ownership
- Public course visibility control
- Rich lesson types for varied content delivery

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants