Files
solution-erp/docs/governance
pqhuy1987 936d1aed6c [CLAUDE] Docs: thi hanh 4 cau anh chot — gui hub + ghep dieu-kien-3 + chot P3/VK-5
Anh tra "1,2,3,4 -> OK".

🔴 KHAI CACH DOC (cau 3 va 4 KHONG phai yes/no, chung la cau chon A-hay-B):
- (1)(2) dang yes/no  => doc thang la CO.
- (3) P3 forward-only HAY hoi-to  => lay nhanh lead DA NEU la dang doc
  (forward-only) va la nhanh KHONG PHA HUY. Hoi-to se pha bat-bien
  counts ≡ enum + pha acceptance W3 => can lenh TUONG MINH, khong suy tu "OK".
- (4) VK-5 nhap khoi chinh HAY giu phu luc => lay nhanh AN TOAN lead da chon
  theo bac-2: giu phu luc. Nhap bang HANDOFF:10-17 vao khoi chinh se lam ban
  dung cot "loi nguyen van" ma luat chong-bay-A1 dung ra de giu sach.
Ca hai deu la bac-2 (nhanh an toan + khai). Anh muon nhanh kia thi 1 chu la doi.

Thi hanh:
1. Bao-cao-cuoi lat sang DA DUYET + DA GUI. Thu di:
   broadcasts/outbox/ai_infra/2026-08-07-se-to-ai_infra-upgrade-pack-phased-bao-cao-cuoi.md
   stamp_verify: OK (canonical match). Da them dong OUTBOUND vao _index.
   🔴 Thu KHONG tu phong nac "da duoc kiem chung" — chi hub cap.
   Thu mang phan bien nguoc: bien the "DA DUNG NHUNG KHONG AI GOI" (2 may
   governance 0 cua goi), de nghi hub them canh "da chay nhung khong ghi lai".
   Muc 5 tu khai 3 loi cua SE, ca 3 do phep do DOC LAP bat.
2. Dieu-kien-3 cua thu hub ghep vao BAC-2 §LT3: khong phan biet duoc
   doi-co-chu-y voi roi-im-lang => khai "khong du du lieu", CAM mac dinh ve
   nhan mien toi. Nay la luat dang hieu luc, khong con la con-tro.
3. P3 = FORWARD-ONLY chot. Khong truc xuat 12 class khoi enum da niem phong.
4. VK-5 = GIU PHU LUC chot.

🔸 Ghi lai 1 loi thao tac: lead tu cai lai phep bam sha256 (split moi dau '---'
   nen an ca duong ke ngang) => MISMATCH. Header script ghi ro "hash via
   script-file ONLY". Da dung gia tri canonical cua script.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 23:37:36 +07:00
..
2026-08-07 17:37:03 +07:00
2026-07-31 21:47:23 +07:00
2026-08-07 17:37:03 +07:00

RAG Governance — SOLUTION_ERP

Pattern: Path B — Delegation stub (VIPIX pattern per v1.3 §4.1) Adopted: 2026-05-26 Status: Adopted — trial week 1-4 (2026-05-26 → 2026-06-23) ĐÃ ĐÓNG; RAG delegation đang phục-vụ thường-trực (2 trục service-liveness / index-freshness → docs/STATUS.md row "RAG chunks"). (Lật nhãn @S168 — H24-DEEP FLAG-11: header treo thì-hiện-tại cho cửa-sổ đã qua 39 ngày.)


Delegation to AI_INFRA canonical

SOLUTION_ERP adopts RAG Framework v1.3 via Path B delegation stub — deferring to AI_INFRA canonical docs.

Doc Path
Comprehensive guide (v1.3) D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-FRAMEWORK-V1.3-SETUP-GUIDE.md
Quickstart checklist D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-QUICKSTART-SISTER-PROJECT.md
Layer A canonical D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-LAYER-A-PROJECT-LOCAL.md
Self-execute walkthrough D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-SELF-SETUP-WALKTHROUGH-AI-INFRA.md

SOLUTION_ERP project-specific config

Phase + BC vocabulary

Phase enum (project-specific):

  • phase-1-foundation — Core schema + Identity + Master (Mig 1-11)
  • phase-2-contract — Contract workflow 9-phase (Mig 1-11)
  • phase-3-pe-v1 — PurchaseEvaluation V1 flat approval (Mig 12-15)
  • phase-4-budget — Budget module 3-panel (Mig 14)
  • phase-5-forms — FormTemplate + Clause engine (Mig 4)
  • phase-6-pe-v2 — PE V2 dynamic approval workflow (Mig 22-26)
  • phase-7-contract-v2 — Contract V2 mirror PE pattern (Mig 27-33)
  • phase-8-admin-ops — CatalogManager role + admin ops (Plan CA)
  • phase-9-uat — UAT + production hardening (current)

BC (bounded-context) enum (project-specific):

  • bc-contract — Contract workflow + ContractApprovals
  • bc-pe — PurchaseEvaluation + PEDeptOpinions + PELevelOpinions
  • bc-budget — Budget + BudgetItems
  • bc-identity — User + Role + Permission + MenuItem
  • bc-master — Supplier + Project + Department
  • bc-forms — FormTemplate + FormClause
  • bc-notification — Notification + SignalR
  • bc-workflow — ApprovalWorkflow + Steps + Levels (cross-module)
  • bc-cicd — Gitea Actions + NSSM runner + IIS deploy
  • bc-agent — Sub-agent memory + skills + governance

Anatomy gate threshold

6/6 STRICT per v1.3 §5.2 default — corpus ~2,409 chunks (post-S41 cleanup 2026-05-29; was 11,922 pre-cleanup inflated) mature enough.

Spec A vs B

Spec A — Strict — SOLUTION_ERP chunks canonical + finite scope (gotchas, patterns, decisions) → strict retrieval test appropriate.


Adoption state

Component Status
Layer A delegation stub This file
.claude/rag.json _decision_log Added 2026-05-26
Anatomy gate 6/6 Documented
Spec A vs B Spec A chosen
Golden set 14 entries eval/golden-set-solution_erp.jsonl
Baseline run eval/runs/2026-05-26-baseline-v1.0.json
Trial state lock eval/trial-state-lock.json
Trial milestones 4-week 2026-05-26 → 2026-06-23

Anti-pattern watch (SOLUTION_ERP-specific)

  • Anti #23 source_path absolute path leak resolved S41 re-bootstrap (2026-05-29): node_modules/_archive excluded, slug fixed. Some (manual) store_memory chunks retain absolute path (cosmetic, non-blocking).
  • Anti #24 registry drift +321% resolved S41: re-bootstrap host-side --config → Qdrant 2,406 (674 junk), registry aligned. (Was: projects.json 2830 / Qdrant LIVE 11,922 inflated.) ⚠️ eval/trial-state-lock.json baseline still cites old number → AI_INFRA to reconcile.

Cross-Project Adoption Ledger (AI_INFRA bundles)

Bundle date Adopted Evidence
2026-05-29 (charter v2 / tiered-mem / session-cmd / RAG v1.3) 4/4 6f08d1f (Tiered Memory v1) + c8ff5e1 (/session-start /session-end) · RAG re-bootstrap 3080→2406
2026-06-01 (RAG T1/T2 · Gov-v2 · hygiene · session-cmd #4) §A auto · §B align · §C wording ×7 · §D #4 step · §E/§F · VERIFIED 2-way (AI_INFRA RT3 confirm) S44 audit (docs-only) — chain ae30f8f→071c25c tree-clean — BROADCAST-OUT-SOLUTION-ERP-2026-06-01.md
2026-06-02 (adap-* channel + Memory-strip + frontend-designer + Gov-v2 re-confirm) 3-cmd channel installed · #1 strip store_memory 8 subs (lead=sole RAG-writer) · #2 frontend-designer 8th agent ADOPT · #3 Gov-v2 already-S44 delta S47 — docs/governance/adap-reports/ 3 files (5-field LOCK) · nấc executed / verified-pending restart (spawn-test FD2) · AI_INFRA /adap-audit reads cross-repo

Cadence #4 (self-sustaining): /session-end Phase 6.3 auto-generates §E adoption-report when infra adopted → em main /session-start next watches + double-checks (2-way loop).


Tags: solution-erp delegation-stub rag-v1.3 path-b spec-a anatomy-gate-6-6 adoption-ledger