Source document: docs/project-brain/16-BRAIN-REPAIR-PLAN.md
Source version: 0.0.0
Generated time: 2026-07-06T14:59:26.050Z
Owner: Unassigned
Audience: Internal
Status: Approved

16 — BRAIN REPAIR PLAN (OMS-2D)

Plan only. KHÔNG sửa brain, KHÔNG sửa source, KHÔNG chạy fix, KHÔNG mở OMS-3. Kế hoạch sửa 4 WARNING từ 13-BRAIN-VERIFICATION. Created 2026-07-04. Scope tag: OMS-2D.
Nguyên tắc thứ tự: theo 11-BRAIN-HANDOFF — sửa canonical TRƯỚC, brain SAU. Cấp version theo 12-BRAIN-VERSIONING.

Phân loại nhanh (4 WARNING → 6 root-cause item)

Warning	Brain	Loại root cause
W1a	01-BACKEND	genuine unsupported claim (số test 135)
W1b	01-BACKEND	source stale (BACKEND-STATUS re RLS/payment)
W2	03-BUSINESS	citation pointer wrong
W3	04-FOUNDER	brain overgeneralization (+ omission nhỏ)
W4a	08-ROADMAP	roadmap drift (OMS-2 status — nguồn mâu thuẫn)
W4b	08-ROADMAP	source omitted (CRM thiếu ở "Later")

Bảng repair plan (bắt buộc)

Warning ID	Brain	Problem	Root cause	Evidence	Proposed fix	Files to touch later	Risk	Priority	Stop condition
W1a	01-BACKEND	"infra 135 test" không khớp nguồn, không verify được	genuine unsupported claim	Brain L8 & L33 "infra 135"; `backend/BACKEND-STATUS` L9 "infra 93/93"; thực grep ≈153 → 3 số khác nhau	Update canonical (đếm lại infra test → ghi vào BACKEND-STATUS) rồi patch brain wording cho khớp số đã verify	`docs/backend/BACKEND-STATUS.md`, sau đó `docs/project-brain/01-BACKEND-BRAIN.md`	Medium (số sai còn tệ hơn số mơ hồ — phải đếm thật)	P1	Brain số = số trong BACKEND-STATUS đã verify; re-run kiểm OMS-2C → PASS
W1b	01-BACKEND	Brain "RLS ON staging / Payment Phase 4" ≠ BACKEND-STATUS "RLS chưa bật, Payment chưa"	source stale (brain đúng)	BACKEND-STATUS L1/L4 "v0.2.0-rc, 2026-07-01", L15 "RLS chưa bật", L37-38 Payment chưa; nhưng `07-SECURITY` xác nhận RLS staging ON = P2C; infra có `payment-service.ts`	Update canonical only (refresh BACKEND-STATUS sang state hiện tại). Brain không đổi (đã đúng)	`docs/backend/BACKEND-STATUS.md`	Low (đồng bộ nguồn về state mới; brain giữ nguyên)	P2	BACKEND-STATUS phản ánh RLS-on-staging + Payment build; brain khớp không cần sửa
W2	03-BUSINESS	Trỏ định nghĩa Account/Customer tới "04-GLOSSARY" — sai file	citation pointer wrong	Brain L21 "(04-GLOSSARY)"; `business-os/04` thực = GTM-PLAYBOOK (README L21); terminology canonical ở 00-README §Terminology (L30-33). Nội dung định nghĩa ĐÚNG	Patch brain citation only: "04-GLOSSARY" → "00-README §Terminology"	`docs/project-brain/03-BUSINESS-BRAIN.md`	Very low (đổi con trỏ, không đổi nghĩa → PATCH)	P3	Citation trỏ 00-README §Terminology; nội dung giữ nguyên
W3	04-FOUNDER	"Founder Portal đọc artifact tĩnh, không hardcode" phóng đại toàn portal	brain overgeneralization (+ omission)	Brain L19 (câu no-hardcode) chỉ đúng cho viewer M4A (L9 `/founder/travel-os` đọc fs); thực có ~20 route `(founder)/founder/` (gồm `/founder/page.tsx` exec dashboard đã build*), nhiều trang hardcode qua `src/lib/founder/data.ts`; brain L12 gộp business dashboard vào "chưa build"	Patch brain wording: thu hẹp "no-hardcode" về M4A viewer; ghi nhận các trang founder khác đã build (data layer hardcode)	`docs/project-brain/04-FOUNDER-BRAIN.md`	Medium (phải mô tả đúng, tránh tạo overclaim mới)	P2	Câu no-hardcode gắn scope viewer; state các trang founder đã build được nêu; re-check → PASS
W4a	08-ROADMAP	Brain "OMS-2 đang làm" ≠ nguồn "OMS-2 ✅ hoàn tất"	roadmap drift — nguồn tự mâu thuẫn	Brain L6 & L14 "OMS-2 đang làm"; `operating-memory/06-NEXT-STEPS` L6 "OMS-1 ✅ + OMS-2 ✅ hoàn tất". NHƯNG OMS-2C/2D đang chạy thực tế → nguồn 06 có thể lạc quan sớm	Defer + clarify với owner: chốt source-of-truth OMS-2 (done vs in-progress) giữa 06-NEXT-STEPS ↔ 03-CURRENT-SPRINT trước; rồi patch brain khớp	(quyết định) `docs/operating-memory/06-NEXT-STEPS.md` &/hoặc `03-CURRENT-SPRINT.md`; sau đó `docs/project-brain/08-ROADMAP-BRAIN.md`	Medium (nguồn bất đồng — sửa sai lan ra router/roadmap)	P1	Owner chốt trạng thái OMS-2; 3 nơi (06, 03, brain) nhất quán
W4b	08-ROADMAP	"Later" thiếu CRM	source omitted	Brain L16 "Later" liệt kê Payment/Partner/Customer/Affiliate/Auth GA/RLS prod; `06-NEXT-STEPS` L19 & `travel-os/10` Phase 4 có thêm CRM	Patch brain wording: thêm CRM vào "Later"	`docs/project-brain/08-ROADMAP-BRAIN.md`	Low	P3	"Later" gồm CRM; khớp 06-NEXT-STEPS L19

Thứ tự thực thi dependency-safe (cho sprint sửa sau — KHÔNG chạy ở đây)

Quy tắc: canonical/decision trước → brain sau → governance cuối.

PHASE A — Canonical & decisions (không đụng brain)
  A1 [W1a/W1b] Đếm lại infra test + refresh BACKEND-STATUS (RLS/payment/test count)
  A2 [W4a]     Owner chốt trạng thái OMS-2; sync 06-NEXT-STEPS / 03-CURRENT-SPRINT

PHASE B — Patch brain (sau A; mỗi item độc lập)
  B1 [W2]  03-BUSINESS: sửa citation      (PATCH)  ← không phụ thuộc A
  B2 [W3]  04-FOUNDER: thu hẹp no-hardcode (MINOR)  ← không phụ thuộc A
  B3 [W1a] 01-BACKEND: align số test       (MINOR)  ← phụ thuộc A1
  B4 [W4a] 08-ROADMAP: align OMS-2 status   (MINOR)  ← phụ thuộc A2
  B5 [W4b] 08-ROADMAP: thêm CRM             (MINOR)  ← gộp cùng B4

PHASE C — Governance (sau B)
  C1 Bump version brain đã sửa ở 12-BRAIN-VERSIONING (01,03,04,08)
  C2 Cập nhật 09-BRAIN-MANIFEST "Last updated" = sprint tag
  C3 Re-run kiểm OMS-2C → kỳ vọng 13/13 PASS

Quick wins làm được ngay khi mở sprint sửa (không chờ A): B1 (W2), B2 (W3).
Chặn bởi decision: B4 (W4a) chờ A2 — không patch khi owner chưa chốt.

Files sẽ đụng trong repair sprint tương lai

Nhóm	File	Item
Canonical source	`docs/backend/BACKEND-STATUS.md`	W1a, W1b
Canonical source	`docs/operating-memory/06-NEXT-STEPS.md` (± `03-CURRENT-SPRINT.md`)	W4a (sau decision)
Brain	`docs/project-brain/01-BACKEND-BRAIN.md`	W1a
Brain	`docs/project-brain/03-BUSINESS-BRAIN.md`	W2
Brain	`docs/project-brain/04-FOUNDER-BRAIN.md`	W3
Brain	`docs/project-brain/08-ROADMAP-BRAIN.md`	W4a, W4b
Governance	`docs/project-brain/09-BRAIN-MANIFEST.md`, `12-BRAIN-VERSIONING.md`	Phase C

Files KHÔNG được đụng (must NOT touch)

Brain PASS: 00-BRAIN-ROUTER, 02-PLATFORM, 05-KNOWLEDGE, 06-DEPLOYMENT, 07-SECURITY, 10-BRAIN-DEPENDENCY, 11-BRAIN-HANDOFF.
CURRENT-STATE: docs/operating-memory/02-CURRENT-STATE.md — cấm sửa (theo chỉ thị).
Implementation: src/, packages/ — chỉ đọc đối chiếu, không sửa.
Records: 00-SOURCE-AUDIT, 00-BRAIN-SCOPE, 13/14/15/16 — không rewrite.
Generated: docs/generated/** — auto-gen, sửa ở nguồn code.

QA (OMS-2D — plan only)

No brain modified — brain 00–12 giữ mtime cũ; chỉ tạo file 16 mới.
No OMS modified — operating-memory/* không đổi.
No implementation modified — src/, packages/ chỉ đọc.
No source rewritten — canonical docs không đổi.
Repair plan only — không thực hiện fix nào; recommended action thuộc sprint sau.
CURRENT-STATE không đổi.

Stop condition (toàn plan)

Kế hoạch này chỉ mô tả. Dừng sau khi tạo file 16. → STOP. Không execute repair. Không update file hiện có. Không mở OMS-3.

Nguồn sự thật (Source of Truth): docs/project-brain/16-BRAIN-REPAIR-PLAN.md · v0.0.0 · sinh tự động lúc 2026-07-06T14:59:26.050Z. Trang này là view suy dẫn — không sửa trực tiếp.