# khanhlabs/datn-learnova architecture

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

- Interactive diagram: https://gitdiagram.com/khanhlabs/datn-learnova
- Repository: https://github.com/khanhlabs/datn-learnova

## Overview

LearnOva is an online learning platform with student, instructor, and administrator experiences. The main workflow is a learner discovering courses, enrolling, studying lessons, and using course learning features; instructors create and manage courses, while administrators oversee users, course approval, and platform operations. The frontend routes role-specific experiences and calls an external application API. A separate FastAPI service accepts video uploads for AI summaries and quizzes. Backend implementation details are not present in the supplied tree, so its internals are not represented.

Main entry points: [`front_end/src/app/routes/AppRoutes.jsx`](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/app/routes/AppRoutes.jsx) (Role-based routes), [`ai_services/app.py`](https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/app.py) (AI upload API), [`front_end/src/features/course/presentation/user/CourseNew.jsx`](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/course/presentation/user/CourseNew.jsx) (Course discovery), [`front_end/src/features/admin/presentation/category/Category.jsx`](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/category/Category.jsx) (Category management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Application bootstrap<br/>[main.jsx]"]
  node_routes["Role-based routes<br/>[AppRoutes.jsx]"]
  node_auth["Authentication state<br/>[AuthContext.jsx]"]
end

subgraph group_learning["Learning experience"]
  node_course_browse["Course discovery<br/>[CourseNew.jsx]"]
  node_course_detail["Course details<br/>[CourseDetail.jsx]"]
  node_course_api["Course services<br/>[CourseApi.js]"]
  node_cart["Cart management<br/>[cartStorage.js]"]
  node_course_creation["Course authoring<br/>[useCourseForm.js]"]
  node_teacher_api["Instructor course API<br/>[CoursesApi.js]"]
end

subgraph group_operations["Platform operations"]
  node_admin_dashboard["Admin dashboard<br/>[Dashboard.jsx]"]
  node_admin_courses["Course administration<br/>[Course.jsx]"]
  node_admin_categories["Category management<br/>[Category.jsx]"]
  node_admin_moderation["Violation reports"]
  node_admin_api["Admin category API<br/>[CategoryApi.js]"]
end

subgraph group_ai["AI services"]
  node_ai_api["AI upload API<br/>[app.py]"]
  node_summary["Video summaries"]
  node_quiz["Quiz generation"]
  node_gemini_files["Gemini file handling"]
end

node_learner(("Learner"))
node_instructor(("Instructor"))
node_admin(("Administrator"))
node_application_api["Application backend"]

node_app -->|"provides auth"| node_auth
node_app -->|"renders routes"| node_routes
node_routes -->|"guards roles"| node_auth
node_routes -->|"routes to"| node_course_browse
node_routes -->|"routes to"| node_admin_dashboard
node_routes -->|"routes to"| node_admin_courses
node_routes -->|"routes to"| node_admin_categories
node_learner -.->|"discovers courses"| node_course_browse
node_course_browse -.->|"loads courses"| node_course_api
node_course_detail -.->|"requests course data"| node_course_api
node_learner -.->|"manages cart"| node_cart
node_cart -->|"syncs cart"| node_application_api
node_instructor -.->|"authors courses"| node_course_creation
node_course_creation -->|"persists drafts"| node_teacher_api
node_teacher_api -->|"sends requests"| node_application_api
node_admin -.->|"reviews overview"| node_admin_dashboard
node_admin -.->|"manages courses"| node_admin_courses
node_admin -.->|"manages categories"| node_admin_categories
node_admin -.->|"reviews reports"| node_admin_moderation
node_admin_categories -->|"uses API"| node_admin_api
node_admin_api -.->|"sends requests"| node_application_api
node_ai_api -->|"invokes summary"| node_summary
node_ai_api -->|"invokes quiz"| node_quiz
node_summary -->|"uses file helpers"| node_gemini_files
node_quiz -->|"uses file helpers"| node_gemini_files
node_application_api -.->|"may request generation"| node_ai_api

click node_app "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/main.jsx"
click node_routes "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/app/routes/AppRoutes.jsx"
click node_auth "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/app/providers/AuthContext.jsx"
click node_course_browse "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/course/presentation/user/CourseNew.jsx"
click node_course_detail "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/home/presentation/courses/courses_detail/CourseDetail.jsx"
click node_course_api "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/course/infrastructure/api/CourseApi.js"
click node_cart "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/shared/utils/cartStorage.js"
click node_course_creation "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/instructor/presentation/teacher/courses/create/hooks/useCourseForm.js"
click node_teacher_api "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/instructor/infrastructure/api/teacher/CoursesApi.js"
click node_admin_dashboard "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/dashboard/Dashboard.jsx"
click node_admin_courses "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/course/Course.jsx"
click node_admin_categories "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/category/Category.jsx"
click node_admin_moderation "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/violation_reports/ViolationReports.jsx"
click node_admin_api "https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/infrastructure/api/CategoryApi.js"
click node_ai_api "https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/app.py"
click node_summary "https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_summary_service.py"
click node_quiz "https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_quiz_service.py"
click node_gemini_files "https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_file_utils.py"

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_routes,node_auth toneBlue
class node_course_browse,node_course_detail,node_course_api,node_cart,node_course_creation,node_teacher_api toneAmber
class node_admin_dashboard,node_admin_courses,node_admin_categories,node_admin_moderation,node_admin_api toneMint
class node_ai_api,node_summary,node_quiz,node_gemini_files toneRose
class node_learner,node_instructor,node_admin,node_application_api toneIndigo
```

## Components

### Web application

- [Application bootstrap](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/main.jsx): `front_end/src/main.jsx`
- [Role-based routes](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/app/routes/AppRoutes.jsx): `front_end/src/app/routes/AppRoutes.jsx`
- [Authentication state](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/app/providers/AuthContext.jsx): `front_end/src/app/providers/AuthContext.jsx`

### Learning experience

- [Course discovery](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/course/presentation/user/CourseNew.jsx): `front_end/src/features/course/presentation/user/CourseNew.jsx`
- [Course details](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/home/presentation/courses/courses_detail/CourseDetail.jsx): `front_end/src/features/home/presentation/courses/courses_detail/CourseDetail.jsx`
- [Course services](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/course/infrastructure/api/CourseApi.js): `front_end/src/features/course/infrastructure/api/CourseApi.js`
- [Cart management](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/shared/utils/cartStorage.js): `front_end/src/shared/utils/cartStorage.js`
- [Course authoring](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/instructor/presentation/teacher/courses/create/hooks/useCourseForm.js): `front_end/src/features/instructor/presentation/teacher/courses/create/hooks/useCourseForm.js`
- [Instructor course API](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/instructor/infrastructure/api/teacher/CoursesApi.js): `front_end/src/features/instructor/infrastructure/api/teacher/CoursesApi.js`

### Platform operations

- [Admin dashboard](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/dashboard/Dashboard.jsx): `front_end/src/features/admin/presentation/dashboard/Dashboard.jsx`
- [Course administration](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/course/Course.jsx): `front_end/src/features/admin/presentation/course/Course.jsx`
- [Category management](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/category/Category.jsx): `front_end/src/features/admin/presentation/category/Category.jsx`
- [Violation reports](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/presentation/violation_reports/ViolationReports.jsx): `front_end/src/features/admin/presentation/violation_reports/ViolationReports.jsx`
- [Admin category API](https://github.com/khanhlabs/datn-learnova/blob/main/front_end/src/features/admin/infrastructure/api/CategoryApi.js): `front_end/src/features/admin/infrastructure/api/CategoryApi.js`

### AI services

- [AI upload API](https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/app.py): `ai_services/app.py`
- [Video summaries](https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_summary_service.py): `ai_services/services/gemini_summary_service.py`
- [Quiz generation](https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_quiz_service.py): `ai_services/services/gemini_quiz_service.py`
- [Gemini file handling](https://github.com/khanhlabs/datn-learnova/blob/main/ai_services/services/gemini_file_utils.py): `ai_services/services/gemini_file_utils.py`

### Other components

- **Learner**
- **Instructor**
- **Administrator**
- **Application backend**

## Connections

- Application bootstrap → Authentication state: provides auth (evidence: `front_end/src/main.jsx`)
- Application bootstrap → Role-based routes: renders routes (evidence: `front_end/src/main.jsx`)
- Role-based routes → Authentication state: guards roles (evidence: `front_end/src/app/routes/AppRoutes.jsx`)
- Role-based routes → Course discovery: routes to (evidence: `front_end/src/app/routes/AppRoutes.jsx`)
- Role-based routes → Admin dashboard: routes to (evidence: `front_end/src/app/routes/AppRoutes.jsx`)
- Role-based routes → Course administration: routes to (evidence: `front_end/src/app/routes/AppRoutes.jsx`)
- Role-based routes → Category management: routes to (evidence: `front_end/src/app/routes/AppRoutes.jsx`)
- Learner → Course discovery: discovers courses
- Course discovery → Course services: loads courses
- Course details → Course services: requests course data
- Learner → Cart management: manages cart
- Cart management → Application backend: syncs cart (evidence: `front_end/src/shared/utils/cartStorage.js`)
- Instructor → Course authoring: authors courses
- Course authoring → Instructor course API: persists drafts (evidence: `front_end/src/features/instructor/presentation/teacher/courses/create/hooks/useCourseForm.js`)
- Instructor course API → Application backend: sends requests (evidence: `front_end/src/features/instructor/infrastructure/api/teacher/CoursesApi.js`)
- Administrator → Admin dashboard: reviews overview
- Administrator → Course administration: manages courses
- Administrator → Category management: manages categories
- Administrator → Violation reports: reviews reports
- Category management → Admin category API: uses API (evidence: `front_end/src/features/admin/presentation/category/Category.jsx`)
- Admin category API → Application backend: sends requests
- AI upload API → Video summaries: invokes summary (evidence: `ai_services/app.py`)
- AI upload API → Quiz generation: invokes quiz (evidence: `ai_services/app.py`)
- Video summaries → Gemini file handling: uses file helpers (evidence: `ai_services/services/gemini_summary_service.py`)
- Quiz generation → Gemini file handling: uses file helpers (evidence: `ai_services/services/gemini_quiz_service.py`)
- Application backend → AI upload API: may request generation
