S108-SELFHEAL — Báo cáo nhiệm vụ

Tổng quan

• Nhiệm vụ: Sửa chữa cơ chế đếm, phát hiện lỗi chính xác, phân loại rõ ràng
• Ngày: 2026-03-10
• Trạng thái: HOÀN THÀNH

Thay đổi chính

Phase 1: Sửa Layer 2 trống (PR #473)

• Nguyên nhân: tableIdMap ánh xạ table->tbl_proposals_list (0 bản ghi) thay vì tbl_table_registry (20 bản ghi)
• Giải pháp: Tạo bản ghi tbl_table_registry tự tham chiếu, sửa tableIdMap

Phase 2: dot-layer-integrity-audit (PR #473, #475)

• 5 kiểm tra x 19 loại thực thể
• CHECK 1: Layer 2 page render dữ liệu
• CHECK 2: Items có mã định danh (PREFIX-NNN) — dùng đúng code field per entity
• CHECK 3: Entity có quan hệ trong entity_dependencies
• CHECK 4: Link riêng hoạt động
• CHECK 5: Cross-check actual_count nhất quán — bỏ qua Model B

Phase 3: system_issues collection + UI (PR #473)

• Collection: system_issues (13 fields, AUTO-ID ISS-NNN)
• Schema script: dot-schema-system-issues-ensure
• UI: Section Vấn đề hệ thống trên /knowledge/registries

Phase 4: Counting v3 (PR #474)

• record_count = items có mã CODE hợp lệ (PREFIX-NNN)
• actual_count = tổng items từ nguồn độc lập
• orphan_count = actual - record
• CODE_INFO map: per-collection (prefix, code_field)
• CAT-999 Chưa phân loại: subtraction logic

Phase 5: Audit code field fix (PR #475)

• CHECK 2: Dùng đúng code field per entity (table_id, process_code)
• CHECK 5: So sánh actual_count (không phải record_count), bỏ qua Model B

Kết quả kiểm tra cuối

dot-registry-count-refresh v3.0

• 19 entity types, 3 thay đổi phát hiện
• CAT-003: orphan=1 (workflow thiếu mã WF-)
• CAT-008: orphan=10 (10 collections chưa đăng ký)
• CAT-017: orphan=15 (15 system issues chưa có mã ISS-)

dot-layer-integrity-audit v1.0

• 69/84 PASS (82%), 6 LỖI, 9 CẢNH BÁO
• 19/19 Layer 2 pages hoạt động (trừ CAT-999 by design)
• Vấn đề thực tế: thiếu mã định danh, thiếu quan hệ entity_dependencies

PRs

• #473: S108-SELFHEAL chính — Merged + Deployed
• #474: Counting v3 + CAT-999 — Merged + Deployed
• #475: Audit code field fix — Merged + Deployed