# sathyapriya-gv/ai-learning-platform architecture

> Architecture diagram of the GitHub repository sathyapriya-gv/ai-learning-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sathyapriya-gv/ai-learning-platform
- Repository: https://github.com/sathyapriya-gv/ai-learning-platform

## Overview

AuraQuiz is a learning platform where students upload study material, generate and take quizzes, then review results, progress, and recommendations. Admins also manage users, uploads, and AI usage. The graph captures the documented UI routes and the sampled server-side upload and quiz flows. Several client pages and the analytics controller were read, but their request wiring is not shown in excerpts; API relationships not directly evidenced are omitted. The README is empty.

Main entry points: [`client/src/App.jsx`](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/App.jsx) (App Router), [`server/controllers/quizController.js`](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/quizController.js) (Quiz Generation and Grading), [`server/controllers/analyticsController.js`](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/analyticsController.js) (Analytics and Recommendations), [`server/controllers/uploadController.js`](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/uploadController.js) (Upload Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student and Admin UI"]
  node_app["App Router<br/>[App.jsx]"]
  node_auth_ui["Auth State<br/>[AuthContext.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_upload_ui["Upload UI<br/>[Upload.jsx]"]
  node_setup_ui["Quiz Setup<br/>[QuizSetup.jsx]"]
  node_player_ui["Quiz Player<br/>[QuizPlayer.jsx]"]
  node_result_ui["Quiz Results<br/>[QuizResultView.jsx]"]
  node_history_ui["Quiz History<br/>[History.jsx]"]
  node_analytics_ui["Analytics View<br/>[Analytics.jsx]"]
  node_recommendations_ui["Recommendations View"]
  node_admin_ui["Admin Pages"]
end

subgraph group_identity["Identity"]
  node_auth_routes["Auth Routes<br/>[authRoutes.js]"]
  node_auth_controller["Auth Controller<br/>[authController.js]"]
  node_auth_middleware["Access Control<br/>[authMiddleware.js]"]
  node_user_store[("User Records<br/>[User.js]")]
  node_api_server["API Server<br/>[server.js]"]
end

subgraph group_materials["Learning Materials"]
  node_upload_routes["Upload Routes<br/>[uploadRoutes.js]"]
  node_upload_controller["Upload Processing"]
  node_extractor["Text Extraction"]
  node_file_store[("File Records<br/>[File.js]")]
  node_text_store[("Extracted Text<br/>[ExtractedText.js]")]
end

subgraph group_quizzes["Quiz and Assessment"]
  node_quiz_routes["Quiz Routes<br/>[quizRoutes.js]"]
  node_quiz_controller["Quiz Generation and Grading<br/>[quizController.js]"]
  node_ai_service["AI Generation<br/>[aiService.js]"]
  node_quiz_store[("Quiz Records<br/>[Quiz.js]")]
  node_question_store[("Question Records<br/>[Question.js]")]
end

subgraph group_insights["Learning Insights"]
  node_analytics_routes["Analytics Routes<br/>[analyticsRoutes.js]"]
  node_analytics_controller["Analytics and Recommendations"]
  node_result_store[("Result Records<br/>[Result.js]")]
  node_progress_store[("Progress Records<br/>[Progress.js]")]
  node_analytics_store[("Analytics Records<br/>[Analytics.js]")]
  node_recommendation_store[("Recommendation Records<br/>[Recommendation.js]")]
end

node_student(("Student"))
node_admin(("Admin"))

node_student -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"provides auth"| node_auth_ui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_upload_ui
node_app -->|"routes to"| node_setup_ui
node_app -->|"routes to"| node_player_ui
node_app -->|"routes to"| node_result_ui
node_app -->|"routes to"| node_history_ui
node_app -->|"routes to"| node_analytics_ui
node_app -->|"routes to"| node_recommendations_ui
node_app -->|"routes to"| node_admin_ui
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_upload_routes
node_api_server -->|"mounts"| node_quiz_routes
node_api_server -->|"mounts"| node_analytics_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects profile"| node_auth_middleware
node_auth_controller -->|"accesses users"| node_user_store
node_auth_middleware -->|"loads user"| node_user_store
node_upload_routes -->|"dispatches"| node_upload_controller
node_upload_routes -->|"protects endpoints"| node_auth_middleware
node_upload_controller -->|"saves and reads"| node_file_store
node_upload_controller -->|"extracts text"| node_extractor
node_upload_controller -->|"saves and reads"| node_text_store
node_upload_controller -->|"identifies topics"| node_ai_service
node_quiz_routes -->|"dispatches"| node_quiz_controller
node_quiz_routes -->|"protects endpoints"| node_auth_middleware
node_quiz_controller -->|"reads material"| node_text_store
node_quiz_controller -->|"generates quiz"| node_ai_service
node_quiz_controller -->|"creates and reads"| node_quiz_store
node_quiz_controller -->|"saves questions"| node_question_store
node_quiz_controller -->|"reads and saves"| node_result_store
node_quiz_controller -->|"updates progress"| node_progress_store
node_quiz_controller -->|"updates analytics"| node_analytics_store
node_quiz_controller -->|"updates recommendations"| node_recommendation_store
node_analytics_routes -->|"dispatches"| node_analytics_controller
node_analytics_routes -->|"protects endpoints"| node_auth_middleware
node_analytics_controller -->|"reads results"| node_result_store
node_analytics_controller -->|"reads progress"| node_progress_store
node_analytics_controller -->|"reads analytics"| node_analytics_store
node_analytics_controller -->|"reads recommendations"| node_recommendation_store
node_analytics_controller -->|"reads files"| node_file_store
node_analytics_controller -->|"reads users"| node_user_store

click node_app "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/App.jsx"
click node_auth_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Dashboard.jsx"
click node_upload_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Upload.jsx"
click node_setup_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizSetup.jsx"
click node_player_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizPlayer.jsx"
click node_result_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizResultView.jsx"
click node_history_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/History.jsx"
click node_analytics_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Analytics.jsx"
click node_recommendations_ui "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Recommendations.jsx"
click node_admin_ui "https://github.com/sathyapriya-gv/ai-learning-platform/tree/main/client/src/pages/admin"
click node_auth_routes "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/authRoutes.js"
click node_auth_controller "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/authController.js"
click node_auth_middleware "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/middleware/authMiddleware.js"
click node_user_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/User.js"
click node_api_server "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/server.js"
click node_upload_routes "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/uploadRoutes.js"
click node_upload_controller "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/uploadController.js"
click node_extractor "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/services/extractorService.js"
click node_file_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/File.js"
click node_text_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/ExtractedText.js"
click node_quiz_routes "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/quizRoutes.js"
click node_quiz_controller "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/quizController.js"
click node_ai_service "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/services/aiService.js"
click node_quiz_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Quiz.js"
click node_question_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Question.js"
click node_analytics_routes "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/analyticsRoutes.js"
click node_analytics_controller "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/analyticsController.js"
click node_result_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Result.js"
click node_progress_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Progress.js"
click node_analytics_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Analytics.js"
click node_recommendation_store "https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Recommendation.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth_ui,node_dashboard,node_upload_ui,node_setup_ui,node_player_ui,node_result_ui,node_history_ui,node_analytics_ui,node_recommendations_ui,node_admin_ui toneBlue
class node_auth_routes,node_auth_controller,node_auth_middleware,node_user_store,node_api_server toneAmber
class node_upload_routes,node_upload_controller,node_extractor,node_file_store,node_text_store toneMint
class node_quiz_routes,node_quiz_controller,node_ai_service,node_quiz_store,node_question_store toneRose
class node_analytics_routes,node_analytics_controller,node_result_store,node_progress_store,node_analytics_store,node_recommendation_store,node_student,node_admin toneIndigo
```

## Components

### Student and Admin UI

- [App Router](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Auth State](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Upload UI](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Upload.jsx): `client/src/pages/Upload.jsx`
- [Quiz Setup](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizSetup.jsx): `client/src/pages/QuizSetup.jsx`
- [Quiz Player](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizPlayer.jsx): `client/src/pages/QuizPlayer.jsx`
- [Quiz Results](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/QuizResultView.jsx): `client/src/pages/QuizResultView.jsx`
- [Quiz History](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/History.jsx): `client/src/pages/History.jsx`
- [Analytics View](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Analytics.jsx): `client/src/pages/Analytics.jsx`
- [Recommendations View](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/client/src/pages/Recommendations.jsx): `client/src/pages/Recommendations.jsx`
- [Admin Pages](https://github.com/sathyapriya-gv/ai-learning-platform/tree/main/client/src/pages/admin): `client/src/pages/admin`

### Identity

- [Auth Routes](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Auth Controller](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Access Control](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [User Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/User.js): `server/models/User.js`
- [API Server](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/server.js): `server/server.js`

### Learning Materials

- [Upload Routes](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/uploadRoutes.js): `server/routes/uploadRoutes.js`
- [Upload Processing](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/uploadController.js): `server/controllers/uploadController.js`
- [Text Extraction](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/services/extractorService.js): `server/services/extractorService.js`
- [File Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/File.js): `server/models/File.js`
- [Extracted Text](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/ExtractedText.js): `server/models/ExtractedText.js`

### Quiz and Assessment

- [Quiz Routes](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/quizRoutes.js): `server/routes/quizRoutes.js`
- [Quiz Generation and Grading](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/quizController.js): `server/controllers/quizController.js`
- [AI Generation](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/services/aiService.js): `server/services/aiService.js`
- [Quiz Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Quiz.js): `server/models/Quiz.js`
- [Question Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Question.js): `server/models/Question.js`

### Learning Insights

- [Analytics Routes](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/routes/analyticsRoutes.js): `server/routes/analyticsRoutes.js`
- [Analytics and Recommendations](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/controllers/analyticsController.js): `server/controllers/analyticsController.js`
- [Result Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Result.js): `server/models/Result.js`
- [Progress Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Progress.js): `server/models/Progress.js`
- [Analytics Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Analytics.js): `server/models/Analytics.js`
- [Recommendation Records](https://github.com/sathyapriya-gv/ai-learning-platform/blob/main/server/models/Recommendation.js): `server/models/Recommendation.js`

### Other components

- **Student**
- **Admin**

## Connections

- Student → App Router: uses (evidence: `client/src/App.jsx`)
- Admin → App Router: uses (evidence: `client/src/App.jsx`)
- App Router → Auth State: provides auth (evidence: `client/src/App.jsx`)
- App Router → Dashboard: routes to (evidence: `client/src/App.jsx`)
- App Router → Upload UI: routes to (evidence: `client/src/App.jsx`)
- App Router → Quiz Setup: routes to (evidence: `client/src/App.jsx`)
- App Router → Quiz Player: routes to (evidence: `client/src/App.jsx`)
- App Router → Quiz Results: routes to (evidence: `client/src/App.jsx`)
- App Router → Quiz History: routes to (evidence: `client/src/App.jsx`)
- App Router → Analytics View: routes to (evidence: `client/src/App.jsx`)
- App Router → Recommendations View: routes to (evidence: `client/src/App.jsx`)
- App Router → Admin Pages: routes to (evidence: `client/src/App.jsx`)
- API Server → Auth Routes: mounts (evidence: `server/server.js`)
- API Server → Upload Routes: mounts (evidence: `server/server.js`)
- API Server → Quiz Routes: mounts (evidence: `server/server.js`)
- API Server → Analytics Routes: mounts (evidence: `server/server.js`)
- Auth Routes → Auth Controller: dispatches (evidence: `server/routes/authRoutes.js`)
- Auth Routes → Access Control: protects profile (evidence: `server/routes/authRoutes.js`)
- Auth Controller → User Records: accesses users (evidence: `server/controllers/authController.js`)
- Access Control → User Records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Upload Routes → Upload Processing: dispatches (evidence: `server/routes/uploadRoutes.js`)
- Upload Routes → Access Control: protects endpoints (evidence: `server/routes/uploadRoutes.js`)
- Upload Processing → File Records: saves and reads (evidence: `server/controllers/uploadController.js`)
- Upload Processing → Text Extraction: extracts text (evidence: `server/controllers/uploadController.js`)
- Upload Processing → Extracted Text: saves and reads (evidence: `server/controllers/uploadController.js`)
- Upload Processing → AI Generation: identifies topics (evidence: `server/controllers/uploadController.js`)
- Quiz Routes → Quiz Generation and Grading: dispatches (evidence: `server/routes/quizRoutes.js`)
- Quiz Routes → Access Control: protects endpoints (evidence: `server/routes/quizRoutes.js`)
- Quiz Generation and Grading → Extracted Text: reads material (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → AI Generation: generates quiz (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Quiz Records: creates and reads (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Question Records: saves questions (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Result Records: reads and saves (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Progress Records: updates progress (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Analytics Records: updates analytics (evidence: `server/controllers/quizController.js`)
- Quiz Generation and Grading → Recommendation Records: updates recommendations (evidence: `server/controllers/quizController.js`)
- Analytics Routes → Analytics and Recommendations: dispatches (evidence: `server/routes/analyticsRoutes.js`)
- Analytics Routes → Access Control: protects endpoints (evidence: `server/routes/analyticsRoutes.js`)
- Analytics and Recommendations → Result Records: reads results (evidence: `server/controllers/analyticsController.js`)
- Analytics and Recommendations → Progress Records: reads progress (evidence: `server/controllers/analyticsController.js`)
- Analytics and Recommendations → Analytics Records: reads analytics (evidence: `server/controllers/analyticsController.js`)
- Analytics and Recommendations → Recommendation Records: reads recommendations (evidence: `server/controllers/analyticsController.js`)
- Analytics and Recommendations → File Records: reads files (evidence: `server/controllers/analyticsController.js`)
- Analytics and Recommendations → User Records: reads users (evidence: `server/controllers/analyticsController.js`)
