Files

pqhuy1987 b223466ded

Deploy SOLUTION_ERP / build-deploy (push) Successful in 3m52s

Details

[CLAUDE] Docs: setup RAG Framework v1.3 governance + eval framework

- docs/governance/README.md: Path B delegation stub → AI_INFRA canonical
  Phase/BC vocabulary documented (9 phase + 10 BC SOLUTION_ERP-specific)
- .claude/rag.json: add _decision_log block (10 rationale entries) +
  add .claude/agents/**/*.md to corpus_paths (fix Case D harvest gap)
- eval/evaluator.md: inline executor spec v1.0 (Spec A strict)
- eval/golden-set-solution_erp.jsonl: 14-entry golden set v1.1
  (5 gotcha + 3 pattern + 3 decision + 3 negative)
- eval/runs/2026-05-26-baseline-v1.0-failed.json: v1.0 attempt
  recall@5=0.455 FAIL — root cause diagnosis Case A/C/D
- eval/runs/2026-05-26-baseline-v1.1-pending.json: v1.1 attempt
  pending CLI restart for accurate numbers
- eval/trial-state-lock.json: 2-section split (quality_gate +
  drift_monitor) per v1.3 §6.2, 4-week milestones 2026-05-26 → 2026-06-23

CRITICAL lesson: bootstrap.py --project flag overrides collection name only.
Use --config D:\...\SOLUTION_ERP\.claude\rag.json for correct project root.
Old projects.json had root_path=AI_INFRA for solution_erp (Anti #24) — FIXED.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-26 13:14:23 +07:00

3.3 KiB

Raw Blame History

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 11,922 chunks 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 — chunks contain D:\Dropbox\... Windows absolute path. Noted — fix in next re-bootstrap run.
Anti #24 registry drift +321% — projects.json says 2830, Qdrant LIVE 11,922. Intentional defer — document in trial-lock _baseline_note. Re-bootstrap align khi Phase 9 UAT ổn định.

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

3.3 KiB Raw Blame History