Files
solution-erp/docs/governance/README.md
pqhuy1987 a2b37dcccc
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 6m26s
[CLAUDE] Docs: S168 closeout-no — gotcha #86 + H24-DEEP F4-F11 resolve + STATUS/HANDOFF/CLAUDE tuoi + orphan S163/S166 harvest + diary ctx + tally L9
- gotcha #86: 2-push-sat -> Gitea auto-CANCEL run dau (CANCELLED != fail; verifier doc run CUOI cua range) + cheatsheet 34 + STATUS row 86
- H24-DEEP 11-FLAG: F-4 CLAUDE-mig 70/71 + module-row 69,71 · F-5/F-6 HANDOFF segment S163->S168 + NEXT-em disposition · F-9 cicd-monitor bo literal baseline 5 site (B1 tro STATUS, an tu restart) · F-10 bo-neo-phase 3 site · F-11 governance README lat nhan · F-8 KHONG-AP theo ring2-bac (slot 59 giu song)
- STATUS: :6 header S168 7/8-wave + 639-test + gotcha-86 + counter-42 · :472 Tests cell 639 (45D+594I) · :473 Gotchas 86 · :479 bundle RgvHZkPH/D65FJPGd #442
- HANDOFF: segment moi S163->S168 + slot (63) GD3 2-quyet + 4-slot-dong (54)(56)(57)(58) + slot (59) phan-xu ring2 + carry re-stamp
- orphan harvest: bookend-open-synthesis.md (S163, 10/10 verdict verbatim-tu-dia) + h24-deep-synthesis.md (S166, disposition tung dong F1-F11 + ring2 INFORM 1-6)
- spec-cum1: dinh-chinh PUT-Conflict theo phan gate-K3 (khoi @S168, chu goc giu)
- run.md S164: ledger 8 row (K3-fix + F1/K4ab/K5K4c/K6/K7/GD3/K8) + Stage B4 7/8 (ctx-verifier co-2)
- diary ctx-verifier + ctx-curator: seed 3 luot L9 moi vai (on-behalf, nguon verbatim _context/_mind) · tally #53: su-kien L9 per-window, tong GIU 72-can-duoi (chot @closeout L9)
- /tiep S168: tick 41->42 CLEAN · mind-check 11D/0T · ctx-verifier CO-11-co (co (7)(9) va lien) · _tiep-5 + verdict-vao-bien-nhan

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-01 16:12:06 +07:00

94 lines
5.0 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:** ✅ 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`](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