ae30f8f5e2
Cadence audit (2026-06-01), docs-only -> CI-skip. investigator-codebase drift scan (ground-truth from disk) -> em main patch. No code touched, 154 test unchanged. Drift fixes (42 count corrections): 40->42 mig, 84/59/55/47->91 tables, 130/111->154 test, 52/49->56 gotcha across CLAUDE.md, docs/CLAUDE.md, ef-core-migration + dependency-audit skills, schema-diagram, database-guide. schema-diagram migration table extended Mig 17-42; ef-core history Mig 27-42; detailed-section gap (Mig 27-42 modules) flagged explicit (deferred, not silent). AI_INFRA bundle 06-01 (federated, full scope): - A: RAG T1/T2 auto-ack - C: hygiene 7/7 agent-mem L1 <=16KB; "25KB"->"~30KB tiered" wording x7 - D: #4 self-sustaining adoption-report step -> /session-end Phase 6.3 - E/F: report + ledger -> docs/governance/ Carry-over .mcp.json + BROADCAST-05-29 left untouched (concurrency rule). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
# 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 | S44 audit (docs-only) — [`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
|