Hệ Thống CLS
Đánh Giá Năng Lực

graph TB subgraph Actors S["👨‍🎓 Học sinh"] A["👨‍💼 Admin"] T["👨‍🏫 Giáo viên"] AI["🤖 AI Engine"] end subgraph UC_Auth["🔐 Xác thực"] UC1["Đăng ký tài khoản"] UC2["Đăng nhập"] UC3["Quản lý hồ sơ"] end subgraph UC_Exam["📝 Thi & Đánh giá"] UC4["Xem danh sách đợt thi"] UC5["Đăng ký thi"] UC6["Làm bài thi"] UC7["Nộp bài"] UC8["Xem kết quả"] end subgraph UC_Analysis["📊 Phân tích"] UC9["Xem phổ điểm"] UC10["So sánh năng lực"] UC11["Dự đoán trúng tuyển"] UC12["Gợi ý chọn trường"] UC13["Xem tiến bộ"] end subgraph UC_Admin["⚙️ Quản trị"] UC14["Quản lý đề thi"] UC15["Quản lý đợt thi"] UC16["Quản lý người dùng"] UC17["Xem báo cáo thống kê"] UC18["Quản lý ngân hàng câu hỏi"] end S --> UC1 S --> UC2 S --> UC3 S --> UC4 S --> UC5 S --> UC6 S --> UC7 S --> UC8 S --> UC9 S --> UC10 S --> UC11 S --> UC12 S --> UC13 A --> UC2 A --> UC14 A --> UC15 A --> UC16 A --> UC17 T --> UC2 T --> UC18 T --> UC14 AI --> UC11 AI --> UC12 AI --> UC10 UC7 -.->|auto| UC8 UC8 -.->|includes| UC9

erDiagram USERS { int user_id PK string full_name string email string phone string password_hash string role "student|teacher|admin" string province string school_name int graduation_year datetime created_at } EXAM_SESSIONS { int session_id PK string session_name string exam_format "DHQG_HN|DHQG_HCM|BACH_KHOA" datetime start_time datetime end_time int duration_minutes string region string status "upcoming|active|completed" boolean is_free } QUESTIONS { int question_id PK int bank_id FK string content_html string option_a string option_b string option_c string option_d string correct_answer string skill_group "tu_duy_logic|ngon_ngu|toan|khoa_hoc|xa_hoi" int difficulty_level "1-5" string exam_format } QUESTION_BANKS { int bank_id PK string bank_name string exam_format int created_by FK int total_questions datetime created_at } EXAM_PAPERS { int paper_id PK int session_id FK string paper_code int total_questions } PAPER_QUESTIONS { int paper_id FK int question_id FK int question_order } STUDENT_EXAMS { int student_exam_id PK int user_id FK int session_id FK int paper_id FK datetime start_time datetime submit_time float total_score string status "in_progress|submitted|graded" } STUDENT_ANSWERS { int answer_id PK int student_exam_id FK int question_id FK string selected_answer boolean is_correct int time_spent_seconds } SKILL_SCORES { int skill_score_id PK int student_exam_id FK string skill_group float score float max_score float percentile } AI_ANALYSES { int analysis_id PK int user_id FK int student_exam_id FK text strengths text weaknesses text recommendations datetime created_at } ADMISSION_PREDICTIONS { int prediction_id PK int analysis_id FK int university_id FK string major_name float predicted_probability float historical_cutoff string recommendation } UNIVERSITIES { int university_id PK string university_name string university_code string city } UNIVERSITY_CUTOFFS { int cutoff_id PK int university_id FK string major_name int year float cutoff_score string exam_format int enrollment_quota } USERS ||--o{ STUDENT_EXAMS : "takes" EXAM_SESSIONS ||--o{ STUDENT_EXAMS : "has" EXAM_SESSIONS ||--o{ EXAM_PAPERS : "contains" EXAM_PAPERS ||--o{ PAPER_QUESTIONS : "includes" QUESTIONS ||--o{ PAPER_QUESTIONS : "appears_in" QUESTION_BANKS ||--o{ QUESTIONS : "contains" STUDENT_EXAMS ||--o{ STUDENT_ANSWERS : "has" STUDENT_EXAMS ||--o{ SKILL_SCORES : "produces" STUDENT_EXAMS ||--o{ AI_ANALYSES : "analyzed_by" AI_ANALYSES ||--o{ ADMISSION_PREDICTIONS : "predicts" UNIVERSITIES ||--o{ ADMISSION_PREDICTIONS : "target" UNIVERSITIES ||--o{ UNIVERSITY_CUTOFFS : "has" EXAM_PAPERS ||--o{ STUDENT_EXAMS : "assigned"

flowchart LR subgraph Input["📥 ĐẦU VÀO"] A1["Học sinh đăng ký"] A2["Chọn đợt thi"] end subgraph Process1["⚙️ XỬ LÝ THI"] B1["Xác thực
tài khoản"] B2["Tạo đề thi
ngẫu nhiên"] B3["Giao diện
làm bài"] B4["Thu thập
đáp án"] end subgraph Process2["📊 CHẤM & PHÂN TÍCH"] C1["Chấm điểm
tự động"] C2["Tính điểm
nhóm kỹ năng"] C3["Tính percentile
& phổ điểm"] end subgraph Process3["🤖 AI ENGINE"] D1["Phân tích
điểm mạnh/yếu"] D2["So sánh với
điểm chuẩn"] D3["Dự đoán
trúng tuyển"] D4["Gợi ý
chiến lược"] end subgraph Output["📤 ĐẦU RA"] E1["Kết quả
tức thì"] E2["Báo cáo
phổ điểm"] E3["Báo cáo AI
Premium"] E4["Biểu đồ
tiến bộ"] end A1 --> B1 A2 --> B2 B1 --> B2 B2 --> B3 B3 --> B4 B4 --> C1 C1 --> C2 C2 --> C3 C1 --> E1 C3 --> E2 C2 --> D1 D1 --> D2 D2 --> D3 D3 --> D4 D4 --> E3 C3 --> E4

sequenceDiagram actor HS as 👨‍🎓 Học sinh participant FE as 🖥️ Frontend participant API as ⚡ API Server participant DB as 🗄️ Database participant AI as 🤖 AI Engine HS->>FE: Đăng nhập FE->>API: POST /auth/login API->>DB: Verify credentials DB-->>API: User data API-->>FE: JWT Token FE-->>HS: Dashboard HS->>FE: Bắt đầu thi FE->>API: POST /exam/start API->>DB: Lấy câu hỏi ngẫu nhiên DB-->>API: Danh sách câu hỏi API-->>FE: Đề thi + Timer FE-->>HS: Giao diện làm bài loop Trả lời câu hỏi HS->>FE: Chọn đáp án FE->>API: PUT /exam/answer API->>DB: Lưu đáp án end HS->>FE: Nộp bài FE->>API: POST /exam/submit API->>DB: Chấm điểm tự động DB-->>API: Kết quả chi tiết API-->>FE: Điểm + Phân tích cơ bản FE-->>HS: Trang kết quả opt Mở khóa AI Premium HS->>FE: Thanh toán Premium FE->>API: POST /payment/unlock API->>AI: Yêu cầu phân tích AI->>DB: Truy vấn dữ liệu DB-->>AI: Dữ liệu lịch sử AI-->>API: Báo cáo AI API-->>FE: Phân tích chuyên sâu FE-->>HS: Trang AI Analysis end

graph TB subgraph Client["🌐 Client Layer"] C1["Web App
(React/Next.js)"] C2["Mobile App
(React Native)"] C3["Admin Panel
(Web)"] end subgraph Gateway["🔀 API Gateway"] GW["API Gateway
Nginx + Rate Limiting
Load Balancer"] end subgraph Services["⚙️ Microservices"] S1["Auth Service
JWT + OAuth2"] S2["Exam Service
Tạo đề, quản lý thi"] S3["Scoring Service
Chấm điểm tự động"] S4["Analytics Service
Phổ điểm, thống kê"] S5["AI Service
Dự đoán, gợi ý"] S6["Payment Service
Thanh toán Premium"] S7["Notification Service
Email, SMS, Push"] end subgraph Data["🗄️ Data Layer"] D1[("PostgreSQL
Primary DB")] D2[("Redis
Cache + Sessions")] D3[("Elasticsearch
Search + Analytics")] D4["S3/MinIO
File Storage"] end subgraph AI_Layer["🤖 AI/ML Layer"] ML1["Prediction Model
XGBoost/LightGBM"] ML2["NLP Analysis
Skill Assessment"] ML3["Recommendation
Engine"] end C1 --> GW C2 --> GW C3 --> GW GW --> S1 GW --> S2 GW --> S3 GW --> S4 GW --> S5 GW --> S6 GW --> S7 S1 --> D1 S1 --> D2 S2 --> D1 S3 --> D1 S3 --> D2 S4 --> D3 S5 --> AI_Layer S6 --> D1 AI_Layer --> D1 AI_Layer --> D3

graph LR subgraph Free["🆓 GÓI MIỄN PHÍ"] F1["✅ Thi đánh giá
không giới hạn"] F2["✅ Kết quả tức thì
điểm tổng + phần"] F3["✅ Phổ điểm
khu vực"] F4["✅ Xếp hạng
trong nhóm"] F5["✅ Biểu đồ
tiến bộ cơ bản"] end subgraph Premium["💎 GÓI PREMIUM"] P1["⭐ AI phân tích
chuyên sâu"] P2["⭐ Dự đoán
trúng tuyển"] P3["⭐ Gợi ý chiến lược
chọn trường/ngành"] P4["⭐ So sánh
nhóm kỹ năng"] P5["⭐ Báo cáo PDF
chi tiết"] end Free -.->|"Nâng cấp
~50.000 - 100.000đ"| Premium

gantt title Lộ trình phát triển hệ thống CLS - ĐGNL dateFormat YYYY-MM-DD axisFormat %m/%Y section Phase 1 - MVP Phân tích & Thiết kế :done, p1a, 2026-03-01, 30d UI/UX Design :active, p1b, 2026-03-15, 30d Backend Core :p1c, 2026-04-01, 45d Thi & Chấm điểm cơ bản :p1d, 2026-04-15, 45d Testing & Deploy MVP :p1e, 2026-05-15, 15d section Phase 2 - Analytics Phổ điểm & Thống kê :p2a, 2026-06-01, 30d Dashboard học sinh :p2b, 2026-06-15, 30d Biểu đồ tiến bộ :p2c, 2026-07-01, 20d section Phase 3 - AI Premium AI Prediction Model :p3a, 2026-07-15, 45d Gợi ý chọn trường :p3b, 2026-08-01, 30d Payment Integration :p3c, 2026-08-15, 20d section Phase 4 - Scale Mobile App :p4a, 2026-09-01, 60d B2B Features :p4b, 2026-09-15, 45d Performance Optimization :p4c, 2026-10-15, 30d