How abdallahanass/learnlite works
Learning Platform serves students, instructors, and administrators through a React client and FastAPI API. The main workflow is role-gated course discovery and management, enrollment, lesson progress, and quizzes; reviews, analytics, authentication, and administration are additional product branches. The backend also supports course-content retrieval assistance and a wellness chatbot. Source evidence is uneven: some domain services and UI pages are indexed but unsampled, so their internal call paths are omitted; documented integrations are shown separately where implementation links are not verified.
Main entry points: router.py API route registry · dependencies.py Auth and service wiring · App.js Role-based routes · client.js Authenticated API client
Components 34
React client
- Role-based routes
frontend/src/App.js - Authenticated API client
frontend/src/api/client.js - Student learning UI
frontend/src/pages/student - Instructor tools
frontend/src/pages/instructor - Admin dashboard
frontend/src/pages/admin - Login and profile
frontend/src/pages
FastAPI API
- API route registry
backend/app/api/router.py - Authentication routes
backend/app/api/routers/auth.py - Course routes
backend/app/api/routers/courses.py - Enrollment routes
backend/app/api/routers/enrollment.py - Quiz routes
backend/app/api/routers/quiz.py - Review routes
backend/app/api/routers/review.py - Admin routes
backend/app/api/routers/admin.py - AI assistant routes
backend/app/api/routers/ai.py - Wellness routes
backend/app/api/routers/wellness.py - Auth and service wiring
backend/app/api/dependencies.py
Learning services
- Course management
backend/app/services/course.py - Enrollment and progress
backend/app/services/enrollment.py - Quiz assessment
backend/app/services/quiz.py - Course reviews
backend/app/services/review.py - Accounts and analytics
backend/app/services
AI features
- Wellness chatbot
backend/app/ai/wellness_bot.py - Course assistant
backend/app/ai - Lesson ingestion
backend/app/ai/pipeline.py - PDF and video extraction
backend/app/ai/extractors.py - Text chunking
backend/app/ai/chunker.py - Vector indexing
backend/app/ai/embedder.py
Persistence
- Learning data models
backend/app/database/models.py - Database sessions
backend/app/database/session.py - PostgreSQL
- Redis token blacklist
backend/app/database/redis.py
Other components
- Platform users
- ChromaDB vector store
- Groq API
Connections 37
- Platform users → Role-based routes: use
frontend/src/App.js - Role-based routes → Student learning UI: routes to
frontend/src/App.js - Role-based routes → Instructor tools: routes to
frontend/src/App.js - Role-based routes → Admin dashboard: routes to
frontend/src/App.js - Role-based routes → Login and profile: routes to
frontend/src/App.js - Student learning UI → Authenticated API client: requests via
- Instructor tools → Authenticated API client: requests via
- Admin dashboard → Authenticated API client: requests via
- Login and profile → Authenticated API client: requests via
- Authenticated API client → API route registry: HTTP REST
README.md - API route registry → Authentication routes: registers
backend/app/api/router.py - API route registry → Course routes: registers
backend/app/api/router.py - API route registry → Enrollment routes: registers
backend/app/api/router.py - API route registry → Quiz routes: registers
backend/app/api/router.py - API route registry → Review routes: registers
backend/app/api/router.py - API route registry → Admin routes: registers
backend/app/api/router.py - API route registry → AI assistant routes: registers
backend/app/api/router.py - API route registry → Wellness routes: registers
backend/app/api/router.py - Enrollment routes → Enrollment and progress: invokes
backend/app/api/routers/enrollment.py - Auth and service wiring → Course management: provides service
backend/app/api/dependencies.py - Auth and service wiring → Enrollment and progress: provides service
backend/app/api/dependencies.py - Auth and service wiring → Quiz assessment: provides service
backend/app/api/dependencies.py - Auth and service wiring → Course reviews: provides service
backend/app/api/dependencies.py - Auth and service wiring → Accounts and analytics: provides services
backend/app/api/dependencies.py - AI assistant routes → Course assistant: uses assistant modules
backend/app/api/routers/ai.py - Wellness routes → Wellness chatbot: uses service
- Lesson ingestion → PDF and video extraction: extracts text
backend/app/ai/pipeline.py - Lesson ingestion → Text chunking: chunks text
backend/app/ai/pipeline.py - Lesson ingestion → Vector indexing: indexes chunks
backend/app/ai/pipeline.py - Course assistant → ChromaDB vector store: retrieves context
README.md - Course assistant → Groq API: calls language model
README.md - Database sessions → PostgreSQL: opens sessions
backend/app/database/session.py - Database sessions → Learning data models: creates tables
backend/app/database/session.py - Auth and service wiring → Database sessions: gets session
backend/app/api/dependencies.py - Auth and service wiring → Redis token blacklist: checks blacklist
backend/app/api/dependencies.py - Enrollment and progress → Learning data models: reads and updates
backend/app/services/enrollment.py - Course reviews → Learning data models: reads and updates
backend/app/services/review.py