Files
solution-erp/docs/governance/README.md
pqhuy1987 5dbcad3f2d [CLAUDE] Docs: AI_INFRA bundle 06-01 VERIFIED 2-way — RT3 confirmed close
AI_INFRA re-verified chain ae30f8f->071c25c independently (Gitea, tree clean) ->
NAC VERIFIED-self -> VERIFIED (2-way confirmed). Permanent ledger both sides.
SE = sister thu 2 tron vong doi adoption loop.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-01 13:03:42 +07:00

93 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# RAG Governance — SOLUTION_ERP
> **Pattern:** Path B — Delegation stub (VIPIX pattern per v1.3 §4.1)
> **Adopted:** 2026-05-26
> **Status:** ✅ Active trial week 1-4 (2026-05-26 → 2026-06-23)
---
## 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`](BROADCAST-OUT-SOLUTION-ERP-2026-06-01.md) |
**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