KB-2F00

h11b-description-detail-missing

3 min read Revision 1
querydescription-governances178-fix28

id: H11b name: Description Detail Missing severity: WARNING category: description-governance law: dieu43-system-context-law §9.1 related: H11a, dieu3-metadata §2.5, dieu24-label deployed: 2026-04-22 session: S178-Fix28 transitional: true

H11b — Description Detail Missing (WARNING)

Ý nghĩa

Entity GOVERNED có description non-empty nhưng chưa được AI/người enrichment. Detect:

  • Label PROV-DOT (máy tự sinh, chưa có AI/người rà) HOẶC
  • Giai đoạn chuyển tiếp (★ R2 Desktop P13): 0 provenance label — entity legacy chưa migrate.

Sau khi hoàn tất migration provenance legacy (Đ3 §VIII bước 7) → thu hẹp chỉ còn PROV-DOT.

Severity WARNING vì vận hành thường: AI enrichment là pha sau, không phải hạ tầng hỏng.

SQL Query

-- Count per table
SELECT v.source_table,
       count(*) AS h11b_findings,
       count(*) FILTER (WHERE v.description_provenance = 'PROV-DOT')    AS prov_dot,
       count(*) FILTER (WHERE v.description_provenance IS NULL)         AS no_prov_legacy
FROM v_entity_full_classification v
WHERE v.governance_role = 'governed'
  AND v.description IS NOT NULL
  AND btrim(v.description) <> ''
  AND (v.description_provenance = 'PROV-DOT' OR v.description_provenance IS NULL)
GROUP BY v.source_table
ORDER BY h11b_findings DESC;

-- Detail list
SELECT v.source_table, v.entity_code,
       coalesce(v.description_provenance,'(none)') AS provenance,
       v.description_length
FROM v_entity_full_classification v
WHERE v.governance_role = 'governed'
  AND v.description IS NOT NULL
  AND btrim(v.description) <> ''
  AND (v.description_provenance = 'PROV-DOT' OR v.description_provenance IS NULL)
ORDER BY v.source_table, v.entity_code;

-- Count total
SELECT count(*) AS h11b_total
FROM v_entity_full_classification v
WHERE v.governance_role = 'governed'
  AND v.description IS NOT NULL
  AND btrim(v.description) <> ''
  AND (v.description_provenance = 'PROV-DOT' OR v.description_provenance IS NULL);

Hành động khi có finding

  • PROV-DOT: schedule batch AI enrichment (Đ3 §VIII bước 10).
  • NULL (legacy): migrate batch bằng bước 7 logic — gán PROV-HUMAN nếu desc là do người viết, hoặc PROV-AI nếu AI viết trước đó.
  • Không urgent, tổng hợp tuần/tháng.

Viện dẫn liên luật

  • Đ3 §2.5: Mô tả chi tiết (PROV-AI/PROV-HUMAN).
  • Đ24: FAC-PROV labels.
  • Đ43 §9.1: Định nghĩa H11.