vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2f068c58e5fd19417b58986fc1f0cd907c0c0065
solution-erp/docs/governance
History
pqhuy1987 2f068c58e5 [CLAUDE] Docs: R6 (ANH NEU) - user-memory ngoai repo = 0 git/0 backup/0 history 
OWNER-RAISED: lead dang va TRIEU-CHUNG (hardcode $userMemDir) thi anh chi ra GOC:
"UserMem phai ghi trong thu-muc du-an chu ko phai o C: -- cai nay lau lau drift dinh mai".

DO DUOC:
| user-memory  C:\Users\<u>\.claude\projects\<slug>\memory\ | 48 file · 151,671 B | 0 git | 0 Dropbox | 0 history
| agent-memory <repo>/.claude/agent-memory/                 | 82 file tracked     | git  | Dropbox   | history
=> BAT-DOI-XUNG khong co ly-do ky-thuat nao.

RUI-RO THAT (khong phai chuyen gon-gang):
  bug #53 zero-byte Write -- da MAT INDEX THAT o S45 -- xay ra DUNG tai thu-muc
  KHONG CO HISTORY de phuc-hoi. Cung bug do o agent-memory => git checkout la xong.
  => lop phong-thu hien tai = "verify byte>0" = KY-LUAT NGUOI dung thay VERSION-CONTROL.

settings.json (project + user) = 0 key cau-hinh memory-path => HARNESS EP.
SE CO Y KHONG TU DOI: doi tay => harness thoi auto-inject => MAT memory khoi context
= hong nang hon bug dang co. Cho hub tra loi 1 cau: doi duoc khong, va neu khong thi vi sao?
SE KHONG ket-luan "harness sai" -- co the co ly-do dung ma SE chua thay (secret?
cross-project? per-machine?). SE chi ket-luan: rui-ro la THAT va DO DUOC.

HARDCODE = HE-QUA PHU, do chinh xac:
  sinh e70c046 2026-06-18 20:44 -> va c39ba9d 2026-07-15 15:12 = SONG 27 NGAY.
  Co-che KHONG phai "tai-pham nhieu lan" ma la "sinh 1 lan roi SONG SOT qua ra":
  git log -S bat 8 commit nhung 5/8 co ps1/js-touched=0 (chi doc/WAL NHAC toi path);
  chi 3 dong vao .ps1/.js that -- va 1 trong do la ae957c4 "double-check x2 + finalize":
  mot dot DOUBLE-CHECK da so DUNG FILE do va KHONG BAT DUOC.
  🟢 Doi-chung: spawn-model-audit.ps1 (W1, HOM NAY) lam DUNG san + tu ghi-chu
  "NOT a hardcoded absolute path" => fleet BIET cach dung; thieu LUAT nen file cu khong ai quet.

DE-XUAT: (1) memory song trong repo (doi-xung agent-memory) (2) hoac config path
(3) hoac toi-thieu document ro "khong duoc version-control, project tu lo backup"
+ doc-lap: (4) luat no-absolute-path (spawn-model-audit = mau san) (5) khao-sat fleet.

2 LOI LEAD ghi vao request (du-lieu ve quy-trinh, khong phai loi xin loi):
(a) va trieu-chung khong hoi goc -- feedback_root_cause_over_symptom DA nam trong
    memory cua lead ma lead khong tu bat ra; anh phai chi.
(b) va dung cai duoc chi, khong quet cai khac -- WAL:30 neu 1 script, lead va roi DUNG;
    anh hoi moi loi ra script thu 2 cung doc user-memory. Thoat vi MAY, khong vi quy-trinh.

Email: broadcasts/outbox/ai_infra/2026-07-15-se-to-ai_infra-r6-user-memory-outside-repo.md
  content_sha256 d204973b0a2358fb19da2b7a3f24431ccf7c70e1c33c2df1af41ff7caf1c31b7
  SELFTEST-STAMP PASS. (KHONG sua email cu -- no da dong hash; sua = pha selftest.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 15:41:37 +07:00
..
adap-reports
[CLAUDE] Docs: W6 adap - 5 adap-report + 5 adap-request + email hub (selftest-stamp PASS)
2026-07-15 15:29:07 +07:00
adap-requests
[CLAUDE] Docs: R6 (ANH NEU) - user-memory ngoai repo = 0 git/0 backup/0 history
2026-07-15 15:41:37 +07:00
BROADCAST-OUT-SOLUTION-ERP-2026-05-29-INFRA-RETRO.md
…
BROADCAST-OUT-SOLUTION-ERP-2026-05-29.md
…
BROADCAST-OUT-SOLUTION-ERP-2026-06-01.md
…
error-ledger.md
…
fable-real-runbook.md
…
harness-11-engine.md
…
RAG-AUDIT-RESPONSE-2026-05-29.md
…
README.md
…
vocab-alias-map.md
…

README.md

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
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