Files
solution-erp/docs/governance
pqhuy1987 a3776eaac4 [CLAUDE] Docs: thi hanh tron plan adap dot-2 (P2/P3/P5/P7i + W4 + khoan 5/6)
Chu du an chot 6 cau @S181; so quyet-dinh o
runs/2026-08-07-S180-adap-upgrade-pack-phased/owner-decisions-07-08-2026-dot-2.md

- P2=PB-2 sua luat da ratify du 2 SITE (tiep.md §3-bis canonical + pause.md
  b6 chi TRO). Cau cam san-3 GIU NGUYEN, chi them ranh REQUEST ⟂ TASK.
- W4: docs/governance/so-yeu-cau-chu-du-an.md 3 khoi, ma YC/ST/PN vinh vien.
  Config: tiep_reload.sources 8->9 + owner_request_verbatim_char_cap.
  nhip-no-probe ve-5 "so-yc treo/nhac2+", fault-inject 5/5, phan biet
  chua-co-du-lieu ⟂ treo 0. Ky luat ghi-NGAY + A5 cam CLAUDE.md + rules.md §6.0.
- P5: ACTIVE-MARKS §LT3 luat tu-tri 3 bac + mark RC-...-07-08-2026-20-57-48.
- P7(i): docs/governance/expensive-runs-view.md derive-view 5 cot.
- P3=B: niem phong _sealed_P3B_S181 (forward-only). Phep thu A10 da co rang
  (fault-inject: class tu che => exit 2; class hop le => exit 0).
- Khoan 6: scripts/naming-baseline.json = NGUON, script chi doc.
  Fault-inject 6/6 hai chieu. 7/7 baseline xanh. 0 byte non-ASCII.
- Khoan 5: broadcasts/_index.md +cot "ap" cuoi hang, backfill 42/4/23 = 69.
- W3 acceptance 6/6 dong + va defect con-tro bang-19-cua (view-stale-status).

Con treo: P8/W4b, W5, P7 ve (ii), VK-5, P3 hoi-to hay forward-only.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 21:25:50 +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