Table Module — Kế hoạch Tổng thể

v1.0 | 2026-03-04 | Lead: Claude Desktop (điều hành) Module bảng là xương sống giao tiếp của hệ thống. Phần lớn UI = bảng dữ liệu.

---

Tầm nhìn

Khi cần 1 bảng mới → khai báo collection + fields config (~15 dòng) → bảng tự động render đầy đủ (pagination, sort, search, filter, responsive). KHÔNG code mới. Nhanh hơn kẻ bảng trong Excel.

Khi thiếu collection/schema → dùng DOT khai báo → collection tạo xong → config bảng → render ngay.

---

Nguyên tắc

1. Ưu tiên đồ có sẵn — kiểm tra Agency OS, @directus/sdk, Nuxt composables TRƯỚC. Code mới chỉ khi không có gì dùng được.
2. Schema-driven — bảng render từ config, không từ code custom.
3. DOT 100% — mọi schema change qua DOT tools, không raw SQL.
4. 1 component, N bảng — DirectusDataTable dùng cho TẤT CẢ bảng trong hệ thống.
5. Mỗi bảng mới ≤ 20 dòng config — quá 20 dòng = sai pattern.

---

Roadmap

Phase 1 — Foundation (S101) ← ĐANG LÀM

• Lập kế hoạch + SSOT
• Kiểm kê lắp ráp (tìm table component có sẵn)
• Tạo DirectusDataTable component (hoặc wrapper nếu có sẵn)
• Tạo useDirectusTable composable
• Tạo workflow_categories collection (DOT)
• Fix lỗi 400 + refactor workflows page dùng DirectusDataTable
• Verify production

Phase 2 — Nâng cao (tương lai)

• Inline editing (click cell → edit → save)
• Bulk actions (chọn nhiều → xóa/cập nhật)
• Export CSV/Excel
• Column resize/reorder (drag)
• Row grouping (nhóm theo field)
• Virtual scroll (bảng >1000 dòng)
• Custom cell renderers (badge, progress bar, avatar...)
• Saved views/filters (user lưu bộ lọc yêu thích)

Phase 3 — Advanced (dài hạn)

• Table builder UI (kéo thả tạo bảng từ Directus Admin)
• Cross-collection join views
• Real-time updates (websocket)
• Pivot/aggregate views

Phụ thuộc tương lai — Schema & Collection Module (TD-062, TD-063)

Table Module phụ thuộc schema/collection. Hiện các thao tác schema rải rác (DOT tools, operating rules, custom-code-registry). Khi Schema Module ra đời → Table Module gọi Schema Module để double-check + tạo collection tự động. Chưa có → tuân thủ quy trình thủ công trong Table SSOT §III Bước 0.

---

Liên kết

• SSOT: knowledge/dev/ssot/table-module/
• Operating Rules: §II "MODULE BẢNG — SCHEMA-DRIVEN TABLE (S101 Rule)"
• Custom Code Registry: knowledge/dev/ssot/custom-code-registry.md