D28 — Bản Yêu Cầu / Quy Hoạch Hiển Thị Nuxt

DRAFT v0.2 | 2026-05-09 | Sửa theo GPT: siết phạm vi Phase 1, không sa đà full Nuxt redesign Loại: Requirements specification — chưa phải luật, chưa phải implementation Mục đích chính: Đủ display governance để P3D notification nằm đúng trong tổng thể, không phải làm lại Chờ: User + GPT review

---

★ PHASE 1 — Minimum Display Governance

Mục tiêu Phase 1

Phase 1 không phải full Nuxt redesign. Phase 1 chỉ định nghĩa đủ display governance để:

• Notification display (tbl_event_outbox) nằm đúng trong khuôn chuẩn
• Không phải refactor lại khi hoàn thành information-unit / text-as-code
• Infrastructure routing (generated map) phục vụ toàn bộ Table Module, không riêng notification

4 điểm chốt Phase 1

1. Family 1 / DirectusTable đủ cho notification display. tbl_event_outbox = 1 instance chuẩn của TPL-001 DirectusTable, config từ table_registry id=21. Không cần UI riêng, không cần Family mới. Hiển thị y hệt mọi bảng registry khác.

2. Generated map = shared Table Module infrastructure. Thay 3 hardcoded maps bằng 1 auto-generated module (Option C, E4→E3). Đây là hạ tầng dùng chung cho tất cả 21+ table_registry rows, không phải notification-specific.

3. Sau generated map + automated route smoke → P3D resume. Sequence: implement generated map → route smoke PASS → --include-draft hoặc publish tbl_event_outbox → notification display live.

4. Các UI family còn lại = roadmap Phase 2+, không block P3D. Families 2–8 (tài liệu, treeview, quy trình, task form, input form, report, module tabs) ghi nhận trong roadmap, thiết kế khi đến lượt. Không yêu cầu trả lời Q1–Q8 lúc này.

Phase 1 roadmap

Phase 1A — Requirements checkpoint (bản này, v0.2)
  ✅ Xác nhận event_outbox = Family 1 instance
  ✅ Xác nhận generated map = shared infrastructure
  ✅ Xác nhận families 2–8 = future, không block
  → Chờ User xác nhận 3 câu hỏi immediate (xem §10.1)

Phase 1B — Generated map implementation
  → Soạn implementation prompt
  → Agent implement: script + generated file + swap 3 consumers + CI
  → Route smoke toàn bộ 21 routes

Phase 1C — Resume P3D notification
  → --include-draft smoke event_outbox
  → Publish tbl_event_outbox (draft → published)
  → Notification display live
  → P3D Phase 1 = COMPLETE

Phase 1D — Continue information-unit / text-as-code infrastructure
  → P10D Laws Page (Family 2 — chỉ khi sẵn sàng, không block P3D)
  → TAC pipeline tiếp tục

3 câu hỏi immediate cho User (thay vì Q1–Q8)

I1. tbl_event_outbox dùng Family 1 / DirectusTable — chấp nhận? I2. Generated map dùng làm shared Table Module infrastructure cho Phase 1 — chấp nhận? I3. Các UI family khác để roadmap Phase 2+, chưa block P3D — chấp nhận?

---

1–9: Bức tranh tổng thể (giữ nguyên v0.1 làm tham khảo dài hạn)

Các section 1–9 từ v0.1 giữ nguyên bên dưới. Đây là roadmap dài hạn — không phải scope Phase 1.

(Nội dung sections 1–9 giữ nguyên như v0.1 — luồng đọc, luồng ghi, mô hình khuôn, 8 families, decision tree, navigation, legacy cleanup, DOT requirements.)

---

10. Questions

10.1 Immediate (cần trả lời cho Phase 1)

I1. tbl_event_outbox dùng Family 1 / DirectusTable — chấp nhận? I2. Generated map = shared Table Module infrastructure — chấp nhận? I3. Families 2–8 = Phase 2+ roadmap, không block P3D — chấp nhận?

10.2 Future (trả lời khi bắt đầu Phase 2+)

Q1–Q8 từ v0.1 giữ nguyên — sẽ trả lời khi thiết kế từng family.

---

12. Roadmap (updated v0.2)

Phase 1 (current):
  1A ✅ Minimum Display Governance checkpoint
  1B    Generated map implementation → unblock Table Module routing
  1C    Resume P3D notification → publish tbl_event_outbox
  1D    Continue TAC / text-as-code infrastructure (P10D when ready)

Phase 2+ (future — after text-as-code infrastructure stable):
  2A    Family 2: Docs reader / TAC display (P10D)
  2B    Family 3: Treeview generalization
  2C    Family 4: Process view standardization
  2D    Family 5: Task form design
  2E    Family 6: Input form / edit mode
  2F    Family 7: Report table + calculations
  2G    Family 8: Module multi-tab abstraction
  2H    Legacy Nuxt cleanup (UTable migration, server routes, etc.)
  2I    Directus Admin UI integration

---

D28 Bản Yêu Cầu Quy Hoạch Hiển Thị Nuxt | DRAFT v0.2 | Phase 1 Minimum | 2026-05-09