Files
solution-erp/docs/governance
pqhuy1987 706134daa9
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 6m24s
[CLAUDE] Workflow: KHKK 8 panel nhóm mirror DuyetNcc + BE guards (0-mig)
YC-013 (S182/L13). 8 leaf "Duyệt KHKK — Nhóm 1..8" ra đúng khuôn trang
DuyetNcc: slice per-Code + lockedCode + Sửa-tại-chỗ/Tạo-version/Ghim/Xoá.
D3=C (YC-014): 6 ô chưa-wire disabled-giữ-state-thật + tooltip trên label
(Chromium không hiện title trên input disabled — MAJOR-1); ô #4 thêm chữ
nhìn thấy được; #7 giữ; #8 Finalize 0-chạm (prod 8/88 dựa nó); ô CEO
disable type-10 + POST null.

BE 5 guard (0 migration):
- W1a deactivate-per-Code cho type-10 (Code+Type+IsActive — cấm regex);
  Code normalize Trim().ToUpperInvariant() tại đường ghi + IgnoreCase belt
  trong GroupCodePattern (MAJOR-2: SQLite test case-sensitive nguoc prod
  CI_AS collation)
- W1b ContractSigningPlanWorkflowGuards (public static, Application) —
  rào nhóm 3 cửa Create/UpdateDraft/Submit, giữ cho-qua-code-ngoài-họ
- W1b2 (D6) pin-check IsActive+IsUserSelectable 2 cửa, 2 message tách
- W1c changelog PUT type-10 vào ContractSigningPlanChangelogs
- W1d DELETE usage-check 409 đích danh (8 module pin, IgnoreQueryFilters
  cho PE/Contract/KHKK; 5 module office pin loose-0FK — guard là rào duy
  nhất chống dangling) + 404 NotFoundException + D5 rào version-cuối nhóm
  (+ ApplicableType — MINOR-3)

Test 645 → 660 (+14 spec + T15 D6-Create MAJOR-3); MINOR-1 pin nguyên câu
thứ-tự 1 ca. File test thứ 3 (GroupAndCatalog) đổi 1 assertion theo câu
409 mới của W1b — spec-change, không phải nới bar.

Khai accepted (reviewer PASS_WITH_FIXES 0C/3M+6m, đã vá 3M+2m):
- MINOR-4: panel nhóm tạo-version-mới ⇒ 6 cờ khoá đóng băng default FE
  (vô hại — BE không đọc 6 cờ đó cho type-10)
- MINOR-5: bỏ ghim/bỏ active bản cuối nhóm = đóng cửa tạo phiếu nhóm đó
  (răng thật của nút Ghim — không rào đợt này)
- race 2-admin cùng Code → 2601/500 thô (UNIQUE đỡ data, chấp nhận)

Evidence: .claude/workflows/runs/2026-08-08-S182-khkk-awf-mirror-ncc/
(3 fable-invest + 2 fable-review + spec FINAL + 4 lane + precheck prod
12 phiếu/pin-lệch-0 + reviewer pre-commit)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-08 12:14:37 +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