Audit #002 — 2026-08-15
Chấm theo Audit Standard AS-01..AS-10 v0.2 (255 chỉ báo, 10 bộ, AS-04 có 6 tiêu chí) trên commit 89a3db46a1, branch main, cộng production thật (D1 nemo12-platform remote, GitHub Actions thật qua gh run list/gh api, Cloudflare Queues/Access thật).
Phương pháp: ba lượt chấm độc lập được hợp nhất theo đúng thứ tự ưu tiên ghi trong nhiệm vụ — (1) chấm gốc theo cả 10 bộ, (2) chấm sâu riêng 18 chỉ báo 🚸 Pilot Gate, (3) một lượt phản biện chạy lại phần lớn bằng chứng bằng lệnh độc lập (không tin lời agent trước). Với mỗi chỉ báo: nếu phản biện có chạm tới, verdict cuối cùng là của phản biện (kể cả khi nó ghi đè verdict Pilot Gate); nếu không, chỉ báo trong danh sách Pilot Gate dùng verdict Pilot Gate; còn lại dùng verdict chấm gốc. Toàn bộ 255/255 chỉ báo đã có bằng chứng trong ba lượt trên — không có chỉ báo nào phải tự chấm bổ sung ở bước rà soát này.
1. Tổng kết
| Bộ | PASS/tổng | % | Mức |
|---|---|---|---|
| AS-01 Tài liệu & Đóng vết | 19/25 | 76% | Vững |
| AS-02 Yêu cầu & Sản phẩm | 17/25 | 68% | Đang dựng |
| AS-03 Kiến trúc & Hợp đồng API | 20/25 | 80% | Vững |
| AS-04 Dữ liệu & Migration | 15/30 | 50% | Đang dựng |
| AS-05 Trí tuệ học tập & Thuật toán | 17/25 | 68% | Đang dựng |
| AS-06 Nội dung & Tri thức | 8/25 | 32% | Sơ khai |
| AS-07 Bảo mật, Riêng tư & Tuân thủ | 16/25 | 64% | Đang dựng |
| AS-08 Tin cậy & Vận hành | 19/25 | 76% | Vững |
| AS-09 Trải nghiệm & Design System | 7/25 | 28% | Sơ khai |
| AS-10 AI Governance & Chi phí | 19/25 | 76% | Vững |
| Toàn hệ | 157/255 | 61,6% | Đang dựng |
text
Mức trưởng thành: Sơ khai < 50% │ Đang dựng 50-69% │ Vững 70-84% │ Chín 85-94% │ Chuẩn mực ≥95%
AS-03 ████████████████░░░░ 80%
AS-08 ███████████████░░░░░ 76%
AS-01 ███████████████░░░░░ 76%
AS-10 ███████████████░░░░░ 76%
AS-02 █████████████░░░░░░░ 68%
AS-05 █████████████░░░░░░░ 68%
AS-07 ████████████░░░░░░░░ 64%
AS-04 ██████████░░░░░░░░░░ 50%
AS-06 ██████░░░░░░░░░░░░░░ 32%
AS-09 █████░░░░░░░░░░░░░░░ 28%Điểm hệ so với sàn REQ-DOC-06 (≥225/255, ~88%): 157/255 = 61,6% — thiếu 68 chỉ báo để chạm sàn mở người dùng thật theo REQ-DOC-06. Đây là ngưỡng dài hạn cho toàn hệ, không phải điều kiện cho đợt pilot 2 ngày cụ thể sắp tới — theo quyết định ✍️ Q-128, điều kiện go/no-go cho pilot là 🚸 Pilot Gate (§4 dưới đây), không phải con số này.
Điều kiện release (dài hạn, §3.1 audit-standard/index.md): KHÔNG ĐẠT — vẫn còn 9/30 chỉ báo 🔴 KHÔNG PASS (xem §3), 2 bộ dưới 60% (AS-06 32%, AS-09 28%), điểm hệ 61,6% < 70%.
2. Đọc đúng — tách KHÔNG PASS theo mã lý do
| Mã | Số lượng | % trong tổng 98 KHÔNG PASS |
|---|---|---|
| HH (hỏng — có phản ví dụ thật) | 56 | 57% |
| CX (chưa xây) | 29 | 30% |
| CM (chưa chứng minh) | 13 | 13% |
Chỉ số đáng lo thật sự là %HH trong tổng KHÔNG PASS = 57% — cao hơn mong đợi cho một hệ 0 ngày tuổi kể từ Audit #001 (cùng ngày). Nghĩa là hơn một nửa số KHÔNG PASS không phải "chưa kịp làm" mà là có bằng chứng cụ thể cho thấy nó sai — code tồn tại, chạy được, và ra kết quả không đúng luật. Đây là hệ quả trực tiếp của một ngày có ~10 phiên AI cùng sửa song song: nhiều tính năng mới (Orca, community events, Whale, labs) được dựng nhanh nhưng docs/schema/pipeline chất lượng không theo kịp, và một script sửa nội dung thẳng production (
apply-review-fixes.mjs) đã bỏ qua toàn bộ vòng đời publish đã xây.Ngược lại, 30% CX là kỳ vọng hợp lý ở giai đoạn này (ngân hàng đề thật, Media System, artifact luật tối giản AS-09.1 đều chưa tới lượt xây) và 13% CM là nợ rẻ nhất để đóng — phần lớn chỉ cần ai đó ngồi rà/viết test, không cần sửa kiến trúc.
3. 🔴 Chặn release — 30 chỉ báo (v0.2), 9 đang KHÔNG PASS
| Chỉ báo | Mã | Sự thật quan sát được |
|---|---|---|
| AS-06.3.1 | HH | scripts/apply-review-fixes.mjs UPDATE thẳng 679 dòng items production qua REST API, bypass hoàn toàn route PATCH (chặn 409) và toàn bộ vòng đời candidate→publish đã xây |
| AS-06.4.2 | CX | 0 đề thi thật (source='real') tồn tại; R2 bucket nội dung rỗng — không có gì để kiểm "chỉ lưu URL không lưu file" |
| AS-06.4.3 | CX | 0 đề thật để spot-check lời giải tự biên soạn |
| AS-07.1.1 | HH | GET /v1/coral/labs thiếu requireSession trong danh sách .use() — tái hiện được: curl ẩn danh vào route chạy local → HTTP 500 crash (session=undefined cho MỌI caller, kể cả staff hợp lệ) |
| AS-07.3.2 | HH | enforceConsent() không có lời gọi thật nào trong repo; cơ chế duy nhất (requireConsent) chỉ chặn khi phụ huynh đã rút đồng thuận, không chặn khi chưa từng được hỏi — 0 dòng consents production, 0 màn hình consent frontend |
| AS-09.3.1 | CM | axe-core thật chạy trên 3 màn chính: rule color-contrast luôn rơi vào incomplete vì hero dùng gradient phức tạp — không đo được dứt khoát bằng công cụ tự động, cần đo pixel-level |
| AS-10.3.1 | CX | buildLearnerContext() chỉ được gọi trong test, 0 route sản xuất nào gọi — AI hiện không chạm learner data qua bất kỳ đường nào, kể cả Context Builder; bất biến "đường duy nhất" đúng một cách rỗng (tính năng nó bảo vệ chưa tồn tại) |
| AS-04.6.3 | HH | Schema-diff thật: whale_scholarships lệch DDL text giữa production và migrate:dryrun cục bộ (dấu phẩy đầu dòng khác — hệ quả 2 lịch sử ALTER khác nhau), mâu thuẫn tuyên bố "giống hệt production" ghi trong 0031_whale_country_detail.sql |
| AS-03.5.3 | HH | Branch protection 403 (plan không phải Pro); README/CLAUDE.md không có câu cấm tường minh "không apply migration production ngoài CI"; và chính AS-04.6.1 đang có 2 dòng mồ côi phát sinh cùng ngày — cả 3 nhánh thoát trong "cách kiểm" đều fail |
21/30 🔴 còn lại đã PASS, gồm cả 4 chỉ báo mới/nâng cấp trong v0.2: AS-04.6.1 (đối soát 2 mồ côi đã ghi lại đúng), AS-04.6.4 (0 vi phạm tương thích ngược kể từ baseline), AS-01.4.1, AS-03.2.4, AS-03.4.1, AS-04.1.1, AS-04.1.4, AS-04.2.2, AS-05.2.2, AS-05.4.1, AS-07.2.1, AS-07.2.2, AS-07.2.3, AS-07.5.1, AS-07.5.2, AS-08.2.2, AS-08.4.3, AS-10.1.1, AS-10.1.2, AS-10.3.5, AS-10.4.1.
4. 🚸 Pilot Gate — điều kiện mở thử 2 ngày tới
Theo Audit Standard §3.3 và quyết định ✍️ Q-128, đây — không phải điểm hệ toàn phần — là điều kiện go/no-go cho đợt mở thử 10 phụ huynh thật sắp tới. 100% 18 chỉ báo dưới đây phải PASS.
| Chỉ báo | PASS? | Bằng chứng |
|---|---|---|
| AS-07.1.1 | ❌ HH | Tái hiện thật: curl local → HTTP 500 trên /v1/coral/labs (thiếu requireSession) |
| AS-07.2.1 | ✅ | Mọi module chạm learner_id gọi canAccessLearner/requireLearnerAccess/tương đương |
| AS-07.2.3 | ✅ | 3 file authz.test.ts, 35/35 PASS, có test phủ định family khác |
| AS-07.3.2 | ❌ HH | Đồng thuận không chặn learner mới chưa từng được hỏi; 0 màn hình consent |
| AS-07.1.4 | ✅ | curl ẩn danh admin/dolphin/coral đều 302 Cloudflare Access login |
| AS-04.6.1 | ✅ | Đối soát 41 remote vs 39 đĩa, 2 mồ côi đã ghi lại đúng trong migration-reconciliation.md |
| AS-04.6.3 | ❌ HH | Schema-diff thật phát hiện whale_scholarships lệch DDL production vs local dryrun |
| AS-04.6.4 | ✅ | 0 vi phạm tương thích ngược trong migration kể từ baseline 2026-08-15 |
| AS-04.1.1 | ✅ | 39 file liên tục 0001-0039; CI enforce xanh tại commit snapshot |
| AS-04.5.5 | ❌ CX | docs/ops/backup-restore-drill.md chưa tồn tại — 0 lần diễn tập backup/restore |
| AS-03.5.3 | ❌ HH | Cả 3 nhánh thoát của "cách kiểm" đều fail (xem §3) |
| AS-08.4.1 | ✅ | ci.yml+deploy-api.yml không escape hatch; gh run list xác nhận chạy thật |
| AS-08.2.2 | ✅ | wrangler queues list thật xác nhận cả nemo12-events và nemo12-events-dlq tồn tại |
| AS-01.4.1 | ✅ | gen:reference 0 diff, xác nhận độc lập nhiều lần |
| AS-03.2.4 | ✅ | contract:diff 139 route, không breaking change, có ở cả 2 workflow |
| AS-10.3.1 | ❌ CX | Context Builder chưa được route sản xuất nào gọi — AI chưa chạm learner data qua đường nào |
| AS-10.3.5 | ✅ | context-builder.test.ts (tên khác quy ước glob trong "cách kiểm") 12/12 PASS, cách ly A/B thật |
| AS-10.4.1 | ✅ | Cả 2 đường sinh nội dung AI đều có cổng người/ngưỡng trước khi publish |
Go/No-go: 12/18 — KHÔNG ĐẠT 100%. Kết luận: NO-GO cho đợt mở thử 2 ngày tới ở trạng thái hiện tại.
6 chỉ báo chặn: AS-07.1.1, AS-07.3.2, AS-04.6.3, AS-04.5.5, AS-03.5.3, AS-10.3.1. Ba trong số này (AS-07.1.1, AS-03.5.3, AS-04.6.3) từng được lượt chấm Pilot Gate ban đầu đánh PASS dựa trên đọc tĩnh (grep/diff) — lượt phản biện chạy lại bằng chứng động (khởi động dev server thật, phân tích DDL text thật, đối chiếu 3 điều kiện "cách kiểm" từng câu) và lật lại thành KHÔNG PASS. AS-10.3.1 bị lật theo hướng ngược lại: từ PASS (cả chấm gốc lẫn Pilot Gate) sang KHÔNG PASS/CX, vì phản biện chỉ ra bất biến "Context Builder là đường duy nhất" đang đúng một cách rỗng — chưa có tính năng AI nào chạm learner data để có đường vòng.
5. Chi tiết theo chỉ báo (10 bộ, 255 chỉ báo)
AS-01 — Tài liệu & Đóng vết · 19/25 (76%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 01.1 Nguồn duy nhất & sổ tiếp nhận | |||
| 1.1 | ❌ | HH | Xác nhận bằng lệnh production thật: cả 4 tên migration (2 cũ+2 mới) đều tồn tại remote, chứng minh tiền đề migrations/README.md §3 sai, mâu thuẫn docs/ops/migration-reconciliation.md |
| 1.2 | ✅ | — | intake.md 128 dòng SRC-001..128 đủ 5 cột, 0 lỗi định dạng ngày, dòng cuối khớp SRC-129 |
| 1.3 | ❌ | HH | 28 SRC ID không có hit ngoài intake.md, xác nhận lại đúng |
| 1.4 | ✅ | — | 128 dòng, 128 ID duy nhất, liên tục 001..128, "Nguồn tiếp theo"=129 khớp |
| 1.5 | ❌ | HH | Cùng bằng chứng 1.1 — migrations/README.md là đặc tả hệ thống thật, mâu thuẫn nội dung |
| 01.2 Frontmatter & metadata | |||
| 2.1 | ✅ | — | check-docs.mjs QG-001 PASS, 64 docs sạch frontmatter |
| 2.2 | ✅ | — | 64 file đủ 8 trường bắt buộc |
| 2.3 | ✅ | — | 64 id duy nhất, lowercase, khớp vai trò file |
| 2.4 | ✅ | — | 0 file có type ngoài tập cho phép |
| 2.5 | ✅ | — | 0 file status ngoài {draft,active,deprecated}, 0 deprecated hiện tại |
| 01.3 Đóng vết hai chiều | |||
| 3.1 | ✅ | — | check-docs mục 2: 0 lỗi trace closure; mọi REQ ✔ có SDD |
| 3.2 | ✅ | — | 221 REQ ✔-M đều có QG-\d+ |
| 3.3 | ✅ | — | 18/18 SDD có sources:; 0 tham chiếu SRC hỏng |
| 3.4 | ❌ | HH | 2 file mồ côi: reference/config.md, ops/migration-reconciliation.md — 0 markdown link trỏ tới, không có trong reference/index.md |
| 3.5 | ❌ | HH | REQ-LRN-19/20/21 (MUST active) thiếu hoàn toàn khỏi §6, 0 US/WF nào nhắc tới |
| 01.4 Trang sinh tự động khớp source | |||
| 4.1 🔴🚸 | ✅ | — | gen:reference chạy lại, git diff --stat rỗng — xác nhận độc lập nhiều lần |
| 4.2 | ✅ | — | 79 bảng CREATE TABLE khớp 79 mục trong data-dictionary.md |
| 4.3 | ✅ | — | contract:diff: 139 route /v1, api.md khai đúng |
| 4.4 | ✅ | — | events.md 25 publish/21 event khớp EVENT_REGISTRY, 0 diff |
| 4.5 | ✅ | — | cả 3 trang tự sinh có dòng cảnh báo "sinh tự động" |
| 01.5 Tươi mới & vòng đời | |||
| 5.1 | ✅ | — | 0 file active có last_reviewed >90 ngày |
| 5.2 | ❌ | HH | 5/5 commit spot-check sửa REQ đáng kể không bump version (PRD-001 vẫn 0.6) |
| 5.3 | ✅ | — | check-docs mục 4: 0 link gãy trong 64 file |
| 5.4 | ✅ | — | 11 hit "tuần trước/gần đây/sắp tới", đếm lại đúng — tất cả là ngôn ngữ UI hoặc tự tham chiếu luật |
| 5.5 | ✅ | — | 49 dòng ✍️ trong open-questions/index.md, spot-check tham chiếu chéo khớp |
AS-02 — Yêu cầu & Sản phẩm · 17/25 (68%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 02.1 Chất lượng REQ catalog | |||
| 1.1 | ❌ | HH | Nhóm REQ ORC (9 REQ, Orca competitions) dùng thật nhưng không có trong bảng nhóm conventions.md §2 |
| 1.2 | ❌ | HH | REQ-BRD-07 dòng 243 dùng "tốt hơn" — khớp điều kiện cơ học của cách-kiểm (hit trong dòng REQ) |
| 1.3 | ✅ | — | 0 kết quả M?/S?/C? trong PRD-001 |
| 1.4 | ✅ | — | 259 dòng REQ §5, 0 dòng cột Nguồn rỗng |
| 1.5 | ✅ | — | proxy token-overlap, cặp trùng cao nhất 75% < ngưỡng 80% |
| 02.2 User story & acceptance criteria | |||
| 2.1 | ✅ | — | 83/83 US đúng format As a **...** |
| 2.2 | ✅ | — | 12 biến thể persona, mọi biến thể phân rã về 4 persona gốc |
| 2.3 | ✅ | — | cột AC riêng, 0/83 dòng rỗng |
| 2.4 | ✅ | — | AC mô tả hành vi quan sát được, 0 hit tên bảng/hàm/biến kỹ thuật |
| 2.5 | ❌ | HH | US-38/REQ-COM-03 ✔ nhưng không có màn hình forum learner thật (0 route/UI dùng) |
| 02.3 Persona, JTBD & phủ vai trò | |||
| 3.1 | ✅ | — | 4 persona active đều có ≥1 JTBD ghi nhận |
| 3.2 | ✅ | — | mọi JTBD có REQ cụ thể phục vụ |
| 3.3 | ✅ | — | 3 cộng đồng đều có WF onboarding riêng, status active |
| 3.4 | ❌ | HH | REQ-SCH-10 trỏ SDD-011 cho Octopus nhưng SDD-011 xác nhận 0 hit Octopus |
| 3.5 | ✅ | — | §8 bản đồ màn hình↔persona↔REQ tồn tại; sampling không thấy màn hình mồ côi |
| 02.4 Phạm vi & ưu tiên | |||
| 4.1 | ✅ | — | 0/259 REQ ✔ thiếu SDD/QG |
| 4.2 | ✅ | — | sampling learn/marlins/web: mọi route đối chiếu được với REQ |
| 4.3 | ✅ | — | 40 hit CC-/FEAT- đều là cột Nguồn hợp lệ, 0 dòng backlog lẫn bảng REQ chính |
| 4.4 | ❌ | CX | legacy-feature-inventory.md (status draft) không có cột "Phân loại" 4 giá trị như chỉ báo yêu cầu |
| 4.5 | ✅ | — | chỉ 1 REQ MUST ⏳ (REQ-INT-19), có lý do+ngày đầy đủ |
| 02.5 Quyết định mở & phê duyệt | |||
| 5.1 | ✅ | — | 165 Q, mọi Q rỗng ở bảng chính đều có dòng ✍️ tương ứng |
| 5.2 | ❌ | HH | 16/29 dòng ✍️ Đợt 1 vi phạm ngưỡng ≥15 ký tự (đếm lại khớp) |
| 5.3 | ✅ | — | artifact rà mâu thuẫn ✍️ có ngày hôm nay, khai luật ưu tiên, liệt kê 6 chỗ lệch, khai phạm vi rà |
| 5.4 | ❌ | HH | bảng "Việc còn chờ chủ dự án" chỉ 2 cột, thiếu cột Trạng thái |
| 5.5 | ❌ | CX | 0 kết quả "Đã vào" trong toàn file — cơ chế đóng vết Q chưa xây |
AS-03 — Kiến trúc & Hợp đồng API · 20/25 (80%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 03.1 Ranh giới module & monorepo | |||
| 1.1 | ✅ | — | 1 hit createRoute ngoài modules/ (health route), khớp bảng ngoại lệ |
| 1.2 | ❌ | HH | Lệnh literal chỉ bắt import 2-cấp (0 hit); lệnh mở rộng đúng ý đồ chỉ báo tìm ra 23 import chéo 1-cấp giữa module, không qua shared/ |
| 1.3 | ✅ | — | fetch( chỉ nằm trong đúng 1 file src/api.ts/app |
| 1.4 | ✅ | — | 0 custom property tự định nghĩa lại trong apps/*/src/*.css |
| 1.5 | ✅ | — | ls apps/ workers/ khớp README; apps/data đã ngừng ghi rõ |
| 03.2 Hợp đồng API | |||
| 2.1 | ✅ | — | 0 file openapi.yaml/json ngoài snapshot |
| 2.2 | ❌ | HH | PATCH /v1/content/items/{itemId} thiếu response 2xx (chỉ 401/409) trong OpenAPI sinh ra |
| 2.3 | ✅ | — | 124 path, 0 path không bắt đầu /v1 |
| 2.4 🔴🚸 | ✅ | — | contract:diff 139 route, không breaking change; có ở cả ci.yml và deploy-api.yml |
| 2.5 | ❌ | HH | POST /v1/auth/google body rỗng → rò nguyên ZodError thô, tái hiện 2 lần |
| 03.3 Hợp đồng event/queue | |||
| 3.1 | ✅ | — | 21 entry EVENT_REGISTRY đều có version+payload zod object |
| 3.2 | ✅ | — | đối soát 2 chiều publishEvent()↔registry khớp 100% |
| 3.3 | ✅ | — | 21 tên event domain.entity.action, action thì quá khứ |
| 3.4 | ✅ | — | assertNoFreeText tồn tại+được gọi; 0 z.string() trần trong payload |
| 3.5 | ✅ | — | wrangler.jsonc khớp đúng số queues.md |
| 03.4 Vệ sinh secret/config | |||
| 4.1 | ✅ | — | 0 pattern key/secret/token hardcode trong source hiện tại lẫn git history (đúng regex gốc) |
| 4.2 | ✅ | — | host nemo12.com chỉ dùng cho điều hướng chéo app hợp lệ |
| 4.3 | ✅ | — | verify-bindings.mjs --offline: Lớp A sạch |
| 4.4 | ❌ | CM | gh run CI thật: KV/R2 không verify được vì token thiếu scope, lặp lại ổn định |
| 4.5 | ✅ | — | verify-bindings.mjs Lớp B sạch, config.md khớp mọi binding+var |
| 03.5 Cấu trúc & kỷ luật pipeline deploy | |||
| 5.1 | ✅ | — | 9 wrangler.jsonc ↔ 9 deploy-*.yml, path filter khớp |
| 5.2 | ✅ | — | cả 9 wrangler.jsonc có routes/custom_domain, không *.workers.dev trần |
| 5.3 | ❌ | HH | 403 Pro + 0 câu cấm tường minh trong README/CLAUDE.md + 2 mồ côi thật phát sinh cùng ngày — cả 3 nhánh thoát đều fail |
| 5.4 | ✅ | — | deploy-api.yml: apply migration đứng trước deploy worker |
| 5.5 | ✅ | — | 9/9 URL production trả 2xx/3xx, khớp custom_domain |
AS-04 — Dữ liệu & Migration · 15/30 (50%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 04.1 Kỷ luật viết migration | |||
| 1.1 🔴🚸 | ✅ | — | 39 file liên tục 0001-0039; CI enforce xanh tại commit snapshot |
| 1.2 | ✅ | — | grep -L IF NOT EXISTS: 0 câu lệnh thật thiếu (5 hit ban đầu đều trong comment) |
| 1.3 | ✅ | — | 0 DELETE FROM; 4 UPDATE đều có WHERE lọc cụ thể |
| 1.4 🔴🚸 | ✅ | — | migrate:dryrun 39/39 OK, exit 0 |
| 1.5 | ✅ | — | wrangler d1 migrations list --remote → No migrations to apply |
| 04.2 Thiết kế schema | |||
| 2.1 | ✅ | — | script Python độc lập parse CREATE TABLE, 0/78 bảng thiếu PK |
| 2.2 🔴 | ✅ | — | 0 REFERENCES users(email); users.id là PK, email chỉ UNIQUE |
| 2.3 | ❌ | HH | 67/68 cột *_id thiếu REFERENCES, chỉ 1 miễn trừ tường minh trong dictionary |
| 2.4 | ❌ | HH | community_events.starts_at lệch UTC (+07:00 thay vì Z) trên dữ liệu thật |
| 2.5 | ✅ | — | 0 json_extract/LIKE '%' trên cột *_json trong WHERE/ORDER BY |
| 04.3 Ngữ nghĩa & enum | |||
| 3.1 | ✅ | — | chạy lại gen-reference.mjs, git diff data-dictionary.md rỗng |
| 3.2 | ❌ | HH | 160 dòng mô tả cột rỗng hoàn toàn (—) |
| 3.3 | ❌ | HH | 79 mục doc vs 78 bảng thật — interaction_votes_rebuilt là bảng ma (RENAME không track) |
| 3.4 | ❌ | HH | CHECK nhiều dòng bị cắt cụt (learner_goal_entries.kind, model_kind thiếu enum) |
| 3.5 | ❌ | HH | community_events/community_event_registrations status enum không có mục trong state-machines.md |
| 04.4 Toàn vẹn vận hành | |||
| 4.1 | ❌ | HH | 5 seed script mặc định --remote production, dùng --yes, không dừng xác nhận |
| 4.2 | ❌ | HH | 20/23 seed script hardcode DB ID production, không nhánh chạy local |
| 4.3 | ❌ | CM | PRAGMA foreign_key_check rỗng nhưng chỉ có nghĩa khi AS-04.2.3 PASS — đang fail nên không phải bằng chứng toàn vẹn thật |
| 4.4 | ❌ | CX | 0 kết quả "khóa nghiệp vụ" trong data-dictionary.md — artifact chưa tồn tại |
| 4.5 | ❌ | HH | 24 dòng thiếu cặp _en trên production (subjects 4, strands 20) |
| 04.5 Riêng tư & lưu trữ | |||
| 5.1 | ❌ | HH | 4/10 chính sách retention có keep_days=NULL (không >0) |
| 5.2 | ✅ | — | endpoint deletion-requests đầy đủ, đặc tả luồng trong data-semantics.md §7 |
| 5.3 | ✅ | — | data-semantics.md §6 tự gắn mã AS-04.5.3, chính sách rõ ràng có lý do |
| 5.4 | ✅ | — | data-semantics.md §5: 17 trường PII, danh sách đóng, lý do không rỗng |
| 5.5 🔴🚸 | ❌ | CX | docs/ops/backup-restore-drill.md chưa tồn tại — 0 lần diễn tập |
| 04.6 Đối soát production | |||
| 6.1 🔴🚸 | ✅ | — | đối soát độc lập 41 remote vs 39 đĩa, 2 mồ côi khớp migration-reconciliation.md |
| 6.2 | ❌ | HH | 2 dòng mồ côi vẫn tồn tại, DELETE dọn nợ chưa chạy |
| 6.3 🔴🚸 | ❌ | HH | schema-diff thật: whale_scholarships lệch DDL text production vs local dryrun |
| 6.4 🔴🚸 | ✅ | — | baseline 2026-08-15, 0 migration vi phạm tương thích ngược |
| 6.5 | ✅ | — | 2 dòng mồ côi đều đã có dòng giải thích trong migration-reconciliation.md |
AS-05 — Trí tuệ học tập & Thuật toán · 17/25 (68%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 05.1 Định nghĩa model & versioning | |||
| 1.1 | ❌ | HH | models.md đánh dấu learning_plan "🕓 Phase 2" nhưng model chạy thật production (route/UI sống) |
| 1.2 | ✅ | — | algorithm_version đúng cột: learning_plan/plan-v1, retention/retention-v1 |
| 1.3 | ✅ | — | COUNT=2, có generated_at, truy vết được |
| 1.4 | ❌ | HH | cùng bằng chứng 1.1 |
| 1.5 | ❌ | HH | đổi công thức mastery (thêm reliability) không tăng version; module không có hằng version nào (6 module khác đều có) |
| 05.2 Đường evidence → model | |||
| 2.1 | ✅ | — | learner_evidence có nguồn rõ; mọi route ghi mastery đều batch nguyên tử với evidence |
| 2.2 🔴 | ✅ | — | 4 vị trí duy nhất UPDATE learner_skill_state, đều evidence-gated |
| 2.3 | ✅ | — | cột reliability REAL, gán giá trị phân biệt rõ theo ngữ cảnh |
| 2.4 | ❌ | CM | 0 file test cho modules/learning, không test dedupe event_id |
| 2.5 | ❌ | HH | 8/8 dòng engine_runs có input_json=NULL — không lời gọi runEngine nào truyền input |
| 05.3 Engine correctness | |||
| 3.1 | ❌ | CM | Mastery/Readiness/Context engine không có test riêng |
| 3.2 | ✅ | — | 0 file test dùng readFileSync để source-regex |
| 3.3 | ❌ | CM | updateMastery(null,...) — ca evidence đầu tiên — chưa từng được test |
| 3.4 | ❌ | CX | chọn cố định 15 câu diagnostic, không có logic stopping criteria |
| 3.5 🚸 | ✅ | — | ci.yml không escape hatch; gh run list xác nhận cơ chế gate hoạt động thật |
| 05.4 Retention & Mastery | |||
| 4.1 🔴 | ✅ | — | periodic.test.ts test bất biến trực tiếp refresh không ghi decay vào anchor |
| 4.2 | ✅ | — | retention-model.md khớp CFG trong engine.ts; 27 test |
| 4.3 | ✅ | — | cron 0 21 * * * khớp schedules.md; workflow_runs có dòng WF-17 succeeded |
| 4.4 | ✅ | — | UPDATE chỉ đụng cột phái sinh, không đụng anchor; có test bất biến |
| 4.5 | ✅ | — | tham số review window trong retention-model.md khớp CFG code |
| 05.5 Giải thích được | |||
| 5.1 | ✅ | — | PlanBlock/PlanPhase.why render trực tiếp ra UI PlanPage.tsx |
| 5.2 | ✅ | — | response trả cả algorithm_version và model_version |
| 5.3 | ✅ | — | diffPlans() + UI hiển thị đổi gì/vì sao đổi cho cả bản hiện hành lẫn bản cũ |
| 5.4 | ✅ | — | cột confidence tồn tại, test xác nhận not null trong [0,1] |
| 5.5 | ✅ | — | endpoint model-versions dùng requireLearnerAccess; UI PlanPage có lịch sử bản cũ |
AS-06 — Nội dung & Tri thức · 8/25 (32%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 06.1 Knowledge graph toàn vẹn | |||
| 1.1 | ✅ | — | 0/274 node thiếu subject_id/grade/level |
| 1.2 | ✅ | — | 0/274 node thiếu strand/unit |
| 1.3 | ✅ | — | DFS 3-màu độc lập trên 233 cạnh prereq: 0 chu trình |
| 1.4 | ❌ | HH | lệnh gốc lỗi (cột unit không tồn tại trên items); sửa bằng JOIN skill_nodes: 69/222 unit <6 item, 21/222 unit =0 item |
| 1.5 | ✅ | — | 0/274 node thiếu title_en |
| 06.2 Chất lượng item | |||
| 2.1 | ❌ | HH | 2146/2146 item published có quality_json NULL — 100% không có hồ sơ 8 chiều |
| 2.2 | ❌ | HH | cùng dữ liệu 2.1 — 0 evidence per-dimension tồn tại |
| 2.3 | ❌ | HH | item_versions=0 dòng dù 679 item đã bị sửa qua script bypass hoàn toàn pipeline chấm |
| 2.4 | ✅ | — | 0 item thiếu node_id/role |
| 2.5 | ❌ | CX | UI Coral "Chất Lượng" chỉ placeholder "Chưa có dữ liệu"; learn không có nút báo câu sai |
| 06.3 Vòng đời nội dung | |||
| 3.1 🔴 | ❌ | HH | scripts/apply-review-fixes.mjs UPDATE thẳng items production, bypass hoàn toàn route PATCH chặn 409 |
| 3.2 | ✅ | — | item_versions.status enum CHECK rõ ràng ở tầng schema |
| 3.3 | ❌ | HH | 679 item sửa nội dung mà chưa từng qua publishVersion/evaluatePublishGate |
| 3.4 | ❌ | HH | 0/2146 item có published_by/published_at |
| 3.5 | ✅ | — | route rollback qua API tồn tại (dù item_versions rỗng nên chưa thực thi) |
| 06.4 Đề thi thật & provenance | |||
| 4.1 | ❌ | CX | 0 đề source=real, toàn bộ 10 exams là generated |
| 4.2 🔴 | ❌ | CX | 0 đề real để kiểm; R2 bucket content rỗng |
| 4.3 🔴 | ❌ | CX | 0 đề real, không spot-check được ≥5 |
| 4.4 | ❌ | CX | SDD-014 status draft, 0 code crawler tồn tại |
| 4.5 | ❌ | CX | cột immutable_after_publish không route nào đọc/ép, không có exam_versions |
| 06.5 Media & bản quyền | |||
| 5.1 | ❌ | CX | SDD-009 active nhưng 0 bảng media, 0 route /v1/media tồn tại |
| 5.2 | ❌ | CX | cùng nguyên nhân — không có registry nguồn/giấy phép media |
| 5.3 | ✅ | — | 0 file bitmap toàn repo, toàn bộ SVG tự vẽ/sinh tham số, 0 hotlink ngoài |
| 5.4 | ❌ | CX | 0 media thật upload qua hệ để đo kích thước |
| 5.5 | ❌ | CX | Media System chưa tồn tại nên cơ chế đồng thuận ảnh trẻ em cũng chưa có |
AS-07 — Bảo mật, Riêng tư & Tuân thủ · 16/25 (64%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 07.1 Xác thực & phiên | |||
| 1.1 🔴🚸 | ❌ | HH | GET /v1/coral/labs thiếu requireSession; tái hiện HTTP 500 thật trên dev server local độc lập, route chị em overview → 401 sạch |
| 1.2 | ✅ | — | resolveSession: hạn dùng, rotate sau 7 ngày, revokeSession khi logout |
| 1.3 | ✅ | — | verifyGoogleIdToken kiểm issuer/audience/alg RS256; 7/7 test PASS |
| 1.4 🚸 | ✅ | — | curl ẩn danh admin/dolphin/coral đều 302 Cloudflare Access login |
| 1.5 | ✅ | — | 0 hit bypass/skip auth trong source |
| 07.2 Phân quyền backend | |||
| 2.1 🔴🚸 | ✅ | — | mọi module chạm learner_id gọi canAccessLearner/tương đương |
| 2.2 🔴 | ✅ | — | 0 so sánh role===email trong authz logic |
| 2.3 🔴🚸 | ✅ | — | 3 file authz.test.ts, 35/35 PASS, có test phủ định family khác |
| 2.4 | ❌ | CM | audit_log actor_role='mentor' COUNT=0 (chưa có mentor thật dùng hệ) |
| 2.5 | ❌ | HH | permissions.md §6.2 nói Admin luôn 📝 nhưng admin/observability.ts 0 hit logAccess/canAccessLearner |
| 07.3 Dữ liệu trẻ em & đồng thuận | |||
| 3.1 | ❌ | CX | data-dictionary.md không có mục đích thu thập cho bất kỳ trường nào |
| 3.2 🔴🚸 | ❌ | HH | 0 lời gọi enforceConsent thật; requireConsent chỉ chặn khi đã rút, không chặn khi chưa từng hỏi; 0 màn hình consent frontend |
| 3.3 | ❌ | CM | code đúng (role check trước ghi) nhưng 0 file test portraits/*.test.ts |
| 3.4 | ✅ | — | chỉ 1 lời gọi ra ngoài thật: Google JWKS certs, không gửi dữ liệu learner |
| 3.5 | ❌ | CX | backend data-usage đầy đủ nhưng 0 màn hình marlins gọi/hiển thị |
| 07.4 Audit log | |||
| 4.1 | ❌ | HH | 3 route admin/observability.ts đọc dữ liệu learner cụ thể không logAccess() lần nào |
| 4.2 | ✅ | — | schema audit_log đủ actor/role/action/target/occurred_at/ip/user_agent/request_id |
| 4.3 | ❌ | HH | 1 dòng audit_log thật chứa nguyên văn note chưa redact (thao tác tay wrangler) |
| 4.4 | ✅ | — | 0 UPDATE/DELETE audit_log thật trong code |
| 4.5 | ✅ | — | GET /v1/admin/audit-log filter đầy đủ, tự ghi log truy vấn |
| 07.5 Bề mặt tấn công | |||
| 5.1 🔴 | ✅ | — | git log -p --all đúng regex gốc: 0 secret |
| 5.2 🔴 | ✅ | — | 0 path debug/seed trong index.ts và toàn bộ module |
| 5.3 | ✅ | — | mọi route qua createRoute+zod schema; 0 c.req.json() thô |
| 5.4 | ✅ | — | 1 hit dangerouslySetInnerHTML, nguồn không phải input người dùng trực tiếp |
| 5.5 🚸 | ✅ | — | RATE_LIMITS qua D1, enforceRateLimit trước verify JWT và trước route AI, 8/8 test PASS |
AS-08 — Tin cậy & Vận hành · 19/25 (76%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 08.1 Production-ready | |||
| 1.1 | ❌ | CX | 0 hit tier/availability gắn worker cụ thể trong wrangler.jsonc hay docs |
| 1.2 | ❌ | CX | SDD-006 §16 chỉ NÊU câu hỏi, không có bản trả lời cho subsystem nào |
| 1.3 | ❌ | CX | 9 SDD mới nhất hầu hết 0 hit fallback/degrad; Orca (feature mới, chạy thật) 0 dòng |
| 1.4 | ❌ | HH | health route luôn HTTP 200 dù database=error; rollback.yml smoke-test chỉ đọc mã HTTP |
| 1.5 | ✅ | — | 0 TODO/FIXME chặn đường trong source |
| 08.2 Idempotency & DLQ | |||
| 2.1 | ✅ | — | dedupeKey/claimMessage/markProcessed qua KV; 5 test PASS |
| 2.2 🔴🚸 | ✅ | — | wrangler queues list thật xác nhận cả 2 queue tồn tại trên Cloudflare |
| 2.3 | ✅ | — | GET/POST dead-letters list+replay, chặn replay 2 lần |
| 2.4 | ✅ | — | max_retries=5 khớp wrangler.jsonc, backoff luỹ thừa có trần 300s |
| 2.5 | ✅ | — | withLock qua KV cho cron retention-refresh, test PASS |
| 08.3 Observability | |||
| 3.1 | ✅ | — | 9/9 wrangler.jsonc có observability |
| 3.2 | ✅ | — | middleware requestId mount đầu tiên, X-Request-Id mọi response |
| 3.3 | ❌ | HH | app.onError không log request_id/path; 2 đường 5xx hoàn toàn không log |
| 3.4 | ✅ | — | GET /v1/admin/run-metrics query engine_runs/workflow_runs/dead_letters |
| 3.5 | ✅ | — | workflow_runs COUNT=1 (>0) trên production thật |
| 08.4 CI/CD & rollback | |||
| 4.1 🚸 | ✅ | — | ci.yml+deploy-api.yml không escape hatch; gh run list xác nhận có run failure thật gần đây bị fail-fast đúng cơ chế |
| 4.2 | ✅ | — | 8/9 deploy-*.yml có paths filter khớp đúng thư mục |
| 4.3 🔴🚸 | ✅ | — | deploy-api.yml: apply migration trước dòng deploy worker |
| 4.4 | ✅ | — | rollback.yml đủ 9 worker, wrangler rollback thật, smoke-test (chưa từng chạy thật lần nào nhưng cách-kiểm chỉ đòi đọc cấu trúc) |
| 4.5 | ✅ | — | 0 workflow có gate thủ công ngoài migration-apply (đã ghi lý do) |
| 08.5 Suy giảm duyên dáng & phụ thuộc ngoài | |||
| 5.1 | ✅ | — | AI/OAuth/R2 đều có try/catch fallback xác nhận được |
| 5.2 | ❌ | CM | không thể mock lỗi AI (bị cấm sửa code trong phiên chấm); 0 test tự động mô phỏng |
| 5.3 | ✅ | — | AbortSignal.timeout duy nhất 1 điểm; AI dùng withTimeout riêng 30s |
| 5.4 | ✅ | — | withCache qua KV TTL; dùng thật ở /v1/subjects; 4 test PASS |
| 5.5 | ✅ | — | curl production 401/404 sạch, không leak stack |
AS-09 — Trải nghiệm & Design System · 7/25 (28%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 09.1 Luật tối giản (SRC-048) | |||
| 1.1–1.5 | ❌×5 | CX | docs/reference/ui-minimalism-audit.md chưa tồn tại — artifact bắt buộc của v0.2 |
| 09.2 Token & component | |||
| 2.1 | ❌ | HH | engine.tsx có hex trần trùng hệt giá trị đã có trong palette.ts nhưng không import — vi phạm luật tự đặt ra |
| 2.2 | ❌ | HH | AboutMarlins/FindingNemo/Tour đều fork 3 bản y hệt (packages+marlins+web/learn), không phải re-export |
| 2.3 | ✅ | — | chỉ 1 file .css toàn cục/app, 0 style-in-JSX theo trang |
| 2.4 | ✅ | — | mỗi .theme-X chỉ override 4 biến accent |
| 2.5 | ❌ | HH | 7 hit text-xs (12px) dưới sàn --text-floor:14px |
| 09.3 Accessibility | |||
| 3.1 🔴🚸 | ❌ | CM | axe-core thật trên 3 màn: color-contrast luôn incomplete do gradient phức tạp |
| 3.2 | ✅ | — | thử Tab THẬT (không .focus() JS) trên learn+marlins: focus-visible outline 3px hoạt động đúng — bằng chứng ban đầu (outline:none) do dùng .focus() lập trình |
| 3.3 | ❌ | HH | resize mobile 375px, đo thật: nhiều link nav/hero dưới 44px chiều cao |
| 3.4 | ✅ | — | mọi <img> thật đều có alt="" |
| 3.5 | ❌ | CM | luồng "trả lời câu hỏi" sau Google OAuth thật, không thể đăng nhập để thử Tab đầu-cuối |
| 09.4 Ngôn ngữ & nội dung UI | |||
| 4.1 | ✅ | — | quét đủ 8/8 file apps/admin/src, 0 hit tiếng Việt ngoài comment |
| 4.2 | ❌ | HH | api.ts request() không bắt lỗi network-level; TypeError: Failed to fetch render thẳng ra UI |
| 4.3 | ❌ | HH | Learning.tsx vs ProgressViews.tsx dùng 2 bộ nhãn khác nhau cho cùng 4 mã trạng thái |
| 4.4 | ❌ | HH | cùng bằng chứng 4.2 |
| 4.5 | ❌ | CM | không rà được màn sau đăng nhập (rào OAuth thật) |
| 09.5 Hiệu năng cảm nhận | |||
| 5.1 | ❌ | CX | 0 hit ngưỡng LCP khai trong SDD nào |
| 5.2 | ❌ | CM | không có lighthouse/axe cài sẵn; PerformanceObserver thật trả rỗng |
| 5.3 | ✅ | — | states.tsx tự dẫn AS-09.5.3, convention loading/empty/error áp dụng 25/34 file |
| 5.4 | ✅ | — | 0 request .png/.jpg trên 3 màn, toàn bộ SVG |
| 5.5 | ❌ | HH | submit() chờ round-trip server mới set đúng/sai — đánh đổi cố ý nhưng vẫn phản ví dụ theo L1 |
AS-10 — AI Governance & Chi phí · 19/25 (76%)
| Chỉ báo | Mã | Bằng chứng | |
|---|---|---|---|
| 10.1 Đường AI duy nhất | |||
| 1.1 | ✅ | — | 1 hit duy nhất env.AI.run qua gateway id nemo12 |
| 1.2 | ✅ | — | 1 model tất định, không vòng lặp thử nhiều model |
| 1.3 | ✅ | — | 1 hit @cf/ model id đầy đủ tường minh |
| 1.4 | ✅ | — | 0 hit env.AI/ai.run trong apps/*/src |
| 1.5 | ❌ | HH | ai-registry.md (last_reviewed 2026-08-14) còn ghi "prompt chưa có registry" — mâu thuẫn prompts.ts đã tồn tại từ 2026-08-15 |
| 10.2 Prompt registry | |||
| 2.1 | ✅ | — | 0 prompt inline trong modules; cả 3 prompt nằm trong shared/prompts.ts registry |
| 2.2 | ✅ | — | mỗi PromptSpec có trường version:number |
| 2.3 | ✅ | — | 1 commit refactor giữ prompt cũ làm version 1, thêm version 2 mới |
| 2.4 | ✅ | — | mỗi PromptSpec có purpose/expects/constraints điền đầy đủ |
| 2.5 | ✅ | — | mỗi PromptSpec.output là z.ZodType thật, safeParse trước khi trả |
| 10.3 Context Builder & ranh giới dữ liệu | |||
| 3.1 🔴🚸 | ❌ | CX | buildLearnerContext() chỉ được gọi trong test — AI hiện không chạm learner data qua bất kỳ đường nào, bất biến "đường duy nhất" đúng một cách rỗng |
| 3.2 | ✅ | — | PURPOSE_FIELDS khai rõ sections+mastery_limit theo purpose; 12/12 test PASS |
| 3.3 | ✅ | — | learnerRef() băm SHA-256 bí danh; assertNoIdentifiers chặn cứng |
| 3.4 | ❌ | HH | item_versions không có cột model/prompt_version/input_ref; learning_experiences CÓ provenance_json — bất đối xứng |
| 3.5 🔴🚸 | ✅ | — | context-builder.test.ts (tên khác quy ước glob) 12/12 test PASS, cách ly A/B thật |
| 10.4 Đánh giá & chống ảo giác | |||
| 4.1 🔴🚸 | ✅ | — | cả 2 đường sinh nội dung AI đều có cổng người/ngưỡng trước publish |
| 4.2 | ✅ | — | 2 evaluator LLM + rule engine tất định; PUBLISH_MIN_EVALUATORS=2 |
| 4.3 | ✅ | — | HUMAN_SPOT_CHECK_RATE=0.2 deterministic, test phân bố lệch <0.03 |
| 4.4 | ✅ | — | source='ai-generated' gán tường minh, dùng ở nhiều tầng UI |
| 4.5 | ✅ | — | learner tự báo → content_reports→review_queue→staff resolveReview khép vòng |
| 10.5 Chi phí & hạn mức | |||
| 5.1 | ❌ | CX | ai-registry.md không có cột/mục ước tính chi phí theo loại lời gọi AI |
| 5.2 | ❌ | CM | Cloudflare AI Gateway API 403 thiếu scope; không có cơ chế thay thế ở tầng ứng dụng |
| 5.3 | ✅ | — | RATE_LIMITS.aiGenerate=30/giờ qua D1, enforceRateLimit trước 2 route AI tốn tiền |
| 5.4 | ❌ | CX | 0 cron/queue nào gọi AI; cả 3 lời gọi AI đều đồng bộ theo HTTP request staff |
| 5.5 | ✅ | — | 2 route sinh nội dung AI đều requireStaff + rate-limited |
6. Đối chiếu với Audit #001 (định tính — mẫu số khác, không so % trực tiếp)
Audit #001 (57dc4fa, v0.1, 250 chỉ báo) chấm 109/250 (44%). Audit #002 (89a3db46a1, v0.2, 255 chỉ báo) chấm 157/255 (61,6%). Theo đúng Hướng dẫn chuyển đổi v0.1→v0.2, không quy đổi cơ học — đối chiếu định tính:
Đã sửa thật, có bằng chứng (từng 🔴 ở #001, nay PASS):
AS-04.1.1numbering migration (0022 trùng → đã đổi tên, đánh CI enforce)AS-07.1.1/AS-07.2.1/AS-07.2.3authz backend + test — phần lớn PASS (trừ 1 routecoral/labsmới lọt lưới, xem dưới)AS-01.4.1gen:reference (91 dòng diff → 0 diff)AS-03.2.4contract:diff (0 chạy đâu → chạy 2 workflow)AS-04.1.4migrate:dryrun (không có → CI enforce 39/39)AS-05.3.5/AS-08.4.1CI chạy test/typecheck/lint trước deploy (không workflow nào chạy → enforce thật, có bằng chứnggh run list)AS-10.3.5test cách ly learner A/B (không tồn tại →context-builder.test.ts12/12 PASS)AS-10.4.1AI không publish thẳng (ghi thẳng DB → có gate/threshold)
Tái diễn — CÙNG LOẠI lỗi, khác chi tiết cụ thể (bài học quan trọng nhất):
- Migration mồ côi/trùng số: #001 bắt được
0022trùng số → sửa xong nhưng đợt sửa (đổi tên0022_whale_country_detail.sql→0031_...,0031_labs.sql→0037_labs.sql) lại tự sinh ra đúng loại lỗi mới — 2 dòng mồ côi khác trongd1_migrationsremote, xác nhận thật bằngwrangler d1 execute --remote.docs/ops/migration-reconciliation.md(mới, do chính đợt v0.2 tạo ra sau sự cố) đã ghi lại minh bạch — AS-04.6.1 PASS đúng nghĩa "nợ đã khai báo", nhưng AS-04.6.2 (0 lệch tuyệt đối) vẫn KHÔNG PASS và AS-04.6.3 phát hiện thêm 1 lớp mới: schema DDL text bản thân cũng lệch (whale_scholarships). Kết luận: cơ chế đối soát mới (AS-04.6) đang hoạt động đúng như thiết kế — phát hiện lỗi thật ngay khi nó xảy ra, thay vì để im lặng. - Authz backend cho learner data: #001 bắt 21/102 endpoint chưa rõ chứng minh auth → #002 sau khi vá gần hết, một route MỚI (
GET /v1/coral/labs, tính năng Coral labs không tồn tại ở #001) lại thiếurequireSession— cùng loại lỗ hổng, route khác.
Mới xuất hiện do tính năng mới (không có ở #001, vì tính năng chưa tồn tại lúc đó):
- Toàn bộ AS-06.2/06.3 (content lifecycle bypass qua
apply-review-fixes.mjs) — #001 ghi nhậnitemschưa có cột lifecycle nào (CX thuần); #002 cho thấy cột lifecycle đã được xây (item_versions,quality_json) nhưng bị bỏ qua hoàn toàn bởi một script vận hành — từ "chưa xây" (CX) chuyển thành "xây rồi nhưng có đường vòng" (HH), nặng hơn về bản chất dù cùng nhóm chỉ báo. - Nhóm REQ
ORC(Orca competitions), community events (AS-04.2.4,AS-04.3.5), Whale (AS-04.6.1/6.3), Octopus school (AS-02.3.4) — toàn bộ là chỉ báo mới KHÔNG PASS gắn với tính năng mới build từ SRC-122 đến SRC-128 (2026-08-15) mà tài liệu/schema chưa theo kịp code. AS-10.3.1Context Builder: #001 ghi CX vì component chưa tồn tại; #002 component đã được xây kỹ (12/12 test cách ly) nhưng chưa được nối vào bất kỳ route AI sản xuất nào — vẫn CX xét theo đúng ý nghĩa "đường duy nhất AI chạm learner data" vì chưa có gì đi qua đường đó.
7. Kết luận
Pilot Gate (điều kiện thật cho đợt mở thử 2 ngày tới, theo ✍️ Q-128): 12/18 — NO-GO. Không mở thử ở trạng thái hiện tại. 6 chỉ báo chặn, xếp theo mức độ nghiêm trọng cho 10 gia đình thật: AS-07.3.2 (đồng thuận không chặn thu thập dữ liệu trẻ em chưa được hỏi — rủi ro pháp lý trực tiếp), AS-07.1.1 (1 route learner data crash/không xác thực), AS-04.5.5 (0 lần diễn tập backup/restore — không có đường lùi nếu dữ liệu trẻ em thật hỏng), AS-04.6.3 (schema drift thật giữa production và migration trên đĩa), AS-03.5.3 (chưa chặn được đúng nguyên nhân gốc sự cố đa-agent 2026-08-15), AS-10.3.1 (không ảnh hưởng pilot nếu pilot không chạm tính năng AI cá nhân hoá — nhưng bất biến chưa có gì để kiểm chứng thật).
Điểm hệ toàn phần: 157/255 (61,6%), mức "Đang dựng" — cách sàn REQ-DOC-06 (≥225/255) còn 68 chỉ báo. Đây KHÔNG phải điều kiện chặn pilot 2 ngày tới (đã có Pilot Gate thay thế theo ✍️ Q-128), nhưng vẫn là ngưỡng dài hạn chưa đạt cho việc mở rộng người dùng thật ra ngoài phạm vi pilot nhỏ này.
%HH = 57% trong tổng KHÔNG PASS là tín hiệu quan trọng nhất của lần chấm này: hơn một nửa số điểm trừ không phải "chưa kịp xây" mà là có bằng chứng cụ thể cho sai — đặc biệt tập trung ở AS-04 (schema/vận hành), AS-06 (nội dung có đường vòng bypass vòng đời), và AS-09 (UI có 2 chuẩn khác nhau cho cùng khái niệm). Đây là hệ quả trực tiếp của nhiều phiên AI chỉnh sửa song song trong cùng một ngày.
8. Hành động sinh ra từ audit này
Xếp theo thứ tự bắt buộc: Pilot Gate chưa PASS lên đầu tuyệt đối, sau đó HH nói chung (đã hỏng, có phản ví dụ), rồi CM (chứng minh — thường rẻ), cuối cùng CX (xây — tốn nhất).
8.1 Pilot Gate — bắt buộc trước khi mở thử (6 việc, chặn go/no-go)
| # | Hành động | Đóng được chỉ báo | Ước lượng |
|---|---|---|---|
| P1 | Thêm /v1/coral/labs vào danh sách .use(path, requireSession) trong coral/routes.ts | AS-07.1.1 🔴🚸 | 15 phút |
| P2 | Đổi requireConsent() sang chặn khi granted != 1 (không chỉ khi đã rút); dựng màn hình consent tối thiểu trong luồng nhận lời mời marlins trước khi kích hoạt learner | AS-07.3.2 🔴🚸 | 1 ngày |
| P3 | Chạy 1 lần thật: backup D1 → restore vào DB test → đếm bảng/dòng khớp → ghi docs/ops/backup-restore-drill.md | AS-04.5.5 🔴🚸 | nửa ngày |
| P4 | Chuẩn hoá lại migration whale_scholarships (viết lại 1 migration mới CREATE TABLE sạch thay vì chuỗi ALTER lịch sử) hoặc ghi nhận lệch DDL vào migration-reconciliation.md kèm xác nhận vô hại | AS-04.6.3 🔴🚸 | nửa ngày |
| P5 | Thêm câu cấm tường minh "không chạy wrangler d1 migrations apply --remote từ máy/phiên cục bộ" vào README §CI/CD hoặc CLAUDE.md; dọn 2 dòng mồ côi (DELETE trong migration-reconciliation.md) | AS-03.5.3 🔴🚸 | 1 giờ |
| P6 | Quyết định tường minh (✍️ hoặc chủ dự án xác nhận): nếu pilot không chạm tính năng AI cá nhân hoá learner, ghi rõ AS-10.3.1 là nợ chấp nhận được cho đợt này; nếu có, nối route AI cá nhân hoá đầu tiên qua buildLearnerContext() trước khi bật | AS-10.3.1 🔴🚸 | 1 giờ (quyết định) hoặc 1 ngày (nối code) |
8.2 🔴 chặn release còn lại, ngoài Pilot Gate (3 việc)
| # | Hành động | Đóng được chỉ báo | Ước lượng |
|---|---|---|---|
| R1 | Chặn hoặc rút quyền chạy scripts/apply-review-fixes.mjs thẳng vào production; mọi sửa item phải qua createCandidate→publishVersion | AS-06.3.1 🔴 | nửa ngày |
| R2 | Bắt đầu ngân hàng đề thật: thu thập ≥1 đề source='real' kèm URL nguồn + lời giải tự biên soạn | AS-06.4.2 🔴, 6.4.3 🔴 | 2-3 ngày (phụ thuộc nguồn đề) |
| R3 | Đo contrast WCAG AA bằng công cụ đo pixel thật (Lighthouse DevTools hoặc thước màu tay) cho vùng gradient hero, không chỉ axe-core | AS-09.3.1 🔴🚸 | nửa ngày |
8.3 HH khác — có phản ví dụ, cần sửa code/dữ liệu (53 chỉ báo, nhóm theo chủ đề)
| # | Hành động | Đóng được chỉ báo | Ước lượng |
|---|---|---|---|
| H1 | Chạy 1 pipeline chấm quality 8 chiều cho 2146 item published thật (kể cả 679 item vừa sửa qua script); ghi evaluator_count/quality_score | AS-06.2.1, 6.2.2, 6.2.3, 6.3.3, 6.3.4 | 2 ngày |
| H2 | Vá 67 cột *_id thiếu REFERENCES (hoặc miễn trừ tường minh trong dictionary nếu polymorphic); sửa starts_at UTC; vá 4 CHECK cắt cụt trong generator; xoá mục ma interaction_votes_rebuilt; điền 160 mô tả cột rỗng | AS-04.2.3, 4.2.4, 4.3.2, 4.3.3, 4.3.4, 4.3.5 | 2 ngày |
| H3 | Sửa 5+20 seed script: thêm --local mặc định hoặc dừng xác nhận trước --remote; điền 24 dòng thiếu cặp _en; sửa 4 policy keep_days=NULL thành số cụ thể | AS-04.4.1, 4.4.2, 4.4.5, 4.5.1 | 1 ngày |
| H4 | Đăng ký nhóm REQ ORC vào conventions.md §2; nối REQ-LRN-19/20/21 vào bảng §6; sửa "tốt hơn" ở REQ-BRD-07; điền mục Octopus vào SDD-011; dựng UI forum tối thiểu cho US-38 hoặc rút REQ-COM-03 khỏi ✔ | AS-02.1.1, 2.1.2, 2.2.5, 2.3.4, 1.3.4, 1.3.5 | 1 ngày |
| H5 | Thêm logAccess() vào 3 route admin/observability.ts; redact lại 1 dòng audit_log chứa note nguyên văn; sửa permissions.md §6.2 cho đúng thực tế | AS-07.2.5, 7.4.1, 7.4.3 | nửa ngày |
| H6 | Sửa app.onError/errorResponse ghi kèm request_id+path+method vào log; sửa health route trả HTTP 503 khi database=error | AS-08.1.4, 8.3.3 | nửa ngày |
| H7 | Thêm hằng MASTERY_VERSION; gắn trang mô tả learning_plan trong models.md; truyền input vào mọi runEngine(); lưu model/prompt_version/input_ref vào item_versions khi tạo qua AI | AS-05.1.1, 5.1.4, 5.1.5, 5.2.5, 10.3.4 | 1 ngày |
| H8 | Import palette.ts vào engine.tsx (xoá 3 hex trần); chuyển 3 component fork (AboutMarlins/FindingNemo/Tour) sang import từ packages/design-system; nâng 7 chỗ text-xs; thống nhất 1 bộ nhãn trạng thái STATE_LABEL dùng chung giữa Learning.tsx/ProgressViews.tsx; sửa nav/hero link ≥44px trên mobile | AS-09.2.1, 9.2.2, 9.2.5, 9.4.3, 9.3.3 | 1 ngày |
| H9 | Bọc try/catch cho lỗi network-level trong api.ts request(), dịch sang tiếng Việt thay vì render thẳng e.message | AS-09.4.2, 9.4.4 | nửa ngày |
| H10 | Cập nhật ai-registry.md (số dòng, thêm generate-experience, xoá tuyên bố "chưa có prompt registry") | AS-10.1.5 | 1 giờ |
| H11 | Cập nhật migrations/README.md §3 khớp thực tế production (sửa khuyến nghị INSERT OR IGNORE thành đúng theo migration-reconciliation.md) | AS-01.1.1, 1.1.5, 1.1.3 (phần liên quan) | 1 giờ |
| H12 | Bump version PRD-001 đúng quy ước khi sửa REQ đáng kể; thêm cột "Trạng thái" vào bảng "Việc còn chờ chủ dự án"; sửa 16 dòng ✍️ Đợt 1 dưới ngưỡng 15 ký tự | AS-01.5.2, 2.5.2, 2.5.4 | nửa ngày |
| H13 | UI "chấm client-side trước, gửi evidence async" cho câu trả lời đầu tiên (nếu chấp nhận đánh đổi lộ đáp án tạm thời) — hoặc ghi nợ ✍️ chấp nhận độ trễ hiện tại | AS-09.5.5 | 1 ngày (nếu làm) |
8.4 CM — chứng minh, thường rẻ (13 chỉ báo)
| # | Hành động | Đóng được chỉ báo | Ước lượng |
|---|---|---|---|
| C1 | Xin/renew Cloudflare API token có scope KV+R2+AI Gateway đọc, chạy lại verify:bindings Lớp C và kiểm chi phí AI Gateway | AS-03.4.4, 10.5.2 | 1 giờ (phụ thuộc quyền cấp token) |
| C2 | Viết test cho updateMastery/computeReadiness, ca evidence: []/null đầu tiên, dedupe event_id trong modules/learning | AS-05.2.4, 5.3.1, 5.3.3 | 1 ngày |
| C3 | Viết portraits/*.test.ts; ghi audit_log mẫu cho mentor thật đầu tiên khi có mentor dùng hệ | AS-07.3.3, 7.2.4 | nửa ngày |
| C4 | Đo contrast bằng công cụ pixel-level thay axe (đã gộp vào P6/R3 ở trên) | AS-09.3.1 | — |
| C5 | Tạo tài khoản test đăng nhập Google thật (không phải mock) để rà Tab đầu-cuối và ngôn ngữ ở màn sau đăng nhập | AS-09.3.5, 9.4.5 | nửa ngày |
| C6 | Cài lighthouse/axe CLI vào devDependencies thật (không phải npx tạm), đo CLS thật | AS-09.5.2 | nửa ngày |
| C7 | Viết test mô phỏng lỗi AI (mock env.AI.run throw) và xác nhận UI/response vẫn sống | AS-08.5.2 | nửa ngày |
8.5 CX — xây mới, tốn nhất (29 chỉ báo, nhóm lớn)
| # | Hành động | Đóng được chỉ báo | Ước lượng |
|---|---|---|---|
| X1 | Dựng docs/reference/ui-minimalism-audit.md (bảng route×app×5 cột, kèm ảnh/file:line) | AS-09.1.1..5 | 2 ngày |
| X2 | Ngân hàng đề thật + crawler tôn trọng robots/ToS (đã gộp một phần vào R2) | AS-06.4.1, 6.4.4, 6.4.5 | 3-5 ngày |
| X3 | Media System tối thiểu (bảng media, route upload, moderation) nếu tính năng ảnh thật sự cần trước pilot mở rộng | AS-06.5.1, 6.5.2, 6.5.4, 6.5.5 | 3 ngày |
| X4 | Viết 5 câu trả lời production-ready SDD-006 §16 cho từng subsystem; khai tier availability theo worker; định nghĩa "hỏng thì thấy gì" cho Orca/Whale/community events | AS-08.1.1, 8.1.2, 8.1.3 | 1 ngày |
| X5 | Cột "Phân loại" 4 giá trị cho legacy-feature-inventory.md; cột "Đã vào" cho mọi Q trong open-questions/index.md; khóa nghiệp vụ trong data-dictionary.md | AS-02.4.4, 2.5.5, 4.4.4 | 1 ngày |
| X6 | Khai ngưỡng LCP trong SDD; ước tính chi phí AI theo loại lời gọi trong ai-registry.md; xác nhận 0 cron/queue gọi AI là chủ đích, ghi rõ nếu sau này thêm | AS-09.5.1, 10.5.1, 10.5.4 | nửa ngày |
| X7 | Nối tính năng AI cá nhân hoá đầu tiên qua Context Builder (nếu roadmap có) — đã liệt ở P6 | AS-10.3.1 | — |
| X8 | Dựng UI Coral "Chất Lượng" thật (thay placeholder) nối content_review_queue; thêm nút "báo câu sai" trong learn | AS-06.2.5 | 1-2 ngày |
| X9 | Mục đích thu thập cho từng trường trẻ em trong data-dictionary.md; UI marlins hiển thị data-usage | AS-07.3.1, 7.3.5 | 1 ngày |
| X10 | Stopping criteria có test cho diagnostic (thay vì cố định 15 câu) | AS-05.3.4 | 1-2 ngày |
9. Ghi chú phương pháp
- Bằng chứng thu bằng lệnh thật trên commit
89a3db46a1(snapshot ghim, độc lập với thư mục làm việc chính đang bị nhiều phiên AI khác sửa song song):check-docs.mjs,gen-reference.mjs,contract:diff,migrate:dryrun,verify:bindings,vitest run,wrangler d1 execute --remotetrên D1 production thật,wrangler queues list/gh run list/gh api(trạng thái sống, gọi ra ngoài snapshot theo đúng ngoại lệ được phép), và grep/rà source + dựng lại dev server local độc lập để tái hiện 1 lỗi động (AS-07.1.1). - Ba lượt hợp nhất: chấm gốc (255/255 chỉ báo, không có ID nào bỏ sót so với
audit-standard/index.md) → chấm sâu 18 chỉ báo Pilot Gate → một lượt phản biện chạm 77/255 chỉ báo (chủ yếu xác nhận lại PASS bằng lệnh độc lập, và tìm phản ví dụ mới hoặc lật lại verdict Pilot Gate khi bằng chứng động mâu thuẫn với bằng chứng tĩnh). Verdict cuối cùng ở mỗi ID dùng lớp muộn nhất đã chạm tới nó. - 5 chỉ báo bị lượt phản biện lật verdict so với lớp ngay trước nó:
AS-03.5.3,AS-04.6.3,AS-07.1.1(Pilot Gate PASS dựa trên đọc tĩnh → phản biện lật lại KHÔNG PASS bằng bằng chứng động, tức quay về đúng kết luận chấm gốc ban đầu),AS-04.4.3(chấm gốc PASS → phản biện lật KHÔNG PASS/CM vì phụ thuộc AS-04.2.3 đang fail),AS-10.3.1(cả chấm gốc lẫn Pilot Gate đều PASS → phản biện lật KHÔNG PASS/CX, chỉ báo duy nhất lật thật theo hướng "tưởng đạt hoá ra chưa" so với kết luận ban đầu của TOÀN BỘ hai lượt trước). Ngoài raAS-09.3.2được phản biện lật từ KHÔNG PASS (chấm gốc) sang PASS — phát hiện bằng chứng gốc dùng.focus()JS thay vì phím Tab thật nên sai. - Theo L2 (cấm N/A) và L3 (không bằng chứng = KHÔNG PASS): mọi KHÔNG PASS đều kèm mã CX/CM/HH theo đúng định nghĩa §1.1 audit-standard/index.md — không dùng chung một ký hiệu ❌ vô phân biệt như Audit #001.
- AS-09.3.5 và một phần AS-09.4.5 vẫn bị chặn bởi rào Google OAuth thật (không có tài khoản test) — chưa rà được các màn sau đăng nhập; ghi CM thay vì suy đoán PASS.