# BẢNG TỔNG QUAN TIẾN ĐỘ THỰC HIỆN ĐỒ ÁN 2 (TASKPILOT)
> **11/11/2026 — PR #53:** bổ sung PostgreSQL AST schema policy, catalog metadata allowlist và integration fresh/upgrade/backend bắt buộc; 414 test backend và 34 test tooling local đạt. Chưa merge/deploy, không sửa V41/V42 hay RLS. [Bằng chứng và tiêu chí gate](../docs/implementation/flyway/PR53_MIGRATION_GUARDS_2026-11-11.md).
**Học phần**: SE121 - Đồ án 2 | Trường Đại học Công nghệ Thông tin (UIT)
**Thời gian thực hiện**: 01/09/2026 – 01/01/2027
**Sinh viên**: Phan Lê Minh (23520952), Đặng Phú Thiện (23521476)
**Giảng viên hướng dẫn**: ThS. Trần Thị Hồng Yến
---
## 📊 Bảng Theo Dõi Tiến Độ Định Kỳ 2 Tuần (Bi-Weekly Progress Master Index)
| Đợt | Khoảng thời gian | Giai đoạn đề cương | Các kết quả & Milestone chính đạt được | Định lượng kết quả | Báo cáo chi tiết | Trạng thái |
|:---:|:---:|:---:|---|---|:---:|:---:|
| **Đợt 01** | 25/08/2026 – 08/09/2026 | **P0: Tái cấu trúc kiến trúc & Môi trường Cloud** | - Refactor toàn diện Backend & Frontend (-1485 LOC boilerplate).
- Khắc phục 14 failure modes khi deploy lên Hugging Face Spaces (UID 1000, port 7860, Actuator probe fix, musl IPv4).
- Thiết lập bộ kỹ năng Agent tự động hóa (`code-refactor`, `hf-deploy-verifier`, `biweekly-progress-tracker`). | - BE: -397 LOC
- FE: -1088 LOC
- 100% test & build pass
- HF Docker verification: PASS | [Xem chi tiết](logs/period-2026-w35-w36.md) | ✅ Hoàn thành |
| **Đợt 02** | 09/09/2026 – 22/09/2026 | **P1: Phân hệ RAG - Tri thức dự án & Điều phối bất đồng bộ** | - Tích hợp `pgvector`, HNSW index & mô hình canonical `gemini-embedding-2` 768 chiều.
- Xây dựng pipeline trích xuất văn bản Apache Tika (PDF/DOCX/MD/CSV) & recursive chunking.
- Hàng đợi bền vững PostgreSQL (`document_chunk_staging`, V27/V30) hỗ trợ nạp tri thức khôi phục (Resumable Ingestion).
- Bộ điều tiết hạn ngạch 2 chiều (100 RPM, 30k TPM) với Normal Pacing & bảo vệ Headroom chat.
- Thực nghiệm khoa học đo lường Quota Google Gemini: Khẳng định cơ chế tính theo từng input text (20 texts = 20 quota units), tích hợp cơ chế xoay vòng đa khóa (`GEMINI_API_KEYS`).
- Phân quyền RBAC cho Kho tri thức: Manager toàn quyền upload/retry/xóa, Member chỉ đọc & tìm kiếm.
- Tích hợp LangChain4j RAG tool (`searchProjectKnowledge`) vào AI Copilot & giao diện Knowledge tab. | - BE: 121/121 tests pass
- FE: 23/23 tests pass
- Stress test: DOCX 212 chunks pass
- Thực nghiệm Quota: 100% verified
- UAT & RBAC: 100% verified | [Xem chi tiết](logs/period-2026-w37-w38.md) | ✅ Hoàn thành |
| **Đợt 03** | 23/09/2026 – 06/10/2026 | **P1: Embedding & Semantic Search Pipeline** | - Tích hợp embedding model & lưu trữ vector database.
- Xây dựng Semantic Search engine và Retrieval chain với LangChain4j.
- Chatbot trả lời dựa trên context tài liệu. | *Dự kiến: Đạt độ chính xác semantic retrieval > 85%* | *Chưa bắt đầu* | ⏳ Kế hoạch |
| **Đợt 04** | 07/10/2026 – 20/10/2026 | **P2: Khởi tạo Teams-clone - File Storage & Chat Room** | - Module lưu trữ tài liệu dự án `project_files` (Upload S3 50MB, Streaming download, RBAC).
- Chat room thời gian thực `project_chat_messages` với Spring WebSocket STOMP (`/ws/chat`, `/topic/projects/{projectId}/chat`).
- Giao diện frontend hoàn chỉnh: `ProjectFilesTab` & `ProjectChatTab` tích hợp vào workspace. | - BE: 10/10 tests pass
- FE: TypeScript & Vite build 100% pass
- Độ trễ WebSocket < 50ms
- RBAC UAT: 100% verified | [Xem chi tiết](logs/period-2026-w40-w41.md) | ✅ Hoàn thành |
| **Đợt 05** | 21/10/2026 – 03/11/2026 | **P2: Video Meeting & Recording (LiveKit)** | - Tích hợp LiveKit Cloud WebRTC (`LiveMeetingRoom`, token JWT HMAC-SHA256, Video Grants).
- Quản lý trọn vẹn vòng đời cuộc họp (Tạo phòng, Host kết thúc, Banner cuộc họp đang diễn ra, thời lượng họp).
- Ngăn kéo thành viên & trò chuyện trong phòng họp thời gian thực.
- 17 ảnh chụp UAT độ phân giải cao phục vụ báo cáo. | - BE: 8/8 tests pass (100%)
- FE E2E: 30/30 tests pass (100%)
- Toàn phân hệ Collab: 130/130 pass
- Flyway V33: 100% applied | [Xem chi tiết](logs/period-2026-w42-w43.md) | ✅ Hoàn thành |
| **Đợt 06** | 04/11/2026 – 17/11/2026 | **Observability & Identity Provider (IAM)** | - Triển khai Prometheus & Grafana giám sát metrics trên HF Space riêng.
- Tích hợp Authentik IAM hỗ trợ Social Login (Google/GitHub) & SSO. | *Dự kiến: Dashboard giám sát thời gian thực 100%* | *Chưa bắt đầu* | ⏳ Kế hoạch |
| **Đợt 07** | 18/11/2026 – 01/12/2026 | **Adaptive Weights & Dashboard phân tích** | - Hiện thực thuật toán học trọng số thích ứng (Online Gradient Descent).
- Dashboard phân tích thống kê tiến độ, velocity, workload dự án. | *Dự kiến: Thuật toán tự học cải thiện 25% độ hài lòng PM* | *Chưa bắt đầu* | ⏳ Kế hoạch |
| **Đợt 08** | 02/12/2026 – 15/12/2026 | **Đánh giá hiệu năng, Viết tài liệu báo cáo & Nghiệm thu** | - Hoàn thiện tài liệu báo cáo Đồ án 2 theo mẫu UIT.
- Benchmark hiệu năng hệ thống, kiểm thử tải toàn diện.
- Chuẩn bị slide thuyết trình và video demo sản phẩm. | *Dự kiến: Báo cáo hoàn chỉnh > 100 trang, demo 100% kịch bản* | *Chưa bắt đầu* | ⏳ Kế hoạch |
### Báo cáo bổ sung theo 14 ngày gần nhất (không tính là một đợt riêng)
| Khoảng thời gian | Kết quả ghi nhận | Báo cáo chi tiết | Lưu ý |
|---|---|---|---|
| 27/10/2026 – 09/11/2026 | OAuth2 Google/GitHub; công cụ AI cho tệp, trò chuyện và cuộc họp; sửa lỗi cộng tác; trên nhánh riêng có bản sửa lỗi sản phẩm và quy trình CI Playwright. | [Xem chi tiết](logs/period-2026-10-27-to-2026-11-09.md) | Trùng một phần đợt 05 và 06; bản sửa lỗi sản phẩm và CI chưa merge `main`; chưa xác minh kết quả chạy CI/UAT. |
### Cập nhật kỹ thuật Flyway — 10/11/2026
Đã merge PR #51/#52 và phát hành bản cứu hộ. CSDL nguồn đã tiếp nhận Flyway V42, validate đạt, không còn migration chờ; giữ nguyên 458 tài khoản, toàn bộ dữ liệu nghiệp vụ và 41 dòng lịch sử cũ. Hồi quy 408 test backend, 89 unit frontend, 149 UI mô phỏng và integration trình duyệt/backend thật đạt; live smoke sau deploy thành công, tài khoản thử đã dọn. [Kết quả phát hành và giới hạn](../docs/implementation/flyway/RECOVERY_RELEASE_2026-11-10.md).
Quy tắc làm việc tiếp theo: [workflow hai người/DB chung](../docs/development/FLYWAY_TEAM_WORKFLOW.md), [SKILL.md độc lập](../.agents/skills/taskpilot-flyway-team/SKILL.md); helper chỉ đọc version/checksum, số đề xuất chưa được giữ chỗ. RLS có sẵn và các provider cloud thật chưa được coi là đã kiểm chứng hoàn tất.
---
## 🔗 Liên Kết Kho Mã & Báo Cáo
- **Backend Service**: [taskpilot-platform/taskpilot](https://github.com/taskpilot-platform/taskpilot)
- **Frontend App**: [taskpilot-platform/taskpilot-frontend](https://github.com/taskpilot-platform/taskpilot-frontend)
- **Hệ Thống Báo Cáo (Typst/Latex)**: [taskpilot-platform/report](https://github.com/taskpilot-platform/report)
- **Landing Page**: [taskpilot-platform.github.io](https://taskpilot-platform.github.io)