Files
solution-erp/docs/governance
pqhuy1987 92d8215a62 [CLAUDE] PurchaseEvaluation: YC-028 sự cố prod A/059 — FE tách "404 thật ⟂ lỗi hệ thống" 5 site ×2 app + guard disk/orphan vào runbook+cicd-monitor
Sự cố 2 tầng (đã giải trọn trong phiên, chi tiết runs/2026-08-10-S189-bookstart-open/run.md + WAL):
- T1: ổ C VPS 0 byte (gitea repo-archive 16,49GB + npm-cache SYSTEM 12,76GB) → SQL Error -2
  → "ko duyệt được" rồi FE vẽ mọi lỗi thành "Không tìm thấy phiếu" (#44). Dọn ~30GB cache
  + AUTO_CLOSE OFF ×3 DB + gỡ nén NTFS 4 file template (#88 tái phát).
- T2: 3 sshd mồ côi (lệnh đo ssh bị cắt output) bão hòa 3/3 core → mọi GET detail 5-47s,
  A/059 (5 NCC) vượt trần hủy ~30s của FE. Kill orphan → A/059 47s→0,38s · phiếu bé 0,17s.

Code (5 site cùng lớp, SHA-mirror 4 cặp MATCH, build ×2 xanh):
- lib/apiError.ts +isNotFound(err) — chỉ 404 mới được nói "không tìm thấy"
- PurchaseEvaluationsListPage (inline + overlay + fullpage) + KhkkListPage + KhkkCreatePage:
  detail.isError && !404 → "Hệ thống đang chậm hoặc lỗi khi tải phiếu — thử lại (refetch)"

Ops-guard (YC-028 (4)): cicd-monitor persona +bước 1b server-health (fsutil free <5GB = FAIL,
CPU-delta tìm orphan) · iis-deploy-runbook +§"Disk-free + orphan guard" + sửa path log Serilog
sai (Logs\log-*.txt → logs\solution-erp-*.log, đo thật). (6) đóng: log 10/08 mất do đợt "giải
phóng dung lượng" hôm qua (retention 30 file config đúng). (3B) cron archive_cleanup Gitea +
decompress Vietreport_Master = chờ ngoài giờ (restart service dùng chung VIETREPORT).

Sổ: +YC-028 (nguyên văn + 2 tầng đã xử). Squash wal: trailing theo §5.0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 11:25:51 +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