Handoff S187 → S188

Phiên: S187 | Ngày: 2026-04-29 Opus: điều hành + soạn prompt + review GPT: duyệt kỹ thuật (delegated technical approval) Codex: thực thi trên VPS

---

1. Tóm tắt 1 câu

S187 hoàn thành P10A end-to-end: Điều 35 cắt 36 miếng → PG → ghép lại → đọc như tài liệu bình thường (0 content drift). MVP 1-document PASS.

---

2. Roadmap — vị trí hiện tại

0-5. ✅ Foundation (P9 12/12, production ready)
6.   ✅ P10A — Pilot 1 document (Điều 35, 36 units, PASS)
7.   → P10B — Multi-document validation (2 thêm) ← ĐANG Ở ĐÂY
8.   ⏳ P10D — Nuxt Laws Page (tree view + reader/review modes)
9.   ⏳ Migration rộng
10.  ⏳ KG/Vector sync

---

3. Quyết định kỹ thuật cụ thể (S187)

Quyết định	Giá trị
P10A plan	v0.4 FINAL (4 vòng GPT review)
Segmentation v1 → v2 → v3	17 → 30 → 36 units (split §4/§6/§8, 12 section_types)
Canonical address	D38-DIEU35-{ROOT|S{N}|S{N}-P{N}|...} — regex ^D38-[A-Z0-9]+-...
Birth gate discovery	BG-UV-03 = warn (body), BG-UV-02 = block (description)
Insert package	DO block + jsonb maps, 85KB/1279 lines, single transaction
Render	Materialized-path CTE, preorder DFS
Rollback	Feasible when lifecycle mutable (proposed/draft)
Execution role	directus (only role with INSERT on tac_*)
Human-readable render	Skip root, hide placeholders, depth→heading
Publication ID	27e48995-d6a1-4a44-8559-cab6a07fdbe0
Operating model	User = mục tiêu/kết quả, GPT = duyệt kỹ thuật
P10D requirements	Reader Mode + Review Mode (admin toggle) + Debug Mode (future)

---

4. Sai lầm + bài học (S187)

Sai lầm	Bài học
P10A-2 v0.1 hardcoded INSERT	Generate SQL từ schema thật
Candidate v1 canonical_address dieu-35/...	Birth gate regex D38- bắt buộc
§8 "4 cặp" vs source 5 children	Theo source thật, không giả định
Artifact corruption do nhiều update	Rewrite sạch khi sửa > 3 lần
P10A-2B render lộ khung kỹ thuật	Cần clean render (bản kỹ thuật ≠ bản người đọc)

---

5. Dữ liệu có con số

Metric	Count
tac_publication rows	1 (DIEU-35 v5.2, proposed)
tac_logical_unit rows	36 (draft_only)
tac_unit_version rows	36 (draft)
tac_publication_member rows	36
Section types used	12 / 17
Diff clean render	2 hunks whitespace, 0 content drift
Original size	39,939 bytes / 817 lines

---

6. Prompt targets S188

#	Target
1	P10B plan: chọn 2 documents + soạn dispatch
2	P10B execution: cắt + insert + render + diff
3	P10B closeout
4	P10D design brief (doc-only, sau P10B PASS)

---

7. Tài liệu path + rev

P10A reports:

Report	Path
P10A-1 discovery	reports/p10a-d35-segmentation-candidate-2026-04-29.md
P10A-1B candidate v2	reports/p10a-d35-segmentation-candidate-v2-2026-04-29.md
P10A-2A package	reports/p10a-2a-d35-insert-package-2026-04-29.md
P10A-2B execute	reports/p10a-2b-d35-pilot-execute-report-2026-04-29.md
P10A-2B deliverables	reports/p10a-2b-d35-pilot/ (6 files)
P10A-2C human render	reports/p10a-2c-d35-human-render/ (5 files)

VPS artifacts (/tmp/):

• p10a-2a-insert-candidate.sql (85KB, insert SQL)
• p10a-2a-render.sql (render CTE)
• p10a-2a-rollback.sql (rollback SQL)
• d35-segments-v3.json (candidate v3)

Handoff:

tham-khao/handoff-s187-p10a-complete.md (file này)

---

Handoff S187 → S188 | 2026-04-29 | Opus 4.6 P10A PASS. MVP 1-document complete. Next: P10B multi-document.