ĐIỀU 31 M4B — DÒNG 11 LAYER 2: GOM NHÓM VẤN ĐỀ

Agent: Claude Code | Ngày: 2026-03-24 PRs: #584 (Layer 2 page), #585 (pagination fix), #586 (aggregate API fix) Status: Deployed + verified on production

---

Deliverables

#	Deliverable	Status
1	API /api/registry/system-issues-groups	✅ Directus aggregate API
2	Layer 2 page /knowledge/registries/system_issue	✅ health pattern
3	738 issues → 5 natural groups	✅ Verified
4	Style consistent with other Layer 2 pages	✅

---

Groups on Production

#	Nhóm vấn đề	Số lượng
1	thiếu quan hệ	606
2	link hỏng	119
3	thiếu mã định danh	9
4	sai lệch dữ liệu	2
5	lỗi lớp 2	2
Total		738

---

Fixes During Mission

PR	Issue	Fix
#585	Directus limit:-1 returns 0 records	Paginated fetch attempt
#586	Paginated fetch also returns 0	Directus aggregate API (groupBy + aggregate[count])

Root cause: Service token has meta count permission but NOT record-level read for system_issues. Aggregate API works because it returns counts, not records.

---

VERIFY NUXT

VERIFY NUXT:
- Nuxt URL: /knowledge/registries
  Dòng 11 click → /knowledge/registries/system_issue (Layer 2). ĐÚNG.
  (TRƯỚC: flat list. SAU: 5 nhóm vấn đề)
- Nuxt URL: /knowledge/registries/system_issue (Layer 2)
  Hiện 5 nhóm vấn đề. Tổng: 738. KHỚP.
  Keywords: LAYER 2, Phân loại, thiếu quan hệ, link hỏng. ĐÚNG.
  Summary cards: Total 738, CRITICAL 0, WARNING 0, 5 Nhóm. ĐÚNG.
- Style: CÙNG pattern health/index.vue. Summary cards + UTable. ĐÚNG.

---

Tự kiểm tra

#	Câu hỏi	✅/❌
1	Đã đọc Layer 2 component dòng khác?	✅ health/index.vue
2	API gom nhóm hoạt động?	✅ 5 groups, 738 total
3	Layer 2 hiện nhóm (không flat list)?	✅
4	Style CÙNG dòng khác?	✅ health pattern
5	Tổng count nhóm = 738?	✅
6	CI GREEN?	✅ PRs #584, #585, #586
7	VERIFY NUXT đầy đủ?	✅