# lchithanh/web_tracnghiem architecture

> Architecture diagram of the GitHub repository lchithanh/web_tracnghiem, 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/lchithanh/web_tracnghiem
- Repository: https://github.com/lchithanh/web_tracnghiem

## Overview

This is an online multiple-choice exam management system: a React role-based interface uses a Laravel REST API for authentication, courses/classes, exam authoring, timed attempts, and results. The main student workflow is browse exams, start and submit an attempt, then view its score and history; teacher and admin workflows manage the content and users behind it. The graph follows documented routes and sampled references. Some frontend pages and backend controllers are indexed but unsampled, so their internal calls are not expanded.

Main entry points: [`my-laravel-be/routes/api.php`](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/routes/api.php) (API routes), [`my-react-fe/src/App.jsx`](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/App.jsx) (Role routes), [`my-react-fe/src/api/axiosClient.js`](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/api/axiosClient.js) (API client), [`my-laravel-be/app/Models/Attempt.php`](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Attempt.php) (Attempt records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["Role routes<br/>[App.jsx]"]
  node_auth_ui["Auth state<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[axiosClient.js]"]
  node_user_ui["User management<br/>[UserManager.jsx]"]
  node_admin_ui["Admin tools"]
  node_teacher_ui["Teacher tools"]
  node_student_ui["Student exam UI"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication<br/>[AuthController.php]"]
  node_user_api["User administration<br/>[UserController.php]"]
  node_user_model["User accounts<br/>[User.php]"]
end

subgraph group_learning["Learning domain"]
  node_exam_api["Exam management<br/>[ExamController.php]"]
  node_question_api["Question bank"]
  node_answer_api["Answer choices"]
  node_import_api["Question import"]
  node_class_api["Class management"]
  node_join_api["Class enrollment<br/>[JoinController.php]"]
  node_attempt_api["Exam attempts"]
  node_attempt_answer_api["Attempt responses"]
  node_attempt_model["Attempt records<br/>[Attempt.php]"]
  node_exam_model["Exam records<br/>[Exam.php]"]
  node_class_model["Class records<br/>[Classroom.php]"]
end

subgraph group_api["Laravel API"]
  node_api_routes["API routes<br/>[api.php]"]
  node_database[("Relational database")]
end

node_student(("Student"))
node_teacher(("Teacher"))
node_admin(("Administrator"))

node_app -->|"provides auth"| node_auth_ui
node_app -->|"routes admin"| node_admin_ui
node_app -->|"routes teacher"| node_teacher_ui
node_app -->|"routes student"| node_student_ui
node_auth_ui -->|"calls"| node_api_client
node_user_ui -->|"calls"| node_api_client
node_admin_ui -.->|"calls"| node_api_client
node_teacher_ui -.->|"calls"| node_api_client
node_student_ui -.->|"calls"| node_api_client
node_api_client -->|"HTTP requests"| node_api_routes
node_api_routes -->|"dispatches"| node_auth_api
node_api_routes -->|"dispatches"| node_user_api
node_api_routes -->|"dispatches"| node_exam_api
node_api_routes -->|"dispatches"| node_question_api
node_api_routes -->|"dispatches"| node_answer_api
node_api_routes -->|"dispatches"| node_import_api
node_api_routes -->|"dispatches"| node_class_api
node_api_routes -->|"dispatches"| node_join_api
node_api_routes -->|"dispatches"| node_attempt_api
node_api_routes -->|"dispatches"| node_attempt_answer_api
node_auth_api -->|"uses account"| node_user_model
node_user_api -->|"uses account"| node_user_model
node_exam_api -->|"uses exam"| node_exam_model
node_exam_api -->|"reads attempts"| node_attempt_model
node_class_api -->|"uses class"| node_class_model
node_attempt_api -->|"uses attempt"| node_attempt_model
node_attempt_answer_api -->|"uses attempt"| node_attempt_model
node_attempt_model -->|"belongs to"| node_exam_model
node_exam_model -.->|"persists records"| node_database
node_class_model -.->|"persists records"| node_database
node_user_model -.->|"persists records"| node_database
node_student -->|"uses portal"| node_app
node_teacher -->|"uses portal"| node_app
node_admin -->|"uses portal"| node_app

click node_app "https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/App.jsx"
click node_auth_ui "https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/context/AuthContext.jsx"
click node_api_client "https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/api/axiosClient.js"
click node_user_ui "https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/pages/admin/UserManager.jsx"
click node_admin_ui "https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/admin"
click node_teacher_ui "https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/teacher"
click node_student_ui "https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/student"
click node_auth_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/AuthController.php"
click node_user_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/UserController.php"
click node_user_model "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/User.php"
click node_exam_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ExamController.php"
click node_question_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/QuestionController.php"
click node_answer_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AnswerController.php"
click node_import_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ImportController.php"
click node_class_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ClassroomController.php"
click node_join_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/JoinController.php"
click node_attempt_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AttemptController.php"
click node_attempt_answer_api "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AttemptAnswerController.php"
click node_attempt_model "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Attempt.php"
click node_exam_model "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Exam.php"
click node_class_model "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Classroom.php"
click node_api_routes "https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/routes/api.php"

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_api_client,node_user_ui,node_admin_ui,node_teacher_ui,node_student_ui toneBlue
class node_auth_api,node_user_api,node_user_model toneAmber
class node_exam_api,node_question_api,node_answer_api,node_import_api,node_class_api,node_join_api,node_attempt_api,node_attempt_answer_api,node_attempt_model,node_exam_model,node_class_model toneMint
class node_api_routes,node_database toneRose
class node_student,node_teacher,node_admin toneIndigo
```

## Components

### React application

- [Role routes](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/App.jsx): `my-react-fe/src/App.jsx`
- [Auth state](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/context/AuthContext.jsx): `my-react-fe/src/context/AuthContext.jsx`
- [API client](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/api/axiosClient.js): `my-react-fe/src/api/axiosClient.js`
- [User management](https://github.com/lchithanh/web_tracnghiem/blob/main/my-react-fe/src/pages/admin/UserManager.jsx): `my-react-fe/src/pages/admin/UserManager.jsx`
- [Admin tools](https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/admin): `my-react-fe/src/pages/admin`
- [Teacher tools](https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/teacher): `my-react-fe/src/pages/teacher`
- [Student exam UI](https://github.com/lchithanh/web_tracnghiem/tree/main/my-react-fe/src/pages/student): `my-react-fe/src/pages/student`

### Identity and access

- [Authentication](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/AuthController.php): `my-laravel-be/app/Http/Controllers/AuthController.php`
- [User administration](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/UserController.php): `my-laravel-be/app/Http/Controllers/Api/UserController.php`
- [User accounts](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/User.php): `my-laravel-be/app/Models/User.php`

### Learning domain

- [Exam management](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ExamController.php): `my-laravel-be/app/Http/Controllers/Api/ExamController.php`
- [Question bank](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/QuestionController.php): `my-laravel-be/app/Http/Controllers/Api/QuestionController.php`
- [Answer choices](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AnswerController.php): `my-laravel-be/app/Http/Controllers/Api/AnswerController.php`
- [Question import](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ImportController.php): `my-laravel-be/app/Http/Controllers/Api/ImportController.php`
- [Class management](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/ClassroomController.php): `my-laravel-be/app/Http/Controllers/Api/ClassroomController.php`
- [Class enrollment](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/JoinController.php): `my-laravel-be/app/Http/Controllers/Api/JoinController.php`
- [Exam attempts](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AttemptController.php): `my-laravel-be/app/Http/Controllers/Api/AttemptController.php`
- [Attempt responses](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Http/Controllers/Api/AttemptAnswerController.php): `my-laravel-be/app/Http/Controllers/Api/AttemptAnswerController.php`
- [Attempt records](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Attempt.php): `my-laravel-be/app/Models/Attempt.php`
- [Exam records](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Exam.php): `my-laravel-be/app/Models/Exam.php`
- [Class records](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/app/Models/Classroom.php): `my-laravel-be/app/Models/Classroom.php`

### Laravel API

- [API routes](https://github.com/lchithanh/web_tracnghiem/blob/main/my-laravel-be/routes/api.php): `my-laravel-be/routes/api.php`
- **Relational database**

### Other components

- **Student**
- **Teacher**
- **Administrator**

## Connections

- Role routes → Auth state: provides auth (evidence: `my-react-fe/src/App.jsx`)
- Role routes → Admin tools: routes admin (evidence: `my-react-fe/src/App.jsx`)
- Role routes → Teacher tools: routes teacher (evidence: `my-react-fe/src/App.jsx`)
- Role routes → Student exam UI: routes student (evidence: `my-react-fe/src/App.jsx`)
- Auth state → API client: calls (evidence: `my-react-fe/src/context/AuthContext.jsx`)
- User management → API client: calls (evidence: `my-react-fe/src/pages/admin/UserManager.jsx`)
- Admin tools → API client: calls (evidence: `my-react-fe/src/pages/admin/UserManager.jsx`)
- Teacher tools → API client: calls (evidence: `my-react-fe/src/pages/teacher/ExamManager.jsx`)
- Student exam UI → API client: calls
- API client → API routes: HTTP requests (evidence: `my-react-fe/src/api/axiosClient.js`)
- API routes → Authentication: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → User administration: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Exam management: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Question bank: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Answer choices: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Question import: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Class management: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Class enrollment: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Exam attempts: dispatches (evidence: `my-laravel-be/routes/api.php`)
- API routes → Attempt responses: dispatches (evidence: `my-laravel-be/routes/api.php`)
- Authentication → User accounts: uses account (evidence: `my-laravel-be/app/Http/Controllers/AuthController.php`)
- User administration → User accounts: uses account (evidence: `my-laravel-be/app/Http/Controllers/Api/UserController.php`)
- Exam management → Exam records: uses exam (evidence: `my-laravel-be/app/Http/Controllers/Api/ExamController.php`)
- Exam management → Attempt records: reads attempts (evidence: `my-laravel-be/app/Http/Controllers/Api/ExamController.php`)
- Class management → Class records: uses class (evidence: `my-laravel-be/app/Http/Controllers/Api/ClassroomController.php`)
- Exam attempts → Attempt records: uses attempt (evidence: `my-laravel-be/app/Http/Controllers/Api/AttemptController.php`)
- Attempt responses → Attempt records: uses attempt (evidence: `my-laravel-be/app/Http/Controllers/Api/AttemptAnswerController.php`)
- Attempt records → Exam records: belongs to (evidence: `my-laravel-be/app/Models/Attempt.php`)
- Exam records → Relational database: persists records
- Class records → Relational database: persists records
- User accounts → Relational database: persists records
- Student → Role routes: uses portal (evidence: `my-react-fe/src/App.jsx`)
- Teacher → Role routes: uses portal (evidence: `my-react-fe/src/App.jsx`)
- Administrator → Role routes: uses portal (evidence: `my-react-fe/src/App.jsx`)
