openccb/roadmap.md

# OpenCCB: Open Comprehensive Course Backbone - Roadmap

## Phase 1: Foundation ✅
- [x] Rust Workspace Setup (Edition 2024)
- [x] Microservices Scaffolding (CMS & LMS)
- [x] Multi-Database Infrastructure (PostgreSQL with separate DBs)
- [x] Frontend Initialization (Next.js Studio & Experience)
- [x] Dockerization of all services
- [x] API Integration (Dashboard <-> CMS Service)
- [x] Unified `install.sh` script with hardware detection & auto-config

## Phase 2: Core CMS Features ✅
- [x] Course Outline Editor (Modules & Lessons)
- [x] File Upload System (Video/Audio/Native Assets)
- [x] Interactive Content (Activity Builder)
  - [x] Block Reordering (Move Up/Down)
  - [x] Rich Text Descriptions
  - [x] Media Blocks with Playback Constraints
  - [x] Quiz Blocks (Multiple Choice, True/False, Multiple Select)
  - [x] Advanced Assessment Types:
    - [x] Fill-in-the-Blanks
    - [x] Matching Pairs
    - [x] Ordering/Sequencing
    - [x] Short Answer
- [x] Service-to-Service Communication (CMS -> LMS sync)
- [x] Premium Video Player with playback limits
- [x] Full Studio UI with dynamic course management

## Phase 3: Authentication & Security ✅
- [x] **JWT-Based Authentication**: Common auth across all services
- [x] **Role-Based Access Control (RBAC)**:
  - [x] Multi-role support (Admin, Instructor, Student)
  - [x] Role-specific permissions and UI
  - [x] Token-based authorization for protected endpoints
- [x] **Audit Logging**: All CMS mutations tracked
- [x] **Audit UI**: Admin interface to view audit logs

## Phase 4: LMS Experience & Grading ✅
- [x] **Student Portal (Experience)**:
  - [x] Course catalog and enrollment
  - [x] Interactive lesson player
  - [x] Mobile-responsive design
- [x] **Holistic Grading System**:
  - [x] Weighted grading categories
  - [x] Drop lowest N scores per category
  - [x] Automatic weighted grade calculation
- [x] **Assessment Policies**:
  - [x] Configurable max attempts per lesson
  - [x] Instant corrections and retry policies
  - [x] Atomic attempt tracking with enforcement
- [x] **Progress Tracking**:
  - [x] Real-time score visualization
  - [x] Category-by-category breakdown
  - [x] Weighted grade calculation
- [x] **Dynamic Passing Thresholds**:
  - [x] Configurable passing percentage per course
  - [x] 5-tier performance visualization
  - [x] Color-coded feedback (Reprobado to Excelente)
- [x] **Certificates**: Automated certificate generation upon completion

## Phase 5: Analytics & Insights ✅
- [x] **Instructor Analytics Dashboard**:
  - [x] Total enrollments per course
  - [x] Overall average score
  - [x] Per-lesson performance breakdown
  - [x] "Struggling lessons" detection
  - [x] RBAC enforcement (instructors see only their courses)
- [x] **Student Progress Dashboard**:
  - [x] Interactive performance bar
  - [x] Tier-based feedback visualization
  - [x] Real-time grade updates

## Phase 6: Advanced Features (In Progress)
- [x] **Multi-tenancy**: Support for multiple organizations (Completed)
  - [x] Database schema migration (add `organization_id`)
  - [x] Update Rust models & JWT Claims
  - [x] Implement Axum middleware for organization context
  - [x] Update Frontend registration to support organizations
- [x] **Organization Branding**: Custom identity per tenant (Completed)
  - [x] Logo upload & optimization
  - [x] Custom color schemes (Primary/Secondary)
  - [x] Dynamic Experience Portal adaptation
  - [x] Live Branding Preview in Studio
- [x] **Advanced Analytics**:
  - [x] Cohort analysis (Implemented)
  - [x] Retention metrics (Implemented)
  - [ ] Engagement heatmaps
- [ ] **AI Integration** (Next Up):
  - [x] AI-driven lesson summaries (Implemented)
  - [ ] Implement real-time video transcription via external API
  - [x] Automated quiz generation (Implemented)
  - [ ] Personalized learning paths
- [x] **Gamification**: (Broadly implemented)
  - [x] Badges and achievements (Implemented base system)
  - [x] Leaderboards (Implemented)
  - [x] XP and leveling system (Implemented)
- [x] **Course Management Enhancements**:
  - [x] Manual naming for modules, lessons, and activities during creation.
  - [x] Reordering for modules, lessons, and activities (Level up/down).
  - [x] Deletion of modules and lessons with confirmation.
  - [x] **Pacing Control**:
    - [x] Self-paced mode (Evergreen).
    - [x] Instructor-led mode (Cohort-based with start/end dates).
  - [x] **Course Calendar**:
    - [x] Management of important dates (exams, assignments, milestones).
    - [ ] Automated reminders for upcoming deadlines.
- [ ] **Content Library**:
  - [ ] Reusable content blocks
  - [ ] Template courses
  - [ ] Shared resource pool

## Phase 7: Enterprise Features (Future)
- [ ] **Advanced Reporting**:
  - [ ] Custom report builder
  - [ ] Export to PDF/CSV
  - [ ] Scheduled reports
- [ ] **Integration Ecosystem**:
  - [ ] LTI 1.3 support
  - [ ] SCORM compliance
  - [ ] Third-party integrations (Zoom, Google Meet, BigBlueButton)
- [ ] **Mobile Apps**:
  - [ ] Native iOS app
  - [ ] Native Android app
  - [ ] Offline mode
- [ ] **Accessibility**:
  - [ ] WCAG 2.1 AA compliance
  - [ ] Screen reader optimization
  - [ ] Keyboard navigation

## Phase 8: Future Innovations (Next Gen)
- [ ] **AI & Adaptive Learning**:
  - [ ] **AI Tutor**: Real-time context-aware assistant for students.
  - [ ] **Auto-grading**: LLM-based evaluation for short answers and essays.
  - [ ] **Adaptive Paths**: Dynamic content unlocking based on performance.
- [ ] **Monetization & Marketplace**:
  - [ ] **Multi-tenant Payments**: Integrated Stripe/Mercado Pago per organization.
  - [ ] **Subscriptions**: Monthly/Yearly membership support.
  - [ ] **Promotions**: Coupons, scholarships, and referral systems.
- [ ] **Social & Collaborative**:
  - [ ] **Peer Review**: Structured student-to-student evaluation flows.
  - [ ] **Co-working Spaces**: Real-time shared whiteboards and documents.
  - [ ] **AI-Threaded Forums**: Automatic discussion summaries and sentiment analysis.
- [ ] **Enterprise Ecosystem**:
  - [ ] **SSO (Single Sign-On)**: Azure AD, Okta, and Google Workspace integration.
  - [ ] **HRIS Integration**: Sync with Workday, SAP, and other HR tools.
  - [ ] **Webhooks & API**: Extensibility for third-party automation.
- [ ] **Deep Analytics**:
  - [ ] **Dropout Prediction**: ML models to detect students at risk.
  - [ ] **Engagement Heatmaps**: Detailed video and interaction tracking.
- [ ] **Offline-First Experience**:
  - [ ] **Mobile Offline Mode**: Encrypted downloads for learning on the go.

## Current Status

**Platform Maturity**: Core functionality is production-ready. Advanced features like AI integration are under active development.

**Recent Milestones**:
- ✅ **Gamification System**: XP, Levels, and Leaderboards integrated into the student experience.
- ✅ **Organization Branding**: Full customization of logos and brand colors across both portals.
- ✅ **Multi-Tenancy**: Full support for multiple organizations, from the database to the frontend.
- ✅ **Holistic Grading System**: Weighted categories, attempt tracking, and dynamic passing thresholds.

**Next Priorities**:
1. **AI Integration**: Implement real-time video transcription (external and local provider).
2. **Advanced Analytics**: Develop cohort analysis and retention metrics.
3. **Enterprise Ecosystem**: SSO (Single Sign-On) and Webhooks.