Ma trận bao phủ tài liệu
Trang này dùng để tự kiểm tra: tài liệu đã đủ trả lời các câu hỏi bảo vệ, vận hành và sửa code chưa. Nếu một câu hỏi chưa biết mở trang nào, bắt đầu từ bảng này.
Mức bao phủ hiện tại
| Mảng cần nắm | Trạng thái docs | Trang chính | Evidence hiện có |
|---|---|---|---|
| Trả lời nhanh khi bảo vệ | Đã có | Bản đồ trả lời nhanh | Câu trả lời 60 giây, 12 luồng nghiệp vụ, câu nên/không nên nói, lệnh kiểm nhanh |
| Kiểm toán độ sẵn sàng | Đã có | Kiểm toán độ sẵn sàng | Requirement audit theo yêu cầu gốc, evidence build/link/search/font/schema/browser, claim hygiene |
| Sơ đồ thư mục và luồng file | Đã có | Sơ đồ thư mục và luồng file | Ảnh SVG cây thư mục, luồng mở file khi sửa UI/logic/API/DB, giải thích 107 SQL vs 108 file |
| Công nghệ sử dụng | Đã có | Câu hỏi bảo vệ, Kiến trúc | Tech stack backend/frontend/storage/video/offline |
| Cách chạy local | Đã có | Chạy local và sửa code | Backend Docker, frontend Angular, docs port 4010, cảnh báo port 8088 |
| Kiến trúc tổng quan | Đã có | Kiến trúc, Sơ đồ | Runtime map, Clean Architecture, publication, Wiii, video, payment |
| Backend DDD/Clean Architecture | Đã có | Backend, Vị trí file code | Controller -> use case -> repository port -> adapter/JPA |
| Frontend Angular | Đã có | Frontend, Source map | Angular 20, signals, feature folders, route/component/service |
| UX/UI và design system | Đã có | UX/UI và design system, Frontend | Design token #0056D2, role layout, course editor UX, Toast/ConfirmDialog, responsive smoke |
| Vị trí file code khi sửa | Đã có | Vị trí file code, Symbol index | Sửa UI, logic, API, DB, upload, video/offline |
| Luồng nghiệp vụ end-to-end | Đã có | Luồng nghiệp vụ, Câu hỏi bảo vệ | Auth, course, publication, learning, assessment, upload, video, payment, Wiii |
| Database/schema | Đã có | Database, SQL schema catalog, Database timeline | 78 application tables, 2 materialized views, 107 migration SQL files |
| DBeaver/ERD | Đã có | Database, DB sống và ERD DBeaver, SQL schema catalog | Có ảnh ERD tổng, sơ đồ domain dễ học, row estimate và cảnh báo không chiếu credential |
| Wiii/AI an toàn | Đã có | Wiii, Luồng nghiệp vụ, Câu hỏi bảo vệ | data-wiii-id, data-wiii-click-safe, preview/diff, dangerous mutation list |
| Video/offline/PWA | Đã có | Video và offline, Interactive video và storage health | Shaka, ABR, R2, video worker, IndexedDB/Dexie, offline sync |
| Payment/revenue | Đã có | Payment và revenue, Câu hỏi bảo vệ | VNPay, SePay, callback/webhook, payment_transactions, payout |
| Quiz/assignment/grading | Đã có | Assessment nâng cao, Luồng nghiệp vụ | Question bank, quiz attempt, assignment submission, rubric, grading audit |
| Roles/permission | Đã có | Roles và permission, Câu hỏi bảo vệ | ADMIN, ORG_ADMIN, TEACHER, STUDENT, ownership boundary |
| STCW/competency | Đã có | STCW competency map, SQL schema catalog | Maritime standards, competencies, lesson mappings |
| Deploy docs Cloudflare | Đã có | Deploy docs lên Cloudflare | Pages Direct Upload, Worker static assets fallback, custom domain docs.holilihu.online, không tự deploy production |
| Troubleshooting/demo lỗi | Đã có | Troubleshooting, Chạy local | Backend, PWA, font/encoding, course publication, payment, Wiii |
| Thuật ngữ tra nhanh | Đã có | Thuật ngữ tra nhanh | DDD, publication, content_blocks, ABR, Pointy, R2, ports |
| Luyện vấn đáp | Đã có | Bộ câu hỏi luyện vấn đáp, Câu hỏi bảo vệ | Câu hỏi theo nhóm kiến trúc, flow, DB, Wiii, video, payment, sửa code |
| Kịch bản demo/báo cáo | Đã có | Kịch bản demo và báo cáo | Script 10 phút, 15 phút, mở code khi thầy hỏi, xử lý demo lỗi |
| Quality gate docs | Đã có | Checklist chất lượng docs | Font/encoding, UX/UI, search, link, build, evidence |
Câu hỏi kiểm tra độ sẵn sàng
| Câu hỏi | Nếu trả lời chưa chắc thì mở |
|---|---|
| Em mô tả hệ thống trong 60 giây như thế nào? | Câu hỏi bảo vệ |
| Làm sao chứng minh docs hiện đủ, không lỗi font và không nói quá? | Kiểm toán độ sẵn sàng, Checklist chất lượng docs |
| Một request đi từ Angular đến database qua những lớp nào? | Backend, Luồng nghiệp vụ |
| Cây thư mục backend/frontend/docs chia thế nào? | Sơ đồ thư mục và luồng file, Source map |
| Vì sao learner không đọc draft course trực tiếp? | Publication |
| Database có bao nhiêu bảng, vì sao V135 không có nghĩa là 135 bảng? | SQL schema catalog |
| Nếu thầy bảo đổi màu nút hoặc sửa logic, mở file nào trước? | Vị trí file code |
| Giao diện thiết kế có hợp lý không, đổi màu/layout ở đâu? | UX/UI và design system, Frontend |
Muốn đưa docs lên docs.holilihu.online thì làm thế nào? |
Deploy docs lên Cloudflare |
| Wiii/Pointy được click gì và không được click gì? | Wiii, Câu hỏi bảo vệ |
| Video lớn được xử lý ra sao để backend không nghẽn? | Video và offline, Runtime |
| Payment tránh user tự sửa giá thế nào? | Payment và revenue, Câu hỏi bảo vệ |
| Nếu 20.000 hoặc 500.000 người vào cùng lúc thì trả lời thế nào? | Câu hỏi bảo vệ |
Cách dùng trước ngày báo cáo
- Mở Bản đồ trả lời nhanh để nắm câu trả lời 60 giây và 12 luồng cốt lõi.
- Mở Kiểm toán độ sẵn sàng để biết claim nào có evidence và claim nào phải nói thận trọng.
- Đọc Câu hỏi bảo vệ để lấy câu trả lời mẫu.
- Đọc Luồng nghiệp vụ để hiểu UI -> API -> use case -> DB.
- Mở Vị trí file code để luyện tình huống “sửa ở đâu”.
- Mở SQL schema catalog để chắc số bảng, tên bảng và migration.
- Luyện theo Bộ câu hỏi luyện vấn đáp.
- Chạy qua Kịch bản demo và báo cáo, rồi kiểm Checklist chất lượng docs.
Không cần học thuộc từng file. Mục tiêu là nói được luồng, biết mở đúng file, biết bảng dữ liệu chính, và nêu được ranh giới an toàn của các vùng nhạy cảm như Wiii, payment, grading, publish/delete.