EDU-12 — Roadmap toàn dự án

Đề gốc: DE-BAI.md · Đây là file flow duy nhất của nhóm, từ hôm nay đến nghiệm thu.

⚠️ Nội dung file này là kế hoạch của nhóm, không phải quy định của BTC — trừ phần Gate 1 (lấy từ thông báo BTC, có đánh dấu 🔒).


0. Sơ đồ tổng

  HÔM NAY (28/7)
        │
        ├───────────────────────────────────────────┐
        │                                           │
   ┌────▼──────────────────────┐          ┌─────────▼──────────────┐
   │ PHASE 0 · SETUP           │          │ PHASE 1 · SPEC         │
   │ (song song, làm ngay)     │          │                        │
   │                           │          │ Đọc tài liệu tuyển sinh│
   │ API key phoenix           │          │        ▼               │
   │  → vào Org GitHub         │          │ Feature list ──► BRIEF │
   │  → clone repo team        │          │        ▼               │
   │  → setup AI Log           │          │ Wireframe ──► WIREFRAME│
   │                           │          │        ▼               │
   │ ──► REPO + AI LOG         │          │ Docs chi tiết ──► PRD  │
   └───────────┬───────────────┘          └─────────┬──────────────┘
               │                                    │
               └────────────────┬───────────────────┘
                                ▼
                    🔒 GATE 1 · nộp 1 link, đủ 4 mục
                         hạn 23:59 · 02/08/2026
                                │
        ┌───────────────────────┴───────────────────────┐
        ▼                                               ▼
 ┌─ PHASE 2A · RAG CORE ─────┐              ┌─ PHASE 2B · APP ──────┐
 │  (ưu tiên, rủi ro cao)    │              │  (chắc ăn)            │
 │                           │              │                       │
 │  Ingestion pipeline       │              │  Xây dựng Database    │
 │  parse → chunk → embed    │              │        ▼              │
 │       → pgvector          │              │  Model (Entity/ORM)   │
 │        ▼                  │              │        ▼              │
 │  Retrieve + Rerank        │              │  Repository           │
 │        ▼                  │              │        ▼              │
 │  Bộ test có nhãn          │              │  Service              │
 │  (~100–200 câu)           │              │  (Business Logic)     │
 │        ▼                  │              │                       │
 │  Eval script              │              │                       │
 │  answer rate + accuracy   │              │                       │
 │        ▼                  │              │                       │
 │  ĐO ACCURACY TRẦN         │              │                       │
 │  (chưa cần API/UI)        │              │                       │
 └───────────┬───────────────┘              └───────────┬───────────┘
             │                                          │
             └──────────────────┬───────────────────────┘
                                ▼
                    ┌─ PHASE 3 · AI AGENT ─────┐
                    │  Tools · Memory          │
                    │  Planner/Router · LLM    │
                    │  Workflow · Guardrails   │
                    │  → xem §4 luồng chạy     │
                    └────────────┬─────────────┘
                                 ▼
                          API (Controller)
                                 ▼
                          Hook / SDK / Client
                                 ▼
                          UI (Next.js)
                                 ▼
                    ┌─ PHASE 4 · NGHIỆM THU ───┐
                    │  Deploy Docker + cloud   │
                    │  Chạy lại eval thật      │
                    │  Đối chiếu KPI đề bài    │
                    │  Dashboard + demo        │
                    └──────────────────────────┘

1. PHASE 0 · Setup (song song — bắt đầu ngay)

Không nằm trong mạch feature → wireframe → docs, nên phải tách nhánh riêng. Có bước phụ thuộc quyền từ BTC → để muộn là không chạy đua bù được.

❓ Ảnh chụp thông báo BTC bị cắt ở bước 2 — cần xem lại tin gốc của “Trợ lý Kute” xem còn bước 3, 4 không.


2. PHASE 1 · Spec → Gate 1

🔒 Deliverable BTC yêu cầu (hạn 23:59 · 02/08/2026 · +100 XP/member · nộp 1 link chứa đủ 4 mục — GitHub / Docs / Drive đều được):

# Deliverable Sinh ra từ bước nào Trạng thái
1 Brief (1 trang, chốt bài toán) Feature list
2 PRD Docs chi tiết
3 Wireframe / UI Flow Wireframe
4 GitHub Repo Setup + AI Log Phase 0

Thứ tự trong Phase 1

Bước 0 — Đọc tài liệu tuyển sinh (nửa buổi). Đặc thù RAG: bot chỉ trả lời được cái có trong tài liệu. Brief/PRD phải cam kết KPI ≥70% answer rate và ≥85% accuracy — viết mà chưa mở tài liệu ra xem thì rất dễ hứa feature dữ liệu không đỡ nổi, mà PRD nộp rồi thì khó rút. Chỉ cần đọc lướt, chưa cần ingestion gì cả.

Bước 1 — Feature list → Brief. Đánh dấu feature nào tài liệu đỡ được, feature nào không.