How tharani927/lingualearn works
LinguaLearn is a React-and-Express language-learning platform. Learners authenticate, browse courses, complete lessons and assessments, then receive diagnostic feedback and can revisit mistakes, track skills, and earn achievements or certificates. Administrators manage users, courses and questions, and inspect analytics and reports. The graph follows the documented browser-to-API flow and sampled module calls; several domain services are represented by their actual service paths, but unshown controller-to-service wiring and database relationships are omitted where evidence is unavailable.
Main entry points: db.js PostgreSQL pool · api.js API client · App.jsx Routed SPA · index.js API route registry
Components 27
Learner and Admin App
- Routed SPA
frontend/src/App.jsx - Session context
frontend/src/contexts/AuthContext.jsx - API client
frontend/src/services/api.js - Learning screens
frontend/src/pages/learner - Admin screens
frontend/src/pages/admin - Theme preferences
frontend/src/contexts/ThemeContext.jsx
API and Identity
- Express API
backend/src/app.js - API route registry
backend/src/routes/index.js - Authentication routes
backend/src/routes/authRoutes.js - Authentication controller
backend/src/controllers/authController.js - Identity service
backend/src/services/authService.js - JWT authentication
backend/src/middleware/auth.js - Course routes
backend/src/routes/courseRoutes.js - Course controller
backend/src/controllers/courseController.js - Admin routes
backend/src/routes/adminRoutes.js
Learning Services
- Course service
backend/src/services/courseService.js - Lesson service
backend/src/services/lessonService.js - Assessment service
backend/src/services/assessmentService.js - Adaptive learning
backend/src/services/adaptiveLearningService.js - AI diagnostics
backend/src/services/aiService.js - Gamification
backend/src/services/gamificationService.js
Insights and Admin
- Admin controller
backend/src/controllers/adminController.js - Admin service
backend/src/services/adminService.js - Analytics service
backend/src/services/analyticsService.js - Reports service
backend/src/services/reportService.js
Persistence
- PostgreSQL pool
backend/src/config/db.js
Other components
- Learner or admin
Connections 30
- Learner or admin → Routed SPA: uses
frontend/src/App.jsx - Routed SPA → Learning screens: routes to
frontend/src/App.jsx - Routed SPA → Admin screens: routes to
frontend/src/App.jsx - Routed SPA → Session context: checks session
frontend/src/App.jsx - Session context → API client: calls auth API
frontend/src/contexts/AuthContext.jsx - Learning screens → API client: requests data
frontend/src/pages/learner/DashboardPage.jsx - Admin screens → API client: requests data
frontend/src/pages/admin/CourseManagementPage.jsx - Theme preferences → API client: syncs preferences
frontend/src/contexts/ThemeContext.jsx - API client → Express API: HTTP requests
frontend/src/services/api.js - Express API → API route registry: mounts routes
backend/src/app.js - API route registry → Authentication routes: registers
backend/src/routes/index.js - API route registry → Course routes: registers
backend/src/routes/index.js - Authentication routes → Authentication controller: dispatches
backend/src/routes/authRoutes.js - Authentication controller → Identity service: calls
backend/src/controllers/authController.js - Authentication routes → JWT authentication: guards requests
backend/src/routes/authRoutes.js - Course routes → JWT authentication: guards requests
backend/src/routes/courseRoutes.js - Course routes → Course controller: dispatches
backend/src/routes/courseRoutes.js - Course controller → Course service: calls
backend/src/controllers/courseController.js - Identity service → PostgreSQL pool: queries
backend/src/services/authService.js - Course service → PostgreSQL pool: accesses
- Lesson service → PostgreSQL pool: accesses
- Assessment service → PostgreSQL pool: accesses
- Adaptive learning → PostgreSQL pool: accesses
- AI diagnostics → PostgreSQL pool: accesses
- Gamification → PostgreSQL pool: accesses
backend/src/services/gamificationService.js - Admin routes → Admin controller: dispatches
backend/src/routes/adminRoutes.js - Admin controller → Admin service: calls
backend/src/controllers/adminController.js - Admin service → PostgreSQL pool: queries
backend/src/services/adminService.js - Analytics service → PostgreSQL pool: accesses
- Reports service → PostgreSQL pool: accesses