How rajat-wyrm/lms-system works
Course Compass is a multi-application learning management system: student and instructor workflows run through a React portal, while administrators use a separate console; both call the Express API for platform data. The backend handles authentication, course and enrollment operations, reviews, notifications, and persistence. A separate notebook-learning API supports document-grounded chat and study activities through retrieval and generation. README documents the main portal/API/database relationships; AI endpoint and service relationships are supported by the supplied source index and excerpts. Several backend and UI internals were not sampled, so their links are omitted where not evidenced.
Main entry points: app.js Express API · AppRouter.jsx Admin routes · main.py Notebook API · AppRouter.tsx Portal routes
Components 31
Learning portal
- Student portal
course-compass-main/src/App.tsx - Portal routes
course-compass-main/src/routes/AppRouter.tsx - Course learning
course-compass-main/src/pages/Courses/CoursePlayer.tsx - Instructor tools
course-compass-main/src/pages/Portal/ManageCourse.tsx
Admin console
- Admin console
admin/src/App.jsx - Admin routes
admin/src/routes/AppRouter.jsx - Course management
admin/src/pages/Dashboard/Admin/Courses.jsx - User management
admin/src/pages/Dashboard/Admin/Users.jsx - Review moderation
admin/src/pages/Dashboard/Admin/Reviews.jsx - Notifications
admin/src/pages/Dashboard/Admin/Notifications.jsx - Platform analytics
admin/src/pages/Dashboard/Admin/Analytics.jsx
LMS backend
- Express API
backend/src/app.js - Course services
backend/src/controllers/courses.controller.js - Enrollment and progress
backend/src/controllers/enrollment.controller.js - Reviews
backend/src/controllers/review.controller.js - Notification service
backend/src/notification.service.js - Email jobs
backend/src/queues/email.queue.js
Notebook learning
- Notebook API
AI/api/app/main.py - Study endpoints
AI/api/app/api/chat.py - Document ingestion
AI/api/app/api/document.py - Quizzes and assignments
AI/api/app/api/quiz.py - RAG generation
AI/api/app/services/rag_service.py - Vector retrieval
AI/api/app/vectorstore/chroma_store.py - Embedding model
AI/api/get_embedding_function.py - Notebook database
AI/api/app/db/session.py
Persistence and services
- Prisma database access
backend/src/config/db.js - PostgreSQL
- Redis cache
backend/src/services/redis.service.js
Other components
- Learners
- Instructors
- Administrators
Connections 36
- Learners → Student portal: uses
README.md - Instructors → Student portal: uses
README.md - Student portal → Portal routes: loads
course-compass-main/src/App.tsx - Portal routes → Course learning: routes to
README.md - Portal routes → Instructor tools: routes to
README.md - Course learning → Express API: uses REST
README.md - Instructor tools → Express API: uses REST
README.md - Administrators → Admin console: uses
README.md - Admin console → Admin routes: loads
admin/src/App.jsx - Admin routes → Course management: routes to
admin/src/routes/AppRouter.jsx - Admin routes → User management: routes to
admin/src/routes/AppRouter.jsx - Admin routes → Review moderation: routes to
admin/src/routes/AppRouter.jsx - Admin routes → Notifications: routes to
admin/src/routes/AppRouter.jsx - Admin routes → Platform analytics: routes to
admin/src/routes/AppRouter.jsx - Course management → Express API: uses API
README.md - User management → Express API: uses API
README.md - Review moderation → Express API: uses API
README.md - Notifications → Express API: uses API
README.md - Platform analytics → Express API: uses API
README.md - Express API → Course services: routes requests
backend/src/app.js - Express API → Enrollment and progress: routes requests
backend/src/app.js - Express API → Reviews: routes requests
- Enrollment and progress → Prisma database access: reads and writes
backend/src/controllers/enrollment.controller.js - Reviews → Prisma database access: reads and writes
backend/src/controllers/review.controller.js - Prisma database access → PostgreSQL: connects
backend/src/config/db.js - Enrollment and progress → Redis cache: clears cache
backend/src/controllers/enrollment.controller.js - Reviews → Notification service: creates notice
backend/src/controllers/review.controller.js - Notebook API → Study endpoints: mounts routes
AI/api/app/main.py - Notebook API → Document ingestion: mounts routes
AI/api/app/main.py - Notebook API → Quizzes and assignments: mounts routes
AI/api/app/main.py - Study endpoints → RAG generation: calls
AI/api/app/api/chat.py - Document ingestion → Vector retrieval: stores documents
AI/api/app/api/document.py - Quizzes and assignments → RAG generation: calls
AI/api/app/api/quiz.py - RAG generation → Vector retrieval: retrieves context
AI/api/app/services/rag_service.py - Vector retrieval → Embedding model: embeds queries
AI/api/app/vectorstore/chroma_store.py - Notebook API → Notebook database: initializes tables
AI/api/app/main.py