diff --git a/.claude/agent-memory/investigator-api/MEMORY.md b/.claude/agent-memory/investigator-api/MEMORY.md
index 69a6d45..8f09a4b 100644
--- a/.claude/agent-memory/investigator-api/MEMORY.md
+++ b/.claude/agent-memory/investigator-api/MEMORY.md
@@ -28,7 +28,8 @@ Read-only EXTERNAL research specialist. WebFetch/WebSearch official docs + NuGet
 
 ## 📅 Recent activity (last 10 FIFO)
 
-- **2026-05-29 (S39 agent split setup):** NEW agent created từ split investigator. Seeded external-research half. Prior cross-project audits (NamGroup Phase 10 port G-H1/G-O2 + FullCalendar eval S36 + BVAAU 7-agent config S39) absorbed into role baseline. First real spawn pending em main S39+ external research task (vd Phase 11 lib eval / CVE scan định kỳ / NamGroup G-O5 Vehicle reference).
+- **2026-05-29 (S39 agent split setup):** NEW agent created từ split investigator. Seeded external-research half. Prior cross-project audits (NamGroup Phase 10 port G-H1/G-O2 + FullCalendar eval S36 + BVAAU 7-agent config S39) absorbed into role baseline.
+- **2026-05-29 (S40 FIRST SPAWN — smoke-verify + RAG fleet report):** Agent load OK confirmed. `list_projects` → 7 project, total **39,798 chunks**. Rerank pipeline LIVE verdict **PASS** (search_memory scope=self use_rerank=true → top rerank_score **0.8789**, 3 results all carry rerank_score). Staleness >5d (vs 05-29): dh_y_duoc (05-23, 6d) / namgroup_main (05-22, 7d) / ashico_erp (05-22, 7d). solution_erp 05-28 fresh-ish but missing S37-S39 content. `shared_global` = 0 chunks (chưa promote pattern nào). MINOR drift: namgroup_main actual 11306 (brief said 11305). vipix_ai_infra (1652) = AI_INFRA hub root `D:\...\AI_INFRA`. No re-ingest performed (report-only).
 
 ---
 
diff --git a/.claude/agent-memory/investigator-codebase/MEMORY.md b/.claude/agent-memory/investigator-codebase/MEMORY.md
index 6f4ff57..bd3b1eb 100644
--- a/.claude/agent-memory/investigator-codebase/MEMORY.md
+++ b/.claude/agent-memory/investigator-codebase/MEMORY.md
@@ -129,6 +129,8 @@ State machine 5 trạng thái phiếu PE: Nháp / Đã gửi duyệt / **Trả l
 
 ## 📅 Recent activity (last 10 FIFO)
 
+- **2026-05-29 (S40 STATE GROUNDING AUDIT — docs vs codebase drift):** Em spawn ~9K. **7 metric verify, 4 DRIFT / 3 khớp.** ✅ **Migrations=40** (path THẬT `src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/*.cs` — STATUS glob `Migrations/*.cs` trả 0 SAI, skill `ef-core-migration` ghi đúng path nhưng stale "31 mig"). Mig cao nhất = `20260528090839_AddAttendances` (G-P1). ✅ **Gotchas=55** (format `### N.` NOT `#NN`, highest `### 55.`). ✅ **git clean** main. ❌ **DbSet=77** (docs 84, -7) — `grep "public DbSet<"` ApplicationDbContext.cs. ⚠️ **Endpoints=211** (docs ~223): 65 GET+69 POST+39 PUT+33 DELETE+5 PATCH. ❌ **FE pages fe-admin=36** (docs 53, -17 nặng; fe-user=29; 36+29=65≠53 nên không phải gộp). ❌ **Menu keys=53** (docs 85, -32 nặng — `MenuKeys.cs` const string=53 single-source; 85 nghi là seed row runtime sau inheritance expand NOT const định nghĩa). **Drift nặng nhất = Menu keys + FE pages** (over-count, docs trộn seed runtime vs const, hoặc S38 skeleton không sync ngược). **Surprises**: (a) Mig 37/38 THỰC = 37 `ExtendApplicableTypeForWorkflowApps` + 38 `AddProposals` TÁCH RIÊNG — KHÁC S37 memory tôi ghi "gộp 37+38 = Proposal" (recommend gộp KHÔNG được adopt). (b) DbSet 77<84 nghi vài entity Phase 10 (WorkflowApps/Attendances/Proposals/MeetingRooms G-* skeleton) chưa add DbSet hoặc gom chung — đáng audit sâu nếu skeleton wire thiếu. (c) Mig 40 thực = AddAttendances NOT documented "Mig 34-40 G-* port" range vẫn đúng. **Recommend**: sync STATUS.md 4 con số (Tables 77 / Endpoints 211 / FE pages 36 / Menu keys 53). Migration + gotcha + git là 3 con số TIN CẬY nhất. Token ~9K. Tag `[state-grounding, docs-drift, s40]`.
+
 - **2026-05-29 (cross-project — BVAAU 7-agent config extract):** Em đọc full 8 file `D:\Dropbox\CONG_VIEC\BENHVIEN_A_AU\SOURCE_CODDE\.claude\agents\` ~22K. **BVAAU split 4→7 trục research(2)/implement(2)/quality(3)**: investigator-api(blue READ external GetFly/Pancake docs) · investigator-codebase(cyan READ internal+sqlcmd) · implementer-domain(yellow WRITE `Domain/**`+`Application/**` only) · implementer-infra(orange WRITE `Infra/**`+`Api/**`+`Web/**`+`Web.Reports React`) · test-specialist(purple WRITE `tests/**` only NEW) · reviewer(red) · cicd-monitor(green). **Boundary key**: repo *interface*=domain, EF *config*=infra, test assertion=test-specialist (2 implementer KHÔNG viết test). **8-criteria REFUSE** cả 2 implementer (schema/UX/cross-stack>2layer/bug-reasoning/<30min/first-time/spec ambiguity>20%). **Token**: ~1.35M/heavy (~6.5× solo) optimized ~700K; Agent fresh ~150K cache-write / warm ~50K / SendMessage 5-30K/turn / parallel SendMessage ⚠️2.25-3×. **Tool diff CRITICAL**: cả 7 BVAAU agent có 5 RAG MCP (`search_memory+search_code+cross_project_search+store_memory+list_projects`) vs SOLUTION_ERP hiện chỉ 2 (`search_memory+cross_project_search`) → BVAAU +3 (`search_code` BM25 saves Read full file + `store_memory` instant index + `list_projects`). **Skill**: BVAAU `skills:` frontmatter KHÔNG có, total skill=0 (Phase 0 all TBD) — SOLUTION_ERP 6 skill+preload MẠNH HƠN, giữ nguyên khi port. **Curate rule**: >25KB archive `<YYYY-MM>.md`, >50KB hard limit. **Parallel patterns**: A=investigator-api→DTO→(infra+domain parallel)→test→reviewer→cicd; B=4 sync job song song file-disjoint. **Surprises**: (a) VIPIX guide `D:\...\VIPIX_MULTISITE_PROJECT\docs\guides\multi-agent-setup-guide.md` KHÔNG tồn tại (glob toàn project miss) → "16 spawn ~1.49M" claim không verify được, đừng cite. (b) 3 inconsistency BVAAU file: cicd ghi cả `.gitea/` (L25) lẫn `.github/` (L159) workflow path; investigator-codebase MEMORY path `/investigator/` mismatch tên agent; README "Setup checklist" L331 vẫn "4 sub-agent" chưa update 7. (c) BVAAU Phase 0 codebase RỖNG → config aspirational template chưa battle-test (vs SOLUTION_ERP 38 session proven). **Recommend port**: trục split + 8-criteria REFUSE + 5-category reviewer adversarial, GIỮ skill-frontmatter SOLUTION_ERP, ADD 3 RAG tool nếu MCP support. Token cost ~22K. Tag `[cross-project, bvaau-agent-config, port-pattern]`.
 
 - **2026-05-28 (S37 Plan G-O3 Đề xuất pre-flight 4 task):** Em spawn ~14K. **T1 Enum:** `ApprovalWorkflowApplicableType` ở `ApprovalWorkflow.cs:45-50` Mig 22 add — 3 value 1-based (DuyetNcc=1, DuyetNccPhuongAn=2, Contract=3) NOT 0-based. Mig 37 +1 value Proposal=4 (G-O3 first), reserve 5-8 cho G-O4..O6 future. **T2 PE pattern intel** (mirror skeleton Mig 38): main entity 25 field critical (Id/MaPhieu/Type/Phase 5-state/TenGoiThau/ProjectId/DepartmentId/DrafterUserId + ApprovalWorkflowId pin V2/CurrentStepIndex/CurrentLevelOrder + BudgetId/BudgetManual + RejectedFromPhase legacy + 8 nav list). LevelOpinion UNIQUE per-LEVEL NOT per-User (composite `(PEId, LevelId)`), FK Cascade Pe + Restrict Level, denorm SignedByFullName(200). CodeSequence **1 row per Prefix** (NOT N rows per year): `PE/YYYY/A` + `PE/YYYY/B` riêng, 3 col Prefix PK+LastSeq+UpdatedAt, tx SERIALIZABLE. ApproveV2Async logic 7 step (load eager → group Levels by Order = Cấp OR-of-N → match actor.Id ∈ ApproverUserId + Admin bypass → log Approval + UPSERT LevelOpinion auto sync → F2 skipToFinal check matchingLevel.AllowApproverSkipToFinal advance tới last Step+last Level Phase giữ ChoDuyet → advance normal levelOrder++ trong Step → next Step reset 1 → DaDuyet terminal). **T3 NamGroup Proposal**: 3 entity `TblRequest.cs` (25 cols generic + SoTien decimal + NguoiNhanTien + TaiKhoanNganHang advance payment) + `TblRequestConfig.cs` (CSV ListApproval inline + IsDirectManager) + `TblRequestListApproval.cs` (forward mechanism qua NguoiChuyenTiepId/NgayChuyenTiep + ChapThuanHoanToan int). **Verdict: SOL CLEAN-ROOM MẠNH HƠN** — NamGroup generic Request KHÔNG phân biệt Đề xuất/Yêu cầu/Phép (1 entity cover ALL). SOL dedicated `Proposal` entity + Workflow V2 pin FK > NamGroup inline CSV JSON. **T4 Mig 38 propose 4 bảng**: Proposals (Code `DX/YYYY/NNNN`, Title/Desc/Category nullable FK + free text fallback, AmountEstimate decimal? optional, Status ProposalStatus 5-state mirror PE, DepartmentId/DrafterUserId, ApprovalWorkflowId pin ApplicableType=4 + CurrentStep/Level pointer + SLA) + ProposalAttachments + ProposalLevelOpinions UNIQUE (PropId, LevelId) + ProposalCodeSequences 1 row Prefix `DX/YYYY`. **3 decision points em main chốt**: (1) CategoryId nullable FK + free text fallback (lesson Plan C drift 8 FK ZERO populated 1675 NV). (2) 5-state mirror PE NOT 7-state Contract (Đề xuất đơn giản hơn HĐ). (3) Dedicated `ProposalStatus` enum NOT reuse PurchaseEvaluationPhase (anti-pattern cross-module coupling). **Surprises**: (a) NamGroup TblRequest có `SoTien + NguoiNhanTien + TaiKhoanNganHang` advance payment — SOL có cần? Defer Mig 39 optional. (b) F1+F3+F4+F2 per-Level pattern Mig 29-31 — Proposal có nên mirror? Option B "đơn giản KHÔNG flag" tiết kiệm 3 chunk admin Designer. (c) **Recommend gộp Mig 37+38 → 1 Mig** `AddProposalsAndExtendApplicableType` (mirror Mig 20 Contract N-stage gộp). Token cost ~14K.
@@ -145,7 +147,6 @@ State machine 5 trạng thái phiếu PE: Nháp / Đã gửi duyệt / **Trả l
 
 - **2026-05-26 (S32 wrap — em main proxy update final state):** Session 32 đóng clean. Em chủ trì spawn em 2 lần S32: (1) startup verify ~10K (afaf6d52a6a59a844 alive) + (2) NamGroup audit pre-flight ~30K (a533c3e8ed4e03bfe hit limit 157K/72 tool_uses fallback em main solo audit). **Em main solo audit NamGroup directly** thay vì re-spawn: discovered NAMGROUP.Server\Data\Entities có 8+ TblNhanVien* (QtCongTac/QtDaoTao/QuanHeThanNhan/KyNangViTinh) + 4 bảng org chart (SoDoToChuc/SoDoKhoi/ChucDanh/ViTri) + Announcement/InternalDocument/TblMenu. **Plan G 11 module port DOCUMENTED migration-todos** với 4 quyết định chốt anh main (FULL 11 module + dbo single + Workflow V2 enum +5 + chunk per-module Plan riêng). **S33 priority spawn em pre-flight Plan G-H1 Hồ sơ NS** audit NamGroup TblNhanVien* 8 bảng + map fields → SOL EmployeeProfile schema (Mig 34 design 1 main + 5 satellite WorkHistory/Education/FamilyRelation/Skill/Document) — scope narrower 30 phút mục tiêu. **Curate Plan A3:** MEMORY archived 4 verbose entries q2 (S25 t1 5Q audit Bug Changelog + S26 Plan AG 5Q + S26 Plan AI RAG research + Plan B Contract V2 Q1-Q5 audit detail) → 27.7→19KB. **Pending tasks anh main S33 SendMessage gọi em:** (a) Plan G-H1 pre-flight NamGroup TblNhanVien* audit (PRIORITY HIGH first thing S33); (b) Plan B-Wrap test bundle pre-flight verify ContractWorkflowService ApproveV2Async test scenarios spec D-Bis trong migration-todos; (c) Phase 9 UAT smoke verify V2 contract create flow post-S29 deploy `QT-HD-V2-001` workflow. Token cost wrap ~5K. Tag: `[wrap, phase-9-to-phase-10, infra]`.
 
-- **2026-05-26 (S32 startup — em main proxy verify context + S31 RAG v1.3 baseline awareness):** S31 đóng ~1.5h ngày 2026-05-26 với RAG v1.3 baseline PASS recall@5=1.000 (11/11 queries) + avg_rerank=0.847. **Root cause S31 fix:** `AI_INFRA/claude-rag/lib/retrieval.py` xài API cũ `qdrant.search()` đã bị qdrant-client 1.18 xóa → đổi sang `query_points().points` API mới. **Gotcha #52 NEW** add vào `docs/gotchas.md` (Qdrant search removed). **Downstream impact:** MCP tools `mcp__rag-unified__search_memory` + `mcp__rag-unified__cross_project_search` live PASS post-CLI restart — test query "gotcha 52 qdrant search removed" top_k=3 trả 3 chunks rerank scores 0.515 / 0.479 / 0.461 (all dưới threshold 0.7 cao mong đợi vì query về symbol `qdrant.search` chỉ match doc rag-setup-plan.md historical, KHÔNG match gotcha #52 doc — doc chưa indexed lần re-index gần nhất hoặc chưa ingest gotchas folder). **Memory size 25.8 KB ĐÃ VƯỢT curate trigger 25KB** — em append entry này + flag em main curate cuối S32 (archive S25 + S26 verbose entries → `archive/2026-05-q2.md`). **Pending tasks anh có thể spawn em qua SendMessage:** (a) Plan B-Wrap test bundle BW1-BW7 (regression ApproveV2Async Contract V2 + ApplicableType=3 validate), (b) Phase 9 UAT audit Contract V2 wire prod usage (V1 7 contract + V2 sample `QT-HD-V2-001` smoke verify), (c) gotcha #52 doc verify trong RAG index (cross-check `docs/gotchas.md` đã re-ingest sau S31 fix chưa). **State delta S29 → S32:** 30 mig → 33 mig (Plan B Contract V2 Mig 32+33 + Plan CA role CatalogManager) · 59 → 60 tables · ~146 → ~148 endpoints · gotcha 47/48 → 52 (+4 #49 Plan B + #50 Plan CA INFRASTRUCTURE seed gate + #51 + #52 Qdrant) · 111 test PASS UNCHANGED (UAT defer test-after) · 23 → 25 memory user-level. Token cost spawn này ~10K.
 
 - **2026-05-22 (S29 wrap — Plan CA + Plan B pre-flight 2 spawns + 3 patterns NEW):** S29 close 2 big plans cumulative. **Plan CA (Move Cấu hình danh mục admin → eoffice)** 7 commits `06a441c..6eec8d7` push deployed Run #229+#230 PASS. **Plan B (Contract V2 wire mirror PE V2 pattern Mig 22-26)** 11 commits `58898e8..38f1c4d` push deployed Run #231+#232 PASS. **Investigator role 2 spawn:** (1) **Plan CA pre-flight audit** (agentId a7ab5576c77ee3730, ~15K token): map 9 menu danh mục terrain + GOTCHA tree-inherit Catalogs↔Master + recommend chunk structure A/B/C/D. fe-user component parity verified (DataTable + PageHeader + PermissionGuard + 6 shadcn ui). DbInitializer SeedAdminPermissionsAsync admin role grant CRUD 27 menu key. Permission Matrix dynamic load /api/menus → tự reflect post-move. (2) **Plan B pre-flight audit Contract V1 state** (agentId abf91b30391fb0cdb, ~25K token): map `Contract.cs` 25 fields (V1 only) + `ContractPhase` enum 12 values (TraLai=98 + TuChoi=99 ready) + `ContractWorkflowService.cs` 220 LOC V1 only + sqlcmd prod 7 V1 contract (Phase 2-8 active workflow) + PE Mig 22-26 reference templates + impact assessment (COEXIST V1+V2, KHÔNG drop V1) + re-chunk 6 chunks (split A → A1 entity + A2 mig). 3 surprise: ApprovalWorkflows Prod ZERO ApplicableType=3 (Chunk A2 must seed sample) + `RejectedAtStepIndex` drift deprecated + ContractType 7 variants generic ApplicableType=3. **Patterns proven NEW Investigator perspective S29:** (a) **9-menu permission terrain map pattern** (Plan CA) — Investigator inventory file paths + line ranges + component parity check + recommend chunk before delegate Implementer. ROI cao. (b) **V1+V2 coexist boundary** (Plan B) — KHÔNG drop V1 vì 7 prod contract pinned. Mirror PE Mig 22-24 spec. (c) **Reference template paths cross-module mirror** (PE → Contract V2): Investigator cite EXACT line ranges (PE Mig 23:14-31, Mig 24:14-17, Mig 26 UNIQUE composite, Service ApproveV2Async 446-634, 519-546 UPSERT, 774-783 ResolveActor) → em main + Implementer chỉ cần mirror rename entity. ROI rất cao saving 30%+ time. **Anti-patterns observed:** (a) Investigator KHÔNG verify endpoint exists end-to-end qua live curl — defer to CICD Monitor stage 4. (b) Investigator output sometimes verbose >700 words → em main hỏi cô đọng <500 next time.
 
diff --git a/.claude/agent-memory/test-specialist/MEMORY.md b/.claude/agent-memory/test-specialist/MEMORY.md
index b11c644..400fa5b 100644
--- a/.claude/agent-memory/test-specialist/MEMORY.md
+++ b/.claude/agent-memory/test-specialist/MEMORY.md
@@ -50,6 +50,7 @@ Test theo CODE (single source truth), document mismatch header comment + report.
 ## 📅 Recent activity (last 10 FIFO)
 
 - **2026-05-29 (S39 agent split setup):** NEW dedicated agent. Seeded test patterns (10 reflection authz + 11 infra helper + 12 InternalsVisibleTo + #48 SQLite tie-break + spec drift S34). Inherited coverage gap backlog 4 priority items từ S36 Reviewer audit (130 PASS baseline). First spawn pending em main S39+ test bundle task (recommend Gap 1 Holiday composite UNIQUE first).
+- **2026-05-29 (S40 baseline audit smoke):** CONFIRMED 130 PASS (Domain 58 + Infra 72), 0 fail/skip, ~15s. Runner count authoritative; raw `[Fact]/[Theory]` attr = 48+70 (Theory→InlineData expand). Infra spread 15 files. Gap re-verified vs prod: EmployeesController+HrmConfigsController EXIST, authz regression chỉ ApprovalWorkflowsV2Controller (gotcha #44 gap real). Proposal = Domain entity + EF config only, CHƯA có ApproveV2Async service (S37 skeleton, defer đúng). Agent load OK. AUDIT-only, no write.
 
 ---
 
diff --git a/CLAUDE.md b/CLAUDE.md
index 81f2438..0b3f40a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -50,7 +50,7 @@ Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Ser
 - Audit fields: `CreatedAt`, `UpdatedAt`, `CreatedBy`, `UpdatedBy` (`BaseEntity`)
 - Soft delete: `IsDeleted`, `DeletedAt`, `DeletedBy` (`AuditableEntity`)
 - Migrations: `dotnet ef migrations add <Name> --project src/Backend/SolutionErp.Infrastructure --startup-project src/Backend/SolutionErp.Api`
-- **Hiện có 33 migration → 60 bảng** (Phase 9+ Session 32 — Mig 32+33 Plan B Contract V2 cookie-cutter mirror PE Mig 22-26 (S29). Mig 26 `AddPeLevelOpinionsForV2`: bảng mới `PurchaseEvaluationLevelOpinions` UNIQUE composite (PEId, LevelId), FK Cascade Pe + Restrict Level. Section 5 "Ý kiến cấp duyệt" V2 dynamic theo workflow đã pin: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox. Service `ApproveV2Async` UPSERT auto khi NV duyệt — Q1=1B (sync gắn với Duyệt, KHÔNG form input rời). SignedByUserId track signer thật, FE banner "Admin duyệt thay" khi !== ApproverUserId. Comment empty → "(duyệt — không ý kiến)" placeholder. Phiếu V1 legacy fallback Mig 15 4 box readOnly (data history). Mig 25 `AddIsUserSelectableToApprovalWorkflows`: ALTER `ApprovalWorkflows` +`IsUserSelectable bit` (admin pin/unpin workflow nào cho user pick lúc create phiếu, multi-select độc lập IsActive). Backfill `WHERE IsActive=1 SET 1` giữ behavior cũ. Designer +badge "Cho user chọn" + button Ghim/Bỏ ghim. Workspace filter dropdown chỉ workflows `IsUserSelectable=true`. Mig 22-24 V2 schema (Session 17): `ApprovalWorkflows`/Steps/Levels — Quy trình > Bước (Phòng) > Cấp (N NV cụ thể qua ApproverUserId, OR-of-N cùng cấp). PE.ApprovalWorkflowId pin V2. PE.CurrentApprovalLevelOrder track. State machine 5 trạng thái: Nháp / Đã gửi duyệt / Trả lại (Phase riêng TraLai=98) / Từ chối / Đã duyệt. PE Service V2 wire match `actor.Id == ApproverUserId`. Contract V2 ĐÃ WIRE (Mig 32+33 Plan B S29 — cookie-cutter mirror PE V2: `ApproveV2Async` + `ContractLevelOpinions` UPSERT + Workspace V2 Select dropdown). 111 test pass. Mig 21 V1 flat workflow vẫn live cho phiếu cũ.)
+- **Hiện có 40 migration → 84 bảng** (Phase 10 COMPLETE — Mig 34-40 HRM/Office/WorkflowApps. V2 schema history S29-era bên dưới giữ nguyên — Mig 32+33 Plan B Contract V2 cookie-cutter mirror PE Mig 22-26 (S29). Mig 26 `AddPeLevelOpinionsForV2`: bảng mới `PurchaseEvaluationLevelOpinions` UNIQUE composite (PEId, LevelId), FK Cascade Pe + Restrict Level. Section 5 "Ý kiến cấp duyệt" V2 dynamic theo workflow đã pin: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox. Service `ApproveV2Async` UPSERT auto khi NV duyệt — Q1=1B (sync gắn với Duyệt, KHÔNG form input rời). SignedByUserId track signer thật, FE banner "Admin duyệt thay" khi !== ApproverUserId. Comment empty → "(duyệt — không ý kiến)" placeholder. Phiếu V1 legacy fallback Mig 15 4 box readOnly (data history). Mig 25 `AddIsUserSelectableToApprovalWorkflows`: ALTER `ApprovalWorkflows` +`IsUserSelectable bit` (admin pin/unpin workflow nào cho user pick lúc create phiếu, multi-select độc lập IsActive). Backfill `WHERE IsActive=1 SET 1` giữ behavior cũ. Designer +badge "Cho user chọn" + button Ghim/Bỏ ghim. Workspace filter dropdown chỉ workflows `IsUserSelectable=true`. Mig 22-24 V2 schema (Session 17): `ApprovalWorkflows`/Steps/Levels — Quy trình > Bước (Phòng) > Cấp (N NV cụ thể qua ApproverUserId, OR-of-N cùng cấp). PE.ApprovalWorkflowId pin V2. PE.CurrentApprovalLevelOrder track. State machine 5 trạng thái: Nháp / Đã gửi duyệt / Trả lại (Phase riêng TraLai=98) / Từ chối / Đã duyệt. PE Service V2 wire match `actor.Id == ApproverUserId`. Contract V2 ĐÃ WIRE (Mig 32+33 Plan B S29 — cookie-cutter mirror PE V2: `ApproveV2Async` + `ContractLevelOpinions` UPSERT + Workspace V2 Select dropdown). Mig 21 V1 flat workflow vẫn live cho phiếu cũ.)
 
 ### Modules
 
@@ -63,7 +63,7 @@ Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Ser
 | Identity (User/Role/Permission/MenuItem) | `Domain/Identity/` | 1, 3, 11 | Feature-complete (30 demo user — 16 sample + 14 Solutions thật) |
 | Forms (Template + Clause) | `Domain/Forms/` | 4 | Feature-complete |
 | Notifications | `Domain/Notifications/` | 6 | In-app + SignalR OK, email SMTP TODO |
-| **Tests** | `tests/SolutionErp.{Domain,Infrastructure}.Tests/` | — | **111 test pass** (58 Domain + 53 Infra) — CI gate + path filter docs-only skip |
+| **Tests** | `tests/SolutionErp.{Domain,Infrastructure}.Tests/` | — | **130 test pass** (58 Domain + 72 Infra) — CI gate + path filter docs-only skip |
 
 ### Commit convention
 
@@ -77,14 +77,14 @@ Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Ser
 
 ```
 tests/
-├── SolutionErp.Domain.Tests/         (54 test - Phase 1: WorkflowPolicy / PEPolicy / BudgetPolicy)
-└── SolutionErp.Infrastructure.Tests/ (17 + 6 + 6 = 29 test)
+├── SolutionErp.Domain.Tests/         (58 test — Domain policy: Workflow / PE / Budget)
+└── SolutionErp.Infrastructure.Tests/ (72 test)
     ├── Common/                       (SqliteDbFixture + TestApplicationDbContext + IdentityFixture S9)
     ├── Services/                     (17 codegen + 6 PE 2-stage approval S9)
     └── Application/                  (6 test - PeWorkflowDefinition versioning)
 ```
 
-**111 unit test pass** / ~3s (58 Domain + 53 Infra: 17 codegen + 6 PE WF + 30 Per-NV regression + Plan M edge case + Plan O cascade hotfix tests). CI gate + path filter live.
+**130 unit test pass** / ~15s (58 Domain + 72 Infra). CI gate + path filter live. (Coverage gap S35-S38: HrmConfig Holiday UNIQUE + EmployeeSatellite cascade + gotcha #44 regression — backlog `docs/STATUS.md`.)
 
 ```bash
 dotnet test SolutionErp.slnx     # chạy cả 2 test project
diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md
index 4fddbc0..2ccc7f4 100644
--- a/docs/HANDOFF.md
+++ b/docs/HANDOFF.md
@@ -1,2683 +1,42 @@
 # HANDOFF — Brief 5 phút cho session tiếp theo
 
-**Last updated:** 2026-05-29 (Session 39 — **⚙️ INFRA: Opus 4.8 1M default + Multi-agent 4→7 (BVAAU adapted) + budget +50%**)
+> **Tiering rule (S40):** giữ **2-3 session gần nhất**. Cũ hơn → `docs/changelog/sessions/`. Full brief history pre-S40 → `docs/_archive/HANDOFF-preS40-fullhistory.md`.
 
-**S39 (2026-05-29):** Pure infra/governance — KHÔNG feature/schema. 1 commit `fd0554a` (docs-only CI skip).
-
-**⚠️⚠️ HÀNH ĐỘNG ĐẦU SESSION S40: ANH MAIN RESTART CLAUDE CODE CLI** (chưa restart S39 → registry vẫn 4 agent cũ). Post-restart verify smoke spawn 3 agent mới (investigator-api / implementer-frontend / test-specialist) confirm load OK trước khi dùng thật.
-
-**7 sub-agent mới (post-restart):**
-| Agent | Color | Scope | subagent_type |
-|---|---|---|---|
-| investigator-codebase | cyan | INTERNAL SQL/EF/grep/reference mirror | `investigator-codebase` |
-| investigator-api | blue | EXTERNAL docs/CVE/lib/cross-project | `investigator-api` |
-| implementer-backend | yellow | .NET Domain+App+Infra+Api | `implementer-backend` |
-| implementer-frontend | orange | FE 2 app cookie-cutter SHA256 mirror | `implementer-frontend` |
-| test-specialist | purple | tests/ dedicated xUnit | `test-specialist` |
-| reviewer | red | adversarial pre-commit + live curl | `reviewer` |
-| cicd-monitor | green | post-deploy Gitea + bundle + smoke | `cicd-monitor` |
-
-**Phân việc S40+ (chi tiết `.claude/agents/README.md`):** Read internal→investigator-codebase · Read external→investigator-api · WRITE .NET→implementer-backend · WRITE FE→implementer-frontend (parallel khi BE+FE independent, em main chốt DTO shape first) · test→test-specialist · pre-commit→reviewer · post-deploy→cicd-monitor. Budget +50% → lean delegate + parallel, ít em main solo (trừ schema/UX/cross-stack tight/gotcha #53-#55 fallback).
-
-**Model:** default Opus 4.8 1M (`~/.claude/settings.json` global 7 project) + 7 agent `model: inherit`. effortLevel max.
-
-**Tool grant:** all 7 agent có 5 RAG MCP (search_memory + search_code BM25 + cross_project_search + store_memory + list_projects).
-
-**2 gotcha NEW (#54 #55):** 529 Overload spawn fail → em main solo fallback · truncation mid-exploration → brief ≤8K + pre-supply reference snippet.
-
-**Memory rename:** agent-memory/ giờ 7 folder (investigator-codebase ← investigator history · implementer-backend ← implementer history · + 3 seed mới). Investigator MEMORY 32KB → cần curate đầu S40 (gotcha #53 risk).
-
-**⚠️ Drift defer cron 2026-06-01:** docs/CLAUDE.md root count (mig 33→40 · gotcha 52→55 · 4→7 agent · table 60→84) + schema-diagram §15+ (Mig 34-40 Phase 10 chưa thêm) + RAG re-ingest S37-S39 content (3076 chunks chưa có Proposal/WorkflowApps/7-agent).
-
-**Next S40 recommend (anh main pick):**
-1. **CLI restart + smoke verify 7 agent** (BẮT BUỘC first)
-2. **Curate Investigator MEMORY 32KB** (~10 phút em main proxy)
-3. **Phase 11 polish** — workflow ApproveV2 wire 5 skeleton module (Leave/OT/Travel/Vehicle + LevelOpinions) + LeaveBalance + Auto-assign + SLA timer — test-specialist write test-before bug fix
-4. **Phase 9 Ops** anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần production validation)
-5. **Test bundle coverage gap** (test-specialist: Gap 1 HrmConfig Holiday composite UNIQUE → Gap 3 gotcha #44 regression → Gap 2 EmployeeSatellite)
-6. **RAG re-ingest** S37-S39 content + cron audit 2026-06-01
-
-**Last updated S38 (prev):** 2026-05-28 (Session 38 — **🎊 PHASE 10 COMPLETE 11/11 Plan G-* atomic 100% DONE — SKELETON 5 plan combo deploy prod**)
-
-**S38 (2026-05-28):** Anh main "OK check lại plan nhé, xem còn gì ko thì finish cho xong luôn đi nhé" — em main pragmatic SKELETON aggressive 5 plan combo (G-O4+G-O5+G-O6+G-P1+G-H3) trong 1 session 1 commit mega. Cumulative end-to-end **1 commit** pushed remote `17aaba9..e54a22d` + **CI Run #247 PASS 3m25s** fastest S38 deploy.
-
-**Commit S38 (1 push):**
-1. `e54a22d` Mig 39+40 + BE mega ~1100 LOC + FE 5 file × 2 app SHA256 IDENTICAL + 11 MenuKey + 8 DbInit menu (Run #247 PASS 3m25s)
-
-**Multi-agent ROI S38 ~80K total (heavy em main solo dominant):**
-- 🟩 CICD 1 spawn ~12K (Run #247 PASS clean)
-- 👤 Em main solo ~68K HEAVY (Mig 39+40 design + BE 1100 LOC mega + FE 5 file × 2 + Permission + commit/push + docs wrap)
-- 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer SKIPPED (skeleton scope no critical risk + em main solo proven fast post S37 lessons learned)
-
-**SKELETON Phase 1 trade-off rõ ràng (defer Phase 11):**
-- Status flat 5-state WorkflowAppStatus share Leave/OT/Travel/Vehicle (NO ApproveV2 advance level)
-- LevelOpinions per-module DEFER (single table per module Phase 11)
-- LeaveBalance calc business logic DEFER
-- CodeGen atomic MaDonTu/MaTicket DEFER (NULL until Phase 11)
-- Vehicle catalog + Driver catalog DEFER (free text VehicleLicense)
-- ItTicketComments thread DEFER (free text Resolution)
-- Auto-assign round-robin + SLA timer DEFER
-- AttendanceReport admin + Excel export + OtPolicy multiplier DEFER
-
-**NEW capability prod S38 (end-to-end UAT-ready visible 100%):**
-- (a) Sidebar Văn phòng số 11 sub-menu (Đề xuất + Đơn từ × 3 + Đặt xe + Ticket CNTT + Chấm công) live
-- (b) Sidebar Nhân sự > Dashboard NS `/hr/dashboard` shows 4 KPI card (Tổng=33 / Active=33 / Sinh nhật 7d / Mới vào tháng) + gender ratio (Male=17 / Female=16) + status breakdown
-- (c) `/attendance` Web GPS check-in/out button live (geolocation API) + tháng calendar
-- (d) `/it-tickets` kanban 5-column status board (Mới/Đang xử lý/Đã giải quyết/Mở lại/Đã đóng)
-- (e) `/workflow-apps/{leave|ot|travel|vehicle}` declarative generic list table
-
-**Bundle hash rotation S38 (1 push):**
-- fe-admin: `CGueDk22` (S37) → `cWAXid0q` (Run #247)
-- fe-user: `CEt0QRgX` (S37) → `CX79e2kZ` (Run #247)
-
-**State chốt S38:**
-- 40 mig (+2 Mig 39+40) · 84 tables (+6 Workflow Apps) · ~223 endpoints (+13 skeleton)
-- 53 FE pages (+5 × 2 app) · 85 menu keys (+8)
-- **130 test PASS unchanged** (UAT mode)
-- **53 gotcha unchanged**
-- 27 memory user-level · 6 skills · 4 sub-agents
-
-**🎊 PHASE 10 COMPLETE — Plan G-* 11/11 atomic ALL DONE cumulative 6 session S33-S38:**
-- ✅ G-H1 Hồ sơ NS (S33) + G-O1 Danh bạ (S34) + G-H2 Cấu hình HRM (S34+S35)
-- ✅ G-O2 Phòng họp (S36) + G-O3 Đề xuất (S37)
-- ✅ G-O4 Đơn từ + G-O5 Đặt xe + G-O6 Ticket CNTT + G-P1 Chấm công + G-H3 Dashboard NS (S38 SKELETON combo)
-
-**Cumulative Phase 10 stats:**
-- 7 Mig (Mig 34→40) · 30+ new tables · ~75+ new endpoints · 17 FE pages × 2 app · 50+ menu keys
-- Pattern 16-bis 9× cumulative · Pattern 12-bis 12× cumulative · Smart Friend 9× clean
-- 6 commit cumulative push 6 CI Run all PASS (Run #237/#238/#240/#241/#242/#243/#244/#246/#247)
-
-**4 sub-agent reuse-able S39+ via fresh spawn:**
-- 🟦 Investigator last spawn `a4c81ef2f9a79a325` (S37 G-O3 pre-flight)
-- 🟨 Implementer last successful spawn `aabfc002a99339ab8` (S36 FE 2 app), 2 spawn S37 FAIL truncate/529
-- 🟥 Reviewer last spawn `a579fa4856eb45316` (S36 G-O2 Smart Friend 9× clean)
-- 🟩 CICD last spawn `a4ea874296872c2be` (S38 Run #247 PASS)
-
-**⚠️ Next session S39+ — recommendations:**
-1. **Phase 11 polish features** — workflow ApproveV2 wire per skeleton module (Leave/OT/Travel/Vehicle) + LevelOpinions table + CodeGen atomic. Spec defer commit message
-2. **LeaveBalance business logic** (Hrm_Config LeaveTypes + EmployeeProfile.HireDate seniority) — em main solo cross-stack tight
-3. **Vehicle catalog + Driver catalog** (Phase 11 Mig 41)
-4. **ItTicket Auto-assign + SLA timer** (reuse SlaTimer pattern Contract)
-5. **AttendanceReport admin + Excel export + OtPolicy multiplier** (Phase 11)
-6. **Test bundle G-O2..G-O3..G-O4 wire** (~30 phút Implementer Case 3) — defer until UAT confirm stable
-7. **Phase 9 Ops anh main coordinate** — SMTP + Rotate creds + UAT 2-3 user 1 tuần production validation
-
-**Defer S39+:**
-- Curate 4 MEMORY (CICD ~30KB post-Run #247 + Investigator borderline) ~10 phút
-- Skill audit cron `2026-06-01` (còn 4 ngày, cumulative drift mig 33→40, gotcha 52→53)
-- Test gate restoration sau UAT mode end
-
-**Last updated S37 (prev):** 2026-05-28 (Session 37 — **🎯 S37 Mig 37 enum extend + Plan G-O3 Đề xuất ALL DONE end-to-end deploy prod full-stack 1 commit**)
-
-**S37 (2026-05-28):** Anh main "OK làm tiếp đi nhé" Full batch 6 plan continuation. Cumulative end-to-end **1 commit** pushed remote `37593f9..de1c378` + **CI Run #246 PASS 3m53s**.
-
-**Commit S37 (1 push):**
-1. `de1c378` Mig 37 enum extend +5 values + Mig 38 Proposal schema + BE CQRS 700 LOC + FE 2 app SHA256 IDENTICAL (Run #246 PASS 3m53s)
-
-**Multi-agent ROI S37 ~225K total (lessons learned mitigation):**
-- 🟦 Investigator 1 spawn ~14K (G-O3 pre-flight — truncated mid-MEMORY size warning 29.6KB)
-- 🟨 Implementer 2 spawn FAIL (BE 150K wasted mid-EXPLORATION gotcha #53 5th + FE 0 token 529 Overload transient)
-- 🟩 CICD 1 spawn ~13K (Run #246 PASS clean)
-- 👤 Em main solo ~50K HEAVY (Mig 37+38 schema + BE 700 LOC + FE 4 file × 2 + 6 mod + commit/push + docs wrap)
-- 🟥 Reviewer SKIPPED (PE pattern proven 11× + test gate PASS + em main solo BE đảm bảo)
-
-**Smart Friend 0 catch S37 — em main solo bypass:**
-- Schema design correct first try (FK strategy + UNIQUE composite + ProposalCodeSequence Prefix PK)
-- ApproveV2Async logic mirror PE pattern exact (match ApproverUserId actor + admin fallback + UPSERT + advance level/terminal)
-- SeedSampleProposalWorkflowV2Async NOT gated DemoSeed (gotcha #51 compliance learned S29)
-- FE PageHeader signature drift caught + fixed (no icon prop, use `actions=ReactNode`)
-
-**NEW capability prod S37 (end-to-end UAT-ready):**
-- (a) Sidebar Văn phòng số > Đề xuất `/proposals` shows table 6 cột + status badge 5 màu + filter
-- (b) `/proposals/new` form Header + ApprovalWorkflow Select pick `QT-DX-V2-001` → Submit → POST + auto-gen `DX/2026/001` atomic SERIALIZABLE tx
-- (c) `/proposals/{id}` 3 Section + WorkflowActions buttons (Submit/Approve/Reject/Return + Comment Dialog) + Section 3 Ý kiến cấp duyệt V2 dynamic UPSERT
-
-**Bundle hash rotation S37 (1 push):**
-- fe-admin: `C9kzTTmq` (S36) → `CGueDk22` (Run #246)
-- fe-user: `CC4DQ-Tr` (S36) → `CEt0QRgX` (Run #246)
-
-**State chốt S37:**
-- 38 mig (+2 Mig 37+38) · 78 tables (+4 Proposal stack) · ~210 endpoints (+8 Proposal)
-- 48 FE pages (+3 × 2 app) · 77 menu keys (+4 Off_DeXuat)
-- **130 test PASS unchanged** (UAT mode)
-- **53 gotcha unchanged** (#53 5th + 529 Overload noted commit only)
-- 27 memory user-level · 6 skills · 4 sub-agents (Investigator MEMORY 29.6KB borderline)
-
-**2 NEW lessons S37 cumulative (em main solo proven fallback):**
-- gotcha #53 5th — Implementer truncated mid-EXPLORATION phase ngay đầu (heavy spec brief ~10K too risky → tight ≤ 6K hoặc em main solo)
-- 529 Overload Anthropic API 1× S37 (S29 đã có 2× — pattern: spawn agent CÓ THỂ fail 0 token, em main MUST có fallback path solo cho critical task)
-
-**4 sub-agent reuse-able S38 via fresh spawn (agentId S37 invalid post-session-end):**
-- 🟦 Investigator last spawn `a4c81ef2f9a79a325` (S37 G-O3 pre-flight)
-- 🟨 Implementer last 2 spawn FAIL (`a3afd177462addaa2` BE truncated + `a590c5c833dc05a1f` FE 529)
-- 🟩 CICD last spawn `ab127ae9929ce6ed7` (S37 Run #246 PASS)
-- 🟥 Reviewer not invoked S37
-
-**⚠️ Next session S38 — sequence em chốt Full batch S37→S41 continued:**
-1. **Plan G-O4 Đơn từ Mig 39** (~5-6h em main solo recommend) — 3 entity (LeaveRequest + OtRequest + TravelRequest) + LeaveBalance business logic + workflow V2 enum +5/+6 reuse (Mig 37 đã extend). Cookie-cutter mirror Proposal G-O3 pattern. **FALLBACK Implementer Case 2 ×3 spawn parallel** nếu API stable + tight brief ≤ 5K
-2. **CICD post-deploy verify Run + bundle rotate**
-
-**Defer recommendations S38+:**
-- Curate 4 MEMORY (Investigator 29.6KB borderline post-S37) ~10 phút em main proxy
-- Test bundle G-O3 (~30 phút) — ApproveV2 + CodeGen + workflow guard
-- Phase 9 Ops anh main coordinate (SMTP + Rotate creds + UAT)
-
-**Last updated S36 (prev):** 2026-05-28 (Session 36 — **🎯 S36 Plan G-O2 Phòng họp ALL DONE end-to-end deploy prod BE+FE combo 1 commit**)
-
-**S36 (2026-05-28):** Anh main chốt **Full batch 6 plan** ~25-31h spread 6 session (G-O2 + G-O3 + G-O4 + G-O5 + G-O6 + G-H3). S36 kick off Plan G-O2 standalone độc lập NOT depend workflow V2 enum extend. Cumulative end-to-end **1 commit** push remote `8afdc1e..f45090b` + **CI Run #359 PASS 3m55s**.
-
-**Commit S36 (1 push):**
-1. `f45090b` BE Mig 36 + CQRS 584 LOC + FE 2 app 1770 LOC combo deploy (Run #359 PASS 3m55s)
-
-**Multi-agent ROI S36 ~225K total:**
-- 🟦 Investigator 2 spawn ~22K (startup + G-O2 pre-flight: clean-room verdict + FullCalendar v6 alternative)
-- 🟨 Implementer 2 spawn ~67K (BE CQRS + FE 2 app — gotcha #53 4th truncation BE diagnose only, FE clean)
-- 🟥 Reviewer 2 spawn ~110K (startup + G-O2 review Smart Friend 9× cumulative CLEAN 3 minor defer)
-- 🟩 CICD 2 spawn ~25K (startup + Run #359 verify ALL PASS)
-- 👤 Em main solo ~50K (curate 2 MEMORY + Mig 36 schema + Application.csproj +Relational + commit/push + docs wrap)
-
-**Smart Friend 0 critical catch S36 (9× cumulative clean):**
-- BE Schema design correct first try (FK strategy + UNIQUE composite + index Room/StartAt range query)
-- BE Validator MaxLength match EF config (Pattern 12-bis 10× cumulative — S35 lesson learned)
-- BE SeedMeetingRoomsAsync NOT gated DemoSeed (gotcha #51 compliance)
-- BE Owner-OR-admin authorization Update/Cancel (no gotcha #44 pattern)
-- BE SERIALIZABLE transaction + exclude self overlap (Cat 3 PASS minor caveat Room race defer)
-- FE Layout staticMap 3 entry mirror Pattern 16-bis 7× (gotcha #50 prevention)
-- FE SHA256 IDENTICAL × 2 app 3 file pair verified
-
-**NEW capability prod S36 (end-to-end UAT-ready):**
-- (a) Sidebar Văn phòng số > Phòng họp `/meeting-calendar` shows 7-day grid 8h-20h slot + click slot → Dialog create booking (Phòng dropdown 4 sample + Attendees multi-select + Title/Description/Note + Auto overlap check 409 detect "Phòng đã được đặt trong khoảng thời gian này")
-- (b) Admin `/meeting-rooms` catalog CRUD table 4 sample room (PH-A Phòng họp lớn cap=20 + PH-B nhỏ cap=8 + PHG-501 Giám đốc cap=6 + ONL-1 Online Zoom cap=50)
-
-**Bundle hash rotation S36 (1 push):**
-- fe-admin: `Bl6e54yi` (S35) → `C9kzTTmq` (Run #359)
-- fe-user: `DHmW2tUF` (S35) → `CC4DQ-Tr` (Run #359)
-
-**State chốt S36:**
-- 36 mig (+1 Mig 36) · 74 tables (+3 MeetingRoom+Booking+Attendees) · ~201 endpoints (+9 Meeting)
-- 45 FE pages (+2 × 2 app) · 73 menu keys (+4 Off_PhongHop+leaf)
-- **130 test PASS unchanged** (UAT mode, test bundle defer ~30 phút Implementer Case 3)
-- **53 gotcha unchanged** (#53 4th occurrence noted commit only)
-- 27 memory user-level · 6 skills · 4 sub-agents (post-curate Implementer 31.7KB + CICD 28.3KB acceptable)
-
-**4 sub-agent reuse-able S37 via fresh spawn (agentId S36 invalid post-session-end):**
-- 🟦 Investigator last spawn `a7bbd88513157f3a6` (S36 G-O2 pre-flight)
-- 🟨 Implementer last spawn `aabfc002a99339ab8` (S36 FE 2 app — 0 truncation tight brief WORK)
-- 🟥 Reviewer last spawn `a579fa4856eb45316` (S36 G-O2 Smart Friend 9× clean)
-- 🟩 CICD last spawn `a915996c2b0c24698` (S36 Run #359 PASS)
-
-**⚠️ Next session S37 — sequence em chốt Full batch S36→S42 cumulative:**
-1. **Plan 10.3 Pre-flight Mig 37 enum extend** (~1h em main solo) — extend `ApprovalWorkflowApplicableType` enum +5 values (ProposalGeneral=4 / LeaveRequest=5 / OtRequest=6 / VehicleBooking=7 / ItTicket=8) cookie-cutter Mig 22 pattern. UNBLOCK G-O3-O6 Workflow Apps.
-2. **Plan G-O3 Đề xuất Mig 38** (~4-5h Implementer Case 2 mirror PE Plan B pattern 12-bis cross-module entity scaffold + ApproveV2Async branch + CodeGen `DX/YYYY/NNN` business logic tight em main solo)
-3. **Reviewer Smart Friend pre-commit Cat 1-6 + CICD post-deploy Run verify**
-
-**Defer recommendations S37+:**
-- Test bundle G-O2 (~30 phút Implementer Case 3) — Code uniqueness + overlap check 409 + Cancel preserve history + AttendeeInput owner-only update
-- 3 minor defer Reviewer (AttendeeInput.Notes validator MaxLength + Room IsActive race window + silent skip unknown UserId)
-- Phase 9 Ops anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần) — still blocked
-
-**Last updated S35 (prev):** 2026-05-28 (Session 35 — **🎯 S35 3 chunk push ALL DONE deploy prod: FE inline forms 5 satellite + G-H2 BE CRUD 16 endpoint + G-H2 FE Admin HrmConfigsPage declarative**)
-
-**S35 (2026-05-28):** Anh main authorize Option A "FE forms + G-H2 BE+FE combo" sequence + "warm-up Implementer + CICD". Cumulative end-to-end **3 commit** pushed remote `63dd9ec..021674a` + **3 CI Run ALL PASS** (#242 + #243 + #244).
-
-**Commits S35 (3 push):**
-1. `c3cd343` Chunk 1 — FE inline forms 5 satellite × 2 app (+1758 LOC, Run #242 PASS 3m30s)
-2. `909655c` Chunk 2 — G-H2 BE CRUD HrmConfig 16 endpoint (+576 LOC NEW, Run #243 PASS 3m43s)
-3. `021674a` Chunk 3 — G-H2 FE Admin HrmConfigsPage declarative (+1388 LOC, Run #244 PASS 3m38s em main fallback verify)
-
-**Multi-agent ROI S35 ~250K:**
-- 🟨 Implementer 3 spawn ~80K (3 cookie-cutter chunk + Smart Friend × 3 catch S35)
-- 🟦 Investigator 1 spawn ~8K (Plan G-H2 BE CRUD pre-flight: NamGroup MISS verdict — SOL clean-room mạnh hơn)
-- 🟥 Reviewer 3 spawn ~60K (Smart Friend 9× cumulative clean: 2 truncated mid-MEMORY-update, 1 tight brief PASS clean)
-- 🟩 CICD 4 spawn ~70K (Run #241 warm-up + #242 + #243 PASS + #244 stalled em main fallback)
-
-**Smart Friend Implementer 3 catch S35 (Pattern preserved):**
-1. Chunk 2 MaxLength validator vs EF config mismatch → aligned to EF source-of-truth (LeaveType/OtPolicy Code=50, Name=200, Description=500)
-2. Chunk 2 HRM entities NO HasQueryFilter (vs Master 9 file have) → explicit `.Where(!IsDeleted)` 8 List/Conflict-check site
-3. Chunk 3 em main spec line 24 GAP: Layout staticMap "no resolve issue" — WRONG. Implementer verified `MenuItem.cs` NO Url field + `resolvePath()` regex chỉ match `Ct_*/Wf_*/Pe_*/PeWf_*/AwV2_*` → silent sidebar drop gotcha #50. Enforced staticMap mirror Pattern 16-bis 6× cumulative
-
-**NEW capability prod S35 (end-to-end UAT-ready):**
-- (a) Admin login `eoffice.solutions.com.vn/employees` → pick NV/2026/0007 → Section 2-6 (Công tác/Đào tạo/Thân nhân/Kỹ năng/Hồ sơ) inline `+ Thêm` button expand AddForm + per-row Pencil/Trash. 15 BE endpoint wire CRUD live.
-- (b) Admin login `eoffice.solutions.com.vn/hrm/configs/leave-types` → 4 sub-tab + table 5 row LeaveType seed + Dialog modal CRUD `+ Thêm`. Switch tab → /hrm/configs/holidays (10 row) → /shifts (3 row) → /ot-policies (1 row). 16 BE endpoint wire CRUD live.
-
-**NEW gotcha #53 sub-agent truncation/stall pattern S35 × 3 occurrence:**
-- Reviewer FE forms (push #1) cut mid-Cat-1 after "PERFECT"
-- Reviewer BE CRUD (push #2) cut mid-MEMORY trim
-- CICD Run #244 verify (push #3) stalled 600s watchdog after VPS mtime cross-check
-- Mitigation verified: tight brief ≤ 8K (Reviewer FE Admin chunk 3 PASS clean no truncation 5K return)
-- Em main grep verify manual Cat 2-6 + commit confidence preserved
-
-**State chốt S35:**
-- 35 mig unchanged · 71 tables unchanged · ~185 endpoints (+16 HRM Configs)
-- 43 FE pages (+1 HrmConfigsPage) · 69 menu keys unchanged
-- **130 test PASS unchanged** (UAT mode no test add 3 chunk)
-- **53 gotcha (+1 #53)** · 27 memory user-level · 6 skills · 4 sub-agents
-
-**Bundle hash rotation S35 cumulative:**
-- fe-admin: `RNTX6Fvo` (Run #241 start) → `BhR0MmLN` (Run #242) → `BhR0MmLN` (Run #243 BE unchanged) → `Bl6e54yi` (Run #244)
-- fe-user: `29A1LuMm` → `DIdNaB6W` → `DIdNaB6W` → `DHmW2tUF`
-
-**4 sub-agent reuse-able S36 via fresh spawn (agentId S35 invalid post-session-end):**
-- 🟦 Investigator last spawn `a42bd882c367f6e47` (S35 G-H2 BE CRUD audit)
-- 🟨 Implementer last spawn `a1aeda2fcbbc19eeb` (S35 G-H2 FE Admin)
-- 🟥 Reviewer last spawn `a6b42cc3c1423e699` (S35 G-H2 FE Admin tight 5K PASS)
-- 🟩 CICD last spawn `a3dfb05e2deee8f0f` (S35 Run #244 stalled mid-MEMORY)
-
-**⚠️ Next session S36 — anh main pick:**
-1. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — FullCalendar lib NEW dep) — standalone tiếp Phase 10.2 Office
-2. **Phase 10.3 G-O3-O6 Workflow Apps** (4 plan đề xuất nghỉ phép/đăng ký OT/đăng ký công tác/dự án — depends G-H2 catalog ready)
-3. **Phase 9 Ops** anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
-4. **Curate 4 MEMORY post-S35 spawn** (Reviewer + CICD borderline) ~20 phút em main proxy
-5. **Test bundle G-H2 BE CRUD** (~30 phút Implementer Case 3 — codeGen UNIQUE Conflict + composite Year+Date + soft delete restore)
-6. **Audit cron 2026-06-01** (còn 4 ngày — cumulative skill + doc drift mig 33→35, test 111→130, gotcha 52→53)
-
-**Recommend sequence S36:**
-1. Curate 4 MEMORY (~20 phút) — clear context before heavy work S36
-2. Plan G-O2 Phòng họp BookingCalendar (~3-4h) — standalone independent
-3. Plan G-O3-O6 Workflow Apps batch (~6-8h) — series workflow app reuse V2
-
-**Last updated S34 FULL (prev):** 2026-05-27 (Session 34 FULL — **🎯 Plan 1+2+3+4 ALL DONE: Curate + G-O1 Danh bạ + Phase 1.5 batch 6/6 + G-H2 Mig 35 schema foundation. BE CRUD + FE forms HrmConfig defer S35**)
-
-**S34 FULL (2026-05-27):** Anh main authorize "1 → 2 → 3 → 4" sequence sau S34 init + "OK làm tiếp đi nhé" tiếp Plan 4. Cumulative end-to-end **6 commit** pushed remote `edba4ae..07b3f3b` + 4 CI Run (#238/#239/#240 PASS + #241 Plan 4 Mig 35 pending verify).
-
-**Commits S34 (6 push):**
-1. `7b0781b` Plan 1 Curate 4 MEMORY (-15% docs CI skip)
-2. `ea440da` Plan 2 G-O1 BE+FE Danh bạ (Run #238 PASS)
-3. `61e9ce5` Plan 3 Phase 1.5 batch 4 item (Run #239 PASS — +10 [Fact] 130 PASS)
-4. `57099c5` Docs S34 batch 1+2+3 wrap (docs CI skip)
-5. `e506cd8` Plan 3 Item 3 BE 5 satellite CRUD scaffold (Run #240 PASS — +15 endpoint)
-6. `07b3f3b` Plan 4 G-H2 Mig 35 + 4 entity + 4 EF Config + seed 19 row + 4 menu (Run #241 verify pending)
-
-**Multi-agent ROI S34 ~150K:**
-- 🟨 Implementer 3 spawn ~80K (Plan 2 FE 2 app + Plan 3 Item 4 test bundle + Plan 3 Item 3 BE 5 satellite Case 2)
-- 🟩 CICD 2 spawn ~40K (Run #238 full verify + Run #239 partial)
-- 👤 em main solo ~30K (BE Plan 2 + Phase 1.5 items 6+2+1+5 + Plan 4 Mig 35 + commit/push 6 batch + UAT smoke + docs wrap)
-- 🟦 Investigator + 🟥 Reviewer: 0 spawn S34
-
-**Plan 4 G-H2 Mig 35 schema deployed (BE CRUD + FE forms defer S35):**
-- 4 entity HRM catalog: LeaveType + Holiday + ShiftPattern + OtPolicy
-- 4 EF Config với UNIQUE indexes (Code unique cho 3 + Year+Date composite cho Holiday)
-- DbInitializer `SeedHrmConfigsAsync` 19 sample row seed (5 LeaveType + 10 Holiday VN 2026 + 3 Shift + 1 OtPolicy STANDARD)
-- MenuKeys `HrmConfig` sub-group + 4 leaf seeded (LeaveTypes/Holidays/Shifts/OtPolicies)
-- FE 2 app menuKeys sync 5 const mirror
-
-**⚠️ Next session S35 — anh main pick:**
-1. **Plan G-H2 Task 3+4 BE CRUD 4 catalog + FE Admin 4 page** (~3-4h Implementer Case 2 cookie-cutter cookie-cutter mirror EmployeeSatelliteFeatures + SOL Catalogs pattern Plan CA Chunk B)
-2. **FE inline forms 5 satellite section** (~1.5h em main solo — Phase 1.5 Item 3 FE remainder)
-3. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — FullCalendar lib new dep)
-4. **Test bundle satellite CRUD** (~30 phút Implementer Case 3 — test endpoint Create UNIQUE + Update partial + soft delete)
-5. **Curate 4 MEMORY again** (CICD + Implementer borderline post-S34 spawn entries)
-6. **Anh main coordinate Phase 9 Ops** (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
-
-**4 sub-agent reuse-able S35:**
-- 🟦 Investigator `afaf6d52a6a59a844` (idle S34)
-- 🟨 Implementer `a5b7154286dad03f5` (last spawn Plan 3 Item 3 BE 5 satellite — NEW agentId S34)
-- 🟥 Reviewer `a0aa13093d14f3bca` (idle S34, no spawn S34)
-- 🟩 CICD `a520665a07ea4e8c4` (last spawn Plan 3 partial)
-
-**Last updated S34 batch 1+2+3 (initial wrap):** 2026-05-27 (Session 34 — **🎯 Plan 1 Curate + Plan 2 G-O1 Danh bạ + Plan 3 Phase 1.5 batch (5/6) deploy prod end-to-end. Plan 4 G-H2 + Item 3 Satellite defer S35**)
-
-**S34 (2026-05-27):** Anh main authorize "1 → 2 → 3 → 4" sequence sau S34 init 10 mục report. Cumulative end-to-end 3 commit pushed remote `edba4ae..61e9ce5` + 2 CI Run PASS (#238 G-O1 3m30s + #239 Phase 1.5 3m48s).
-
-**Multi-agent ROI S34 ~95K:**
-- 🟨 Implementer 2 spawn ~50K (G-O1 FE 2 app cookie-cutter mirror SHA256 IDENTICAL × 2 + Phase 1.5 Item 4 test bundle Case 3 +10 [Fact])
-- 🟩 CICD 2 spawn ~40K (Run #238 Plan 2 G-O1 full verify + Run #239 Plan 3 batch partial → em main fallback manual smoke)
-- Em main solo ~5K direct UAT smoke admin vs nv.test gotcha #44 verify
-- 🟦 Investigator + 🟥 Reviewer: 0 spawn S34 (chưa cần — Implementer Case 2+3 + em main solo đủ)
-
-**Plan 1 Curate 4 MEMORY** (~30 phút em main proxy):
-- CICD: 32.9KB → 27.3KB → 30.9KB post-Run #238 entry (curate again next session)
-- Implementer: 30.5KB → 24.6KB → 28KB post-Plan 3 entry
-- Investigator: 26KB → 21.8KB ✅
-- Reviewer: 28.5KB → 25.7KB ✅
-- 4 archive q3.md mới (Reviewer q2.md vì lần đầu có q2)
-
-**Plan 2 G-O1 Danh bạ nội bộ (~1.5h) — NEW capability prod:**
-- `GET /api/directory` LEFT JOIN Users + EmployeeProfiles + Departments
-- Sidebar Văn phòng số > Danh bạ → /directory card grid 34 user
-- Avatar PALETTE 6 màu + filter dept dropdown + search name/email/phone/code
-- Email mailto + phone tel click-to-call + Ext: badge
-- `Off` + `OffDanhBa` MenuKeys Order=29 root + Order=1 leaf
-
-**Plan 3 Phase 1.5 batch 5/6 item:**
-- Item 6 menuKeys × 2 app FULL sync mirror BE 28 key cumulative ✅
-- Item 2 UpdateEmployeeProfileCommand 3 bool→bool? safe partial update ✅
-- Item 1 EmployeesController per-action policy Hrm_HoSo.{Read|Create|Update|Delete} ✅
-- Item 4 test bundle +10 [Fact] 120→130 PASS ✅
-- Item 5 UAT smoke nv.test 403 /api/employees (gotcha #44 ACTIVE) + 200 /api/directory ✅
-- ⏸️ Item 3 Satellite CRUD endpoints + FE forms (~2-3h heavy) — DEFER S35
-
-**Plan 4 G-H2 Cấu hình HRM** (~3-4h Mig 35) — **DEFER S35** (sequence cuối — em main reach realistic capacity)
-
-**4 sub-agent reuse-able next session via SendMessage:**
-- 🟦 Investigator `afaf6d52a6a59a844` (idle S34, last activity S33 t1 NamGroup audit)
-- 🟨 Implementer `ad60dcfc154bdbbc4` (NEW S34 test bundle spawn agentId, last activity Plan 3 Item 4)
-- 🟥 Reviewer `a0aa13093d14f3bca` (idle S34, last activity S33)
-- 🟩 CICD `a520665a07ea4e8c4` (NEW S34 Run #239 verify partial agentId — may continue via SendMessage)
-
-**⚠️ Next session S35 — anh main pick:**
-1. **Item 3 Satellite CRUD endpoints + FE forms** (~2-3h) — round out Phase 1.5 G-H1 Phase 1
-2. **Plan 4 G-H2 Cấu hình HRM** (~3-4h Mig 35 LeaveTypes + Holidays + ShiftPatterns + OtPolicy 4 catalog)
-3. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — depends FullCalendar lib new dep)
-4. **Curate 4 MEMORY again** (CICD 30.9KB + Implementer 28KB borderline post-S34 spawn entries)
-5. **Anh main coordinate Phase 9 Ops hard blockers** (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
-
-**Recommend sequence S35:**
-1. Item 3 Satellite CRUD (~2h) — close Phase 1.5 properly trước khi mở Cấu hình HRM
-2. Plan 4 G-H2 (~3h) — prerequisite cho G-O3-O6 Workflow Apps
-3. Curate 4 MEMORY (~15 phút mid-session) nếu over 25KB
-
-**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD + Plan C B-Wrap +9 tests + Drift patch**)
-
-**S33 (2026-05-26):** Anh main authorize "Plan cha B và Plan cha C" + "OK commit, push" + "Pending Plan B G-H1 Phase 2 làm đi nhé". Cumulative end-to-end 7 commit pushed remote `5400983..79a8343` + 2 CI Run PASS (#350 Phase 1 + #237 Phase 2). **Phase 10.1 G-H1 UNBLOCK 8/11 module sau** (G-H2/G-O1-O6/G-H3/G-P1 ready depend EmployeeProfile data).
-
-**Multi-agent ROI S33:**
-- 🟦 Investigator 2 spawn ~20K: S33 startup audit (MEMORY size + RAG verify 2/3 PASS) + Plan B Task 1 NamGroup TblNhanVien* 10 bảng audit (NOT 8 anh estimate) + field map 70 cols main + 5 satellite proposal
-- 🟨 Implementer 4 spawn ~110K Case 2 cookie-cutter: Plan B Task 3 BE entity 17 file + Task 4 BE CQRS 3 file + Task 5 FE 2 app 12 file SHA256 IDENTICAL + Plan C BW1-BW7 3 test file
-- 🟥 Reviewer 3 spawn ~60K Smart Friend 6× clean: S33 startup drift severity + Plan C BW pre-commit + Plan B Phase 2 pre-commit (0 critical/major, 3 minor defer Phase 1.5)
-- 🟩 CICD 3 spawn ~60K: S33 startup HEALTHY + Run #350 Phase 1 PASS 3m38s (Mig 34 + 33 EmployeeProfiles seeded + endpoint smoke + gotcha #51 verified) + Run #237 Phase 2 PASS 3m50s (5 NEW employee endpoint + Hrm menu seeded + bundle rotate × 2)
-
-**Em main solo S33:** Task 2 Mig 34 schema design (4 decision: 5 satellite/Skill polymorphic/DiaChi dual-write/MaNhanVien NV/YYYY/NNNN) + Task 3b DbInitializer SeedDemoEmployeeProfilesAsync ~90 LOC (NOT gated DemoSeed flag per gotcha #51) + Task 6 Permission menu MenuKeys+SeedMenuTreeAsync 2 edit + 3 commit batch + push.
-
-**NEW capability prod (UAT-ready):**
-- Sidebar menu "Nhân sự" > "Hồ sơ Nhân sự" mở /employees
-- 33 EmployeeProfile sample seeded `NV/2026/0001..0033` (1 admin + 30 demo + 2 catalog.manager)
-- Sample: `NV/2026/0007 BOD 1 - Director / Ban Giám đốc / Active / hireDate=2021-08-01`
-- CreatePage form Header minimal (UserId picker + status + birthday + gender + phone + hire date)
-- 6-section inline collapsible detail (Cơ bản/Công tác/Đào tạo/Thân nhân/Kỹ năng/Hồ sơ)
-- Phase 1 read-only satellite, edit Header defer Phase 1.5
-
-**Implementer truncation pattern observation 2/3 (NEW lesson S33):**
-- Task 3 + Task 4 heavy scaffold ~50+ tool uses → MEMORY update mid-sentence cutoff
-- Task 5 clean (smaller scaffold ~10 file under same budget)
-- Functional work complete despite truncation (em main verify via file existence + build + test post-spawn)
-- Mitigation cross-project: Implementer split heavy task ≥30 file → 2 phase (scaffold + MEMORY update separate budget reserve)
-- Em main proxy MEMORY append next session (Pattern 12-bis foundation S29 still in place, no critical knowledge loss)
-
-**4 MEMORY status post-S33 (CURATE priority next session):**
-- CICD: 32.9 KB OVER 25KB hard threshold (32.9-25=7.9 KB excess)
-- Implementer: 30.5 KB OVER
-- Reviewer: 28.5 KB borderline
-- Investigator: 26 KB borderline
-- Cumulative ~118 KB / 100 KB rolling budget
-- Recommend dedicated curate session next time (~30 phút Plan A3 mirror S32 pattern)
-
-**Defer Phase 1.5 backlog (per Reviewer 3 minor + CICD recommend):**
-1. Per-action policy `Hrm_HoSo_View/Create/Edit/Delete` wire (gotcha #44 mitigation)
-2. Convert 3 bool field UpdateCommand → `bool?` safe partial update
-3. Satellite CRUD endpoint (WorkHistory/Education/FamilyRelation/Skill/Document) + edit forms FE
-4. Test bundle Plan B Phase 2 (Create UNIQUE conflict + List filter + codeGen race)
-5. UAT smoke non-admin role verify silent 403 catch
-6. fe-admin menuKeys.ts add Bg_*/Catalog* sync với fe-user (drift not blocking)
-
-**⚠️ Next session S34 — anh main pick:**
-1. **Phase 1.5 backlog** (6 item above) — 1-2h dedicated session
-2. **Phase 10.1 G-H2** Cấu hình HRM (Mig 35 LeaveTypes + Holidays + ShiftPatterns + OtPolicy 4 catalog) ~3-4h
-3. **Phase 10.2 G-O1** Danh bạ nội bộ (reuse Users + EmployeeProfile + Departments, 1 endpoint + FE card grid) ~2-3h — easiest standalone, no workflow
-4. **Curate 4 MEMORY sub-agent** (~30 phút) trước khi heavy work khác — avoid context bloat
-5. **Update CLAUDE.md state numbers** drift S33 (mig 33→34, table 60→67, test 111→120) bundle batch 2026-06-01 audit cycle
-
-**Recommend sequence S34:**
-1. Curate 4 MEMORY (~30 phút) first — clear context for next plan
-2. G-O1 Danh bạ (~2h) standalone easy win
-3. G-H2 Cấu hình HRM (~4h) prerequisite cho G-O3-O6 workflow apps
-
-**S32 (2026-05-26):** Anh main yêu cầu plan kỹ NamGroup 11 module port → SOL (NHÂN SỰ 3 + VĂN PHÒNG SỐ 6 + CÁ NHÂN 1). 4 quyết định AskUserQuestion: FULL 11 module + single schema `dbo` Mig 34-42 + reuse Workflow V2 enum +5 values + chunk per-module Plan riêng. Document Phase 10 backlog detailed migration-todos.md với 10 Plan G-* atomic (G-H1 + G-H2 / G-O1 + G-O2 / G-O3-O6 / G-H3 + G-P1). Stats target Phase 10 end: 33→42 mig, 60→85 tables, 148→250 endpoints, 38→60 FE pages, 14→18 AppRoles, 60→110 permission menu, 111→200 tests.
-
-**Phase 9 stabilize batch done sequential anh main "finish hết":**
-- **Plan A2** ✅ RAG re-ingest 2949→2988 chunks (166 files, 75.7s). Gotcha #52 rerank 0.516→0.906 verify.
-- **Plan A3** ✅ MEMORY curate 3 agents OVER 25KB: Implementer 38.4→27.5KB (Patterns 1-19+12-bis+16-bis foundation preserved, 5 verbose S25-S29 archived q2) + Investigator 27.7→19KB (4 verbose S25-S26-S29 archived q2) + CICD 27→24.2KB (Run #231 PARTIAL detail archived q2). Reviewer 24.39KB unchanged (self-curated S32 startup earlier).
-- **Plan B-Wrap** ✅ Spec BW1-BW7 documented detailed migration-todos D-Bis section. Implementation **defer dedicated session ~2h** chốt anh main S32 (test infra IChangelogService + IContractCodeGenerator mocks first-time).
-- **Plan C1** ✅ Ops status update: backup-sql.ps1 ready (register Task Scheduler manual cmd documented). win-acme cert api.solutions.com.vn notAfter `2026-07-23` (not 2026-06-18 stale). SMTP + rotate creds BLOCKED chờ anh main coordinate.
-
-**4 commits S32 push remote (all docs-only CI skip per #41):**
-1. `b832f43` Phase 10 backlog Plan G + 4 sub-agent S32 startup MEMORY entries
-2. `cce0963` Phase 9 stabilize batch (Plan A3 curate + B-Wrap spec + C1 ops)
-3. + 2 earlier `f938bf5` (S31 docs patch) + `1e1c9a2` (S31 RAG baseline)
-
-**4 sub-agent reuse-able next session via SendMessage (if tool available):**
-- 🟦 Investigator `afaf6d52a6a59a844`
-- 🟨 Implementer `ab23cc322b5d495c0`
-- 🟥 Reviewer `a0aa13093d14f3bca`
-- 🟩 CICD Monitor `a505a02d84fc1fabe`
-
-**⚠️ Next session S33 — Phase 10.1 G-H1 Hồ sơ NS kick off:**
-1. Spawn Investigator pre-flight audit NamGroup `TblNhanVien*` 8 bảng (`D:\Dropbox\CONG_VIEC\NAMGROUP\SOURCECODE_CÔNG_TY\NAMGROUP\NAMGROUP.Server\Data\Entities\`) + map fields → SOL EmployeeProfile schema (~30 phút)
-2. Em main design Mig 34 `AddEmployeeProfiles` schema (1 main + 5 satellite: WorkHistory/Education/FamilyRelation/Skill/Document)
-3. Implementer Case 2 cookie-cutter BE entity scaffold 6 entity + EF Config + DbInitializer seed 30 demo profile mirror 30 users
-4. Implementer Case 2 mirror PE handler BE CQRS + 6 endpoint controller
-5. Implementer Case 2 cookie-cutter mirror PE FE 2 app EmployeesPage 3-panel + EmployeeDetailTabs (6 section)
-6. Em main solo Permission menu `Hrm_HoSo*` + Permission Matrix seed
-7. Reviewer pre-commit + CICD Monitor post-deploy verify
-
-**Anh main coordinate Phase 9 ops trong meantime:**
-- SMTP host/user/pass → appsettings.Production.json
-- Rotate creds plan approve cycle (admin + 30 demo + SA + vrapp + JWT secret + Gitea runner)
-- Register Task Scheduler SQL backup `ssh vietreport-vps "Register-ScheduledTask -TaskName SolutionErpBackupDaily ..."`
-- UAT 2-3 user 1 tuần
-
-**Last updated S31 (prev):** 2026-05-26 (Session 31 — **🎯 RAG v1.3 Baseline PASS + retrieval.py fix**)
-
-**S30 (2026-05-26):** Setup RAG Framework v1.3 governance + eval framework. Bootstrap 2949 chunks (164 files). Golden set v1.1 14 queries. Baseline v1.0=0.455 FAIL. v1.1 tentative=0.364 (MCP stale — vector broken). Commit b223466 (docs-only, CI skip).
-
-**S31 (2026-05-26):** Diagnose vector search broken: qdrant-client 1.18 removed search() → AttributeError silently swallowed. Fix retrieval.py: search()→query_points().points. Re-run eval: **recall@5=1.000 (11/11) PASS** avg_rerank=0.847. Quality gate PASS. Gotcha #52 added. STATUS/HANDOFF updated.
-
-**⚠️ S31 CRITICAL caveat (resolved S32):** CLI restart required — retrieval.py fix in AI_INFRA source but MCP server still loaded old code. ✅ S32 confirmed live (RAG query rerank 0.906 verify gotcha #52 hit post-CLI-restart + S32 re-ingest 2988 chunks).
-
-**Last updated S29 (prev):** 2026-05-22 (Session 29 **FINAL wrap** — **🎯 2 big plans END-TO-END deployed prod: Plan CA + Plan B Contract V2**). 20 commits cumulative S29 push 4 CI Runs PASS (#229+#230 Plan CA + #231+#232 Plan B). **Plan CA Move "Cấu hình danh mục dùng chung" admin → eoffice**: 9 menu (Master + 4 leaf + Catalogs + 4 sub-catalogs) move + role mới `CatalogManager` + demo user `catalog.manager@solutions.com.vn / CatalogMgr@2026`. 5 chunks A+B+C+D+D2 + Hotfix 1 (resolvePath staticMap silent sidebar drop — anh UAT screenshot catch). **Plan B Contract V2 wire mirror PE Mig 22-26**: COEXIST V1+V2 (7 V1 contract giữ behavior). 9 chunks A1+A2+B+C+B2+E1+D+E2+E3 + Hotfix Reviewer (ApplicableType=Contract guard MAJOR security catch) + Hotfix CICD (SeedSampleContractWorkflowV2 OUT of DemoSeed gate — V2 path BLOCKED prod nếu gated — **gotcha #51 NEW INFRASTRUCTURE vs DEMO seed**). Mig 32+33 prod applied. Sample `QT-HD-V2-001` seeded post Hotfix CICD. fe-admin/fe-user bundle 4× rotate cumulative S29. **Multi-agent ROI S29 ~565K total**: Investigator 2 spawn ~40K + Implementer Case 2 5 spawn ~82K (1 stopped mid-task E3) + Reviewer 4 spawn ~355K (Smart Friend MAJOR catch 2 lần) + CICD Monitor 3 spawn ~90K (2 fail 529 transient em main fallback manual + 1 CRITICAL catch). Em main solo ~150K coordinate + Chunk B/B2 cross-stack + E3 finish + 2 hotfix re-edit. **Smart Friend pattern proven 4× cumulative S22 #44 + S25 #48 + S29 Reviewer #ApplicableType + S29 CICD #DemoSeed**. **MCP RAG tools added 4 agent definitions** (commit `b51fc94`) — search_memory + cross_project_search — anh restart CLI hot-reload S30+. **Test gate:** 111/111 PASS preserved (UAT mode skip per chunk, V2 ApproveV2Async 150 LOC NO test cover — defer test bundle Plan B Wrap session). **8 patterns NEW saved S29** (xem STATUS.md). **NEW capability prod end-to-end:** (1) Anh login Drafter fe-user → `/contracts/new?type=1` → Workspace dropdown pick `QT-HD-V2-001` → submit ChoDuyet → CCM `binh.le` approve → Service ApproveV2Async UPSERT opinion + advance → terminal gen mã HĐ + Phase=DaPhatHanh (mirror PE V2 flow). (2) Anh login `catalog.manager@solutions.com.vn / CatalogMgr@2026` → fe-user sidebar Master + 4 leaf + Catalogs + 4 sub-catalogs CRUD full. **Pending S30+**: anh UAT verify end-to-end V2 contract flow + restart CLI MCP RAG load + curate 4 MEMORY (Investigator 25.2KB + Implementer 35.4KB + Reviewer ~22KB + CICD 24.9KB — Implementer over hard threshold, dedicate curate session) + test bundle Plan B (regression test ApproveV2Async + ApplicableType validation). **Stats final S29:** 33 mig (+2) · 60 tables (+1) · ~148 endpoints (+1) · 38 FE pages · 111 test · 51 gotcha (+1 #51) · 25 memory · 6 skills · 4 sub-agents · 14 AppRoles (+1) · 34 active prod users (+1) · 7 V1 contracts + V2 ready · 4× bundle rotate.)
-
-**Last updated S28 prev:** 2026-05-22 (Session 28 **FINAL wrap** — **🎯 S28 cumulative t1→t6 + Layer A governance apply + 4 sub-agent flush MEMORY DONE**. Bro broadcast Layer A governance active 2026-05-22 (3-Layer distributed: A project-local active / B shared_global defer / C infrastructure anh pqhuy). **Quên rule cũ "mọi tương tác PHẢI store_memory" — ABANDONED** (em main S28 t2 over-reach self-authorize cross-project rule → caught S28 t4 → scope-down về SOLUTION_ERP self-discipline). Em main apply Layer A policy local: **4-category default** (decision/lesson/pattern-proven-≥2×/session-wrap) + skip list nguyên + 5 SOLUTION_ERP-specific adjustment + tag schema mandatory `[type, phase, bc-or-module]` + phase enum 11 (current phase-9 UAT) + BC/module 8 domain + 5 cross-cutting + optional prefix 8 + source_path convention `solution_erp/<area>/<topic>-<date>` + eval ritual weekly Friday 5 metric từ 2026-05-29 → end-trial 2026-06-05 + 10 golden query draft. **4 sub-agent flush MEMORY DONE post-S27 model:inherit fix** — Investigator (aeda4 alive) + Implementer (a2a2f spawn) + Reviewer (a9e94 spawn) + CICD Monitor (a8098 spawn) — registry hot-reload verified, Recent activity entry S28 wrap góc nhìn từng con preserved cumulative S1-S27 narrative untouched. **6 chunk stored RAG S28 t2-t6** with tags schema mandatory format. **+1 memory user-level `feedback_interaction_logging_rag.md` SCOPE-DOWN S28 t4** (lesson authority boundary + implicit consent risk). **Hit rate verify 3 query**: Plan B Contract V2 rerank 0.84 ✓ + gotcha #48 rerank 0.84/0.82 ✓ + per-NV 10-surface checklist ✓ — cumulative > 0.7 threshold pass. **State chốt S28:** 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **25 memory user-level (+1)** · 6 skills · 4 sub-agents verified · **3,462 RAG chunks SOLUTION_ERP** (+6 chunk S28). **0 commit remote S28** (all local docs + memory + RAG store — anh chốt push thủ công). Plan B Contract V2 wire kick-off PRIORITY HIGH S29+ — 8-chunk pre-allocated 🟦 Investigator pre-flight audit + 🟨 Implementer Case 2 mirror PE V2 (4 chunk) + 👤 Chủ trì Solo Service ApproveV2Async + 🟥 Reviewer pre-commit Smart Friend + 🟩 CICD Monitor post-deploy Run verify. Plan AI Phase 5 distributed bootstrap 4 project khác (NamGroup/DH/Ashico/Vipix) đã DONE — total 18,532 chunks indexed cross 5 project. VIPIX hosting governance docs `D:\Dropbox\CONG_VIEC\VIPIX_MULTISITE_PROJECT\docs\governance\RAG-LAYER-A-PROJECT-LOCAL.md` v1.1 (em đọc + apply scope SOLUTION_ERP). 2-week trial monitoring 2026-05-22 → 2026-06-05 weekly Friday eval — Friday 2026-05-29 first checkpoint.)
-
-**Last updated S28 t1 initial:** 2026-05-22 (Session 28 turn 1 — **🎯 S28 startup 9-step + RAG ROI reality check em main verdict + cross-agent perspective update**. Anh restart Claude Code CLI sau S27 wrap → **sub-agent registry hot-reload OK** verified qua smoke test spawn Investigator (agentId `a2462ca503ed38b0b`, 16.3 KB MEMORY loaded, 3 skills attached: contract-workflow + permission-matrix + ef-core-migration, model `inherit` 1M Opus parent). RAG status verified: **3,460 chunks SOLUTION_ERP indexed** (cao hơn S26 wrap 2,628 — re-index ngầm) + 6 MCP tools (`mcp__rag-unified__*`) loaded, Qdrant NSSM Service Running PID 4476. **Bro hỏi "cảm nhận rõ lợi ích RAG ko?"** → em main verdict thẳng thắn (anti-suger-coat): **CÓ LỢI marginal short-term (5-10% time saving), TRANSFORM long-term cross-project (chưa khai phá vì 4 em main project khác chưa bootstrap).** 3 case WIN rõ S28 start: (1) Carry over Plan B Contract V2 state — query `Plan B mirror PE pattern` → rerank **0.84** instant 5 hits (saved ~8 phút vs đọc 3-4 session log); (2) Coverage gap detection — query `subagent setup pitfalls` → **0 hits** → phát hiện S27 NEW content chưa index, re-bootstrap pending pydantic fix; (3) Cross-project pattern verify — `cross_project_search` tool sẵn sàng (chưa dùng vì 4 dự án khác chưa bootstrap). **Reality check — RAG KHÔNG thay được blanket auto-load:** STATUS.md (40K) + HANDOFF.md (30K, đỉnh 88K full) + 4 MEMORY 200 lines/spawn (~25K) + CLAUDE.md (~10K) = ~150-200K blanket KHÔNG cắt được, RAG chỉ supplement khi cần truy cập historical specific. **3 nhược điểm cảm nhận thật:** (a) Bootstrap lag — S27 NEW content (4 file `feedback_subagent_setup_pitfalls + skill-audit-late + 4 MEMORY post-curate + rag-onboarding-guide`) chưa index sau 1 ngày; (b) Effective coverage gap — Plan B query rerank 0.84 excellent vs S27 content 0 hit miss; (c) Token cost rerank-2.5 ~$0.05/1K query. **4 case verdict — RAG worth it?** Solo project blanket đủ ⚠️ Marginal (5-10% saving) | Cross-session retrieve specific historical ✅ Tốt (1 query vs 10 phút find) | Cross-project pattern reuse 5 dự án 🚀 **TRANSFORM** (chưa dùng được vì 4 dự án khác chưa bootstrap) | Heavy refactor Plan B Contract V2 wire ✅ Tốt (instant Mig 22-26 pattern lookup). **Bottom line:** RAG hiện tại đáng giữ cho infrastructure đã đầu tư S26-S27 (60.9s bootstrap + NSSM Service auto-start + Custom Dashboard 7 panel), **nhưng nếu redo từ đầu** sẽ recommend bro **đợi bootstrap 5 dự án rồi mới claim "RAG transform"** — solo project chỉ saving marginal. **Pattern reusable cross-project — RAG ROI evaluation framework:** 1 dev solo + 1 project < 1M tokens → ❌ Skip RAG (blanket sufficient) · 1 dev solo + 1 project > 1M tokens → ⚠️ Marginal (5-10% saving) · 1 dev solo + N project > 5M tokens → ✅ Worth it (cross-project transform) · N dev team + 1 project → ✅ Worth it (shared knowledge) · N dev team + N project enterprise → ✅ Mandatory (Sourcegraph-tier scale). Avoid over-hype RAG cho solo 1 project. **Update multi-layer 6 file:** memory user-level `feedback_rag_hybrid_pattern.md` append §S28 t1 ROI reality check (~120 LOC NEW section) + 4 agent MEMORY Recent activity entry góc nhìn từng con (🟦 Investigator: pre-flight audit cross-session retrieve Plan B-class · 🟨 Implementer: Pattern proven retrieve cumulative 19 Pattern foundation · 🟥 Reviewer: gotcha historical context cross-ref #44+#48+#49 · 🟩 CICD Monitor: Run history cross-reference #186-#222 cumulative + 10-surface-point per-NV checklist promoted foundation) + STATUS.md + HANDOFF.md headers. **Bro sẽ cross-check** 4 agent có hiểu consistent context + verdict mới không (next test: spawn 4 agent với same prompt "cảm nhận RAG ROI sau S27?" + compare consistency). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **24 memory user-level (no new entry, only append §S28 t1 to existing feedback_rag_hybrid_pattern)** · 6 skills · 4 sub-agents (registry hot-reload verified post-S27 fix) · 3,460 RAG chunks + 6 MCP tools active. **0 commit remote S28 t1** (all docs + memory update + retrospective opinion — anh chốt push thủ công sau approve).)
-
-**Last updated S27:** 2026-05-22 (Session 27 **chốt cuối** — **🎯 Memory Curate + RAG Manual Control + Multi-agent Setup Pitfalls Fix**. **Trigger:** Anh share VIPIX `docs/guides/multi-agent-pitfalls.md` (lesson VIPIX 2026-05-22 em main solo cả buổi vì agents KHÔNG load) → em audit SOLUTION_ERP setup phát hiện **CHÍNH XÁC CÙNG PATTERN broken**: 4 file `.claude/agents/*.md` dùng `model: claude-opus-4-7` (200K silent fallback) + non-standard `effort: max` field → registry chưa load cả session S27. Em main solo 8 task vì KHÔNG có lựa chọn delegate (2/8 lẽ ra Implementer Case 1+2: A3.1 5 PS scripts cookie-cutter + F2 4 file mechanical fix). **Fix applied:** 4 file `model: inherit` + remove `effort: max`. **Pending:** Anh restart Claude Code CLI để hot-reload (pitfall #1 - no hot-reload session đang chạy). **Memory user-level NEW:** `feedback_subagent_setup_pitfalls.md` 235 lines cross-project pitfall checklist (VIPIX + SOLUTION_ERP evidence). **Plan A.3 RAG Manual Control + Upgrade Option 4b NSSM:** 7 PS scripts `D:\.claude-rag\scripts\` (start/stop/status/dashboard/boot/install-service/fix-service-start ASCII-only) + 6 `$PROFILE` aliases + Startup folder shortcut `rag-boot.lnk` open Dashboard sau login + Custom MCP Dashboard HTML `dashboard.html` 19 KB 7 panels with SNAPSHOT warning banner (was 13.3 KB pre-NSSM). **S27 post-wrap upgrade Option 4a → Option 4b NSSM Windows Service** (anh phản biện "Qdrant nên auto-start như PostgreSQL/SQL Server"): Download NSSM 2.24 ~351 KB (retry 1× sau 503 transient) → `install-service.ps1` elevated register service Qdrant + AppDirectory + log paths + rotation 10MB + Start SERVICE_AUTO_START + AppExit Default Restart 3s delay + DisplayName "Qdrant Vector DB (RAG Unified)". **Bug WAL lock conflict** khi pre-existing manual qdrant.exe held WAL → service Paused → `fix-service-start.ps1` elevated recovery (Stop-Service Force + kill orphan qdrant.exe + Start-Service + verify). Service Running PID 4476 RAM 101.8 MB confirmed. Auto-start boot-time trước login + auto-restart on crash + survive logout. 4 PS scripts updated to Service cmdlet (Start-Service/Stop-Service/Get-Service). Dashboard removed meta refresh + add prominent SNAPSHOT warning banner + Service status panel. **Plan A.4 RAG Onboarding Guide:** `docs/guides/rag-onboarding-guide.md` **42.5 KB / 682 lines / 14 sections + §A2 + §A3 NEW** (post-NSSM upgrade S27). 13 sections base + §12 upgraded Option 4b NSSM với install/fix scripts + §A2 cấu trúc chuẩn em main pioneer + **§A3 Context loading Hybrid pattern (~242 lines NEW post-wrap)** — 8 sub-sections covering: Cách A defensive vs B aggressive decision gate / Layer 1 blanket auto-load checklist 200-280KB / Layer 2 RAG retrieve decision tree 7-branch / Token budget 5 utilization zones 1M Opus / 6 MCP tools examples Vietnamese+English / em main daily workflow morning+EOS+monthly / 7 anti-patterns cross-project / context monitoring + end session protocol. Cho 4 em main project khác self-onboard + apply workflow optimization từ session 1. **Plan F1 Qdrant Web UI fix:** UAT bro catch `localhost:6333/dashboard` 404 → root cause Qdrant Windows binary zip không bundle Web UI static, log warn `Static content folder for Web UI './static' does not exist`. Em pioneer S26 chỉ download `qdrant-x86_64-pc-windows-msvc.zip` 28.3 MB binary, miss `dist-qdrant.zip` 6.59 MB v0.2.12 separate. **Fix:** Download + extract `D:\.claude-rag\qdrant-bin\static\` + flatten dist subfolder + restart → HTTP 200 "UI | Qdrant" ✓. **Memory Curate 4 MEMORY -60%:** cicd-monitor 72.4→15.8 KB (-78%) + implementer 38.8→22.0 KB + investigator 34.9→16.3 KB + reviewer 34.5→17.9 KB. Total 180.6→72.0 KB. Archive 115 KB preserved verbose entries (rule §6.5 compliance). 4 archive files: `archive/2026-05-runs.md` + `archive/2026-05-q1.md` × 3 agent. 10-surface-point per-NV checklist promoted to cicd-monitor MEMORY foundation. Gotcha #48 SQLite tie-break promoted to cicd-monitor MEMORY foundation. **Audit drift sớm §6.4+§9.4** (trigger +8 gotcha vượt threshold): 5 file patched (4 `26 migration → 31` + 1 `41 bẫy → 49`) + audit log `docs/changelog/skill-audit-2026-05-late.md`. **State chốt S27:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT mode defer) · 49 gotcha (gotcha #48/#49 pending docs add) · **24 memory user-level (+1: feedback_subagent_setup_pitfalls)** · 6 skills · 4 sub-agents (fixed pending CLI restart) · +5 PS scripts · +1 custom Dashboard HTML · +2 docs files (onboarding + audit log late) · **0 commit remote S27** (all local + memory + docs - anh chốt push thủ công sau approve). **Patterns reusable cross-project S27:** (1) Multi-agent setup pitfall checklist cross-project, (2) PS scripts ASCII-only discipline + CSS-styled badges thay emoji, (3) Qdrant Windows 2-step setup (binary + Web UI static separate), (4) Custom Dashboard PS generator pattern, (5) Memory curate proxy pattern khi registry empty, (6) Audit log file separate khi drift sớm.)
-
-**Last updated S26 FINAL:** 2026-05-21 (Session 26 **FINAL wrap** — **🎯 Anh chốt 2 decisions architectural CUỐI sau commit `bf93abd`**: **(1) Approach B distributed RAG bootstrap** — em main SOLUTION_ERP chỉ build infrastructure + docs, KHÔNG bootstrap hộ project khác. 4 em main NamGroup/DH/Ashico/Vipix tự setup khi mở session project đó (Cognition boundary, sensitivity per project, self-ownership re-bootstrap). **(2) Option 4a manual PowerShell scripts** thay Task Scheduler auto-start — anh OWN control qua `rag-start`/`rag-stop`/`rag-status`/`rag-dashboard` aliases trong `$PROFILE` + Qdrant dashboard built-in FREE `http://localhost:6333/dashboard`. **Bug fix bootstrap.py glob `extra_corpus`** — `import glob.glob(recursive=True)` thay Path manual parsing (em main fix sau khi test query "feedback_rag_distributed_ownership" return 0 hit → user-level memory KHÔNG được scan đúng). Re-bootstrap với fix: **2,421 → 2,628 chunks** (+207 chunks user-level memory 23 file). Cache SHA256 hit perfect — 2nd bootstrap 6.5s vs initial 60.9s = **10× speedup**. **+1 memory user-level NEW** `feedback_rag_distributed_ownership.md` ~200 lines documenting 2 decisions + setup-once scale-distributed pattern reusable cross-project (RAG + MCP + future shared tools). **Rerank verify S26 content:** 5/6 query hit rerank 0.498-0.926 (em main project X build infra docs query hit BEST 0.926 — semantic search Anthropic Contextual Retrieval working PERFECT). **Pending S27+ updated:** Phase 5 SKIP em (distributed approach) · Phase 6 Option 4a 4 PowerShell scripts (start/stop/status/dashboard) + `$PROFILE` aliases (~30 phút em viết) · Phase 7 `rag-onboarding-guide.md` 13 section (11 outline cũ + §12 monitoring `rag-status` + §13 distributed Approach B explanation) (~40 phút em viết). 4 em main project khác tự setup ~10 phút mỗi project khi anh mở session.)
-
-**Last updated S26 initial wrap:** 2026-05-21 (Session 26 chốt cuối lần đầu — **🎯 Plan AG/AG2/AG3/AG4/AG5/AG6 cumulative 6 commits Plan AG series `0bf6c7e..d99069a` push remote + Plan AI RAG global MCP infrastructure setup**. **Trigger:** Bro UAT 2026-05-21 screenshot phàn nàn UI Duyệt NCC PE List "đám rừng" flat list + đề xuất Outlook-style folder tree theo dự án + dưới năm + NCC. 6 plan UI iteration cumulative: **Plan AG** Phase 1 PE List tree view 2-level Project > Gói thầu > PE (🟦 Investigator audit 5Q ~30K + 🟨 Implementer Case 2 cookie-cutter mirror 2 app ~16K commit `0bf6c7e` 2 file +346/-116 LOC SHA256 IDENTICAL + 🟥 Reviewer pre-commit ~25K PASS 0 blocker + 🟩 CICD Monitor Run #222 ~12K bundle hash 2 app rotate verified `C8TvDy7r→CWHIdoFo` admin + `BvcWrq2z→Bg2FNeIz` user). **Plan AG2** (`c5429c0`) simplify 1-level (drop tầng gói thầu per bro feedback "gói thầu thì ko cần thiết phải treedow") + widen Panel 1 340px → 400px. **Plan AG3** (`fbad4a9`) drop single-PE flat branch consistent UI (mọi dự án dù 1/N phiếu đều render `<details>`). **Plan AG4** (`2bf0118`) bổ sung Người tạo + Phòng ban tạo PE card — BE+FE cross-stack 8 file (DTO `PurchaseEvaluationListItemDto` +4 fields DrafterUserId/DrafterName/DepartmentId/DepartmentName + 3 projection JOIN Users+Departments LEFT (ListHandler/InboxHandler/ApprovedHandler) + FE PeListItem type +4 + UI card 👤 Drafter · Phòng ban inline) + dotnet test 111/111 PASS unchanged. **Plan AG5** (`083b601`) extend tree 3-level Project > Năm > NCC > PE (selectedSupplierName fallback "(Chưa chọn NCC)" cho PE chưa DaDuyet, sort vi locale + năm DESC + PE createdAt DESC). **Plan AG6** (`d99069a`) compact card 3-row gọn đẹp (drop Type "Duyệt NCC" label redundant + combine mã phiếu/time + Drafter/Dept/HĐ inline + py-2.5 → py-2). Tất cả 6 commit verified IDENTICAL SHA256 hash mirror 2 app §3.9 + npm build × 2 PASS 0 TS err. **Plan AI RAG global MCP setup** (User-level Approach A — 1 dev 5 dự án cùng máy localhost share infrastructure): Phase 0 pre-flight (Python 3.11.3 + Voyage API key set User scope length 46 + 5 project paths detected Claude Desktop config epitaxy: SOLUTION + NAMGROUP + DAI_Y_DUOC + ASHICO + VIPIX_MULTISITE) + Phase 1 Qdrant v1.18.0 Windows native binary running PID 67240 port 6333 (KHÔNG Docker, anh chốt no Docker) + Phase 2 FastMCP server ~1100 LOC Python 9 file (server.py 6 tool handlers + lib/embed.py Voyage wrapper + lib/retrieval.py 3-layer pipeline + lib/projects.py auto-detect cwd + lib/chunking.py Anthropic Contextual Retrieval prepend + lib/watcher.py + bootstrap.py CLI + README.md) + Phase 3 register MCP user-level (`claude mcp add -s user -e VOYAGE_API_KEY=$VK -- rag-unified python ...` — trick `--` separator để terminate variadic `-e` flag) — "rag-unified: ✓ Connected" + Phase 4 bootstrap SOLUTION_ERP corpus 126 files → **2,392 chunks indexed 60.9s** (~484K Voyage tokens = 0.24% free tier 200M/month) + verify search 4 query thực tế recall 0.641-0.879 rerank score. **Stack final RAG:** Voyage-4-large embedding (1024-dim) + Voyage rerank-2.5 cross-encoder + Qdrant Windows native + SQLite FTS5 BM25 (unicode61 + diacritics remove) + Reciprocal Rank Fusion (k=60) + FastMCP 3.3.1 stdio + Anthropic Contextual Retrieval prepend "From <doc> > <heading>:" + git-sync embeddings snapshot pattern (Cursor lesson). 6 MCP tools exposed: search_memory · cross_project_search · search_code · store_memory · promote_to_shared · list_projects. **+1 file MD onboarding** `docs/guides/multi-agent-setup-guide.md` xuất cho 4 dự án future áp dụng pattern 1 em main + 4 sub-agent + RAG share infrastructure. Multi-agent ROI S26: 🟦 Investigator 2 spawn (Plan AG audit 5Q + Plan AI RAG distribution research 4 study cases Cursor/Cline/Continue/Sourcegraph) ~70K + 🟨 Implementer 1 spawn (Plan AG Case 2) ~16K + 🟥 Reviewer 1 spawn (Plan AG pre-commit) ~25K + 🟩 CICD Monitor 1 spawn (Run #222) ~12K. Em main solo Plan AG2-AG6 (5 plan polish UAT iteration) + Plan AI Phase 0-4 (RAG infra setup ~1.5h). **State chốt S26:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · 49 gotcha unchanged · 23 memory user-level unchanged · 6 skills · 4 sub-agents · **+1 docs/guides/multi-agent-setup-guide.md** + **+1 RAG infrastructure** `D:\.claude-rag\` ready 5 project. 3 patterns reusable cross-project (S26 NEW): (1) Pattern 19 Implementer — HTML native `<details>/<summary>` + Tailwind named groups `group/proj`+`group/year`+`group/sup` + localStorage Set<string> cho hierarchical 3-level tree UI no Accordion lib, (2) RAG User-level Global MCP — 1 server localhost serve N project + per-project `.claude/rag.json` config (Approach A — 1 dev solo scenario), (3) Qdrant Windows native binary deployment — no Docker overhead, appropriate cho solo dev không enterprise scale. **Memory FLAG continued S26:** cicd-monitor MEMORY ~74KB (+2KB từ S25), critical curate session URGENT next (archive Run #186-#221 verbose → `archive/2026-05-runs.md`). **Pending follow-up Plan AI:** Phase 5 bootstrap 4 project còn lại (NamGroup/DH Y Dược/Ashico/Vipix) ~30 phút mỗi project + Phase 6 file watcher + Windows Task Scheduler auto-start Qdrant. Tests baseline 111 preserve cross 6 commit (test debt cumulative S22+1 + S25 + S26 bug fix not added — UAT mode defer per §7).)
-
-**Last updated S25:** 2026-05-19 (Session 25 chốt cuối — **🎯 Plan AB→AF cumulative 7 commits push `e23f51c..506cada` + 7 CICD Runs (#215 FAIL → #216-#221 PASS) — Lịch sử visibility critical fix UAT iteration**. Trigger: Bro UAT 2026-05-19 phát hiện 2 bug critical phiếu PE/2026/A/032: Bug 1 Budget Adjust không show "Lịch sử thay đổi" (BE log OK + FE filter strict TraLai-only loại) + Bug 2 Return Mode 4 mode KHÔNG log Changelog (`ApplyReturnModeAsync` miss `db.PurchaseEvaluationChangelogs.Add()`). **Plan AB Chunk A** (`cdfd542`, 🟨 Implementer Case 1 spawn ~12K): BE refactor `ApplyReturnModeAsync` Drafter early return → common path + single `Changelog.Add()` cover 4 mode uniform với `modeName` switch enum + `actorName` resolve via `userManager.FindByIdAsync` mirror `LogTransitionAsync` pattern. FE `PeDetailTabs.tsx` × 2 app `HistoryTab` filter extend (PE_ENTITY_HEADER=1 + summary 'ngân sách' + Workflow summary 'Trả lại'). 🟥 Reviewer pre-commit verify ~22K PASS 0 critical/major/minor (1 minor V1 legacy fallback non-block). Run #215 FAIL test_infra 2/53 — Plan M edge case tests SQLite frozen-clock tie-break (gotcha #48 NEW): 2 Changelog rows cùng `CreatedAt` → `OrderByDescending.FirstAsync()` pick wrong → ContextNote null. **Plan AB Chunk A2** (`8c05947`, em main solo): Test filter `Where(Summary.Contains("Chuyển phase"))` pick đúng LogTransition entry. 111/111 PASS. Run #216 PASS. **Plan AC** (`a734bf2`, em main solo): BE capture pre-call Step/Level → Reject branch add `PurchaseEvaluationApprovals.Add()` với Decision=Reject + Comment from-pos + mode summary. BE line 472 enrich Approve comment prefix `[Duyệt vượt cấp tới Cấp cuối]` khi skipToFinal=true. FE × 2 app ApprovalsTab thêm `decisionBadge(decision, toPhase)` helper (Duyệt emerald / Trả lại amber / Từ chối rose). Run #217 PASS, bundle rotate × 2 app. **Plan AC2** (`25837b6`, em main solo, Option 2A bro chốt): FE merge view ApprovalsTab fetch changelogs + reconstruct synthetic Reject rows từ Workflow+Reject Changelog (filter EntityType=5 + Summary "→ TraLai"/"→ TuChoi" OR ContextNote "Trả về"/"không lùi được") + dedupe `approverUserId + timestamp 5s bucket` cùng real Reject rows + merge sort by approvedAt. KHÔNG DB write, reversible historical recovery. Run #218 PASS, 8 Workflow entries verified, bundle rotate × 2 app. **Plan AD** (`0aaf2df`, em main solo, Option A bro chốt): Drop fromPhase→toPhase badges (visual confusion 3/4 mode Reject giữ ChoDuyet — gotcha #49 NEW) + add `extractNextTargetHint(decision, toPhase, comment)` helper regex parse `Chuyển phase X → Y` + keyword detect "Trả về"/"vượt cấp"/"Cấp cuối" → "→ Cấp Y" / "→ Trả về Người chỉ định (Bước X Cấp Y)" / "→ Vượt cấp tới Cấp cuối" / "→ Đã duyệt hoàn tất". Cleanup unused `PurchaseEvaluationPhaseColor` import. Mirror × 2 app §3.9. Run #219 PASS, bundle rotate × 2 app. **Plan AE** (`9ea62be`, em main solo, preventive batch fix): BE 9 `Changelog.Add()` sites add `UserName = currentUser.FullName ?? currentUser.Email` (Budget Adjust + Create PE + Update PE Header + Detail Insert/Update/Delete + Quote Insert/Update/Delete + Select Winner). ICurrentUser đã có FullName/Email từ JWT — KHÔNG inject userManager mới. `replace_all=true` 1 pass cover 8 sites cùng indent + 1 site manual fix indent 16 spaces inside if block. 111/111 PASS local. Run #220 PASS, bundle UNCHANGED (BE-only commit). **Plan AF** (`506cada`, em main solo, Option A bro chốt): FE ApprovalsTab + HistoryTab build `userMap useMemo` từ embedded PeDetailBundle data: `drafterUserId+drafterName + approvals[].approverUserId+approverName + approvalFlow.steps[].levels[].approvers[].userId+fullName + levelOpinions[].signedByUserId+signedByFullName + departmentOpinions[].userId+userName` — no extra `/api/users` fetch (admin permission). `resolveActorName(a) / resolveUserName(l)` helper: trust entry.userName non-empty → userMap.get(entry.userId) → 'Hệ thống' fallback. Mirror × 2 app §3.9. Run #221 PASS, bundle rotate × 2 app. **Multi-agent ROI S25:** 🟦 Investigator 1 spawn (~28K Bug 1+2 audit) + 🟨 Implementer 1 spawn (~12K Plan AB Chunk A Case 1) + 🟥 Reviewer 1 spawn (~22K Plan AB pre-commit) + 🟩 CICD Monitor 7 spawns (Run #215 catch test gate fail + Run #216-#221 PASS verify, ~70K cumulative). Em main solo 5 plans AC→AF cross-stack reasoning + UAT iteration. Total cumulative agent cost ~132K · em main ~210K. **State chốt S25:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · **49 gotcha (+2: #48 SQLite tie-break + #49 dual-phase UI confusion)** · **23 memory user-level (+2 NEW: feedback_fe_merge_synthetic_audit + feedback_fe_usermap_fallback)** · 6 skills · 4 sub-agents active. **Memory CRITICAL FLAG:** cicd-monitor MEMORY ~72KB strongly over 50KB hard threshold — DEDICATED CURATION SESSION REQUIRED next (archive Run #186-#210 + S22-S24 verbose entries to `archive/2026-05-runs-186-210.md`). Investigator 32KB / Implementer 35.7KB / Reviewer 32.3KB cũng over 25KB threshold — recommend curate cùng session với cicd-monitor. **8 patterns reusable saved S25:** (1) Multi-Changelog SQLite tie-break (gotcha #48) → test discriminator, (2) CICD catch UAT skip test risk → resumed local verify BE refactor > 100 LOC, (3) Test fix Option A over BE refactor preservation, (4) Capture pre-call mutation state cho audit row from-position, (5) FE merge synthetic rows từ Changelog reversible recovery (Plan AC2), (6) Drop misleading dual-phase badges + semantic next-target hint (Plan AD), (7) Changelog UserName preventive systemic batch fix 9 sites (Plan AE), (8) FE userMap fallback từ embedded domain data no extra API (Plan AF). Bro UAT verify cumulative deploy live PE/2026/A/032 — historical entries pre-Plan AE nay resolve user names qua userMap fallback.)
-
-**Last updated S24:** 2026-05-15 (Session 24 chốt cuối — **🎯 Plan AA cumulative 7 commits push `a1a910f..ee0902a`** — User Workflow Matrix view + Sidebar widen + 4 polish iteration UAT feedback. Phase 1 Plan AA core (3 commit `ee776d5..ac2c859`): 🟦 Investigator Pre-A 5Q audit (~32K) + 👤 Chủ trì Chunk A BE+Layout solo (gotcha #44 đã fix permanent từ S18 → chỉ ADD `IsUserSelectable bool?` filter + DbInitializer INSERT-OR-UPDATE-Order idempotent shift existing prod rows + MenuKeys `Pe_DuyetNcc_WfView` helper + sidebar widen `w-72 xl:w-80` × 2 app + revert Plan U truncate × 5 sites) + 🟨 Implementer Case 2 Chunk B FE (~14K, WorkflowMatrixViewPage + types + App.tsx route ~270 LOC) + 🟥 Reviewer cumulative pre-commit (~25K, PASS 0 blocker + fe-admin build bonus 1926 modules) + 🟩 CICD Monitor Run #210 verify (4/4 wire end-to-end: filter live + menu Order shift + bundle hash rotate 2 app + Mig 31 unchanged). Phase 2 polish iteration UAT feedback (4 commit `da218f1..ee0902a`): 👤 Chủ trì Solo 4× CSS/UX polish — (1) `da218f1` hotfix container px-6→px-2 (content sát sidebar) + (2) `4d60598` redesign v1 panel-per-NV mirror admin Designer color coding (drop table 11 cột symbol khó hiểu) + (3) `fbbd361` redesign v2 HTML table rowSpan tận dụng full width (4 cột: Bước/Cấp/NV/Quyền duyệt grid 2-col 7 label) + (4) `ee0902a` wrap fix label dài về đầu hàng pattern hanging-indent reverse CSS (flex→block + inline-block icon + inline text + absolute ChevronDown) + text smaller text-[12px] leading-snug. Patterns reusable cross-project: (a) gotcha #44 relax pattern PROVEN cross-stack reuse, (b) DbInitializer INSERT-OR-UPDATE-Order idempotent re-deploy, (c) Tailwind JIT palette array (STEP_PALETTE 5 màu + LEVEL_PALETTE 5 màu cycle), (d) HTML table rowSpan flat row builder helper, (e) hanging-indent reverse via inline-block icon. Stats: 31 mig · 59 tables · **~146 endpoints (+1 GET filter param)** · **35 FE pages (+1 WorkflowMatrixViewPage)** · **111 test** (no change, baseline confirmed post-Plan AA) · 47 gotcha · 21 memory · 6 skills · 4 sub-agents. Multi-agent ROI S24: ~175K total (Inv 32K + Imp 14K + Rev 25K + CICD 12K + 3 flush agents ~12K + em main ~80K) = ~28% solo equiv. CICD verify Run #210 PASS. **Implementer MEMORY ~31.5KB > 25KB threshold** → recommend curate next session archive S20-S22 old entries.)
-
-**Last updated S23 t12:** 2026-05-15 (Session 23 turn 12 chốt cuối — **🎯 S23 cumulative 11 plan + 32 commits**. Plan K (Mig 31 F2 refactor 9c) → L (UAT bug 5c) → M (F1 edge case 4c) → N (per-NV lookup 1 site 2c) → O (4 sites cascade 2c) → P (Controller body record 1c) → Q (FE banner 1c) → R (cleanup phiếu/wf 1c) → S (wipe ALL wf 1c) → T (DemoSeed flag 2c) → U (sidebar truncate 1c). 4 sub-agents: Investigator 5 spawn + Implementer 5 spawn + Reviewer 2 spawn + CICD Monitor 10 verify runs PASS. Memory +1 NEW `feedback_demo_seed_flag_disable.md` + `feedback_per_nv_permission_scope.md` reinforced 10 wire surface points (point 9 lookup discrimination + point 10 Controller body record mirror). Cleanup cumulative R+S+T5 ~720 rows wiped + DbInitializer flag persist. Stats: 31 mig · 59 tables · ~145 endpoints · **111 test** · 47 gotcha · **21 memory** (+1) · 6 skills · **0 PE + 0 demo workflow + flag persist** UAT permanent clean slate. 32 commits push `eb106f2..86d8806`. Plan B Contract V2 wire HIGH next.)
-
-**Last updated S23 t10:** 2026-05-15 (Session 23 turn 10 — **🔧 Plan T: Disable auto re-seed demo data + final DELETE — UAT permanent clean slate**. Bro phát hiện sau Plan R+S: 4 phiếu `[DEMO]-A/B` + workflows TỰ ĐỘNG RE-SEED sau IIS recycle do DbInitializer 5 demo seed methods. Plan T fix root cause: `appsettings.json` add `DemoSeed:Disabled=true` (Dev override false) + `DbInitializer.cs` check flag → skip 5 method. Run #207 PASS deploy applied flag. T5 sqlcmd DELETE 7 rows + cascade. T6 force IIS recycle verify NO re-seed: PE=0 + V2=0 + V1=0 preserved. DemoSeed flag PROVEN active end-to-end. Cumulative Plan R+S+T: ~677 rows wiped + DbInitializer re-seed permanent disable. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow + flag persist** UAT permanent clean slate.)
-
-**Last updated S23 t9:** 2026-05-15 (Session 23 turn 9 — **🧹 Plan S: Wipe ALL workflows — UAT clean slate hoàn toàn**. Bro chốt sau Plan R: xóa hết 4 workflows demo cũ còn lại (V2 ghim + V1 active đều seed cumulative). Backup Plan R reuse. Execute DELETE ALL ApprovalWorkflows + PurchaseEvaluationWorkflowDefinitions. Post-state: **0/0 workflow + 0 cascade Steps/Levels/Approvers**. BE smoke 5/5 endpoints 200, KHÔNG crash. Total cumulative cleanup Plan R+S: ~670 rows wiped (35 PE + 17 V2 + 4 V1 + 600 child). Hậu quả: user phải đợi admin Designer seed workflow mới. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory. Database UAT clean slate hoàn toàn.)
-
-**Last updated S23 t8:** 2026-05-15 (Session 23 turn 8 — **🧹 Plan R: Cleanup destructive prod database**. Bro chốt sau Plan P+Q wire OK: "xóa hết phiếu test + quy trình ko ghim". Investigator pre-flight audit ~64K confirm scope 28 PE active + 7 soft + 15 V2 unghim + 2 V1 inactive. Backup mandatory `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB. Hard-DELETE 52 rows + ~600 cascade child (PE child + workflow Steps+Levels+Approvers). Post-cleanup: **0 PE · 2 V2 ghim · 2 V1 active**. Smoke verify 3/3 endpoints 200 — BE healthy. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory · 6 skills. UAT clean slate. Bro test workflow fresh.)
-
-**Last updated S23 t6:** 2026-05-15 (Session 23 turn 6 — **🎯 Plan P HOTFIX: Controller TransitionPeBody record missing 3 fields — bug ROOT CAUSE thực sự F1+F2 fail**. CICD Monitor Plan O Run #202 catch CRITICAL caveat: Controller `TransitionPeBody:267` MISSING ReturnMode + ReturnTargetUserId + SkipToFinal. Investigator audit FE confirm: FE × 2 app mirror SEND ĐÚNG 7 fields qua `api.post()` — BE drop tại Controller body record + mediator.Send line 70. Bug present 2 ngày prod từ Mig 28 deploy 2026-05-13 → F1+F2 wire fail từ FE side. Plan N + Plan O fix lookup sites nhưng controller bug block flow trước khi đến lookup. Plan P fix BE-only ~10 LOC: TransitionPeBody +3 field default null/false + mediator.Send pass 7 fields + using import WorkflowReturnMode namespace. **111/111 PASS unchanged**. Pattern reinforced: Controller body record MUST mirror Command record fields. Multi-agent ROI: Investigator avoid cross-stack fix sai + CICD Monitor catch root cause invaluable chain. Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test** · 47 gotcha · 20 memory · 6 skills.)
-
-**Last updated S23 t5:** 2026-05-15 (Session 23 turn 5 — **🎯 Plan O HOTFIX: 4 lookup sites cùng pattern per-NV cascade — Plan N chỉ catch 1/5 sites**. Bro UAT sau Plan N: Actor NV Test trong OR-of-N click "Trả lại Người chỉ định" → "Không phải lượt bạn" mặc dù đúng slot. Em main grep audit phát hiện 5 lookup sites cùng bug, Plan N chỉ catch 1. Plan O fix 4 sites còn lại: Service.cs:201 (EnsureCanRejectV2Async = bug bro), Service.cs:248 (ApplyReturnModeAsync read Allow flag), DetailFeatures.cs:72 (F3 guard), Features.cs:311 (F4 AdjustBudget guard). ApplyReturnModeAsync signature +`Guid? actorUserId` 4th param + caller TransitionAsync:94 update. 3 regression test mới `PurchaseEvaluationPerNvLookupRegressionTests`. **111/111 PASS** (+3 từ 108). Pattern reinforced 5 sites checklist + audit grep `FirstOrDefault.*Order ==`. Bug 2 (F2 chỉ đến Phan Văn Chương) defer follow-up — F2 logic đúng, verify workflow v14 DB. Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test (+3)** · 47 gotcha · 20 memory · 6 skills.)
-
-**Last updated S23 t4:** 2026-05-15 (Session 23 turn 4 — **🎯 Plan N HOTFIX: BE per-NV lookup site discrimination — bug critical UAT block**. Bro UAT screenshot phát hiện admin Designer tick 7 flag TRUE cho NV Test (UAT V2) nhưng dialog Duyệt/Trả lại KHÔNG có F1+F2+F3+F4 options. Investigator audit verify Hypothesis B: `PurchaseEvaluationFeatures.cs:765` `FirstOrDefault(Order==X)` thiếu `ApproverUserId == currentUser.UserId` discriminator. Schema Mig 29 OR-of-N: 4 row cùng Order → handler luôn lấy row đầu DB (Lê Văn Bính, Drafter only), bỏ qua admin tick per-NV. Bug PRESENT 2 ngày prod từ Mig 29 deploy 2026-05-13 — chỉ bộc lộ khi lần đầu admin tick selectively. Fix 5 LOC: thêm match `ApproverUserId == currentUser.UserId` + fallback row đầu cho admin/non-approver. Test regression `GetPurchaseEvaluationCurrentLevelOptionsTests` 2 method: 4 actor distinct flag profile + admin fallback. **108/108 PASS** (+2 từ 106). Multi-agent ROI: Investigator catch root cause 1 spawn ~80K — em main solo fix nhanh. Pattern reinforced: per-NV admin opt-in flag wire checklist **9 surface points** (thêm point 9 handler lookup site discrimination). Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **108 test (+2)** · 47 gotcha · 20 memory (1 entry reinforced) · 6 skills.)
-
-**Last updated S23 t3:** 2026-05-15 (Session 23 turn 3 — **🎯 Plan M: Fix F1.OneLevel/OneStep edge case Bước 1 → giữ ChoDuyet + FE label phase rename**. 3 commits Plan M `c2042ef..4dd6f9c` local (chưa push, chờ Reviewer verdict). Bro UAT post-Plan L deploy: "Hiện logic cũ là khi trả lại 1 cấp hoặc chỉ định hoặc edit là trạng thái draft → thay đổi lại". Investigator audit confirm 4 mode F1.OneLevel/Assignee + F2 + F3 + F4 main path đã giữ ChoDuyet đúng (Mig 28-31 cumulative). Edge case F1.OneLevel ở Bước 1 Cấp 1 + F1.OneStep ở Bước 1 còn fallback Drafter (Phase=TraLai) — gap "draft" bro phát hiện. Plan M fix: reset (0, 1) giữ Phase=ChoDuyet + audit log "không lùi được" + SLA reset 7d (no-op effective). M3 FE label phase Phase=TraLai badge "Trả lại" → "Cần chỉnh sửa lại" (rõ end-user). M2 add 2 edge case tests **106/106 PASS** (+2 từ 104). F1.Drafter mode 4 GIỮ NGUYÊN Phase=TraLai semantic (explicit role mode). Multi-agent ROI evidence: Investigator catch fact code main path đã đúng (avoid em main spam fix sai) + Implementer Case 2+3 cookie-cutter 2 spawns + Reviewer pre-commit pending. Memory user-level update 2 entry. Stats: **31 mig** · 59 tables · **~145 endpoints** · 34 FE pages · **106 test (+2)** · 47 gotcha · 20 memory (2 entry reinforced) · 6 skills · 4 sub-agents. CHƯA push remote.)
-
-**Last updated S23 t1:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K Mig 31 F2 refactor sang per-Approver-slot — DONE 9 commits `56868bf..0062fcb` pushed remote**. Verify result K9 + K11: Mig 31 prod TOP 1 ✅, Levels.AllowApproverSkipToFinal col added ✅, Users.AllowDrafterSkipToFinal col dropped ✅, zombie PATCH /allow-skip-final → 404 ✅, bundle hash rotated 2/2 (admin `CpI5OL8n→CRsX6cFo`, user `d064StNa→X7qb4Zl4`) ✅, 33 active users preserved ✅, AwLevelDto `allowApproverSkipToFinal` field PRESENT (13 keys, default False opt-in) ✅. CICD Monitor K9 catch CRITICAL wire gap: `AwLevelDto` admin DTO miss field — em main K2 + Reviewer K2 cùng miss audit `ApprovalWorkflowV2AdminFeatures.cs`. K10 hotfix ~15 LOC 1 file (AwLevelDto + ToDto + CreateAwLevelInput + entity init) pushed `0062fcb`. Run #195 success → K11 self-verify field present. Pattern lesson: per-NV admin opt-in flag wire **8 surface points** required (NOT 6 — admin overview DTO + Create input là 2 gap em main miss S22+5 và S23 t1). Memory `feedback_per_nv_permission_scope.md` cần add wire checklist gotcha S23 t2+.
-
-**S23 t1 prev:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K Mig 31 F2 refactor sang per-Approver-slot — DONE 8 commits Plan K `56868bf..<latest>`**. Bro phát hiện inconsistency S22: F1+F3+F4 đều per-slot ở Designer, F2 lone wolf ở User Management (Plan D S22 wire) + bro chốt đổi semantic F2: Drafter from Nháp → Approver during ChoDuyet skip thẳng Cấp cuối. Plan K 8 chunk: pre-A slot label rename "#NV {order}" → ApproverFullName + K1 Mig 31 schema swap (drop Users + add Levels, NO BACKFILL Option A) + K2 Service ApproveV2Async +skipToFinal 8th param APPROVE STEP branch + DTO 7th Allow* field + K3 Designer 7th checkbox + banner rewrite + K5 zombie endpoint cleanup (PATCH /users/{id}/allow-skip-final + Command/Handler/DTO/UI all backout Plan D S22) + K6 Workspace × 2 app DROP Drafter checkbox + ADD Approver toggle Dialog amber warning + K7 tests 104/104 PASS regression (3 deleted Drafter F2 + 3 added Approver F2 cancel out) + K8 docs cumulative. Multi-agent ROI: 🟦 Investigator K0 pre-flight + 🟨 Implementer 4 spawns (pre-A + K1 + K3 + K5 + K7 Case 2+3) + 🟥 Reviewer K2 pre-commit catch zombie endpoint Major + 👤 Chủ trì K0-bis sqlcmd + K2 cross-stack reasoning + K6 UX flow + K8 docs. 4 prod user lose AllowDrafterSkipToFinal=true value per Option A (admin re-config qua Designer). Reviewer K2 PASS 0 critical, 2 Major + 2 Minor flagged → K5 + K8 resolved. New pattern caught: "Transient sentinel zombie" anti-pattern (K1 sentinel-false patch + chunk scope shift → endpoint NoOp swallow silent). Per-NV admin opt-in flag pattern proven **3× cumulative** (Mig 29 F1+F3 + Mig 30 F4 + Mig 31 F2) — pattern ALSO applies cho refactor existing scope, KHÔNG chỉ greenfield. Memory `feedback_per_nv_permission_scope.md` reinforced S23 t1. State final: **31 mig (+1 Mig 31)** · 59 tables · **~145 endpoints (-1 backout)** · 34 FE pages · **104 test PASS unchanged** · 47 gotcha · 20 memory · 6 skills · 4 sub-agents (Investigator 1 spawn + Implementer 4 spawn + Reviewer 1 spawn + CICD pending K9). CHƯA push remote — chờ bro confirm K9 spawn CICD Monitor verify.)
-**S22 chốt cuối:** 2026-05-13 2300 (Session 22 CHỐT cuối cùng — **bro chốt directive Thứ 9 BẮT BUỘC delegate sub-agent**. 14 commits pushed remote `3d725c4..2b9788d` + (this final). CICD Monitor Run #193 PASS verified all live endpoints + Mig 30 prod + bundle hash rotated. State final: **30 mig · 104 test · 47 gotcha (#47 revised informational) · 19 memory · 6 skills · 4 sub-agents · 33 active users prod**. Retrospective S22: em main solo 6/10 task lẽ ra delegate được — vi phạm directive Thứ 9. **Forward S23+ rule:** BẮT BUỘC spawn sub-agent khi ACCEPT criteria match (Implementer Case 1/2/3/5, Investigator pre-flight, Reviewer pre-commit, CICD Monitor post-deploy). Em main solo CHỈ khi schema/UX/architecture decision + cross-stack tight coupling + bug fix reasoning chain.)
-**S22 chốt v1:** 2026-05-13 2200 (Session 22 CHỐT — **bro confirm sub-agent solution OK**. 11 commits pushed remote `3d725c4..b04a11a`. CICD Monitor Run #188 PASS verified. State final: **30 mig · 104 test · 47 gotcha (+1 #47) · 19 memory · 6 skills · 4 sub-agents · 33 active users prod**. KHÔNG còn pending push. Plan G S21-S22 evidence: Trial Week 1 → Week 2 sub-agent ROI confirmed. Bro test UAT 4 flag pattern + view file PDF + Section Điều chỉnh ngân sách.)
-**S22 prev:** 2026-05-13 1800 (Session 22 — Plan C + D + E done, Plan F ABORTED pre-flight fail. 5 commits local `60efeed..HEAD` chưa push. Plan D F2 toggle UI (BE+FE Admin). Plan C task 4 + 1-3 — 19 unit test mới (+5 reg #44 + 7 ReturnMode + 7 Guard). Plan E strict V2 scope List + Detail (remove UAT loose `|| ApprovalWorkflowId != null`). Plan F ABORTED — pre-flight prod sqlcmd reveal Contract entity HOÀN TOÀN V1 chưa wire V2 + 4 PE V1-only + 23 PE V1+V2 mix. Defer F sau Plan B Contract V2 wire. State: **29 mig · 103 test (+19) · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (em main solo S22)**. 5 commits pending push `3d725c4..HEAD`.)
-**S21 CHỐT CUỐI:** 2026-05-13 1530 (Session 21 CHỐT CUỐI — 5 turn cumulative `3a34831..c0af9e0` 12 commits pushed remote, CICD Monitor verify 2/2 run PASS. Gotcha #46 mới (Gitea API path/cache stale). 2 memory user-level mới: `feedback_ef_migration_backfill_reorder` + `feedback_per_nv_permission_scope`. 3 agent Inv/Imp/Rev cập nhật MEMORY ghi recent activity S21 t3-t5 em main solo. State final: **29 mig · 84 test · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (3 seeds + 1 cicd 2-run)**. KHÔNG còn pending push. Plan G Trial Week 1 evidence: CICD spawn 2/2 PASS (green), cost ~110-120K under 150K budget, CI time 3-3.5min stable. Pending Plan C test-after bundle defer sau UAT 2-3 lần ổn.)
-**S21 turn 5:** 2026-05-13 1400 (Session 21 turn 5 — **🎯 Refactor Allow* sang PER-NV (Mig 29). 4 chunk per-commit `0366946` (A BE+Mig 29) → `63234b2` (B FE Admin Designer per-Level 5 checkbox) → `5ccb2a7` (C FE eOffice mirror 2 app rename) → this Chunk D Docs. **F1+F3** 5 flag MOVED xuống `ApprovalWorkflowLevels` (per slot Approver). **F2** MOVED xuống `Users` (per-Drafter). Mig 29 4-stage: ADD 5 Levels + 1 Users + BACKFILL bulk SQL preserve admin config S21 t4 + DROP 6 workflow column. Service refactor đọc `currentLevel.Allow*` + `drafterUser.AllowDrafterSkipToFinal`. DTO `AwLevelDto +5`, `PeDetailBundle.workflowOptions → currentLevelOptions + drafterAllowSkipToFinal`. FE Admin Designer 5 checkbox per Level slot inline (drop section workflow-level). 84 test PASS. CHƯA push remote — chờ bro confirm.**)
-**S21 turn 4:** 2026-05-13 1200 (Session 21 turn 4 — **🎯 F1+F2+F3 PE Workflow advanced options (Mig 28) — 5 chunk per-commit `0294693` (A schema) → `c56024b` (B BE) → `a508564` (C FE Admin) → `d27caaf` (D FE eOffice) → this (E Docs). **F1** 4 mode Trả lại admin tick stick (1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo) — 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain), mode Drafter giữ Phase=TraLai clear pointer (S17 backward compat). **F2** Drafter skip thẳng Cấp cuối — workflow tick + Workspace checkbox dynamic. **F3** Approver edit Section 2 (Hạng mục/NCC/Báo giá) khi workflow tick + actor match CurrentLevel.ApproverUserId + audit ghi PurchaseEvaluationChangelog. Mig 28 thêm 6 bit column lên `ApprovalWorkflows` (DEFAULT 1 cho AllowReturnToDrafter backward compat, 5 còn lại 0). BE Service extend signature 3 optional param (returnMode/returnTargetUserId/skipToFinal). Helper `EnsureEditableForDetailsAsync` mới gating Detail/Quote/Supplier CRUD theo Drafter scope OR F3 Approver scope + audit changelog Update/Delete (trước đây silent). FE Admin Designer "Cấu hình nâng cao" section 6 checkbox 3 group. FE eOffice 3 changes mirror 2 app. UAT mode skip dotnet test mỗi chunk, npm build × 2 app pass mỗi chunk. CHƯA push remote — chờ bro confirm.**)
-**S21 turn 3:** 2026-05-12 2100 (Session 21 turn 3 — **🔴 BUG FIX CRITICAL "Trả về nhưng hệ thống vẫn duyệt" PE workflow (gotcha #45 mới). 3 chunk per-commit: `de00887` (BE Chunk A guard + 3 test) + `4b29d00` (FE Chunk B fix 2 app mirror) + this Chunk C Docs. Root: `PeWorkflowPanel.tsx` `isReject` payload (L64-66) thiếu nhánh TraLai → button "← Trả lại" gửi `decision: 1` (Approve) thay vì `2` (Reject) khi target=TraLai(98) → BE skip Reject branch → enter APPROVE STEP → `ApproveV2Async` UPSERT opinion "đã duyệt" + advance Cấp tiếp theo. Inconsistency phụ: dialog `isSendBack` (L247-248) cùng pattern thiếu TraLai → dialog title sai `'✓ Duyệt → Trả lại'` + KHÔNG amber warning. Severity CRITICAL — data integrity issue khó rollback (BE đã `SaveChangesAsync`). Test-before §7 BẮT BUỘC: viết test reproduce → confirm FAIL (BE đi sâu vào ApproveV2Async throw "Phiếu chưa pin workflow") → thêm BE guard early throw ConflictException khi `target ∈ {TraLai, TuChoi} && decision != Reject` → confirm PASS. 3 regression test (Throws TraLai+Approve, Throws TuChoi+Approve consistency, happy path Reject+TraLai). Tổng `dotnet test SolutionErp.slnx` 84 PASS (58 Domain + 26 Infra = +3 from 81 baseline). `npm run build` × 2 app pass. Stats: 27 mig (no change) · 59 tables · ~142 endpoints · 34 FE pages · **84 test (+3)** · **45 gotcha (+1 #45)** · 17 memory · 6 skills · 4 sub-agents seeds-only. Em main solo S21 t3 — bug fix reasoning chain cross BE/FE Implementer REFUSE per multi-agent rule (decision tree: tightly coupled BE+FE+test). CHƯA push remote — chờ bro confirm sau Chunk C wrap.**)
-**S21 turn 2:** 2026-05-12 1800 (Session 21 turn 2 — **🎯 RAG Hybrid setup planning + Cách A validation deep dive. 2 commit (`1f8e9af` plan save 1223 LOC + this chốt). KHÔNG implement, plan only — defer chờ bro confirm 5 dự án future. Decision chốt: Cách A defensive (giữ blanket 120K em main + RAG retrieve) over Cách B aggressive (cắt 60-70% blanket). Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider). Stack: Voyage-3-large + Qdrant + FastMCP + Streamlit dashboard. Multi-agent cost reality: 4 agents → ~520K cumulative blanket → heavy session ~560K (Cách A) vs ~700K (lazy). 3-layer pattern Phase 1-3 rollout (embeddings + BM25 + reranking, ~70% → ~92% recall). Stats: +1 memory entry (`feedback_rag_hybrid_pattern`) +1 plan file (`rag-setup-plan.md` 1500 LOC). Sub-agents vẫn 4 seeds-only, em main solo session.**)
-**S21 turn 1:** 2026-05-12 0030 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`. CI skipped per path filter (3 file `.md`). Cost reality update: ~750K spawn (3 → 4 agents) · ~1.35M heavy / ~700K optimized. Stats: 4 sub-agents seeds-only · 16 memory · 27 mig · 59 tables · ~142 endpoints · 81 test · 44 gotcha · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work — em main solo). Trial Week 1 kick-off S21 turn 2+ Plan B Contract V2 wire mirror PE pattern.**)
-
-## 🎯 Plan B Contract V2 wire — sub-agent role pre-allocated (S23+ kick off priority)
-
-Per directive Thứ 9 BẮT BUỘC delegate. Workflow forward:
-
-| Chunk | Owner | Justification |
-|---|---|---|
-| **Pre-flight audit Contract entity V1 state** | 🟦 **Investigator** | Read-only scan `Contract.cs` + `ContractDeptApproval.cs` + sqlcmd 7 V1 contract — Case "audit > 5 files" |
-| **Chunk A Mig 31 schema** (Contract +ApprovalWorkflowId +CurrentApprovalLevelOrder) | 🟨 **Implementer Case 2** | Cookie-cutter mirror PE Mig 23 pattern proven 1× S17. Spec deterministic |
-| **Chunk B Service ApproveV2Async branch** | 👤 **Chủ trì Solo** | Cross-stack reasoning chain — Service branch theo pin field + state machine integration |
-| **Chunk C Mig 32 ContractLevelOpinions + Service UPSERT hook** | 🟨 **Implementer Case 2** | Mirror PE Mig 26 + service hook pattern (`feedback_service_hook_vs_endpoint`) |
-| **Chunk D FE ContractCreatePage Workspace Select V2** | 🟨 **Implementer Case 2** | Mirror PeCreate Workspace pattern × 2 app (rule §3.9) |
-| **Chunk E FE ContractDetailContent Section 5 V2** | 🟨 **Implementer Case 2** | Mirror PE Section 5 LevelOpinionsSectionV2 × 2 app |
-| **Pre-commit each chunk review** | 🟥 **Reviewer** | Heavy diff + cross-stack — Smart Friend guard active |
-| **Post-deploy verify Run** | 🟩 **CICD Monitor** | Bundle hash + Mig 31+32 prod + smoke endpoint mới |
-
-Estimated: 5-6 chunk, ~700+ LOC. Em main lead Chunk B (cross-stack reasoning) + coordinate. 4 chunk delegate Implementer (Case 2 cookie-cutter mirror).
+**Last updated:** 2026-05-29 (Session 40 — init audit + doc consolidation)
 
 ---
 
-## 🎯 Session 21 chốt cuối — 5 turn timeline (2026-05-12 → 2026-05-13)
+## S40 (2026-05-29) — Init audit + doc consolidation
 
-| Turn | Date/Time | Topic | Commits | CICD verify |
-|---|---|---|---|---|
-| t1 | 2026-05-12 0030 | Add cicd-monitor sub-agent (4th, Path A) | `f1c61c9` `3a34831` (2) | n/a (docs+config only) |
-| t2 | 2026-05-12 1800 | RAG Hybrid setup planning Cách A | `1f8e9af` `0a3b747` (2) | n/a (docs only) |
-| t3 | 2026-05-12 2100 | 🔴 Fix gotcha #45 PE button "Trả lại" mismatch + 3 regression test | `de00887` `4b29d00` `6d30ba4` (3) | bundled with t4 push |
-| t4 | 2026-05-13 1200 | F1+F2+F3 PE Workflow advanced options Mig 28 (workflow-level) | `0294693` `c56024b` `a508564` `d27caaf` `eea86fd` (5) | 🟩 Run #186 PASS 3m32s |
-| t5 | 2026-05-13 1400 | Refactor Allow* sang per-NV Mig 29 (UAT feedback "cấu hình cho từng người") | `0366946` `63234b2` `5ccb2a7` `c0af9e0` (4) | 🟩 Run #187 PASS 3m18s |
+**Việc:** Session-init 10-mục + consolidate docs (anh main pick "Consolidate docs").
+- ✅ **7-agent registry LIVE** (CLI đã restart). Smoke verify: 🟪 test-specialist + 🟦 investigator-api load OK. 🟧 implementer-frontend chưa spawn (smoke khi task FE đầu tiên).
+- ✅ **RAG `rag-unified` connected** — 7 project / **39,798 chunks**, re-rank PASS (top 0.8789, Voyage rerank-2.5 alive). solution_erp 3076 (thiếu S37-S39 content).
+- ✅ **Test 130 PASS** confirm (58 Domain + 72 Infra).
+- ✅ **Doc consolidation:** STATUS 170KB→~15KB + HANDOFF 224KB→~12KB (full → `docs/_archive/`). Count re-ground: endpoints **211**, FE pages **65** (36+29), menu **~53**, tables **84 đúng**. CLAUDE.md root patch mig/table/test stale.
 
-**Cumulative 12 commits S21 pushed remote `3a34831..c0af9e0`.** No pending push.
+**⚠️ Lưu ý harness:** **SendMessage KHÔNG có** trong harness này → agent "reuse" = fresh spawn (MEMORY on-disk auto-inject giữ context). agentId chỉ valid trong-session. agentId S40: investigator-codebase `a4ddb2ab3d8368f68` · test-specialist `a3d4f4511ecce0f38` · investigator-api `ac4d509631913b1c9`.
 
-### Major schema evolution
+**⚠️ Defer (cumulative):** Curate 4 agent MEMORY >25KB · RAG re-ingest S37-S39 · CLAUDE.md root deep stale (test tree breakdown + migration paragraph S32-era + ef-core skill "31 migration") → cron 2026-06-01.
 
-- S21 t4 Mig 28 +6 column `ApprovalWorkflows` (workflow-level Allow*)
-- S21 t5 Mig 29 → REFACTOR: +5 column `ApprovalWorkflowLevels` (per-Approver slot) + 1 column `Users` (per-Drafter F2) + BACKFILL bulk SQL + DROP 6 column `ApprovalWorkflows`
-
-### Pattern reusable saved memory (2 entry mới user-level)
-
-- `feedback_ef_migration_backfill_reorder` — EF auto drop-then-add WRONG cho data preservation, manual reorder ADD→BACKFILL SQL→DROP discipline. Cross-project pattern.
-- `feedback_per_nv_permission_scope` — Multi-role workflow flag split scope theo role context (Approver per-slot Level vs Drafter per-User global), KHÔNG gắn parent workflow-level. Decision tree role → table mapping.
-
-### Gotcha mới (gotchas.md count +1: 45 → 46)
-
-- `#46 Gitea Actions API` — path `/actions/tasks` not `/actions/runs` (Gitea v1 naming khác GitHub), cache stale ~2 min → cross-check VPS file mtime. Discovery từ CICD Monitor Run #186 + #187.
-
-### Plan G Trial Week 1 evidence (multi-agent ROI)
-
-| Spawn | Run | Cost | Verdict | Catch | Notes |
-|---|---|---|---|---|---|
-| 🟩 CICD Monitor #1 | Run #186 (S21 t4 deploy) | ~12K | PASS | 0 fail (green) | Gitea API discovery |
-| 🟩 CICD Monitor #2 | Run #187 (S21 t5 deploy) | ~110K | PASS | 0 fail (green) | Schema refactor verify all 5 stage |
-| 🟦 Investigator | seeds-only | 0 | n/a | n/a | Em main solo S21 t3-t5 (cross-stack) |
-| 🟨 Implementer | seeds-only | 0 | n/a | n/a | REFUSE 3× per criteria #3/#4 — correct |
-| 🟥 Reviewer | seeds-only | 0 | n/a | n/a | Em main self-review build+test |
-
-CICD Monitor ROI: 100% green = 0 catch but 100% peace of mind, automated verify thay em nhớ verify thủ công (recurring blind spot pattern S20). 2 bonus gotcha learnings saved cross-session.
-
-### Pending S22+ (cumulative carry)
-
-- **Plan C test-after bundle** — defer commit riêng sau UAT 2-3 lần ổn:
-  - Service `ApplyReturnModeAsync` 4 mode read level.Allow* (per-NV)
-  - Service skipToFinal read user.AllowDrafterSkipToFinal (per-Drafter)
-  - Helper `EnsureEditableForDetailsAsync` 3 scenario read level (Drafter scope / Approver match / Approver mismatch → Forbidden)
-  - Regression #44 silent 403 còn nợ (S18 — vi phạm test-before bug fix)
-- **User Management F2 toggle UI** — BE column `Users.AllowDrafterSkipToFinal` sẵn, FE chỉ cần thêm 1 checkbox vào UserEdit dialog (~30 phút). Defer khi admin UAT request.
-- **Plan B Contract V2 wire Mig 30+31** — chưa kick off (PE V2 + per-NV pattern đã proven, ready mirror sang Contract).
-- **Plan D-F-H-I** unchanged (carry from S21 t2 HANDOFF tree).
-
-### Audit định kỳ unchanged
-
-- Lần gần: 2026-05-04 manual
-- Lần kế: **2026-06-01** combined audit (skill + doc drift)
-- Drift sau S21: Mig 27→29 (+2), gotcha 44→46 (+2), memory 16→19 (+3), test 81→84 (+3). Threshold KHÔNG kích hoạt audit sớm.
+**Next S41 (anh main pick):**
+1. **Phase 11 polish** — P11-A wire ApproveV2 + LevelOpinions 4 module (full 5-agent end-to-end)
+2. **Test coverage gaps** — 🟪 test-specialist Gap1 (Holiday UNIQUE CRITICAL) + Gap3 (gotcha #44 regression ~50 LOC)
+3. **Curate 4 agent MEMORY**
+4. **RAG re-ingest** S37-S39
+5. **Phase 9 Ops** (anh main coordinate: SMTP + rotate creds + UAT)
 
 ---
 
-## TL;DR Session 21 turn 5 — Refactor Allow* sang PER-NV (Mig 29 drop Mig 28)
+## S39 (2026-05-29) — ⚙️ INFRA: Opus 4.8 1M + Multi-agent 4→7 + budget +50%
 
-User feedback sau UAT S21 t4 deploy: "Cấu hình cho từng người nhé (chứ ko phải là cho toàn bộ quy trình duyệt), thêm table vào SQL luôn để cấu hình cho dễ."
+Pure infra/governance, 1 commit `fd0554a` (docs CI skip). 7 agent: 🟦 investigator-codebase (internal SQL/EF/grep) + 🟦 investigator-api (external docs/CVE/lib) + 🟨 implementer-backend (.NET) + 🟧 implementer-frontend (FE 2 app) + 🟪 test-specialist (tests/) + 🟥 reviewer + 🟩 cicd-monitor. `model: inherit` (Opus 4.8 1M). 5 RAG MCP/agent. Skill re-distribute (README matrix). 2 gotcha NEW: **#54** (529 Overload spawn fail → em main solo fallback) + **#55** (truncation mid-exploration → brief ≤8K + pre-supply snippet).
+→ detail `docs/changelog/sessions/2026-05-29-S36-S39-phase10-complete-7agent.md`
 
-→ Refactor 6 Allow* options từ workflow-level (Mig 28) sang per-NV scope:
-- **F1 (4 mode Trả lại) + F3 (Edit Section 2)** = 5 flag MOVE xuống `ApprovalWorkflowLevels` (per slot Approver — cùng table với ApproverUserId).
-- **F2 (AllowDrafterSkipToFinal)** MOVE xuống `Users` (per-Drafter user, admin config ở User Management page).
+## S38 (2026-05-28) — 🎊 PHASE 10 COMPLETE 11/11
 
-### Q&A clarify (2 lượt)
-
-| Câu | User chốt |
-|---|---|
-| Scope "từng người" | **Per-Level**: 5 flag (4 F1 + 1 F3) gắn slot Designer. F2 per-Drafter user. |
-| Mig 28 cũ xử lý sao | **Migrate bốc → per-NV bulk + drop**: copy workflow → all Levels của workflow, set TRUE cho Drafter user từng dùng workflow F2, rồi drop 6 column workflow. |
-
-### Chunk A — BE schema + Service refactor (`0366946`)
-
-Mig 29 `RefactorAdvancedOptionsToPerLevelAndDrafterUser` — 4-stage (EF
-auto-generated drop-then-add đã REORDER manual):
-
-1. **ADD 5 column** trên `ApprovalWorkflowLevels` (AllowReturnOneLevel/OneStep/
-   ToAssignee/ToDrafter[default true]/AllowApproverEditDetails)
-2. **ADD 1 column** trên `Users` (AllowDrafterSkipToFinal default false)
-3. **BACKFILL bulk SQL** (preserve admin config Mig 28):
-   ```sql
-   -- Levels: copy workflow.Allow* → all Levels của workflow
-   UPDATE l SET l.AllowReturnOneLevel = w.AllowReturnOneLevel, ...
-   FROM ApprovalWorkflowLevels l
-   INNER JOIN ApprovalWorkflowSteps s ON s.Id = l.ApprovalWorkflowStepId
-   INNER JOIN ApprovalWorkflows w ON w.Id = s.ApprovalWorkflowId;
-
-   -- Users: SET TRUE cho user từng Drafter PE link workflow Allow=true
-   UPDATE u SET u.AllowDrafterSkipToFinal = 1
-   FROM Users u WHERE EXISTS (
-     SELECT 1 FROM PurchaseEvaluations pe
-     INNER JOIN ApprovalWorkflows w ON w.Id = pe.ApprovalWorkflowId
-     WHERE pe.DrafterUserId = u.Id AND w.AllowDrafterSkipToFinal = 1
-   );
-   ```
-4. **DROP 6 column** workflow-level (Mig 28 cleanup)
-
-Domain entity refactor:
-- `ApprovalWorkflow.cs` — REMOVE 6 Allow* (S21 t4 Mig 28 cũ)
-- `ApprovalWorkflowLevel.cs` — ADD 5 Allow* (F1 + F3)
-- `User.cs` — ADD 1 Allow* (F2 AllowDrafterSkipToFinal)
-
-Service refactor `ApplyReturnModeAsync`:
-- Resolve currentLevel slot (CurrentWorkflowStepIndex + CurrentApprovalLevelOrder)
-- Read 5 Allow* từ `currentLevel.AllowXxx` thay vì workflow
-- Drafter mode validate AllowReturnToDrafter của currentLevel
-- V1 legacy phiếu → fallback Drafter tự động
-
-DRAFTER trình refactor:
-- Permission check moved → `drafterUser.AllowDrafterSkipToFinal`
-- `userManager.FindByIdAsync(actorUserId)` get Drafter user entity
-- Admin bypass unchanged
-
-Helper `EnsureEditableForDetailsAsync`:
-- Read `level.AllowApproverEditDetails` thay vì workflow
-- Error message rõ "Cấp Approver hiện tại (Bước X / Cấp Y)"
-
-DTO refactor:
-- `AwLevelDto +5 Allow*` (admin Designer GET per-Level)
-- `AwDefinitionDto -6 Allow*` (no longer workflow-level)
-- `CreateAwLevelInput +5 Allow*` (admin Designer POST per-Level)
-- `ApprovalWorkflowOptionsDto` chỉ còn 5 flag (F2 separate field)
-- `PurchaseEvaluationDetailBundleDto`:
-  - RENAME `WorkflowOptions` → `CurrentLevelOptions`
-  - ADD `DrafterAllowSkipToFinal bool`
-
-GetPe handler populate:
-- currentLevelOptions = 5 Allow* của Cấp hiện tại (null nếu V1 / no pointer)
-- drafterAllowSkipToFinal = User.AllowDrafterSkipToFinal từ DrafterUserId
-
-### Chunk B — FE Admin Designer (`63234b2`)
-
-ApprovalWorkflowsV2Page.tsx:
-- Types: `LevelDto +5 Allow*`, `DefinitionDto -6 Allow*`, `EditLevelEntry +5 Allow*`
-- Helper `makeDefaultLevelEntry(order, userId)` factory với 4 false + AllowReturnToDrafter=true
-- `copyFromDefinition` propagate 5 Allow* từ Levels cũ
-- REMOVE section "Cấu hình nâng cao" workflow-level (amber bg 6 checkbox)
-- REPLACE với info banner violet ngắn "ⓘ Cấu hình quyền duyệt riêng cho từng NV..."
-- Mỗi Level entry (NV row) ADD inline panel amber-50/30 5 checkbox grid-cols-2
-
-fe-user KHÔNG mirror (Designer admin-only).
-
-F2 cần UX riêng ở User Management page → defer commit sau (BE field đã sẵn,
-FE chỉ thêm 1 toggle UserEdit dialog khi admin UAT request).
-
-### Chunk C — FE eOffice (`5ccb2a7`) mirror 2 app
-
-Types:
-- `ApprovalWorkflowOptions` REMOVE allowDrafterSkipToFinal (5 flag)
-- `PeDetailBundle`:
-  - RENAME `workflowOptions → currentLevelOptions`
-  - ADD `drafterAllowSkipToFinal: boolean`
-
-PeWorkflowPanel.tsx:
-- RENAME local `wfOptions → levelOptions`, source `evaluation.currentLevelOptions`
-
-PeDetailTabs.tsx:
-- F3 approverEditMode: read `currentLevelOptions?.allowApproverEditDetails`
-- F2 allowSkipToFinal: read `drafterAllowSkipToFinal` (per-user)
-
-Backward compat:
-- Backfill Mig 29 preserve admin config S21 t4
-- Phiếu V1 legacy → currentLevelOptions=null → fallback chỉ Drafter mode
-- drafterAllowSkipToFinal TRUE chỉ cho user từng Drafter PE link workflow Allow=true
-
-### Chunk D — Docs (this commit)
-
-- `docs/database/schema-diagram.md §14`: title "Mig 22-29, S17-21" + add 5 column
-  Level inline comment + add 1 column User Mig 29 block
-- `docs/STATUS.md` Last updated S21 t5 + 28→29 mig
-- `docs/HANDOFF.md` TL;DR S21 t5 đầy đủ (file này)
-- Session log riêng
-
-### State chốt S21 turn 5
-
-| Metric | Trước (S21 t4) | Sau (S21 t5) | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| **Migrations** | 28 | **29** | **+1** (Mig 29 refactor per-NV) |
-| Endpoints | ~143 | ~143 | 0 (same body, different schema) |
-| FE pages | 34 | 34 | 0 |
-| Unit tests | 84 | 84 | 0 (UAT defer test-after §7) |
-| Gotchas | 45 | 45 | 0 |
-| Memory | 17 | 17 | 0 |
-| Skills | 6 | 6 | 0 |
-| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
-| **Commits S21 t5** | — | **4** | `0366946` → `63234b2` → `5ccb2a7` → this |
-
-### Pending — defer / next session
-
-- **User Management page F2 toggle**: thêm checkbox "Cho phép gửi PE thẳng Cấp cuối"
-  vào UserEdit dialog (BE column sẵn, FE 1 toggle nhỏ — defer khi admin UAT request)
-- **Test-after carry** (Plan C bundle): Service ApplyReturnModeAsync 4 mode +
-  EnsureEditableForDetailsAsync 3 scenario read-from-level + skipToFinal read-from-user
+Mig 39+40 + BE ~1100 LOC mega + FE 5 file × 2 app SHA256 IDENTICAL + 8 menu. Run #247 PASS 3m25s. G-O4 Đơn từ + G-O5 Đặt xe + G-O6 Ticket CNTT + G-P1 Chấm công + G-H3 Dashboard NS (SKELETON combo). Trade-off rõ commit: ApproveV2 advance level + LevelOpinions + LeaveBalance + CodeGen atomic + Vehicle/Driver catalog + auto-assign/SLA **DEFER Phase 11**. NEW prod: sidebar Văn phòng số 11 sub-menu + Nhân sự Dashboard + GPS check-in + ticket kanban.
+→ same session log
 
 ---
 
-## TL;DR Session 21 turn 4 — F1+F2+F3 PE Workflow advanced options (Mig 28)
-
-User request 3 tính năng mới trong PE V2 Workflow:
-- **F1** 4 mode Trả lại admin stick: 1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo
-- **F2** Drafter gửi thẳng Cấp cuối (skip mọi Bước/Cấp trung gian)
-- **F3** Approver chỉnh sửa Section 2 (Hạng mục + NCC + Báo giá) khi đang duyệt
-
-### Q&A clarify chốt scope (2 lượt AskUserQuestion)
-
-- **F1 "1 bậc"** = cả 2 mode (admin chọn 1 Cấp HOẶC 1 Bước HOẶC cả 2 stick)
-- **F1 "Người chỉ định"** = Approver pick runtime từ list NV đã ký (PE.LevelOpinions)
-- **F1 behavior** = 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain). Mode Drafter giữ Phase=TraLai S17 fallback.
-- **F2 skip** = chỉ skip tới Level cuối (CEO) — Dropdown 2 option "Gửi tuần tự" vs "Gửi thẳng Cấp cuối"
-- **F2+F3 admin enable** = cả 2 cần admin tick per workflow (audit nghiêm)
-- **F3 approver perm** = mọi approver Cấp đang active (currentLevel match)
-- **F3 scope** = Section 2 only (Hạng mục + NCC + Báo giá), KHÔNG đụng PE Header, KHÔNG reset workflow
-- **Test** = test-after UAT default Phase 9 (skip dotnet test mỗi chunk, npm build × 2 app pass)
-
-### Chunk A — Mig 28 + Domain (`0294693`)
-
-`ApprovalWorkflow.cs` thêm 6 bool field:
-- `AllowReturnOneLevel` / `AllowReturnOneStep` / `AllowReturnToAssignee` (default false)
-- `AllowReturnToDrafter` (default **TRUE** — backward compat S17)
-- `AllowDrafterSkipToFinal` / `AllowApproverEditDetails` (default false)
-
-EF config `ApprovalWorkflowConfiguration` thêm 6 `HasDefaultValue` match Mig 28 DEFAULT.
-
-Mig 28 `AddAdvancedOptionsToApprovalWorkflows`:
-- 6 AddColumn bit NOT NULL DEFAULT 0/1
-- 3-file rule complete (mig.cs + Designer.cs + Snapshot.cs)
-- Apply LocalDB Dev + Design
-
-### Chunk B — BE Service + handlers + DTOs (`c56024b`)
-
-**Service interface + impl** `TransitionAsync` thêm 3 optional param (backward compat):
-- `WorkflowReturnMode? returnMode` (enum {OneLevel=1, OneStep=2, Assignee=3, Drafter=4})
-- `Guid? returnTargetUserId` (required khi mode=Assignee)
-- `bool skipToFinal`
-
-REJECT branch extend với helper `ApplyReturnModeAsync` switch 4 mode:
-- OneLevel: lùi 1 Cấp cùng Step. Bước 1 Cấp 1 → fallback Drafter.
-- OneStep: lùi sang Bước trước Cấp cuối. Bước 1 → fallback Drafter.
-- Assignee: tìm Step+Level match `ApproverUserId == returnTargetUserId`.
-- Drafter: Phase=TraLai clear pointer (S17 behavior).
-- 3 mode đầu giữ ChoDuyet + reset SLA 7d.
-- Admin bypass workflow.Allow* flag check.
-- Non-admin → throw ConflictException nếu flag disabled.
-
-DRAFTER trình branch extend với F2 skipToFinal:
-- Workflow.AllowDrafterSkipToFinal required (non-admin)
-- Set CurrentWorkflowStepIndex = Steps.Count-1 + CurrentApprovalLevelOrder = max Level
-- Audit comment append "[Drafter gửi thẳng Cấp cuối]"
-
-**Helper edit guard** `EnsureEditableForDetailsAsync` mới (PurchaseEvaluationDraftGuard class):
-- Drafter scope: DangSoanThao OR TraLai
-- F3 Approver scope: ChoDuyet + workflow.AllowApproverEditDetails + actor match CurrentLevel.ApproverUserId
-- Admin bypass workflow flag check
-
-**8 handler switch** sang helper mới + inject ICurrentUser khi cần:
-- Detail Add/Update/Delete + Quote Upsert/Delete (5 handler — replace EnsureDraftAsync)
-- Supplier Add/Update/Remove (3 handler — bonus security fix, trước đây hoàn toàn KHÔNG có phase guard!)
-- Update/Delete handler trước đây silent → thêm changelog `PhaseAtChange + UserId + Summary` (append `[Approver edit khi đang duyệt]` khi phase=ChoDuyet)
-
-**Command DTO + DTOs**:
-- `TransitionPurchaseEvaluationCommand` +3 optional field
-- `ApprovalWorkflowOptionsDto` NEW sub-record (6 Allow* flag)
-- `PurchaseEvaluationDetailBundleDto` +WorkflowOptions field
-- `AwDefinitionDto` +6 Allow* (admin Designer GET)
-- `CreateAwDefinitionCommand` +6 Allow* param (admin Designer POST)
-
-### Chunk C — FE Admin Designer (`a508564`)
-
-`ApprovalWorkflowsV2Page.tsx` Designer modal thêm section "Cấu hình nâng cao" 3 sub-group:
-
-1. Mode Trả lại 4 checkbox:
-   - Trả về 1 Cấp trước (peer review chain trong cùng Bước)
-   - Trả về 1 Bước trước (Cấp cuối Bước trước nhận lại)
-   - Trả về Người chỉ định (pick runtime từ NV đã ký)
-   - Trả về Người soạn thảo (default checked = backward compat S17)
-
-2. Drafter skip: 1 checkbox "Cho phép Drafter gửi thẳng Cấp cuối"
-
-3. Approver edit: 1 checkbox "Cho phép Approver chỉnh sửa Section 2"
-
-Styling: container amber-50/30 border distinct với Steps section. Helper text [10px] dưới label. Headers uppercase tracking.
-
-DTO types + state defaults từ cloneFrom (giữ config version trước) hoặc S17 fallback (chỉ AllowReturnToDrafter=true). POST body propagate 6 flag → BE Create handler set entity.
-
-fe-user KHÔNG mirror (Designer admin-only).
-
-### Chunk D — FE eOffice (`d27caaf`) mirror 2 app
-
-Types `purchaseEvaluation.ts`:
-- `ApprovalWorkflowOptions` type
-- `WorkflowReturnMode` const-object
-- `PeDetailBundle` +workflowOptions field
-
-`PeWorkflowPanel.tsx` F1 Trả lại radio picker:
-- State `returnMode` (default Drafter) + `returnTargetUserId`
-- Dialog Trả lại render 1-4 radio mode enabled theo wfOptions.Allow*
-- Assignee mode → submodal Select pick từ levelOpinions (NV đã ký), dedupe by userId
-- Banner amber rounded dưới mô tả hành vi mode chọn
-- Mutation payload +returnMode +returnTargetUserId khi isTraLaiAction
-
-`PeDetailTabs.tsx` F2 Drafter skip:
-- State `skipToFinal` + `allowSkipToFinal` từ workflowOptions
-- submitForApproval mutationFn accept opts.skipToFinal
-- Workspace action bar: checkbox violet "Gửi thẳng Cấp cuối (skip trung gian)" conditional
-- Confirm dialog message + button label dynamic theo skipToFinal
-
-`PeDetailTabs.tsx` F3 Approver edit Section 2:
-- useAuth import + compute `approverEditMode` (phase=ChoDuyet + workflowOptions.allowApproverEditDetails + actor match)
-- `itemsReadOnly = readOnly && !approverEditMode` → ItemsTab nhận
-- Banner violet "ⓘ Bạn được phép chỉnh sửa..." khi approverEditMode + readOnly (Duyệt menu)
-- InfoTab / NccSelectorRow / BudgetFieldRow GIỮ strict isEditablePhase (Header + Section 3, KHÔNG trong F3 scope)
-
-### Chunk E — Docs (this commit)
-
-- `docs/database/schema-diagram.md §14` cập nhật title "Mig 22-28, S17-21" + thêm 6 column Allow* trong Core block với inline comment F1/F2/F3
-- `docs/STATUS.md` Last updated S21 t4 + count 27→28 mig + UAT defer test count unchanged 84
-- `docs/HANDOFF.md` TL;DR S21 t4 đầy đủ (file này)
-- `docs/changelog/sessions/2026-05-13-1200-s21-turn4-pe-workflow-advanced-options.md` session log
-
-### State chốt S21 turn 4
-
-| Metric | Trước (S21 t3) | Sau (S21 t4) | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| **Migrations** | 27 | **28** | **+1** (Mig 28 6 column Allow*) |
-| Endpoints | ~142 | ~143 | +1 (extend transitions body) |
-| FE pages | 34 | 34 | 0 (Designer extend section) |
-| **Unit tests** | 84 | **84** | 0 (UAT defer test-after §7) |
-| Gotchas | 45 | 45 | 0 |
-| Memory entries | 17 | 17 | 0 |
-| Skills | 6 | 6 | 0 |
-| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
-| **Commits S21 t4** | — | **5** | (`0294693` → `c56024b` → `a508564` → `d27caaf` → this) |
-
-### Pending — Test-after (Plan C carry)
-
-Per `feedback_uat_skip_verify` Phase 9 default: viết test sau UAT 2-3 lần ổn.
-Test scope candidate (test-after-uat commit riêng):
-- Service `ApplyReturnModeAsync` 4 mode happy path (OneLevel/OneStep/Assignee/Drafter)
-- Service skipToFinal happy path + AllowDrafterSkipToFinal=false → ConflictException
-- `EnsureEditableForDetailsAsync` 3 scenario: Drafter scope / Approver match / Approver mismatch → Forbidden
-
-Bundle với Plan C existing (test #44 silent 403 + test V2 ApproveV2Async + Mig 25/27 PATCH).
-
----
-
-## TL;DR Session 21 turn 3 — Bug fix CRITICAL "Trả về nhưng hệ thống vẫn duyệt" (gotcha #45)
-
-User UAT 2026-05-12 21:00 screenshot button labeled `← Trả lại` trong PE Workflow Panel (menu "Duyệt"), mô tả hành vi: nhấn vào nhưng phiếu KHÔNG về phase TraLai — ngược lại tiến qua Cấp tiếp theo. User mô tả: "Trả về nhưng hệ thống vẫn duyệt".
-
-### Diagnose (em main solo, no agent spawn)
-
-3 chỗ inconsistency cùng pattern trong `PeWorkflowPanel.tsx` (× 2 app fe-admin + fe-user):
-
-| # | Location | Logic | Bug? |
-|---|---|---|---|
-| 1 | L205-207 button `isSendBack` | include TraLai → label `← Trả lại` ĐÚNG | ✅ no bug |
-| 2 | L64-66 payload `isReject` | thiếu nhánh TraLai → gửi `decision: 1` (Approve) | 🔴 BUG ROOT |
-| 3 | L247-248 dialog `isSendBack` | thiếu nhánh TraLai → dialog title fallback `'✓ Duyệt → Trả lại'` + no amber warning | 🔴 BUG phụ |
-
-BE `PurchaseEvaluationWorkflowService.TransitionAsync`:
-- L51 `if (decision == Reject)` branch → đúng cho decision=Reject.
-- L97 `APPROVE STEP` branch khi decision=Approve + fromPhase=ChoDuyet → ApproveV2Async UPSERT opinion + advance Cấp.
-- → FE gửi `decision=1` (do bug `isReject`) → BE đi vào nhánh APPROVE thay vì REJECT → phiếu approve mặc dù user định trả lại.
-
-### Chunk A — BE defense-in-depth + 3 regression test (`de00887`)
-
-**Test-before §7 BẮT BUỘC:** Viết test reproduce bug TRƯỚC fix.
-
-```csharp
-// Sau line 48 (set isAdmin/isSystem), trước REJECT branch (L51)
-if ((targetPhase == PurchaseEvaluationPhase.TraLai
-        || targetPhase == PurchaseEvaluationPhase.TuChoi)
-    && decision != ApprovalDecision.Reject)
-{
-    throw new ConflictException(
-        $"Transition tới {targetPhase} BẮT BUỘC decision=Reject (nhận {decision}). " +
-        "Báo lỗi caller — payload mismatch giữa target phase và decision.");
-}
-```
-
-Boundary protection cho mọi caller tương lai (API client / mobile / cron retry). Guard KHÔNG xoá khi FE fix — defense-in-depth.
-
-3 test file `tests/SolutionErp.Infrastructure.Tests/Services/PurchaseEvaluationWorkflowServiceGuardTests.cs`:
-- `TransitionAsync_TargetTraLai_WithApproveDecision_Throws_AndDoesNotMutateState` — reproduce bug, expect `ConflictException` "*TraLai*Reject*"
-- `TransitionAsync_TargetTuChoi_WithApproveDecision_Throws_AndDoesNotMutateState` — consistency cover TuChoi
-- `TransitionAsync_TargetTraLai_WithRejectDecision_SetsPhaseTraLai` — happy path control (Reject branch vẫn đúng)
-
-+ `NoOpNotificationService` stub reusable cho future PE service tests (avoid `INotificationService` real DI complexity).
-
-Run test → 2 FAIL (reproduce bug, BE đi sâu vào ApproveV2Async throw "Phiếu chưa pin workflow") + 1 PASS (happy path). Thêm BE guard → 3 PASS. Tổng `dotnet test SolutionErp.slnx` 84 PASS (+3 from 81 baseline).
-
-### Chunk B — FE fix mirror 2 app (`4b29d00`)
-
-3 chỗ × 2 app = 6 edits:
-
-```typescript
-// Chỗ 1: isReject payload (L64-66)
-const isReject = target === PurchaseEvaluationPhase.TuChoi
-  || (target === PurchaseEvaluationPhase.DangSoanThao
-      && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao)
-  || (target === PurchaseEvaluationPhase.TraLai             // ← THÊM
-      && evaluation.phase !== PurchaseEvaluationPhase.TraLai)
-
-// Chỗ 3: dialog isSendBack (L247-248)
-const isSendBack = (target === PurchaseEvaluationPhase.DangSoanThao
-                    || target === PurchaseEvaluationPhase.TraLai)   // ← THÊM
-  && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao
-  && evaluation.phase !== PurchaseEvaluationPhase.TraLai             // ← THÊM
-```
-
-Chỗ 2 (button label `isSendBack` L205-207) đã đúng từ S17, KHÔNG đụng.
-
-Verify: `npm run build` × 2 app pass (fe-user 17.91s + fe-admin 6.71s, 0 TS6 err).
-
-### Chunk C — Docs (this commit)
-
-- `docs/gotchas.md` +#45 PE button label vs decision payload mismatch (~120 dòng narrative + 2 commit cross-ref + pattern reusable + phòng tránh tương lai)
-- `docs/gotchas.md` checklist debug +entry 22 quick lookup
-- `docs/STATUS.md` Last updated S21 t3 + count 81→84 test + 44→45 gotcha
-- `docs/HANDOFF.md` TL;DR S21 t3 narrative đầy đủ (file này)
-- `docs/changelog/sessions/2026-05-12-2100-s21-turn3-fix-tra-lai-bug45.md` session log mới
-
-### Pending (carry from S21 turn 2)
-
-Plans A-I unchanged. Plan C1 (test regression gotcha #44 silent 403 S18) vẫn còn nợ — không bundle với S21 t3 fix (scope khác, ưu tiên unblock UAT bug critical trước).
-
-### Audit cadence
-
-- Lần gần nhất: 2026-05-04 manual trễ 4 ngày
-- Lần kế: **2026-06-01** combined audit
-- Drift sau S21 t3: 44→45 gotcha (+1) + 81→84 test (+3) + 17→17 memory (no new) + 6 skills unchanged
-
-### State chốt S21 turn 3
-
-| Metric | Trước (S21 t2) | Sau (S21 t3) | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| Migrations | 27 | 27 | 0 |
-| Endpoints | ~142 | ~142 | 0 |
-| FE pages | 34 | 34 | 0 |
-| **Unit tests** | 81 | **84** | **+3** (PE guard) |
-| **Gotchas** | 44 | **45** | **+1** (#45) |
-| Memory entries | 17 | 17 | 0 |
-| Skills | 6 | 6 | 0 |
-| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
-| **Commits S21 t3** | — | **3** | (`de00887` + `4b29d00` + this) |
-
----
-
-## TL;DR Session 21 turn 2 — RAG Hybrid setup planning (Cách A chốt + 3-layer pattern)
-
-User clarify 5 dự án future > 1M MD tokens → cuộc thảo luận deep ~15 turn về RAG infrastructure. Em main solo (no SOLUTION_ERP sub-agent spawn), delegate 2 lần claude-code-guide agent research Anthropic + community practice.
-
-### Q&A deep dive 10 topics
-
-1. RAG fundamentals + Vector DB role (Qdrant)
-2. Embedding "AI nhúng" + Voyage AI cost mechanics ($0.18/M tokens)
-3. Multi-project shared architecture (5 projects → single Qdrant + per-collection)
-4. Audit procedure 3-tier (weekly auto + monthly deep + quarterly major)
-5. UI/UX Streamlit dashboard 7 pages design
-6. Cách A defensive (giữ blanket 120K) vs Cách B aggressive (cắt 60-70%)
-7. Reasoning depth comparison: lazy 60% → A 90% → B 75-80%
-8. Industry validation: Anthropic + Cursor + Continue + Cline + Aider all hybrid
-9. Multi-agent cost reality: 8-10× multiplier, ~520K cumulative blanket 5 entities
-10. 3-layer hybrid pattern (Anthropic Contextual Retrieval Sept 2024)
-
-### Quyết định chốt — Cách A vs Cách B
-
-**Chọn Cách A** (defensive hybrid):
-- Blanket: GIỮ NGUYÊN 120K em main + RAG retrieve supplement
-- Sub-agent spawn baseline: ~80-100K each (4 agents = ~400K cumulative)
-- Heavy session billed: ~560K (saving -20% vs lazy 700K)
-- Quality recall: ~85% (vs Cách B 75-80% do fragmentation)
-
-**Why Cách A** (bro priority chốt):
-- ✅ Em main control flow strong (state ownership direct, response fast)
-- ✅ Decision quality 90% (multi-source cohesive reasoning)
-- ✅ Wall-clock per task -20% (12 phút vs Cách B 16 phút)
-- ✅ Risk-averse (graceful fallback blanket nếu RAG fail)
-- ✅ Multi-agent leverage cache 70-90% hit common queries
-- ✅ Industry-validated (Anthropic + Cursor + Continue + Cline + Aider)
-
-### 3-layer hybrid Phase rollout (Anthropic Contextual Retrieval)
-
-| Phase | Layers | Recall | Cost/mo |
-|---|---|---|---|
-| Phase 1 (Week 1-4) | Vector embedding only (Voyage-3-large) | ~70% | ~$1.50 |
-| Phase 2 (Month 2) | + BM25 hybrid (bm25s free local) | ~78% | ~$1.50 |
-| Phase 3 (Month 3) | + Voyage rerank-2 + Contextual prefix | ~92% | ~$4-5 |
-
-### Stack validated cross-industry
-
-- Voyage AI embedding (Anthropic partner, multilingual 26 lang)
-- Qdrant local (Rust binary, "leading agent memory backend 2026")
-- FastMCP Python (official Anthropic SDK)
-- SQLite event log + Streamlit dashboard 7 pages
-- Pre-commit hook re-index delta
-
-### Multi-agent cost reality (Anthropic warn 8-10× multiplier)
-
-```
-Per entity blanket Cách A:
-  Em main: ~120K
-  4 sub-agents × ~100K spawn = 400K cumulative
-  Total: ~520K cumulative billed (not single context window)
-
-Heavy session 4-agent spawn:
-  Lazy: ~700K effective billed
-  Cách A: ~560K (-20% from multi-agent shared cache)
-```
-
-### Plan I NEW — RAG Setup Implementation (defer)
-
-**Trigger:** Bro confirm 5 dự án path + stack + pilot choice + Voyage API key + disk cleanup 5-8GB.
-
-**Schedule:** Dedicated session 10-14h weekend (per `feedback_drastic_refactor_scope`).
-
-**Phase rollout:**
-- Phase 1 single project pilot 4-week trial
-- Phase 2-3 upgrade incremental conditional on Phase 1 success
-- Cost realistic: ~$2-5/month total cho 5 projects
-
-### Deliverables
-
-- ✅ `docs/rag-setup-plan.md` (commit `1f8e9af` 1223 LOC + extend S21 t2 ~300 LOC = ~1500 LOC final)
-- ✅ Memory `feedback_rag_hybrid_pattern.md` (NEW cross-project reusable)
-- ✅ MEMORY.md index +1 entry
-- ✅ Session log this chốt
-- ⏭ Implementation defer chờ trigger
-
-### Em main solo S21 turn 2 (no SOLUTION_ERP sub-agent spawn)
-
-3 spawn này session — KHÔNG phải 4 SOLUTION_ERP sub-agents:
-- claude-code-guide × 2 (generic agent for Anthropic + industry research)
-- 4 SOLUTION_ERP sub-agents (Inv/Imp/Rev/CICD) vẫn seeds-only
-
-### State chốt S21 turn 2
-
-| Metric | Trước | Sau | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| Migrations | 27 | 27 | 0 |
-| Endpoints | ~142 | ~142 | 0 |
-| FE pages | 34 | 34 | 0 |
-| Unit tests | 81 | 81 | 0 |
-| Gotchas | 44 | 44 | 0 |
-| **Memory entries** | 16 | **17** | **+1** (RAG hybrid pattern) |
-| Skills | 6 | 6 | 0 |
-| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
-| **Commits S21 cumulative** | 2 | **4** | **+2** |
-| **Plan files** | 0 | **1** (`rag-setup-plan.md`) | **+1** |
-
----
-
-## TL;DR Session 21 turn 1 — Add cicd-monitor (4th sub-agent, Path A chốt)
-
-User chốt Path A sau pre-flight Plan G Trial Week 1 (S20 wrap đã setup 3 agents Inv/Imp/Rev): thêm sub-agent thứ 4 chuyên post-deploy verify (Gitea Actions poll + bundle hash × 2 app + sqlcmd mig prod + endpoint smoke). **Trade-off chốt:** +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động — recurring blind spot pattern em main solo S20 quên verify ~30% push.
-
-### Em main solo S21 turn 1 (no agent spawn)
-
-1 turn từ S20 wrap chiều/đêm 2026-05-11 22:00 sang sáng/đêm 2026-05-12. Em main solo qua context paste + Write file. **3 agents (Inv/Imp/Rev) KHÔNG spawn**, vẫn seeds-only state. cicd-monitor mới setup file (Write), chưa spawn work.
-
-### Deliverables (1 commit `f1c61c9`, 456 +/-23 LOC)
-
-| File | Loại | LOC |
-|---|---|---|
-| `.claude/agents/cicd-monitor.md` | NEW system prompt (~7KB) | ~200 |
-| `.claude/agent-memory/cicd-monitor/MEMORY.md` | NEW seed (~5KB) | ~150 |
-| `.claude/agents/README.md` | UPDATE 4-agent architecture | +~80 / -23 |
-| `feedback_multi_agent_setup.md` (user-level memory) | UPDATE 3 → 4 agents | +12 / -6 |
-
-### Q&A chốt scope (Path A vs B)
-
-- **Path A (chọn):** cicd-monitor READ tier (~150K/spawn) — catch fail tự động
-- **Path B (bỏ):** Em main thêm checklist verify manual (~0 cost) — phụ thuộc memory + recurring miss
-- **Decision rationale:** Recurring blind spot S20 ~30% push quên verify → tự động hóa worth +150K trade-off
-
-### CI skipped (gotcha #41 path filter)
-
-3 file `.md` → match `paths-ignore: '**/*.md'` → CI không trigger → prod IIS không thay đổi. Đây là **expected behavior** — agent infrastructure là local Claude Code only, KHÔNG cần deploy lên prod IIS. Khi spawn agent đọc file `.md` từ local filesystem.
-
-### State chốt S21 turn 1
-
-| Metric | Trước S21 | Sau S21 t1 | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| Migrations | 27 | 27 | 0 |
-| Endpoints | ~142 | ~142 | 0 |
-| FE pages | 34 | 34 | 0 |
-| Unit tests | 81 | 81 | 0 (no test added) |
-| Gotchas | 44 | 44 | 0 |
-| Memory entries | 16 | 16 | 0 (update existing entry only) |
-| Skills | 6 | 6 | 0 |
-| **Sub-agents** | **3 seeds-only** | **4 seeds-only** | **+1 cicd-monitor green** |
-| Commits S21 | — | **1** | (`f1c61c9`) |
-
-### Plan G (Multi-agent Trial 4-week) update post-S21 t1
-
-- ✅ **Setup phase complete**: 3 agents S20 t12 + 1 agent S21 t1 → 4 sub-agents seeds-only ready
-- ⏳ **Week 1 pending**: Plan B Contract V2 wire Mig 28+29 — kick-off Session 21 turn 2+
-- ⏳ **Pass criteria updated**: Rev catch ≥ 2 wire bugs + **CI/CD Monitor catch ≥ 1 deploy ship fail** (bundle hash unchanged / mig drift) + saving ≥ 25% Case 1+2 + Max 20× quota comfortable
-
-### Next session priority unchanged (carry from S20 wrap)
-
-- **Plan B** (HIGH) Contract V2 wire — Trial Week 1 kick-off với 4 agents
-- **Plan C** (HIGH) Test gap fill (B4 silent 403 + Mig 25/26/27 PATCH) — bundle Chunk E Plan B
-- **Plan D** Hard blockers ops (UAT/SMTP/creds/backup)
-- **Plan E** Phân quyền strict V2 + drop legacy V1
-- **Plan F** Audit định kỳ 2026-06-01 (chưa đến — KHÔNG tự chạy)
-
-### Cost reality update
-
-| Metric | Trước (3 agents) | Sau (4 agents) |
-|---|---|---|
-| Spawn setup total | ~564K | **~750K** (+150K cicd-monitor) |
-| Heavy session | ~1.2M (~6× solo) | **~1.35M (~6.5× solo)** |
-| Optimized cached | ~600K (~3× solo) | **~700K (~3.5× solo)** |
-
-Max 20× plan absorbs ~3.5× solo cost comfortable.
-
----
-
-## TL;DR Session 20 WRAP (turns 1-12 chốt 2026-05-11)
-
-User UAT live iteration liên tục — 12 turns trong 1 ngày (sáng-trưa-chiều-tối-đêm). 14 commit cumulative.
-
-### 3 chủ đề lớn
-
-1. **PE Detail UI restructure** (turns 1-5 + 6 + 8-10): User yêu cầu 3 polish UX core + 4 polish nhỏ.
-   - Turn 1-5 wrap commit `9dee00d→f2f01f4→f8e5675`: Section reorder (Hạng mục lên #2 + auto-seed 1 row từ gói thầu) → Nested grid HangMucCard NCC expand (drop SuppliersTab dead code) → Section Ý kiến gộp đồng cấp 1 box / Step
-   - Turn 6 `f568945`: Manual budget "Nhập tay" drop tên field, chỉ giữ số tiền + VND format
-   - Turn 8-10: NCC palette 5-màu cycle + Winner icon ✓ đậm + hover transition + AddSupplier auto-fill master data 4 field
-2. **Admin menu eOffice management** (turn 7): Mig 27 `IsVisible + DisplayLabel` cột MenuItem + PATCH `/api/menus/{key}` + NEW `MenuVisibilityPage` ~210 LOC + fe-user Layout filter !isVisible + render `displayLabel || label`. Admin sidebar luôn dùng Label gốc (Q2=b).
-3. **Infrastructure** (turns 11-12):
-   - Turn 11 responsive 4-tầng pattern cho laptop nhỏ → memory `feedback_responsive_laptop_breakpoint.md`
-   - Turn 12 SETUP 3 sub-agents (Investigator + Implementer + Reviewer) + em main coordinator → memory `feedback_multi_agent_setup.md`
-
-### Stats cumulative
-
-| Metric | Trước S20 | Sau S20 | Δ |
-|---|---|---|---|
-| DB tables | 59 | 59 | 0 |
-| Migrations | 26 | **27** | +1 (Mig 27 menu visibility) |
-| Endpoints | ~141 | **~142** | +1 (PATCH /menus/{key}) |
-| FE pages | 33 | **34** | +1 (MenuVisibilityPage) |
-| Menu keys | ~60 | **~61** | +1 (MenuVisibility) |
-| Unit tests | 81 | 81 | 0 (Phase 9 UAT defer §7) |
-| Gotchas | 44 | 44 | 0 |
-| Memory entries | 14 | **16** | +2 (responsive t11 + multi-agent t12) |
-| Skills | 6 | 6 | 0 |
-| Sub-agents | 0 | **3** | +3 (Inv + Imp + Rev seeds) |
-| Commits S20 | — | **14** | (`9dee00d` → `ae1814c`) |
-
-### Multi-agent state chốt session
-
-3 sub-agents vừa setup turn 12 → **seeds-only state, chưa spawn work**. KHÔNG có findings để flush cross-agent learnings ở session này.
-
-**Trial Week 1 sẽ kick off Session 21:**
-- Investigator pre-flight: audit PE V2 schema patterns (Mig 22-27) + Permission flow → spec Contract V2
-- Implementer Chunk A-E (Mig 28 ALTER Contract + Mig 29 ContractLevelOpinions + Service ApproveV2Async + Controller + FE mirror)
-- Reviewer pre-commit verify gotcha #42 (V1/V2 dual schema branch)
-- Em main: architecture decisions + scope refusals + final synthesize
-
-### Memory entries mới capture S20
-
-1. `feedback_responsive_laptop_breakpoint.md` (t11) — 4-tầng pattern: sidebar w-60 xl:w-72 + workspace 2-panel lg:260 xl:320 + Section padding xs/sm responsive + Card flex-wrap. Phân biệt `lg` vs `xl` breakpoint quan trọng cho laptop nhỏ.
-2. `feedback_multi_agent_setup.md` (t12) — Decision gate 6-criteria. Anthropic + Cognition hybrid. Implementer ACCEPT/REFUSE strict rules. Windows MAX_PATH pitfall (drop isolation worktree). NAMGROUP s41-s43 ROI curve.
-
-### Pending Session 21+ (cumulative carry over)
-
-**Plan cha B (HIGH priority) — Contract V2 wire Mig 28+29:** mirror PE pattern S17-S19 + S20 turn 7. Audit-reuse memory `feedback_audit_reuse_before_clone` áp dụng — discriminator `ApplicableType.Contract=3` đã chung 80% với PE schema V2. 6-task plan:
-- Task 1: Mig 28 ALTER `Contract.ApprovalWorkflowId? + CurrentApprovalLevelOrder?`
-- Task 2: Mig 29 CREATE `ContractLevelOpinions` (mirror PE Mig 26 UNIQUE + FK Cascade/Restrict)
-- Task 3: `ContractWorkflowService.ApproveV2Async` branch + UPSERT opinion
-- Task 4: `ContractCreatePage` Workspace Select V2 (validate ApplicableType=3)
-- Task 5: Pin V2 mặc định cho ContractType qua Designer (admin)
-- Task 6: `ContractDetailContent` Section "Ý kiến cấp duyệt" V2 dynamic mirror S20 Chunk C
-
-**Plan cha C (HIGH priority) — Test coverage gap fill (§7):**
-- Test regression B4 silent 403 S18 (HIGH — vi phạm rule §7 test-before bug fix)
-- Test V2 Service wire `ApproveV2Async` UPSERT opinion (Mig 26) + Section gộp render (S20 t1-5 Chunk C)
-- Test Mig 25 PATCH `/user-selectable` endpoint
-- Test PATCH `/api/menus/{key}` Mig 27 (mới)
-
-**Plan cha D — Hard blockers ops (chờ user/ops):** UAT thật 1 tuần / SMTP / Rotate creds / SQL backup schedule / win-acme fix / remove `.huypham.vn` binding
-
-**Plan cha E — Phân quyền strict V2 + drop legacy V1:**
-- List/Inbox/Detail filter actor scope (V2 đã đúng — `ResolveV2InboxIdsAsync`)
-- Drop tables V1 sau UAT confirm: WorkflowDefinitions/Steps/Approvers + column RejectedAtStepIndex/RejectedFromPhase
-- Mig 30 drop Mig 15 PurchaseEvaluationDepartmentOpinions cleanup
-
-**Plan cha F — Audit định kỳ 2026-06-01:** skill stale (`ef-core-migration` "21" → 27 / `dependency-audit-erp` 41 → 44) + `schema-diagram` §16-21 + memory consolidate xem có duplicate
-
-**Plan cha G NEW — Multi-agent trial 4 tuần (Week 1-4):** evaluate ROI keep/tune/archive 3 sub-agents
-
-### Audit cadence
-
-- Lần gần nhất: 2026-05-04 manual trễ 4 ngày
-- Lần kế: **2026-06-01** combined audit
-- Drift sau S20: Mig 27 + 1 menu key + +2 memory entries + 3 sub-agents NEW + (no gotcha new). `ef-core-migration` skill "21 migration" stale → thực 27 sau S20 t12
-
-## TL;DR Session 20 turn 7 — Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27)
-
-User UAT live yêu cầu thêm tính năng admin quản lý menu eOffice (fe-user) — Ẩn/Hiện + Đổi tên hiển thị. Hỏi xác nhận "chưa có?" → đúng, chưa có. User clarify **Q2=b "edit hiển thị bên ngoài, chỉ của eOffice thôi"** → admin sidebar luôn dùng Label gốc, DisplayLabel CHỈ áp render fe-user.
-
-### Q&A chốt scope
-
-- Q1=**a** Global (không per-role — permission matrix đã handle)
-- Q2=**b** DisplayLabel chỉ fe-user, admin sidebar giữ Label gốc
-- Q3=**a** Giữ USER_HIDDEN_KEYS hardcode + tầng IsVisible dynamic combine
-- Q4=ok UAT iteration skip test, vẫn npm build mỗi chunk
-
-### Chunk A (`2ea2d27`) — Schema + Migration 27
-
-Domain MenuItem +IsVisible bool=true +DisplayLabel string?(200). EF config HasDefaultValue(true) + HasMaxLength(200). Migration 27 AddVisibilityAndDisplayLabelToMenuItems (2 AddColumn) — 3-file rule. Apply LocalDB Dev + Design qua --connection override.
-
-### Chunk B (`ef394f8`) — BE API
-
-DTO MenuNodeDto + MenuItemDto +isVisible +displayLabel. GetMyMenuTreeQueryHandler pass through (KHÔNG filter server-side — 2 FE app tự quyết render). NEW UpdateMenuItemCommand + Validator (Key required + DisplayLabel max 200) + Handler (whitespace → null). MenusController +PATCH /api/menus/{key} [Authorize Policy="Permissions.Update"].
-
-### Chunk C (`059bfcb`) — FE Admin MenuVisibilityPage
-
-Domain MenuKeys +MenuVisibility. DbInitializer +leaf System/MenuVisibility (Eye, Order=94). FE Admin: types/menu.ts mirror, lib/menuKeys.ts +const, Layout resolver +/system/menu-visibility, App.tsx +Route. NEW pages/system/MenuVisibilityPage.tsx ~210 LOC:
-- PageHeader + description nhắc admin sidebar dùng Tên gốc
-- 4 StatCard (Tổng / Hiển thị / Đã ẩn / Đã đổi tên)
-- Search box (key | label | displayLabel)
-- Table 5 cột: Key mono + parentKey ↳ / Tên gốc / Input "Tên hiển thị" inline (placeholder "Mặc định: {label}") / Toggle button emerald-Eye / amber-EyeOff / Lưu (khi dirty) + Khôi phục (khi custom)
-- onSuccess invalidate `['menus','all']` + `['my-menu']` → live update
-
-### Chunk D (`1ed6530`) — fe-user Layout filter + render
-
-types/menu.ts mirror. Layout.tsx:
-```tsx
-function filterForUser(nodes: MenuNode[]) {
-  // 2 tầng: hardcode USER_HIDDEN_KEYS + dynamic !isVisible
-  return nodes.filter(n => !USER_HIDDEN_KEYS.has(n.key) && n.isVisible !== false)
-              .map(n => ({ ...n, children: filterForUser(n.children) }))
-}
-function effectiveLabel(n) { return (n.displayLabel?.trim()) || n.label }
-```
-Replace 3 callsite `{node.label}` → `{effectiveLabel(node)}`. **fe-admin Layout KHÔNG đụng** — render Label gốc + show hết menu (Q2=b).
-
-### Pending S21+ (cumulative carry over)
-
-1. Test V2 Service wire + Section gộp + B4 silent 403 + Mig 25 PATCH user-selectable
-2. **Contract V2 wire (Mig 28+29 mirror PE)** — biggest pending
-3. Phân quyền strict V2 + drop legacy V1 + Mig 15 cleanup
-4. Test PATCH /api/menus/{key} validate (Mig 27)
-5. Skill `permission-matrix` thêm section "menu visibility" — defer cron audit 2026-06-01
-6. UX verify trong UAT: admin ẩn menu cha → children có ẩn theo không (FE filter chỉ check `!n.isVisible` per-node)
-
-### Hard blockers ops (carry)
-
-UAT thật / SMTP / Rotate creds / SQL backup schedule / win-acme fix / remove `.huypham.vn`
-
-## TL;DR Session 20 — PE Detail UI restructure 3 yêu cầu UX user (previous)
-
-Note: TL;DR Session 20 PE Detail UI giữ nguyên dưới (rule §6.5 KEEP narrative). Session 20 turn 7 này thêm trên cùng (admin menu visibility — chủ đề khác).
-
- (4 chunk `9dee00d`→`2bba851`→`f2f01f4`→Docs). FE-only restructure (1 hook BE nhẹ auto-seed Detail). Q1=a giữ Section "Chọn NCC TP" riêng / Q2=a NCC shared + 1 hạng mục demo / Q3=a chỉ hiện NV đã ký / Q4 public luôn (skip dotnet test, vẫn npm build × 2 app mỗi chunk vì rename/remove function). Chunk A: BE CreatePE handler thêm 1 PurchaseEvaluationDetail mặc định (NoiDung=TenGoiThau, ThanhTienNganSach=Budget.TongNganSach||BudgetManualAmount||0) + FE reorder section Hạng mục lên #2. Chunk B: ItemsTab restructure list HangMucCard 1 card / hạng mục với expand panel chứa NCC inline table 8 cột (NCC/Liên hệ/Điều khoản TT/File báo giá/ĐG chưa VAT/ĐG có VAT/Thành tiền/Action). Click cell quote → QuoteDialog reuse. Drop SuppliersTab function ~134 LOC dead code, giữ 2 dialog + SupplierAttachmentsCell. Section 4 NCC tham gia gộp vào Section 2 → 4 section final (Thông tin/Hạng mục nested/Chọn NCC TP thắng thầu/Ý kiến). Chunk C: LevelOpinionsSectionV2 forEach step → 1 StepOpinionsBox (replace grid-cols-2 N approvers). Header "Bước N — Tên" + dept badge + "X/Y đã duyệt" counter. Body filter signed opinions sort levelOrder asc + signedAt asc → StepOpinionEntry per signed (tên + Cấp badge + admin override badge + timestamp + comment). NV chưa duyệt KHÔNG hiển thị. KHÔNG đụng Mig 26 schema. Drop LevelOpinionBox function. 81 test pass unchanged (UAT defer).**)
-
-## TL;DR Session 20 — PE Detail UI restructure 3 yêu cầu user UX
-
-User UAT live feedback: "Logic khá OK rồi, điều chỉnh giao diện chỗ Duyệt NCC 1 tý". 3 yêu cầu cụ thể:
-
-1. Hạng mục đưa lên phía trên + auto-tạo 1 hạng mục từ gói thầu (tên = TenGoiThau, giá trị = ngân sách)
-2. NCC expand dưới hạng mục (tầng 1 = hạng mục, tầng 2 = NCC, thông tin nhập trên grid)
-3. Section Ý kiến: gộp comment đồng cấp cùng Phòng → 1 ô / bước (chỉ hiện NV đã duyệt)
-
-### Q&A clarify trước code (chốt scope)
-
-- **Q1=a**: Giữ Section "Chọn NCC TP thắng thầu" riêng (rõ UX, không gộp dropdown winner vào nested grid)
-- **Q2=a**: NCC shared cross-hạng mục (như schema PE.Suppliers hiện tại) — "nhưng hiện chỉ cần 1 hạng mục trước tiên" → đơn giản scope Chunk B
-- **Q3=a**: CHỈ hiển thị NV đã ký (KHÔNG show placeholder "— chưa duyệt")
-- **Q4 public luôn demo**: Phase 9 UAT iteration skip `dotnet test` mỗi chunk, vẫn chạy `npm run build` × 2 app mỗi chunk (rule UAT skip verify exception cho rename/remove function — đã catch TS6133 SuppliersTab + SupplierAttachmentsCell)
-
-### Chunk A (`9dee00d`) — BE auto-seed Hạng mục + FE reorder section
-
-**BE — `PurchaseEvaluationFeatures.cs` `CreatePurchaseEvaluationCommandHandler`:**
-
-```csharp
-var defaultBudgetValue = linkedBudgetTotal ?? request.BudgetManualAmount ?? 0m;
-var defaultDetail = new PurchaseEvaluationDetail
-{
-    PurchaseEvaluationId = entity.Id,
-    GroupCode = "01",
-    GroupName = "Hạng mục chính",
-    NoiDung = request.TenGoiThau,
-    DonViTinh = "gói",
-    KhoiLuongNganSach = 1m,
-    KhoiLuongThiCong = 1m,
-    DonGiaNganSach = defaultBudgetValue,
-    ThanhTienNganSach = defaultBudgetValue,
-    Order = 1,
-};
-db.PurchaseEvaluationDetails.Add(defaultDetail);
-// + Changelog Insert audit
-```
-
-`linkedBudgetTotal` mới: nếu PE link Budget, fetch `Budget.TongNganSach` (computed sum BudgetDetails). Nếu không link, fall back `BudgetManualAmount`. Nếu cả 2 null → 0.
-
-**FE — Reorder section** (mirror fe-admin + fe-user, Chunk A intermediate state):
-1.Thông tin / **2.Hạng mục (lên #2)** / 3.Chọn NCC / 4.NCC tham gia / 5.Ý kiến.
-
-Verify: `dotnet build SolutionErp.slnx` 0 warn / 0 err.
-
-### Chunk B (`2bba851`) — Nested grid Hạng mục → NCC expand
-
-Restructure `ItemsTab` thành list `HangMucCard` (1 card / 1 hạng mục, expanded=true mặc định cho 1 hạng mục demo).
-
-**HangMucCard structure:**
-
-```
-┌──────────────────────────────────────────┐
-│ ▼ 01 · Tên hạng mục          KL ĐG TT NS │ ← Header row
-│ ──────────────────────────────────────── │
-│ NCC tham gia (3)  [+ Thêm NCC]           │ ← Sub-header
-│ ┌──────────────────────────────────────┐ │
-│ │ NCC │ Liên hệ │ ĐK │ File │ giá ... │ │ ← Inline NCC table
-│ ├──────────────────────────────────────┤ │
-│ │ NCC X │ ... │ ... │ ... │ ... │     │ │
-│ └──────────────────────────────────────┘ │
-└──────────────────────────────────────────┘
-```
-
-Header card: GroupCode + NoiDung + 3 stat (KL/ĐG ngân sách/TT ngân sách) + NS link Δ (nếu có Budget link) + Pencil/Trash actions + ▼/▶ toggle expand. Expand body: NCC inline table 8 cột (NCC / Liên hệ / Điều khoản TT / **File báo giá** / ĐG chưa VAT / ĐG có VAT / Thành tiền / Action).
-
-**Tương tác:**
-- Click cell quote (chưa VAT / có VAT / Thành tiền) → mở `QuoteDialog` cũ (reuse)
-- `+ Thêm NCC` button trong expand panel → `AddSupplierDialog` cũ (reuse)
-- `✏` icon mỗi NCC row → `EditSupplierDialog` cũ
-- `✓` icon → `setWinner` mutation, row + cell ăn theo màu emerald
-- `🗑` icon disabled khi NCC là winner hoặc đã có quote (giữ logic cũ)
-- `SupplierAttachmentsCell` nhúng vào cell "File báo giá" — full CRUD upload/download/delete file
-
-**Drop dead code:**
-- Function `SuppliersTab` xóa hoàn toàn (~134 LOC) — replace bằng `HangMucCard` expand panel
-- Bỏ Section 4 "NCC tham gia" cũ trong main render PeDetailTabs (gộp vào Section 2)
-
-**Section layout cuối** (4 section):
-1. Thông tin gói thầu
-2. Hạng mục + Báo giá NCC (nested expand)
-3. Chọn NCC / TP thắng thầu
-4. Ý kiến cấp duyệt
-
-Verify: `npm run build` × 2 app pass (sau khi catch TS6133 SuppliersTab unused → drop + SupplierAttachmentsCell unused → restore vào cột "File báo giá").
-
-### Chunk C (`f2f01f4`) — Section Ý kiến gộp đồng cấp cùng Phòng
-
-**FE-only mirror 2 app**. KHÔNG đụng Mig 26 schema (vẫn UPSERT 1 row / Level trong `PurchaseEvaluationLevelOpinions` qua `ApproveV2Async` Service). Chỉ thay đổi render layer.
-
-**Trước (S19 LevelOpinionsSectionV2):**
-```
-forEach step:
-  div.grid-cols-2:
-    forEach level:
-      forEach approver:
-        <LevelOpinionBox /> (1 box / NV)
-          - Cấp N — Tên NV
-          - "Đã duyệt" emerald badge or "— chưa duyệt" italic gray
-          - comment text
-          - admin override badge nếu signedBy !== approver
-```
-
-**Sau (Chunk C):**
-```
-forEach step:
-  <StepOpinionsBox stepOrder stepName departmentName totalApprovers opinions={stepOpinions} />
-    - Header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter
-    - Body:
-      - empty → "— Chưa có ý kiến duyệt." italic gray
-      - else → list <StepOpinionEntry opinion /> per signed opinion
-              (sort levelOrder asc, signedAt asc)
-```
-
-`StepOpinionEntry`:
-- Header trái: ApproverFullName + "Cấp N" badge slate + admin override badge amber nếu có
-- Header phải: emerald rounded-full timestamp "✓ DD/MM/YYYY HH:mm"
-- Body: comment text whitespace-pre-wrap
-
-NV chưa duyệt KHÔNG hiển thị (Q3=a) — chỉ 1 box / Step thay vì N box / NV như cũ.
-
-**Drop dead code:**
-- Function `LevelOpinionBox` xóa (~50 LOC) — replace bằng `StepOpinionsBox` + `StepOpinionEntry`
-
-Verify: `npm run build` × 2 app pass.
-
-### Pending Session 21+ (carry over từ HANDOFF S19 + còn nguyên)
-
-1. **Test V2 Service wire** (Chunk B Service hook S19 + Section gộp Chunk C S20) — defer chờ UAT user confirm + có sample data Production. Domain test ApproveV2 + UPSERT opinion match logic + Admin override match firstLevel + comment empty placeholder + render gộp Step.
-2. **Test regression B4 silent 403 S18** (HIGH §7 priority — vi phạm rule "test-before bug fix") — per-action `[Authorize(Policy=...)]` ApprovalWorkflowsV2Controller.
-3. **Test Mig 25 PATCH `/user-selectable`** endpoint (admin scope hẹp, MED).
-4. **🎯 Contract V2 wire (Mig 27/28 mirror PE pattern)** — biggest pending Plan. Audit-reuse memory áp dụng:
-   - Mig 27: `Contract.ApprovalWorkflowId` Guid? + `CurrentApprovalLevelOrder` int?
-   - Mig 28: `ContractLevelOpinions` mirror PE Mig 26 (UNIQUE composite, FK Cascade/Restrict)
-   - `ContractWorkflowService.ApproveV2Async` mirror PE branch
-   - `ContractCreatePage` Workspace Select V2 (validate ApplicableType=Contract=3)
-   - Pin V2 mặc định cho ContractType (admin Designer)
-   - `ContractDetailContent` Section "Ý kiến cấp duyệt" V2 dynamic (mirror S20 Chunk C — 1 box / Step)
-5. **Phân quyền strict V2** — vẫn loose UAT (mọi authenticated user thấy mọi phiếu V2). Sau confirm flow:
-   - List = Drafter + approver any-Step + Admin
-   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
-   - Detail = same as List
-   - Cũng giải quyết được bug "/inbox loose trả phiếu Nháp" → sau khi strict, B1 FE filter S18 có thể relax
-6. **Drop legacy V1 cleanup** sau khi không còn phiếu pin `WorkflowDefinitionId`:
-   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
-   - Mig 29+ cleanup drop column `RejectedAtStepIndex` + `RejectedFromPhase` deprecated S17
-   - Drop `ApproveV1LegacyAsync` branch trong Service
-7. **Drop Mig 15 cho V2 phiếu** sau UAT confirm — Mig 30 cleanup drop bảng `PurchaseEvaluationDepartmentOpinions` + entity. Hoặc giữ cả 2 backward compat (Q3 user chốt phiếu MỚI dùng V2, V1 cũ giữ legacy không migrate).
-8. **schema-diagram §16 PE Level Opinions V2** + §17-21 Mig 18-21 — defer cron audit 2026-06-01.
-9. **Skill `ef-core-migration`** frontmatter "21 migration" stale (thực 26) — defer cron audit 2026-06-01.
-
-### Hard blockers ops (carry over từ Session 19)
-
-- UAT thật 1 tuần với 2-3 user (Drafter/CCM/BOD)
-- SMTP config → Email outbox (BLOCKED chờ user cấp host/user/pass)
-- Rotate creds (admin + 30 demo + SA + vrapp + JWT secret + Gitea runner token)
-- Schedule SQL backup daily — `scripts/backup-sql.ps1` chưa schedule Task Scheduler
-- Remove binding cũ `.huypham.vn` sau verify stable
-- win-acme scheduled task "unhealthy" — auto-renew fix trước 2026-06-18
-
-### Audit định kỳ
-
-- Lần gần nhất: 2026-05-04 (manual trễ 4 ngày) — log `docs/changelog/skill-audit-2026-05.md`
-- Lần kế: **2026-06-01** combined audit (skill + doc drift). Drift hiện tại unchanged từ S19 (S20 không thêm migration / gotcha mới):
-  - `ef-core-migration` "21 migration" stale (thực 26)
-  - `dependency-audit-erp` count gotcha 41 stale (thực 44)
-  - `schema-diagram` §16 PE Level Opinions V2 + §17-21 Mig 18-21 pending
-- Cron Claude SDK KHÔNG fit monthly (auto-expire 7d, memory `feedback_cron_monthly_limitation`) — manual trigger khi đến ngày hoặc user nói "audit MD" / "kiểm tra docs"
-
-## TL;DR Session 19 — PE Section 5 V2 dynamic theo Workflow + Mig 26
-
-User feedback Section 5 hiện CỨNG 4 box (Mig 15 PheDuyet/CCM/MuaHàng/SmPm từ Phase 8) → cần ĐỘNG theo Workflow V2 đã pin với phiếu. Spec rõ: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox với ý kiến + tên người. "Bước 1 phòng A có 2 NV → 2 box ngang hàng".
-
-User chốt 5 câu Q&A trước code (capture trong session log):
-- Q1=**1B**: Comment khi NV nhấn Duyệt trong Workflow Panel auto sync sang OpinionBox của NV đó (Section 5 read-only summary). KHÔNG có form input rời.
-- Q2=**2A+Admin**: Chỉ NV chính chủ duyệt được. Admin override → lưu SignedByUserId=Admin.Id, FE banner "Admin <name> duyệt thay" khi SignedByUserId !== Level.ApproverUserId.
-- Q3=**V2 hết**: Phiếu V1 legacy → fallback render Mig 15 4 box CỨNG readOnly cho data history (KHÔNG drop Mig 15 — giữ data cũ).
-- Q4=**4C + bonus**: Phase=DaDuyet/TuChoi → khoá hoàn toàn. Admin có quyền duyệt thay. Comment empty/whitespace → ghi "(duyệt — không ý kiến)" placeholder.
-- Q5=**5A**: Layout group theo Step (header "Bước N — Phòng X" badge emerald + hint số người duyệt) + grid-cols-2 cho N approvers (wrap nếu N>2).
-
-### Polish 3 button Hành động (873e7a1) — đầu session
-
-Session 18 turn cuối user đã review screenshot "Hành động: Trả lại / Hủy/Từ chối / Duyệt → Chờ CCM" — yêu cầu rút gọn label + 3 màu khác nhau + bold. PeWorkflowPanel.tsx (mirror 2 app):
-- Label: "← Trả lại (về Drafter sửa)" → **"← Trả lại"** | "✗ Hủy / Từ chối" → **"✗ Từ chối"** | "✓ Duyệt → Chờ CCM" → **"✓ Duyệt"**
-- Phase đích vẫn hiện qua tooltip title khi hover
-- 3 màu: Duyệt = emerald (positive) · Trả lại = amber (request changes) · Từ chối = red (terminal)
-- font-medium → font-bold
-
-### Chunk A (`77a3058`) — Domain entity + EF + Mig 26
-
-`PurchaseEvaluationLevelOpinion : AuditableEntity`:
-- (PEId, ApprovalWorkflowLevelId) UNIQUE composite
-- Comment nvarchar(2000)
-- SignedAt datetime2 (luôn có khi UPSERT)
-- SignedByUserId Guid (NV chính chủ HOẶC Admin override)
-- SignedByFullName nvarchar(200) — denorm tránh user xóa/đổi tên
-
-EF: FK Cascade Pe + Restrict Level. SignedByUserId KHÔNG nav (denorm only).
-Migration 26 `AddPeLevelOpinionsForV2`: 1 CREATE TABLE + 2 FK + 2 index. 3-file rule commit đủ. Apply LocalDB SolutionErp_Dev OK (Mig 25 + 26 catchup).
-
-Verify: dotnet build pass + dotnet test 81 pass.
-
-### Chunk B (`90baa8e`) — Service V2 hook + DTO + GET include
-
-Service `ApproveV2Async` sau khi log approval → UPSERT row LevelOpinion cho Cấp hiện tại:
-```csharp
-var matchingLevel = pendingLevelGroup
-    .FirstOrDefault(l => actorUserId.HasValue && l.ApproverUserId == actorUserId.Value)
-    ?? pendingLevelGroup.First();  // Admin override fallback first
-var actorFullName = await ResolveActorFullNameAsync(actorUserId, isSystem, ct);
-var existingOpinion = await db.PurchaseEvaluationLevelOpinions
-    .FirstOrDefaultAsync(o => o.PurchaseEvaluationId == evaluation.Id
-        && o.ApprovalWorkflowLevelId == matchingLevel.Id, ct);
-var normalizedComment = string.IsNullOrWhiteSpace(comment)
-    ? "(duyệt — không ý kiến)"
-    : comment.Trim();
-// UPSERT: if existing → update; else → Add new
-```
-
-Reject (Trả lại / Từ chối) KHÔNG sync. Multi-NV cùng Cấp OR-of-N: match level theo ApproverUserId (NV chính chủ). Admin = fallback first; FE banner "Admin duyệt thay".
-
-Helper `ResolveActorFullNameAsync` lookup denorm SignedByFullName từ Users (fallback "(System)" / "(unknown)").
-
-DTO `PurchaseEvaluationLevelOpinionDto` 15 fields:
-- LevelId, StepOrder, StepName, StepDepartmentId, StepDepartmentName
-- LevelOrder, LevelName, ApproverUserId, ApproverFullName
-- Comment, SignedAt, SignedByUserId, SignedByFullName
-
-GET handler Include LevelOpinions + `BuildLevelOpinionsAsync` JOIN ApprovalWorkflows.Steps.Levels + Departments + Users → denorm DTO. Empty list cho phiếu V1 / V2 chưa có cấp duyệt → FE fallback message.
-
-Verify: dotnet build pass + dotnet test 81 pass.
-
-### Chunk C (`6e913b3`) — FE Section 5 V2 dynamic mirror 2 app
-
-Type `PeLevelOpinion` (15 field) + `PeDetailBundle.levelOpinions[]`.
-
-Section 5 PeDetailTabs conditional:
-```tsx
-{evaluation.approvalWorkflowId
-  ? <LevelOpinionsSectionV2 ev={evaluation} />
-  : <DepartmentOpinionsSection ev={evaluation} readOnly={opinionsReadOnly} />}
-```
-
-`LevelOpinionsSectionV2`:
-- Empty state khi `flow null` / `0 steps` → message "Workflow chưa cấu hình hoặc chưa có cấp duyệt nào"
-- forEach `step` → header "Bước N — <step.name>" + dept badge emerald + hint "(N người duyệt)" nếu totalApprovers > 1
-- Body grid-cols-2 cho `step.levels.flatMap(level => level.approvers.map(approver => <LevelOpinionBox/>))`
-- Lookup opinion theo (stepOrder, levelOrder, approverUserId) match levelOpinions[]
-
-`LevelOpinionBox` read-only:
-- Title "Cấp N — <ApproverFullName>"
-- Badge amber "⚠ Admin <SignedByFullName> duyệt thay" khi `signedByUserId !== approverUserId`
-- Badge emerald "✓ Đã duyệt" khi opinion tồn tại
-- Empty: "— chưa duyệt" italic gray
-- Footer: timestamp signedAt format vi-VN
-
-Workspace mode hint amber giữ "Ý kiến + chữ ký auto đồng bộ khi NV duyệt phiếu — vào menu Duyệt để ký."
-
-Mirror fe-admin + fe-user (rule §3.9).
-
-Verify: npm run build × 2 pass · 0 TS error.
-
-### Stats Δ Session 19
-
-| | Trước S19 | Sau S19 |
-|---|---:|---:|
-| Migrations | 25 | **26** (+1 Mig 26) |
-| DB tables | 58 | **59** (+1 PeLevelOpinions) |
-| API endpoints | ~141 | ~141 (no new — UPSERT auto qua Service hook) |
-| FE pages | 33 | 33 (modify existing only) |
-| Test pass | 81 | 81 (no change — UAT defer test §7) |
-| Gotchas | 44 | 44 |
-| Memory entries | 14 | 14 |
-| Skills | 6 | 6 |
-| Commits | (after S18) | **+4** (873e7a1 + 77a3058 + 90baa8e + 6e913b3 + Chunk D Docs) |
-
-## ⚠️ Điều quan trọng cho Session 20+
-
-1. **Test V2 Service wire mới (Chunk B Service hook)** — defer khi UAT user UAT confirm + có sample data Production. Domain test ApproveV2 + UPSERT opinion match logic + Admin override match firstLevel + comment empty placeholder.
-
-2. **Drop Mig 15 cho V2 phiếu (cleanup sau UAT confirm)** — sau khi không còn phiếu V2 dùng `PurchaseEvaluationDepartmentOpinions` (tất cả phiếu V2 chỉ dùng Mig 26 LevelOpinions). Mig 27 cleanup drop bảng + entity. Phiếu V1 legacy giữ Mig 15. Hoặc giữ cả 2 để backward compat.
-
-3. **Migrate phiếu V1 cũ sang V2 (data migration)** — admin tool chuyển `ApprovalWorkflowId` từ null → V2 workflow phù hợp + clear `WorkflowDefinitionId`. Hiện chưa làm (Q3 user nói chuyển V2 hết = phiếu MỚI dùng V2, phiếu V1 cũ giữ legacy không migrate — đơn giản hơn).
-
-4. **Contract V2 wire (Mig 27 hoặc 28) + Section 5 dynamic Contract** — mirror PE Mig 26 pattern: thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 27) + `ContractLevelOpinions` (Mig 28) + Service `ApproveV2Async` mirror PE + ContractDetailContent Section 5 V2. Audit-reuse pattern memory `feedback_audit_reuse_before_clone` áp dụng.
-
-5. **Phân quyền strict V2** — vẫn loose UAT. Sau confirm V2 flow (S19 Section 5 + S18 polish OK):
-   - List = Drafter + approver any-Step + Admin
-   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng)
-   - Detail = same as List
-
-6. **schema-diagram §16 PE Level Opinions V2** — thêm khi Chunk D update. Mig 22-25 V2 schema vẫn defer cron audit 2026-06-01.
-
-7. **Skill `ef-core-migration` frontmatter "21 migration" stale** (thực 26). Defer cron audit 2026-06-01.
-
----
-
-## TL;DR Session 18 — PE V2 polish + Clone B + 4 bug fix UAT
-
-User UAT live tiếp Session 17, 7 batch nhỏ + 1 feature lớn (Mig 25). Áp memory `feedback_uat_skip_verify` (skip dotnet test mỗi chunk, push ngay) + lesson `0ae3fe2`: rename/remove → BẮT BUỘC `npm run build`.
-
-### B1 (`aaa1c6c`) — Pe Duyệt filter cứng "Đã gửi duyệt"
-
-User: "Duyệt bỏ cái trạng thái đi, chỉ load những trạng thái 'Đã gửi duyệt' là đc."
-
-- Bỏ dropdown "Tất cả trạng thái" khỏi UI khi `pendingMe=true`, thay bằng hint amber "Lọc cố định: Đã gửi duyệt (phiếu đang chờ duyệt)"
-- Filter cứng client-side: `getPeDisplayStatus(p.phase) === DaGuiDuyet` — loại Nháp/Trả lại/Đã duyệt/Từ chối
-- Header count dùng `rows.length` khi `pendingMe` (inbox không paged)
-- Workaround BE `/inbox` loose UAT có thể trả phiếu Nháp (phân quyền strict V2 pending Session 19+)
-- Mirror fe-admin + fe-user `PurchaseEvaluationsListPage.tsx`
-
-### B2 (`917446d`) — HistoryTab filter Trả lại / Gửi duyệt lại
-
-User: "Lịch sử thay đổi: chỉ bắt các dòng thay đổi khi trả lại và gửi duyệt lại thôi nhé, không cần bắt trạng thái duyệt và các thay đổi trước khi trả lại."
-
-- FE filter trong `PeDetailTabs.HistoryTab`, BE giữ audit data đầy đủ (reversible nếu user đổi ý / cần audit trail compliance)
-- Logic giữ:
-  - Workflow transition về TraLai (`phaseAtChange === 98`)
-  - Workflow transition từ TraLai (summary chứa `"TraLai →"`)
-  - Mọi thay đổi nội dung (Header/Detail/Supplier/Quote/Attachment) khi `phaseAtChange === 98`
-- Bỏ: workflow Approve cùng cấp (Cấp 1→2→DaDuyet), sửa khi phase=Nháp/ChoDuyet ban đầu
-- Empty state: "Chưa có lịch sử trả lại / gửi duyệt lại"
-
-### B3 (`937eb24`) — Clone V2 cho B (DuyetNccPhuongAn)
-
-User: "Quy trình chọn thầu phụ - NCC → Duyệt NCC đúng. Plan kế hoạch clone toàn bộ updates sang Duyệt NCC và Giải pháp."
-
-Audit reuse trước thay vì duplicate. Phát hiện 80% đã chung:
-- Schema V2 (Mig 22-24) qua `ApplicableType` enum
-- BE Service `ApproveV2Async` không hardcode type
-- App CQRS / API `/approval-workflows-v2?applicableType=N` dynamic
-- FE Designer `ApprovalWorkflowsV2Page` có `TYPE_CODE_TO_INT` cả 3 type
-- Layout regex `^AwV2_(.+)$` match dynamic typeCode
-- App.tsx route `/system/approval-workflows-v2/:typeCode` dynamic
-
-Chỉ thiếu cho B: **menu key + sample seed** (3 file ~60 LOC).
-
-- `MenuKeys.cs` +const `ApprovalWorkflowDuyetNccPhuongAnV2 = "AwV2_DuyetNccPhuongAn"` + add vào `All[]`
-- `DbInitializer.SeedMenusAsync` +leaf "Duyệt NCC và Giải pháp (Mới)" dưới root ApprovalWorkflowsV2 (Order=2 cạnh leaf A Order=1)
-- `DbInitializer +SeedSampleApprovalWorkflowsV2Async` (idempotent — skip nếu admin đã tạo workflow B nào, hoặc thiếu test user `nv.test`/Phòng CCM): seed `QT-DN-PA-V2-001 v01` 1 Bước Phòng CCM × 1 Cấp NV test
-- `fe-admin/lib/menuKeys.ts` +`AwV2_DuyetNccPhuongAn`
-
-KHÔNG migration / Service / Designer page mới. Memory `feedback_audit_reuse_before_clone.md` capture pattern.
-
-User feedback "OK khá tốt, 1 phát chạy luôn :))" sau verify → confirm approach.
-
-### B4 (`f77ea38`) — Fix silent 403 ApprovalWorkflowsV2Controller
-
-Triệu chứng: Drafter `nv.test` Workspace tạo phiếu B → dropdown "Quy trình duyệt" empty mặc dù Admin Designer thấy 2 version (v01 sample + v02 admin clone).
-
-Root cause: Class-level `[Authorize(Policy = "Workflows.Read")]` → non-admin role 403 Forbidden khi GET `/api/approval-workflows-v2`. TanStack Query catch error không hiện UI → dropdown rỗng silent.
-
-Fix:
-- Class-level đổi `[Authorize]` only (any authenticated user)
-- GET endpoint inherit class policy — Drafter list workflow để pick read-only, không nhạy cảm
-- POST + DELETE giữ `[Authorize(Policy = "Workflows.Create")]` admin-only Designer
-
-Pattern reusable cho Contract V2 Mig 26 sau.
-
-### B5 (`a9c0857`) — Fix sidebar highlight queryMatches transient keys
-
-Triệu chứng: Ở leaf "Danh sách" `/purchase-evaluations?type=1`, click chọn 1 phiếu → URL thành `?type=1&id=abc` → leaf bị mất highlight box (gotcha #34 cũ tái phát theo cách khác).
-
-Root cause: `queryMatches` exact-set equality — target `{type}` (1 key) vs current `{type, id}` (2 keys) length mismatch → no match → leaf unhighlight.
-
-Fix: `TRANSIENT_QUERY_KEYS = {id, q, editHeader, page, phase, awId}` — strip trước khi compare. Mọi key navigation identity (`type`, `pendingMe`, `mode`) check exact-set như cũ.
-
-Edge cases verified:
-| URL hiện tại | Target leaf | Match |
-|---|---|---|
-| `?type=1&id=abc` | Danh sách `?type=1` | ✓ giữ highlight |
-| `?type=1&pendingMe=1` | Danh sách `?type=1` | ✗ distinct (không cross-highlight Pending) |
-| `?type=1&phase=10` | Danh sách `?type=1` | ✓ giữ highlight (filter dropdown) |
-| `?type=1&pendingMe=1&awId=xyz` | Duyệt `?type=1&pendingMe=1` | ✓ giữ highlight |
-
-Mirror fe-admin + fe-user `Layout.tsx`.
-
-### B6 (`2a53107`) — Mig 25 IsUserSelectable + Designer pin toggle + bỏ "(clone)"
-
-User feedback xem Admin Designer: "Bỏ chữ Clone đi nhé, ghi v02, v03... là đủ rồi. Thêm cho tao nút stick để chọn các quy trình nào mà User đc select bên ngoài khi tạo phiếu."
-
-**Bỏ "(clone)":** Designer auto-fill `name = cloneFrom.name` (bỏ ` (clone)` suffix). Version số đã đủ phân biệt.
-
-**Pin toggle "Cho user chọn":**
-
-- **Migration 25** `AddIsUserSelectableToApprovalWorkflows`:
-  ```sql
-  ALTER TABLE ApprovalWorkflows ADD IsUserSelectable bit NOT NULL DEFAULT 0;
-  -- Backfill (giữ behavior cũ — active workflows vẫn pickable):
-  UPDATE ApprovalWorkflows SET IsUserSelectable = 1 WHERE IsActive = 1;
-  ```
-- **Domain** `ApprovalWorkflow.IsUserSelectable` — independent với `IsActive`, multiple versions có thể cùng selectable (admin có thể "ghim" nhiều version cho user pick).
-- **App CQRS:**
-  - `AwDefinitionDto` +field `IsUserSelectable`
-  - `CreateAwDefinitionCommand` Handler set default `true` cho version mới (mirror IsActive default)
-  - New `SetAwUserSelectableCommand(Guid Id, bool IsUserSelectable)` + Handler — toggle
-- **API** `PATCH /api/approval-workflows-v2/{id}/user-selectable` policy `Workflows.Create` (admin only)
-- **DbInitializer** `SeedSampleApprovalWorkflowsV2Async` +`IsUserSelectable = true`
-- **FE Designer** (`fe-admin/ApprovalWorkflowsV2Page.tsx`):
-  - `DefinitionDto` +`isUserSelectable`
-  - Badge amber "📌 Cho user chọn" cạnh badge IsActive/Archived khi `isUserSelectable === true`
-  - Button "📌 Ghim cho user / 🚫 Bỏ ghim" trong action group + mutation `toggleSelectable` (call PATCH endpoint, invalidate query)
-- **FE Workspace** (cả fe-admin + fe-user `PeWorkspaceCreateView.tsx`):
-  - approvalWorkflows query `.filter(w => w.isUserSelectable)` — chỉ workflows admin đã ghim hiện trong dropdown user
-
-### B7 (`32a8d4d`) — Cleanup orphan zip files
-
-`.claude.zip + docs.zip` từ harness session start lỡ tay vào `git add -A` ở B6 commit. Untrack + add `*.zip` rule `.gitignore`.
-
-### Stats Δ Session 18
-
-| | Trước S18 | Sau S18 |
-|---|---:|---:|
-| Migrations | 24 | **25** (+1) |
-| DB tables | 58 | 58 (Mig 25 chỉ ALTER cột) |
-| API endpoints | ~140 | **~141** (+1 PATCH user-selectable) |
-| FE pages | 33 | 33 (modify existing only) |
-| Test pass | 81 | 81 (no change — UAT feature defer test §7) |
-| Gotchas | 43 | **44** (+1 silent 403) |
-| Memory entries | 13 | **14** (+1 audit reuse pattern) |
-| Skills | 6 | 6 (no add) |
-| Commits | (after S17) | **+7** |
-
-## ⚠️ Điều quan trọng cho Session 19+
-
-1. **Contract V2 wire (Mig 26) — pending dedicated session.** Pattern audit-reuse áp dụng: phần lớn đã chung. Mirror PE pattern:
-   - Thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 26)
-   - `ContractWorkflowService.ApproveV2Async` mirror PE pattern
-   - `ContractCreatePage` Workspace Select V2
-   - Pin V2 mặc định cho ContractType
-   - Permission GET endpoint đã permissive (Session 18 fix), không cần đụng
-
-2. **Phân quyền strict V2 V2** — hiện loose UAT (mọi authenticated thấy mọi phiếu V2). Sau confirm flow:
-   - List = Drafter + approver any-Step + Admin
-   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
-   - Detail = same as List
-   - Cũng giải quyết được bug "/inbox loose trả phiếu Nháp" — sau khi strict, B1 FE filter có thể relax nếu BE đã filter đúng
-
-3. **Drop legacy V1 cleanup** sau khi không còn phiếu pin `WorkflowDefinitionId` (V1):
-   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
-   - Mig 27 cleanup drop column `RejectedAtStepIndex` + `RejectedFromPhase` deprecated S17
-   - Drop `ApproveV1LegacyAsync` branch trong Service
-
-4. **Test V2 wire** (defer khi UAT confirm + có sample data) — Domain test `ApproveV2Async` match logic + transient TraLai entry → Cấp 1 reset.
-
-5. **`feedback_audit_reuse_before_clone` memory** — áp dụng cho mọi "clone X sang Y" / "thêm type Z mới" sau này. List "đã chung" vs "còn thiếu" trước khi propose plan.
-
-6. **Sample seed B sample** chạy với check `hasAnyB` — sau UAT có thể remove sample seed (admin đã tạo workflow thật). Hoặc giữ làm fallback. Idempotent skip nếu admin có workflow B → không clobber.
-
----
-
-## TL;DR Session 17 — PE V2 schema end-to-end
-
-## TL;DR Session 17 — PE V2 schema end-to-end
-
-User chốt sau Session 16 (drastic refactor flat Mig 21 vẫn sai intent): **viết lại schema riêng + thêm Menu "Duyệt NCC (Mới)"** với cấu trúc explicit:
-
-```
-Mã Quy trình - Tên Quy trình
-  * Bước 1 - Phòng A
-    * Cấp 1 - NV X        ← 1 user CỤ THỂ qua ApproverUserId
-    * Cấp 2 - NV Y
-  * Bước 2 - Phòng B
-    * Cấp 1 - NV Z
-```
-
-Khác Mig 21: mỗi Cấp = 1 NV chính xác, KHÔNG OR-of-many group Dept+PositionLevel/Role/User.
-
-**4 commit (3 chunk per-commit + docs):**
-
-### Chunk A (`c847dc0`) — Domain + EF + Mig 22 + Menu
-
-- Domain `ApprovalWorkflowsV2/ApprovalWorkflow.cs` — 3 entity (ApprovalWorkflow + Step + Level) + enum `ApprovalWorkflowApplicableType` (DuyetNcc=1 / DuyetNccPhuongAn=2 / Contract=3)
-- EF `ApprovalWorkflowConfiguration.cs` — UNIQUE (Code, Version), FK Cascade Step→Workflow + Level→Step, FK Restrict Department + ApproverUserId
-- ApplicationDbContext +3 DbSet
-- **Migration 22** `AddApprovalWorkflowsV2` — 3 CREATE TABLE + 1 UNIQUE + 4 INDEX. Applied cả `_Design` + `_Dev` LocalDB
-- DbInitializer SeedMenusAsync: +menu `ApprovalWorkflowsV2` root dưới System (icon Workflow) + leaf `AwV2_DuyetNcc` (icon FileCheck, label "Duyệt NCC (Mới)")
-- MenuKeys.cs +2 const trong All array
-
-### Chunk B (`f6047d5`) — Application CQRS + API
-
-- `Application/ApprovalWorkflowsV2/ApprovalWorkflowV2AdminFeatures.cs`:
-  - `GetAwAdminOverviewQuery(ApplicableType?)` — load 3-level Include + dept/user names map
-  - `CreateAwDefinitionCommand` + Validator — auto-increment Version theo Code, deactivate active version cùng ApplicableType
-  - `DeleteAwDefinitionCommand` — UAT helper unconditional (chưa pin)
-  - DTO AwDefinition/AwStep/AwLevel + AwTypeSummary
-- IApplicationDbContext +3 DbSet
-- `Api/Controllers/ApprovalWorkflowsV2Controller` — route `/api/approval-workflows-v2`, GET ?applicableType=N | POST | DELETE/{id}, reuse policy `Workflows.Read` + `Workflows.Create`
-
-### Chunk C (`2781c7e`) — FE Designer
-
-- `fe-admin/src/pages/system/ApprovalWorkflowsV2Page.tsx` (~480 LOC)
-  - Overview cards Active+History per ApplicableType
-  - DefinitionCard read-only: Bước (badge phòng emerald) → Cấp (badge violet C1/C2 + tên NV + email)
-  - Designer dialog: Mã/Tên/Mô tả + Add/Remove Step + reorder (chevron up/down) + Add/Remove Level + Select Phòng + Select NV duyệt
-  - Validate: mỗi Step ≥1 Level, mỗi Level phải có ApproverUserId
-  - Auto-assign code mặc định theo type: `QT-DN-V2-001` / `QT-DN-PA-V2-001` / `QT-HD-V2-001`
-- Layout.tsx resolver +ApprovalWorkflowsV2 root → `/system/approval-workflows-v2`, +AwV2_<TypeCode> leaf → `/system/approval-workflows-v2/<code>`
-- App.tsx +2 route
-- menuKeys.ts +2 const sync với BE
-
-### Chunk D — Docs
-
-STATUS + HANDOFF + project_solution_erp.md memory.
-
-### Chunk E (UAT iteration, 9 commit) — Designer fix + State machine + Service wire + UX
-
-User UAT iter Designer V2 phát hiện multiple issues + chốt spec dần qua state diagram. Per memory `feedback_uat_skip_verify.md` UAT mode iterate nhanh:
-
-| Commit | Tóm tắt |
-|---|---|
-| `9712778` | Designer iter 1 lock 3 cấp/bước (sai intent) |
-| `f3bea3c` | Designer iter 2 đúng intent: max 3 cấp × N NV/cấp + sequential gating C2/C3 disabled khi prev empty + filter NV theo Phòng + no-dup same level. Validator BE strict |
-| `ff21120` | State machine 5 trạng thái Nháp/ĐãGửiDuyệt/TrảLại/TừChối/ĐãDuyệt. TraLai = Phase RIÊNG (không revert DangSoanThao + không jump-back). PE/Contract/Budget Phase enum + Policy + Service Reject branch → TraLai. 4 test mới TraLai entry point |
-| `0a40c65` | **Mig 23** `AddApprovalWorkflowIdToPurchaseEvaluation` — pin V2 vào PE entity. Workspace Select bắt buộc workflow lúc create. Validate ApplicableType match PE.Type |
-| `b41484b` | **Mig 24** `AddCurrentApprovalLevelOrderToPe` + Service V2 wire — `ApproveV2Async` iterate Steps/Levels group by Order = Cấp (OR-of-N approvers) match `actor.Id ∈ ApproverUserId`. Synthetic Policy `ForV2Schema()` cho FE nextPhases |
-| `d814429` | DTO CurrentApproval + banner "Đến lượt bạn" / "Không phải lượt bạn" + button Duyệt forward disabled khi V2 + actor không trong cấp + tooltip "chỉ {NV X / Y} duyệt được". Trả lại + Từ chối vẫn enabled |
-| `9e63e2d` `d250ae4` `74745a7` | List/Inbox V2-aware (`ResolveV2InboxIdsAsync` precompute IDs). 2 dropdown filter Quy trình + Trạng thái (chỉ ở Duyệt). Inbox endpoint nhận `approvalWorkflowId` |
-| `ac41d5e` | SQL `clean-transactional-uat.sql` — clean prod (9 PE + 11 HĐ + 19 Notif xóa) giữ master. Run qua SSH VPS `.\SQLEXPRESS` |
-| `de0f38d` | Panel 3 thay 4 phase cards bằng flow workflow thực tế: Bước (icon ✓/●/○) → Cấp (label "đang chờ"/"đã duyệt" + tên NV). DTO `ApprovalFlow` full snapshot với Status Done/Current/Pending |
-
-**Stats final Session 17:** 24 migration (+3), 58 DB tables (+3), ~140 endpoints (+5), 81 test pass (+4).
-
-**Test user UAT** (tạo qua API admin):
-- Email: `nv.test@solutions.com.vn` / Pass: `TestUser@123456` / Role: Drafter / Phòng: CCM
-
-## ⚠️ Điều quan trọng cho Session 18+
-
-1. **Contract V2 wire CHƯA làm** — chỉ PE wire xong (Mig 23-24). Session sau mirror pattern PE → Contract:
-   - Thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 25)
-   - Update `ContractWorkflowService` thêm `ApproveV2Async` branch
-   - Update Workspace Select V2 trong `ContractCreatePage`
-   - Pin V2 thành mặc định cho Contract types
-
-2. **Phân quyền strict V2** — hiện loose UAT (mọi authenticated user thấy phiếu V2). Sau confirm flow OK:
-   - List: Drafter + bất kỳ approver any-Step + Admin
-   - Inbox: chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
-   - Detail: same as List
-
-3. **Drop legacy V1 sau UAT** — khi không còn phiếu nào pin `WorkflowDefinitionId`:
-   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
-   - Cleanup migration: drop column `RejectedAtStepIndex` + `RejectedFromPhase` (deprecated từ Session 17)
-   - Drop `ApproveV1LegacyAsync` branch trong Service
-
-4. **Admin role bypass** — hiện code `if (!isAdmin && !isSystem)` skip approver check. By design cho UAT + emergency override. Nếu prod cần audit override → option C trong Session 17 thảo luận: thêm flag `IsAdminOverride=true` trong approval row + banner đỏ trên detail.
-
-5. **81 test pass** — Domain WorkflowPolicyTests + PurchaseEvaluationPolicyTests + BudgetPolicyTests đã update cho TraLai entry point. KHÔNG có test cho V2 Service wire (defer khi UAT confirm + có sample data).
-
----
-
-## TL;DR Session 16 (08/05 — Drastic refactor flat workflow EXECUTE)
-
-Resume từ Session 15 defer plan. Per memory `feedback_drastic_refactor_scope.md`: dedicated session, fresh context, conservative buffer.
-
-**Spec:** Workflow flat list (Phòng × Cấp × Approvers). Mỗi step = 1 (Phòng × Cấp). Service iterate steps OrderBy Order, advance pointer. Phase enum simplify ChoDuyet=10. Pin WorkflowDefinitionId.
-
-**2 chunk per-commit (5-6 chunk plan rút gọn vì BE tightly coupled):**
-
-### Chunk A (`dbb0089`) — All BE: Domain + Mig 21 + Service + Tests
-
-**Domain entities:**
-- Phase enum (PE + Contract): + ChoDuyet=10 generic intermediate. Legacy 2-6 + 98 deprecated (giữ enum cho data cũ).
-- WorkflowStep + DepartmentId Guid? FK Restrict + PositionLevel int?
-- PurchaseEvaluation/Contract + CurrentWorkflowStepIndex int? + RejectedAtStepIndex int?
-- DROP class WorkflowStepInnerStep + nav (PE + Contract)
-- DROP *DepartmentApproval.InnerStepId column
-
-**EF Configurations:**
-- DROP InnerStep config (PE + Contract) → table dropped
-- WorkflowStep config + DeptId/PositionLevel + FK Restrict
-- DepartmentApprovals: restore simple unique non-filtered (Mig 19/20 filtered split reverse)
-
-**ApplicationDbContext:** DROP DbSet<*WorkflowStepInnerStep> × 2
-
-**Migration 21** `RefactorWorkflowToFlatModel` GỘP:
-- 4 ALTER (PE/Contract +CurrentStepIndex +RejectedAtStepIndex)
-- 2 ALTER (WorkflowStep +DepartmentId +PositionLevel) PE + Contract
-- DROP TABLE × 2 (PEWorkflowStepInnerSteps + WorkflowStepInnerSteps Mig 18+20)
-- DROP COLUMN × 2 (*DeptApproval.InnerStepId)
-- DROP filtered indexes Mig 19/20
-- RESTORE simple UNIQUE (TargetId, Phase, Dept, Stage) non-filtered × 2
-
-**Service rewrite (PE + Contract WorkflowService.TransitionAsync):**
-- DangSoanThao → ChoDuyet (Drafter trình, init idx=0)
-- ChoDuyet → ChoDuyet (advance idx per approve)
-- ChoDuyet → DaDuyet/DaPhatHanh (idx ≥ steps.Count → terminal, gen mã HĐ Contract)
-- ChoDuyet → DangSoanThao (Trả lại — save RejectedAtStepIndex)
-- ChoDuyet → TuChoi (Từ chối — khoá vĩnh viễn)
-- Resume Drafter (DangSoanThao + RejectedAtStepIndex≠null) → ChoDuyet jump-back
-- Match approver: actor.Dept == step.Dept AND actor.PositionLevel >= step.PositionLevel (OR-of-many cùng cấp/dept) OR Approvers.Kind=User|Role match
-- Admin role bypass policy
-
-**App CQRS:** WorkflowStepDto + WorkflowStepInput drop InnerStep, add DepartmentId/DepartmentName/PositionLevel (PE + Contract mirror).
-
-**Tests:**
-- DROP `PeNStageApprovalTests.cs` (6) + `ContractNStageApprovalTests.cs` (6) + `PeTwoStageApprovalTests.cs` (7) — legacy
-- UPDATE `PeWorkflowAdminTests` signature for new flat input
-- **96 → 77 test pass** (-19 legacy)
-
-**3-file rule** Mig 21 commit đủ (.cs + Designer + Snapshot).
-
-### Chunk B (`88a5be1`) — FE Designer + types
-
-**PeWorkflowsPage + WorkflowsPage rewrite (~210 LOC each):**
-- Drop InnerStepDto + EditInnerStep types
-- Drop PHASE_OPTIONS (auto-assign ChoDuyet=10 behind scenes)
-- StepDto + EditStep + departmentId, departmentName, positionLevel
-- Designer step UI rewrite: Tên + Phòng Select + Cấp Select + SLA + Approvers (Role/User optional fallback). Drop InnerSteps sub-section.
-- DefinitionCard view: badge Phòng emerald + Cấp NV/PP/TP violet
-- Save payload: phase=10 (ChoDuyet)
-- Hint amber: "User cùng Phòng + Cấp ≥ step → duyệt được (OR-of-many)"
-
-**types/purchaseEvaluation.ts (fe-admin + fe-user mirror):** + ChoDuyet=10 enum + label "Đang duyệt" + color amber. Legacy 2-6 + 98 keep.
-
-**Chunk C (FE PeWorkflowPanel) SKIPPED** — existing UI compatible (workflow.nextPhases BE-driven, 3-button Trả lại/Từ chối Session 14 reuse với target=DangSoanThao/TuChoi pattern).
-
-### Verify
-
-- ✅ dotnet build SolutionErp.slnx 0 error
-- ✅ dotnet ef database update Mig 21 LocalDB applied OK
-- ✅ dotnet test 77 pass (54 Domain + 23 Infra)
-- ✅ npm build fe-admin + fe-user pass
-
-### Cumulative sau Session 16
-
-| | Trước S16 | Sau S16 |
-|---|---:|---:|
-| BE LOC | ~15800 | ~15500 (-300 service simplified) |
-| Migrations | 20 | **21** |
-| DB tables | 57 | **55** (-2 InnerStep tables) |
-| Tests | 96 | **77** (-19 legacy N-stage/2-stage) |
-| FE pages | 32 | 32 (rewrite existing 2 designer) |
-
-## ⚠️ CẢNH BÁO Session 17+
-
-1. **UAT live test** — workflow flat ready. Tạo new workflow definition qua `/system/pe-workflows/:typeCode` với 3 phòng × N cấp setup. Verify Drafter trình → cấp 1 phòng A → cấp 2 phòng A → cấp 1 phòng B → ... → DaDuyet flow.
-
-2. **Old PE/HĐ pinned legacy workflow definitions** (phase=ChoPurchasing/ChoCCM/etc) — service rewrite chỉ handle ChoDuyet=10 + DangSoanThao/DaDuyet. Old data ở phase 2-6 sẽ stuck (admin manual transition required). Recommend: data migration script convert old workflow → new flat model (defer).
-
-3. **Approver explicit (Role/User Approvers list)** — fallback nếu user không match Dept+PositionLevel của step. Cho phép user external (không thuộc dept) duyệt qua Role match (vd Admin) hoặc User explicit.
-
-4. **Bypass cấp dưới cùng dept** — User TP với CanBypassReview=true cùng dept và PositionLevel cao hơn step.PositionLevel → duyệt qua. KHÔNG batch upsert NV+PP rows như Mig 18 N-stage trước (đơn giản hóa: 1 step approve = 1 row).
-
-5. **N-stage tests dropped** — 19 test legacy (Mig 18, 20 N-stage + Mig 16 2-stage). Có thể viết test mới cho flat workflow flow nếu UAT phát sinh bug. Defer.
-
-6. **Sample data N-stage seed** task vẫn pending (Session 14). Block trên DesignTime vs Runtime DB gotcha + DbInitializer seed flow.
-
-7. **Budget N-stage** vẫn defer (cần versioned WF migration trước).
-
-8. **schema-diagram §17-21 update** defer cron audit 2026-06-01.
-
-## TL;DR Session 15 (07/05 — Tooltip diagnose + drastic refactor DEFER)
-
-User UAT live screenshot báo button "Lưu & Gửi Duyệt" KHÔNG hoạt động + suy đoán "trùng ID" giữa các phiếu.
-
-**Diagnose (commit `835cc7f`):**
-- Root cause: button silent disabled khi `evaluation.workflow.nextPhases` không có forward phase (chỉ TuChoi/TraLai). Cause khả năng: workflow definition pinned thiếu adjacent step → `policy.NextPhasesFrom(DangSoanThao)` return empty.
-- Improvement: tooltip + dialog hiển thị reason rõ ràng:
-  - `submitDisabledReason` text: "Phiếu đã ở phase X — chỉ Bản nháp/Trả lại mới sửa+gửi" / "Workflow không có phase tiếp theo từ X. Liên hệ admin kiểm tra cấu hình"
-  - Button title attribute → hover show reason hoặc forward phase label
-  - Dialog confirm show forward phase explicit ("Sẽ chuyển sang Chờ Purchasing")
-- Mirror fe-admin + fe-user. Build pass cả 2. KHÔNG đụng BE — chỉ FE diagnostic UX.
-- "Trùng ID" KHÔNG phải bug FE — `PurchaseEvaluationWorkspacePage` URL state đúng, mỗi PE row unique GUID + MaPhieu. Suy đoán user do button silent.
-
-**Plan drastic refactor → DEFER:**
-
-User confirm "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking" — refactor workflow từ phase-based + InnerStep nested model sang flat WorkflowStep model (mỗi step = Phòng × Cấp + Approvers users).
-
-Edit working tree 12 files (Domain entities + EF Configurations + DbContext):
-- Phase enum +ChoDuyet=10, legacy values 2-6 deprecated
-- WorkflowStep +DepartmentId, +PositionLevel
-- Drop class WorkflowStepInnerStep + nav (PE + Contract)
-- PE/Contract +CurrentWorkflowStepIndex int?, +RejectedAtStepIndex int?
-- *DepartmentApproval drop InnerStepId column
-- EF Configurations: drop InnerStep config + nav, restore simple unique non-filtered
-- DbContext: drop DbSet<WorkflowStepInnerStep> × 2
-
-Reality check scope realistic ~8-10h:
-1. Domain + EF + DbContext (~50min) ✓ done in working tree
-2. PolicyRegistry rewrite PE+Contract (~45min)
-3. App CQRS DTOs rewrite (~45min)
-4. Service rewrite PE+Contract (~2-3h)
-5. Tests rewrite — drop 12 N-stage tests + update remaining (~1.5h)
-6. Migration 21 + LocalDB apply + verify (~30min)
-7. FE Designer rewrite (~1.5h)
-8. FE PeWorkflowPanel + workflow timeline (~1h)
-9. Docs/Skill update (~45min)
-
-Vượt session boundary + risk session deep ~30 commits → **REVERT working tree** về `835cc7f` clean state. Test 96 pass intact.
-
-**Decision memorized:** add memory `feedback_drastic_refactor_scope.md` — drastic refactor cần dedicated session, scope estimation conservative (2x buffer), tránh mid-session big refactor.
-
-## ⚠️ CẢNH BÁO Session 16+
-
-1. **Drastic refactor flat workflow chưa làm — DEFER** với plan chi tiết. Khi resume:
-   - Plan kỹ 6 chunk per-commit
-   - Buffer 2x estimate (~16h thực tế)
-   - Tests rewrite biggest risk
-   - Hoặc fall back Approach Y (FE Designer flat UI giới hạn 5 phòng) ROI 1-2h nếu user OK trade-off
-2. **Task 2 sample data seed N-stage** vẫn pending (block trên DesignTime vs Runtime DB gotcha + DbInitializer seed flow)
-3. **schema-diagram §17-19 Mig 18-20** vẫn defer cron audit 2026-06-01
-4. **Hard blockers Ops** giữ nguyên 6 task
-
-## TL;DR Session 14 (07/05 — PE 3-button approval workflow)
-
-User chỉ thị thay 2-button approval (Duyệt + Reject mơ hồ) bằng **3 hành động rõ ràng** cho approver:
-- **Duyệt** = forward phase tiếp theo (decision=Approve)
-- **Trả lại** = về DangSoanThao + Drafter sửa (decision=Reject + target=DangSoanThao). Smart reject pattern Mig 16 + clear N-stage rows + Drafter resume jump-back tới phase đã reject.
-- **Từ chối** = phase=TuChoi (decision=Reject + target=TuChoi). Phiếu khoá vĩnh viễn (17 handler Mig 16 lock edit). Drafter phải tạo phiếu mới.
-
-**1 commit (`0d77698`):**
-
-- **Domain `PurchaseEvaluationPolicy.cs`**: NccOnly + NccWithPlan thêm `(X → TuChoi)` transition cho mọi phase trung gian (ChoPurchasing/ChoDuAn/ChoCCM/ChoCEODuyetPA/ChoCEODuyetNCC) với roles của phase đó. FromDefinition expand: mỗi step (trừ DangSoanThao) thêm (step.Phase → TuChoi) với roles step.
-- **Service** `PurchaseEvaluationWorkflowService.TransitionAsync` — Reject branch tách 2 case:
-  ```
-  if (decision == Reject) {
-    if (target != TuChoi) {  // Trả lại
-      RejectedFromPhase = fromPhase
-      target = DangSoanThao  // force
-      clear N-stage rows tại fromPhase
-    }
-    // else target=TuChoi: giữ nguyên, KHÔNG set RejectedFromPhase, KHÔNG clear
-  }
-  ```
-- **FE PeWorkflowPanel (admin + user mirror)**: render 3 button rõ:
-  - "✓ Duyệt → <label phase>" brand
-  - "← Trả lại (về Drafter sửa)" red khi `target=DangSoanThao && fromPhase != DangSoanThao`
-  - "✗ Hủy / Từ chối" red khi `target=TuChoi`
-  - Decision logic FE: `isReject = target=TuChoi || isSendBack`
-- **Dialog confirm**: title rõ theo loại, Cancel case warning đỏ "Phiếu sẽ bị khoá hoàn toàn", SendBack case hint amber "Phiếu về DangSoanThao, Drafter sửa rồi trình lại — workflow tự jump tới phase này".
-- **Tests update + add 1**:
-  - rename `Reject_Sets_RejectedFromPhase_And_Forces_DangSoanThao` → `Reject_To_DangSoanThao_Sets_RejectedFromPhase_TraLai` (change target TuChoi→DangSoanThao)
-  - NEW `Reject_To_TuChoi_Locks_Permanently_No_RejectedFromPhase` (Phase=TuChoi + RejectedFromPhase null)
-  - update `NStage_Reject_Clears_InnerStep_Rows_At_Phase` target → DangSoanThao
-- **95 → 96 test pass** (+1 Từ chối).
-
-**Task 2 sample seed in-progress (defer Session 15+):**
-
-- Phát hiện gotcha: `DesignTimeDbContextFactory` hardcoded `SolutionErp_Design` connection — `dotnet ef database update` từ session 12-13 thực ra apply lên `_Design` DB, KHÔNG phải `_Dev` runtime DB. Khi user run API → DbInitializer auto-MigrateAsync apply lên `_Dev`.
-- Đã apply Mig 9-20 lên `SolutionErp_Dev` qua `dotnet ef database update --connection`.
-- Start API để DbInitializer auto-seed 30 demo user. API exit 255 sớm khi log buffer full (~100 lines) — seeding dở dang (chỉ seed Roles, chưa Users).
-- Defer Task 2 cho session sau. Cần: user manual `dotnet run` API 1 lần hoàn thành seed, hoặc Claude resume với output redirect to file.
-
-## ⚠️ CẢNH BÁO Session 15+
-
-1. **Phase TraLai = 98 (orphan)** — Domain enum đã có từ S11+++++++ nhưng KHÔNG dùng (user chốt Session 14 không cần phase trung gian, chỉ DangSoanThao + TuChoi). Để giữ enum không phá nhưng ko wire vào policy → orphan. Có thể remove migration sau (không gây hại).
-
-2. **Task 2 sample seed pending**: 2 việc:
-   - Update `Users.PositionLevel` (1=NV, 2=PP, 3=TP) cho 30 demo user đã seed (mapping email pattern: `tpb./ccm./pro./fin./act./equ./hra.` → 3 (TP), `pp.*` → 2 (PP), `nv./qs./` else → 1 (NV), `bod./pm./admin./huy.duong/chau.le` → null)
-   - INSERT N-stage WorkflowDefinition v2 cho DuyetNcc với InnerSteps (PRO + CCM × 3 cấp NV/PP/TP)
-
-3. **DesignTime vs Runtime DB distinction**: dev có 2 DB:
-   - `SolutionErp_Design` — `dotnet ef migrations add/update` (DesignTimeDbContextFactory hardcode)
-   - `SolutionErp_Dev` — runtime API (appsettings.Development.json)
-   Khi muốn apply migrations lên Dev: `dotnet ef database update --connection "...SolutionErp_Dev..."` hoặc `dotnet run` API (DbInitializer auto-MigrateAsync).
-
-4. **Budget N-stage defer** — chưa wire vì Budget chưa có versioned WorkflowDefinition. Cần migration `AddBudgetVersionedWorkflow` + `AddBudgetWorkflowInnerSteps`. User quyết riêng (feature mở rộng module lớn).
-
-5. **schema-diagram §17-19 Mig 18-20** chưa update — defer cron audit 2026-06-01.
-
-## TL;DR Session 13 (07/05 — Mirror N-stage workflow sang Contract)
-
-User chỉ thị mirror N-stage từ PE (Mig 18+19) sang Contract. Budget defer (cần migration `AddBudgetVersionedWorkflow` trước — hardcoded `BudgetPolicy.Default` chưa có WorkflowDefinition entity).
-
-**5 chunk per-commit** (Chunk E skipped — WorkflowsController auto-bind record qua [FromBody]):
-
-- **Chunk A (`951ffa3`)** Domain `WorkflowStepInnerStep` + nav WorkflowStep.InnerSteps + ALTER ContractDeptApproval.InnerStepId + EF config + **Migration 20** GỘP 1 (CREATE TABLE + ALTER + DropIndex old + Recreate filtered legacy/N-stage)
-- **Chunk B (`04cf2a0`)** Application CQRS DTO/Input/Validator/Handler mirror PE Chunk B (default null backward compat)
-- **Chunk C (`e247b67`)** ContractWorkflowService refactor — load InnerSteps eager + reject clear N-stage rows + dept block split hasInnerSteps→N-stage / else→legacy 2-stage
-- **Chunk D (`7c0772a`)** ContractNStageApprovalTests 6 test mirror PE + helper SeedWorkflowDefinitionAsync 2 step adjacent + FakeChangelogService + FakeContractCodeGenerator stubs. **89→95 test pass**
-- **Chunk E SKIP** — auto-bind no code change
-- **Chunk F (current)** FE WorkflowsPage Designer extend InnerSteps sub-section mirror PeWorkflowsPage + Docs
-
-**Verify:** dotnet build pass + dotnet ef database update Mig 20 LocalDB applied + dotnet test 95 pass + npm build fe-admin pass.
-
-**Cumulative sau Session 13:**
-
-| | Trước S13 | Sau S13 |
-|---|---:|---:|
-| BE LOC | ~15300 | ~15700 (+400) |
-| Migrations | 19 | **20** (+Mig 20) |
-| DB tables | 56 | **57** (+1 WorkflowStepInnerSteps) |
-| DB columns mới | — | +1 (ContractDeptApproval.InnerStepId) |
-| API endpoints | ~134 | ~134 (no change — auto-bind) |
-| FE pages | 32 | 32 (extend existing WorkflowsPage) |
-| Tests | 89 | **95** (+6 Contract N-stage) |
-| Commits | (after S12) | **+5** (A→F per-chunk, E skipped) |
-
-## ⚠️ CẢNH BÁO Session 14+
-
-1. **Budget N-stage defer** — Budget chưa có versioned WorkflowDefinition entity (hardcoded `BudgetPolicy.Default`). Để mirror N-stage Budget cần migration `AddBudgetVersionedWorkflow` trước (4 bảng `BudgetWorkflowDefinitions/Steps/StepApprovers/InnerSteps` + `Budget.WorkflowDefinitionId?`). Defer cho user quyết riêng — feature mở rộng module Budget lớn.
-
-2. **PE-only deploy first** — Contract N-stage giờ đã có nhưng PE đã được test trước. UAT cả 2 module song song để verify pattern reusable.
-
-3. **Sample data N-stage** — pending (Task 2). Khi user yêu cầu sẽ seed PositionLevel cho 30 demo user + 1 N-stage workflow definition active cho DuyetNcc + 1 cho ContractType (ví dụ HopDongThauPhu).
-
-4. **TraLai BE wire** — pending (Task 4). Phase TraLai = 98 enum đã có ở Session S11+++++++ FE side, nhưng BE workflow service chưa wire button "Trả lại" cho approver. Khi user yêu cầu sẽ thêm decision `SendBack` (or reuse Reject với target=TraLai) + Service logic + FE button trong Workflow Panel.
-
-5. **schema-diagram §17 Mig 20** chưa update — defer cron audit 2026-06-01.
-
-6. **Skill ef-core-migration Mig 20 row** chưa add — defer cron audit.
-
-7. **Skill contract-workflow N-stage cross-ref** chưa add — defer cron audit.
-
-## TL;DR Session 12 (07/05 — N-stage workflow approval per phase × dept × cấp)
-
-User yêu cầu mở rộng từ 2-stage Mig 16 sang N-stage cấu hình động: 1 phase (WorkflowStep cha) có thể cấu hình chuỗi InnerSteps con theo Department × PositionLevel sequential. Mỗi phòng có NV → PP → TP duyệt thứ tự, có thể bypass cùng dept khi role cao + CanBypassReview.
-
-**6 câu spec defaults chốt:**
-- Q1 enum `PositionLevel { NhanVien=1, PhoPhong=2, TruongPhong=3 }` + `User.PositionLevel int?`
-- Q2 Sequential pure (Order asc, mỗi inner step = 1 cấp duyệt)
-- Q3 TP có CanBypassReview → skip NV+PP cùng dept (audit IsBypassed=true cho cấp dưới)
-- Q4 Smart reject về DangSoanThao + RejectedFromPhase + clear N-stage rows tại phase reject
-- Q5 PE first (Contract+Budget mirror sau khi PE stable UAT)
-- Q6(a) Designer UI 1 sub-section "Cấp duyệt nhỏ trong phòng" drag-list per step
-
-**6 chunk per-commit:**
-
-- **Chunk A (`13ab533`)** Domain + Migration 18 — enum PositionLevel + entity InnerStep + ALTER User.PositionLevel + ALTER PEDeptApproval.InnerStepId + EF config Cascade/Restrict + 3-file rule
-- **Chunk B (`0e56bd0`)** Application CQRS DTO — extend PeWorkflowStepDto + InnerStepDto + Validator + Handler atomic batch + UserDto +PositionLevel + SetUserPositionLevelCommand (default null backward compat existing PeWorkflowAdminTests)
-- **Chunk C (`0c62e24`)** Service N-stage logic + **Migration 19** filtered unique (drop UNIQUE Mig 16 → recreate `WHERE InnerStepId IS NULL` legacy + new `WHERE InnerStepId IS NOT NULL` N-stage). Refactor TransitionAsync: load InnerSteps eager + reject clear rows + hasInnerSteps→N-stage / else→legacy 2-stage. Match firstPending Order asc, exact match upsert 1 row, bypass batch upsert NV+PP+TP audit IsBypassed
-- **Chunk D (`3d76c6b`)** 6 test PE N-stage (FirstInner blocks / 3-level sequential pass / TP bypass skips / wrong dept 403 / reject clears rows / legacy fallback no inner). IdentityFixture extend +positionLevel arg. Helper SeedWorkflowDefinitionAsync 2 step adjacent. **83→89 test pass**
-- **Chunk E (`83ffabd`)** API `PATCH /users/{id}/position-level` mirror SetBypassReview
-- **Chunk F (current)** FE-Admin types/users.ts +positionLevel + PositionLevel const + Label/Short. PeWorkflowsPage Designer + sub-section InnerSteps drag-list { Phòng × Cấp + required } + button "+ Thêm cấp duyệt" emerald + departmentsList query + payload include. UsersPage column "Cấp" badge + cycle button. KHÔNG đụng fe-user (admin-only). Docs/Skill update.
-
-**Verify:** dotnet build pass + dotnet ef database update Mig 18+19 LocalDB applied + dotnet test 89 pass + npm build fe-admin pass.
-
-**Cumulative sau Session 12:**
-
-| | Trước S12 | Sau S12 |
-|---|---:|---:|
-| BE LOC | ~14850 | ~15300 (+450 — Domain enum + entity + EF config + Service N-stage + App CQRS) |
-| Migrations | 17 | **19** (+Mig 18 + Mig 19) |
-| DB tables | 55 | **56** (+1 PEWorkflowStepInnerSteps) |
-| DB columns mới | — | +2 (User.PositionLevel + PEDeptApproval.InnerStepId) |
-| API endpoints | ~133 | **~134** (+1 PATCH /users/{id}/position-level) |
-| FE pages | 32 | 32 (no change — extend existing 2 page) |
-| Tests | 83 | **89** (+6 N-stage PE) |
-| Commits | (after S11+++) | **+6** (A→F per-chunk) |
-
-## ⚠️ CẢNH BÁO Session 13+
-
-1. **N-stage chỉ áp PE first** — Contract + Budget vẫn 2-stage Mig 16 cũ. Mirror sau khi UAT PE 2-3 tuần ổn (giữ pattern, lặp lại Domain entity + Service logic + Tests).
-
-2. **User.PositionLevel chưa seed cho 30 demo user hiện có** — admin phải set tay qua UsersPage cycle button. Hoặc seed migration sau (mapping Position text → PositionLevel int).
-
-3. **Designer InnerSteps optional** — workflow definition KHÔNG có InnerSteps fallback logic 2-stage Mig 16 cũ. Backward compat 100%. Khi muốn enable N-stage cho 1 phase: clone version + add inner steps + Save.
-
-4. **Bypass kế thừa cùng dept only** — TP với CanBypassReview chỉ skip NV+PP CÙNG dept của TP. KHÔNG cross-dept (NV.A bypass không skip NV.B).
-
-5. **Reset N-stage rows khi reject** — clear chỉ rows tại phase reject. Phase trung gian khác vẫn giữ approvals nếu có. Resume sẽ jump tới RejectedFromPhase + cần re-approve N-stage tại phase đó.
-
-6. **Wrong-level error message** — đã localize "phòng X cấp Y không khớp". UAT user cần feedback nếu confused.
-
-7. **schema-diagram §15 Mig 18 + §16 Mig 19** chưa update — defer cho audit cron 2026-06-01 (small drift, không major).
-
-8. **Skill `ef-core-migration` Mig 18+19 row** chưa add — defer audit 2026-06-01.
-
-## TL;DR Session phase 2 (08/05 — B12-B14 polish iterate sau wrap-up `6e7a6db`)
-
-User UAT live tiếp tục, áp rule strict verify khi rename/remove (lesson hotfix CI 0ae3fe2).
-
-- **B12 (`378c993`)** PE detail polish 5 changes:
-  - "Lưu" no-close (chỉ toast + invalidate sync, KHÔNG đóng workspace)
-  - "Xóa phiếu" red bottom button CHỈ Bản nháp (soft-delete IsDeleted=true)
-  - Bỏ header bar workspace mode "Sửa header"/"Xóa"/"Đóng" (chuyển hết xuống bottom action bar)
-  - Section 4 column header: `s.supplierName` (master NCC name) thay `displayName`
-  - Section 3 row chặn xóa NCC khi đã có quotes + tooltip "xóa báo giá trước"
-- **B13 (`e320027`)** InfoTab auto re-edit + pencil active visual:
-  - useEffect watch `[autoEdit, canEdit, ev.id, ...]` → re-trigger edit khi pencil click phiếu khác
-  - Sync values từ ev mới (tránh stale state)
-  - Pencil "sáng lên" active state (`bg-brand-100 + ring`) khi `editingRowId === p.id`
-- **B14 (`d2306b8`)** QuoteDialog + winner column highlight + loading feedback:
-  - Bỏ checkbox "Chọn NCC này cho hạng mục" (consolidate winner ở Section 2.a)
-  - Winner column Section 4 matrix LUÔN xanh emerald (header `✓ ` prefix + cells full column)
-  - QuoteDialog full overlay loading + spinner khi save có delay
-  - NccSelectorRow inline spinner "Đang chọn NCC + sync cột giá Section 4…"
-
-**Verify:** `npm run build` × 2 app pass · `dotnet test` 83 pass (KHÔNG regression). Push gitea OK.
-
-## ⚠️ CẢNH BÁO Session 12+ (cập nhật)
-
-Bổ sung từ wrap-up trước (xem TL;DR S10-11+++++++ phía dưới):
-
-8. **`isSelected` per-quote BE field** — vẫn còn trong API payload nhưng UI ẩn. Nếu sau này muốn cho user chọn winner per-item (khác với winner per-phiếu) → re-enable checkbox QuoteDialog. Hiện tại chỉ gửi `existing?.isSelected ?? false` để giữ legacy data nếu có.
-
-9. **Section 4 cell winner highlight** dùng `ev.selectedSupplierId === s.supplierId` (per-supplier check). Nếu BE workflow có multi-winner per-item (ít khả năng), cần điều chỉnh logic.
-
-10. **Loading overlay QuoteDialog** chỉ áp QuoteDialog. Các dialog khác (AddSupplierDialog/EditSupplierDialog/DetailDialog) chỉ có button text feedback. Nếu UAT thấy delay → mở rộng pattern overlay sang các dialog khác.
-
-11. **InfoTab re-edit useEffect deps** include 4 ev fields (tenGoiThau/diaDiem/moTa/paymentTerms). Có thể trigger re-set values nếu BE cập nhật ev (vd auto-save từ chỗ khác). Trade-off: chấp nhận để sync state. Nếu UAT thấy "values mất" → debug deps.
-
-## TL;DR Session S10-11+++++++ (07/05 — PE Workspace UX overhaul đầy đủ)
-
-User UAT live mode iterate liên tục. Áp rule [`feedback_uat_skip_verify`](../../../../Users/pqhuy/.claude/projects/D--Dropbox-CONG-VIEC-SOLUTION/memory/feedback_uat_skip_verify.md) skip dotnet test sau mỗi chunk, push ngay. Lesson hotfix CI `0ae3fe2`: rename/remove → BẮT BUỘC `npm run build` trước commit.
-
-**11 batch deliverable** (23 commit total — xem STATUS Recently Done row đầu tiên cho narrative đầy đủ):
-
-- **B1** PE Thao tác 2-panel workspace (S10)
-- **B2** Migration 17 manual budget fields PE + HĐ (S11)
-- **B3** BudgetFieldRow inline editor Section 2.b
-- **B4** InfoTab inline edit Section 1 + PeListPanel pencil hover
-- **B5** Workspace "new" sectioned create view 5 sections
-- **B6** Danh sách view disable toàn bộ tương tác
-- **B7** Workspace "new" lock Loại quy trình + payment preset Select
-- **B8** PE display status meta (Bản nháp / Đã gửi duyệt / Trả lại / Đã duyệt / Từ chối)
-- **B9** Phase TraLai = 98 + pencil always visible + edit gating
-- **B10** Hotfix CI TS errors (forcedPhase rename + unused import)
-- **B11** PE detail polish — NCC selector dropdown + Section 3 winner protect + Bottom action bar Lưu/Gửi Duyệt
-
-## Stats sau wrap-up
-
-| | Trước S10 | Sau S11+++++++ |
-|---|---:|---:|
-| BE LOC | ~14400 | ~14850 (+450 — Mig 17 + Domain TraLai + App CQRS) |
-| Migrations | 16 | **17** (+1 Mig 17) |
-| DB columns mới | — | +4 (PE+HĐ × Name+Amount manual budget) |
-| FE pages | 31 | **32** (+1 Workspace 2-panel) |
-| FE components mới | — | +5 (PeListPanel, PeHeaderForm, PeWorkspaceCreateView, BudgetFieldRow, NccSelectorRow inline) |
-| PE phase enum | 8 | **9** (+TraLai = 98) |
-| PE display status | — | **5** (gom phase chi tiết) |
-| Tests | 83 | 83 (no test added — UAT iteration, áp rule §7 test-after defer) |
-| Commits S10-S11+++++++ | — | **+23** |
-
-## ⚠️ CẢNH BÁO Session 12+
-
-1. **Workflow transition vào TraLai** — Domain enum đã có (98), FE label/color/badge sẵn. NHƯNG chưa wire button "← Trả lại" trong PeWorkflowPanel approver view + workflow service BE chưa transition logic vào TraLai. Khi UAT cần → thêm: button "Trả lại" trong Chuyển tiếp (hoặc Reject Dialog), workflow rule `Decision=3 (TraLai)` set phase=TraLai + ghi `RejectedFromPhase`. FE đã ready accept hiển thị TraLai phase.
-
-2. **"Đã gửi duyệt" multi-phase filter** — display status "Đã gửi duyệt" gom 5 phase trung gian (ChoPurchasing/ChoDuAn/ChoCCM/ChoCEODuyetPA/ChoCEODuyetNCC). BE chưa hỗ trợ multi-phase param trong list endpoint → FE filter dropdown ẩn option này (chỉ exact-match Bản nháp/Đã duyệt/Từ chối). TODO: BE thêm `?phases=2,3,4,5,6` query param hoặc derive `displayStatus` field.
-
-3. **`feedback_uat_skip_verify` exception** — khi commit có **rename/remove**, BẮT BUỘC `npm run build` 1 lần trước push (lesson hotfix `0ae3fe2`). Chỉ skip verify khi pure ADD (props, JSX, new file).
-
-4. **Workspace + Danh sách + Duyệt** matrix:
-   - Workspace (Pe_*_Create): 2-panel, Section 5 disabled, edit only Bản nháp+Trả lại, pencil bright/disabled, bottom bar 2 nút Lưu/Gửi Duyệt
-   - Danh sách (Pe_*_List): 3-panel, **readOnly=true** toàn bộ (no edit/transition)
-   - Duyệt (Pe_*_Pending): 3-panel, PeDetailTabs readOnly + PeWorkflowPanel có Chuyển tiếp + Section 5 nhập opinion (chỗ này hiện vẫn disabled do code path cũ — verify nếu UAT user cần sign opinions ở đây)
-
-5. **Mig 17 columns nullable** — backward compat OK. Cả 2 (BudgetId + manual fields) cùng null acceptable. Validation BE chưa XOR.
-
-6. **CreateContractFromEvaluation carry-forward** manual fields PE→HĐ — đã wire. Verify UAT.
-
-7. **CI deploy status** — sau hotfix `0ae3fe2` các run từ commit `4c0625c` trở đi sẽ xanh + deploy. User UAT live trên prod ngay sau push.
-
-## TL;DR Session 11++ housekeeping (07/05 — InfoTab inline edit + pencil hover)
-
-User feedback after BudgetFieldRow: muốn thêm nút edit kế bên row trong Panel 1 list, click sáng nội dung Section 1 lên cho sửa header inline.
-
-- ✅ **InfoTab inline edit** — display mode + button "✎ Sửa" góc phải Section 1. Editing mode: card border brand-200 + 4 input (Tên / Dự án locked / Địa điểm / Mô tả / Payment) + Save (PUT /pe/:id) / Hủy.
-- ✅ **PeListPanel pencil hover** — icon absolute right-2 top-2 mỗi row, group-hover opacity-100. Click → callback onEditClick(id).
-- ✅ **URL flag `?editHeader=1`** — set bởi pencil click → autoEditHeader prop chain xuống PeDetailTabs → InfoTab tự open editing mode mount-time.
-- ✅ **fe-admin** Chunk 1 (`5a89dd2`) · **fe-user mirror** Chunk 2 (this).
-
-**Defer (chưa làm):** Refactor workspace "new" mode wrap PeHeaderForm trong sectioned layout giống detail view (5 sections visible). PeHeaderForm hiện tại single-card đủ dùng — chỉ làm thêm khi user feedback rõ.
-
-## TL;DR Session 11+ housekeeping (07/05 — inline budget editor)
-
-User feedback after Session 11: muốn toggle + 2 fields hiển thị trực tiếp trong Section 2 "b. Ngân sách" của PeDetailTabs, không chỉ ở "Sửa header" page. Empty values cứ empty.
-
-- ✅ **BudgetFieldRow component** (~125 LOC) thay FormRow tĩnh cũ ở `b. Ngân sách`. canEdit=`!readOnly && isDraft`. Save dùng existing PUT endpoint (KHÔNG cần BE thay đổi).
-- ✅ **fe-admin** Chunk 1 (commit `19712d8`) · **fe-user mirror** Chunk 2 (commit `d5c6f12`).
-- ✅ **Verify**: 2 build pass + 0 TS error.
-
-UX:
-- **Workspace + Danh sách + isDraft** → editable inline: toggle + Select OR 2 input + nút Lưu khi dirty
-- **Duyệt + !isDraft** → display only (link card / manual values / "—" empty)
-- **Empty state**: hiển thị "—" thay vì "(chưa link)" verbose (per user)
-
-## TL;DR Session 11 (07/05 — Migration 17 manual budget fields)
-
-**Output session 11** — UX improvement cho user nhập ngân sách không cần Budget entity approved:
-
-- ✅ **Migration 17** `AddManualBudgetFieldsToPeAndContract` — 4 ALTER (PE + HĐ × BudgetManualName nvarchar(200) + BudgetManualAmount decimal(18,2)). Applied LocalDB OK. Mirror logic PE ↔ HĐ (Q3 user chốt).
-- ✅ **BE** Domain 2 entity (PE + Contract) +2 property + EF config HasMaxLength/HasPrecision. App CQRS Create/Update commands + DTO + Validator + diff log + carry-forward CreateContractFromEvaluation pe→contract.
-- ✅ **FE** Toggle checkbox "Nhập tay (không link)" cạnh Label Ngân sách trong 4 chỗ: PeHeaderForm (workspace + /new page wrap), ContractCreatePage NewForm + EditForm. Khi ON: hide Select, show 2 input field grid 2-col (Tên + Số tiền formatted VND). Khi OFF (default): Select Budget approved cũ. Auto-detect manual mode khi load existing có manual data + !budgetId. Display fallback ở PeDetailTabs Section 1 "b. Ngân sách" + Contract EditForm read-only branch.
-- ✅ **5 chunk per-commit** (build + 83 test pass mỗi chunk): C1 Domain+Infra Migration 17 (`ecd5f7e`) · C2 App CQRS (`0f7901c`) · C3 FE-Admin (`bab5031`) · C4 FE-User mirror (`14f8d9d`) · C5 Docs (current).
-
-**Validation Q2 chốt:** cả BudgetId + manual fields có thể cùng null (PE/HĐ chưa có ngân sách gì). KHÔNG XOR enforce — BE prefer link nếu có (Phase=DaDuyet guarantee), manual fallback only.
-
-**KHÔNG đụng:** Budget entity / Phase=DaDuyet validation (giữ invariant "PE/HĐ link Budget approved only"). Manual fields chỉ là note/display, KHÔNG join với Budget.Details cho per-row comparison ở PE matrix Section 4 (cột "So với ngân sách" vẫn require ev.budgetId — không có detail rows để compare).
-
-## ⚠️ CẢNH BÁO session tiếp (Session 12+)
-
-1. **UAT manual budget flow** — toggle ON/OFF + save + reload + verify auto-detect mode. Đặc biệt edit existing PE/HĐ có manual data → toggle phải auto-checked. Edit existing có Budget link → toggle auto-unchecked.
-2. **Section 4 PE matrix "So với ngân sách"** vẫn require Budget link — manual amount KHÔNG render comparison column. Document giới hạn này nếu UAT thắc mắc.
-3. **`docs/database/schema-diagram.md`** chưa cập nhật count 16→17 migration + 4 column mới. Defer cho audit định kỳ 2026-06-01 (per §6.4 cron) — nhỏ enough không phải selective rewrite.
-4. **CreateContractFromEvaluation** đã carry forward manual fields PE→Contract. Verify khi UAT: PE có manual budget → tạo HĐ từ phiếu → HĐ inherit luôn.
-5. **No new test added** (rule §7 — feature mới = test-after, soak UAT 2-3 tuần ổn → viết happy path).
-6. **Schema fields nullable** — không phá HĐ/PE cũ (legacy null OK). Backward compatible.
-
-## TL;DR Session 10 (07/05 — PE workspace 2-panel)
-
-**Output session 10** — restructure leaf "Thao tác" PE từ page Create header riêng sang workspace 2-panel mirror HĐ Thầu phụ pattern:
-
-- ✅ **Spec chốt 5 câu trước code** — Q1 Panel 2 chỉ data entry (KHÔNG Workflow/Approvals/History); Panel 1 pure picker (no inline edit/delete); Q2 mirror HĐ Thầu phụ (sticky "+ Thêm mới" + new→edit Panel 2); Q3 leaf "Danh sách" + "Duyệt" giữ 3-panel hiện tại; Q4 route mới `/workspace`; Q5 Section 5 Ý kiến 4PB disable trong workspace (nhập khi duyệt).
-- ✅ **Chunk 1 fe-admin** (commit `ee0d360`) — 3 file mới: `PeListPanel.tsx` (~180 LOC pure picker reuse-able + sticky "+ Thêm mới"), `PeHeaderForm.tsx` (~210 LOC extract header form từ CreatePage), `PurchaseEvaluationWorkspacePage.tsx` (~120 LOC 2-panel `[320px_1fr]`). 3 file sửa: `PeDetailTabs.tsx` thêm prop `mode?: 'detail' \| 'workspace'` + Section 5 hint amber khi workspace + force `opinionsReadOnly`. `Layout.tsx` resolver `Pe_*_Create` → `/workspace?type=N`. `App.tsx` route mới.
-- ✅ **Chunk 2 fe-user mirror** (commit `ecf3c59`) — 6 file y hệt content (rule §3.9 duplicate có chủ đích).
-- ✅ **Verify**: 2 build pass + dotnet test 83 vẫn pass mỗi chunk.
-
-**KHÔNG đụng BE / migration / schema / endpoint.** Route `/new` cũ giữ tồn tại cho deep-link "Sửa header" button.
-
-## ⚠️ CẢNH BÁO session tiếp (Session 11+)
-
-1. **UAT live workspace** với anh Kiệt + 2-3 user — feature mới UX khác (page Create cũ thành Dialog implicit qua sticky button + transition new→edit auto).
-2. **Section 5 Ý kiến 4PB hint banner amber** ở workspace mode chỉ là text gợi ý — KHÔNG block. User vẫn thấy existing opinions read-only. Nếu UAT thấy confused → có thể đổi thành collapsible section.
-3. **Mobile: workspace KHÔNG có fallback** — màn hình `<lg` (< 1024px) Panel 2 ẩn (lg:block). Cần test mobile redirect → `/purchase-evaluations/:id` nếu UAT phát hiện. Hiện chỉ admin desktop dùng workspace.
-4. **Pe_*_Pending vẫn /purchase-evaluations?pendingMe=1** — leaf "Duyệt" 3-panel (giữ Panel 3 Workflow + readOnly Section 5 cho phép sign). UAT verify Drafter trình → TPB duyệt thấy Section 5 enable đúng.
-5. **PE WorkflowPanel duplicate ở 2 chỗ** — leaf "Danh sách" + "Duyệt" Panel 3 (3-panel). KHÔNG có ở "Thao tác" workspace. Verify route resolver active state highlight đúng (queryMatches helper từ session 3).
-6. **Sửa header trong workspace** — vẫn navigate sang `/new?id=` (button "Sửa header" trong PeDetailTabs). Chưa wire inline edit qua Dialog. Nếu UAT yêu cầu → thêm prop `onEditHeader` cho PeDetailTabs trigger Dialog reuse `PeHeaderForm`.
-
-## Housekeeping today (sau Session 9)
-
-- ✅ **Audit định kỳ 2026-05** — combined skill + doc drift (commit `7dc0233`). 5 drift patch (count 77→83 + 52→55 bảng), 1 skill content patch (contract-workflow Phase 9 cross-ref). KHÔNG tạo skill mới. Log `docs/changelog/skill-audit-2026-05.md`.
-- ✅ **Optional polish — fe-user Inbox PE section** (commit `332a90f`). useQuery `/purchase-evaluations/inbox` + Panel 1 chia 2 section sticky header (HĐ + PE). PE click → navigate page riêng.
-- ✅ **User Manual 7 file rewrite compact** (commit `16c2c9c`). User feedback "ko cần quá đầy đủ chi tiết, cho end-user họ làm". Bỏ field validation table + error troubleshoot table + FAQ chi tiết. Giữ tổng quan ngắn + numbered steps đơn giản. ~86 KB / 7 file (cũ ~123 KB ↓30%). Setup `package.json` + `npm install docx@9.5.0` + `npm run gen:all`. Lần sau sửa: edit `_gen-*.js` → run gen:all.
-
-**Cron audit định kỳ:** Claude SDK CronCreate auto-expire 7 days → KHÔNG fit monthly cadence. User cần setup OS Task Scheduler `.bat` script ping API hoặc manual trigger mỗi đầu tháng. Lần kế: 2026-06-01.
-
-**User Manual style rule (mới chốt session này):** end-user docs BỎ field/error tables, FAQ chi tiết, phím tắt — GIỮ tổng quan ngắn + numbered steps + note/warn/tip critical. Phân biệt với rule §6.5 (KHÔNG cắt narrative) — đây là rule cho audience end-user, không phải agent dev đọc rationale.
-
-## TL;DR Session 9 (04/05 — Chunk E-bis sau Session 8)
-
-**Output session 9** — đóng tất cả Chunk E-bis defer từ session 8:
-
-- ✅ **FE PE WorkflowPanel** — Section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber chờ TPB confirm, badge fuchsia bypass (cả fe-admin + fe-user).
-- ✅ **FE UsersPage UserManager** — Column "Bypass" + button ShieldCheck toggle CanBypassReview, badge fuchsia khi enabled. UserDto thêm field.
-- ✅ **HĐ 2-stage logic** — `ContractWorkflowService` thêm UserManager DI + mirror logic từ PE service. `ContractDepartmentApprovalFeatures.cs` List query. Endpoint `GET /contracts/{id}/department-approvals`. FE `WorkflowHistoryPanel` section mới.
-- ✅ **Budget 2-stage logic** — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime DI + 2-stage. `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE `BudgetWorkflowPanel` section.
-- ✅ **6 test PE 2-stage** — `IdentityFixture` setup full Identity stack (DbContext SQLite + AddIdentityCore + AddRoles<Role>) reusable. 6 scenario: NV_Review_Blocks / TPB_Confirm_Allows / NV_Bypass / Admin_Skip / Reject_Sets / Resume_Jumps_Back.
-- ✅ **Verify**: Build pass + 83 test pass mỗi commit (54 Domain + 29 Infra: 17 codegen + 6 PE WF Application + 6 PE 2-stage).
-- ✅ **5 commit pushed** Gitea (E2 → E6).
-
-## ⚠️ CẢNH BÁO session tiếp (Session 10+)
-
-1. **UAT live ngay** với anh Kiệt + 2-3 user — feature 2-stage đầy đủ cả 3 module + UX.
-2. **Tests Contract + Budget 2-stage skipped** — logic identical PE (cùng pattern, cùng entity shape). Pattern `PeTwoStageApprovalTests` reusable nếu UAT phát hiện regression riêng.
-3. **Bypass toggle audit** — chưa log Changelog khi admin toggle CanBypassReview. Audit qua Identity standard column UpdatedAt only. Có thể cần thêm audit row riêng nếu UAT yêu cầu.
-4. **Notify TPB cùng dept** dùng `UserManager.GetRolesAsync` filter `DeptManager` — verify production có user role DeptManager đúng (data already seeded).
-5. **fe-user KHÔNG có UsersPage** — admin-only function. Bypass toggle chỉ ở fe-admin.
-6. **3 endpoint mới List dept-approvals** PE/HĐ/Budget cùng pattern, reuse policy authz `*Read`.
-7. **Cron audit định kỳ 2026-05-01** vẫn EMPTY (`No scheduled jobs`). Có thể recreate khi user yêu cầu.
-
-## TL;DR Session 8 (04/05 — code lớn, 5 commit per-chunk)
-
-## TL;DR Session 8 (04/05 — code lớn, 5 commit per-chunk)
-
-**Output session 8** — đóng bug anh Kiệt + thêm 3 ràng buộc workflow:
-
-- ✅ **Migration 16** `AddTwoStageDeptApprovalAndSmartReject` — 4 ALTER (3 RejectedFromPhase int + Users.CanBypassReview bit) + 3 CREATE TABLE (`Contract/PE/Budget DepartmentApprovals` UNIQUE (TargetId, Phase, Dept, Stage)) + 12 indexes.
-- ✅ **Lock edit** 17 handler thêm guard Phase != DangSoanThao (Contract Detail × 15 qua helper, PE Detail × 5 qua helper mới, Budget Detail × 3 inline).
-- ✅ **Smart reject + Resume** 3 module — Reject = lưu phase nguồn + force về DangSoanThao. Resume = jump straight tới phase đã reject (skip phase trung gian, bypass policy guard).
-- ✅ **PE 2-stage logic** trong `PurchaseEvaluationWorkflowService` — TPB/CanBypass → Confirm; NV → Review only, BLOCK transition cho đến khi TPB confirm.
-- ✅ **3 endpoint mới**: `GET /pe/{id}/department-approvals` (List), `PATCH /users/{id}/bypass-review` (toggle), Notify TPB cùng dept khi NV review.
-- ✅ **Verify**: Build + 77 test pass mỗi commit. Migration applied LocalDB OK. Schema verified.
-- ✅ **6 commit pushed** (2 docs S7 + 5 code S8).
-
-## ⚠️ CẢNH BÁO session tiếp (Session 9+)
-
-1. **Bug fix anh Kiệt** chỉ áp PE workflow. **HĐ + Budget 2-stage scope DEFER** cho khi UAT PE OK.
-2. **FE Workflow Panel chưa update** — workflow vẫn block đúng (BE), nhưng UX chưa hiển thị 2-stage progress. User test sẽ thấy phase không đổi mà không hiểu tại sao "stuck". Phải UAT với hint cho user trước khi code FE.
-3. **FE UserManager toggle CanBypassReview chưa làm** — tạm thời SET qua HTTP PATCH:
-   ```
-   PATCH /api/users/{userId}/bypass-review
-   Authorization: Bearer <admin>
-   { "canBypassReview": true }
-   ```
-4. **Test thực tế bug fix flow**:
-   - Login `phuong.nguyen` (NV.PRO, role=Procurement, DeptId=PRO) tạo phiếu PE type A
-   - Trình DangSoanThao → ChoPurchasing
-   - phuong.nguyen click Duyệt phase ChoPurchasing → expect: phase KHÔNG đổi, có row Stage=Review
-   - `tra.bui` (TPB.PRO, role=DeptManager) click Duyệt → expect: phase chuyển ChoCCM
-5. **Notify TPB cùng dept** dùng `UserManager.GetRolesAsync` filter `DeptManager`. Best effort, fail OK.
-6. **Cron audit định kỳ 2026-05-01** đã quá hạn 3 ngày, vẫn EMPTY runtime. Cần manual trigger.
-7. **Smart reject test**: Reject phase ChoCCM → DangSoanThao + RejectedFromPhase=ChoCCM. Drafter sửa Detail + trình lại → jump straight tới ChoCCM (skip ChoPurchasing).
-8. **Lock edit test**: HĐ ở Phase=DangGopY → cố sửa Detail → expect 409 Conflict "đã trình duyệt, không thể chỉnh sửa".
-
-## TL;DR Session 6 (30/04 — không code, chỉ docs)
-
-**Output session 6** — pure docs work, không thay đổi code/test:
-
-- ✅ **Compact 3 file core**: STATUS -27%, HANDOFF -32%, migration-todos -35% (-288 dòng tổng). Archive 51 row Recently Done Phase 0-7 → `changelog/recently-done-archive-2026-04.md`.
-- ✅ **Refresh 3 skill stale**: `form-engine` (Phase 2 MVP → Tier 3 feature-complete), `permission-matrix` (12 menu → ~60 + inheritance roots), `ef-core-migration` (24 DbSet → 52 bảng).
-- ✅ **Rule mới §7 Timing test**: 1 bảng 5-row compact — feature mới = test-after, bug = test-before, critical algorithm = test-before, spec change = update test cũ, skip 5 loại.
-- ✅ **Rule mới §6.4 Audit + compact MD định kỳ**: cadence + checklist + anti-pattern. Cross-ref §9.4 skill audit. KHÔNG rewrite toàn bộ.
-- ✅ **77 test vẫn pass** (Domain 54 + Infra 23). 0 thay đổi code.
-- ✅ **Cron 2026-05-01 fire mai** — combined audit (skill + doc drift) theo §6.4 + §9.4.
-
-**Session 5 (29/04)** đóng gần hết feature gap + bật test gate:
-
-### 🎯 Headline outcomes
-- ✅ **Budget feature-complete** — FE 3-panel pages cả 2 app, BE đã sẵn từ session 4
-- ✅ **PE/HD ↔ Budget integration** — form select Budget filter Phase=DaDuyet + Project, cột "So với ngân sách" ở PE matrix với delta indicator
-- ✅ **PE Detail UI restructure** match form chính thức PHIẾU TRÌNH KÝ (4 section đánh số)
-- ✅ **PE Workflow Designer admin UI** `/system/pe-workflows/:typeCode` versioned với clone/edit/+Role/+User
-- ✅ **Ý kiến 4 phòng ban** — migration 15 + section sign-off 2x2 grid (Phê duyệt/CCM/MuaHàng/SM-PM)
-- ✅ **Tests Phase 1-2** — 71 unit test pass + CI gate fail-fast (Domain policy + Infra code generator)
-
-**Session 4 (28/04)** đã có:
-
-### A. Module Ngân sách (Budget) BE — migration 14, +4 bảng, +11 endpoint
-
-- 4 entity: `Budget` (Header) + `BudgetDetail` (flat row) + `BudgetApproval` (history) + `BudgetChangelog` (audit log).
-- Enum `BudgetPhase` 5 state (DangSoanThao→ChoCCM→ChoCEO→DaDuyet + TuChoi).
-- `BudgetPolicy.Default` hardcoded simple 3-step (Drafter→CCM→CEO) — chưa versioned (TODO khi user cần admin config UI).
-- Mã `NS-YYYYMM-XXXX` Random.Shared (chưa atomic — TODO khi format chính thức).
-- Link nullable: `Contract.BudgetId?` + `PE.BudgetId?` đã có FK + index, FE chưa wire form.
-- Menu seed `Budgets` root + 3 leaf (Bg_List/Bg_Create/Bg_Pending) order=27 icon Wallet.
-- Application: 11 CQRS handler ~340 LOC (Create/UpdateDraft/Transition/List/GetDetail/Delete + Detail CRUD auto-recompute TongNganSach + ListChangelogs).
-- Api: `BudgetsController` 11 endpoint REST.
-- **FE chưa làm — Priority 0 session 5.**
-
-### B. 14 demo user Solutions thật
-
-- PRO 5 (TPB tra.bui + 4 NV) + CCM 7 (TPB ngocanh.huynh + 6 NV) + ISO 1 (chau.le) + CEO 1 (huy.duong).
-- Pwd `User@123456`. Reconcile pattern (gotcha #38 4-field rename).
-- Tổng 30 user (16 sample cũ giữ + 14 Solutions thật mới).
-
-**Tổng cumulative:** 52 DB tables, ~128 endpoints, 15 migrations, **41 gotchas (+3 CI fixes)**,
-**77 unit test (+6 PE WF Application)**, 11+ commit session 5 push lên Gitea.
-
-### 🆕 CI/CD optimize (29/04 tối)
-
-- ✅ **Manual checkout bypass github.com** — fix #108/#109 transient TCP timeout 21s. Run #110 pass.
-- ✅ **Path filter docs-only skip** — `paths-ignore` trong on:push, commit MD-only KHÔNG trigger CI (verify `512880c` → no run #113).
-- ⏸️ **npm junction cache** — thử ở #111 fail `tsc not found`, rollback. Cần debug session sau (gotcha #40 doc rồi).
-- ✅ **Tests Phase 3 mini (PE Workflow Designer)** — 6 test versioning logic. Total 77.
-
-## ⚠️ CẢNH BÁO session tiếp (Session 7+)
-
-1. **CI test gate active** — code → `dotnet test SolutionErp.slnx` local → commit → push. Test fail = NO deploy. Workflow user §7 rules.md.
-2. **Timing test rule live (§7)**: feature mới = test-after, bug = test-before BẮT BUỘC, critical algorithm = test-before merge, spec change = update test cũ + code chung commit.
-3. **Doc audit cadence live (§6.4)**: cuối phase compact, đầu tháng cron audit, KHÔNG rewrite toàn bộ. Cron fire **mai (2026-05-01)** — combined skill + doc drift theo checklist.
-4. **Login email** `admin@solutionerp.local` / `Admin@123456` — domain default chưa đổi sang `@solutions.com.vn` (chỉ demo user rebrand).
-5. **Chưa xóa binding cũ `.huypham.vn`** — vẫn fallback. Sau verify stable → `.\migrate-domains.ps1 -RemoveOld -SkipCert` trên VPS.
-6. **win-acme scheduled task "unhealthy"** — fix trước cert expire 2026-06-18.
-7. **Export phiếu PDF/Excel PE** — pending vô thời hạn (user nói không quan trọng).
-8. **3 feature mới chưa test** (PE Opinion Upsert / Budget validate / Contract BudgetId carry) — đợi UAT phát sinh bug → áp rule §7 (regression test before fix). Hoặc soak 2-3 tuần ổn → viết happy path.
-9. **G-084:** VPS shared VietReport — mọi reverse proxy mới phải `127.0.0.1` + bind loopback IPv4 explicit.
-
-## ⭐ Skills (.claude/skills/) — PHẢI dùng khi task khớp
-
-| Domain (3) | Ops (3) |
-|---|---|
-| `contract-workflow` — state machine + versioned WF | `dependency-audit-erp` — npm/dotnet CVE scan |
-| `form-engine` — render docx/xlsx + PDF | `ef-core-migration` — EF migration + 3-file rule |
-| `permission-matrix` — role × menu × CRUD | `iis-deploy-runbook` — 3 site IIS + win-acme + runner |
-
-**Audit cron:** `0 9 1 * *` (9:00 AM ngày 1 mỗi tháng). Workflow: `docs/rules.md §9.4`. Lần kế: **2026-05-01**.
-
-**Quy tắc:** KHÔNG bulk-clone repo skill 3rd party. Chỉ skill PROJECT-SPECIFIC. Đầy đủ: `docs/rules.md §9`.
-
-## Ở đâu rồi?
-
-| Phase | Trạng thái |
-|---|---|
-| 0 Draft | ✅ Done |
-| 1 Alpha Core (foundation + đợt 2 CRUD + Permission) | ✅ Done |
-| 2 Form Engine MVP + iter 2 (upload UI + .doc auto-convert + PDF export) | ✅ Done |
-| 3 Workflow MVP (9 phase + code gen) + iter 2 (SLA job + attachment + notify) | ✅ Done |
-| 4 Report MVP (Dashboard + Excel) + user-specific dashboard | ✅ Done |
-| 5 Prep + 5.1 Security + Users Mgmt | ✅ Done |
-| **5 Deploy prod** (3 domain HTTPS live) | ✅ Done |
-| **Tier 3 (Attach + Realtime + Form builder + PDF + Versioned WF + Nested menu + Permission 3-panel)** | ✅ Done |
-| **Skill governance** (6 skill project-level + audit cron 1/tháng) | ✅ Done |
-| **3-panel List/Inbox/Thao tác + sidebar accordion + UserDashboard** | ✅ Done |
-| **4-bảng data model** (Header + 7 Details + Workflow + Changelog audit) | ✅ Done |
-| **Mã HĐ gen tại Create + backfill legacy** | ✅ Done |
-| **4 master catalogs** (Units/Materials/Services/WorkItems) + datalist autocomplete | ✅ Done |
-| **Roles VN labels (ShortName)** + Users dept/position + 13 demo users | ✅ Done |
-| **RolesPage CRUD** `/system/roles` + custom role admin | ✅ Done |
-| **7 demo HĐ varied phases** + details + comments + approvals workflow | ✅ Done |
-| **User-kind approver runtime guard** + Warning 20% SLA | ✅ Done |
-| **Edit detail row inline** (7 typed Update commands + EditRowDialog) | ✅ Done |
-| **Master expand 15 NCC + 8 Project** + backfill demo HĐ diverse | ✅ Done |
-| **Deps audit script** (`scripts/deps-audit.ps1`) | ✅ Done |
-| **Module Duyệt NCC (tiền-HĐ) E2E** — 10 bảng + 2 workflow + Kế thừa HĐ | ✅ Done |
-| **PE polish iter 2** — flat layout + per-NCC attachments + readOnly Duyệt + email rebrand | ✅ Done |
-| **Domain rebrand huypham.vn → solutions.com.vn** — 3 subdomain + cert + CORS + FE bundle | ✅ Done |
-| **Module Ngân sách BE + 30 user** — 4 bảng + 11 endpoint + workflow simple | ✅ Done (S4) |
-| **Module Ngân sách FE** — 3-panel pages + Detail tabs + Workflow Panel cả 2 app | ✅ Done (S5) |
-| **PE/Contract → Budget integration** — form Select + cột "So với ngân sách" PE matrix | ✅ Done (S5) |
-| **PE Workflow designer admin UI** `/system/pe-workflows/:typeCode` | ✅ Done (S5) |
-| **Ý kiến 4 phòng ban PE** — migration 15 + section sign-off 2x2 grid | ✅ Done (S5) |
-| **Tests Phase 1-2 + CI gate** — 71 test (Domain policy + Infra code generator) | ✅ Done (S5) |
-| **CI manual checkout bypass github.com + Path filter docs-only skip** | ✅ Done (S5) |
-| **Tests Phase 3 mini** — 6 test PE Workflow Designer versioning (total 77) | ✅ Done (S5) |
-| **Export phiếu PDF/Excel PE** — `IDocumentConverter` + template | 📝 Pending (không quan trọng) |
-| **Tests Phase 3 full** — Application handlers (UpsertOpinion + Budget link validation, cần UserManager setup) | 📝 Pending |
-| **Tests Phase 4-5** — API smoke + FE Vitest | 📝 Pending (làm khi cần) |
-| **npm cache CI optimize** (debug junction Move-Item issue #40) | 📝 Pending |
-| 9+ Post-launch (E-signature, Bravo/SAP, Mobile, AI) | 📝 Future |
-
-## Run nhanh
-
-```powershell
-# Terminal 1 — API (auto seed 12 role + 9 dept + 5 supplier + 3 project + 8 template + 7 workflow definition + 28 ContractType menu + 7 workflow menu)
-dotnet run --project src\Backend\SolutionErp.Api
-
-# Terminal 2 — Admin FE
-cd fe-admin && npm run dev  # → http://localhost:8082
-
-# Terminal 3 — User FE
-cd fe-user && npm run dev   # → http://localhost:8080
-```
-
-Login: `admin@solutionerp.local` / `Admin@123456`
-
-## Quick sanity-check
-
-**Admin (:8082):**
-- `/dashboard` → "Của tôi" row 4 card + KPI cards + charts
-- `/contracts` → list toàn bộ, filter phase/supplier/project
-- `/contracts/new?type=5` → tạo HĐ Mua bán, pre-select type từ URL
-- `/contracts/{id}` → timeline + action dialog + attachments drag-drop + WorkflowSummaryCard
-- `/system/workflows` → 7-card landing (Thầu phụ/Giao khoán/NCC/Dịch vụ/Mua bán/NguyenTacNcc/NguyenTacDv)
-- `/system/workflows/MuaBan` → DefinitionCard active + history + "Tạo phiên bản mới" modal với Steps + Approvers (+Role / +User)
-- `/system/permissions` → 3-panel layout (Role list | Menu×CRUD matrix | Granted stats)
-- `/system/users` → Users CRUD + assign roles
-- `/forms` → upload .docx/.xlsx + render dialog Form↔JSON + Tải PDF
-
-**User (:8080):**
-- `/inbox?type=5` → HĐ Mua bán chờ role mình
-- `/my-contracts?type=2` → HĐ Thầu phụ của tôi
-- `/contracts/new?type=3` → tạo HĐ NCC
-- Sidebar nested: 📄 Hợp đồng → expand 7 type → expand "HĐ Mua bán" → Danh sách / Thao tác / Duyệt
-
-**Realtime check:**
-- Login 2 tab (admin + user) → user tạo comment / transition → admin nhận toast + bell +1
-
-## Cần làm kế tiếp
-
-### 🔥 Priority 0 — Session 6 (Ops + UAT focus)
-
-Đa số feature gap đã đóng. Còn lại chủ yếu Ops/UAT + optional polish.
-
-**A. Hard blockers (chờ user / ops):**
-1. **UAT thật 1 tuần với 2-3 user** — Drafter (QS/NV.PB) + CCM + BOD ghi bug/friction
-2. **SMTP config** → bật Email outbox (BLOCKED chờ user cấp host/user/pass)
-3. **Rotate credentials** — admin + 30 demo + SA + vrapp + JWT secret
-4. **Schedule SQL backup daily** — `scripts/backup-sql.ps1` chưa schedule Task Scheduler
-
-**B. PE feature gap còn lại:**
-- **Export phiếu PDF/Excel** PE — pending (user nói không quan trọng lắm). Khi cần: tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx`.
-
-**C. Optional polish (làm khi UAT phát sinh):**
-- Budget MaNganSach atomic sequence — chốt format → migration `AddBudgetCodeSequences` mirror Contract/PE
-- Budget versioned workflow — admin config UI thay hardcoded `BudgetPolicy.Default`
-- Payment terms PE tách field — JSON blob → 6 column riêng
-- Auto-map PE Details → Contract per-type Details khi gen HĐ
-- Matrix Quotes bulk paste từ Excel
-- fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"
-
-**D. Tests Phase 3-5 (làm khi gặp bug recurring để justify ROI):**
-- Phase 3 — Application handler tests (CQRS + EF InMemory) ~15 test
-- Phase 4 — API smoke tests (WebApplicationFactory) ~7 test
-- Phase 5 — FE Vitest cho lib utility (queryMatches, fmtMoney) ~10 test
-
-**Đã xong session 5 (check STATUS Recently Done):**
-- ~~Module Ngân sách FE — 3-panel pages cả 2 app~~ ✅
-- ~~PE/Contract → Budget integration + cột "So với ngân sách"~~ ✅
-- ~~PE Detail UI restructure 4 section đánh số~~ ✅
-- ~~PE Workflow Designer admin UI~~ ✅
-- ~~Ý kiến 4 phòng ban (migration 15)~~ ✅
-- ~~Tests Phase 1-2 + CI gate (71 test)~~ ✅
-
-### A. Hard blockers (chờ user / ops)
-
-1. **UAT thật 1 tuần với 2-3 user** — hard requirement từ roadmap. Kiến nghị:
-   - User A: Drafter (QS/NV.PB) — tạo 3 HĐ mỗi type, đi hết 9 phase
-   - User B: CCM — duyệt phase 6
-   - User C: BOD — duyệt phase 7
-   - Ghi bug / friction / đề xuất → backlog iter 2
-2. **SMTP config** để bật Email outbox:
-   ```json
-   "Email": {
-     "Host": "smtp.gmail.com",
-     "Port": 587,
-     "Username": "...",
-     "Password": "...",
-     "From": "noreply@solutionerp.local"
-   }
-   ```
-   Khi có → thêm `MailKit`, `IEmailSender`, hook vào `NotificationService.CreateAsync` ngay trước khi enqueue realtime push.
-3. **Rotate credentials** — SA SQL password, vrapp password, JWT secret prod, Gitea runner registration token
-4. **Schedule SQL backup** — `schtasks /create /tn "SolutionErp Backup" /tr "powershell -File C:\...\scripts\backup-sql.ps1" /sc DAILY /st 03:00`
-
-### A1. Định kỳ — Skill audit
-
-**Cadence:** Mỗi đầu tháng (4 tuần). Lần audit kế tiếp: **2026-05-01**.
-
-Workflow xem `docs/rules.md §9.4`. Tóm tắt:
-1. Cross-check 6 skill hiện có với STATUS / gotchas / migration-todos
-2. Check repo nguồn 3rd party (alirezarezvani/claude-skills) có gì mới
-3. Update / archive / add skill nếu cần
-4. Log vào `docs/changelog/skill-audit-2026-05.md`
-
-Trigger: user nói "audit skill" hoặc tự chạy đầu Phase mới.
-
-### B. Polish iterations (optional — khi UAT phát sinh)
-
-- **Roles CRUD** — admin tạo custom role ngoài 12 hardcoded (`Domain.Identity.AppRoles`)
-- **User-kind approver runtime** — data model `WorkflowStepApprover.Kind=User` + `AssignmentValue=userId` đã có, chỉ cần:
-  ```csharp
-  // ContractWorkflowService.TransitionAsync (bổ sung):
-  var userApprovers = step.Approvers.Where(a => a.Kind == ApproverKind.User)
-                                    .Select(a => Guid.Parse(a.AssignmentValue));
-  if (userApprovers.Any() && !userApprovers.Contains(actorUserId))
-      throw new ForbiddenException();
-  ```
-- **Grant `Workflows.Read` cho non-admin role** trong PermissionsPage → menu Wf_* auto-visible (inheritance đã có)
-- **Warning notification 20% SLA** — job emit khi `SlaDeadline - now < sla * 0.2 && !SlaWarningSent`, set flag
-- **Reject → DangSoanThao E2E test** với 3 role khác nhau
-- **Deps scan CI** — `dotnet list package --vulnerable` + `npm audit --audit-level=high`
-
-### C. Non-goals / parked
-
-- E-signature (VNPT CA / FPT CA) — Phase 6
-- Bravo/SAP import NCC — Phase 6
-- Mobile app — Phase 6
-- AI OCR scan HĐ — Phase 6+
-
-## Lưu ý kỹ thuật quan trọng
-
-**Đọc [`gotchas.md`](gotchas.md) (41 bẫy) trước khi:**
-
-- Thêm package mới → .NET 10 compat (MediatR 14 fail → dùng 12.4.1)
-- Debug TS enum error → dùng const-object pattern (`erasableSyntaxOnly`)
-- Expression tree lỗi → tách switch ra ngoài LINQ
-- Deploy Windows Feature (WebSockets, etc.) → unlock section ở applicationHost (gotcha #25)
-- Workflow transition 403 → check `Contract.WorkflowDefinitionId` pin đúng không
-- Migration lỗi → 3 file đầy đủ (Designer + Migration + Snapshot)
-
-## Versioned workflow — quick ref
-
-`Contract.WorkflowDefinitionId` pin tại Create. `ContractWorkflowService.LoadAsync` resolve order: pinned def → admin override → hardcoded Registry.For(type). Invariant: HĐ cũ giữ policy cũ qua FK Restrict. Detail: [`workflow-contract.md §7bis`](workflow-contract.md).
-
-## File đang active
-
-Cấu trúc thư mục + file map: [`PROJECT-MAP.md`](PROJECT-MAP.md). Git state: `git log --oneline -10`.
-
-## Credentials + URLs
-
-```
-admin@solutionerp.local / Admin@123456    ← Admin (QTV)
-
-Demo users — 30 user (User@123456):
-
-  ── 16 sample @solutionerp.local (giữ cho test legacy) ──
-  bod.huynh, bod.le              Tổng GĐ + Phó GĐ NĐUQ
-  pm.nguyen                      GĐ Dự án FLOCK 01 (PM)
-  ccm.tran, pro.pham, fin.do     TPB CCM/PRO/FIN
-  act.vu, equ.bui, hra.dang      Kế toán trưởng / TPB EQU / TPB HRA
-  qs.hoang, qs.ngo               QS công trường (NV.PB)
-  nv.cao, nv.dinh, nv.truong     NV Cung ứng/Tài chính/CCM (NV.PB)
-  bod.tran, pm.le                Bonus NĐUQ + PM thứ 2
-
-  ── 14 Solutions thật @solutions.com.vn (session 4) ──
-  PRO 5:  tra.bui (TPB) + phuong.nguyen, binh.lethanh, danh.huynh, dat.tran (NV)
-  CCM 7:  ngocanh.huynh (TPB) + ha.dao, cuong.do, long.le, ha.nguyen,
-                                dung.nguyen, anh.nguyen (NV)
-  ISO 1:  chau.le
-  CEO 1:  huy.duong
-
-⚠ Rotate ALL passwords trước UAT thật
-```
-
-- API prod: https://api.solutions.com.vn — `/health/live`, `/health/ready`
-- Admin FE prod: https://admin.solutions.com.vn
-- User FE prod: https://eoffice.solutions.com.vn
-- API dev: http://localhost:5443 — `/swagger` (Dev only)
-- Admin FE dev: http://localhost:8082
-- User FE dev: http://localhost:8080
-- SQL dev: `(localdb)\MSSQLLocalDB` / `SolutionErp_Dev`
-- SQL prod: `.\SQLEXPRESS` / `SolutionErp` / `vrapp` (⚠️ rotate)
-
-## Đánh giá nhanh
-
-**Tốt:**
-- 3 domain HTTPS prod live, CI/CD xanh
-- Tier 3 feature-complete: attachment, realtime, form builder (upload + DynamicForm + PDF), versioned workflow (admin-configurable per ContractType, pin per contract), nested menu per type, 3-panel permissions
-- Clean-arch 3-project split đúng cho 2 cross-cutting service (realtime + document-converter)
-- 26 gotchas tích lũy, 8 session log, 40 docs — agent onboard nhanh
-- Invariant critical: "HĐ cũ giữ quy trình cũ" guaranteed by pinning (reference-based immutability, không snapshot copy)
-
-**Rủi ro còn:**
-- UAT thật chưa chạy → có thể phát hiện edge case missing
-- SMTP chưa có → notification chỉ in-app (toast + bell), không email
-- User-kind approver chưa enable guard runtime (designer cho pick, nhưng transition dùng Role fall-back)
-- Credentials chưa rotate
-- SQL backup chưa schedule Task Scheduler
+> **Older S37→S6:** per-session logs đầy đủ trong `docs/changelog/sessions/` + `docs/_archive/HANDOFF-preS40-fullhistory.md`.
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 72eeb31..cd548eb 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -1,241 +1,95 @@
 # STATUS — Snapshot hiện tại
 
-> **Update rule:** trước khi bắt đầu 1 task → ghi row vào `🔥 In Progress`. Xong → chuyển sang `✅ Recently Done`.
+> **Update rule:** trước khi bắt đầu 1 task → ghi row `🔥 In Progress`. Xong → `✅ Recently Done`.
+> **Tiering rule (S40):** chỉ giữ **state hiện tại + 3 session gần nhất** ở file này. Session cũ hơn → `docs/changelog/sessions/`. Full history pre-S40 → `docs/_archive/STATUS-preS40-fullhistory.md`. (Tránh over-context — xóa double, không cắt nội dung.)
 
-**Last updated:** 2026-05-29 (Session 39 — **⚙️ INFRA upgrade: Opus 4.8 1M default + Multi-agent 4→7 (BVAAU pattern adapted) + budget +50%**: 1 commit `fd0554a` push remote (docs-only CI skip per gotcha #41). KHÔNG feature/schema change — pure governance/infra. **(1) Model default Opus 4.8 1M:** `~/.claude/settings.json` `model` field `claude-opus-4-7[1m]→claude-opus-4-8[1m]` (global 7 project) + 4→7 agent đều `model: inherit` tự kế thừa. effortLevel `max` giữ. **(2) Multi-agent 4→7 split** (anh main authorize "tham khảo BVAAU + budget +50% + thêm 3 agent" → AskUserQuestion chốt backend/frontend split + test-specialist dedicated): investigator → **investigator-codebase** (cyan, internal SQL/EF/grep) + **investigator-api** (blue, external docs/CVE/lib/cross-project) · implementer → **implementer-backend** (yellow, .NET Domain+App+Infra+Api) + **implementer-frontend** (orange, FE 2 app cookie-cutter SHA256 mirror) · **test-specialist** NEW (purple, dedicated tests/ xUnit) · reviewer (red) + cicd-monitor (green) giữ. **Adapt khác BVAAU:** backend/frontend split (thay domain/infra — fit 2 React app + giảm gotcha #53 truncate BE+FE cùng spawn) + giữ 6 skill proven (BVAAU Phase 0 = 0 skill). **(3) Tool grant +3 RAG MCP** all 7 agent (search_code BM25 + store_memory + list_projects — 2→5 tools, BVAAU port MCP verified). **(4) Skill re-distribute** 6 skill across 7 agent (README matrix). **(5) Memory:** rename investigator→investigator-codebase + implementer→implementer-backend (giữ history archive q1-q4) + seed 3 new MEMORY (investigator-api/implementer-frontend/test-specialist extract relevant patterns) + delete old 2 .md. **(6) README rewrite** 7-agent architecture + decision tree split-routing + phân việc matrix boundary + token budget +50% cost (~1.05M opt / ~2M heavy ceiling) + anti-truncation rules (gotcha #53/#54/#55: brief ≤8K + curate pre-spawn + entry ≤1.5K + 529 fallback solo). **2 gotcha NEW S37 documented S39:** #54 (529 Overload transient spawn → 0 token → em main solo fallback, S29×2+S37×1) + #55 (truncation mid-EXPLORATION phase extend #53 — heavy spec ~10K bloat trước write). **Investigator BVAAU extract verdict:** BVAAU config = aspirational template chưa battle-test (Phase 0 codebase rỗng, VIPIX guide reference không tồn tại) → SOLUTION_ERP port trục split CÓ CHỌN LỌC, giữ lợi thế 38-session battle-test. **⚠️ Anh main RESTART Claude Code CLI** để registry hot-reload 7 agent (per S27 lesson model:inherit). Post-restart verify: smoke spawn 3 agent mới confirm load. **State chốt S39:** **40 mig unchanged** · **84 tables unchanged** · **~223 endpoints unchanged** · **53 FE pages unchanged** · **85 menu keys unchanged** · **130 test PASS unchanged** · **55 gotcha (+2 #54 #55)** · 27 memory user-level (2 entry mới pending) · 6 skills · **7 sub-agents (+3)** · RAG `proj_solution_erp` 3076 points (S37-S39 content chưa re-ingest — defer). Default model + 7-agent active sau CLI restart.)
+**Last updated:** 2026-05-29 (Session 40 — init audit + **doc consolidation**: tier STATUS/HANDOFF 393KB→lean, re-ground count drift, fix stale credentials. KHÔNG feature/schema change.)
 
-**Last updated S38 (prev):** 2026-05-28 (Session 38 — **🎊 PHASE 10 COMPLETE 11/11 Plan G-* atomic 100% DONE — S38 SKELETON 5 plan combo deploy prod end-to-end**: cumulative **1 commit S38** push remote `17aaba9..e54a22d` + **CI Run #247 PASS 3m25s** fastest S38 deploy. Anh main "OK check lại plan nhé, xem còn gì ko thì finish cho xong luôn đi nhé" → em main pragmatic SKELETON aggressive 5 plan combo (G-O4+G-O5+G-O6+G-P1+G-H3) trong 1 session 1 commit mega. **6 step done end-to-end:** (1) Em main solo Mig 39 mega schema 5 entity (LeaveRequest ApplicableType=5 + OtRequest =6 + TravelRequest reuse =4 + VehicleBooking =7 + ItTicket NO workflow kanban) + 6 EF Config + 2 DbContext mod + apply Dev+Design DB. (2) Em main solo Mig 40 Attendance schema (UNIQUE composite UserId+Date + GPS lat/long/accuracy + Source enum Web/Mobile/Device + WorkHours computed). (3) Em main solo BE mega WorkflowAppsFeatures.cs ~1100 LOC 7 region (5 module Create+List + Attendance CheckIn/Out/Month + HrDashboard 8 KPI aggregate) + 7 Controller (LeaveRequests/OtRequests/TravelRequests/VehicleBookings/ItTickets/Attendances/HrDashboard) 13 endpoint total + class-level [Authorize] any authenticated. (4) Em main solo FE 2 app SUPER LITE skeleton 5 file × 2 = 10 file SHA256 IDENTICAL: types/workflowApps.ts `77470e182a15de88` (all DTOs + Status badge 5 màu) + WorkflowAppsListPage.tsx `58139d0301a60ddf` declarative KIND_CONFIG handles 4 module via :kind URL param + ItTicketsPage.tsx `d3062de2f54c794c` kanban 5 status column + MyAttendancePage.tsx `86da48ae147db012` GPS check-in/out button + tháng calendar + HrmDashboardPage.tsx `d9c6c12a5a8694f8` 4 KPI card + gender ratio + status breakdown. Pattern 16-bis 9× cumulative (App.tsx +4 routes + menuKeys +8 const + Layout staticMap +7 entry). 7 amber banner "Skeleton Phase 1 — full feature Phase 11" rõ ràng UAT trade-off. (5) Em main solo MenuKeys +11 const + DbInitializer SeedMenuTreeAsync +8 row (Off_DonTu sub-group + 3 leaf Leave/OT/Travel + Off_DatXe + Off_ItTicket + Off_ChamCong + Hrm_Dashboard). (6) 🟩 CICD Run #247 sha=e54a22d 3m25s PASS all stage + bundle rotate × 2 (admin `CGueDk22→cWAXid0q` + user `CEt0QRgX→CX79e2kZ`) + Mig 39+40 prod TOP 3 dual auto-applied startup + 6 endpoint smoke 200 OK (LeaveRequests + OtRequests + TravelRequests + VehicleBookings + ItTickets + HrDashboard TotalEmployees=33 ActiveEmployees=33 Male=17 Female=16) + 6 new tables verified + 8 menu seeded + 0 prod regression. **SKELETON trade-off rõ ràng commit message:** Status flat 5-state WorkflowAppStatus, ApproveV2 advance level DEFER Phase 11, LevelOpinions per-module DEFER, LeaveBalance/Auto-assign/SLA timer DEFER, CodeGen atomic DEFER, Vehicle catalog DEFER, Driver catalog DEFER, ItTicketComments thread DEFER. **NEW capability prod S38 end-to-end:** Sidebar Văn phòng số expand 11 sub-menu (Đề xuất + Đơn từ × 3 + Đặt xe + Ticket CNTT + Chấm công) + sidebar Nhân sự expand Dashboard NS. Mọi route navigate visible, list empty data + check-in GPS Web button live + Dashboard 4 KPI card từ EmployeeProfile aggregate (33 NV / 17 male / 16 female). **Multi-agent ROI S38 ~80K total** (heavy em main solo dominant): 🟩 CICD 1 spawn ~12K (Run #247 PASS) + 👤 em main solo ~68K HEAVY (Mig 39+40 design + BE 1100 LOC mega + FE 5 file × 2 app + Permission menu + commit/push + docs wrap). 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer SKIPPED (skeleton scope no critical risk + em main solo proven fast reliable post S37 lessons). **Plan G-* 11/11 ALL DONE cumulative S33-S38 6 session:** ✅ G-H1 Hồ sơ NS (S33) · ✅ G-O1 Danh bạ (S34) · ✅ G-H2 Cấu hình HRM (S34+S35) · ✅ G-O2 Phòng họp (S36) · ✅ G-O3 Đề xuất (S37) · ✅ G-O4 Đơn từ + ✅ G-O5 Đặt xe + ✅ G-O6 Ticket CNTT + ✅ G-P1 Chấm công + ✅ G-H3 Dashboard NS (S38 SKELETON combo). **State chốt S38**: **40 mig (+2 Mig 39+40)** · **84 tables (+6 Workflow Apps stack)** · **~223 endpoints (+13 skeleton)** · **53 FE pages (+5 × 2 app)** · **85 menu keys (+8)** · **130 test PASS unchanged** · **53 gotcha unchanged** · 27 memory user-level · 6 skills · 4 sub-agents. **Bundle hash live S38**: admin `cWAXid0q` + user `CX79e2kZ`.)
+---
 
-**Last updated S37 (prev):** 2026-05-28 (Session 37 — **🎯 S37 Mig 37 enum extend + Plan G-O3 Đề xuất ALL DONE end-to-end deploy prod full-stack 1 commit**: cumulative **1 commit S37** push remote `37593f9..de1c378` + **CI Run #246 PASS 3m53s**. Anh main "OK làm tiếp đi nhé" Full batch 6 plan continuation. **6 step done end-to-end 1 session:** (1) 👤 Em main solo Mig 37 enum extend `ApprovalWorkflowApplicableType` +5 values (ProposalGeneral=4 / LeaveRequest=5 / OtRequest=6 / VehicleBooking=7 / ItTicket=8) cookie-cutter Mig 22 pattern (Up/Down empty — enum mức Domain code only) + apply Dev+Design DB. UNBLOCK G-O3-O6 Workflow Apps. (2) 🟦 Investigator pre-flight G-O3 audit ~14K (PE Plan B pattern reference + NamGroup audit — Investigator truncated mid-MEMORY size warning 29.6KB report). (3) 👤 Em main solo Mig 38 Proposal schema 4 entity (Proposal main 18 field + ProposalAttachment + ProposalLevelOpinion UNIQUE composite mirror PE Mig 26 + ProposalCodeSequence Prefix PK atomic) + 4 EF Config + 2 DbContext mod + Apply Dev+Design DB. (4) 👤 Em main solo BE CQRS ~700 LOC ProposalFeatures.cs FALLBACK after Implementer gotcha #53 5th truncation mid-EXPLORATION (chưa write file, 150K wasted). 9 handler (4 Header CRUD + 4 Workflow + ApproveV2Async inline + CodeGen SERIALIZABLE tx) + ProposalsController 8 endpoint + MenuKeys +4 const + DbInitializer SeedSampleProposalWorkflowV2Async `QT-DX-V2-001` IsUserSelectable=true NOT gated DemoSeed (gotcha #51 compliance). (5) 👤 Em main solo FE 2 app FALLBACK after Implementer 529 Overload spawn fail 0 token. 4 file × 2 app SHA256 IDENTICAL: types/proposal.ts `95607052ff1138f2` + ProposalsListPage.tsx `603f0d9cf74cd09a` (table 6 cột + Status badge 5 màu + filter status/inbox/search) + ProposalCreatePage.tsx `6aed3a76563dd576` (form Header card) + ProposalDetailPage.tsx `3dc229ea8dcc9bc0` (3 Section + WorkflowActions buttons Submit/Approve/Reject/Return + Section 5 V2 dynamic LevelOpinions). Pattern 16-bis 8× cumulative (App.tsx +3 route + menuKeys +4 const + Layout staticMap +3 entry). PageHeader signature mismatch fix (no icon prop, use actions=ReactNode). npm build × 2 PASS clean (fe-admin 14.72s + fe-user 6.40s 0 TS error). (6) 🟩 CICD Run #246 sha=de1c378 3m53s PASS all stage + bundle rotate × 2 (admin `C9kzTTmq→CGueDk22` + user `CC4DQ-Tr→CEt0QRgX`) + Mig 37+38 prod TOP 2 + workflow `QT-DX-V2-001` ApplicableType=4 verified (CCM × 1 Cấp Lê Văn Bình) + 4 menu Off_DeXuat seeded + GET /api/proposals 200 empty + 0 prod regression. Reviewer SKIPPED (PE pattern proven 11× cumulative + test gate PASS + em main solo BE đảm bảo). **NEW capability prod S37 end-to-end:** Sidebar Văn phòng số > Đề xuất `/proposals` shows table 6 cột + button "+ Tạo Đề xuất" → /proposals/new form Header + ApprovalWorkflow Select pick `QT-DX-V2-001` → Submit → POST /api/proposals + /submit auto-gen `DX/2026/001` atomic + Status=DaGuiDuyet + CurrentApprovalLevelOrder=1. Approver (binh.le CCM) login → /proposals?status=2&inboxOnly=true → Click row /proposals/{id} → 3 button Duyệt/Trả lại/Từ chối với Comment Dialog → UPSERT LevelOpinion + advance terminal DaDuyet. **Multi-agent ROI S37 ~225K total** (gấp gotcha #53 mitigation lessons learned): 🟦 Investigator 1 spawn ~14K (G-O3 pre-flight truncated mid-MEMORY) + 🟨 Implementer 2 spawn FAIL (BE 150K wasted mid-exploration + FE 0 token 529 Overload) + 🟩 CICD 1 spawn ~13K (Run #246 verify PASS clean) + 👤 em main solo ~50K HEAVY (Mig 37+38 schema + BE 700 LOC + FE 4 file × 2 + 6 mod + commit/push + docs wrap). **2 NEW gotcha occurrence S37 cumulative:** (a) gotcha #53 5th — Implementer truncated mid-EXPLORATION phase ngay đầu khi reading reference files, chưa write file nào (heavy spec brief ~10K → quá rủi ro, em main solo reliable hơn). (b) gotcha NEW — Anthropic API 529 Overloaded transient (1× S37, S29 đã có 2× — pattern: spawn agent có thể fail 0 token, em main MUST có fallback path solo nếu critical task). **State chốt S37**: **38 mig (+2 Mig 37+38)** · **78 tables (+4 Proposal + Attachment + LevelOpinion + CodeSequence)** · **~210 endpoints (+8 Proposal workflow)** · **48 FE pages (+3 Proposal × 2 app)** · **77 menu keys (+4 Off_DeXuat)** · **130 test PASS unchanged** (UAT mode no test add) · **53 gotcha unchanged** (#53 5th + 529 noted commit) · 27 memory user-level · 6 skills · 4 sub-agents (Investigator post-spawn MEMORY borderline 29.6KB warning per Investigator self-report). **Bundle hash live S37**: admin `CGueDk22` + user `CEt0QRgX`.)
+## 🎯 CURRENT STATE (verified S40)
 
-**Last updated S36 (prev):** 2026-05-28 (Session 36 — **🎯 S36 Plan G-O2 Phòng họp ALL DONE end-to-end deploy prod BE+FE combo 1 commit**: cumulative **1 commit** push remote `8afdc1e..f45090b` + **CI Run #359 PASS 3m55s**. Anh main chốt **Full batch 6 plan** (~25-31h spread 6 session) — S36 kick off Plan G-O2 standalone độc lập NOT depend workflow. **6 step done end-to-end 1 session:** (1) Curate 2 MEMORY ưu tiên — Implementer 36.4→31.7KB + CICD 40.4→28.3KB archive q4.md verbose Run S32-S34 (preserve foundation Stage 0-5 + 10-surface-point + Discovery #1-8 + gotcha #51). (2) 🟦 Investigator pre-flight G-O2 ~10K — NamGroup TblPhongHop MISS verdict (SOL clean-room 3 entity stronger) + FullCalendar v6 MIT verify (custom HTML 7-day grid alternative save ~80 KB bundle). (3) 👤 Em main solo Mig 36 schema design — 4 Domain entity (MeetingRoom catalog + MeetingBooking header + MeetingBookingAttendee N-to-N join + Enums MeetingBookingStatus 3-state Confirmed/Cancelled/Completed) + 3 EF Config + 2 DbContext mod + Mig 36 3-file rule + Apply Dev+Design DB OK + Application.csproj +Microsoft.EntityFrameworkCore.Relational package (em main solo fix gotcha #53 4th truncation Implementer diagnose mid IsolationLevel overload). (4) 🟨 Implementer BE CQRS ~30K — MeetingFeatures.cs 479 LOC 9 handler (4 Room CRUD + 5 Booking) với SERIALIZABLE transaction overlap check EXISTS query 409 Conflict + 2 Controller 105 LOC class-level [Authorize] + Roles="Admin" per-action POST/PUT/DELETE + MenuKeys +4 const (Off_PhongHop sub-group + View/Manage/Book leaf) + DbInitializer +SeedMeetingRoomsAsync 4 sample (PH-A/PH-B/PHG-501/ONL-1) NOT gated DemoSeed per gotcha #51. (5) 🟨 Implementer FE 2 app ~32K — types/meeting.ts × 2 SHA256 IDENTICAL `ce0ad9c6d017cde2` + MeetingCalendarPage.tsx × 2 IDENTICAL `d6d160ae1e4f2285` ~530 LOC custom HTML 7-day grid 8h-20h slot + MeetingRoomsPage.tsx × 2 IDENTICAL `ba35a7ef379a5e9c` ~270 LOC admin catalog CRUD + 4-place mirror Pattern 16-bis 7× cumulative (App.tsx route + menuKeys.ts +4 const + Layout.tsx staticMap 3 entry). npm build × 2 PASS 0 TS err bundle +23 KB gzip. (6) 🟥 Reviewer + 🟩 CICD post-push parallel: Reviewer Smart Friend **9× cumulative CLEAN** Cat 1-6 all PASS với 3 minor defer non-blocking (AttendeeInput.Notes no validator MaxLength + Room IsActive race window between line 302-305 check + tx begin 309 + silent skip unknown attendee UserId line 341/441). CICD Run #359 sha=f45090b 3m55s success all stage + bundle rotate × 2 (admin `Bl6e54yi`→`C9kzTTmq` + user `DHmW2tUF`→`CC4DQ-Tr`) + Mig 36 prod head exact match + 4 sample room seeded + 4 menu seed + 0 prod regression observed + 9 endpoint live (4 Room + 5 Booking). **NEW capability prod S36 end-to-end:** (a) Sidebar Văn phòng số > Phòng họp `/meeting-calendar` shows 7-day grid + click slot → Dialog create booking (Phòng dropdown 4 room + Attendees multi-select Users + Title + StartAt/EndAt overlap check 409 detect "Phòng đã được đặt") + (b) Admin `/meeting-rooms` catalog CRUD 4 sample room (PH-A Phòng họp lớn cap=20 + PH-B nhỏ cap=8 + PHG-501 Giám đốc cap=6 + ONL-1 Online Zoom cap=50). **Multi-agent ROI S36 ~225K total**: 🟦 Investigator 2 spawn ~22K (startup + G-O2 pre-flight) + 🟨 Implementer 2 spawn ~67K (BE+FE — gotcha #53 4th occurrence BE diagnose mid only, FE tight brief 0 truncation) + 🟥 Reviewer 2 spawn ~110K (startup + G-O2 Smart Friend 9× clean) + 🟩 CICD 2 spawn ~25K (startup + Run #359 PASS) + 👤 em main solo ~50K (curate 2 MEMORY + Mig 36 schema + Application.csproj fix Relational + commit/push + docs wrap). **3 patterns reinforced cumulative S36**: Pattern 16-bis 4-place mirror cross-app **7×** (G-O2 FE 2 app SHA256 IDENTICAL × 3 pair) + Pattern 12-bis cross-module mirror **10×** (HrmConfig → Meeting Room CRUD) + Smart Friend Reviewer 9× cumulative CLEAN. **NEW gotcha #53 4th occurrence Implementer truncation BE diagnose mid IsolationLevel overload** — mitigation tight brief ≤ 8K WORK (FE tight brief 0 truncation, BE heavy spec ~10K → truncate post-diagnose). **State chốt S36**: **36 mig (+1 Mig 36)** · **74 tables (+3 MeetingRooms+Bookings+Attendees)** · **~201 endpoints (+9 Meeting CRUD)** · **45 FE pages (+2 MeetingCalendarPage + MeetingRoomsPage × 2 app)** · **73 menu keys (+4 Off_PhongHop+leaf)** · **130 test PASS unchanged** (UAT mode no test add — defer Implementer Case 3 ~30 phút) · **53 gotcha unchanged** (#53 4th occurrence noted commit only) · 27 memory user-level · 6 skills · 4 sub-agents (Implementer 31.7KB + CICD 28.3KB acceptable post-curate). **Bundle hash live S36**: admin `C9kzTTmq` + user `CC4DQ-Tr`.)
+| Metric | Value | Note |
+|---|---|---|
+| Migrations | **40** | last `AddAttendances` (20260528090839) |
+| SQL tables | **84** | 77 app DbSet + 7 ASP.NET Identity (`.ToTable()` in ModelSnapshot) |
+| API endpoints | **~211** | `[HttpVerb]` attrs in Controllers |
+| FE pages | **65** | 36 fe-admin + 29 fe-user (`*Page.tsx`) |
+| Menu keys | **~53** | BE `MenuKeys` const (FE menuKeys.ts mirror 54) |
+| Tests | **130 PASS** | 58 Domain + 72 Infra · 0 fail / 0 skip (~15s) |
+| Gotchas | **55** | `docs/gotchas.md` (latest #54 529-fallback, #55 truncation-mid-exploration) |
+| User memory | 27 | + `MEMORY.md` index |
+| Skills | 6 | 3 domain + 3 ops |
+| Sub-agents | **7** | Opus 4.8 1M (S39 split 4→7) |
+| RAG chunks | 3076 | ⚠️ S37-S39 content gap (re-ingest pending) |
 
-**Last updated S35 (prev):** 2026-05-28 (Session 35 — **🎯 S35 3 chunk push ALL DONE end-to-end deploy prod: FE inline forms 5 satellite + G-H2 BE CRUD 16 endpoint + G-H2 FE Admin HrmConfigsPage**: cumulative **3 commit S35** push remote `63dd9ec..021674a` + **3 CI Run ALL PASS #242/#243/#244**. **Chunk 1 FE inline forms** (`c3cd343` Run #242 3m30s PASS): Implementer Case 2 cookie-cutter mirror Pattern 12-ter × 16-bis. EmployeesListPage.tsx 573→1200 LOC (+627) × 2 app SHA256 IDENTICAL `802d01fd1ee79925` + types/employee.ts +53 × 2 app + 5 inline Form component (WorkHistory/Education/FamilyRelation/Skill/Document) + 3 DRY helpers (FormField + FormFooter + RowActions × 45 usage) + 15 useMutation × 2 app + DRY `invalidate()` helper × 15 calls. Wire 15 endpoint S34 BE inline expandable form Add/Edit/Delete (NOT modal/drawer). gotcha #44 mitigation ACTIVE per-action policy Hrm_HoSo. Bundle hash rotate `RNTX6Fvo→BhR0MmLN` + `29A1LuMm→DIdNaB6W`. **Chunk 2 G-H2 BE CRUD 16 endpoint** (`909655c` Run #243 3m43s PASS): Implementer Case 2 mega Pattern 12-bis 3× cumulative. HrmConfigFeatures.cs NEW 439 LOC 4 region cookie-cutter mirror Catalogs (LeaveTypes/Holidays/Shifts/OtPolicies) + HrmConfigsController.cs NEW 137 LOC URL `/api/hrm-configs/{kind}` × 4 verb = 16 endpoint + Class `[Authorize]` + write `[Authorize(Roles="Admin")]` 12 attribute + 8 Conflict UNIQUE check (4 Create + 4 Update với composite Year+Date Holiday exclude-self) + 8 AbstractValidator + 44 RuleFor. **Smart Friend Implementer caught 2 spec drift**: (a) MaxLength validator vs EF config mismatch → aligned to EF source-of-truth (Code 20→50, Name 100→200, Description 500), (b) HRM entities NO HasQueryFilter (vs Master 9 file have) → explicit `.Where(!IsDeleted)` 8 site. 4 GET smoke 19 row prod live (5+10+3+1). Bundle hash UNCHANGED 2 app (anti-pattern verify BE-only). **Chunk 3 G-H2 FE Admin HrmConfigsPage** (`021674a` Run #244 3m38s PASS): Implementer Case 2 declarative single-page mirror Pattern 12-bis × 16-bis 9× cumulative. types/hrm-config.ts NEW 98 LOC × 2 app SHA256 IDENTICAL `228917e5fac2cdc6` + HrmConfigsPage.tsx NEW ~470 LOC × 2 app SHA256 IDENTICAL `6378fbc71ff90260` + App.tsx +3 LOC × 2 app (route + Navigate redirect default) + Layout.tsx +6 LOC staticMap × 2 app. **Smart Friend Implementer 3rd catch S35**: em main spec line 24 GAP "Layout staticMap no resolve issue" — WRONG. Implementer verified `MenuItem.cs` NO Url field + `resolvePath()` regex chỉ match `Ct_*/Wf_*/Pe_*/PeWf_*/AwV2_*` (KHÔNG `Hrm_Config_*`) → silent sidebar drop gotcha #50. Enforced staticMap mirror Pattern 16-bis 6× foundation reinforced. Declarative `KIND_CONFIG` Record × 4 kind + FieldDef extend types (text/textarea/checkbox/number/date/time/select/multiselect-weekday cho Shift WorkDays). Bundle hash rotate `BhR0MmLN→Bl6e54yi` admin + `DIdNaB6W→DHmW2tUF` user. **Multi-agent ROI S35 ~250K total**: 🟨 Implementer 3 spawn ~80K (3 cookie-cutter chunk + Smart Friend × 3 catch) + 🟦 Investigator 1 spawn ~8K (Plan G-H2 BE CRUD pre-flight audit + NamGroup ref MISS verdict — SOL clean-room design MẠNH HƠN, KHÔNG cần port) + 🟥 Reviewer 3 spawn ~60K (3 pre-commit verify Smart Friend cumulative 9× clean S22+S25+S29×2+S33×2+S35×3, Cat 1-6 PASS tất cả chunk) + 🟩 CICD 4 spawn ~70K (warm-up Run #241 + Run #242 + Run #243 + Run #244 stalled em main fallback). **NEW gotcha #53 sub-agent truncation/stall pattern** S35 × 3 occurrence (Reviewer × 2 mid-MEMORY-update + CICD × 1 stalled 600s watchdog) — mitigation: tight brief ≤ 8K + em main grep verify manual + curate MEMORY pre-spawn nếu > 25KB + remove "BEFORE stop with detailed MEMORY" directive khi MEMORY borderline. **NEW capability prod end-to-end S35**: (a) Admin login eoffice/employees → 5 satellite section inline Add/Edit/Delete form expandable cho 33 EmployeeProfile sample + (b) Admin login /hrm/configs/leave-types → table 5 row + sub-tab 4 kind switcher (LeaveTypes/Holidays/Shifts/OtPolicies) Dialog modal CRUD. **State chốt S35**: **35 mig unchanged** · **71 tables unchanged** · **~185 endpoints (+16 HRM Configs)** · **43 FE pages (+1 HrmConfigsPage)** · **69 menu keys unchanged** · **130 test PASS unchanged** (UAT mode no test add 3 chunk) · **53 gotcha (+1 #53 sub-agent truncation)** · 27 memory user-level · 6 skills · 4 sub-agents (Reviewer + CICD borderline post-spawn MEMORY entries S35).)
+**Bundle hash live (prod):** admin `cWAXid0q` · user `CX79e2kZ` (Run #247, S38).
+**Phase:** ✅ **Phase 10 COMPLETE 11/11** Plan G-* · ⬜ Phase 11 polish NOT started · 🚫 Phase 9 Ops blocked (anh main coordinate).
 
-**Last updated S34 FULL (prev):** 2026-05-27 (Session 34 FULL — **🎯 Plan 1+2+3+4 ALL DONE end-to-end: Curate 4 MEMORY + Plan G-O1 Danh bạ + Phase 1.5 batch 6/6 + Plan G-H2 Mig 35 schema foundation**: cumulative **6 commit S34** push remote `edba4ae..07b3f3b` + 4 CI Run PASS (#238 Plan 2 + #239 Plan 3 batch + #240 Item 3 satellite + #241 Plan 4 Mig 35 - pending verify). **Plan 1 Curate** 4 MEMORY 118KB→101KB (-15%, 4 archive q3.md). **Plan 2 G-O1 Danh bạ** end-to-end: BE `Application/Office/DirectoryFeatures.cs` + FE 2 app card grid mirror SHA256 IDENTICAL + 34 row prod live + Run #238 PASS. **Plan 3 Phase 1.5 batch 6/6:** Item 6 menuKeys sync × 2 + Item 2 bool→bool? safe partial + Item 1 per-action policy Hrm_HoSo.{R/C/U/D} + Item 4 test +10 [Fact] 130 PASS + Item 5 UAT smoke nv.test 403 employees + 200 directory (gotcha #44 ACTIVE) + Item 3 BE 5 satellite CRUD scaffold 15 endpoint Pattern 12-ter NEW (~621 LOC + 164 LOC controller extend). **Plan 4 G-H2 Mig 35 schema foundation** (BE CRUD + FE forms defer S35): em main solo 4 entity (LeaveType + Holiday + ShiftPattern + OtPolicy) + 4 EF Config UNIQUE indexes + IApplicationDbContext + ApplicationDbContext +4 DbSet + Mig 35 3-file rule + `SeedHrmConfigsAsync` ~120 LOC seed 19 sample row (5 LeaveType + 10 Holiday VN 2026 + 3 Shift + 1 OtPolicy STANDARD) + MenuKeys `HrmConfig` sub-group + 4 leaf Order=2 + FE 2 app menuKeys sync 5 const. **Multi-agent ROI S34 ~150K total**: 🟨 Implementer 3 spawn ~80K (Plan 2 FE 2 app cookie-cutter + Plan 3 Item 4 test bundle Case 3 + Plan 3 Item 3 BE 5 satellite Case 2) + 🟩 CICD 2 spawn ~40K (Run #238 + Run #239 partial → em main fallback) + 👤 em main solo ~30K (BE Task 1+2 G-O1 + Phase 1.5 Items 6+2+1+5 + Plan 4 Mig 35 schema + DbInitializer seed + Permission menu + 6 commit/push batch + UAT smoke + STATUS/HANDOFF wrap). 🟦 Investigator + 🟥 Reviewer: 0 spawn S34 (chưa cần — Implementer Case 2+3 + em main solo đủ). **5 patterns reinforced cumulative S34**: Pattern 16-bis 4-place mirror cross-app 5× + Pattern 12-bis cross-module mirror preserved + Pattern 12-ter NEW (within-module 5× satellite scaffold) + Smart Friend 6× clean preserved no NEW catches + Per-NV admin opt-in policy match prior PE + bool→bool? safe partial Pattern NEW cross-project + Pattern 11 test infra helper cookie-cutter reinforced. **NEW capability prod end-to-end S34:** (a) Sidebar Văn phòng số > Danh bạ /directory shows 34 row card grid + (b) `/api/employees/{id}/work-history|education|family-relations|skills|documents` 15 endpoint scaffold ready (admin/Hrm role wire qua per-action policy Hrm_HoSo.*) + (c) 4 catalog HRM seeded prod sample (LeaveTypes/Holidays/Shifts/OtPolicies) ready cho Workflow Apps Phase 10.3 reference. **State chốt S34:** **35 mig (+1 Mig 35)** · **71 tables (+4 HRM Configs)** · **~169 endpoints (+15 satellite + 1 directory)** · **42 FE pages (+2 Directory × 2 app)** · **69 menu keys (+Off+OffDanhBa+HrmConfig+4 leaf)** · **130 test PASS (+10)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (post-spawn MEMORY borderline curate next session). 
+> ⚠️ **Count drift fixed S40:** endpoints ~223→**211**, FE pages 53→**65**, menu keys 85→**~53**. Tables **84 confirmed correct** (DbSet 77 + Identity 7). 3 số "khó fake" (mig/gotcha/git) luôn đúng. Cause: số "incremented mỗi session" over/under-count optimistic — re-ground định kỳ.
 
-**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD + Plan C B-Wrap +9 tests + Drift patch**)
+---
 
-**Last updated S34 batch 1+2+3 (initial wrap):** 2026-05-27 (Session 34 — **🎯 Plan 1+2+3 cumulative DONE end-to-end: Curate 4 MEMORY + Plan 10.2 G-O1 Danh bạ + Phase 1.5 batch 4 item**: cumulative **3 commit S34** push remote `edba4ae..61e9ce5` + 2 CI Run PASS (#238 Plan 2 G-O1 3m30s + #239 Plan 3 Phase 1.5 batch 3m48s). **Plan 1 Curate** 4 MEMORY sub-agent 118KB→101KB (-15%) — archive 4 file q3.md (Investigator/Implementer/CICD) + q2.md (Reviewer) preserve Patterns 1-15+12-bis+16-bis + Smart Friend foundation + 10-surface-point per-NV cumulative. **Plan 2 Phase 10.2 G-O1 Danh bạ nội bộ** end-to-end 4 task: em main solo `Application/Office/DirectoryFeatures.cs` + `Api/Controllers/DirectoryController.cs` (LEFT JOIN Users+EmployeeProfiles+Departments) + MenuKeys `Off`+`OffDanhBa` Order=29 + Implementer Case 2 FE 2 app SHA256 IDENTICAL × 2 (`types/directory.ts` 7349d9f64e78 + `InternalDirectoryPage.tsx` 2aa7e0eed2c8 card grid avatar PALETTE 6 màu + filter dept dropdown + email mailto + phone tel + Ext: badge) + CICD Run #238 PASS 34 rows EmployeeProfile API live + bundle rotate × 2 (`CqGMUMOr→ChA9_vP5` admin + `C_HKyxBe→DCpX7akt` user). **Plan 3 Phase 1.5 backlog G-H1 batch** 5/6 item DONE end-to-end: Item 6 menuKeys × 2 app full sync mirror BE 28 key cumulative + Item 2 UpdateEmployeeProfileCommand 3 bool→bool? safe partial update (Reviewer minor S33 fixed) + Item 1 EmployeesController per-action policy `Hrm_HoSo.Read/Create/Update/Delete` (gotcha #44 mitigation active) + Item 4 test bundle +10 [Fact] 120→**130 PASS** (EmployeeCodeGen 3 + Create handler 4 + List query 3) + Item 5 UAT smoke nv.test verified 403 silent /api/employees (gotcha #44 ACTIVE) + 200 /api/directory (class-level [Authorize] đúng spec). **Item 3 Satellite CRUD endpoints + FE forms DEFER S35** (heavy ~2-3h). **Plan 4 G-H2 Cấu hình HRM DEFER S35** (~3-4h Mig 35). **Multi-agent ROI S34 ~95K total**: 🟨 Implementer 2 spawn ~50K (Plan 2 Task 3 FE 2 app mirror + Plan 3 Item 4 test bundle Case 3) + 🟩 CICD 2 spawn ~40K (Plan 2 verify Run #238 + Plan 3 verify Run #239 partial then em main fallback) + em main solo ~5K direct UAT smoke. Em main solo BE Task 1+2 G-O1 + BE Item 6+2+1 Phase 1.5 + 3 commit/push batch + UAT smoke nv.test verify gotcha #44. **5 patterns reinforced cumulative S34**: Pattern 16-bis 4-place mirror cross-app 5× (G-O1 Task 3 + S33 Task 5 + S29 Plan CA HF1 + S29 Plan B Chunk D + future) + Smart Friend 6× clean preserved (no NEW catches S34 — all clean wire) + Per-NV admin opt-in pattern reinforced (Hrm_HoSo policy match prior PE Per-NV) + Test bundle cookie-cutter Pattern 11 (CodeGen + Create + List mirror BW1-BW7 fixture) + bool→bool? safe partial Pattern NEW (cross-project applicable for future Update commands). **NEW capability prod end-to-end S34:** Sidebar Văn phòng số > Danh bạ nội bộ /directory shows 34 rows card grid filter search + Per-action policy Hrm_HoSo wire prod live (Run #239 verified). **State chốt S34:** **34 mig (no change)** · **67 tables** · **~154 endpoints (+1 /api/directory)** · **42 FE pages (+2 Directory × 2 app)** · **64 menu keys (+Off+OffDanhBa)** · **130 test PASS (+10)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (MEMORY 4× curate q3 — Investigator 21.8KB ✅ + Implementer 28KB borderline + Reviewer 25.7KB ✅ + CICD 30.9KB borderline post-spawn entries) · 14 AppRoles · 33 EmployeeProfile prod seeded · 7 V1 contract + V2 ready · bundle rotate 2× S34.)
+## 🔥 In Progress (S40)
 
-**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD end-to-end + Plan C B-Wrap BW1-BW7 +9 tests + Drift patch S33 startup**: cumulative **7 commit S33** push remote `5400983..79a8343` + 2 CI Run PASS (#350 Phase 1 3m38s + #237 Phase 2 3m50s). **Plan cha B Phase 10.1 G-H1** end-to-end 7 task: Investigator NamGroup audit 10 bảng → em main Mig 34 schema 4 decision → Implementer Case 2 BE entity 17 file + CQRS 3 file + FE 2 app 12 file cookie-cutter mirror SHA256 IDENTICAL + DbInitializer seed 30 EmployeeProfile + EmployeeCodeSequence + em main Permission menu Hrm+HrmHoSo + Reviewer Smart Friend 6× clean + CICD Run #237 PASS. **Plan cha C B-Wrap** end-to-end 4 step: TestCurrentUser stub + Implementer 3 test file BW1-BW7 (9 [Fact] split) + Reviewer PASS 0 critical + CICD verify Mig 33 prod + EmployeeProfiles 33 seeded + bundle hash rotate × 2 app (`BUTKoqRP→CqGMUMOr` admin + `CMHv2GS4→C_HKyxBe` user). **Plan cha D Drift patch S33 startup** Reviewer SEVERE catch CLAUDE.md+docs+implementer.md 10 line patch cumulative S19→S32 (mig 26→33 + test 81→111 + gotcha 26→52 + audit next 2026-06-01). **Multi-agent ROI S33 ~250K total**: 🟦 Investigator 2 spawn ~20K (S33 startup audit + Plan B Task 1 NamGroup pre-flight) + 🟨 Implementer 4 spawn ~110K (Plan B Task 3 BE entity + Task 4 CQRS + Task 5 FE 2 app + Plan C BW1-BW7) + 🟥 Reviewer 3 spawn ~60K (drift severity + Plan C BW verify + Plan B Phase 2 verify) + 🟩 CICD 3 spawn ~60K (S33 startup health + Run #350 + Run #237). Em main solo Task 2 schema design + Task 3b DbInitializer seed + Task 6 Permission menu + commit/push 7 commit batch. **8 patterns reinforced cumulative S33**: Pattern 12-bis cross-module mirror PE→Hrm 4× + Pattern 16-bis 4-place mirror cross-app 4× + Smart Friend 6× clean (S22+S25+S29×2+S33×2) + gotcha #51 INFRASTRUCTURE seed lesson applied 2× (EmployeeProfile + Hrm menu) + gotcha #50 Layout staticMap mirror applied 1× + Pattern Implementer truncation pattern observation 2×/3 (Task 3+4 truncated mid-MEMORY update, Task 5 clean — mitigation noted commit message). **NEW capability prod end-to-end:** Admin login `admin@solutions.com.vn / Admin@123456` → sidebar Nhân sự → Hồ sơ NS → /employees list 33 row sample `NV/2026/0007 BOD 1 - Director` + CreatePage form Header (UserId picker). **State chốt S33:** **34 mig (+1)** · **67 tables (+7 EmployeeProfile + 5 satellite + Sequence)** · **~153 endpoints (+5)** · **40 FE pages (+2)** · **62 menu keys (+Hrm+HrmHoSo)** · **120 test PASS (+9 BW)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (MEMORY all >25KB, curate next session priority) · 14 AppRoles · 33 EmployeeProfile prod seeded · 7 V1 contract + V2 ready · bundle rotate 4× cumulative S33 (Phase 1 + Phase 2 push each).)
+| Task | Owner | Status |
+|---|---|---|
+| Doc consolidation (STATUS/HANDOFF tier + count re-ground + CLAUDE.md root) | 👤 em main + 🟦 investigator-codebase | 🔄 |
 
-**Last updated S32 (prev):** 2026-05-26 (Session 32 — **🎯 Phase 10 backlog Plan G NamGroup port DOCUMENTED + Phase 9 stabilize batch DONE**: 10 Plan G-* atomic sprint ~3 tháng T6-T8/2026 (4 quyết định chốt: FULL 11 module + single schema `dbo` mở rộng Mig 34-42 + reuse Workflow V2 enum +5 values + chunk per-module). **Phase 9 stabilize 4 task done sequential anh main "finish hết":** (A2) RAG re-ingest 2949→2988 chunks, gotcha #52 rerank 0.516→0.906 verify; (A3) MEMORY curate 3 agent OVER 25KB: Implementer 38.4→27.5KB + Investigator 27.7→19KB + CICD 27→24.2KB (Patterns 1-19 + 12-bis + 16-bis foundation preserved, 10 verbose archived q2); (B-Wrap) Spec BW1-BW7 ContractWorkflowService ApproveV2Async test bundle DOCUMENTED implementation defer dedicated session ~2h; (C1) Ops status updated: backup-sql.ps1 ready (Task Scheduler register manual cmd), cert api.solutions.com.vn notAfter `2026-07-23` (~2 tháng nữa expire, auto-renew ~2026-06-23), SMTP+rotate creds BLOCKED chờ anh main coordinate. **4 sub-agent reuse-able S33:** Investigator agentId `afaf6d52a6a59a844` / Implementer `ab23cc322b5d495c0` / Reviewer `a0aa13093d14f3bca` / CICD `a505a02d84fc1fabe`. **Phase 10.1 G-H1 Hồ sơ NS handover S33 kick off:** spawn Investigator pre-flight NamGroup TblNhanVien* 8 bảng audit → em main design Mig 34 (1 main + 5 satellite) → Implementer Case 2 scaffold. Stats: 33 mig · 60 tables · ~148 endpoints · **111 test PASS unchanged** · **52 gotcha** · **26 memory user-level (+1 feedback_phase10_namgroup_port)** · 6 skills · 4 sub-agents · 38520 chunks 7 projects RAG live. 4 commits S32 push remote `b832f43..cce0963` all docs-only CI skip per #41.)
+---
 
-**Last updated S31 (prev):** 2026-05-26 (Session 31 — **🎯 RAG v1.3 Baseline PASS (11/11 recall@5=1.000) + retrieval.py critical fix**. **S30 RAG Setup:** Setup RAG Framework v1.3 governance () + evaluator spec + golden set v1.1 (14 queries) + baseline runs v1.0+v1.1 + . Bootstrap 2949 chunks (164 files — fixed Anti #24 projects.json root_path + added  corpus). Commit  docs-only CI skip. **S31 Eval Fix:** Discover  removed  method →  silently returns  (gotcha #52 NEW). Fix: . After fix: **recall@5 = 1.000 (11/11) PASS** (prev tentative 0.364 FAIL). Quality gate  updated: baseline=1.000, avg_rerank=0.847. **Sub-agents S30/S31:** 0 spawns (docs/infra only). **Commits pushed:**  (docs-only S30) — S31 pending. State: **33 mig** · 60 tables · ~148 endpoints · 38 FE pages · **111 test PASS** · **52 gotcha (+1 #52 qdrant-client search() removed)** · **25 memory user-level** · 6 skills · 4 sub-agents · **RAG v1.3 ACTIVE baseline PASS** 2949 chunks · CLI restart required for live MCP vector fix.)
+## ✅ Recently Done (newest on top — 3 session; cũ hơn → session logs)
 
-**Last updated S29 FINAL (prev):** 2026-05-22 (Session 29  — **🎯 Plan CA + Plan B Contract V2 wire ALL DEPLOYED PROD**: cumulative **20 commits push 4 CI Runs PASS** (#229 + #230 + #231 + #232). **2 big plans done end-to-end:** Plan CA Move "Cấu hình danh mục dùng chung" admin → eoffice (7 commits + Hotfix 1) + Plan B Contract V2 wire mirror PE Mig 22-26 (9 chunks + Hotfix Reviewer + Hotfix CICD). **Multi-agent ROI explosive S29:** 🟦 Investigator 2 spawn ~40K (Plan CA terrain map + Plan B V1 audit) + 🟨 Implementer Case 2 5 spawn ~82K (Plan CA Chunk B + Plan B A2/C/D + E3 stopped mid-task) + 🟥 **Reviewer 4 spawn ~355K** (Plan CA Hotfix D2 password ≥12 MAJOR catch + Plan B Hotfix ApplicableType=Contract MAJOR catch — Smart Friend pattern 4× cumulative) + 🟩 **CICD Monitor 3 spawn ~90K** (2 fail 529 transient em main fallback manual + Plan B SeedSampleContractWorkflowV2 CRITICAL DemoSeed gate catch — gotcha #51 NEW). **Patterns NEW saved S29:** (1) 9-menu permission terrain map (Investigator) (2) V1+V2 coexist boundary (Investigator) (3) reference template paths cross-module mirror PE→Contract (Investigator) (4) Pattern 12-bis cross-module entity cookie-cutter mirror (Implementer) (5) Pattern 16-bis 4-place mirror cross-app reinforced 2× (Implementer) (6) Cross-module security validation mirror Cat 3 (Reviewer) (7) INFRASTRUCTURE vs DEMO seed classification gotcha #51 (CICD) (8) Race condition em main + Implementer parallel BE → stash workaround OR sequential preferred (Implementer). **3 hotfix cumulative:** Plan CA HF1 resolvePath staticMap + Plan CA D2 password ≥12 chars + Plan B Reviewer ApplicableType=Contract + Plan B CICD SeedSampleContractWorkflowV2 ungate. **NEW capability prod:** demo user `catalog.manager@solutions.com.vn / CatalogMgr@2026` (role CatalogManager — full CRUD 9 menu Master+Catalogs) + Drafter có thể create V2 contract qua Workspace dropdown `QT-HD-V2-001` sample workflow. **MCP RAG tools added cho 4 agent definitions** (commit `b51fc94`) — anh restart CLI để hot-reload. State chốt: **33 mig (+2 Mig 32+33)** · **60 tables (+1 ContractLevelOpinions)** · **~148 endpoints (+1 V2 contract create)** · **38 FE pages (+3: 4 master moved + WorkflowMatrixView counted unchanged S24)** · **111 test PASS unchanged** (UAT mode skip per chunk + cookie-cutter mirror) · **51 gotcha (+1 #51 INFRASTRUCTURE vs DEMO seed)** · **25 memory user-level unchanged** · 6 skills · 4 sub-agents (MCP RAG added pending CLI restart) · **14 AppRoles (+1 CatalogManager)** · **34 active prod users (+1 catalog.manager)** · **7 V1 contracts pinned coexist V2** · Bundle hash 4× rotate cumulative S29 (fe-admin: `BvcWrq2z→leEMWFLU→BBADl46y` + fe-user: `Bg2FNeIz→DVBLmZlt→Dgn1iU9E→DA_VI3zO`).)
+### S40 (2026-05-29) — Init audit + doc consolidation
+- 7-agent smoke verify (🟪 test-specialist + 🟦 investigator-api load OK), RAG re-rank PASS (top 0.8789 Voyage rerank-2.5), 130 test confirm.
+- Doc consolidation: STATUS 170KB→~15KB + HANDOFF 224KB→~12KB (archive full → `docs/_archive/`). Count re-ground. Stale credential `admin@solutionerp.local`→`admin@solutions.com.vn` fixed.
 
-**Last updated S29 prev wrap1:** 2026-05-22 (Session 29 — **🎯 Plan CA wire DONE + Hotfix 1 deploy**: 6 commits + 1 hotfix push `3cb54e0..e55d96b` cumulative. Move "Cấu hình danh mục dùng chung" (9 menu: Master + Suppliers + Projects + Departments + Catalogs + 4 sub-catalogs) từ fe-admin → fe-user/eoffice + add role mới `CatalogManager` + demo user `catalog.manager@solutions.com.vn`. **Chunks:** A 80d39a0 BE Role + Seed (em main, 64 LOC) · B 06a441c FE move 4 master pages 948 LOC (Implementer Case 2 cookie-cutter mirror byte-identical SHA256 4 file) · C c995f42 Sidebar filter 2 app (em main, 14 LOC) · D 4a592cf Seed demo user (em main, 7 LOC) · D2 68bcedd Hotfix password ≥12 chars S22+2 policy (em main, Reviewer pre-push CATCH critical) · HF1 e55d96b Add 7 entries `resolvePath` staticMap fe-user (em main, anh UAT screenshot CATCH silent sidebar drop). **2 CI runs PASS:** Run #229 sha=68bcedd 3m32s + Run #230 sha=e55d96b 3m24s. Bundle hash 2× rotate: fe-admin `BvcWrq2z→leEMWFLU`, fe-user `Bg2FNeIz→DVBLmZlt→Dgn1iU9E`. **Multi-agent ROI Plan CA:** 🟦 Investigator 1 spawn ~15K (terrain map 9 menu + GOTCHA tree-inherit) + 🟨 Implementer Case 2 1 spawn ~10K (byte-identical mirror 4 page) + 🟥 Reviewer 2 spawn ~165K (CRITICAL catch password policy) + 🟩 CICD Monitor 2 spawn fail 529 transient (em main fallback manual smoke) + 👤 Chủ trì Solo Chunk A/C/D/D2/HF1 ~100K. **NEW gotcha #50** "Page move cross-app — `Layout.tsx` `resolvePath` staticMap missed mirror → silent sidebar drop" + Pattern reusable cross-project: **4-place mirror checklist** khi Implementer Case 2 cookie-cutter copy page (page + Routes + menuKeys.ts + Layout.tsx staticMap — Implementer Chunk B missed point 4). Implementer MEMORY Pattern 16-bis NEW. **State chốt S29 Plan CA:** 31 mig (no schema change) · 59 tables · ~146 endpoints · **36 FE pages (+4: fe-user master/{Suppliers,Projects,Departments,Catalogs}Page)** · **111 test pass unchanged** (UAT skip per chunk + cookie-cutter mirror) · **50 gotcha (+1 #50)** · 25 memory user-level · 6 skills · 4 sub-agents · **13 AppRoles (+1 CatalogManager)** · **34 active prod users (+1 catalog.manager@solutions.com.vn)**. Catalog manager login `CatalogMgr@2026` (15 chars policy compliant). 7 commits remote `3cb54e0..e55d96b`.)
+### S39 (2026-05-29) — ⚙️ INFRA: Opus 4.8 1M + Multi-agent 4→7 + budget +50%
+- Pure infra/governance, 1 commit `fd0554a` (docs CI skip). Model default Opus 4.8 1M. investigator→codebase+api · implementer→backend+frontend · +test-specialist (purple). 5 RAG MCP/agent. 2 gotcha NEW #54 (529 fallback) + #55 (truncation mid-exploration). CLI restart → registry hot-reload (done S40).
+- → `docs/changelog/sessions/2026-05-29-S36-S39-phase10-complete-7agent.md`
 
-**Last updated S28 prev:** 2026-05-22 (Session 28 **FINAL wrap** — **🎯 S28 cumulative 12+ bước (t1→t6): Startup 9-step + RAG ROI verdict + bro correction mistake + scope-down + Layer A governance apply + 4 sub-agent flush MEMORY**. Bro broadcast **Layer A governance active 2026-05-22** (3-Layer distributed: A project-local active / B shared_global defer / C infrastructure anh pqhuy). **Quên rule cũ "mọi tương tác PHẢI store_memory" — ABANDONED.** Em main SOLUTION_ERP apply Layer A scope local: **4-category default** (decision/lesson/pattern-proven-≥2×/session-wrap) + **skip list nguyên** + 5 SOLUTION_ERP-specific adjustment cho Phase 9 UAT mode + **tag schema mandatory** `[type, phase, bc-or-module]` với type closed enum 6 (decision/lesson/pattern/gotcha/bug-fix/session-wrap) + phase enum 11 (phase-0 → phase-10+, current **phase-9 UAT ACTIVE**) + BC/module enum 8 domain (contract/pe/budget/master/identity/forms/workflow/notifications) + 5 cross-cutting (tests/infra/cicd/multi-agent/governance/docs) + optional prefix 8 (tech/agent/risk/severity/commit/mig/gotcha/plan). **source_path convention** `solution_erp/<area>/<topic>-<date>`. **Eval ritual** weekly Friday 5 metric từ 2026-05-29 → end-trial 2026-06-05. **10 golden query draft** ready. **6 chunk stored S28 t2-t6:** Protocol cross-project (deprecated S28 t4 scope-down) · Conversation log S28 t1+t2 · Commit pattern acknowledge · 2-week monitoring 5 measure · Scope-down acknowledge · Layer A policy apply. **4 sub-agent flush MEMORY DONE post-S27 model:inherit fix** — registry hot-reload verified all 4 (Investigator agentId `a2462`/`aeda4`, Implementer `a2a2f`, Reviewer `a9e94`, CICD Monitor `a8098`). Each Recent activity entry S28 t1 → S28 wrap góc nhìn từng con preserved cumulative S1-S27. **NEW memory user-level `feedback_interaction_logging_rag.md` SCOPE-DOWN S28 t4** (anti-pattern over-reach self-authorize cross-project rule + implicit consent risk lesson). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **25 memory user-level (+1 NEW interaction logging scope-down)** · 6 skills · 4 sub-agents (all verified hot-reload) · **3,462 RAG chunks SOLUTION_ERP** (+6 chunk store S28) + 6 MCP tools active. **Hit rate verify 3 query**: Plan B Contract V2 rerank 0.84 ✓ + gotcha #48 rerank 0.84/0.82/0.82 ✓ + per-NV 10-surface checklist hit (token overflow) ✓ — > 0.7 threshold pass cumulative. **0 commit remote S28** (all docs + memory + RAG store — anh chốt push thủ công sau approve). Plan B Contract V2 wire kick-off pending 2026-05-22+ (8-chunk pre-allocated 🟦 Investigator pre-flight + 🟨 Implementer Case 2 ×4 + 👤 Chủ trì Solo Service ApproveV2Async + 🟥 Reviewer pre-commit + 🟩 CICD Monitor post-deploy).)
+### S38 (2026-05-28) — 🎊 PHASE 10 COMPLETE 11/11 (SKELETON combo)
+- Mig 39+40 + BE ~1100 LOC + FE 5 file × 2 app + 8 menu. Run #247 PASS 3m25s. G-O4/O5/O6/P1/H3 skeleton. Trade-off DEFER Phase 11: ApproveV2 wire + LevelOpinions per-module + LeaveBalance + CodeGen atomic + Vehicle/Driver catalog + ItTicket auto-assign/SLA.
+- → same session log
 
-**Last updated S28 t1 initial:** 2026-05-22 (Session 28 turn 1 — **🎯 S28 startup 9-step + RAG ROI reality check em main verdict + cross-agent perspective update**. Anh restart Claude Code CLI sau S27 wrap → sub-agent registry **hot-reload OK** verified qua smoke test spawn Investigator (agentId `a2462ca503ed38b0b`, 16.3 KB MEMORY loaded, 3 skills attached: contract-workflow + permission-matrix + ef-core-migration). RAG status: **3,460 chunks SOLUTION_ERP indexed** (cao hơn S26 wrap 2,628 — re-index ngầm) + 6 MCP tools (`mcp__rag-unified__*`) loaded, Qdrant NSSM Service Running PID 4476. **Bro hỏi "cảm nhận rõ lợi ích RAG ko?"** → em main verdict thẳng thắn (anti-suger-coat): **CÓ LỢI marginal short-term (5-10% time saving), TRANSFORM long-term cross-project (chưa khai phá vì 4 em main project khác chưa bootstrap).** 4 case verdict: solo project blanket đủ ⚠️ Marginal | cross-session retrieve specific ✅ Tốt (rerank 0.84 vs 10 phút find) | cross-project 5 dự án 🚀 **TRANSFORM** (chưa dùng được) | heavy refactor Plan B-class ✅ Tốt. **3 nhược điểm cảm nhận thật:** (1) Bootstrap lag — S27 NEW content (`feedback_subagent_setup_pitfalls + skill-audit-late + 4 MEMORY post-curate + rag-onboarding-guide`) chưa index sau 1 ngày, query "subagent setup pitfalls" return **0 hits** (re-bootstrap pending pydantic fix); (2) Effective coverage gap — Plan B query rerank 0.84 excellent vs S27 content 0 hit miss; (3) Token cost rerank-2.5 ~$0.05/1K query (0.24% free tier Voyage). **Bottom line:** RAG đáng giữ cho infrastructure đã đầu tư S26-S27 (60.9s bootstrap + NSSM Service auto-start + Custom Dashboard 7 panel), **nhưng nếu redo từ đầu** sẽ recommend bro đợi bootstrap 5 dự án rồi mới claim "RAG transform" — solo project chỉ saving marginal. **Pattern reusable cross-project — RAG ROI evaluation framework:** 1 dev solo + 1 project < 1M tokens → ❌ Skip RAG | > 1M tokens → ⚠️ Marginal (5-10%) | N project > 5M tokens → ✅ Worth (cross-project transform) | N dev team enterprise → ✅ Mandatory. Avoid over-hype RAG cho solo 1 project. **Update multi-layer 6 file:** memory user-level `feedback_rag_hybrid_pattern.md` append §S28 t1 ROI reality check (~120 LOC NEW section) + 4 agent MEMORY Recent activity entry góc nhìn từng con (🟦 Investigator: pre-flight audit cross-session retrieve Plan B-class · 🟨 Implementer: Pattern proven retrieve cumulative 19 Pattern foundation · 🟥 Reviewer: gotcha historical context cross-ref #44+#48+#49 · 🟩 CICD Monitor: Run history cross-reference #186-#222 cumulative + 10-surface-point per-NV checklist promoted foundation) + STATUS.md + HANDOFF.md headers. **Bro sẽ cross-check** 4 agent consistency (next test: spawn 4 agent với same prompt verify alignment). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **24 memory user-level (no new entry, only append §S28 t1)** · 6 skills · 4 sub-agents (registry hot-reload verified post-S27 fix) · 3,460 RAG chunks + 6 MCP tools active. **0 commit remote S28 t1** (all docs + memory update + retrospective opinion - anh chốt push thủ công sau approve).)
-
-**Last updated S27:** 2026-05-22 (Session 27 chốt cuối — **🎯 Memory Curate + RAG Manual Control + Multi-agent Setup Pitfalls Fix**. **Trigger:** Anh share VIPIX `docs/guides/multi-agent-pitfalls.md` → em audit SOLUTION_ERP setup phát hiện CHÍNH XÁC CÙNG PATTERN broken: 4 file `.claude/agents/*.md` dùng `model: claude-opus-4-7` (200K silent fallback) + non-standard `effort: max` field → registry chưa load cả session S27. **Fix applied:** 4 file → `model: inherit` + remove `effort: max`. **Pending:** Anh restart Claude Code CLI để hot-reload. **Memory user-level NEW:** `feedback_subagent_setup_pitfalls.md` 235 lines cross-project pitfall checklist. **Plan A.3 RAG Manual Control + Option 4b NSSM Service:** 7 PS scripts + 6 `$PROFILE` aliases + Startup folder shortcut + Custom Dashboard HTML 7 panels. NSSM Windows Service Qdrant Running PID 4476 RAM 101.8 MB. **Plan A.4 RAG Onboarding Guide:** 42.5 KB / 682 lines / 14 sections + §A2 + §A3. **Plan F1 Qdrant Web UI fix:** Download dist-qdrant.zip 6.59 MB → HTTP 200 "UI | Qdrant". **Memory Curate 4 MEMORY -60%** (180.6→72.0 KB, archive 115 KB preserved §6.5). **Audit drift §6.4+§9.4 sớm** (trigger +8 gotcha): 5 file patched + log `docs/changelog/skill-audit-2026-05-late.md`. **0 commit remote S27** (all local).)
-
-**Last updated S26 FINAL:** 2026-05-21 (Session 26 **FINAL wrap** — **🎯 Anh chốt 2 decisions architectural quan trọng cuối session sau khi đã commit `bf93abd`**: (1) **Approach B distributed RAG bootstrap** — em main SOLUTION_ERP chỉ build INFRASTRUCTURE + DOCS, KHÔNG bootstrap data cho 4 dự án khác (NamGroup/DH Y Dược/Ashico/Vipix). 4 em main project khác tự bootstrap khi anh mở session project đó (Cognition "writes single-threaded" boundary). (2) **Option 4a manual PowerShell scripts** thay Phase 6b Task Scheduler auto-start — anh OWN control + visibility tốt hơn qua `rag-start`/`rag-stop`/`rag-status`/`rag-dashboard` aliases + Qdrant dashboard built-in (`http://localhost:6333/dashboard`) FREE. **+1 memory user-level NEW** `feedback_rag_distributed_ownership.md` (~200 chunks added vào RAG sau khi fix bootstrap.py glob extra_corpus bug — `import glob` recursive thay vì Path manual parsing). **RAG corpus final S26:** 127 files → **2,628 chunks** (+207 chunks user-level memory entries 23 file) → ~535K Voyage tokens (0.27% free tier 200M/month). Cache SHA256 hit working PERFECT: re-bootstrap force-reindex 2nd time chỉ 6.5s (vs 60.9s initial — 10× speedup). **Rerank verify**: 5/6 query S26 content hit rerank 0.498-0.926 (Approach B distributed pattern + Option 4a manual scripts + em main project X build infra docs). Query failed "PowerShell aliases rag-start" expected — Phase 6 scripts chưa code thực tế (defer S27+). **Pending S27+ updated:** Phase 5 SKIP cho em (distributed) · Phase 6 = Option 4a scripts (em viết 4 PS1 script + add `$PROFILE` aliases) · Phase 7 = xuất `rag-onboarding-guide.md` 13 section (11 cũ + §12 monitoring + §13 distributed Approach B). **Memory user-level: 24 entries** (+1 NEW `feedback_rag_distributed_ownership.md`).)
-
-**Last updated S26 initial wrap:** 2026-05-21 (Session 26 chốt cuối lần đầu — **🎯 S26 cumulative wrap: 6 plan PE List tree view UI iteration + Plan AI RAG global MCP infrastructure setup**. **Plan AG/AG2/AG3/AG4/AG5/AG6** cumulative 6 commits Plan AG series `0bf6c7e..d99069a` push remote — UAT feedback bro Tra Sol 2026-05-21 screenshot "UI Duyệt NCC như đám rừng" → folder tree giống Outlook: **Plan AG** Phase 1 PE List tree view 2-level Project > Gói thầu > PE (Investigator audit 5Q + Implementer Case 2 cookie-cutter mirror 2 app + Reviewer pre-commit PASS 0 blocker + CICD Monitor Run #222 PASS bundle hash rotate). **Plan AG2** simplify 1-level (drop tầng gói thầu) + Panel 1 widen 340→400px. **Plan AG3** drop single-PE flat branch, consistent UI (mọi dự án dù 1/N phiếu đều render `<details>`). **Plan AG4** bổ sung Người tạo + Phòng ban tạo PE card — BE DTO `PurchaseEvaluationListItemDto` +4 fields (DrafterUserId/DrafterName/DepartmentId/DepartmentName) + 3 projection JOIN Users+Departments LEFT (ListHandler/InboxHandler/ApprovedHandler) + FE `PeListItem` type +4 fields + UI card render 👤 Drafter · Phòng ban. **Plan AG5** extend tree 3-level Project > Năm > NCC > PE (selectedSupplierName fallback "(Chưa chọn NCC)" cho PE chưa DaDuyet). **Plan AG6** compact card 3-row gọn đẹp (drop Type label redundant + combine mã phiếu/time + Drafter/Dept/HĐ inline). **Plan AI RAG global MCP setup** (User-level Approach A — 1 dev 5 dự án cùng máy localhost) — Phase 0 pre-flight + Phase 1 Qdrant v1.18.0 Windows native binary (KHÔNG Docker, PID 67240 port 6333) + Phase 2 FastMCP server ~1100 LOC Python 9 file (server.py + lib/embed.py voyage wrapper + lib/retrieval.py 3-layer pipeline + lib/projects.py auto-detect cwd + lib/chunking.py contextual prepend + lib/watcher.py) + Phase 3 register MCP user-level (`claude mcp add` với `--` separator trick) + Phase 4 bootstrap SOLUTION_ERP 126 files → **2,392 chunks indexed 60.9s** (~484K Voyage tokens = 0.24% free tier 200M/month). 4 test queries verified end-to-end recall: "gotcha #45 PE button TraLai" 0.641 / "admin opt-in per-NV" 0.836 / "EF migration backfill" 0.766 / "multi-agent setup" 0.879. Stack: Voyage-4-large embedding + Voyage rerank-2.5 + Qdrant Windows native + SQLite FTS5 BM25 + Reciprocal Rank Fusion + Anthropic Contextual Retrieval prepend + FastMCP 3.3.1 stdio. **+1 file MD onboarding `docs/guides/multi-agent-setup-guide.md`** xuất cho 4 dự án future (NamGroup/DH Y Dược/Ashico/Vipix detected từ Claude Desktop config epitaxy folder permission). Multi-agent execution S26: 🟦 Investigator 2 spawn (Plan AG audit 5Q ~30K + Plan AI RAG distribution research ~40K — 4 study cases Cursor/Cline/Continue/Sourcegraph) + 🟨 Implementer 1 spawn (Plan AG Case 2 cookie-cutter ~16K) + 🟥 Reviewer 1 spawn (Plan AG pre-commit ~25K PASS 0 blocker) + 🟩 CICD Monitor 1 spawn (Run #222 verify ~12K). Em main solo Plan AG2-AG6 + Plan AI Phase 0-4 (UI polish iteration + RAG infra setup — cost ROI thấp nếu spawn 5×). Stats final S26 chốt: **31 mig (no schema)** · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after) · 49 gotcha unchanged · 23 memory user-level unchanged · 6 skills · 4 sub-agents · **+1 docs file `multi-agent-setup-guide.md`** + **+1 RAG infrastructure** `D:\.claude-rag\` (server + lib + qdrant-bin + data). Patterns reusable cross-project (3 NEW S26): (1) HTML native `<details>/<summary>` + Tailwind named groups `group/proj` + localStorage Set<string> cho hierarchical tree UI when no Accordion lib available (Pattern 19 Implementer NEW), (2) RAG User-level Global MCP 1 server localhost serve N project (Approach A Plan AI), (3) Qdrant Windows native binary deployment (no Docker overhead — appropriate cho 1 dev solo scenario, không scale enterprise). **Memory FLAG**: cicd-monitor MEMORY ~74KB (+2KB từ S25), critical curate session URGENT next.)
-
-**Last updated S25:** 2026-05-19 (Session 25 chốt cuối — **🎯 S25 cumulative wrap: 7 plan + 7 commits Plan AB→AF + 7 CICD Runs (#215 FAIL → #216-#221 PASS)**. Push remote `e23f51c..506cada`. Bro UAT 2026-05-19 phát hiện 2 bug visibility critical PE/2026/A/032 + 4 follow-up polish UAT iteration: **Bug 1 Budget Adjust** không show "Lịch sử thay đổi" (BE log Header+Update OK nhưng FE filter strict TraLai-only loại) — **Bug 2 Return Mode 4 mode** không log Changelog (ApplyReturnModeAsync miss `db.PurchaseEvaluationChangelogs.Add()`) — **Bug 3 Lịch sử duyệt** missing Trả lại + Vượt cấp entries (Reject branch không add Approval row) — **Bug 4 dual-phase badges** gây nhầm "Đã gửi duyệt → Đã gửi duyệt" cho 3 mode Reject giữ Phase=ChoDuyet — **Bug 5 Changelog UserName** show "Hệ thống" thay vì user thật (9 sites BE miss UserName) — **Bug 6 historical name resolve** entries pre-deploy vẫn show empty (forward-only fix). **Plan AB Chunk A** (`cdfd542`) BE log return mode + FE filter relax × 2 app. **Plan AB Chunk A2** (`8c05947`) fix Plan M tests SQLite frozen-clock tie-break (gotcha #48 NEW — Run #215 caught + Run #216 PASS). **Plan AC** (`a734bf2`) BE Reject add Approval row + skipToFinal comment + FE Decision badge × 2 app. **Plan AC2** (`25837b6`) FE merge synthetic Reject rows từ Changelog historical (Option 2A bro chốt, reversible no-DB-touch). **Plan AD** (`0aaf2df`) Drop misleading dual-phase badges + parse next-target hint via regex `Chuyển phase X → Y` + comment keyword Trả lại/Vượt cấp (gotcha #49 NEW). **Plan AE** (`9ea62be`) BE preventive batch fix UserName 9 Changelog.Add sites (Budget Adjust + 8 sites: Create + Update + Detail CRUD + Quote CRUD + Select Winner). **Plan AF** (`506cada`) FE userMap fallback từ embedded domain data PeDetailBundle (drafter + approvals + approvalFlow + levelOpinions + departmentOpinions) — no extra API fetch admin permission. Multi-agent execution: 🟦 **Investigator** 1 spawn Plan AB Bug 1+2 audit ~28K + 🟨 **Implementer** 1 spawn Plan AB Chunk A ~12K Case 1 + 🟥 **Reviewer** 1 spawn Plan AB pre-commit ~22K PASS 0 blocker (1 minor non-block) + 🟩 **CICD Monitor** 7 spawns Run #215-#221 verify ALL PASS post-Plan AB Chunk A2 fix. **Em main solo từ Plan AC đến AF** (5 plan, cross-stack reasoning + UAT iteration borderline, Implementer/Reviewer KHÔNG re-spawn). Stats final S25 chốt: **31 mig (no schema)** · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · **49 gotcha (+2 #48 SQLite tie-break + #49 dual-phase UI confusion)** · **23 memory user-level (+2 NEW: `feedback_fe_merge_synthetic_audit` Plan AC2 + `feedback_fe_usermap_fallback` Plan AF)** · 6 skills · 4 sub-agents active. Bundle hash 6× rotate × 2 app (#216-#221), Mig 31 unchanged toàn S25. Patterns reusable cross-project (8 NEW S25): (1) Multi-Changelog.Add SQLite tie-break test discriminator, (2) CICD catch UAT skip test risk for BE refactor > 100 LOC, (3) Test fix Option A over BE refactor preservation, (4) Capture pre-call mutation state cho audit row from-position, (5) FE merge synthetic rows từ Changelog reversible recovery, (6) Drop misleading dual-phase badges + parse semantic hint, (7) Changelog UserName preventive systemic batch fix, (8) FE userMap fallback từ embedded domain data no extra API. **Memory CRITICAL FLAG**: cicd-monitor MEMORY ~72KB strongly over 50KB hard threshold — DEDICATED CURATION SESSION REQUIRED next (archive Run #186-#210 + S22-S24 verbose). Bro UAT verify ALL Plan AB→AF live deploy cumulative.)
-
-**Last updated S23 t12:** 2026-05-15 (Session 23 turn 12 chốt cuối — **🎯 S23 cumulative wrap: 11 plan + 32 commits cumulative**. Plan K (Mig 31 F2 refactor 9 commits) → L (UAT bug 5) → M (F1 edge case 4) → N (per-NV lookup 1 site 2) → O (4 sites cascade 2) → P (Controller body record 1) → Q (FE banner CSS 1) → R (cleanup phiếu/workflow 1) → S (wipe ALL workflows 1) → T (DemoSeed flag 2) → U (sidebar truncate 1). 4 sub-agents active throughout: 🟦 Investigator 5 spawn (K0 + N + P FE wire + R audit + L2 spawn) + 🟨 Implementer 5 spawn (K1/K3/K5/K7 + M2 + M3 Case 2/3) + 🟥 Reviewer 2 spawn (K2 pre-commit + M3 cumulative review) + 🟩 CICD Monitor 5 spawn (Run #195 K10 + #199 L + #200 M + #201 N + #202 O + #203 P + #204 Q + #207 T + #208 T5+T6 + #209 U — ALL PASS). **Memory user-level update cumulative S23:** `feedback_per_nv_permission_scope.md` reinforced 5 sections (S22+5 + S23 t1 + t3 + t4 + t5 + t6) → wire 10 surface points (point 9 lookup discrimination + point 10 Controller body record mirror). `feedback_uat_skip_verify.md` Plan L lesson Service refactor semantic test atomic. **+1 memory NEW** `feedback_demo_seed_flag_disable.md` cross-project Plan T pattern. **3 destructive cleanup cumulative Plan R+S+T5** ~720 rows wiped + DbInitializer permanent disable demo seed. **Stats final S23 chốt cuối:** 31 mig · 59 tables · ~145 endpoints · 34 FE pages · **111 test unchanged** · 47 gotcha · **21 memory entries** (+1 NEW Plan T flag pattern) · 6 skills · 4 sub-agents active · **0 PE + 0 demo workflow + DemoSeed flag persist** UAT permanent clean slate. Backup rollback: `vietreport-vps:C:\Backup\SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB. **32 commits S23** pushed remote `eb106f2..86d8806`. CI verify ALL PASS. Bro Designer setup workflow mới from scratch, KHÔNG còn auto re-seed contaminate. Plan B Contract V2 wire HIGH priority next.)
-**Last updated S23 t10:** 2026-05-15 (Session 23 turn 10 — **🔧 Plan T: Disable auto re-seed demo data + final DELETE — UAT permanent clean slate**. Bro phát hiện sau Plan R+S: 4 phiếu `[DEMO]-A/B` + 2 V1 workflows + 1 V2 mẫu UAT TỰ ĐỘNG RE-SEED sau khi BE deploy commits Plan P+Q+R+S → IIS recycle → `DbInitializer.InitializeAsync` chạy lại 5 demo seed methods. Bro AskUserQuestion chốt Option A: disable demo seed vĩnh viễn qua flag config. Em main implement: `appsettings.json` add `"DemoSeed": { "Disabled": true }` + `appsettings.Development.json` override `false` cho dev test seed local + `DbInitializer.cs` add `using Microsoft.Extensions.Configuration` + `var demoSeedDisabled = config.GetValue<bool>("DemoSeed:Disabled")` + wrap 5 method conditional `if (!demoSeedDisabled)` (SeedWorkflowDefinitions V1 + SeedPurchaseEvaluationWorkflows V1 + SeedDemoContracts + SeedDemoPurchaseEvaluations + SeedSampleApprovalWorkflowsV2). KEEP: SeedRoles + SeedAdmin + SeedDepartments + SeedDemoUsers (30 UAT users) + SeedMenuTree + SeedAdminPermissions + SeedDemoMasterData (Supplier/Project) + SeedContractTemplates + SeedCatalogs + Backfill helpers. Note: `appsettings.Production.json` bị `.gitignore` (secrets), em set flag mặc định trong `appsettings.json` commit qua git — production inherit `true`. Run #207 sha=0b97840 PASS 3min24s → IIS deploy applied flag. T5 final DELETE: SCP `scripts/plan-t5-final-cleanup.sql` upload + sqlcmd -i 3 TRANSACTION DELETE → 4 PE + 1 V2 + 2 V1 = 7 rows + cascade child. T6 verify NO re-seed loop: `Restart-WebAppPool SolutionErp-Api` force IIS recycle → BE startup → wait healthy → sqlcmd verify: **PE=0 + V2=0 + V1=0** preserved (KHÔNG re-seed) + Users=33 + Suppliers=19 + Projects=9 + Contracts=7 (existing preserved). DemoSeed flag PROVEN active end-to-end. Total cumulative Plan R+S+T cleanup: ~677 rows wiped + DbInitializer re-seed disable vĩnh viễn. Stats final S23 t10: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test unchanged** · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow + flag disable demo seed** — UAT permanent clean slate. Bro Designer setup workflow mới from scratch, KHÔNG còn auto re-seed contaminate.)
-**Last updated S23 t9:** 2026-05-15 (Session 23 turn 9 — **🧹 Plan S: Wipe ALL workflows — UAT clean slate hoàn toàn**. Bro chốt sau Plan R: "các cái demo quy trình cũ -> xóa hết luôn đi nhé". 4 workflows còn lại (2 V2 ghim + 2 V1 active) đều seed demo cumulative (`(mẫu UAT)` / `(clone)(clone)` / `(v01)` sample seed). Bro AskUserQuestion chốt Option A (Recommended): wipe ALL 4 workflows, UAT clean slate. Em main solo execute (Investigator audit Plan R đã cover scope precedent, Plan S = continuation cùng UAT cleanup phase). Backup rollback: Plan R backup `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB vẫn capture full state pre-cleanup → reuse cho rollback. Script `scripts/plan-s-wipe-all-workflows.sql` 2 BEGIN/COMMIT TRANSACTION + SET QUOTED_IDENTIFIER ON. Execute via scp + sqlcmd -i: DELETE ALL ApprovalWorkflows (2 rows cascade Steps+Levels) + DELETE ALL PurchaseEvaluationWorkflowDefinitions (2 rows cascade Steps+Approvers). Post-state: **0 V2 + 0 V1 + 0 Steps + 0 Levels + 0 Approvers** (ALL workflow entities wiped). BE smoke verify 5/5 endpoints 200 (auth + PE list + V2 workflows + V1 workflows + users + menus) — KHÔNG crash startup (no Contract pin to V1 — chỉ PE dùng workflow, PE đã wipe Plan R). Hậu quả expected: user KHÔNG tạo được phiếu mới (Workspace Select empty) cho đến khi admin Designer seed workflow mới from scratch — UAT mode chấp nhận. Total cleanup cumulative Plan R + S: 35 PE + 17 V2 + 4 V1 + ~600 cascade child = **~670 rows wiped**, prod database UAT clean slate hoàn toàn. Stats final S23 t9: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · 111 test · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow** (database state mới hoàn toàn). Pending: admin Designer seed workflow mới + bro UAT test fresh.)
-**Last updated S23 t8:** 2026-05-15 (Session 23 turn 8 — **🧹 Plan R: Cleanup destructive prod database — phiếu test + workflow ko ghim**. Bro UAT confirm Plan P+Q wire OK + chỉ thị "OK Tao thấy tạm ổn rồi đấy, mày xóa hết các phiếu test cũ đi nhé, các quy trình cũ ko ghim cũng xóa hết đi. Cho gọn đẹp." 🟦 Investigator pre-flight audit prod ~64K spawn confirm scope: 28 PE active + 7 soft-deleted + 15 V2 workflows IsUserSelectable=false + 2 V1 workflows IsActive=false. FK Restrict gotcha: PE.ApprovalWorkflowId Restrict → phải hard-DELETE PE trước (soft-delete KHÔNG release FK). Entity extend `BaseEntity` (workflow) KHÔNG hỗ trợ soft-delete. Bro chốt Option A (Recommended) qua AskUserQuestion. Em main execute 6 steps qua sqlcmd ssh vietreport-vps: (1) BACKUP `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB qua `scripts/plan-r-backup.sql` upload scp + sqlcmd -i (workaround SQL Express no COMPRESSION + no RESTORE VERIFYONLY permission cho vrapp). (2) Script `scripts/plan-r-cleanup.sql` 3 BEGIN/COMMIT TRANSACTION + SET QUOTED_IDENTIFIER ON (filtered index Mig 29+ require). (3) DELETE 35 PE rows (28 active + 7 soft-deleted, cascade ~446 child: 42 Details + 49 Suppliers + 64 Approvals + 238 Changelogs + 10 Attachments + 43 LevelOpinions). (4) DELETE 15 V2 unghim (cascade ~140 Steps+Levels). (5) DELETE 2 V1 inactive (cascade ~37 Steps+Approvers). Total: **52 rows + ~600 cascade child deleted**. Post-cleanup state: **0 PE · 2 V2 workflows ghim** (`QT-DN-V2-001 v16` + `QT-DN-PA-V2-001 v2`) · **2 V1 workflows active** (`QT-DN-A v3` + `QT-DN-B v1`). Smoke verify BE alive post-cleanup: 3/3 endpoints 200 (auth login + PE list + V2/V1 workflow list) → KHÔNG crash startup (Plan F precedent S22 avoid được — V1 active workflow giữ nguyên). Multi-agent ROI: Investigator catch FK Restrict gotcha + recommend backup mandatory + 3 Option compare — saved em main hard-delete without backup risk. Stats final S23 t8: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · 111 test unchanged · 47 gotcha · 20 memory · 6 skills · **0 PE phiếu test + 4 workflow ghim/active** (gọn đẹp UAT clean slate). Pending: bro UAT test workflow mới fresh.)
-**Last updated S23 t6:** 2026-05-15 (Session 23 turn 6 — **🎯 Plan P: HOTFIX Controller TransitionPeBody record missing 3 fields — bug ROOT CAUSE thực sự của F1+F2 fail**. 1 commit Plan P atomic. CICD Monitor Run #202 verify Plan O CRITICAL caveat catch: `PurchaseEvaluationsController.cs:267` `TransitionPeBody` record CHỈ có 3 fields (TargetPhase, Decision, Comment) — MISSING 3 fields có trong Command record `TransitionPurchaseEvaluationCommand` (ReturnMode + ReturnTargetUserId + SkipToFinal). `mediator.Send` line 70 cũng drop 3 field. → FE × 2 app SEND ĐÚNG 7 fields qua `api.post(/transitions)` body (Investigator verify FE wire OK 100%) → ASP.NET Core deserialization silently DROP 3 fields ở Controller layer → Handler nhận `ReturnMode=null` + `SkipToFinal=false` → fallback default Drafter mode + F2 không trigger. Bug present 2 NGÀY PROD từ Mig 28 deploy 2026-05-13 — gây TẤT CẢ F1+F2 wire fail từ FE side (Plan N + Plan O fix lookup sites nhưng controller bug block flow trước khi đến lookup site). Fix Plan P: Controller body record +3 field default null/false + `mediator.Send` pass 7 fields + add `using SolutionErp.Application.PurchaseEvaluations.Services` cho WorkflowReturnMode enum import. ~10 LOC BE 1 file. dotnet test **111/111 PASS** (+0 từ 108 — không cần test mới vì Investigator confirm scope BE Controller only, FE wire đúng, Mig 28/31 Domain test đã cover handler logic). Multi-agent ROI: 🟦 Investigator audit FE 2 spawn ~58K confirm hypothesis BE-only scope, avoid em main fix sai cross-stack. 🟩 CICD Monitor Run #202 catch caveat critical lúc verify Plan O — invaluable bug catch chain. Pattern reinforced: **Controller body record MUST mirror Command record fields** khi Command thêm optional params — Mig 28 + Mig 31 cumulative thêm 3 fields nhưng Controller body record chưa update → silent drop bug. Stats final S23 t6: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test pass unchanged** · 47 gotcha · 20 memory · 6 skills · 4 sub-agents (Investigator FE wire + CICD Monitor verify spawns). CHƯA push remote — chờ CICD verify cuối.)
-**Last updated S23 t5:** 2026-05-15 (Session 23 turn 5 — **🎯 Plan O: HOTFIX 4 lookup sites cùng pattern per-NV cascade — Plan N point 9 chỉ catch 1/5 sites**. 2 commits Plan O atomic + docs. Bro UAT 2026-05-15 sau Plan N deploy phát hiện tiếp: Actor NV Test (UAT V2) trong OR-of-N slot 4 NV click "Trả lại Người chỉ định" → toast "Không phải lượt bạn" mặc dù NV Test đúng trong slot. Em main audit grep `FirstOrDefault.*Order ==` toàn project — discovered 5 lookup sites total: Plan N catch 1 (GetPe handler), 4 sites khác CÙNG BUG còn nguyên: (1) `Service.cs:201` `EnsureCanRejectV2Async` actor match guard ← Bug bro UAT ROOT CAUSE, (2) `Service.cs:248` `ApplyReturnModeAsync` read Allow flag từ row đầu, (3) `DetailFeatures.cs:72` F3 `EnsureEditableForDetailsAsync` cùng bug, (4) `Features.cs:311` F4 `AdjustBudgetCommand` cùng bug. 👤 Chủ trì Solo fix 4 sites surgical ~30 LOC + add `Guid? actorUserId` param vào `ApplyReturnModeAsync` (4 param signature change) + caller `TransitionAsync:94` update + 3 regression test mới `PurchaseEvaluationPerNvLookupRegressionTests` (Actor non-first-row OR-of-N trả lại / Outsider không slot ForbiddenException / Actor có flag while others don't AllowsMode). dotnet test **111/111 PASS** (+3 từ 108 baseline Plan N). Pattern reinforced: **5 lookup sites checklist** sau Mig 29 OR-of-N — Plan N chỉ catch 1/5. Memory `feedback_per_nv_permission_scope.md` CRITICAL HOTFIX S23 t5 section updated với 5 sites enum + audit grep checklist. Bug 2 (F2 Duyệt thẳng chỉ đến Phan Văn Chương thay vì Nguyễn Văn Trường BOD) defer follow-up — F2 logic line 483-524 đã đúng, cần verify workflow v14 DB structure thực tế. Stats final S23 t5: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test pass (+3)** · 47 gotcha · 20 memory (1 entry CRITICAL HOTFIX section reinforced 2 lần) · 6 skills · 4 sub-agents (em main solo Plan O — bug fix reasoning chain cross 4 sites). CHƯA push remote — chờ CICD verify.)
-**Last updated S23 t4:** 2026-05-15 (Session 23 turn 4 — **🎯 Plan N: HOTFIX per-NV lookup site discrimination — BE bug critical UAT block**. 2 commits N1+N2 batch atomic + N4 docs. Bro UAT screenshot post-Plan M deploy: Admin Designer tick TRUE 7 flag cho NV Test (UAT V2) slot Bước 2 Cấp 1 workflow QT-DN-V2-001 v12/v13 (4 NV cùng Cấp) — actor login → dialog ✓ Duyệt KHÔNG có checkbox F2 skipToFinal + dialog ← Trả lại CHỈ 1 radio Drafter + KHÔNG có F3+F4 Edit options. 🟦 Investigator audit (~80K spawn) verify Hypothesis B: BE bug `PurchaseEvaluationFeatures.cs:765` `FirstOrDefault(l => l.Order == curLevelOrder)` thiếu discriminator `ApproverUserId == currentUser.UserId` — schema Mig 29 (S21 t5) refactor: 1 row per ApproverUserId (OR-of-N cùng Order) → handler luôn lấy row đầu DB (Lê Văn Bính — Drafter only), bỏ qua admin tick per-NV của actor. Bug PRESENT từ Mig 29 deploy 2026-05-13 nhưng chỉ bộc lộ khi lần đầu admin tick selectively per-NV. 👤 Chủ trì Solo fix N1 (5 LOC BE) + N2 regression test (~200 LOC test) + N4 docs — KHÔNG spawn Implementer vì bug fix reasoning chain. Fix: `var curLevel = curStep?.Levels.FirstOrDefault(l => l.Order == curLevelOrder && l.ApproverUserId == currentUser.UserId) ?? curStep?.Levels.FirstOrDefault(l => l.Order == curLevelOrder);` — actor match per-NV slot, admin/non-approver fallback row đầu (giữ behavior view detail). Test regression `GetPurchaseEvaluationCurrentLevelOptionsTests` 2 method: 4 actor distinct flag profile + admin fallback. dotnet test **108/108 PASS** (+2 từ 106). Pattern reinforced: **Per-NV admin opt-in flag** wire checklist phải bao gồm **9 surface points** (KHÔNG 8) — thêm point 9 "Handler lookup site `currentLevelOptions` MUST discriminate ApproverUserId". Cumulative Mig 29 + 30 + 31 đã wire 8 points đúng nhưng MISS point 9 — bug present 2 days production. Stats final S23 t4: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **108 test pass (+2)** · 47 gotcha · 20 memory (1 entry reinforced narrative wire checklist 9 points) · 6 skills · 4 sub-agents (1 Investigator spawn). CHƯA push remote — chờ Reviewer/CICD verify.)
-**Last updated S23 t3:** 2026-05-15 (Session 23 turn 3 — **🎯 Plan M: Fix F1.OneLevel/OneStep edge case Bước 1 → giữ ChoDuyet (KHÔNG fallback Drafter) + FE label phase TraLai rename**. 3 commits Plan M `c2042ef..4dd6f9c` chuỗi M1→M3→M2: M1 (`c2042ef`) BE Service `ApplyReturnModeAsync` 2 edge case block (line 287-333) → reset (0, 1) giữ Phase=ChoDuyet thay vì fallback Phase=TraLai (semantic mới per bro chốt AskUserQuestion: "Cho phép nhưng vẫn giữ ChoDuyet, clear pointer thôi") + M3 (`508b17a`) FE × 2 app rename `PurchaseEvaluationPhaseLabel[98]` + `PeDisplayStatusLabel.TraLai` + 2 inline literal trong PeWorkflowPanel F1 dialog "Trả lại" → "Cần chỉnh sửa lại" (phase status badge, KHÔNG đụng action verb "← Trả lại" + mode picker "Trả về Người soạn thảo") + M2 (`4dd6f9c`) Tests add 2 edge case test `OneLevel_AtStep1Level1_ResetsToBuoc1Cap1_KeepsChoDuyet` + `OneStep_AtStep1_ResetsToBuoc1Cap1_KeepsChoDuyet` + helper `SeedWorkflowAsync` extend 2 param optional. Multi-agent execution: 🟦 Investigator audit pre-flight catch fact code main path đã đúng (F1.OneLevel/Assignee + F2 + F3 + F4 main path giữ ChoDuyet) chỉ edge case Bước 1 fallback sai + 🟨 Implementer 2 spawns Case 2+3 (M2 + M3) + 🟥 Reviewer pre-commit pending + 👤 Chủ trì M1+M4. Test final: **106/106 PASS** (+2 từ 104, 58 Domain + 48 Infra) — K7 Approver F2 NO cascade. F1.Drafter mode 4 GIỮ NGUYÊN Phase=TraLai semantic (explicit role mode). Memory user-level update 2 entry: `feedback_per_nv_permission_scope.md` reinforcement S23 t3 "edge case không lùi được KHÔNG fallback role khác" + `feedback_uat_skip_verify.md` Plan L lesson "Service refactor semantic BẮT BUỘC update test cùng commit". Stats final S23 t3: **31 mig** (no change) · 59 tables · **~145 endpoints** (no change) · 34 FE pages · **106 test pass (+2)** · 47 gotcha · 20 memory (2 entry reinforced) · 6 skills · 4 sub-agents. CHƯA push remote — chờ Reviewer verdict.)
-**Last updated S23 t1:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K: F2 refactor sang per-Approver-slot Mig 31** + UI consistency. 8 commits Plan K `56868bf..<latest>`: Chunk pre-A slot label rename → K1 Mig 31 schema swap (drop `Users.AllowDrafterSkipToFinal` + add `ApprovalWorkflowLevels.AllowApproverSkipToFinal` no BACKFILL) → K2 Service ApproveV2Async Approver F2 branch + DTO refactor → K3 Designer 7th checkbox + banner rewrite → K5 zombie endpoint cleanup + Reviewer Major #1+#2 + Minor #3+#4 → K6 Workspace × 2 app DROP Drafter + ADD Approver toggle → K7 tests regression 104/104 PASS (3 deleted + 3 added cancel) → K8 docs. Multi-agent execution: 🟦 Investigator K0 pre-flight + 🟨 Implementer K1+K3+K5+K7 (4 spawns Case 2+3) + 🟥 Reviewer K2 pre-commit (PASS 0 critical, 2 Major + 2 Minor) + 👤 Chủ trì K0-bis+K2+K6+K8. Bro decision: F2 semantic ĐỔI Drafter from Nháp → Approver during ChoDuyet skip thẳng Cấp cuối (mirror F3+F4 admin opt-in per slot) + setup ALL ở Workflow Designer (KHÔNG ở User Management). UI slot label "#NV {order}" → ApproverFullName. Stats final S23 t1: **31 mig (+1 Mig 31)** · 59 tables · **~145 endpoints (-1 backout /allow-skip-final)** · 34 FE pages · **104 test pass unchanged** (3 deleted + 3 added) · 47 gotcha unchanged · 20 memory (cumulative reinforce `feedback_per_nv_permission_scope` 3×) · 6 skills · **4 sub-agents active 4 spawns (Implementer Case 2+3) + 1 Reviewer**. 4 prod user lose `AllowDrafterSkipToFinal=true` value per Option A (admin re-config qua Designer). Pattern reinforced: per-NV admin opt-in flag 3× proven (Mig 29 F1+F3 + Mig 30 F4 + Mig 31 F2) — pattern ALSO applies cho refactor existing scope, KHÔNG chỉ greenfield. Plan B Contract V2 wire vẫn pending S23 t2+. CHƯA push remote — chờ bro confirm.)
-**S22 chốt cuối:** 2026-05-13 2200 (Session 22 CHỐT — **🎯 Bro chốt sub-agent solution OK**. 11 commits S22 pushed remote `3d725c4..b04a11a`. CICD Monitor Run #188 PASS verified. Highlights: Plan D F2 toggle + Plan C +20 test (test catch-up backlog) + Plan E strict V2 scope + Plan F ABORTED pre-flight (defer sau Plan B) + S22+1 fix disable 3 button bug + S22+2 seed 20 test user role-based naming + S22+3 rename users `{dept}.{level}@solutions.com.vn` + S22+4 attachment view inline PDF + Section "Điều chỉnh ngân sách" + S22+5 Mig 30 `AllowApproverEditBudget` per-NV opt-in (spec fix bro feedback). Stats final S22: **30 mig (+1 Mig 30)** · 59 tables · **~146 endpoints (+3)** · 34 FE pages · **104 test pass (+20: 5 reg #44 + 7 ReturnMode + 7 Guard + 1 V2 actor scope)** · **47 gotcha (+1 #47 paths-ignore agent-memory gap pending bro fix)** · 19 memory · 6 skills · **33 active users prod** (13 cũ + 20 mới role-based) · 4 sub-agents (CICD Monitor Run #188 PASS verify, 3 sub-agents seeds-only em main solo throughout S22). Pattern reinforced: per-NV admin opt-in flag 2× proven (Mig 29 + Mig 30) — anti-pattern default scope expansion. Memory `feedback_per_nv_permission_scope` reinforced S22+5 narrative.)
-**Last updated S22 prev:** 2026-05-13 1800 (Session 22 — Plan C + D + E done, Plan F ABORTED pre-flight fail. 5 commits local `60efeed`→`dbda37e`→`215b1e0`→`f149661`→Docs. Plan D BE+FE Admin User F2 toggle UI (PATCH /users/{id}/allow-skip-final + UsersPage column "Skip cuối" violet badge). Plan C task 4 5 reflection regression test gotcha #44 silent 403 ApprovalWorkflowsV2Controller policy split (catch class-level Policy regression). Plan C task 1-3 14 service test catch-up — ApplyReturnMode 4 mode per-NV Mig 29 + skipToFinal per-Drafter + EnsureEditableForDetails F3 gating. Plan E strict V2 scope List + Detail (remove UAT loose `|| ApprovalWorkflowId != null`, replace with V2 approver actor.UserId scope via ApprovalWorkflowLevels join). Plan F ABORTED — pre-flight prod sqlcmd reveal 23 PE + 7 Contract pin V1 + Contract entity HOÀN TOÀN V1 chưa wire V2 → drop V1 BE crash startup. Defer F sau Plan B Contract V2 + migrate 4 V1-only PE + UAT 2-3 tuần. Stats S22: 29 mig (0) · 59 tables · ~144 endpoints (+1) · 34 FE pages · **103 test pass (+19: 5 reg #44 + 7 ReturnMode + 7 Guard)** · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (em main solo). Pattern reusable: SeedWorkflowAsync + SeedApproversAsync helper test infra + reflection Authorize regression test + pre-flight prod check pattern. CHƯA push remote — chờ bro confirm.)
-**S21 chốt cuối:** 2026-05-13 1530 (Session 21 chốt cuối — 5 turn cumulative pushed remote, CICD verified PASS 2/2 run, 1 gotcha mới #46 Gitea API path, 2 memory entry mới — `feedback_ef_migration_backfill_reorder` + `feedback_per_nv_permission_scope`. Session 21 5 turn timeline: t1 cicd-monitor add → t2 RAG planning Cách A → t3 fix gotcha #45 → t4 F1+F2+F3 Mig 28 → t5 refactor Allow* per-NV Mig 29. Stats final: 29 mig · 59 tables · ~143 endpoints · 34 FE pages · **84 test pass** · **46 gotcha (+2 từ S20: #45 PE button mismatch + #46 Gitea API)** · **19 memory entries (+3 từ S20: RAG + EF backfill + per-NV scope)** · 6 skills · 4 sub-agents (3 seeds-only + 1 cicd-monitor 2 runs PASS). 12 commits pushed `3a34831..c0af9e0`. Plan G Trial Week 1 evidence: CICD Monitor catch 0 fail vì green 2/2 run, cost 110-120K/run under 150K budget, 3-3.5min CI time stable. KHÔNG còn pending push. UAT mode skip dotnet test mỗi chunk, test-after Plan C bundle cho tất cả turn 3-5 sau UAT 2-3 lần ổn.)
-**S21 turn 5:** 2026-05-13 1400 (Session 21 turn 5 — **🎯 Refactor F1+F2+F3 sang PER-NV (Mig 29 drop Mig 28 column workflow-level). 4 chunk per-commit `0366946` (A BE schema+Service refactor) → `63234b2` (B FE Admin Designer 5 checkbox per-Level row) → `5ccb2a7` (C FE eOffice rename currentLevelOptions + drafterAllowSkipToFinal) → this Chunk D Docs. **F1+F3** 5 flag MOVED xuống `ApprovalWorkflowLevels` (per slot Approver, mỗi NV có riêng quyền duyệt). **F2** AllowDrafterSkipToFinal MOVED xuống `Users` (per-Drafter user, admin config ở User Management). Mig 29 4-stage: ADD 5 column Levels + 1 column Users + BACKFILL bulk SQL (copy workflow → all Levels, set TRUE cho Drafter user nào từng dùng workflow Allow) + DROP 6 column workflow `ApprovalWorkflows`. Service `ApplyReturnModeAsync` refactor đọc `currentLevel.AllowXxx` thay vì `workflow.AllowXxx`. Helper `EnsureEditableForDetailsAsync` read `level.AllowApproverEditDetails`. DRAFTER trình branch read `userManager.FindByIdAsync(actorUserId).AllowDrafterSkipToFinal`. DTO refactor: `AwLevelDto +5 Allow*`, `AwDefinitionDto -6 Allow*`, `CreateAwLevelInput +5 Allow*`, `PeDetailBundle.workflowOptions → currentLevelOptions + drafterAllowSkipToFinal`. FE Admin Designer drop section "Cấu hình nâng cao" workflow-level, replace 5 checkbox grid-cols-2 inline mỗi Level entry row (5 flag per slot). FE eOffice rename `wfOptions → levelOptions` đọc `currentLevelOptions`. Backward compat: backfill preserve admin config S21 t4. Test 84/84 PASS unchanged. Stats: **29 mig (+1) · 59 tables · ~143 endpoints · 34 FE pages · 84 test pass · 45 gotcha · 17 memory · 6 skills · 4 sub-agents seeds-only.**)
-**S21 turn 4:** 2026-05-13 1200 (Session 21 turn 4 — **🎯 F1+F2+F3 PE Workflow advanced options (Mig 28) — 5 chunk per-commit `0294693`→`c56024b`→`a508564`→`d27caaf`→this Chunk E Docs. **F1** 4 mode Trả lại admin tick: "1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo" — 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain), mode Drafter giữ Phase=TraLai S17 fallback. **F2** Drafter skip thẳng Cấp cuối — workflow tick + Workspace checkbox dynamic confirm. **F3** Approver edit Section 2 (Hạng mục/NCC/Báo giá) khi workflow tick + actor match CurrentLevel + audit ghi PurchaseEvaluationChangelog. Mig 28 `ApprovalWorkflows +6 bool Allow*` (DEFAULT 1 cho AllowReturnToDrafter backward compat, 5 còn lại 0). BE Service `TransitionAsync` extend 3 optional param (returnMode/returnTargetUserId/skipToFinal) + helper `ApplyReturnModeAsync` switch 4 mode. Detail/Quote/Supplier helper `EnsureEditableForDetailsAsync` mới (kế thừa `EnsureDraftAsync` + add ChoDuyet+F3 branch + Admin bypass). FE Admin Designer "Cấu hình nâng cao" section 6 checkbox 3 group. FE eOffice 3 changes mirror 2 app: Trả lại radio picker 1-4 mode + Workspace skip checkbox violet + Section 2 itemsReadOnly approver banner. UAT mode skip dotnet test mỗi chunk (per `feedback_uat_skip_verify`), `npm run build` × 2 app pass mỗi chunk. Stats: **28 mig (+1)** · 59 tables · **~143 endpoints (+1 user-selectable patch existed)** · **34 FE pages (+1 Designer section)** · **84 test pass unchanged** (UAT defer test-after) · **45 gotcha unchanged** · 17 memory · 6 skills · 4 sub-agents seeds-only.**)
-**S21 turn 3:** 2026-05-12 2100 (Session 21 turn 3 — **🎯 Bug fix CRITICAL "Trả về nhưng hệ thống vẫn duyệt" PE workflow (gotcha #45). 2 chunk per-commit `de00887` (BE Chunk A) + `4b29d00` (FE Chunk B) + Chunk C Docs this. Root: PeWorkflowPanel.tsx `isReject` payload (L64-66) thiếu nhánh TraLai → button "← Trả lại" gửi `decision: 1` (Approve) thay vì `2` (Reject) khi target=TraLai(98) → BE ApproveV2Async UPSERT opinion "đã duyệt" + advance Cấp. Inconsistency phụ: dialog `isSendBack` (L247-248) cùng pattern thiếu TraLai → dialog title sai. Fix BE defense-in-depth + FE 3 chỗ × 2 app mirror rule §3.9. Test-before §7 BẮT BUỘC: 3 regression test mới (2 reproduce bug + 1 happy path control) — `dotnet test SolutionErp.slnx` 84 PASS (58 Domain + 26 Infra = +3). `npm run build` × 2 app pass. Stats: 27 mig (no change) · 59 tables · ~142 endpoints · 34 FE pages · **84 test pass (+3)** · **45 gotcha (+1 #45)** · 17 memory entries (no new) · 6 skills. Em main solo (no sub-agent spawn S21 t3 — bug fix reasoning chain cross BE/FE Implementer REFUSE per multi-agent rule).**)
-**S21 turn 2:** 2026-05-12 1800 (Session 21 turn 2 — **🎯 RAG Hybrid setup planning + Cách A validation deep dive. 2 commit (`1f8e9af` plan save 1223 LOC + this chốt). Em main solo (no SOLUTION_ERP sub-agent spawn), delegate claude-code-guide × 2 research Anthropic + community practice. Decision chốt: Cách A defensive (giữ blanket 120K em main + RAG retrieve supplement) over Cách B aggressive (cắt 60-70% blanket). Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider all hybrid). Stack: Voyage-3-large + Qdrant local + FastMCP Python + Streamlit dashboard 7 pages + SQLite event log. Multi-agent cost reality: 4 agents → ~520K cumulative blanket → heavy session ~560K (Cách A) vs ~700K (lazy), saving -20%. 3-layer pattern Phase 1-3 rollout (Layer 1 vector → Layer 2 +BM25 → Layer 3 +reranking, recall ~70% → ~92%). Stats: +1 memory entry (`feedback_rag_hybrid_pattern.md`) +1 plan file (`rag-setup-plan.md` 1500 LOC final). 4 sub-agents vẫn seeds-only. Plan I NEW deferred chờ bro confirm 5 dự án path + stack + Voyage API key + disk cleanup 5-8GB.**)
-**S21 turn 1:** 2026-05-12 0030 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier green READ tier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`, CI skipped per path filter (`**/*.md` paths-ignore docs-only). Trade-off: +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động (bundle hash unchanged / mig drift prod / endpoint 500) — recurring blind spot pattern em main solo S20 quên verify ~30% push. Cost reality update: ~750K spawn setup (3 → 4 agents) · ~1.35M heavy session · ~700K optimized cached. Stats: 4 sub-agents seeds-only (+1 cicd-monitor green) · 16 memory entries (no new, update existing `feedback_multi_agent_setup.md` 3 → 4 agents narrative) · 27 mig · 59 tables · ~142 endpoints · 81 test unchanged · 44 gotcha unchanged · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work S21 t1 nên KHÔNG có findings — em main solo via context + Write file).**)
-**S20 wrap:** 2026-05-11 22:00 (Session 20 wrap turns 1-12 — **🎯 14 commit `9dee00d` → `ae1814c`. PE Detail UI restructure 3 yêu cầu (t1-5) + Manual budget drop tên (t6) + Mig 27 admin menu eOffice (t7) + NCC palette 5-màu cycle + Winner icon ✓ đậm + AddSupplier auto-fill master + Responsive laptop nhỏ 4-tầng pattern (t8-11) + Multi-agent infrastructure setup 3 sub-agents (t12). 27 mig (+1) · 59 tables · ~142 endpoints (+1) · 34 FE pages (+1) · 61 menu key (+1) · 81 test pass unchanged · 44 gotcha · 16 memory entries (+2) · 3 sub-agents NEW. Phase 9 UAT iteration mode.**)
-**S20 turn 7:** 2026-05-11 17:00 (Session 20 turn 7 — **🎯 Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27). 5 chunk `2ea2d27`→`ef394f8`→`059bfcb`→`1ed6530`→Chunk E Docs. User Q2=b: DisplayLabel CHỈ áp fe-user, admin sidebar giữ Label gốc. Domain MenuItem +IsVisible(true) +DisplayLabel(200). Mig 27 AddVisibilityAndDisplayLabelToMenuItems. BE PATCH /api/menus/{key} [Authorize Policy=Permissions.Update]. NEW FE-admin MenuVisibilityPage ~210 LOC (table inline edit per-row + Save dirty + Khôi phục mặc định + Toggle Eye/EyeOff + 4 StatCard). fe-user Layout filterForUser 2 tầng (USER_HIDDEN_KEYS hardcode + !isVisible dynamic) + effectiveLabel(displayLabel || label) replace 3 callsite. fe-admin Layout KHÔNG đụng. +1 menu key MenuVisibility "Menu eOffice" leaf System Order=94. 27 mig, 59 tables, ~142 endpoints, 34 FE pages, 81 test pass (Q4 UAT defer).**)
-**S20 prev:** 2026-05-11 (Session 20 — **🎯 PE Detail UI restructure 3 yêu cầu user UX. 4 chunk per-commit `9dee00d` → `2bba851` → `f2f01f4` → (current Chunk D Docs).** Q1=a (giữ Section "Chọn NCC TP" riêng), Q2=a "1 hạng mục trước tiên" (NCC shared, demo 1 hạng mục), Q3=a (chỉ hiện NV đã ký), Q4 public luôn (skip dotnet test mỗi chunk theo memory `feedback_uat_skip_verify`, vẫn `npm run build` × 2 app mỗi chunk vì có rename/remove function). **Chunk A (`9dee00d`)**: BE `CreatePurchaseEvaluationCommandHandler` thêm 1 PurchaseEvaluationDetail mặc định khi tạo phiếu — GroupCode="01", GroupName="Hạng mục chính", NoiDung=TenGoiThau, DonGiaNganSach=ThanhTienNganSach=Budget.TongNganSach hoặc BudgetManualAmount fallback 0; Changelog Insert audit. FE reorder PeDetailTabs (mirror 2 app) 1.Thông tin / 2.Hạng mục (lên #2) / 3.Chọn NCC / 4.NCC tham gia / 5.Ý kiến. **Chunk B (`2bba851`)**: ItemsTab restructure thành list `HangMucCard` (1 card / 1 hạng mục, expanded=true mặc định cho 1 hạng mục demo). Header card: GroupCode + NoiDung + 3 stat (KL/ĐG/TT) + NS link Δ nếu có + Pencil/Trash actions + ▼/▶ toggle expand. Expand body: NCC inline table columns NCC / Liên hệ / Điều khoản TT / **File báo giá** / ĐG chưa VAT / ĐG có VAT / Thành tiền / Action. Quote inline click cell → QuoteDialog cũ reuse. Add NCC + Sửa NCC reuse AddSupplierDialog/EditSupplierDialog cũ. Winner ✓ button mỗi NCC row. Drop function `SuppliersTab` (dead code ~134 LOC, replace bằng HangMucCard expand panel). Giữ AddSupplierDialog + EditSupplierDialog + SupplierAttachmentsCell (HangMucCard call lại). Section layout cuối: 1.Thông tin / 2.Hạng mục + Báo giá NCC (nested) / 3.Chọn NCC TP thắng thầu / 4.Ý kiến cấp duyệt — 4 section. **Chunk C (`f2f01f4`)**: Section Ý kiến restructure render layer (KHÔNG đụng Mig 26 schema — vẫn UPSERT 1 row / Level). LevelOpinionsSectionV2 forEach step → 1 `StepOpinionsBox` (replace grid-cols-2 cho N approver). Box header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter. Body: filter opinions theo step.order → sort levelOrder asc, signedAt asc → render `StepOpinionEntry` per signed opinion (tên NV + Cấp badge slate + admin override badge amber nếu có + emerald rounded-full timestamp + comment text). NV chưa duyệt KHÔNG hiển thị (Q3=a). Drop function `LevelOpinionBox` (replaced). Mirror fe-admin + fe-user. Verify build pass cả 2 app sau khi catch TS6133 `SuppliersTab` + `SupplierAttachmentsCell` unused (đã giải quyết: drop SuppliersTab, restore SupplierAttachmentsCell vào HangMucCard cột "File báo giá"). 81 test pass (no change — UAT defer)**)
-
-## 📍 Phase hiện tại: **Phase 9 active — UAT V2 testing với user thật** — **59 DB tables, 29 migrations (Mig 28 +6 column workflow-level S21 t4 → Mig 29 refactor sang per-NV S21 t5 — 5 column trên ApprovalWorkflowLevels + 1 column trên Users + DROP 6 column workflow-level), ~143 API endpoints, 34 FE pages. 84 unit test pass** (58 Domain + 26 Infra = +3 PE guard S21 t3, UAT defer test-after per §7 cho S21 t4+t5). **46 gotcha (+1 S21 t5 chốt: #46 Gitea API path/cache)**. 30 demo user + 1 test user UAT. 6 skill. **5 trạng thái phiếu** (Nháp/Đã gửi duyệt/Trả lại/Từ chối/Đã duyệt). **2 Workflow schemas đồng tồn tại** post-Session 17 + Per-NV refactor S21 t5: (1) Mig 21 `WorkflowDefinition` flat (V1) — pin với PE/Contract cũ. (2) Mig 22-29 `ApprovalWorkflow` (V2) — pin với PE mới, Mig 29 các flag per-NV ở Levels + Users. Service PE branch theo `ApprovalWorkflowId`. **4 sub-agents:** 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer (3 seeds-only S21 — em main solo cross-stack reasoning chain REFUSE) + 🟩 CICD Monitor (2 runs PASS, ~110-120K/run cost). 30 demo user + 1 test user UAT. 6 skill. **5 trạng thái phiếu** (Nháp/Đã gửi duyệt/Trả lại/Từ chối/Đã duyệt). **2 Workflow schemas đồng tồn tại** post-Session 17: (1) Mig 21 `WorkflowDefinition` flat (V1) — pin với PE/Contract cũ + match Dept+PositionLevel. (2) Mig 22-26 `ApprovalWorkflow` (V2) — pin với PE mới + match ApproverUserId 1-1, Steps/Levels group by Order, Bước (Phòng) > Cấp (N NV OR-of-N), Mig 25 +IsUserSelectable admin pin per version, **Mig 26 +PeLevelOpinions sign-off dynamic theo Level**. Service PE branch theo `ApprovalWorkflowId` set or null. Sau UAT chốt → migrate + drop V1 + Contract V2 wire.
-
-### 🌐 Production URLs
-
-- https://api.solutions.com.vn — API (Let's Encrypt, auto-renew via win-acme)
-- https://admin.solutions.com.vn — Admin FE (HTTP→HTTPS auto-redirect)
-- https://eoffice.solutions.com.vn — User FE (HTTP→HTTPS auto-redirect)
-- https://git.baocaogiaoduc.vn/vietreport-admin/solution-erp — Gitea repo + Actions
-- Default admin: `admin@solutionerp.local` / `Admin@123456` ⚠️ **RE-ROTATE sau login đầu**
-
-## 🔥 In Progress — Session 7+ (Phase 9 active)
-
-### A. Hard blockers (chờ user / ops)
-
-- [ ] **UAT thật 1 tuần** với 2-3 user (Drafter / CCM / BOD) — hard requirement Phase 5 roadmap
-- [ ] **SMTP config** → Email outbox (BLOCKED chờ user cấp host/user/pass)
-- [ ] **Rotate creds** — admin + 30 demo + SA + vrapp + JWT secret + Gitea runner token
-- [ ] **Schedule SQL backup daily** — `scripts/backup-sql.ps1` đã sẵn, chưa schedule Task Scheduler
-- [ ] **Remove binding cũ `.huypham.vn`** sau verify stable: `ssh vietreport-vps ; .\migrate-domains.ps1 -RemoveOld -SkipCert`
-- [ ] **win-acme scheduled task "unhealthy"** — auto-renew fix trước 2026-06-18
-
-### B. Carry over feature gap
-
-- [ ] **Export phiếu PDF/Excel** PE — tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx` (user pending — không quan trọng lắm)
-
-### C. Optional polish (khi UAT phát sinh bug)
-
-- [ ] Budget MaNganSach atomic sequence (hiện Random.Shared → migration `AddBudgetCodeSequences`)
-- [ ] Budget versioned workflow (admin config UI thay hardcoded `BudgetPolicy.Default`)
-- [ ] Payment terms PE tách field (JSON blob → 6 column riêng)
-- [ ] Auto-map PE Details → Contract per-type Details khi gen HĐ
-- [ ] Matrix Quotes bulk paste từ Excel
-- [ ] fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"
-
-### D. Tests Phase 3-5 (làm khi gặp bug recurring để justify ROI — rule §7)
-
-- [ ] **Phase 3 full** — Application handler tests cần UserManager DI helper (PE Opinion Upsert, Budget validate, CreateContractFromEvaluation BudgetId carry) ~15 test
-- [ ] **Phase 4** — API smoke tests qua WebApplicationFactory ~7 test
-- [ ] **Phase 5** — FE Vitest cho lib utility (queryMatches, fmtMoney) ~10 test
-
-### E. 2-stage dept approval — Chunk E-bis ✅ DONE (Session 9)
-
-- [x] **FE Workflow Panel** PE — section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber khi chờ TPB confirm
-- [x] **FE UserManager toggle** `CanBypassReview` — column "Bypass" badge fuchsia + button toggle ShieldCheck (UsersPage)
-- [x] **HĐ 2-stage** mở rộng — `ContractWorkflowService` thêm UserManager DI + 2-stage logic mirror PE + `ContractDepartmentApprovalFeatures.cs` + endpoint `GET /contracts/{id}/department-approvals` + FE WorkflowHistoryPanel section mới
-- [x] **Budget 2-stage** mở rộng — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime + 2-stage logic + `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE BudgetWorkflowPanel section
-- [x] **Tests 2-stage** (6 test) — `IdentityFixture` setup full Identity stack + 6 test PE workflow service: NV review block / TPB confirm allow / NV bypass / Admin skip / Reject set / Resume jump-back. Pattern reusable.
-
-### F. Audit định kỳ (cron tự fire)
-
-- [x] **2026-05-01** (audit 2026-05-04 manual trigger sau trễ 4 ngày) — combined audit log `docs/changelog/skill-audit-2026-05.md`. Cron Claude SDK KHÔNG fit monthly cadence (auto-expire 7d) → user setup OS Task Scheduler nếu cần auto-remind.
-- [ ] **2026-06-01** — combined audit kế. Trigger thủ công khi đến ngày hoặc user nói "audit MD" / "kiểm tra docs" / "định kỳ kiểm tra".
-
-## ✅ Recently Done (newest on top)
-
-| Ngày | Ai | Task | Commit |
-|---|---|---|---|
-| 2026-05-15 | Claude | **🎯 SESSION 24 chốt cuối — Plan AA cumulative 7 commits (3 core + 4 polish UAT iteration)** — Plan AA Phase 1 core 3 commit (Chunk A BE+Layout + Chunk B FE matrix page + Chunk C Docs initial). Phase 2 polish 4 commit liên tục UAT feedback bro: `da218f1` hotfix px-6→px-2 (content sát sidebar) + `4d60598` redesign v1 panel-per-NV mirror admin Designer color coding (drop table symbol khó hiểu) + `fbbd361` redesign v2 HTML table rowSpan tận dụng full width (Bước/Cấp/NV/Quyền duyệt grid 2-col 7 label tiếng Việt nguyên văn) + `ee0902a` wrap fix sidebar label dài về đầu hàng (hanging-indent reverse CSS: flex→block + inline-block icon + inline text + absolute ChevronDown + text-[12px] leading-snug × 5 sites mirror 2 app). Patterns reusable saved: (1) Tailwind JIT palette array (5-color cycle Step + Cấp), (2) HTML table rowSpan flat row builder helper, (3) hanging-indent reverse CSS pattern. Multi-agent ROI: ~175K total (Investigator 32K Pre-A + Implementer 14K Chunk B + Reviewer 25K cumulative + CICD 12K Run #210 + 3 agent flush ~12K + em main ~80K) ≈ 28% solo equiv. **CICD Run #210 PASS 4/4 wire end-to-end**: IsUserSelectable filter live (admin no-filter / admin ghim / nv.test ghim all HTTP 200) + menu Pe_DuyetNcc_WfView present + Order shift idempotent 1-10 contiguous + non-admin permission Read OK + bundle hash rotate 2 app + Mig 31 unchanged. Pattern reinforced cumulative: gotcha #44 class-level Authorize relax PROVEN cross-stack reuse S18→S24 (Workflows endpoint từ admin-only sang any-auth read accessible). Test 111/111 PASS unchanged post-Plan AA (BE filter param + DbInitializer refactor no regression). Stats: 31 mig · 59 tables · **~146 endpoints (+1)** · **35 FE pages (+1 WorkflowMatrixViewPage)** · 111 test · 47 gotcha · 21 memory · 6 skills. **Implementer agent MEMORY ~31.5KB > 25KB threshold** → recommend curate next session archive S20-S22 old entries. | `ee776d5` (A BE+Layout) · `c667802` (B FE page) · `ac2c859` (C Docs init) · `da218f1` (px-2 hotfix) · `4d60598` (redesign v1 panel) · `fbbd361` (redesign v2 table rowSpan) · `ee0902a` (wrap fix label) · this Docs final |
-| 2026-05-15 | Claude | **🎯 SESSION 24 turn 1 — Plan AA User Workflow Matrix view + Sidebar widen revert Plan U truncate (3 commit)** — Bro UAT request: (1) sidebar Plan U S23 t11 truncate "..." → hiển thị đầy đủ label custom Mig 27, (2) thêm menu "Luồng duyệt" trên Danh sách hiển thị ma trận phân quyền workflow Designer ghim cho user xem (filter `IsUserSelectable=true` Mig 25). Q&A clarify 2 lượt: Q1 Permission strategy "Relax class-level [Authorize]" (đã fix gotcha #44 permanent từ S18 → CHỈ cần add filter param), Q2 Matrix layout "Table 2D full 7 Allow* cột". Plan 4 chunk: Pre-A (🟦 Investigator audit ~32K, confirm gotcha #44 + sidebar `w-72 xl:w-80` SAFE + Order strategy shift existing) + Chunk A (👤 Chủ trì Solo BE + Layout: MenuKeys `PurchaseEvaluationWorkflowView` helper + DbInitializer tree.Add LuongDuyet Order=2 + INSERT-OR-UPDATE-Order refactor idempotent + Permission seed 7 role + Handler `IsUserSelectable bool?` filter + Controller pass-through + sidebar `w-60 xl:w-72` → `w-72 xl:w-80` × 2 app mirror + revert Plan U truncate × 5 sites; commit `ee776d5` 6 files +73/-24) + Chunk B (🟨 Implementer Case 2 ~14K: WorkflowMatrixViewPage.tsx ~215 LOC + types/approvalWorkflowV2.ts ~55 LOC + App.tsx +route 2 LOC; commit `c667802` 3 files +305) + Chunk C (🟥 Reviewer cumulative ~25K: PASS 0 critical/major/minor blocker + Smart Friend guard active + fe-admin build verify bonus 1926 modules 740ms). Pattern reinforced: (1) gotcha #44 relax pattern PROVEN cross-stack reuse — Workflows endpoint từ admin-only sang any-auth read accessible. (2) DbInitializer INSERT-only → INSERT-OR-UPDATE-Order safe shift existing prod rows (idempotent re-deploy). (3) Plan U truncate revert pattern: widen sidebar + drop truncate, keep `min-w-0 flex-1` + `shrink-0` + `title` tooltip (no harm). **Surprise:** PE Workspace là **2-panel** không phải 3-panel — memory `feedback_responsive_laptop_breakpoint.md` stale claim → defer update memory. **3 commits push pending** (`ee776d5..<this>`). Stats: 31 mig · 59 tables · ~146 endpoints (+1 query filter param) · **35 FE pages (+1)** · 111 test (unchanged UAT mode) · 47 gotcha · 21 memory · 6 skills · 4 sub-agents (3 spawn S24 t1). | `ee776d5` (A BE+Layout) · `c667802` (B FE page) · (this Docs C) |
-| 2026-05-12 | Claude | **🎯 SESSION 21 turn 2 — RAG Hybrid setup planning + Cách A validation deep dive (2 commit `1f8e9af` plan save + this chốt)** — Sau S21 turn 1 chốt cicd-monitor, user clarify 5 dự án future > 1M MD tokens → cuộc thảo luận deep ~15 turn về RAG infrastructure. **Em main solo** (no SOLUTION_ERP sub-agent spawn), delegate **claude-code-guide × 2** spawn agent research Anthropic + community practice. **Q&A deep dive 10 topics**: (1) RAG fundamentals + Vector DB Qdrant role, (2) Embedding "AI nhúng" + Voyage AI cost mechanics ($0.18/M tokens), (3) Multi-project shared architecture (5 projects → single Qdrant + per-collection), (4) Audit procedure 3-tier (weekly auto + monthly deep + quarterly major), (5) UI/UX Streamlit dashboard 7 pages design (overview + drill-down + compare + audit + cost + change + admin), (6) Cách A defensive (giữ blanket 120K) vs Cách B aggressive (cắt 60-70%), (7) Reasoning depth comparison lazy 60% → A 90% → B 75-80%, (8) Industry validation Anthropic + Cursor + Continue + Cline + Aider all hybrid, (9) Multi-agent cost reality 8-10× multiplier ~520K cumulative blanket 5 entities, (10) 3-layer hybrid pattern Anthropic Contextual Retrieval Sept 2024. **Quyết định chốt Cách A** (defensive hybrid: giữ blanket 120K em main + RAG retrieve supplement, sub-agent spawn baseline ~100K each, 4 agents = ~400K cumulative, heavy session billed ~560K saving -20% vs lazy 700K, quality recall ~85%) over **Cách B bỏ** (aggressive cut 60-70% vi phạm priority em main control flow strong + reasoning fragmented + UX latency +1-2s/state Q + risk severe RAG fail). **Why Cách A** (bro priority chốt): em main control flow strong preserve, decision quality 90% multi-source cohesive, wall-clock -20% (12 phút vs 16), risk-averse graceful fallback, multi-agent leverage cache 70-90%, industry-validated 9 sources. **3-layer hybrid Phase rollout**: P1 (W1-4) vector only Voyage-3-large recall ~70% $1.50/mo · P2 (M2) +BM25 bm25s free recall ~78% $1.50/mo · P3 (M3) +Voyage rerank-2 + Contextual prefix recall ~92% $4-5/mo. **Stack validated** cross-industry: Voyage AI embedding (Anthropic partner, multilingual 26 lang, $0.36 initial), Qdrant local (Rust 50MB, agent-native 2026 leader, ~3GB disk 5 project), FastMCP Python (official SDK, ~100 LOC), SQLite event log (5 tables + audit history), Streamlit 7 pages. **Plan I NEW deferred** — trigger bro confirm 5 dự án path + stack + pilot + Voyage API key + disk cleanup → dedicated session 10-14h weekend (per `feedback_drastic_refactor_scope` rule). **Deliverables**: `docs/rag-setup-plan.md` 1223 LOC commit `1f8e9af` + extend S21 t2 ~300 LOC = ~1500 LOC final, memory `feedback_rag_hybrid_pattern.md` cross-project reusable, session log this chốt, MEMORY.md index +1 entry. **CI skipped** path filter (`.md`). **4 sub-agents vẫn seeds-only** (KHÔNG spawn S21 turn 2 nên KHÔNG flush MEMORY.md per §6.5 KHÔNG add noise). Tests baseline 81 unchanged. | `1f8e9af` (plan save) · this chốt (commit final) |
-| 2026-05-12 | Claude | **🎯 SESSION 21 turn 1 — Add con thứ 4 cicd-monitor (Path A — post-deploy verifier green READ tier, 1 commit `f1c61c9`)** — User chốt Path A sau pre-flight Plan G Trial Week 1: thêm sub-agent thứ 4 chuyên post-deploy verify (Gitea Actions poll + bundle hash 2 app verify + sqlcmd mig prod = repo latest + endpoint smoke). Trade-off: +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động — recurring blind spot pattern em main solo S20 quên verify ~30% push. **2 file mới**: `.claude/agents/cicd-monitor.md` (~7KB) — system prompt + 8-step workflow (verify push → poll Gitea API → fail log grep → live curl smoke → bundle hash × 2 app + verify changed → sqlcmd mig prod = repo latest → report PASS/FAIL/PARTIAL/TIMEOUT/SKIPPED-DOCS) + 5-stage report table + gotcha #25/#39/#40/#41/#44 cross-ref + skill `iis-deploy-runbook`/`dependency-audit-erp`/`ef-core-migration` preload + Anti-pattern 9 rules. `.claude/agent-memory/cicd-monitor/MEMORY.md` (~5KB seed) — recurring CI bug patterns + 5-stage checklist + baseline build/bundle metrics + bearer test pattern admin/nv.test. **1 file update repo**: `.claude/agents/README.md` — 4-agent architecture diagram (green slot mới) + decision tree (after push code + prod issue diagnose branches) + memory routine 4 SendMessage + skills preload 4 agents + cost reality table 564K → 750K spawn / 1.2M → 1.35M heavy / 600K → 700K optimized + trial workflow Week 1-3 CI/CD Monitor spawn integrated + pass criteria + catch ≥1 deploy ship fail. **Memory user-level update**: `feedback_multi_agent_setup.md` — title 3 → 4 sub-agents, decision tree +CI/CD Monitor invocation branches (after push + user prod issue), skills preload list +CI/CD Monitor (iis-deploy-runbook + dependency-audit-erp + ef-core-migration), cost table update + trade-off rationale (recurring blind spot ~30% push S20). **CI skipped**: all 3 file changed `.md` → match `paths-ignore: '**/*.md'` per gotcha #41 → no Gitea Actions run → no IIS deploy (expected — agent infra là local Claude Code, không cần present trên prod). Push success `36e21c8..f1c61c9 main -> main`. **3 (now 4) sub-agents vẫn seeds-only**: chưa spawn work nào — em main solo via context paste + Write file. KHÔNG flush 3 agent MEMORY.md (chưa spawn work = không findings, per §6.5 KHÔNG add noise entry). cicd-monitor MEMORY.md có entry "setup 2026-05-12" trong seed. Trial Week 1 kick-off ở Session 21 turn 2+ với Plan B Contract V2 wire Mig 28+29 candidate (mirror PE pattern S17-S19 proven 1×). Tests baseline 81 unchanged (no test added — docs-only commit). | `f1c61c9` (Setup cicd-monitor + README 4-agent + memory update) |
-| 2026-05-11 | Claude | **🎯 SESSION 20 turns 6 + 8-12 — PE polish (NCC palette + autofill + responsive) + Multi-agent setup (7 commit `f568945` → `ae1814c`)** — Sau turn 7 wrap-up Mig 27, user iterate 7 polish/feature lớn nhỏ. **Turn 6 (`f568945`)** Manual budget "Nhập tay" drop tên field — 3 file × 2 app mirror (BudgetFieldRow + WorkspaceCreateView + HeaderForm) bỏ Input "Tên" UI khỏi manual mode, BE save `budgetManualName: null` luôn, VND format `1.000.000` + suffix đ. **Turn 8 (`3ec7b5a`)** AddSupplier +Số tiền inline + NCC 5-màu palette + Winner badge "🏆 Trúng thầu" — AddSupplierDialog +prop detailId? +form thanhTien, sequential POST /suppliers (response {id}) → POST /quotes (nếu detailId + thanhTien > 0). NCC_PALETTES const 5 màu literal Tailwind (blue/purple/sky/teal/pink) cycle theo idx. Winner row override emerald-500 border-l + bg-emerald-100/70 + shadow-sm + ring-1 emerald-300 + badge rounded-full bg-emerald-600 text-white "🏆 Trúng thầu". **Turn 9 (`83aae8e`)** User feedback bỏ badge → revert icon ✓ stick cũ nhưng đậm hơn (text-base font-bold emerald-700) + tên NCC winner text-emerald-900 + hover transition (winner hover:bg-emerald-200/70, non-winner hover:bg-white/80 hover:shadow-sm). **Turn 10 (`66551db`)** AddSupplierDialog auto-fill từ master data khi chọn NCC dropdown — onChange lookup picked supplier, setForm ghi đè 4 field (contactName ← contactPerson / contactPhone ← phone / contactEmail ← email / note ← note). Hint emerald "✓ Đã tự điền từ Master". User vẫn override được. **Turn 11 (`6e338f7`)** Responsive cho laptop màn hình nhỏ 1280-1366px — 4-tầng pattern: sidebar fe-admin + fe-user `w-72` → `w-60 xl:w-72` (+48px lg) / PE Workspace 2-panel `lg:[320px_1fr]` → `lg:[260px_1fr] xl:[320px_1fr]` (+60px lg) / Section padding `px-5 py-4` → `px-3 py-3 sm:px-5 sm:py-4` (+16px xs) / HangMucCard `gap-3 p-3` → `flex-wrap gap-2 p-2 sm:gap-3 sm:p-3` (+8px xs). Net gain trên 1366px ~+132px width cho NCC table area. Memory `feedback_responsive_laptop_breakpoint.md` capture pattern. **Turn 12 (`ae1814c`)** SETUP MULTI-AGENT INFRASTRUCTURE 3 sub-agents (Investigator READ cyan + Implementer WRITE conditional yellow + Reviewer READ adversarial red) + em main coordinator. Pre-flight decision gate 6/6 ✅. Phase 1-4 execute: `.claude/agents/` 4 file (README ~9.7KB + investigator + implementer + reviewer) + `.claude/agent-memory/` 3 MEMORY.md seed (~6KB each). Customize SOLUTION_ERP: skills preload mỗi agent (reuse 6 skills hiện có) + bearer test (admin@solutions / nv.test@solutions) + prod UAT URL + Phase 9 UAT mode + DB Dev/Design distinct. Windows MAX_PATH pitfall handled — drop `isolation: worktree` khỏi implementer.md (project path 51 chars + Dropbox-managed nested overflow 260+ chars). Memory `feedback_multi_agent_setup.md` capture decision gate + ACCEPT/REFUSE criteria + NAMGROUP s41-s43 ROI reference. 3 agents **chưa spawn work** ở S20 turn 12 — seeds-only state. Trial Week 1 candidate Contract V2 wire Mig 28+29 (mirror PE pattern proven). **Stats cumulative S20:** 27 mig (+1 Mig 27 from turn 7) · 59 tables · ~142 endpoints (+1 PATCH /menus/{key}) · 34 FE pages (+1 MenuVisibilityPage) · ~61 menu key (+1) · 81 test pass unchanged · 44 gotcha unchanged · **16 memory entries (+2: responsive + multi-agent)** · 6 skills unchanged · **3 sub-agents NEW** · 14 commits S20. | `f568945` (t6) · `3ec7b5a` (t8) · `83aae8e` (t9) · `66551db` (t10) · `6e338f7` (t11) · `ae1814c` (t12) · (current Docs t13 wrap) |
-| 2026-05-11 | Claude | **🎯 SESSION 20 turn 7 — Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27, 5 chunk `2ea2d27`→`ef394f8`→`059bfcb`→`1ed6530`→Chunk E Docs)** — User UAT yêu cầu "tính năng Ẩn Hiện và Đổi tên hiển thị của các Menu bên ngoài Office, làm trong Trang Admin Page". Hỏi xác nhận "chưa có" — đúng. User clarify Q2=b "edit hiển thị bên ngoài, chỉ của eOffice thôi" → admin sidebar luôn giữ Label gốc, DisplayLabel CHỈ áp fe-user. Q1=a global (không per-role), Q3=a giữ USER_HIDDEN_KEYS hardcode + tầng IsVisible dynamic combine, Q4 UAT skip test. **Chunk A** Domain MenuItem +IsVisible bool=true +DisplayLabel string?(200) + EF config + Migration 27 AddVisibilityAndDisplayLabelToMenuItems (2 AddColumn) — 3-file rule, apply LocalDB _Dev + _Design OK. **Chunk B** BE API: MenuNodeDto + MenuItemDto +isVisible +displayLabel (sau CRUD flags trước Children). GetMyMenuTreeQueryHandler pass through, KHÔNG filter server-side — 2 FE app tự quyết. UpdateMenuItemCommand + Validator + Handler (trim DisplayLabel whitespace → null). MenusController +PATCH /api/menus/{key} [Authorize Policy=Permissions.Update] body {isVisible, displayLabel}. **Chunk C** Domain MenuKeys +MenuVisibility const + All[] + DbInitializer +leaf "Menu eOffice" Icon=Eye Order=94 (Workflows shift 94→95). Manual seed Mig 27 LocalDB _Dev (INSERT MenuItems + Permissions Admin). FE Admin: types/menu.ts +isVisible +displayLabel, lib/menuKeys.ts +MenuVisibility, Layout resolver +/system/menu-visibility, App.tsx +Route. NEW pages/system/MenuVisibilityPage.tsx ~210 LOC: PageHeader + 4 StatCard (Tổng/Hiển thị/Đã ẩn/Đã đổi tên) + Search + Table 5 cột (Key mono + parentKey ↳ / Tên gốc / Input "Tên hiển thị" inline placeholder "Mặc định: {label}" / Toggle button emerald-Eye / amber-EyeOff / Lưu khi dirty + Khôi phục khi custom). PATCH endpoint, invalidate ['menus','all'] + ['my-menu'] trigger live update sidebar. Row hidden bg-amber-50/40 highlight, custom label bg-brand-50/40. **Chunk D** fe-user types/menu.ts mirror. Layout.tsx filterForUser 2 tầng (USER_HIDDEN_KEYS structural + !isVisible dynamic). Helper effectiveLabel(n) = displayLabel?.trim() || label. Replace 3 callsite {node.label} → {effectiveLabel(node)}. USER_FIXED_TOP "__inbox" entry +isVisible:true cho type check pass. **fe-admin Layout KHÔNG đụng** — admin sidebar render Label gốc + show hết menu (user Q2=b). **Chunk E Docs (current)**. **Stats Session 20 turn 7**: 26→27 mig, 59 DB tables (no change), ~141→142 endpoints, 33→34 FE pages, ~60→61 menu key, 81 test pass (Q4 UAT defer), 44 gotcha (no new). Memory entries 14 (no new). | `2ea2d27` (A Mig 27) · `ef394f8` (B BE API) · `059bfcb` (C FE admin) · `1ed6530` (D FE user) · (current E Docs) |
-| 2026-05-11 | Claude | **🎯 SESSION 20 — PE Detail UI restructure 3 yêu cầu UX (4 chunk: 9dee00d→2bba851→f2f01f4→Chunk D Docs)** — User UAT live phản hồi "Logic OK rồi, điều chỉnh UI Duyệt NCC 1 tý": (1) Hạng mục lên trên + auto-tạo 1 row từ gói thầu, (2) NCC expand dưới hạng mục, (3) Section Ý kiến gộp đồng cấp cùng Phòng. Q&A clarify trước code (4 câu Q1=a/Q2=a "1 hạng mục"/Q3=a "chỉ hiện signed"/Q4 "public luôn demo thôi"). 4 chunk per-commit pattern `feedback_per_chunk_commit`. **Chunk A** BE `CreatePurchaseEvaluationCommandHandler` + INSERT 1 PurchaseEvaluationDetail mặc định + Changelog (GroupCode=01, NoiDung=TenGoiThau, ThanhTienNganSach=Budget.TongNganSach hoặc BudgetManualAmount fallback 0) + FE reorder PeDetailTabs section. **Chunk B** ItemsTab restructure list HangMucCard (1 card / hạng mục, expanded=true default cho demo 1 hạng mục). Header: GroupCode + NoiDung + 3 stat (KL/ĐG/TT) + NS link Δ + Pencil/Trash + ▼/▶ toggle. Expand body: NCC inline table 8 cột (NCC/Liên hệ/Điều khoản TT/File báo giá/ĐG chưa VAT/ĐG có VAT/Thành tiền/Action). Click cell quote → QuoteDialog reuse. Add NCC/Edit NCC reuse 2 dialog cũ. Winner ✓ button per row. Bỏ Section 4 "NCC tham gia" (gộp vào Section 2 nested) → 4 section final. Drop SuppliersTab function ~134 LOC dead code (replace bằng HangMucCard expand). Giữ AddSupplierDialog + EditSupplierDialog + SupplierAttachmentsCell (HangMucCard reuse). **Chunk C** Section Ý kiến gộp đồng cấp cùng Phòng. LevelOpinionsSectionV2 forEach step → 1 `StepOpinionsBox` (replace grid-cols-2 N approvers). Header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter. Body: filter opinions theo step.order → sort levelOrder asc + signedAt asc → render `StepOpinionEntry` per signed (tên NV + Cấp badge slate + admin override amber + timestamp emerald rounded-full + comment). NV chưa duyệt KHÔNG hiển thị (Q3=a). KHÔNG đụng Mig 26 schema (vẫn UPSERT 1 row / Level qua Service). Drop LevelOpinionBox function. Mirror fe-admin + fe-user mỗi chunk. **Verify**: dotnet build pass (Chunk A) + npm build × 2 app pass (Chunk B/C — catch TS6133 SuppliersTab unused + SupplierAttachmentsCell unused, fix re-add cột File báo giá vào nested table). **Test skip** Phase 9 UAT iteration (81 test pass unchanged). **Stats unchanged**: 26 mig, 59 DB tables, ~141 endpoint, 33 FE pages, 44 gotcha, 81 test. **Pending S21+**: Test regression B4 silent 403 (HIGH §7), Test V2 Service wire ApproveV2Async + Section gộp (Chunk C), Test Mig 25 PATCH user-selectable, Contract V2 (Mig 27/28 mirror PE), phân quyền strict V2, drop legacy V1 cleanup. | `9dee00d` (A) · `2bba851` (B) · `f2f01f4` (C) · (current D Docs) |
-| 2026-05-09 | Claude | **🎯 SESSION 19 — PE Section 5 V2 dynamic theo ApprovalWorkflowLevel + Mig 26 (4 commit: 873e7a1 polish 3 button + 77a3058/90baa8e/6e913b3/Chunk D Mig 26)** — User feedback Section 5 hiện CỨNG 4 box (PheDuyet/CCM/MuaHàng/SmPm Mig 15 từ Phase 8) → cần động theo Workflow V2 đã pin: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox với ý kiến + tên người ý kiến. Bước 1 Phòng A có 2 NV → 2 box ngang hàng. **5 câu chốt spec trước code:** Q1=1B (gắn — Service auto sync khi duyệt, KHÔNG form input rời), Q2=2A+Admin (NV chính chủ + Admin override với SignedByUserId track actual signer), Q3=chuyển V2 hết (phiếu V1 legacy fallback Mig 15 4 box readOnly), Q4=4C+bonus (Phase=DaDuyet/TuChoi khoá; Admin có quyền duyệt thay; comment empty → "(duyệt — không ý kiến)" placeholder), Q5=5A (layout group Step header "Bước N — Phòng X" + grid-cols-2 cho N approvers). **3 chunk per-commit (memory `feedback_per_chunk_commit`):** Chunk A (`77a3058`) Domain entity `PurchaseEvaluationLevelOpinion : AuditableEntity` (PEId+LevelId UNIQUE composite, Comment nvarchar(2000), SignedAt datetime2, SignedByUserId Guid, SignedByFullName nvarchar(200) denorm) + EF config FK Cascade Pe + Restrict Level + ApplicationDbContext + IApplicationDbContext DbSet + **Migration 26** `AddPeLevelOpinionsForV2` (1 CREATE TABLE + 2 FK + 2 index — UNIQUE composite + IX LevelId). 3-file rule. Apply LocalDB SolutionErp_Dev OK. Chunk B (`90baa8e`) Service `PurchaseEvaluationWorkflowService.ApproveV2Async` sau line log approval → UPSERT row PurchaseEvaluationLevelOpinions cho Cấp hiện tại: match level theo `ApproverUserId == actorUserId` (multi-NV cùng Cấp OR-of-N), fallback first khi Admin override (FE detect SignedByUserId !== Level.ApproverUserId hiển thị "Admin duyệt thay"). Reject KHÔNG sync. Empty/whitespace comment → "(duyệt — không ý kiến)" placeholder. Helper `ResolveActorFullNameAsync(actorUserId, isSystem)` lookup denorm SignedByFullName từ Users (fallback "(System)" / "(unknown)"). DTO `PurchaseEvaluationLevelOpinionDto` 15 fields (LevelId/StepOrder/StepName/StepDepartmentId/StepDepartmentName/LevelOrder/LevelName/ApproverUserId/ApproverFullName/Comment/SignedAt/SignedByUserId/SignedByFullName). GET handler `GetPurchaseEvaluationQueryHandler` Include LevelOpinions + helper `BuildLevelOpinionsAsync` JOIN ApprovalWorkflows.Steps.Levels + Departments + Users → denorm DTO list. Empty list cho phiếu V1 / V2 chưa có cấp duyệt → FE fallback. Chunk C (`6e913b3`) FE Section 5 V2 dynamic: type `PeLevelOpinion` + `PeDetailBundle.levelOpinions[]`. Section 5 conditional: `evaluation.approvalWorkflowId` set → `<LevelOpinionsSectionV2/>` (V2 dynamic), else `<DepartmentOpinionsSection/>` readOnly fallback (V1 legacy giữ Mig 15 4 box). Component `LevelOpinionsSectionV2` group theo step.order: header "Bước N — <name>" + dept badge emerald + hint "(N người duyệt)" khi totalApprovers > 1; body grid-cols-2 cho `step.levels.flatMap(level => level.approvers.map(approver => <LevelOpinionBox/>))`; lookup opinion theo (stepOrder, levelOrder, approverUserId). `LevelOpinionBox` read-only: title "Cấp N — <ApproverFullName>", badge amber "⚠ Admin <name> duyệt thay" khi override, badge emerald "✓ Đã duyệt", empty "— chưa duyệt" italic gray, footer timestamp signedAt format vi-VN. Workspace mode hint giữ amber "Ý kiến + chữ ký auto đồng bộ khi NV duyệt". Mirror fe-admin + fe-user (rule §3.9). Verify: dotnet build pass + dotnet test 81 pass + npm run build × 2 pass · 0 TS error. Chunk D docs (current) STATUS/HANDOFF/migration-todos/CLAUDE.md/schema-diagram §16 mới + session log. Phiếu V1 cũ KHÔNG migrate (giữ Mig 15 readOnly), drop sau UAT confirm. **Stats:** 26 mig (+1), 59 DB tables (+1), ~141 endpoints (no new), 33 FE pages, 81 test pass. Polish 3 button (873e7a1) Hành động đầu Session 19: rút gọn label "✓ Duyệt / ← Trả lại / ✗ Từ chối" + 3 màu khác nhau (emerald/amber/red) + font-bold cho cả 2 app. | `873e7a1` (3 button) · `77a3058` (Chunk A Mig 26) · `90baa8e` (Chunk B Service+DTO+GET) · `6e913b3` (Chunk C FE) · (current Chunk D Docs) |
-| 2026-05-08 19:45 | Claude | **🎯 SESSION 18 WRAP-UP — PE V2 polish + Clone B (DuyetNccPhuongAn) + 4 bug fix UAT + Mig 25 IsUserSelectable (7 commit `aaa1c6c` → `32a8d4d`)** — User UAT live tiếp Session 17, request chuỗi polish nhỏ + clone V2 cho type B. Áp memory `feedback_uat_skip_verify` (skip dotnet test mỗi chunk, push ngay) + lesson rename/remove → bắt buộc `npm run build`. **B1 (`aaa1c6c`)** Pe Duyệt (`?pendingMe=1`): bỏ dropdown "Tất cả trạng thái" + filter cứng client-side `getPeDisplayStatus === DaGuiDuyet` (loại Nháp/Trả lại/Đã duyệt/Từ chối). Hint amber "Lọc cố định: Đã gửi duyệt". Header count dùng `rows.length` (inbox không paged). Workaround BE /inbox loose UAT trả phiếu Nháp. Mirror fe-admin + fe-user. **B2 (`917446d`)** PeDetailTabs HistoryTab filter chỉ events Trả lại/Gửi duyệt lại: workflow transition về TraLai (phaseAtChange=98) + transition từ TraLai (summary chứa "TraLai →") + sửa nội dung khi phaseAtChange=TraLai. BE giữ audit data đầy đủ, chỉ FE filter (reversible). Empty state "Chưa có lịch sử trả lại / gửi duyệt lại". Mirror cả 2 app. **B3 (`937eb24`) Clone V2 cho B (DuyetNccPhuongAn)** — User chốt "Quy trình chọn thầu phụ - NCC → Duyệt NCC đúng. Clone toàn bộ updates sang Duyệt NCC và Giải pháp". Audit phát hiện 80% chung qua `ApplicableType` discriminator → chỉ thêm 3 file ~60 LOC: (a) `MenuKeys.cs` +const `ApprovalWorkflowDuyetNccPhuongAnV2` + add vào `All[]`. (b) `DbInitializer.SeedMenusAsync` +leaf "Duyệt NCC và Giải pháp (Mới)" dưới root ApprovalWorkflowsV2 + new method `SeedSampleApprovalWorkflowsV2Async` seed `QT-DN-PA-V2-001 v01` (1 Bước Phòng CCM × 1 Cấp NV test, idempotent). (c) `fe-admin/lib/menuKeys.ts` +`AwV2_DuyetNccPhuongAn`. KHÔNG migration / Service / Designer page (Layout regex `^AwV2_(.+)$` đã match dynamic, ApprovalWorkflowsV2Page có `TYPE_CODE_TO_INT` cả 3 type). Rút memory `feedback_audit_reuse_before_clone.md`. **B4 (`f77ea38`) Fix permission silent 403** — Drafter `nv.test` Workspace dropdown empty mặc dù seed OK. Root: class-level `[Authorize(Policy = "Workflows.Read")]` → non-admin 403, TanStack Query catch silent → UI empty không warning. Fix: class-level `[Authorize]` only (any authenticated). GET = list workflow read-only không nhạy cảm; POST + DELETE giữ `Workflows.Create` admin-only. Pattern reusable cho Contract V2 sau. **B5 (`a9c0857`) Fix sidebar highlight queryMatches** — Click phiếu trong leaf "Danh sách" → URL `?type=1&id=abc` → menu mất highlight (gotcha #34 cũ tái phát). Root: queryMatches exact-set equality {type} vs {type, id} length mismatch. Fix: `TRANSIENT_QUERY_KEYS = {id, q, editHeader, page, phase, awId}` strip trước compare. Edge case verified: Danh sách `?type=1` vs Pending `?type=1&pendingMe=1` distinct (không cross-highlight). Mirror cả 2 app Layout.tsx. **B6 (`2a53107`) Mig 25 + Designer pin toggle + bỏ "(clone)" + Workspace filter** — User feedback Admin Designer: bỏ "(clone)" auto-suffix khi clone version (version đã đủ phân biệt) + thêm pin toggle "Cho user pick lúc create phiếu" (multi-select, độc lập IsActive). Migration 25 `AddIsUserSelectableToApprovalWorkflows`: ALTER ApprovalWorkflows +`IsUserSelectable bit NOT NULL DEFAULT 0` + Sql backfill `UPDATE WHERE IsActive=1 SET 1` (giữ behavior cũ active workflow vẫn pickable). Domain ApprovalWorkflow +property. DTO AwDefinitionDto +field. CreateAwDefinitionCommand set default `true` cho version mới (mirror IsActive). New `SetAwUserSelectableCommand` + Handler. API `PATCH /api/approval-workflows-v2/{id}/user-selectable` policy `Workflows.Create`. DbInitializer SeedSampleApprovalWorkflowsV2Async +`IsUserSelectable=true`. FE Designer: `DefinitionDto` +field; badge amber "📌 Cho user chọn"; button "Ghim cho user / Bỏ ghim" + mutation `toggleSelectable`. Designer `name = cloneFrom.name` (bỏ ` (clone)` suffix). Workspace fetch filter `w.isUserSelectable === true` (cả fe-admin + fe-user). **B7 (`32a8d4d`)** Cleanup orphan `.claude.zip + docs.zip` từ harness session start, +`*.zip` rule .gitignore. **Cumulative Session 18:** 25 mig (+1), 58 tables (no new), ~141 endpoints (+1), 33 FE pages, **81 test pass** (no change — feature mới UAT defer test theo §7), 44 gotcha (+1 silent 403). Memory +1 entry. **Pending Session 19+:** Contract V2 wire (Mig 26 mirror PE), phân quyền strict V2, drop legacy V1 cleanup. | `aaa1c6c` (B1) · `917446d` (B2) · `937eb24` (B3) · `f77ea38` (B4) · `a9c0857` (B5) · `2a53107` (B6) · `32a8d4d` (B7) |
-| 2026-05-08 | Claude | **🎯 SESSION 17 WRAP-UP — PE Workflow V2 schema + Service wire end-to-end (13 commit `c847dc0` → `de0f38d`)** — User chốt sau Session 16 "Thấy vẫn không đúng" → viết lại schema riêng + thêm Menu "Duyệt NCC (Mới)" UAT. Cấu trúc rõ ràng: Quy trình > Bước (Phòng) > Cấp (NV cụ thể qua ApproverUserId). 3 chunk lớn: **Schema design + Designer** (Mig 22 — `c847dc0/f6047d5/2781c7e/12daa7f`): 3 entity ApprovalWorkflow/Step/Level + enum ApplicableType (DuyetNcc/DuyetNccPhuongAn/Contract). Designer page `/system/approval-workflows-v2/:typeCode` — iter 1 lock 3 cấp (`9712778`, sai intent) → iter 2 đúng intent max 3 cấp × N NV/cấp + sequential gating C2/C3 disabled khi cấp trước empty + filter NV theo Phòng + no-dup same level (`f3bea3c`). Validator BE Order∈{1,2,3} + HaveSequentialOrders + HaveNoDuplicateApproverInSameLevel. **State machine 5 trạng thái** (`ff21120`): Nháp→Đã gửi duyệt→Đã duyệt (terminal) | Trả lại (Phase riêng TraLai=98, KHÔNG revert DangSoanThao + KHÔNG jump-back) | Từ chối (terminal). Drafter từ TraLai sửa+gửi lại chạy LẠI từ Cấp 1 Bước 1 (Option A user chốt diagram). PE/Contract/Budget Phase enum +TraLai=98 + Policy + Service Reject branch trỏ → TraLai + bỏ smart-reject (RejectedAtStepIndex giữ DB column deprecated). 4 test mới TraLai entry point. **Pin V2 vào PE + Service wire** (Mig 23-24 — `0a40c65/b41484b`): PE.ApprovalWorkflowId Guid? + PE.CurrentApprovalLevelOrder int? + EF FK Restrict. CreatePurchaseEvaluationCommand+Validate ApplicableType match PE.Type. UpdateDraft cho phép sửa Phase=Nháp/TraLai. Workspace Select bắt buộc (filter ApplicableType=type). Service `ApproveV2Async` + `ApproveV1LegacyAsync` branch theo ApprovalWorkflowId set or null: V2 group Levels by Order = Cấp (OR-of-N approvers cùng cấp), match `actor.Id ∈ ApproverUserId`, advance levelOrder++ trong Step → idx++ + reset levelOrder=1 → DaDuyet. Synthetic Policy `ForV2Schema()` cho FE nextPhases (DangSoanThao/TraLai → ChoDuyet/TuChoi; ChoDuyet → ChoDuyet/TraLai/TuChoi). **UX V2-aware** (`d814429/9e63e2d/d250ae4/74745a7/de0f38d`): DTO `CurrentApproval { stepIdx, levelOrder, approvers[] }` + `ApprovalFlow { steps[]: { Order, Name, Dept, Levels[]: { Order, Approvers[], Status:Done/Current/Pending } } }`. Banner emerald "Đến lượt bạn" / amber "Không phải lượt bạn — chỉ {NV X / Y} duyệt được". Button Duyệt forward disabled khi V2 + actor không trong cấp + tooltip. Trả lại + Từ chối vẫn enabled (BE không gating reject theo cấp). Inbox V2-aware (`ResolveV2InboxIdsAsync` precompute Set IDs khớp actor.Id ∈ Cấp hiện tại). 2 dropdown filter "Quy trình duyệt" + "Trạng thái" (chỉ ở Duyệt sau user feedback, Danh sách giữ 1 dropdown trạng thái). Panel 3 thay 4 phase cards bằng flow workflow thực tế: Bước (icon ✓/●/○ + dept badge) → Cấp (icon nhỏ + label "đang chờ" / "đã duyệt" + tên NV). Phiếu V1 legacy fallback note. **Test setup** (`ac41d5e`): SQL `clean-transactional-uat.sql` xóa 9 PE + 11 HĐ + Budget + 19 Notif + reset CodeSequences trên prod, giữ master (Users/Suppliers/Projects/Departments/Workflows V1+V2). Tạo test user `nv.test@solutions.com.vn`/`TestUser@123456` (Drafter, Phòng CCM) qua API. **77→81 test pass** (+4 TraLai entry point Domain). FE rename "Bản nháp" → "Nháp" + ChoDuyet=10 + TraLai=98 thêm vào types/contracts.ts + types/budget.ts. **Pending session sau:** Contract V2 wire (mirror PE pattern), Budget V2 (defer xa hơn), phân quyền strict V2 (hiện loose UAT cho mọi authenticated user xem phiếu V2), drop legacy V1 sau khi UAT chốt + cleanup migration drop RejectedAtStepIndex/RejectedFromPhase. | 13 commit (xem `git log --since='2026-05-08'`) |
-| 2026-05-08 | Claude | **🎯 SESSION 16 — DRASTIC REFACTOR flat workflow Phòng × Cấp (Mig 21, 2 commit Chunk A+B)** — Resume từ Session 15 defer plan. User chốt "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking". Per memory `feedback_drastic_refactor_scope`: dedicated session với context fresh, scope conservative 2x buffer (~8-10h estimate, actual ~3h). **Chunk A (`dbb0089`)** — Domain enum simplify (DangSoanThao=1, ChoDuyet=10 NEW, DaDuyet=7, TuChoi=99; legacy 2-6 + 98 deprecated giữ cho data cũ). WorkflowStep + DepartmentId Guid? FK Restrict + PositionLevel int? (PE + Contract mirror). PE/Contract entity + CurrentWorkflowStepIndex int? + RejectedAtStepIndex int?. Drop class WorkflowStepInnerStep + nav (PE + Contract). Drop *DepartmentApproval.InnerStepId column. EF Configurations: drop InnerStep config + restore simple unique non-filtered (Mig 19/20 filtered split reverse). DbContext drop DbSet<*WorkflowStepInnerStep> × 2. **Migration 21** `RefactorWorkflowToFlatModel` GỘP: 4 ALTER cols (PE/Contract CurrentStepIndex+RejectedAtStepIndex) + 2 ALTER (WorkflowStep DeptId+PositionLevel) + DROP TABLE x 2 (PEWorkflowStepInnerSteps + WorkflowStepInnerSteps Mig 18+20) + DROP InnerStepId column x 2 (PE+Contract DeptApproval) + DROP filtered indexes x 2 + restore simple unique x 2. PE + Contract Service rewrite TransitionAsync: phase transitions DangSoanThao→ChoDuyet (Drafter trình init idx=0) / ChoDuyet→ChoDuyet (advance idx) / ChoDuyet→DaDuyet/DaPhatHanh (last step done) / ChoDuyet→DangSoanThao (Trả lại save RejectedAtStepIndex) / ChoDuyet→TuChoi (Từ chối khoá vĩnh viễn). Match approver: actor.Dept==step.Dept AND actor.PositionLevel>=step.PositionLevel (OR cùng cấp/dept) OR Approvers.Kind=User match OR Kind=Role match. Admin role bypass policy. Last step done → gen mã HĐ (Contract only). App CQRS WorkflowStepDto + WorkflowStepInput drop InnerStep, add DepartmentId/DepartmentName/PositionLevel (PE + Contract mirror). Tests rewrite: DROP `PeNStageApprovalTests.cs` (6) + `ContractNStageApprovalTests.cs` (6) + `PeTwoStageApprovalTests.cs` (7) — legacy N-stage/2-stage no longer applicable. UPDATE `PeWorkflowAdminTests` signature. **96 → 77 test pass** (-19 legacy). 3-file rule Mig 21 (.cs + Designer + Snapshot) commit đủ. **Chunk B (`88a5be1`)** — FE-Admin Designer rewrite (PeWorkflowsPage + WorkflowsPage): drop InnerStepDto + EditInnerStep types, drop PHASE_OPTIONS auto-assign ChoDuyet=10, StepDto + EditStep + departmentId/positionLevel, copyFromDefinition simplified, Designer step UI rewrite (Tên + Phòng Select + Cấp Select + SLA + Approvers Role/User optional fallback, drop entire InnerSteps sub-section), DefinitionCard view hiển thị badge Phòng emerald + Cấp NV/PP/TP violet, save payload phase=10. types/purchaseEvaluation.ts (fe-admin + fe-user mirror) + ChoDuyet=10 enum + label "Đang duyệt" + color amber. **Chunk C (FE PeWorkflowPanel) SKIP** — existing UI compatible (workflow.nextPhases driven by BE simplified policy), reuse 3-button Trả lại/Từ chối logic Session 14 hoạt động trên ChoDuyet phase tự động. **KHÔNG đụng** Service Notify pattern + Changelog pattern (giữ hành vi Mig 16). Verify: dotnet build pass + Mig 21 LocalDB applied + 77 test pass + npm build × 2 pass. Memory `feedback_drastic_refactor_scope.md` validated: dedicated session approach hoạt động đúng dự đoán. | `dbb0089` (A) · `88a5be1` (B) |
-| 2026-05-07 | Claude | **🎯 SESSION 15 — Tooltip diagnose "Lưu & Gửi Duyệt" + Plan drastic refactor flat workflow → DEFER** — User UAT live screenshot phiếu PE Bản nháp + báo "Lưu & Gửi Duyệt" KHÔNG hoạt động + suy đoán "trùng ID với phiếu khác". Chẩn đoán: button silent disabled khi `evaluation.workflow.nextPhases` không có forward phase (chỉ TuChoi/TraLai). FE chưa có visual feedback → user không biết. Improvement (commit `835cc7f`): compute `forwardPhase` once + add `submitDisabledReason` string giải thích reason (canEditPhase=false / readOnly / !forwardPhase với hint admin kiểm tra cấu hình quy trình) + button title attribute show reason hover hoặc forward phase label khi enabled + Dialog confirm show forward phase explicit "Sẽ chuyển sang Chờ Purchasing". Mirror fe-admin + fe-user. Build pass cả 2. **"Trùng ID" KHÔNG phải bug FE** — `PurchaseEvaluationWorkspacePage` URL state đúng (`+ Thêm mới` clear `id`, save set new), mỗi PE row unique GUID + MaPhieu. **Tiếp theo plan drastic refactor**: User chốt "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking" + workflow flat list (Phòng × Cấp × Users[]) thay InnerStep model. Surface 6 chunk plan + start Chunk A: edit Domain entities (Phase enum +ChoDuyet=10, WorkflowStep +DeptId/PositionLevel, drop InnerStep class+nav, PE/Contract +CurrentWorkflowStepIndex/RejectedAtStepIndex, *DeptApproval drop InnerStepId) + EF Configurations (drop InnerStep config + nav, restore simple unique non-filtered) + DbContext drop DbSets — 12 files trong working tree. Realize scope realistic ~8-10h (PolicyRegistry rewrite + 2 Service rewrite + App CQRS + 12 tests rewrite + Designer FE + Migration 21 + Docs) vượt session boundary + risk session context deep ~30 commits. **REVERT working tree** về `835cc7f` clean. Add memory `feedback_drastic_refactor_scope` decision rule: drastic refactor cần dedicated session, ước tính conservative (2x buffer), tránh mid-session big refactor. **Stats unchanged**: 96 test pass, 20 mig, 57 bảng. | `835cc7f` |
-| 2026-05-07 | Claude | **🎯 SESSION 14 — PE 3-button workflow Duyệt/Trả lại/Từ chối + Task 2 sample seed in-progress** — User chỉ thị thay 2-button approval bằng 3 hành động rõ ràng cho approver: **Duyệt** (forward), **Trả lại** (về DangSoanThao + Drafter sửa, smart reject Mig 16 + clear N-stage rows + Drafter resume jump-back), **Từ chối** (Phase=TuChoi, phiếu khoá vĩnh viễn 17 handler Mig 16 lock edit, Drafter phải tạo phiếu mới). 1 commit (`0d77698`): Domain `PurchaseEvaluationPolicy.cs` NccOnly + NccWithPlan thêm `(X → TuChoi)` transition cho mọi phase trung gian (ChoPurchasing/ChoCCM/ChoDuAn/ChoCEODuyetPA/ChoCEODuyetNCC) với roles của phase. FromDefinition expand: mỗi step (trừ DangSoanThao) thêm (step.Phase → TuChoi) với roles step. Service `PurchaseEvaluationWorkflowService.TransitionAsync` — Reject branch tách 2 case: target=TuChoi giữ nguyên (KHÔNG override + KHÔNG set RejectedFromPhase + KHÔNG clear N-stage); target khác (DangSoanThao) → smart reject (force DangSoanThao + RejectedFromPhase + clear N-stage). FE PeWorkflowPanel (admin + user mirror): render 3 button rõ ràng "✓ Duyệt → X" brand / "← Trả lại (về Drafter sửa)" red / "✗ Hủy / Từ chối" red. Decision logic: target=TuChoi || isSendBack → Reject (2), else Approve (1). Dialog confirm: title rõ + Cancel case warning red "phiếu sẽ bị khoá hoàn toàn" + SendBack case hint amber "Phiếu về DangSoanThao, Drafter sửa rồi trình lại — workflow tự jump tới phase này". Tests: rename `Reject_Sets_RejectedFromPhase_And_Forces_DangSoanThao` → `Reject_To_DangSoanThao_Sets_RejectedFromPhase_TraLai` (target từ TuChoi → DangSoanThao). NEW `Reject_To_TuChoi_Locks_Permanently_No_RejectedFromPhase`. Update `NStage_Reject_Clears_InnerStep_Rows_At_Phase` target → DangSoanThao. **95 → 96 test pass** (+1 Từ chối). **Task 2 sample seed in-progress**: dotnet ef database update applied Mig 9-20 lên LocalDB SolutionErp_Dev (trước đó chỉ Mig 1-8 vì DesignTimeDbContextFactory hardcoded SolutionErp_Design ≠ runtime SolutionErp_Dev — gotcha tooling distinction). API start để DbInitializer auto-seed 30 demo user nhưng exit 255 sớm khi log buffer full → seed dở dang. Defer Task 2 cho session sau (cần guidance: seed manual SQL hoặc manual API run + sample N-stage workflow def + Update PositionLevel cho 30 users existing). | `0d77698` |
-| 2026-05-07 | Claude | **🎯 SESSION 13 — Mirror N-stage workflow sang Contract (Mig 20, 5 commit per-chunk + skip Chunk E API)** — User chỉ thị mirror N-stage từ PE sang Contract. Budget defer (cần versioned WF migration trước, hardcoded BudgetPolicy hiện tại chưa có WorkflowDefinition). 5 chunk per-commit (build + ef + test pass mỗi chunk): **Chunk A (`951ffa3`)** Domain entity `WorkflowStepInnerStep` (Domain/Contracts/) + nav WorkflowStep.InnerSteps + ALTER ContractDepartmentApproval.InnerStepId Guid? + EF config FK Cascade Step / Restrict Dept+InnerStep + **Migration 20** `AddContractWorkflowInnerStepsAndAlterDeptApprovalUnique` GỘP 1 (CREATE TABLE WorkflowStepInnerSteps + ALTER InnerStepId + DropIndex old + Recreate filtered legacy `WHERE InnerStepId IS NULL` + new filtered N-stage `WHERE InnerStepId IS NOT NULL` + 3 IX + 3 FK). **Chunk B (`04cf2a0`)** Application CQRS DTO — `WorkflowStepInnerStepDto` + extend `WorkflowStepDto` + GetWorkflowAdminOverview Include InnerSteps + DeptNames map + `CreateWorkflowStepInnerStepInput` + `CreateWorkflowStepInput` extend (default null backward compat) + Validator child rules + Handler atomic batch insert. **Chunk C (`e247b67`)** ContractWorkflowService refactor mirror PE — load definition InnerSteps eager, reject branch clear N-stage rows tại fromPhase, dept approval block split hasInnerSteps→N-stage logic / else→legacy 2-stage. N-stage flow giống PE: yêu cầu actor có DeptId+PositionLevel, match firstPending Order asc + (exact level OR canBypass + level≥), exact upsert 1 row InnerStepId, bypass batch upsert NV+PP+TP cùng dept ≤ actor (audit IsBypassed cho cấp dưới), recheck stillPending → BLOCK + log "duyệt cấp X (còn Y pending)". **Chunk D (`7c0772a`)** Tests 6 N-stage Contract mirror PE pattern + helper SeedWorkflowDefinitionAsync 2 step adjacent (DangGopY + DangDamPhan) + SeedContractAsync với Project + Supplier seed + FakeChangelogService + FakeContractCodeGenerator stubs. Bug fix: legacy fallback test ban đầu fail (Standard policy DangGopY → DangDamPhan chỉ cho [Drafter, DeptManager], không Procurement) → switched phase pair sang DangKiemTraCCM → DangTrinhKy + role CostControl khớp. Total 89 → **95 test pass**. **Chunk E SKIP** — WorkflowsController auto-bind `[FromBody] CreateWorkflowDefinitionCommand` record qua JSON, no code change cần. **Chunk F (current)** FE-Admin types/users.ts đã có PositionLevel const từ Session 12 reuse. WorkflowsPage Designer extend mirror PeWorkflowsPage Chunk F: InnerStepDto + EditInnerStep types + copyFromDefinition include + departmentsList query + sub-section "Cấp duyệt nhỏ trong phòng" drag-list { Phòng × Cấp + required } + button "+ Thêm cấp duyệt" emerald + payload include Order asc. Empty state hint fallback 2-cấp legacy. KHÔNG đụng fe-user (admin-only). Docs/Skill update. **Backward compat 100%**: workflow Contract no InnerSteps → fallback legacy 2-stage Mig 16. Data legacy InnerStepId=null vẫn enforce unique cũ qua filtered index. Defer Budget mirror cho session sau (cần migration `AddBudgetVersionedWorkflow` trước). | `951ffa3` (A) · `04cf2a0` (B) · `e247b67` (C) · `7c0772a` (D) · (current F) |
-| 2026-05-07 | Claude | **🎯 SESSION 12 — N-stage workflow approval Phòng × PositionLevel cấu hình động (PE-only first, 6 commit per-chunk + Mig 18+19)** — User yêu cầu mở rộng từ 2-stage Mig 16 (NV.Review/TPB.Confirm) sang N-stage cấu hình động: mỗi WorkflowStep cha (= 1 phase) có thể cấu hình chuỗi InnerSteps con theo Department × PositionLevel với Order sequential. Spec defaults chốt 6 câu (PositionLevel int 1=NV/2=PP/3=TP, sequential pure, bypass cùng dept TP skip NV+PP, smart reject reset N-stage rows về DangSoanThao, PE-only first, designer 1 sub-section InnerSteps). 6 chunk per-commit (build + ef + test pass mỗi chunk per `feedback_per_chunk_commit.md`): **Chunk A (`13ab533`)** Domain enum `PositionLevel` (NV/PP/TP) + entity `PurchaseEvaluationWorkflowStepInnerStep` + ALTER User.PositionLevel int? + ALTER PEDeptApprovals.InnerStepId Guid? + EF config + **Migration 18** `AddPeWorkflowInnerStepsAndPositionLevel` (1 CREATE TABLE + 2 ALTER + 3 index + FK Cascade Step / Restrict Dept/InnerStep). 3-file rule. **Chunk B (`0e56bd0`)** Application CQRS DTO — `PeWorkflowStepInnerStepDto` + extend `PeWorkflowStepDto` + `CreatePeWorkflowStepInnerStepInput` (default null backward compat existing PeWorkflowAdminTests) + Validator child rules + Handler atomic batch insert + UserDto +PositionLevel field + `SetUserPositionLevelCommand` mirror SetBypassReview. **Chunk C (`0c62e24`)** Service N-stage logic — **Migration 19** `AlterPeDeptApprovalsUniqueFilteredForInnerSteps` (filtered unique: legacy `WHERE InnerStepId IS NULL` + N-stage `WHERE InnerStepId IS NOT NULL`) cho phép multi-row cùng dept khác inner step. PurchaseEvaluationWorkflowService refactor: load definition InnerSteps eager + reject branch clear N-stage rows + dept block split hasInnerSteps→N-stage logic / else→legacy 2-stage. N-stage flow: yêu cầu actor có DeptId+PositionLevel, match firstPending (Order asc IsRequired) same dept + (exact level OR canBypass + level≥), exact match upsert 1 row InnerStepId, bypass batch upsert NV+PP+TP cùng dept ≤ actor level (audit IsBypassed cho cấp dưới skip), recheck stillPending → BLOCK + log "duyệt cấp X (còn Y pending)" / all done → fall through phase transition. Backward compat: workflow no InnerSteps fallback legacy + InnerStepId=null filter unique cũ vẫn enforce. **Chunk D (`3d76c6b`)** Tests N-stage 6 test mới (NV first blocks / 3-level sequential pass / TP bypass skips / wrong dept throws 403 / reject clears rows / legacy fallback no inner) + IdentityFixture extend `+positionLevel` arg + helper SeedWorkflowDefinitionAsync 2 step adjacent (ChoPurchasing+ChoCCM) cho FromDefinition build transition policy guard pass. Total 83→**89 test pass**. **Chunk E (`83ffabd`)** API `PATCH /users/{id}/position-level` mirror SetBypassReview pattern + body `{positionLevel:int?}` Authorize Users.Update. **Chunk F (current)** FE-Admin types/users.ts +positionLevel field + PositionLevel const + Label/Short maps. PeWorkflowsPage Designer extend: InnerStepDto type + EditInnerStep type + copyFromDefinition include + departmentsList query + sub-section "Cấp duyệt nhỏ trong phòng" per step card với drag-drop list { Phòng × Cấp + required checkbox } + button "+ Thêm cấp duyệt" (xanh emerald) + payload include innerSteps Order asc. UsersPage column "Cấp" badge NV/PP/TP emerald + action button cycle null→1→2→3→null call positionLevelMut PATCH. KHÔNG đụng fe-user (admin-only feature). Docs/Skill update. PE-only first. Backward compat 100%: workflow no InnerSteps + data legacy 2-stage rows không phá. | `13ab533` (A) · `0e56bd0` (B) · `0c62e24` (C) · `3d76c6b` (D) · `83ffabd` (E) · (current F) |
-| 2026-05-08 00:30 | Claude | **🎯 SESSION PHASE 2 WRAP-UP — B12-B14 PE detail polish iterate (3 commit FE-only sau wrap-up `6e7a6db`)** — User UAT iteration tiếp, áp rule strict verify khi rename/remove (lesson hotfix CI). 3 batch nhỏ: **B12 (`378c993`)** "Lưu" no-close (chỉ toast + invalidate, KHÔNG đóng workspace) + nút "Xóa phiếu" red bottom CHỈ Bản nháp (soft-delete `IsDeleted=true` qua AuditableEntity, không xóa hoàn toàn DB) + bỏ header bar workspace mode "Sửa header"/"Xóa"/"Đóng" (chuyển hết xuống bottom action bar) + Section 4 column header dùng `s.supplierName` thay `displayName` (NCC master) + Section 3 row chặn xóa NCC khi đã có quotes (`hasQuotes` computed) + tooltip "xóa báo giá trước". **B13 (`e320027`)** InfoTab `useEffect` watch `[autoEdit, canEdit, ev.id, ...]` → re-trigger edit mode khi pencil click phiếu khác (fix useState mount-time only) + sync values từ ev mới (tránh stale state) + Pencil "sáng lên" active state khi `editingRowId === p.id` (bg-brand-100 + text-brand-700 + ring-brand-300 + shadow-sm + tooltip cập nhật) + wire `editingRowId={autoEditHeader ? selectedId : null}` từ Workspace → PeListPanel. **B14 (`d2306b8`)** QuoteDialog bỏ checkbox "Chọn NCC này cho hạng mục" (consolidate winner ở Section 2.a NccSelectorRow, isSelected vẫn gửi BE giữ trạng thái cũ) + winner column Section 4 matrix highlight emerald (header `bg-emerald-50` + `✓ ` prefix + cells `bg-emerald-50 font-semibold` cho ENTIRE column, không chỉ cell có quote) + loading overlay full-screen QuoteDialog (`bg-white/70 backdrop-blur-sm` + spinner ring brand-600 + text "Đang lưu báo giá…"/"Đang xóa…") + NccSelectorRow inline spinner "Đang chọn NCC + sync cột giá Section 4…" + disable Hủy/Xóa/Lưu buttons khi `isSaving`. Verify: `npm run build` × 2 app pass mỗi commit · `dotnet test` 83 pass (KHÔNG regression). | `378c993` (B12) · `e320027` (B13) · `d2306b8` (B14) |
-| 2026-05-07 | Claude | **🎯 SESSION WRAP-UP S10-11+++++++ — PE Workspace UX overhaul đầy đủ (23 commit / ~3500 LOC FE + Mig 17 BE)** — User UAT live mode iterate liên tục, áp rule `feedback_uat_skip_verify` (skip dotnet test sau mỗi chunk, push ngay). 7 batch chính: **B1 (S10) PE Thao tác 2-panel workspace** — leaf `Pe_*_Create` từ page Create header riêng → workspace 2-panel `[320px_1fr]` mirror HĐ Thầu phụ; PeListPanel pure picker + sticky "+ Thêm mới"; PeDetailTabs `mode='workspace'` ẩn Workflow/Approvals/History + Section 5 disabled "nhập khi duyệt" (4 commit). **B2 (S11) Migration 17** `AddManualBudgetFieldsToPeAndContract` — 4 ALTER (PE + HĐ × `BudgetManualName` nvarchar(200) + `BudgetManualAmount` decimal(18,2)) cho fallback "user nhập tay khi không link Budget entity approved". Domain + EF config + App CQRS Create/Update + DTO + Validator + carry-forward `CreateContractFromEvaluation`. FE toggle "Nhập tay" trong PeHeaderForm + ContractCreatePage NewForm/EditForm × 2 app (5 commit). **B3 (S11+) BudgetFieldRow inline editor** — Section 2 "b. Ngân sách" thay FormRow tĩnh → editable component (toggle + Select OR 2 input + Save dirty + Hủy). canEdit cho cả 3 view (Workspace/Danh sách/Duyệt mode), readOnly chỉ display (3 commit). **B4 (S11++) InfoTab inline edit + PeListPanel pencil hover** — Section 1 "✎ Sửa" button flip display↔inputs (Tên/Địa điểm/Mô tả/Payment editable, Dự án locked). PeListPanel thêm pencil icon group-hover absolute right + URL `?editHeader=1` chain → `autoEditHeader` prop trigger mount-time edit (3 commit). **B5 (S11+++) Workspace "new" sectioned create view** — `PeWorkspaceCreateView.tsx` ~230 LOC layout 5 sections giống PeDetailTabs visual. S1 + S2.b editable, S3-5 LockedHint "Lưu phiếu trước". POST trigger create. Replace `PeHeaderForm` trong workspace mode='new' (1 commit). **B6 (S11++++) Danh sách disable toàn bộ interactions** — PurchaseEvaluationsListPage `readOnly={true}` hardcoded cho PeDetailTabs + `readOnly={!pendingMe}` cho PeWorkflowPanel (List view → ẩn Chuyển tiếp + show hint "Vào menu Duyệt"; Pending vẫn approve được) (2 commit). **B7 (S11+++++) Lock Loại quy trình + payment preset** — workspace `<Select>` Loại quy trình → `<Input disabled>` theo URL `?type=N`. `<Textarea>` JSON Điều khoản TT → `<Select>` 8 preset Việt + "Khác (nhập tay)" → text input fallback (1 commit). **B8 (S11++++++) Display status meta** — `PeDisplayStatus` enum 4-5 trạng thái UI (Bản nháp / Đã gửi duyệt / Trả lại / Đã duyệt / Từ chối) gom phase chi tiết. `getPeDisplayStatus()` helper. Workflow timeline Panel 3 vẫn giữ phase chi tiết (1 commit). **B9 (S11+++++++) Phase TraLai + pencil always visible + edit gating** — Domain `PurchaseEvaluationPhase` thêm `TraLai = 98` (giữa DaDuyet=7 + TuChoi=99). FE label/color + display status badge. `isEditablePhase()` helper: chỉ DangSoanThao + TraLai. PeListPanel pencil bỏ hover-only → LUÔN visible (bright khi editable / xám disabled khi không) + click guard. Workspace `editableOnly` filter client-side (1 commit). **B10 (hotfix CI)** — TS strict catch fail 2 commit B7+B8 do skip-verify (`forcedPhase` rename quên xóa destructuring args + unused `PurchaseEvaluationType` import). Update memory `feedback_uat_skip_verify.md` thêm exception "rename/remove → BẮT BUỘC `npm run build`" (1 commit). **B11 (last) PE detail polish** — `NccSelectorRow` Section 2.a thay FormRow tĩnh → Select dropdown từ ev.suppliers (Section 3 list) wire `/select-winner` API. Section 2.c text rõ "(chọn NCC trước)" / "(chưa nhập báo giá)". Section 3 row khi `isWinner` → ẩn ✏ + 🗑 (chỉ giữ ✓ active). Bottom action bar workspace mode: **2 nút "Lưu (đóng)" + "Lưu & Gửi Duyệt →"** confirm dialog → POST `/transitions` với `targetPhase = first nextPhase` skip TuChoi/TraLai → workflow chuyển từ Bản nháp/Trả lại → Đã gửi duyệt (ChoPurchasing) → onBack đóng workspace (1 commit). | `ee0d360` (S10 C1) → `4c0625c` (B11) — 23 commit total |
-| 2026-05-07 | Claude | **PE InfoTab inline edit Section 1 + PeListPanel pencil edit hover** — User feedback 2026-05-07: muốn thêm nút edit kế bên row trong Panel 1, click sáng nội dung Section 1 lên cho user sửa header inline (KHÔNG cần đi "Sửa header" page). 2 chunk per-commit (build pass mỗi chunk): C1 fe-admin (3 file) — InfoTab thêm prop `readOnly + autoEdit`, canEdit=`!readOnly && isDraft`: display mode hiển thị FormRow + button "✎ Sửa" góc trên phải, editing mode card border brand-200 + 4 input (Tên */Dự án locked/Địa điểm/Mô tả/Payment) + Save (PUT /pe/:id full payload + invalidate detail+list)/Hủy. PeListPanel thêm prop `onEditClick`, pencil icon absolute right-2 top-2 mỗi row, opacity-0 group-hover:opacity-100. PurchaseEvaluationWorkspacePage đọc URL `?editHeader=1` → pass `autoEditHeader` xuống PeDetailTabs → trigger edit auto. C2 fe-user mirror y hệt 3 file (rule §3.9). KHÔNG đụng BE. KHÔNG refactor workspace "new" mode (defer — PeHeaderForm hiện tại đủ dùng, làm thêm khi user feedback). | `5a89dd2` (C1) · (current C2) · (current C3 docs) |
-| 2026-05-07 | Claude | **PE BudgetFieldRow inline editor — toggle + 2 fields trong Section 2 (cả 3 view)** — User feedback after Session 11: muốn toggle "Nhập tay" + 2 input fields hiển thị trực tiếp trong Section 2 "b. Ngân sách" của PeDetailTabs — KHÔNG chỉ ở "Sửa header" page, mà cả 3 view (Workspace / Danh sách / Duyệt). Empty values cứ hiển thị empty (không text "(chưa link)" verbose). 2 chunk mirror per-commit (build pass mỗi chunk): C1 fe-admin BudgetFieldRow component (~125 LOC) thay FormRow tĩnh ở `b. Ngân sách`. canEdit=`!readOnly && isDraft`: render toggle + Select Budget OR 2 input grid 2-col + nút "Lưu ngân sách" (chỉ hiện khi dirty) + "Hủy thay đổi". Save: full PUT `/pe/:id` với current entity values + new budget payload. Read-only mode (Duyệt + !isDraft): chỉ display, KHÔNG toggle/inputs, empty hiển thị "—". C2 fe-user mirror y hệt 1 file (rule §3.9). Mỗi chunk: build pass + 0 TS error. KHÔNG đụng BE — re-use existing PUT endpoint. | `19712d8` (C1) · `d5c6f12` (C2) · (current C3) |
-| 2026-05-07 | Claude | **Migration 17 — manual budget fields fallback cho PE + HĐ (toggle "Nhập tay")** — User feedback: khi project chưa có Budget approved (Phase=DaDuyet eligible), user phải break flow đi tạo Budget + duyệt + quay lại link. UX kém. Solution: thêm fallback "Nhập tay" — checkbox toggle cạnh Label Ngân sách, khi ON → hide Select Budget, show 2 input field grid 2-col (Tên tham chiếu text + Số tiền number formatted VND). Lưu trên entity row, KHÔNG cần Budget entity. Q1-3 chốt: 1 = stick-toggle reveal 2 input fields; 2 = cả BudgetId + manual fields cùng null OK (KHÔNG XOR validate); 3 = mirror logic sang HĐ luôn (cả 7 ContractType qua ContractCreatePage). 5 chunk per-commit (build + 83 test pass mỗi chunk): C1 Migration 17 `AddManualBudgetFieldsToPeAndContract` 4 ALTER (PE + HĐ × Name nvarchar(200) + Amount decimal(18,2)) + Domain 2 entity + 2 EF config (HasMaxLength + HasPrecision) — applied LocalDB OK, 3-file rule. C2 App CQRS — CreatePurchaseEvaluationCommand + Update + DTO + Validator (>=0 when has value), CreateContractCommand + Update + DTO + diff log audit, CreateContractFromEvaluation carry forward pe.BudgetManualName/Amount → contract khi gen HĐ từ phiếu. C3 FE-Admin — types +2 field, PeHeaderForm toggle + 2 input + payload conditional (manual mode clear budgetId, link mode clear manual), PeDetailTabs Section "b. Ngân sách" fallback display "Tên · Số tiền + badge nhập tay" khi !budget + có manual data, refactor PurchaseEvaluationCreatePage wrap PeHeaderForm DRY (222→30 LOC), ContractCreatePage NewContractForm + EditContractForm cùng pattern + read-only display branch khi !isDraft. C4 fe-user mirror y hệt 6 file. C5 docs (this row + HANDOFF + session log). KHÔNG đụng Budget entity / Phase=DaDuyet validation (giữ invariant). | `ecd5f7e` (C1) · `0f7901c` (C2) · `bab5031` (C3) · `14f8d9d` (C4) · (current C5) |
-| 2026-05-07 | Claude | **PE "Thao tác" 2-panel workspace + Panel 1 read-only picker + Section 5 disabled** — User chỉ thị restructure leaf "Thao tác" (Pe_DuyetNcc_Create + Pe_DuyetNccPhuongAn_Create) từ page tạo header riêng (`/purchase-evaluations/new?type=N` — chỉ form Tên/Project/Địa điểm/Payment/Budget) sang workspace 2-panel mirror pattern HĐ Thầu phụ ContractCreatePage. 5 câu chốt spec trước code: Q1 Panel 2 KHÔNG render Workflow Panel + Approvals + History (chỉ data entry); Panel 1 = pure picker, KHÔNG inline edit/delete; Q2 mirror HĐ Thầu phụ pattern (sticky "+ Thêm mới" + Panel 2 transition new→edit form); Q3 leaf "Danh sách" + "Duyệt" giữ 3-panel hiện tại; Q4 route mới `/purchase-evaluations/workspace?type={1\|2}`; Q5 Section 5 Ý kiến 4PB disable trong workspace (vì người ta nhập khi duyệt, không phải lúc nhập liệu). 2 chunk per-commit (build + 83 test pass mỗi chunk): C1 fe-admin (3 file mới `PeListPanel.tsx` ~180 LOC pure picker reuse + `PeHeaderForm.tsx` ~210 LOC extract + `PurchaseEvaluationWorkspacePage.tsx` ~120 LOC, 3 file sửa `PeDetailTabs.tsx` thêm prop `mode?: 'detail' \| 'workspace'` + Section 5 hint banner amber + Layout.tsx resolver `Pe_*_Create`→`/workspace?type=N` + App.tsx route mới). C2 fe-user mirror y hệt 6 file (rule §3.9). KHÔNG đụng BE / migration / schema / endpoint. Route `/new` cũ giữ tồn tại cho deep-link "Sửa header" button. **Total +1142 LOC FE / 0 BE / 32 FE pages.** | `ee0d360` (C1) · `ecf3c59` (C2) · (current C3) |
-| 2026-05-04 | Claude | **User Manual 7 file rewrite compact cho end-user** — User feedback "ko cần quá đầy đủ chi tiết, cho end-user họ làm". Setup `package.json` + `npm install docx@9.5.0` + script `npm run gen:all`. Rewrite 7 generator scripts theo style end-user friendly: BỎ field validation table 5 cột (Tên field/Kiểu/Bắt buộc/Validation/Ví dụ), BỎ error troubleshoot table 3 cột (Lỗi/Nguyên nhân/Cách xử lý), BỎ FAQ chi tiết 8 câu (giữ 1 chương "Khi gặp lỗi" 4-5 bullet), BỎ phím tắt table. GIỮ: tổng quan ngắn 1-2 câu mỗi chức năng, numbered steps đơn giản 3-7 bước, note/warn/tip chỉ critical, bullet liệt kê. 7 file: 01-Bat-dau (12.1KB cũ 21.7KB ↓44%) / 02-Hop-dong / 03-Duyet-Workflow (mention 2-stage NV/TPB Mig 16) / 04-PE-Phieu-Duyet-NCC (A/B + 4PB + tạo HĐ) / 05-Budget / 06-7-Loai-HD-Cheatsheet / admin-02-Quan-ly-Users-Roles (mention bypass review S9). Refactor user-01 dùng `_helpers.js` shared (trước có helpers inline 793 dòng, giờ ~110 dòng). Tổng output ~86KB / 7 file (cũ ~123KB ↓30%). | `16c2c9c` |
-| 2026-05-04 | Claude | **Optional polish — fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"** — User chỉ thị "tiếp tục plan tổng" → pick task không blocked. useQuery thứ 2 cho `/purchase-evaluations/inbox` (endpoint có sẵn), peRows filter theo search. Stats overdue/dueSoon đếm cả PE rows (totalValue chỉ HĐ vì PE không có giá trị). Panel 1 chia 2 section sticky header: "Hợp đồng (N)" giữ behavior cũ click → inline detail Panel 2; "Phiếu Duyệt NCC (M)" click → navigate `/purchase-evaluations/:id` page riêng (PE entity shape khác Contract, không inline). EmptyState mới: "Không có HĐ hoặc Phiếu Duyệt NCC nào chờ". Chỉ fe-user (Drafter + TPB dùng Inbox) — fe-admin defer. Build pass. | `332a90f` |
-| 2026-05-04 | Claude | **Audit định kỳ 2026-05 (combined skill + doc drift theo §6.4 + §9.4)** — Cron `solution-erp-skill-audit-monthly` empty (`No scheduled jobs`), trễ 4 ngày so schedule 2026-05-01 → manual trigger sau Session 9 close. Phase 1 cross-check counts: tests=83, migrations=16, gotchas=41, skills=6, STATUS rows=12 (<30 chưa archive) — toàn bộ khớp. Drift patches 5 file: docs/CLAUDE.md (52→55 bảng + §14 DepartmentApprovals), docs/rules.md (Phase 8→9, 77→83 test), docs/architecture.md (77→83 test 2 chỗ), .claude/skills/ef-core-migration (77→83 + ghi 6 PE 2-stage), .claude/skills/dependency-audit-erp (26+→41 bẫy). Phase 2 skill staleness: contract-workflow thêm "Phase 9 cross-ref Mig 16" block + section "Phase 9 done" (2-stage + smart reject + lock edit + bypass). KHÔNG tạo skill mới (§9.5 anti-pattern "viết skill chỉ để có thêm" — pattern 2-stage đủ generic, đã ghi đủ Domain/Service/6 test reusable). Cron recreate SKIP (CronCreate Claude SDK auto-expire 7 days, không fit monthly cadence). Audit log `docs/changelog/skill-audit-2026-05.md` (1 page). 6 file ~+30/~12 line patch, validation §6.5 OK. | `7dc0233` |
-| 2026-05-04 | Claude | **Session 9 — Chunk E-bis complete: FE 2-stage panel + UserManager bypass toggle + HĐ/Budget 2-stage mirror PE + 6 test + IdentityFixture** — User chỉ thị "làm hết cho xong tính năng luôn". 5 chunk per-commit (build + 83 test pass mỗi chunk): (E2) FE PeWorkflowPanel section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber chờ TPB, badge fuchsia bypass — cả 2 app (rule §3.9). (E3) FE UsersPage column "Bypass" + ShieldCheck toggle button + UserDto.CanBypassReview field. (E4) ContractWorkflowService thêm UserManager DI + mirror 2-stage logic từ PE + `ContractDepartmentApprovalFeatures.cs` (List query) + endpoint `GET /contracts/{id}/department-approvals` + FE WorkflowHistoryPanel section. (E5) Budget mirror đầy đủ — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime DI + 2-stage logic + `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE BudgetWorkflowPanel. (E6) `IdentityFixture` setup ServiceProvider với Identity stack đầy đủ (DbContext SQLite + AddIdentityCore + AddRoles<Role> + EF stores) + 6 test PE 2-stage: NV_Review_Blocks / TPB_Confirm_Allows / NV_Bypass / Admin_Skip / Reject_Sets_RejectedFromPhase / Resume_Jumps_Back. Tests Contract + Budget skip vì logic identical PE, ROI thấp. **Total 77→83 test pass.** 5 commit pushed lên Gitea. | `f8eebd5` (E2) · `4380bdc` (E3) · `b6f5a16` (E4) · `1fc439b` (E5) · `8353fe8` (E6) · (current E7) |
-| 2026-05-04 | Claude | **Session 8 — Migration 16: 2-stage dept approval + smart reject + lock edit (đóng bug anh Kiệt)** — Anh Kiệt báo: NV.PRO tạo phiếu PE → duyệt được hết phase = phân quyền sai. Schema mới: 3 bảng `*DepartmentApprovals` (Contract/PE/Budget) UNIQUE (TargetId, Phase, Dept, Stage). 4 cột mới: `Users.CanBypassReview` bit + 3 `RejectedFromPhase` int. Logic 2-stage trong `PurchaseEvaluationWorkflowService.TransitionAsync`: user.DepartmentId != null → DeptManager (TPB) Stage=Confirm; CanBypassReview=true → Stage=Confirm+IsBypassed; else NV → Stage=Review only, BLOCK transition cho đến khi TPB confirm. Smart reject: Decision=Reject → set RejectedFromPhase, force về DangSoanThao. Resume sau reject: Drafter trình lại từ DangSoanThao + RejectedFromPhase != null → jump straight tới phase đã reject (skip phase trung gian). Lock edit: 17 handler thêm guard Phase != DangSoanThao (Contract Detail × 15, PE Detail × 5, Budget Detail × 3). 3 endpoint mới: `GET /pe/{id}/department-approvals` (FE Workflow Panel hiển thị progress) + `PATCH /users/{id}/bypass-review` (admin toggle) + Notify TPB cùng dept khi NV review. **HĐ + Budget 2-stage scope defer** (chỉ PE first đóng bug). FE update + Tests defer Chunk E-bis. | `5fe61cc` (A) · `14f3c9f` (B) · `9747f8c` (C) · `a532ba6` (D) · (current) |
-| 2026-04-30 | Claude | **Session 6 — MD audit + compact + 3 skill refresh + 2 rule mới** — Compact 3 file core (-288 dòng): STATUS -27%, HANDOFF -32%, migration-todos -35%. Archive 51 row Recently Done Phase 0-7 → `changelog/recently-done-archive-2026-04.md`. Refresh 3 skill stale: `form-engine` (Phase 2 MVP → Tier 3 feature-complete + bỏ section duplicate gen mã HĐ), `permission-matrix` (12 menu → ~60 menu key + Bg_*/Pe_*/PeWf_* + inheritance roots), `ef-core-migration` (24 DbSet → 52 bảng + ERD update). Rule mới `rules.md §7 Khi nào viết test — timing rule` (5-row table compact, sau khi rút gọn từ 70 dòng overkill). Rule mới `rules.md §6.4 Audit + compact MD định kỳ` (cadence + checklist + anti-pattern, KHÔNG rewrite toàn bộ). `rules.md §9.4 Skill audit` mở rộng cross-ref §6.4. | (current) |
-| 2026-04-29 | Claude | **Tests Phase 3 mini + 3 gotcha CI mới (#39 #40 #41)** — `tests/.../Application/PeWorkflowAdminTests.cs` 6 test versioning logic (CreatePeWorkflowDefinition: first version IsActive=true, second deactivates first, different EvaluationType independent, persists steps ordered + approvers per step, third version increments to v3). Total **77 test** (54 Domain + 17 Infra + 6 PE WF Application). Gotcha #39 act_runner github.com TCP timeout 21s + manual checkout fix. #40 npm junction cache fail `tsc not found` rolled back. #41 paths-ignore behavior + workflow file exclusion. | `b874743` |
-| 2026-04-29 | Claude | **CI Path filter docs-only skip live** — `paths-ignore` trong on:push lookup `docs/**`/`**/*.md`/`.claude/skills/**`/`.gitignore`. Commit chỉ touch docs SKIP CI hoàn toàn (saving ~196s/commit, ~30% commit thuộc loại này). Verify `512880c` (docs-only) → Gitea NO trigger run #113. | `29eb5d9` · `a21790d` · `512880c` |
-| 2026-04-29 | Claude | **CI manual checkout bypass github.com (fix #108/#109)** — Run #108/#109 fail TCP timeout 21s khi act_runner fetch `actions/checkout@v4` từ github.com. Replace `uses: actions/checkout@v4` + `actions/upload-artifact@v4` bằng manual `git init` + `git fetch` từ Gitea internal. Token `${{ github.token }}` auth tự sẵn per-job. Fetch by ref + depth=30. Run #110 pass 3m16s. | `14b7d18` · `26075c4` |
-| 2026-04-29 | Claude | **Tests Phase 2 — Code generator format + sequence (SQLite in-memory)** — `tests/SolutionErp.Infrastructure.Tests/` xUnit + EF SQLite 10. `SqliteDbFixture` + `TestApplicationDbContext` subclass override `nvarchar(max) → TEXT` (SQLite không support `max`). 17 test: ContractCodeGenerator (format RG-001 5 type + Framework year scope vs Project scope + sequence per prefix + year boundary reset + persistence verify) + PurchaseEvaluationCodeGenerator (format A/B + 3-digit pad + independent A/B sequences + year boundary). CI gate +1 step. Total 71 test pass / 2.1s. | `df5988b` |
-| 2026-04-29 | Claude | **Tests Phase 1 — Domain unit tests + CI gate** — `tests/SolutionErp.Domain.Tests/` xUnit 2.9 + FluentAssertions 7.2 (pin trước v8 commercial). 54 test pure function (no DB/IO): WorkflowPolicy (Standard 9-phase + SkipCcm 7-phase + Registry per ContractType + FromDefinition versioned + UserKindApprover) / PEPolicy (NccOnly 3-step + NccWithPlan 5-step + reject paths) / BudgetPolicy (Default 3-step + terminals + SLA spec). `.gitea/workflows/deploy.yml` thêm step "Run unit tests" trước build, fail → `exit $LASTEXITCODE` → no deploy. SolutionErp.slnx + folder `/tests/`. | `d3f9346` |
-| 2026-04-29 | Claude | **PE Workflow designer admin UI + Ý kiến 4 phòng ban** — Migration 15 `AddPurchaseEvaluationDepartmentOpinions` (UNIQUE PEId+Kind, 1 row/phòng/phiếu). Domain `PurchaseEvaluationDepartmentOpinion` + enum `PeDepartmentKind` (PheDuyet/Ccm/MuaHang/SmPm). BE: `PeWorkflowAdminFeatures.cs` ~250 LOC mirror Contract pattern (GetOverview + Create version, deactivate cũ atomic) + `PeWorkflowsController` 2 endpoint reuse policy `Workflows.*`. `PeDepartmentOpinionFeatures.cs` Upsert (sign=true→set SignedAt+UserId, sign=false giữ chữ ký cũ) + Delete + 2 endpoint. FE: `PeWorkflowsPage.tsx` ~500 LOC + designer dialog (clone version + add/remove steps + +Role/+User approvers). Section "5. Ý kiến 4 phòng ban (sign-off)" 2x2 grid OpinionBox (read mode chữ ký vs edit textarea + 2 button Lưu/Lưu&Ký). | `5d94bb4` |
-| 2026-04-29 | Claude | **PE Detail UI restructure theo spec form PHIẾU TRÌNH KÝ** — 4 section đánh số match form chính thức: "1. Thông tin gói thầu" (a/b chỉ Tên + Dự án) / "2. Chọn NCC/TP" (a NCC chọn / b Ngân sách / c Giá chào thầu auto-compute từ winner quotes / d Bản so sánh embed GeneralAttachments) / "3. NCC/TP tham gia" / "4. Hạng mục + Báo giá". FormRow helper (label 176px + value flex) thay cho dl grid 2-col cũ. | `7e36241` |
-| 2026-04-29 | Claude | **PE/Contract → Budget integration + cột "So với ngân sách"** — BE: `BudgetSummaryDto` shared (PE & Contract DetailBundle), Create/Update PE+Contract commands + `BudgetId?` validate cùng Project + Phase=DaDuyet. `CreateContractFromEvaluation` carry forward pe.BudgetId → contract.BudgetId. FE: PE & Contract Create form + Select "Ngân sách" filter Phase=DaDuyet + Project match. PE InfoTab + Contract Edit display Budget link clickable. PE ItemsTab matrix + cột "NS link · Δ" — match per-row qua key `groupCode\|itemCode`, fetch /budgets/{id} riêng + footer aggregate (xanh dưới / đỏ vượt / xám khớp). | `61e5d4d` |
-| 2026-04-29 | Claude | **Budget FE 3-panel pages cả 2 app** — `types/budget.ts` (BudgetPhase 5-state enum + DTO) + `BudgetsListPage` 3-panel `[340px_1fr_360px]` + filter Phase + Năm + alias `?phase=Pending` + readOnly mode menu Duyệt + `BudgetCreatePage` form Header + `BudgetDetailTabs` flat (Section Thông tin Header + Section Hạng mục table CRUD inline auto-compute ThanhTien=KL×ĐG) + `BudgetWorkflowPanel` Panel 3 timeline + dialog comment + Approvals/Changelog. Mirror fe-user. App.tsx 3 route + Layout resolver `Bg_*`. TS build pass cả 2 app. | `df12fb1` |
-
-
-> **51 row Phase 0-7 (2026-04-21..28) đã archive →** [`changelog/recently-done-archive-2026-04.md`](changelog/recently-done-archive-2026-04.md)
-
-Session logs: [P0](changelog/sessions/2026-04-21-1045-phase0-scaffold.md) · [P1f](changelog/sessions/2026-04-21-1100-phase1-foundation.md) · [P1.2](changelog/sessions/2026-04-21-1130-phase1-cruds-permission.md) · [P2](changelog/sessions/2026-04-21-1200-phase2-form-engine.md) · [P3](changelog/sessions/2026-04-21-1330-phase3-workflow.md) · [P4](changelog/sessions/2026-04-21-1430-phase4-report.md) · [P5prep](changelog/sessions/2026-04-21-1530-phase5-prep.md) · [Tier 3](changelog/sessions/2026-04-22-0300-tier3-feature-complete.md) · [Skill gov](changelog/sessions/2026-04-23-0900-skill-governance.md) · [Toolkit+4-bảng+Roles VN](changelog/sessions/2026-04-23-1500-toolkit-data-roles.md) · [Roles+Demo+Pending](changelog/sessions/2026-04-23-2200-roles-demo-pending-cleanup.md) · [PE polish iter 2 + rebrand](changelog/sessions/2026-04-24-chot-session-3-pe-polish.md) · [Budget BE + 14 Solutions users](changelog/sessions/2026-04-28-chot-session-4-budget.md) · [Budget FE + PE/HD-Budget + PE WF Designer + Tests Phase 1-2](changelog/sessions/2026-04-29-chot-session-5-budget-fe-pe-tests.md) · [Drastic refactor flat workflow Mig 21](changelog/sessions/2026-05-08-0500-drastic-refactor-flat-workflow.md) · [PE V2 schema end-to-end Mig 22-24](changelog/sessions/2026-05-08-1100-pe-workflow-v2-end-to-end.md) · [**S18 PE V2 polish + Clone B + Mig 25 IsUserSelectable**](changelog/sessions/2026-05-08-1945-s18-pe-v2-polish-clone-b.md)
-
-**Docs entry points:**
-
-- [`rules.md`](rules.md) · [`architecture.md`](architecture.md) · [`HANDOFF.md`](HANDOFF.md)
-- [`workflow-contract.md`](workflow-contract.md) · [`forms-spec.md`](forms-spec.md)
-- [`database/database-guide.md`](database/database-guide.md) · [`database/schema-diagram.md`](database/schema-diagram.md)
-- [`flows/`](flows/) (7 file) · [`guides/`](guides/) (4 file) · [`gotchas.md`](gotchas.md)
-- [`changelog/migration-todos.md`](changelog/migration-todos.md) · [`changelog/sessions/`](changelog/sessions/) (17 file)
-- [`.claude/skills/README.md`](../.claude/skills/README.md) — 6 skill (3 domain + 3 ops) · audit định kỳ 1/tháng (cron `solution-erp-skill-audit-monthly` next 2026-05-01)
+---
 
 ## 🎯 Next up
 
-### Hard blockers (chờ user / ops)
+### ⬜ Phase 11 — Polish/wire skeleton (NEXT plan lớn)
+- **P11-A** wire ApproveV2 + LevelOpinions 4 module (Leave/OT/Travel/Vehicle) — 👤 schema + 🟨 BE + 🟧 FE + 🟪 test + 🟥 reviewer + 🟩 cicd
+- **P11-B** LeaveBalance business logic (👤 cross-stack) · **P11-C** Vehicle+Driver catalog Mig 41 · **P11-D** ItTicket auto-assign + SLA timer · **P11-E** AttendanceReport + Excel + OtPolicy multiplier · **P11-F** CodeGen atomic MaDonTu/MaTicket
 
-- [ ] **UAT 1 tuần 2-3 user thật** — hard requirement từ roadmap Phase 5
-- [ ] **Email outbox** — MailKit + SMTP (BLOCKED chờ user cấp SMTP host/user/pass)
-- [ ] **Rotate credentials** — SA, vrapp, JWT secret, runner token (đã post chat)
-- [ ] **SQL backup daily** — Task Scheduler (script `scripts/backup-sql.ps1` đã có, chưa schedule)
+### 🔧 Maintenance backlog
+- Curate 4 agent MEMORY >25KB: investigator-codebase 35.7 / cicd-monitor 35.3 / implementer-backend 30.9 / reviewer 28.4
+- RAG re-ingest `solution_erp` S37-S39 content (Proposal/WorkflowApps/7-agent)
+- Test coverage gaps: **Gap1** HrmConfig Holiday composite UNIQUE (🔴 CRITICAL) · **Gap2** EmployeeSatellite cascade · **Gap3** gotcha #44 regression `EmployeesController`+`HrmConfigsController`
+- Skill + doc drift audit cron **2026-06-01**
 
-### Optional polish (khi rảnh / UAT phát sinh)
+### 🚫 Phase 9 Ops (blocked — anh main coordinate)
+- SMTP email outbound · Rotate prod creds · SQL auto-backup (backup-sql.ps1 ready, chờ Task Scheduler register) · UAT 2-3 user 1 tuần
 
-- [ ] Roles CRUD — admin tạo custom role ngoài 12 hardcoded (schema sẵn, chỉ cần CQRS + FE)
-- [ ] User-level approver targeting runtime — data model đã có (`WorkflowStepApprover.Kind=User`), chỉ cần wire User-kind vào `ContractWorkflowService.TransitionAsync` guard
-- [ ] PermissionsPage: grant `Workflows.Read` cho non-admin role → menu Wf_* visible
-- [ ] Warning notification khi còn 20% SLA (`SlaWarningSent` flag đã có, chỉ thiếu job emit)
-- [ ] E2E test reject → quay về DangSoanThao (multi-role)
-- [ ] Dependencies scan CI (`dotnet list package --vulnerable`, `npm audit`)
-
-### Tier 3 ERP roadmap ✓ (close)
-
-- [x] Attachment upload BE + FE ✓
-- [x] SignalR real-time push ✓
-- [x] Form template builder CRUD + DynamicForm ✓
-- [x] PDF export qua LibreOffice headless ✓
-- [x] .doc/.xls → .docx/.xlsx auto-conversion ✓
-- [x] Dynamic workflow policy per ContractType ✓
-- [x] **Versioned workflow (WorkflowDefinition pinned per Contract)** ✓
-- [x] **Admin workflow designer UI (per-type, per-step approvers)** ✓
-- [x] **Nested sidebar menu per ContractType (fe-user) + menu split admin/user** ✓
-- [x] **PermissionsPage 3-panel layout** ✓
-- [ ] Email outbox for Notification (blocked — SMTP config)
-
-## 📊 Thông số cumulative
-
-| | P0 | P1f | P1.2 | P2 | P3 | P4 | P5prep | Tier3 | +Toolkit | +RolesPg+Demo | +PE module | +PE polish | +Budget+30 users | **+Session 5** |
-|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
-| BE LOC | 0 | ~400 | ~1500 | ~1900 | ~2700 | ~3100 | ~3300 | ~4800 | ~7800 | ~8800 | ~11100 | ~11400 | ~11750 | **~13050** (+1300 PE WF Designer + Opinion + Budget integration) |
-| DB tables | 0 | 7 | 12 | 14 | 19 | 19 | 19 | 24 | 36 | 36 | 46 | 47 | 51 | **52** (+1 PEDepartmentOpinions) |
-| API endpoints | 0 | 4 | 20 | 23 | 31 | 33 | 35 | ~50 | ~80 | ~93 | ~110 | ~113 | ~124 | **~128** (+2 PE WF + 2 Opinion) |
-| Migrations | 0 | 1 | 3 | 4 | 5 | 5 | 5 | 8 | 11 | 11 | 12 | 13 | 14 | **15** (`AddPEDepartmentOpinions`) |
-| FE pages | 0 | 2 | 6 | 7 | 14 | 16 | 16 | ~20 | ~22 | ~23 | ~26 | ~26 | ~26 | **~31** (+5 Budget × 2 app + PeWorkflowsPage) |
-| FE components | — | — | — | — | — | — | — | many | many+ | +EditRowDialog | +PE 5-tab | +Compare section | — | **+Budget tabs/panel + PE OpinionBox + PE 4-section restructure** |
-| Scripts PS | 0 | 0 | 0 | 1 | 1 | 1 | 3 | 4 | 4 | 5 | 5 | 6 | 6 | 6 |
-| CI/CD workflow | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | **1+test gate+path filter+manual checkout** |
-| **Tests** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | **77** (54 Domain + 17 Infra + 6 PE WF Application) |
-| Docs | 10 | 13 | 14 | 24 | 26 | 30 | 35 | ~40 | ~42 | ~44 | ~46 | ~48 | ~50 | **~52** (+session log + Test plan) |
-| Demo data | 0 | 0 | empty | 0 | 0 | 0 | 0 | 0 | 5+3 | 15+8+7+13+4 | +PE 4 phiếu | +rebrand email | 30 user | 30 user |
-| Commits | 1 | 2 | 3 | 5 | 6 | 7 | 8 | ~25 | ~47 | ~52 | ~63 | ~70 | ~75 | **~82** (+6 session 5) |
+---
 
 ## 🚨 Blockers / risks
+- ⚠️ **Email SMTP chưa có** — blocker notification outbound
+- ⚠️ **Credentials trong chat** — rotate trước go-live thật
+- ⚠️ **SQL backup chưa auto** — risk data loss (script ready, chờ register)
+- ⚠️ **UAT real user chưa chạy** — risk edge-case bug
+- ⚠️ **Cert** `api.solutions.com.vn` expire ~2026-07-23 (auto-renew ~06-23)
 
-- ⚠️ **Email SMTP chưa có** — blocker cho notification outbound
-- ⚠️ **UAT real user chưa chạy** — risk phát sinh bug edge-case quan trọng
-- ⚠️ **Credentials leaked trong chat** — cần rotate trước go-live thật
-- ⚠️ **SQL backup không auto** — risk data loss nếu VPS crash
-- ⚠️ **Permission `Workflows.Read` cho non-admin** — cần grant để họ thấy menu Wf_* (hiện chỉ admin thấy)
-- ⚠️ **User-kind approver chưa enable runtime** — designer cho chọn User nhưng guard fall back DeptManager
-
-## Credentials + URLs
+---
 
+## 🔑 Credentials + URLs
 ```
-admin@solutionerp.local / Admin@123456
+Prod login: admin@solutions.com.vn / Admin@123456   (⚠️ rotate sau login đầu)
 ```
+- API prod `https://api.solutions.com.vn` (`/health/live` + `/health/ready`) · dev `http://localhost:5443` (`/swagger`)
+- Admin FE prod `https://admin.solutions.com.vn` · dev `:8082`
+- User FE prod `https://eoffice.solutions.com.vn` · dev `:8080`
+- Gitea `https://git.baocaogiaoduc.vn/vietreport-admin/solution-erp` · SSH `ssh vietreport-vps`
+- SQL prod `.\SQLEXPRESS` / `SolutionErp` · dev `(localdb)\MSSQLLocalDB` / `SolutionErp_Dev`
 
-- API prod: https://api.solutions.com.vn — Health `/health/live` + `/health/ready`
-- API dev: http://localhost:5443 — Swagger `/swagger`
-- Admin FE prod: https://admin.solutions.com.vn · dev `http://localhost:8082`
-- User FE prod: https://eoffice.solutions.com.vn · dev `http://localhost:8080`
-- SQL prod: `.\SQLEXPRESS` / `SolutionErp` / `vrapp`
-- SQL dev: `(localdb)\MSSQLLocalDB` / `SolutionErp_Dev`
+---
+
+> **Session history:** S0→S39 full detail trong `docs/changelog/sessions/` + `docs/_archive/STATUS-preS40-fullhistory.md`. File này chỉ giữ state hiện tại + 3 session gần nhất.
diff --git a/docs/_archive/HANDOFF-preS40-fullhistory.md b/docs/_archive/HANDOFF-preS40-fullhistory.md
new file mode 100644
index 0000000..4fddbc0
--- /dev/null
+++ b/docs/_archive/HANDOFF-preS40-fullhistory.md
@@ -0,0 +1,2683 @@
+# HANDOFF — Brief 5 phút cho session tiếp theo
+
+**Last updated:** 2026-05-29 (Session 39 — **⚙️ INFRA: Opus 4.8 1M default + Multi-agent 4→7 (BVAAU adapted) + budget +50%**)
+
+**S39 (2026-05-29):** Pure infra/governance — KHÔNG feature/schema. 1 commit `fd0554a` (docs-only CI skip).
+
+**⚠️⚠️ HÀNH ĐỘNG ĐẦU SESSION S40: ANH MAIN RESTART CLAUDE CODE CLI** (chưa restart S39 → registry vẫn 4 agent cũ). Post-restart verify smoke spawn 3 agent mới (investigator-api / implementer-frontend / test-specialist) confirm load OK trước khi dùng thật.
+
+**7 sub-agent mới (post-restart):**
+| Agent | Color | Scope | subagent_type |
+|---|---|---|---|
+| investigator-codebase | cyan | INTERNAL SQL/EF/grep/reference mirror | `investigator-codebase` |
+| investigator-api | blue | EXTERNAL docs/CVE/lib/cross-project | `investigator-api` |
+| implementer-backend | yellow | .NET Domain+App+Infra+Api | `implementer-backend` |
+| implementer-frontend | orange | FE 2 app cookie-cutter SHA256 mirror | `implementer-frontend` |
+| test-specialist | purple | tests/ dedicated xUnit | `test-specialist` |
+| reviewer | red | adversarial pre-commit + live curl | `reviewer` |
+| cicd-monitor | green | post-deploy Gitea + bundle + smoke | `cicd-monitor` |
+
+**Phân việc S40+ (chi tiết `.claude/agents/README.md`):** Read internal→investigator-codebase · Read external→investigator-api · WRITE .NET→implementer-backend · WRITE FE→implementer-frontend (parallel khi BE+FE independent, em main chốt DTO shape first) · test→test-specialist · pre-commit→reviewer · post-deploy→cicd-monitor. Budget +50% → lean delegate + parallel, ít em main solo (trừ schema/UX/cross-stack tight/gotcha #53-#55 fallback).
+
+**Model:** default Opus 4.8 1M (`~/.claude/settings.json` global 7 project) + 7 agent `model: inherit`. effortLevel max.
+
+**Tool grant:** all 7 agent có 5 RAG MCP (search_memory + search_code BM25 + cross_project_search + store_memory + list_projects).
+
+**2 gotcha NEW (#54 #55):** 529 Overload spawn fail → em main solo fallback · truncation mid-exploration → brief ≤8K + pre-supply reference snippet.
+
+**Memory rename:** agent-memory/ giờ 7 folder (investigator-codebase ← investigator history · implementer-backend ← implementer history · + 3 seed mới). Investigator MEMORY 32KB → cần curate đầu S40 (gotcha #53 risk).
+
+**⚠️ Drift defer cron 2026-06-01:** docs/CLAUDE.md root count (mig 33→40 · gotcha 52→55 · 4→7 agent · table 60→84) + schema-diagram §15+ (Mig 34-40 Phase 10 chưa thêm) + RAG re-ingest S37-S39 content (3076 chunks chưa có Proposal/WorkflowApps/7-agent).
+
+**Next S40 recommend (anh main pick):**
+1. **CLI restart + smoke verify 7 agent** (BẮT BUỘC first)
+2. **Curate Investigator MEMORY 32KB** (~10 phút em main proxy)
+3. **Phase 11 polish** — workflow ApproveV2 wire 5 skeleton module (Leave/OT/Travel/Vehicle + LevelOpinions) + LeaveBalance + Auto-assign + SLA timer — test-specialist write test-before bug fix
+4. **Phase 9 Ops** anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần production validation)
+5. **Test bundle coverage gap** (test-specialist: Gap 1 HrmConfig Holiday composite UNIQUE → Gap 3 gotcha #44 regression → Gap 2 EmployeeSatellite)
+6. **RAG re-ingest** S37-S39 content + cron audit 2026-06-01
+
+**Last updated S38 (prev):** 2026-05-28 (Session 38 — **🎊 PHASE 10 COMPLETE 11/11 Plan G-* atomic 100% DONE — SKELETON 5 plan combo deploy prod**)
+
+**S38 (2026-05-28):** Anh main "OK check lại plan nhé, xem còn gì ko thì finish cho xong luôn đi nhé" — em main pragmatic SKELETON aggressive 5 plan combo (G-O4+G-O5+G-O6+G-P1+G-H3) trong 1 session 1 commit mega. Cumulative end-to-end **1 commit** pushed remote `17aaba9..e54a22d` + **CI Run #247 PASS 3m25s** fastest S38 deploy.
+
+**Commit S38 (1 push):**
+1. `e54a22d` Mig 39+40 + BE mega ~1100 LOC + FE 5 file × 2 app SHA256 IDENTICAL + 11 MenuKey + 8 DbInit menu (Run #247 PASS 3m25s)
+
+**Multi-agent ROI S38 ~80K total (heavy em main solo dominant):**
+- 🟩 CICD 1 spawn ~12K (Run #247 PASS clean)
+- 👤 Em main solo ~68K HEAVY (Mig 39+40 design + BE 1100 LOC mega + FE 5 file × 2 + Permission + commit/push + docs wrap)
+- 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer SKIPPED (skeleton scope no critical risk + em main solo proven fast post S37 lessons learned)
+
+**SKELETON Phase 1 trade-off rõ ràng (defer Phase 11):**
+- Status flat 5-state WorkflowAppStatus share Leave/OT/Travel/Vehicle (NO ApproveV2 advance level)
+- LevelOpinions per-module DEFER (single table per module Phase 11)
+- LeaveBalance calc business logic DEFER
+- CodeGen atomic MaDonTu/MaTicket DEFER (NULL until Phase 11)
+- Vehicle catalog + Driver catalog DEFER (free text VehicleLicense)
+- ItTicketComments thread DEFER (free text Resolution)
+- Auto-assign round-robin + SLA timer DEFER
+- AttendanceReport admin + Excel export + OtPolicy multiplier DEFER
+
+**NEW capability prod S38 (end-to-end UAT-ready visible 100%):**
+- (a) Sidebar Văn phòng số 11 sub-menu (Đề xuất + Đơn từ × 3 + Đặt xe + Ticket CNTT + Chấm công) live
+- (b) Sidebar Nhân sự > Dashboard NS `/hr/dashboard` shows 4 KPI card (Tổng=33 / Active=33 / Sinh nhật 7d / Mới vào tháng) + gender ratio (Male=17 / Female=16) + status breakdown
+- (c) `/attendance` Web GPS check-in/out button live (geolocation API) + tháng calendar
+- (d) `/it-tickets` kanban 5-column status board (Mới/Đang xử lý/Đã giải quyết/Mở lại/Đã đóng)
+- (e) `/workflow-apps/{leave|ot|travel|vehicle}` declarative generic list table
+
+**Bundle hash rotation S38 (1 push):**
+- fe-admin: `CGueDk22` (S37) → `cWAXid0q` (Run #247)
+- fe-user: `CEt0QRgX` (S37) → `CX79e2kZ` (Run #247)
+
+**State chốt S38:**
+- 40 mig (+2 Mig 39+40) · 84 tables (+6 Workflow Apps) · ~223 endpoints (+13 skeleton)
+- 53 FE pages (+5 × 2 app) · 85 menu keys (+8)
+- **130 test PASS unchanged** (UAT mode)
+- **53 gotcha unchanged**
+- 27 memory user-level · 6 skills · 4 sub-agents
+
+**🎊 PHASE 10 COMPLETE — Plan G-* 11/11 atomic ALL DONE cumulative 6 session S33-S38:**
+- ✅ G-H1 Hồ sơ NS (S33) + G-O1 Danh bạ (S34) + G-H2 Cấu hình HRM (S34+S35)
+- ✅ G-O2 Phòng họp (S36) + G-O3 Đề xuất (S37)
+- ✅ G-O4 Đơn từ + G-O5 Đặt xe + G-O6 Ticket CNTT + G-P1 Chấm công + G-H3 Dashboard NS (S38 SKELETON combo)
+
+**Cumulative Phase 10 stats:**
+- 7 Mig (Mig 34→40) · 30+ new tables · ~75+ new endpoints · 17 FE pages × 2 app · 50+ menu keys
+- Pattern 16-bis 9× cumulative · Pattern 12-bis 12× cumulative · Smart Friend 9× clean
+- 6 commit cumulative push 6 CI Run all PASS (Run #237/#238/#240/#241/#242/#243/#244/#246/#247)
+
+**4 sub-agent reuse-able S39+ via fresh spawn:**
+- 🟦 Investigator last spawn `a4c81ef2f9a79a325` (S37 G-O3 pre-flight)
+- 🟨 Implementer last successful spawn `aabfc002a99339ab8` (S36 FE 2 app), 2 spawn S37 FAIL truncate/529
+- 🟥 Reviewer last spawn `a579fa4856eb45316` (S36 G-O2 Smart Friend 9× clean)
+- 🟩 CICD last spawn `a4ea874296872c2be` (S38 Run #247 PASS)
+
+**⚠️ Next session S39+ — recommendations:**
+1. **Phase 11 polish features** — workflow ApproveV2 wire per skeleton module (Leave/OT/Travel/Vehicle) + LevelOpinions table + CodeGen atomic. Spec defer commit message
+2. **LeaveBalance business logic** (Hrm_Config LeaveTypes + EmployeeProfile.HireDate seniority) — em main solo cross-stack tight
+3. **Vehicle catalog + Driver catalog** (Phase 11 Mig 41)
+4. **ItTicket Auto-assign + SLA timer** (reuse SlaTimer pattern Contract)
+5. **AttendanceReport admin + Excel export + OtPolicy multiplier** (Phase 11)
+6. **Test bundle G-O2..G-O3..G-O4 wire** (~30 phút Implementer Case 3) — defer until UAT confirm stable
+7. **Phase 9 Ops anh main coordinate** — SMTP + Rotate creds + UAT 2-3 user 1 tuần production validation
+
+**Defer S39+:**
+- Curate 4 MEMORY (CICD ~30KB post-Run #247 + Investigator borderline) ~10 phút
+- Skill audit cron `2026-06-01` (còn 4 ngày, cumulative drift mig 33→40, gotcha 52→53)
+- Test gate restoration sau UAT mode end
+
+**Last updated S37 (prev):** 2026-05-28 (Session 37 — **🎯 S37 Mig 37 enum extend + Plan G-O3 Đề xuất ALL DONE end-to-end deploy prod full-stack 1 commit**)
+
+**S37 (2026-05-28):** Anh main "OK làm tiếp đi nhé" Full batch 6 plan continuation. Cumulative end-to-end **1 commit** pushed remote `37593f9..de1c378` + **CI Run #246 PASS 3m53s**.
+
+**Commit S37 (1 push):**
+1. `de1c378` Mig 37 enum extend +5 values + Mig 38 Proposal schema + BE CQRS 700 LOC + FE 2 app SHA256 IDENTICAL (Run #246 PASS 3m53s)
+
+**Multi-agent ROI S37 ~225K total (lessons learned mitigation):**
+- 🟦 Investigator 1 spawn ~14K (G-O3 pre-flight — truncated mid-MEMORY size warning 29.6KB)
+- 🟨 Implementer 2 spawn FAIL (BE 150K wasted mid-EXPLORATION gotcha #53 5th + FE 0 token 529 Overload transient)
+- 🟩 CICD 1 spawn ~13K (Run #246 PASS clean)
+- 👤 Em main solo ~50K HEAVY (Mig 37+38 schema + BE 700 LOC + FE 4 file × 2 + 6 mod + commit/push + docs wrap)
+- 🟥 Reviewer SKIPPED (PE pattern proven 11× + test gate PASS + em main solo BE đảm bảo)
+
+**Smart Friend 0 catch S37 — em main solo bypass:**
+- Schema design correct first try (FK strategy + UNIQUE composite + ProposalCodeSequence Prefix PK)
+- ApproveV2Async logic mirror PE pattern exact (match ApproverUserId actor + admin fallback + UPSERT + advance level/terminal)
+- SeedSampleProposalWorkflowV2Async NOT gated DemoSeed (gotcha #51 compliance learned S29)
+- FE PageHeader signature drift caught + fixed (no icon prop, use `actions=ReactNode`)
+
+**NEW capability prod S37 (end-to-end UAT-ready):**
+- (a) Sidebar Văn phòng số > Đề xuất `/proposals` shows table 6 cột + status badge 5 màu + filter
+- (b) `/proposals/new` form Header + ApprovalWorkflow Select pick `QT-DX-V2-001` → Submit → POST + auto-gen `DX/2026/001` atomic SERIALIZABLE tx
+- (c) `/proposals/{id}` 3 Section + WorkflowActions buttons (Submit/Approve/Reject/Return + Comment Dialog) + Section 3 Ý kiến cấp duyệt V2 dynamic UPSERT
+
+**Bundle hash rotation S37 (1 push):**
+- fe-admin: `C9kzTTmq` (S36) → `CGueDk22` (Run #246)
+- fe-user: `CC4DQ-Tr` (S36) → `CEt0QRgX` (Run #246)
+
+**State chốt S37:**
+- 38 mig (+2 Mig 37+38) · 78 tables (+4 Proposal stack) · ~210 endpoints (+8 Proposal)
+- 48 FE pages (+3 × 2 app) · 77 menu keys (+4 Off_DeXuat)
+- **130 test PASS unchanged** (UAT mode)
+- **53 gotcha unchanged** (#53 5th + 529 Overload noted commit only)
+- 27 memory user-level · 6 skills · 4 sub-agents (Investigator MEMORY 29.6KB borderline)
+
+**2 NEW lessons S37 cumulative (em main solo proven fallback):**
+- gotcha #53 5th — Implementer truncated mid-EXPLORATION phase ngay đầu (heavy spec brief ~10K too risky → tight ≤ 6K hoặc em main solo)
+- 529 Overload Anthropic API 1× S37 (S29 đã có 2× — pattern: spawn agent CÓ THỂ fail 0 token, em main MUST có fallback path solo cho critical task)
+
+**4 sub-agent reuse-able S38 via fresh spawn (agentId S37 invalid post-session-end):**
+- 🟦 Investigator last spawn `a4c81ef2f9a79a325` (S37 G-O3 pre-flight)
+- 🟨 Implementer last 2 spawn FAIL (`a3afd177462addaa2` BE truncated + `a590c5c833dc05a1f` FE 529)
+- 🟩 CICD last spawn `ab127ae9929ce6ed7` (S37 Run #246 PASS)
+- 🟥 Reviewer not invoked S37
+
+**⚠️ Next session S38 — sequence em chốt Full batch S37→S41 continued:**
+1. **Plan G-O4 Đơn từ Mig 39** (~5-6h em main solo recommend) — 3 entity (LeaveRequest + OtRequest + TravelRequest) + LeaveBalance business logic + workflow V2 enum +5/+6 reuse (Mig 37 đã extend). Cookie-cutter mirror Proposal G-O3 pattern. **FALLBACK Implementer Case 2 ×3 spawn parallel** nếu API stable + tight brief ≤ 5K
+2. **CICD post-deploy verify Run + bundle rotate**
+
+**Defer recommendations S38+:**
+- Curate 4 MEMORY (Investigator 29.6KB borderline post-S37) ~10 phút em main proxy
+- Test bundle G-O3 (~30 phút) — ApproveV2 + CodeGen + workflow guard
+- Phase 9 Ops anh main coordinate (SMTP + Rotate creds + UAT)
+
+**Last updated S36 (prev):** 2026-05-28 (Session 36 — **🎯 S36 Plan G-O2 Phòng họp ALL DONE end-to-end deploy prod BE+FE combo 1 commit**)
+
+**S36 (2026-05-28):** Anh main chốt **Full batch 6 plan** ~25-31h spread 6 session (G-O2 + G-O3 + G-O4 + G-O5 + G-O6 + G-H3). S36 kick off Plan G-O2 standalone độc lập NOT depend workflow V2 enum extend. Cumulative end-to-end **1 commit** push remote `8afdc1e..f45090b` + **CI Run #359 PASS 3m55s**.
+
+**Commit S36 (1 push):**
+1. `f45090b` BE Mig 36 + CQRS 584 LOC + FE 2 app 1770 LOC combo deploy (Run #359 PASS 3m55s)
+
+**Multi-agent ROI S36 ~225K total:**
+- 🟦 Investigator 2 spawn ~22K (startup + G-O2 pre-flight: clean-room verdict + FullCalendar v6 alternative)
+- 🟨 Implementer 2 spawn ~67K (BE CQRS + FE 2 app — gotcha #53 4th truncation BE diagnose only, FE clean)
+- 🟥 Reviewer 2 spawn ~110K (startup + G-O2 review Smart Friend 9× cumulative CLEAN 3 minor defer)
+- 🟩 CICD 2 spawn ~25K (startup + Run #359 verify ALL PASS)
+- 👤 Em main solo ~50K (curate 2 MEMORY + Mig 36 schema + Application.csproj +Relational + commit/push + docs wrap)
+
+**Smart Friend 0 critical catch S36 (9× cumulative clean):**
+- BE Schema design correct first try (FK strategy + UNIQUE composite + index Room/StartAt range query)
+- BE Validator MaxLength match EF config (Pattern 12-bis 10× cumulative — S35 lesson learned)
+- BE SeedMeetingRoomsAsync NOT gated DemoSeed (gotcha #51 compliance)
+- BE Owner-OR-admin authorization Update/Cancel (no gotcha #44 pattern)
+- BE SERIALIZABLE transaction + exclude self overlap (Cat 3 PASS minor caveat Room race defer)
+- FE Layout staticMap 3 entry mirror Pattern 16-bis 7× (gotcha #50 prevention)
+- FE SHA256 IDENTICAL × 2 app 3 file pair verified
+
+**NEW capability prod S36 (end-to-end UAT-ready):**
+- (a) Sidebar Văn phòng số > Phòng họp `/meeting-calendar` shows 7-day grid 8h-20h slot + click slot → Dialog create booking (Phòng dropdown 4 sample + Attendees multi-select + Title/Description/Note + Auto overlap check 409 detect "Phòng đã được đặt trong khoảng thời gian này")
+- (b) Admin `/meeting-rooms` catalog CRUD table 4 sample room (PH-A Phòng họp lớn cap=20 + PH-B nhỏ cap=8 + PHG-501 Giám đốc cap=6 + ONL-1 Online Zoom cap=50)
+
+**Bundle hash rotation S36 (1 push):**
+- fe-admin: `Bl6e54yi` (S35) → `C9kzTTmq` (Run #359)
+- fe-user: `DHmW2tUF` (S35) → `CC4DQ-Tr` (Run #359)
+
+**State chốt S36:**
+- 36 mig (+1 Mig 36) · 74 tables (+3 MeetingRoom+Booking+Attendees) · ~201 endpoints (+9 Meeting)
+- 45 FE pages (+2 × 2 app) · 73 menu keys (+4 Off_PhongHop+leaf)
+- **130 test PASS unchanged** (UAT mode, test bundle defer ~30 phút Implementer Case 3)
+- **53 gotcha unchanged** (#53 4th occurrence noted commit only)
+- 27 memory user-level · 6 skills · 4 sub-agents (post-curate Implementer 31.7KB + CICD 28.3KB acceptable)
+
+**4 sub-agent reuse-able S37 via fresh spawn (agentId S36 invalid post-session-end):**
+- 🟦 Investigator last spawn `a7bbd88513157f3a6` (S36 G-O2 pre-flight)
+- 🟨 Implementer last spawn `aabfc002a99339ab8` (S36 FE 2 app — 0 truncation tight brief WORK)
+- 🟥 Reviewer last spawn `a579fa4856eb45316` (S36 G-O2 Smart Friend 9× clean)
+- 🟩 CICD last spawn `a915996c2b0c24698` (S36 Run #359 PASS)
+
+**⚠️ Next session S37 — sequence em chốt Full batch S36→S42 cumulative:**
+1. **Plan 10.3 Pre-flight Mig 37 enum extend** (~1h em main solo) — extend `ApprovalWorkflowApplicableType` enum +5 values (ProposalGeneral=4 / LeaveRequest=5 / OtRequest=6 / VehicleBooking=7 / ItTicket=8) cookie-cutter Mig 22 pattern. UNBLOCK G-O3-O6 Workflow Apps.
+2. **Plan G-O3 Đề xuất Mig 38** (~4-5h Implementer Case 2 mirror PE Plan B pattern 12-bis cross-module entity scaffold + ApproveV2Async branch + CodeGen `DX/YYYY/NNN` business logic tight em main solo)
+3. **Reviewer Smart Friend pre-commit Cat 1-6 + CICD post-deploy Run verify**
+
+**Defer recommendations S37+:**
+- Test bundle G-O2 (~30 phút Implementer Case 3) — Code uniqueness + overlap check 409 + Cancel preserve history + AttendeeInput owner-only update
+- 3 minor defer Reviewer (AttendeeInput.Notes validator MaxLength + Room IsActive race window + silent skip unknown UserId)
+- Phase 9 Ops anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần) — still blocked
+
+**Last updated S35 (prev):** 2026-05-28 (Session 35 — **🎯 S35 3 chunk push ALL DONE deploy prod: FE inline forms 5 satellite + G-H2 BE CRUD 16 endpoint + G-H2 FE Admin HrmConfigsPage declarative**)
+
+**S35 (2026-05-28):** Anh main authorize Option A "FE forms + G-H2 BE+FE combo" sequence + "warm-up Implementer + CICD". Cumulative end-to-end **3 commit** pushed remote `63dd9ec..021674a` + **3 CI Run ALL PASS** (#242 + #243 + #244).
+
+**Commits S35 (3 push):**
+1. `c3cd343` Chunk 1 — FE inline forms 5 satellite × 2 app (+1758 LOC, Run #242 PASS 3m30s)
+2. `909655c` Chunk 2 — G-H2 BE CRUD HrmConfig 16 endpoint (+576 LOC NEW, Run #243 PASS 3m43s)
+3. `021674a` Chunk 3 — G-H2 FE Admin HrmConfigsPage declarative (+1388 LOC, Run #244 PASS 3m38s em main fallback verify)
+
+**Multi-agent ROI S35 ~250K:**
+- 🟨 Implementer 3 spawn ~80K (3 cookie-cutter chunk + Smart Friend × 3 catch S35)
+- 🟦 Investigator 1 spawn ~8K (Plan G-H2 BE CRUD pre-flight: NamGroup MISS verdict — SOL clean-room mạnh hơn)
+- 🟥 Reviewer 3 spawn ~60K (Smart Friend 9× cumulative clean: 2 truncated mid-MEMORY-update, 1 tight brief PASS clean)
+- 🟩 CICD 4 spawn ~70K (Run #241 warm-up + #242 + #243 PASS + #244 stalled em main fallback)
+
+**Smart Friend Implementer 3 catch S35 (Pattern preserved):**
+1. Chunk 2 MaxLength validator vs EF config mismatch → aligned to EF source-of-truth (LeaveType/OtPolicy Code=50, Name=200, Description=500)
+2. Chunk 2 HRM entities NO HasQueryFilter (vs Master 9 file have) → explicit `.Where(!IsDeleted)` 8 List/Conflict-check site
+3. Chunk 3 em main spec line 24 GAP: Layout staticMap "no resolve issue" — WRONG. Implementer verified `MenuItem.cs` NO Url field + `resolvePath()` regex chỉ match `Ct_*/Wf_*/Pe_*/PeWf_*/AwV2_*` → silent sidebar drop gotcha #50. Enforced staticMap mirror Pattern 16-bis 6× cumulative
+
+**NEW capability prod S35 (end-to-end UAT-ready):**
+- (a) Admin login `eoffice.solutions.com.vn/employees` → pick NV/2026/0007 → Section 2-6 (Công tác/Đào tạo/Thân nhân/Kỹ năng/Hồ sơ) inline `+ Thêm` button expand AddForm + per-row Pencil/Trash. 15 BE endpoint wire CRUD live.
+- (b) Admin login `eoffice.solutions.com.vn/hrm/configs/leave-types` → 4 sub-tab + table 5 row LeaveType seed + Dialog modal CRUD `+ Thêm`. Switch tab → /hrm/configs/holidays (10 row) → /shifts (3 row) → /ot-policies (1 row). 16 BE endpoint wire CRUD live.
+
+**NEW gotcha #53 sub-agent truncation/stall pattern S35 × 3 occurrence:**
+- Reviewer FE forms (push #1) cut mid-Cat-1 after "PERFECT"
+- Reviewer BE CRUD (push #2) cut mid-MEMORY trim
+- CICD Run #244 verify (push #3) stalled 600s watchdog after VPS mtime cross-check
+- Mitigation verified: tight brief ≤ 8K (Reviewer FE Admin chunk 3 PASS clean no truncation 5K return)
+- Em main grep verify manual Cat 2-6 + commit confidence preserved
+
+**State chốt S35:**
+- 35 mig unchanged · 71 tables unchanged · ~185 endpoints (+16 HRM Configs)
+- 43 FE pages (+1 HrmConfigsPage) · 69 menu keys unchanged
+- **130 test PASS unchanged** (UAT mode no test add 3 chunk)
+- **53 gotcha (+1 #53)** · 27 memory user-level · 6 skills · 4 sub-agents
+
+**Bundle hash rotation S35 cumulative:**
+- fe-admin: `RNTX6Fvo` (Run #241 start) → `BhR0MmLN` (Run #242) → `BhR0MmLN` (Run #243 BE unchanged) → `Bl6e54yi` (Run #244)
+- fe-user: `29A1LuMm` → `DIdNaB6W` → `DIdNaB6W` → `DHmW2tUF`
+
+**4 sub-agent reuse-able S36 via fresh spawn (agentId S35 invalid post-session-end):**
+- 🟦 Investigator last spawn `a42bd882c367f6e47` (S35 G-H2 BE CRUD audit)
+- 🟨 Implementer last spawn `a1aeda2fcbbc19eeb` (S35 G-H2 FE Admin)
+- 🟥 Reviewer last spawn `a6b42cc3c1423e699` (S35 G-H2 FE Admin tight 5K PASS)
+- 🟩 CICD last spawn `a3dfb05e2deee8f0f` (S35 Run #244 stalled mid-MEMORY)
+
+**⚠️ Next session S36 — anh main pick:**
+1. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — FullCalendar lib NEW dep) — standalone tiếp Phase 10.2 Office
+2. **Phase 10.3 G-O3-O6 Workflow Apps** (4 plan đề xuất nghỉ phép/đăng ký OT/đăng ký công tác/dự án — depends G-H2 catalog ready)
+3. **Phase 9 Ops** anh main coordinate (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
+4. **Curate 4 MEMORY post-S35 spawn** (Reviewer + CICD borderline) ~20 phút em main proxy
+5. **Test bundle G-H2 BE CRUD** (~30 phút Implementer Case 3 — codeGen UNIQUE Conflict + composite Year+Date + soft delete restore)
+6. **Audit cron 2026-06-01** (còn 4 ngày — cumulative skill + doc drift mig 33→35, test 111→130, gotcha 52→53)
+
+**Recommend sequence S36:**
+1. Curate 4 MEMORY (~20 phút) — clear context before heavy work S36
+2. Plan G-O2 Phòng họp BookingCalendar (~3-4h) — standalone independent
+3. Plan G-O3-O6 Workflow Apps batch (~6-8h) — series workflow app reuse V2
+
+**Last updated S34 FULL (prev):** 2026-05-27 (Session 34 FULL — **🎯 Plan 1+2+3+4 ALL DONE: Curate + G-O1 Danh bạ + Phase 1.5 batch 6/6 + G-H2 Mig 35 schema foundation. BE CRUD + FE forms HrmConfig defer S35**)
+
+**S34 FULL (2026-05-27):** Anh main authorize "1 → 2 → 3 → 4" sequence sau S34 init + "OK làm tiếp đi nhé" tiếp Plan 4. Cumulative end-to-end **6 commit** pushed remote `edba4ae..07b3f3b` + 4 CI Run (#238/#239/#240 PASS + #241 Plan 4 Mig 35 pending verify).
+
+**Commits S34 (6 push):**
+1. `7b0781b` Plan 1 Curate 4 MEMORY (-15% docs CI skip)
+2. `ea440da` Plan 2 G-O1 BE+FE Danh bạ (Run #238 PASS)
+3. `61e9ce5` Plan 3 Phase 1.5 batch 4 item (Run #239 PASS — +10 [Fact] 130 PASS)
+4. `57099c5` Docs S34 batch 1+2+3 wrap (docs CI skip)
+5. `e506cd8` Plan 3 Item 3 BE 5 satellite CRUD scaffold (Run #240 PASS — +15 endpoint)
+6. `07b3f3b` Plan 4 G-H2 Mig 35 + 4 entity + 4 EF Config + seed 19 row + 4 menu (Run #241 verify pending)
+
+**Multi-agent ROI S34 ~150K:**
+- 🟨 Implementer 3 spawn ~80K (Plan 2 FE 2 app + Plan 3 Item 4 test bundle + Plan 3 Item 3 BE 5 satellite Case 2)
+- 🟩 CICD 2 spawn ~40K (Run #238 full verify + Run #239 partial)
+- 👤 em main solo ~30K (BE Plan 2 + Phase 1.5 items 6+2+1+5 + Plan 4 Mig 35 + commit/push 6 batch + UAT smoke + docs wrap)
+- 🟦 Investigator + 🟥 Reviewer: 0 spawn S34
+
+**Plan 4 G-H2 Mig 35 schema deployed (BE CRUD + FE forms defer S35):**
+- 4 entity HRM catalog: LeaveType + Holiday + ShiftPattern + OtPolicy
+- 4 EF Config với UNIQUE indexes (Code unique cho 3 + Year+Date composite cho Holiday)
+- DbInitializer `SeedHrmConfigsAsync` 19 sample row seed (5 LeaveType + 10 Holiday VN 2026 + 3 Shift + 1 OtPolicy STANDARD)
+- MenuKeys `HrmConfig` sub-group + 4 leaf seeded (LeaveTypes/Holidays/Shifts/OtPolicies)
+- FE 2 app menuKeys sync 5 const mirror
+
+**⚠️ Next session S35 — anh main pick:**
+1. **Plan G-H2 Task 3+4 BE CRUD 4 catalog + FE Admin 4 page** (~3-4h Implementer Case 2 cookie-cutter cookie-cutter mirror EmployeeSatelliteFeatures + SOL Catalogs pattern Plan CA Chunk B)
+2. **FE inline forms 5 satellite section** (~1.5h em main solo — Phase 1.5 Item 3 FE remainder)
+3. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — FullCalendar lib new dep)
+4. **Test bundle satellite CRUD** (~30 phút Implementer Case 3 — test endpoint Create UNIQUE + Update partial + soft delete)
+5. **Curate 4 MEMORY again** (CICD + Implementer borderline post-S34 spawn entries)
+6. **Anh main coordinate Phase 9 Ops** (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
+
+**4 sub-agent reuse-able S35:**
+- 🟦 Investigator `afaf6d52a6a59a844` (idle S34)
+- 🟨 Implementer `a5b7154286dad03f5` (last spawn Plan 3 Item 3 BE 5 satellite — NEW agentId S34)
+- 🟥 Reviewer `a0aa13093d14f3bca` (idle S34, no spawn S34)
+- 🟩 CICD `a520665a07ea4e8c4` (last spawn Plan 3 partial)
+
+**Last updated S34 batch 1+2+3 (initial wrap):** 2026-05-27 (Session 34 — **🎯 Plan 1 Curate + Plan 2 G-O1 Danh bạ + Plan 3 Phase 1.5 batch (5/6) deploy prod end-to-end. Plan 4 G-H2 + Item 3 Satellite defer S35**)
+
+**S34 (2026-05-27):** Anh main authorize "1 → 2 → 3 → 4" sequence sau S34 init 10 mục report. Cumulative end-to-end 3 commit pushed remote `edba4ae..61e9ce5` + 2 CI Run PASS (#238 G-O1 3m30s + #239 Phase 1.5 3m48s).
+
+**Multi-agent ROI S34 ~95K:**
+- 🟨 Implementer 2 spawn ~50K (G-O1 FE 2 app cookie-cutter mirror SHA256 IDENTICAL × 2 + Phase 1.5 Item 4 test bundle Case 3 +10 [Fact])
+- 🟩 CICD 2 spawn ~40K (Run #238 Plan 2 G-O1 full verify + Run #239 Plan 3 batch partial → em main fallback manual smoke)
+- Em main solo ~5K direct UAT smoke admin vs nv.test gotcha #44 verify
+- 🟦 Investigator + 🟥 Reviewer: 0 spawn S34 (chưa cần — Implementer Case 2+3 + em main solo đủ)
+
+**Plan 1 Curate 4 MEMORY** (~30 phút em main proxy):
+- CICD: 32.9KB → 27.3KB → 30.9KB post-Run #238 entry (curate again next session)
+- Implementer: 30.5KB → 24.6KB → 28KB post-Plan 3 entry
+- Investigator: 26KB → 21.8KB ✅
+- Reviewer: 28.5KB → 25.7KB ✅
+- 4 archive q3.md mới (Reviewer q2.md vì lần đầu có q2)
+
+**Plan 2 G-O1 Danh bạ nội bộ (~1.5h) — NEW capability prod:**
+- `GET /api/directory` LEFT JOIN Users + EmployeeProfiles + Departments
+- Sidebar Văn phòng số > Danh bạ → /directory card grid 34 user
+- Avatar PALETTE 6 màu + filter dept dropdown + search name/email/phone/code
+- Email mailto + phone tel click-to-call + Ext: badge
+- `Off` + `OffDanhBa` MenuKeys Order=29 root + Order=1 leaf
+
+**Plan 3 Phase 1.5 batch 5/6 item:**
+- Item 6 menuKeys × 2 app FULL sync mirror BE 28 key cumulative ✅
+- Item 2 UpdateEmployeeProfileCommand 3 bool→bool? safe partial update ✅
+- Item 1 EmployeesController per-action policy Hrm_HoSo.{Read|Create|Update|Delete} ✅
+- Item 4 test bundle +10 [Fact] 120→130 PASS ✅
+- Item 5 UAT smoke nv.test 403 /api/employees (gotcha #44 ACTIVE) + 200 /api/directory ✅
+- ⏸️ Item 3 Satellite CRUD endpoints + FE forms (~2-3h heavy) — DEFER S35
+
+**Plan 4 G-H2 Cấu hình HRM** (~3-4h Mig 35) — **DEFER S35** (sequence cuối — em main reach realistic capacity)
+
+**4 sub-agent reuse-able next session via SendMessage:**
+- 🟦 Investigator `afaf6d52a6a59a844` (idle S34, last activity S33 t1 NamGroup audit)
+- 🟨 Implementer `ad60dcfc154bdbbc4` (NEW S34 test bundle spawn agentId, last activity Plan 3 Item 4)
+- 🟥 Reviewer `a0aa13093d14f3bca` (idle S34, last activity S33)
+- 🟩 CICD `a520665a07ea4e8c4` (NEW S34 Run #239 verify partial agentId — may continue via SendMessage)
+
+**⚠️ Next session S35 — anh main pick:**
+1. **Item 3 Satellite CRUD endpoints + FE forms** (~2-3h) — round out Phase 1.5 G-H1 Phase 1
+2. **Plan 4 G-H2 Cấu hình HRM** (~3-4h Mig 35 LeaveTypes + Holidays + ShiftPatterns + OtPolicy 4 catalog)
+3. **Plan G-O2 Phòng họp BookingCalendar** (~3-4h Mig 36 — depends FullCalendar lib new dep)
+4. **Curate 4 MEMORY again** (CICD 30.9KB + Implementer 28KB borderline post-S34 spawn entries)
+5. **Anh main coordinate Phase 9 Ops hard blockers** (SMTP + Rotate creds + UAT 2-3 user 1 tuần)
+
+**Recommend sequence S35:**
+1. Item 3 Satellite CRUD (~2h) — close Phase 1.5 properly trước khi mở Cấu hình HRM
+2. Plan 4 G-H2 (~3h) — prerequisite cho G-O3-O6 Workflow Apps
+3. Curate 4 MEMORY (~15 phút mid-session) nếu over 25KB
+
+**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD + Plan C B-Wrap +9 tests + Drift patch**)
+
+**S33 (2026-05-26):** Anh main authorize "Plan cha B và Plan cha C" + "OK commit, push" + "Pending Plan B G-H1 Phase 2 làm đi nhé". Cumulative end-to-end 7 commit pushed remote `5400983..79a8343` + 2 CI Run PASS (#350 Phase 1 + #237 Phase 2). **Phase 10.1 G-H1 UNBLOCK 8/11 module sau** (G-H2/G-O1-O6/G-H3/G-P1 ready depend EmployeeProfile data).
+
+**Multi-agent ROI S33:**
+- 🟦 Investigator 2 spawn ~20K: S33 startup audit (MEMORY size + RAG verify 2/3 PASS) + Plan B Task 1 NamGroup TblNhanVien* 10 bảng audit (NOT 8 anh estimate) + field map 70 cols main + 5 satellite proposal
+- 🟨 Implementer 4 spawn ~110K Case 2 cookie-cutter: Plan B Task 3 BE entity 17 file + Task 4 BE CQRS 3 file + Task 5 FE 2 app 12 file SHA256 IDENTICAL + Plan C BW1-BW7 3 test file
+- 🟥 Reviewer 3 spawn ~60K Smart Friend 6× clean: S33 startup drift severity + Plan C BW pre-commit + Plan B Phase 2 pre-commit (0 critical/major, 3 minor defer Phase 1.5)
+- 🟩 CICD 3 spawn ~60K: S33 startup HEALTHY + Run #350 Phase 1 PASS 3m38s (Mig 34 + 33 EmployeeProfiles seeded + endpoint smoke + gotcha #51 verified) + Run #237 Phase 2 PASS 3m50s (5 NEW employee endpoint + Hrm menu seeded + bundle rotate × 2)
+
+**Em main solo S33:** Task 2 Mig 34 schema design (4 decision: 5 satellite/Skill polymorphic/DiaChi dual-write/MaNhanVien NV/YYYY/NNNN) + Task 3b DbInitializer SeedDemoEmployeeProfilesAsync ~90 LOC (NOT gated DemoSeed flag per gotcha #51) + Task 6 Permission menu MenuKeys+SeedMenuTreeAsync 2 edit + 3 commit batch + push.
+
+**NEW capability prod (UAT-ready):**
+- Sidebar menu "Nhân sự" > "Hồ sơ Nhân sự" mở /employees
+- 33 EmployeeProfile sample seeded `NV/2026/0001..0033` (1 admin + 30 demo + 2 catalog.manager)
+- Sample: `NV/2026/0007 BOD 1 - Director / Ban Giám đốc / Active / hireDate=2021-08-01`
+- CreatePage form Header minimal (UserId picker + status + birthday + gender + phone + hire date)
+- 6-section inline collapsible detail (Cơ bản/Công tác/Đào tạo/Thân nhân/Kỹ năng/Hồ sơ)
+- Phase 1 read-only satellite, edit Header defer Phase 1.5
+
+**Implementer truncation pattern observation 2/3 (NEW lesson S33):**
+- Task 3 + Task 4 heavy scaffold ~50+ tool uses → MEMORY update mid-sentence cutoff
+- Task 5 clean (smaller scaffold ~10 file under same budget)
+- Functional work complete despite truncation (em main verify via file existence + build + test post-spawn)
+- Mitigation cross-project: Implementer split heavy task ≥30 file → 2 phase (scaffold + MEMORY update separate budget reserve)
+- Em main proxy MEMORY append next session (Pattern 12-bis foundation S29 still in place, no critical knowledge loss)
+
+**4 MEMORY status post-S33 (CURATE priority next session):**
+- CICD: 32.9 KB OVER 25KB hard threshold (32.9-25=7.9 KB excess)
+- Implementer: 30.5 KB OVER
+- Reviewer: 28.5 KB borderline
+- Investigator: 26 KB borderline
+- Cumulative ~118 KB / 100 KB rolling budget
+- Recommend dedicated curate session next time (~30 phút Plan A3 mirror S32 pattern)
+
+**Defer Phase 1.5 backlog (per Reviewer 3 minor + CICD recommend):**
+1. Per-action policy `Hrm_HoSo_View/Create/Edit/Delete` wire (gotcha #44 mitigation)
+2. Convert 3 bool field UpdateCommand → `bool?` safe partial update
+3. Satellite CRUD endpoint (WorkHistory/Education/FamilyRelation/Skill/Document) + edit forms FE
+4. Test bundle Plan B Phase 2 (Create UNIQUE conflict + List filter + codeGen race)
+5. UAT smoke non-admin role verify silent 403 catch
+6. fe-admin menuKeys.ts add Bg_*/Catalog* sync với fe-user (drift not blocking)
+
+**⚠️ Next session S34 — anh main pick:**
+1. **Phase 1.5 backlog** (6 item above) — 1-2h dedicated session
+2. **Phase 10.1 G-H2** Cấu hình HRM (Mig 35 LeaveTypes + Holidays + ShiftPatterns + OtPolicy 4 catalog) ~3-4h
+3. **Phase 10.2 G-O1** Danh bạ nội bộ (reuse Users + EmployeeProfile + Departments, 1 endpoint + FE card grid) ~2-3h — easiest standalone, no workflow
+4. **Curate 4 MEMORY sub-agent** (~30 phút) trước khi heavy work khác — avoid context bloat
+5. **Update CLAUDE.md state numbers** drift S33 (mig 33→34, table 60→67, test 111→120) bundle batch 2026-06-01 audit cycle
+
+**Recommend sequence S34:**
+1. Curate 4 MEMORY (~30 phút) first — clear context for next plan
+2. G-O1 Danh bạ (~2h) standalone easy win
+3. G-H2 Cấu hình HRM (~4h) prerequisite cho G-O3-O6 workflow apps
+
+**S32 (2026-05-26):** Anh main yêu cầu plan kỹ NamGroup 11 module port → SOL (NHÂN SỰ 3 + VĂN PHÒNG SỐ 6 + CÁ NHÂN 1). 4 quyết định AskUserQuestion: FULL 11 module + single schema `dbo` Mig 34-42 + reuse Workflow V2 enum +5 values + chunk per-module Plan riêng. Document Phase 10 backlog detailed migration-todos.md với 10 Plan G-* atomic (G-H1 + G-H2 / G-O1 + G-O2 / G-O3-O6 / G-H3 + G-P1). Stats target Phase 10 end: 33→42 mig, 60→85 tables, 148→250 endpoints, 38→60 FE pages, 14→18 AppRoles, 60→110 permission menu, 111→200 tests.
+
+**Phase 9 stabilize batch done sequential anh main "finish hết":**
+- **Plan A2** ✅ RAG re-ingest 2949→2988 chunks (166 files, 75.7s). Gotcha #52 rerank 0.516→0.906 verify.
+- **Plan A3** ✅ MEMORY curate 3 agents OVER 25KB: Implementer 38.4→27.5KB (Patterns 1-19+12-bis+16-bis foundation preserved, 5 verbose S25-S29 archived q2) + Investigator 27.7→19KB (4 verbose S25-S26-S29 archived q2) + CICD 27→24.2KB (Run #231 PARTIAL detail archived q2). Reviewer 24.39KB unchanged (self-curated S32 startup earlier).
+- **Plan B-Wrap** ✅ Spec BW1-BW7 documented detailed migration-todos D-Bis section. Implementation **defer dedicated session ~2h** chốt anh main S32 (test infra IChangelogService + IContractCodeGenerator mocks first-time).
+- **Plan C1** ✅ Ops status update: backup-sql.ps1 ready (register Task Scheduler manual cmd documented). win-acme cert api.solutions.com.vn notAfter `2026-07-23` (not 2026-06-18 stale). SMTP + rotate creds BLOCKED chờ anh main coordinate.
+
+**4 commits S32 push remote (all docs-only CI skip per #41):**
+1. `b832f43` Phase 10 backlog Plan G + 4 sub-agent S32 startup MEMORY entries
+2. `cce0963` Phase 9 stabilize batch (Plan A3 curate + B-Wrap spec + C1 ops)
+3. + 2 earlier `f938bf5` (S31 docs patch) + `1e1c9a2` (S31 RAG baseline)
+
+**4 sub-agent reuse-able next session via SendMessage (if tool available):**
+- 🟦 Investigator `afaf6d52a6a59a844`
+- 🟨 Implementer `ab23cc322b5d495c0`
+- 🟥 Reviewer `a0aa13093d14f3bca`
+- 🟩 CICD Monitor `a505a02d84fc1fabe`
+
+**⚠️ Next session S33 — Phase 10.1 G-H1 Hồ sơ NS kick off:**
+1. Spawn Investigator pre-flight audit NamGroup `TblNhanVien*` 8 bảng (`D:\Dropbox\CONG_VIEC\NAMGROUP\SOURCECODE_CÔNG_TY\NAMGROUP\NAMGROUP.Server\Data\Entities\`) + map fields → SOL EmployeeProfile schema (~30 phút)
+2. Em main design Mig 34 `AddEmployeeProfiles` schema (1 main + 5 satellite: WorkHistory/Education/FamilyRelation/Skill/Document)
+3. Implementer Case 2 cookie-cutter BE entity scaffold 6 entity + EF Config + DbInitializer seed 30 demo profile mirror 30 users
+4. Implementer Case 2 mirror PE handler BE CQRS + 6 endpoint controller
+5. Implementer Case 2 cookie-cutter mirror PE FE 2 app EmployeesPage 3-panel + EmployeeDetailTabs (6 section)
+6. Em main solo Permission menu `Hrm_HoSo*` + Permission Matrix seed
+7. Reviewer pre-commit + CICD Monitor post-deploy verify
+
+**Anh main coordinate Phase 9 ops trong meantime:**
+- SMTP host/user/pass → appsettings.Production.json
+- Rotate creds plan approve cycle (admin + 30 demo + SA + vrapp + JWT secret + Gitea runner)
+- Register Task Scheduler SQL backup `ssh vietreport-vps "Register-ScheduledTask -TaskName SolutionErpBackupDaily ..."`
+- UAT 2-3 user 1 tuần
+
+**Last updated S31 (prev):** 2026-05-26 (Session 31 — **🎯 RAG v1.3 Baseline PASS + retrieval.py fix**)
+
+**S30 (2026-05-26):** Setup RAG Framework v1.3 governance + eval framework. Bootstrap 2949 chunks (164 files). Golden set v1.1 14 queries. Baseline v1.0=0.455 FAIL. v1.1 tentative=0.364 (MCP stale — vector broken). Commit b223466 (docs-only, CI skip).
+
+**S31 (2026-05-26):** Diagnose vector search broken: qdrant-client 1.18 removed search() → AttributeError silently swallowed. Fix retrieval.py: search()→query_points().points. Re-run eval: **recall@5=1.000 (11/11) PASS** avg_rerank=0.847. Quality gate PASS. Gotcha #52 added. STATUS/HANDOFF updated.
+
+**⚠️ S31 CRITICAL caveat (resolved S32):** CLI restart required — retrieval.py fix in AI_INFRA source but MCP server still loaded old code. ✅ S32 confirmed live (RAG query rerank 0.906 verify gotcha #52 hit post-CLI-restart + S32 re-ingest 2988 chunks).
+
+**Last updated S29 (prev):** 2026-05-22 (Session 29 **FINAL wrap** — **🎯 2 big plans END-TO-END deployed prod: Plan CA + Plan B Contract V2**). 20 commits cumulative S29 push 4 CI Runs PASS (#229+#230 Plan CA + #231+#232 Plan B). **Plan CA Move "Cấu hình danh mục dùng chung" admin → eoffice**: 9 menu (Master + 4 leaf + Catalogs + 4 sub-catalogs) move + role mới `CatalogManager` + demo user `catalog.manager@solutions.com.vn / CatalogMgr@2026`. 5 chunks A+B+C+D+D2 + Hotfix 1 (resolvePath staticMap silent sidebar drop — anh UAT screenshot catch). **Plan B Contract V2 wire mirror PE Mig 22-26**: COEXIST V1+V2 (7 V1 contract giữ behavior). 9 chunks A1+A2+B+C+B2+E1+D+E2+E3 + Hotfix Reviewer (ApplicableType=Contract guard MAJOR security catch) + Hotfix CICD (SeedSampleContractWorkflowV2 OUT of DemoSeed gate — V2 path BLOCKED prod nếu gated — **gotcha #51 NEW INFRASTRUCTURE vs DEMO seed**). Mig 32+33 prod applied. Sample `QT-HD-V2-001` seeded post Hotfix CICD. fe-admin/fe-user bundle 4× rotate cumulative S29. **Multi-agent ROI S29 ~565K total**: Investigator 2 spawn ~40K + Implementer Case 2 5 spawn ~82K (1 stopped mid-task E3) + Reviewer 4 spawn ~355K (Smart Friend MAJOR catch 2 lần) + CICD Monitor 3 spawn ~90K (2 fail 529 transient em main fallback manual + 1 CRITICAL catch). Em main solo ~150K coordinate + Chunk B/B2 cross-stack + E3 finish + 2 hotfix re-edit. **Smart Friend pattern proven 4× cumulative S22 #44 + S25 #48 + S29 Reviewer #ApplicableType + S29 CICD #DemoSeed**. **MCP RAG tools added 4 agent definitions** (commit `b51fc94`) — search_memory + cross_project_search — anh restart CLI hot-reload S30+. **Test gate:** 111/111 PASS preserved (UAT mode skip per chunk, V2 ApproveV2Async 150 LOC NO test cover — defer test bundle Plan B Wrap session). **8 patterns NEW saved S29** (xem STATUS.md). **NEW capability prod end-to-end:** (1) Anh login Drafter fe-user → `/contracts/new?type=1` → Workspace dropdown pick `QT-HD-V2-001` → submit ChoDuyet → CCM `binh.le` approve → Service ApproveV2Async UPSERT opinion + advance → terminal gen mã HĐ + Phase=DaPhatHanh (mirror PE V2 flow). (2) Anh login `catalog.manager@solutions.com.vn / CatalogMgr@2026` → fe-user sidebar Master + 4 leaf + Catalogs + 4 sub-catalogs CRUD full. **Pending S30+**: anh UAT verify end-to-end V2 contract flow + restart CLI MCP RAG load + curate 4 MEMORY (Investigator 25.2KB + Implementer 35.4KB + Reviewer ~22KB + CICD 24.9KB — Implementer over hard threshold, dedicate curate session) + test bundle Plan B (regression test ApproveV2Async + ApplicableType validation). **Stats final S29:** 33 mig (+2) · 60 tables (+1) · ~148 endpoints (+1) · 38 FE pages · 111 test · 51 gotcha (+1 #51) · 25 memory · 6 skills · 4 sub-agents · 14 AppRoles (+1) · 34 active prod users (+1) · 7 V1 contracts + V2 ready · 4× bundle rotate.)
+
+**Last updated S28 prev:** 2026-05-22 (Session 28 **FINAL wrap** — **🎯 S28 cumulative t1→t6 + Layer A governance apply + 4 sub-agent flush MEMORY DONE**. Bro broadcast Layer A governance active 2026-05-22 (3-Layer distributed: A project-local active / B shared_global defer / C infrastructure anh pqhuy). **Quên rule cũ "mọi tương tác PHẢI store_memory" — ABANDONED** (em main S28 t2 over-reach self-authorize cross-project rule → caught S28 t4 → scope-down về SOLUTION_ERP self-discipline). Em main apply Layer A policy local: **4-category default** (decision/lesson/pattern-proven-≥2×/session-wrap) + skip list nguyên + 5 SOLUTION_ERP-specific adjustment + tag schema mandatory `[type, phase, bc-or-module]` + phase enum 11 (current phase-9 UAT) + BC/module 8 domain + 5 cross-cutting + optional prefix 8 + source_path convention `solution_erp/<area>/<topic>-<date>` + eval ritual weekly Friday 5 metric từ 2026-05-29 → end-trial 2026-06-05 + 10 golden query draft. **4 sub-agent flush MEMORY DONE post-S27 model:inherit fix** — Investigator (aeda4 alive) + Implementer (a2a2f spawn) + Reviewer (a9e94 spawn) + CICD Monitor (a8098 spawn) — registry hot-reload verified, Recent activity entry S28 wrap góc nhìn từng con preserved cumulative S1-S27 narrative untouched. **6 chunk stored RAG S28 t2-t6** with tags schema mandatory format. **+1 memory user-level `feedback_interaction_logging_rag.md` SCOPE-DOWN S28 t4** (lesson authority boundary + implicit consent risk). **Hit rate verify 3 query**: Plan B Contract V2 rerank 0.84 ✓ + gotcha #48 rerank 0.84/0.82 ✓ + per-NV 10-surface checklist ✓ — cumulative > 0.7 threshold pass. **State chốt S28:** 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **25 memory user-level (+1)** · 6 skills · 4 sub-agents verified · **3,462 RAG chunks SOLUTION_ERP** (+6 chunk S28). **0 commit remote S28** (all local docs + memory + RAG store — anh chốt push thủ công). Plan B Contract V2 wire kick-off PRIORITY HIGH S29+ — 8-chunk pre-allocated 🟦 Investigator pre-flight audit + 🟨 Implementer Case 2 mirror PE V2 (4 chunk) + 👤 Chủ trì Solo Service ApproveV2Async + 🟥 Reviewer pre-commit Smart Friend + 🟩 CICD Monitor post-deploy Run verify. Plan AI Phase 5 distributed bootstrap 4 project khác (NamGroup/DH/Ashico/Vipix) đã DONE — total 18,532 chunks indexed cross 5 project. VIPIX hosting governance docs `D:\Dropbox\CONG_VIEC\VIPIX_MULTISITE_PROJECT\docs\governance\RAG-LAYER-A-PROJECT-LOCAL.md` v1.1 (em đọc + apply scope SOLUTION_ERP). 2-week trial monitoring 2026-05-22 → 2026-06-05 weekly Friday eval — Friday 2026-05-29 first checkpoint.)
+
+**Last updated S28 t1 initial:** 2026-05-22 (Session 28 turn 1 — **🎯 S28 startup 9-step + RAG ROI reality check em main verdict + cross-agent perspective update**. Anh restart Claude Code CLI sau S27 wrap → **sub-agent registry hot-reload OK** verified qua smoke test spawn Investigator (agentId `a2462ca503ed38b0b`, 16.3 KB MEMORY loaded, 3 skills attached: contract-workflow + permission-matrix + ef-core-migration, model `inherit` 1M Opus parent). RAG status verified: **3,460 chunks SOLUTION_ERP indexed** (cao hơn S26 wrap 2,628 — re-index ngầm) + 6 MCP tools (`mcp__rag-unified__*`) loaded, Qdrant NSSM Service Running PID 4476. **Bro hỏi "cảm nhận rõ lợi ích RAG ko?"** → em main verdict thẳng thắn (anti-suger-coat): **CÓ LỢI marginal short-term (5-10% time saving), TRANSFORM long-term cross-project (chưa khai phá vì 4 em main project khác chưa bootstrap).** 3 case WIN rõ S28 start: (1) Carry over Plan B Contract V2 state — query `Plan B mirror PE pattern` → rerank **0.84** instant 5 hits (saved ~8 phút vs đọc 3-4 session log); (2) Coverage gap detection — query `subagent setup pitfalls` → **0 hits** → phát hiện S27 NEW content chưa index, re-bootstrap pending pydantic fix; (3) Cross-project pattern verify — `cross_project_search` tool sẵn sàng (chưa dùng vì 4 dự án khác chưa bootstrap). **Reality check — RAG KHÔNG thay được blanket auto-load:** STATUS.md (40K) + HANDOFF.md (30K, đỉnh 88K full) + 4 MEMORY 200 lines/spawn (~25K) + CLAUDE.md (~10K) = ~150-200K blanket KHÔNG cắt được, RAG chỉ supplement khi cần truy cập historical specific. **3 nhược điểm cảm nhận thật:** (a) Bootstrap lag — S27 NEW content (4 file `feedback_subagent_setup_pitfalls + skill-audit-late + 4 MEMORY post-curate + rag-onboarding-guide`) chưa index sau 1 ngày; (b) Effective coverage gap — Plan B query rerank 0.84 excellent vs S27 content 0 hit miss; (c) Token cost rerank-2.5 ~$0.05/1K query. **4 case verdict — RAG worth it?** Solo project blanket đủ ⚠️ Marginal (5-10% saving) | Cross-session retrieve specific historical ✅ Tốt (1 query vs 10 phút find) | Cross-project pattern reuse 5 dự án 🚀 **TRANSFORM** (chưa dùng được vì 4 dự án khác chưa bootstrap) | Heavy refactor Plan B Contract V2 wire ✅ Tốt (instant Mig 22-26 pattern lookup). **Bottom line:** RAG hiện tại đáng giữ cho infrastructure đã đầu tư S26-S27 (60.9s bootstrap + NSSM Service auto-start + Custom Dashboard 7 panel), **nhưng nếu redo từ đầu** sẽ recommend bro **đợi bootstrap 5 dự án rồi mới claim "RAG transform"** — solo project chỉ saving marginal. **Pattern reusable cross-project — RAG ROI evaluation framework:** 1 dev solo + 1 project < 1M tokens → ❌ Skip RAG (blanket sufficient) · 1 dev solo + 1 project > 1M tokens → ⚠️ Marginal (5-10% saving) · 1 dev solo + N project > 5M tokens → ✅ Worth it (cross-project transform) · N dev team + 1 project → ✅ Worth it (shared knowledge) · N dev team + N project enterprise → ✅ Mandatory (Sourcegraph-tier scale). Avoid over-hype RAG cho solo 1 project. **Update multi-layer 6 file:** memory user-level `feedback_rag_hybrid_pattern.md` append §S28 t1 ROI reality check (~120 LOC NEW section) + 4 agent MEMORY Recent activity entry góc nhìn từng con (🟦 Investigator: pre-flight audit cross-session retrieve Plan B-class · 🟨 Implementer: Pattern proven retrieve cumulative 19 Pattern foundation · 🟥 Reviewer: gotcha historical context cross-ref #44+#48+#49 · 🟩 CICD Monitor: Run history cross-reference #186-#222 cumulative + 10-surface-point per-NV checklist promoted foundation) + STATUS.md + HANDOFF.md headers. **Bro sẽ cross-check** 4 agent có hiểu consistent context + verdict mới không (next test: spawn 4 agent với same prompt "cảm nhận RAG ROI sau S27?" + compare consistency). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **24 memory user-level (no new entry, only append §S28 t1 to existing feedback_rag_hybrid_pattern)** · 6 skills · 4 sub-agents (registry hot-reload verified post-S27 fix) · 3,460 RAG chunks + 6 MCP tools active. **0 commit remote S28 t1** (all docs + memory update + retrospective opinion — anh chốt push thủ công sau approve).)
+
+**Last updated S27:** 2026-05-22 (Session 27 **chốt cuối** — **🎯 Memory Curate + RAG Manual Control + Multi-agent Setup Pitfalls Fix**. **Trigger:** Anh share VIPIX `docs/guides/multi-agent-pitfalls.md` (lesson VIPIX 2026-05-22 em main solo cả buổi vì agents KHÔNG load) → em audit SOLUTION_ERP setup phát hiện **CHÍNH XÁC CÙNG PATTERN broken**: 4 file `.claude/agents/*.md` dùng `model: claude-opus-4-7` (200K silent fallback) + non-standard `effort: max` field → registry chưa load cả session S27. Em main solo 8 task vì KHÔNG có lựa chọn delegate (2/8 lẽ ra Implementer Case 1+2: A3.1 5 PS scripts cookie-cutter + F2 4 file mechanical fix). **Fix applied:** 4 file `model: inherit` + remove `effort: max`. **Pending:** Anh restart Claude Code CLI để hot-reload (pitfall #1 - no hot-reload session đang chạy). **Memory user-level NEW:** `feedback_subagent_setup_pitfalls.md` 235 lines cross-project pitfall checklist (VIPIX + SOLUTION_ERP evidence). **Plan A.3 RAG Manual Control + Upgrade Option 4b NSSM:** 7 PS scripts `D:\.claude-rag\scripts\` (start/stop/status/dashboard/boot/install-service/fix-service-start ASCII-only) + 6 `$PROFILE` aliases + Startup folder shortcut `rag-boot.lnk` open Dashboard sau login + Custom MCP Dashboard HTML `dashboard.html` 19 KB 7 panels with SNAPSHOT warning banner (was 13.3 KB pre-NSSM). **S27 post-wrap upgrade Option 4a → Option 4b NSSM Windows Service** (anh phản biện "Qdrant nên auto-start như PostgreSQL/SQL Server"): Download NSSM 2.24 ~351 KB (retry 1× sau 503 transient) → `install-service.ps1` elevated register service Qdrant + AppDirectory + log paths + rotation 10MB + Start SERVICE_AUTO_START + AppExit Default Restart 3s delay + DisplayName "Qdrant Vector DB (RAG Unified)". **Bug WAL lock conflict** khi pre-existing manual qdrant.exe held WAL → service Paused → `fix-service-start.ps1` elevated recovery (Stop-Service Force + kill orphan qdrant.exe + Start-Service + verify). Service Running PID 4476 RAM 101.8 MB confirmed. Auto-start boot-time trước login + auto-restart on crash + survive logout. 4 PS scripts updated to Service cmdlet (Start-Service/Stop-Service/Get-Service). Dashboard removed meta refresh + add prominent SNAPSHOT warning banner + Service status panel. **Plan A.4 RAG Onboarding Guide:** `docs/guides/rag-onboarding-guide.md` **42.5 KB / 682 lines / 14 sections + §A2 + §A3 NEW** (post-NSSM upgrade S27). 13 sections base + §12 upgraded Option 4b NSSM với install/fix scripts + §A2 cấu trúc chuẩn em main pioneer + **§A3 Context loading Hybrid pattern (~242 lines NEW post-wrap)** — 8 sub-sections covering: Cách A defensive vs B aggressive decision gate / Layer 1 blanket auto-load checklist 200-280KB / Layer 2 RAG retrieve decision tree 7-branch / Token budget 5 utilization zones 1M Opus / 6 MCP tools examples Vietnamese+English / em main daily workflow morning+EOS+monthly / 7 anti-patterns cross-project / context monitoring + end session protocol. Cho 4 em main project khác self-onboard + apply workflow optimization từ session 1. **Plan F1 Qdrant Web UI fix:** UAT bro catch `localhost:6333/dashboard` 404 → root cause Qdrant Windows binary zip không bundle Web UI static, log warn `Static content folder for Web UI './static' does not exist`. Em pioneer S26 chỉ download `qdrant-x86_64-pc-windows-msvc.zip` 28.3 MB binary, miss `dist-qdrant.zip` 6.59 MB v0.2.12 separate. **Fix:** Download + extract `D:\.claude-rag\qdrant-bin\static\` + flatten dist subfolder + restart → HTTP 200 "UI | Qdrant" ✓. **Memory Curate 4 MEMORY -60%:** cicd-monitor 72.4→15.8 KB (-78%) + implementer 38.8→22.0 KB + investigator 34.9→16.3 KB + reviewer 34.5→17.9 KB. Total 180.6→72.0 KB. Archive 115 KB preserved verbose entries (rule §6.5 compliance). 4 archive files: `archive/2026-05-runs.md` + `archive/2026-05-q1.md` × 3 agent. 10-surface-point per-NV checklist promoted to cicd-monitor MEMORY foundation. Gotcha #48 SQLite tie-break promoted to cicd-monitor MEMORY foundation. **Audit drift sớm §6.4+§9.4** (trigger +8 gotcha vượt threshold): 5 file patched (4 `26 migration → 31` + 1 `41 bẫy → 49`) + audit log `docs/changelog/skill-audit-2026-05-late.md`. **State chốt S27:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT mode defer) · 49 gotcha (gotcha #48/#49 pending docs add) · **24 memory user-level (+1: feedback_subagent_setup_pitfalls)** · 6 skills · 4 sub-agents (fixed pending CLI restart) · +5 PS scripts · +1 custom Dashboard HTML · +2 docs files (onboarding + audit log late) · **0 commit remote S27** (all local + memory + docs - anh chốt push thủ công sau approve). **Patterns reusable cross-project S27:** (1) Multi-agent setup pitfall checklist cross-project, (2) PS scripts ASCII-only discipline + CSS-styled badges thay emoji, (3) Qdrant Windows 2-step setup (binary + Web UI static separate), (4) Custom Dashboard PS generator pattern, (5) Memory curate proxy pattern khi registry empty, (6) Audit log file separate khi drift sớm.)
+
+**Last updated S26 FINAL:** 2026-05-21 (Session 26 **FINAL wrap** — **🎯 Anh chốt 2 decisions architectural CUỐI sau commit `bf93abd`**: **(1) Approach B distributed RAG bootstrap** — em main SOLUTION_ERP chỉ build infrastructure + docs, KHÔNG bootstrap hộ project khác. 4 em main NamGroup/DH/Ashico/Vipix tự setup khi mở session project đó (Cognition boundary, sensitivity per project, self-ownership re-bootstrap). **(2) Option 4a manual PowerShell scripts** thay Task Scheduler auto-start — anh OWN control qua `rag-start`/`rag-stop`/`rag-status`/`rag-dashboard` aliases trong `$PROFILE` + Qdrant dashboard built-in FREE `http://localhost:6333/dashboard`. **Bug fix bootstrap.py glob `extra_corpus`** — `import glob.glob(recursive=True)` thay Path manual parsing (em main fix sau khi test query "feedback_rag_distributed_ownership" return 0 hit → user-level memory KHÔNG được scan đúng). Re-bootstrap với fix: **2,421 → 2,628 chunks** (+207 chunks user-level memory 23 file). Cache SHA256 hit perfect — 2nd bootstrap 6.5s vs initial 60.9s = **10× speedup**. **+1 memory user-level NEW** `feedback_rag_distributed_ownership.md` ~200 lines documenting 2 decisions + setup-once scale-distributed pattern reusable cross-project (RAG + MCP + future shared tools). **Rerank verify S26 content:** 5/6 query hit rerank 0.498-0.926 (em main project X build infra docs query hit BEST 0.926 — semantic search Anthropic Contextual Retrieval working PERFECT). **Pending S27+ updated:** Phase 5 SKIP em (distributed approach) · Phase 6 Option 4a 4 PowerShell scripts (start/stop/status/dashboard) + `$PROFILE` aliases (~30 phút em viết) · Phase 7 `rag-onboarding-guide.md` 13 section (11 outline cũ + §12 monitoring `rag-status` + §13 distributed Approach B explanation) (~40 phút em viết). 4 em main project khác tự setup ~10 phút mỗi project khi anh mở session.)
+
+**Last updated S26 initial wrap:** 2026-05-21 (Session 26 chốt cuối lần đầu — **🎯 Plan AG/AG2/AG3/AG4/AG5/AG6 cumulative 6 commits Plan AG series `0bf6c7e..d99069a` push remote + Plan AI RAG global MCP infrastructure setup**. **Trigger:** Bro UAT 2026-05-21 screenshot phàn nàn UI Duyệt NCC PE List "đám rừng" flat list + đề xuất Outlook-style folder tree theo dự án + dưới năm + NCC. 6 plan UI iteration cumulative: **Plan AG** Phase 1 PE List tree view 2-level Project > Gói thầu > PE (🟦 Investigator audit 5Q ~30K + 🟨 Implementer Case 2 cookie-cutter mirror 2 app ~16K commit `0bf6c7e` 2 file +346/-116 LOC SHA256 IDENTICAL + 🟥 Reviewer pre-commit ~25K PASS 0 blocker + 🟩 CICD Monitor Run #222 ~12K bundle hash 2 app rotate verified `C8TvDy7r→CWHIdoFo` admin + `BvcWrq2z→Bg2FNeIz` user). **Plan AG2** (`c5429c0`) simplify 1-level (drop tầng gói thầu per bro feedback "gói thầu thì ko cần thiết phải treedow") + widen Panel 1 340px → 400px. **Plan AG3** (`fbad4a9`) drop single-PE flat branch consistent UI (mọi dự án dù 1/N phiếu đều render `<details>`). **Plan AG4** (`2bf0118`) bổ sung Người tạo + Phòng ban tạo PE card — BE+FE cross-stack 8 file (DTO `PurchaseEvaluationListItemDto` +4 fields DrafterUserId/DrafterName/DepartmentId/DepartmentName + 3 projection JOIN Users+Departments LEFT (ListHandler/InboxHandler/ApprovedHandler) + FE PeListItem type +4 + UI card 👤 Drafter · Phòng ban inline) + dotnet test 111/111 PASS unchanged. **Plan AG5** (`083b601`) extend tree 3-level Project > Năm > NCC > PE (selectedSupplierName fallback "(Chưa chọn NCC)" cho PE chưa DaDuyet, sort vi locale + năm DESC + PE createdAt DESC). **Plan AG6** (`d99069a`) compact card 3-row gọn đẹp (drop Type "Duyệt NCC" label redundant + combine mã phiếu/time + Drafter/Dept/HĐ inline + py-2.5 → py-2). Tất cả 6 commit verified IDENTICAL SHA256 hash mirror 2 app §3.9 + npm build × 2 PASS 0 TS err. **Plan AI RAG global MCP setup** (User-level Approach A — 1 dev 5 dự án cùng máy localhost share infrastructure): Phase 0 pre-flight (Python 3.11.3 + Voyage API key set User scope length 46 + 5 project paths detected Claude Desktop config epitaxy: SOLUTION + NAMGROUP + DAI_Y_DUOC + ASHICO + VIPIX_MULTISITE) + Phase 1 Qdrant v1.18.0 Windows native binary running PID 67240 port 6333 (KHÔNG Docker, anh chốt no Docker) + Phase 2 FastMCP server ~1100 LOC Python 9 file (server.py 6 tool handlers + lib/embed.py Voyage wrapper + lib/retrieval.py 3-layer pipeline + lib/projects.py auto-detect cwd + lib/chunking.py Anthropic Contextual Retrieval prepend + lib/watcher.py + bootstrap.py CLI + README.md) + Phase 3 register MCP user-level (`claude mcp add -s user -e VOYAGE_API_KEY=$VK -- rag-unified python ...` — trick `--` separator để terminate variadic `-e` flag) — "rag-unified: ✓ Connected" + Phase 4 bootstrap SOLUTION_ERP corpus 126 files → **2,392 chunks indexed 60.9s** (~484K Voyage tokens = 0.24% free tier 200M/month) + verify search 4 query thực tế recall 0.641-0.879 rerank score. **Stack final RAG:** Voyage-4-large embedding (1024-dim) + Voyage rerank-2.5 cross-encoder + Qdrant Windows native + SQLite FTS5 BM25 (unicode61 + diacritics remove) + Reciprocal Rank Fusion (k=60) + FastMCP 3.3.1 stdio + Anthropic Contextual Retrieval prepend "From <doc> > <heading>:" + git-sync embeddings snapshot pattern (Cursor lesson). 6 MCP tools exposed: search_memory · cross_project_search · search_code · store_memory · promote_to_shared · list_projects. **+1 file MD onboarding** `docs/guides/multi-agent-setup-guide.md` xuất cho 4 dự án future áp dụng pattern 1 em main + 4 sub-agent + RAG share infrastructure. Multi-agent ROI S26: 🟦 Investigator 2 spawn (Plan AG audit 5Q + Plan AI RAG distribution research 4 study cases Cursor/Cline/Continue/Sourcegraph) ~70K + 🟨 Implementer 1 spawn (Plan AG Case 2) ~16K + 🟥 Reviewer 1 spawn (Plan AG pre-commit) ~25K + 🟩 CICD Monitor 1 spawn (Run #222) ~12K. Em main solo Plan AG2-AG6 (5 plan polish UAT iteration) + Plan AI Phase 0-4 (RAG infra setup ~1.5h). **State chốt S26:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · 49 gotcha unchanged · 23 memory user-level unchanged · 6 skills · 4 sub-agents · **+1 docs/guides/multi-agent-setup-guide.md** + **+1 RAG infrastructure** `D:\.claude-rag\` ready 5 project. 3 patterns reusable cross-project (S26 NEW): (1) Pattern 19 Implementer — HTML native `<details>/<summary>` + Tailwind named groups `group/proj`+`group/year`+`group/sup` + localStorage Set<string> cho hierarchical 3-level tree UI no Accordion lib, (2) RAG User-level Global MCP — 1 server localhost serve N project + per-project `.claude/rag.json` config (Approach A — 1 dev solo scenario), (3) Qdrant Windows native binary deployment — no Docker overhead, appropriate cho solo dev không enterprise scale. **Memory FLAG continued S26:** cicd-monitor MEMORY ~74KB (+2KB từ S25), critical curate session URGENT next (archive Run #186-#221 verbose → `archive/2026-05-runs.md`). **Pending follow-up Plan AI:** Phase 5 bootstrap 4 project còn lại (NamGroup/DH Y Dược/Ashico/Vipix) ~30 phút mỗi project + Phase 6 file watcher + Windows Task Scheduler auto-start Qdrant. Tests baseline 111 preserve cross 6 commit (test debt cumulative S22+1 + S25 + S26 bug fix not added — UAT mode defer per §7).)
+
+**Last updated S25:** 2026-05-19 (Session 25 chốt cuối — **🎯 Plan AB→AF cumulative 7 commits push `e23f51c..506cada` + 7 CICD Runs (#215 FAIL → #216-#221 PASS) — Lịch sử visibility critical fix UAT iteration**. Trigger: Bro UAT 2026-05-19 phát hiện 2 bug critical phiếu PE/2026/A/032: Bug 1 Budget Adjust không show "Lịch sử thay đổi" (BE log OK + FE filter strict TraLai-only loại) + Bug 2 Return Mode 4 mode KHÔNG log Changelog (`ApplyReturnModeAsync` miss `db.PurchaseEvaluationChangelogs.Add()`). **Plan AB Chunk A** (`cdfd542`, 🟨 Implementer Case 1 spawn ~12K): BE refactor `ApplyReturnModeAsync` Drafter early return → common path + single `Changelog.Add()` cover 4 mode uniform với `modeName` switch enum + `actorName` resolve via `userManager.FindByIdAsync` mirror `LogTransitionAsync` pattern. FE `PeDetailTabs.tsx` × 2 app `HistoryTab` filter extend (PE_ENTITY_HEADER=1 + summary 'ngân sách' + Workflow summary 'Trả lại'). 🟥 Reviewer pre-commit verify ~22K PASS 0 critical/major/minor (1 minor V1 legacy fallback non-block). Run #215 FAIL test_infra 2/53 — Plan M edge case tests SQLite frozen-clock tie-break (gotcha #48 NEW): 2 Changelog rows cùng `CreatedAt` → `OrderByDescending.FirstAsync()` pick wrong → ContextNote null. **Plan AB Chunk A2** (`8c05947`, em main solo): Test filter `Where(Summary.Contains("Chuyển phase"))` pick đúng LogTransition entry. 111/111 PASS. Run #216 PASS. **Plan AC** (`a734bf2`, em main solo): BE capture pre-call Step/Level → Reject branch add `PurchaseEvaluationApprovals.Add()` với Decision=Reject + Comment from-pos + mode summary. BE line 472 enrich Approve comment prefix `[Duyệt vượt cấp tới Cấp cuối]` khi skipToFinal=true. FE × 2 app ApprovalsTab thêm `decisionBadge(decision, toPhase)` helper (Duyệt emerald / Trả lại amber / Từ chối rose). Run #217 PASS, bundle rotate × 2 app. **Plan AC2** (`25837b6`, em main solo, Option 2A bro chốt): FE merge view ApprovalsTab fetch changelogs + reconstruct synthetic Reject rows từ Workflow+Reject Changelog (filter EntityType=5 + Summary "→ TraLai"/"→ TuChoi" OR ContextNote "Trả về"/"không lùi được") + dedupe `approverUserId + timestamp 5s bucket` cùng real Reject rows + merge sort by approvedAt. KHÔNG DB write, reversible historical recovery. Run #218 PASS, 8 Workflow entries verified, bundle rotate × 2 app. **Plan AD** (`0aaf2df`, em main solo, Option A bro chốt): Drop fromPhase→toPhase badges (visual confusion 3/4 mode Reject giữ ChoDuyet — gotcha #49 NEW) + add `extractNextTargetHint(decision, toPhase, comment)` helper regex parse `Chuyển phase X → Y` + keyword detect "Trả về"/"vượt cấp"/"Cấp cuối" → "→ Cấp Y" / "→ Trả về Người chỉ định (Bước X Cấp Y)" / "→ Vượt cấp tới Cấp cuối" / "→ Đã duyệt hoàn tất". Cleanup unused `PurchaseEvaluationPhaseColor` import. Mirror × 2 app §3.9. Run #219 PASS, bundle rotate × 2 app. **Plan AE** (`9ea62be`, em main solo, preventive batch fix): BE 9 `Changelog.Add()` sites add `UserName = currentUser.FullName ?? currentUser.Email` (Budget Adjust + Create PE + Update PE Header + Detail Insert/Update/Delete + Quote Insert/Update/Delete + Select Winner). ICurrentUser đã có FullName/Email từ JWT — KHÔNG inject userManager mới. `replace_all=true` 1 pass cover 8 sites cùng indent + 1 site manual fix indent 16 spaces inside if block. 111/111 PASS local. Run #220 PASS, bundle UNCHANGED (BE-only commit). **Plan AF** (`506cada`, em main solo, Option A bro chốt): FE ApprovalsTab + HistoryTab build `userMap useMemo` từ embedded PeDetailBundle data: `drafterUserId+drafterName + approvals[].approverUserId+approverName + approvalFlow.steps[].levels[].approvers[].userId+fullName + levelOpinions[].signedByUserId+signedByFullName + departmentOpinions[].userId+userName` — no extra `/api/users` fetch (admin permission). `resolveActorName(a) / resolveUserName(l)` helper: trust entry.userName non-empty → userMap.get(entry.userId) → 'Hệ thống' fallback. Mirror × 2 app §3.9. Run #221 PASS, bundle rotate × 2 app. **Multi-agent ROI S25:** 🟦 Investigator 1 spawn (~28K Bug 1+2 audit) + 🟨 Implementer 1 spawn (~12K Plan AB Chunk A Case 1) + 🟥 Reviewer 1 spawn (~22K Plan AB pre-commit) + 🟩 CICD Monitor 7 spawns (Run #215 catch test gate fail + Run #216-#221 PASS verify, ~70K cumulative). Em main solo 5 plans AC→AF cross-stack reasoning + UAT iteration. Total cumulative agent cost ~132K · em main ~210K. **State chốt S25:** 31 mig (no schema) · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · **49 gotcha (+2: #48 SQLite tie-break + #49 dual-phase UI confusion)** · **23 memory user-level (+2 NEW: feedback_fe_merge_synthetic_audit + feedback_fe_usermap_fallback)** · 6 skills · 4 sub-agents active. **Memory CRITICAL FLAG:** cicd-monitor MEMORY ~72KB strongly over 50KB hard threshold — DEDICATED CURATION SESSION REQUIRED next (archive Run #186-#210 + S22-S24 verbose entries to `archive/2026-05-runs-186-210.md`). Investigator 32KB / Implementer 35.7KB / Reviewer 32.3KB cũng over 25KB threshold — recommend curate cùng session với cicd-monitor. **8 patterns reusable saved S25:** (1) Multi-Changelog SQLite tie-break (gotcha #48) → test discriminator, (2) CICD catch UAT skip test risk → resumed local verify BE refactor > 100 LOC, (3) Test fix Option A over BE refactor preservation, (4) Capture pre-call mutation state cho audit row from-position, (5) FE merge synthetic rows từ Changelog reversible recovery (Plan AC2), (6) Drop misleading dual-phase badges + semantic next-target hint (Plan AD), (7) Changelog UserName preventive systemic batch fix 9 sites (Plan AE), (8) FE userMap fallback từ embedded domain data no extra API (Plan AF). Bro UAT verify cumulative deploy live PE/2026/A/032 — historical entries pre-Plan AE nay resolve user names qua userMap fallback.)
+
+**Last updated S24:** 2026-05-15 (Session 24 chốt cuối — **🎯 Plan AA cumulative 7 commits push `a1a910f..ee0902a`** — User Workflow Matrix view + Sidebar widen + 4 polish iteration UAT feedback. Phase 1 Plan AA core (3 commit `ee776d5..ac2c859`): 🟦 Investigator Pre-A 5Q audit (~32K) + 👤 Chủ trì Chunk A BE+Layout solo (gotcha #44 đã fix permanent từ S18 → chỉ ADD `IsUserSelectable bool?` filter + DbInitializer INSERT-OR-UPDATE-Order idempotent shift existing prod rows + MenuKeys `Pe_DuyetNcc_WfView` helper + sidebar widen `w-72 xl:w-80` × 2 app + revert Plan U truncate × 5 sites) + 🟨 Implementer Case 2 Chunk B FE (~14K, WorkflowMatrixViewPage + types + App.tsx route ~270 LOC) + 🟥 Reviewer cumulative pre-commit (~25K, PASS 0 blocker + fe-admin build bonus 1926 modules) + 🟩 CICD Monitor Run #210 verify (4/4 wire end-to-end: filter live + menu Order shift + bundle hash rotate 2 app + Mig 31 unchanged). Phase 2 polish iteration UAT feedback (4 commit `da218f1..ee0902a`): 👤 Chủ trì Solo 4× CSS/UX polish — (1) `da218f1` hotfix container px-6→px-2 (content sát sidebar) + (2) `4d60598` redesign v1 panel-per-NV mirror admin Designer color coding (drop table 11 cột symbol khó hiểu) + (3) `fbbd361` redesign v2 HTML table rowSpan tận dụng full width (4 cột: Bước/Cấp/NV/Quyền duyệt grid 2-col 7 label) + (4) `ee0902a` wrap fix label dài về đầu hàng pattern hanging-indent reverse CSS (flex→block + inline-block icon + inline text + absolute ChevronDown) + text smaller text-[12px] leading-snug. Patterns reusable cross-project: (a) gotcha #44 relax pattern PROVEN cross-stack reuse, (b) DbInitializer INSERT-OR-UPDATE-Order idempotent re-deploy, (c) Tailwind JIT palette array (STEP_PALETTE 5 màu + LEVEL_PALETTE 5 màu cycle), (d) HTML table rowSpan flat row builder helper, (e) hanging-indent reverse via inline-block icon. Stats: 31 mig · 59 tables · **~146 endpoints (+1 GET filter param)** · **35 FE pages (+1 WorkflowMatrixViewPage)** · **111 test** (no change, baseline confirmed post-Plan AA) · 47 gotcha · 21 memory · 6 skills · 4 sub-agents. Multi-agent ROI S24: ~175K total (Inv 32K + Imp 14K + Rev 25K + CICD 12K + 3 flush agents ~12K + em main ~80K) = ~28% solo equiv. CICD verify Run #210 PASS. **Implementer MEMORY ~31.5KB > 25KB threshold** → recommend curate next session archive S20-S22 old entries.)
+
+**Last updated S23 t12:** 2026-05-15 (Session 23 turn 12 chốt cuối — **🎯 S23 cumulative 11 plan + 32 commits**. Plan K (Mig 31 F2 refactor 9c) → L (UAT bug 5c) → M (F1 edge case 4c) → N (per-NV lookup 1 site 2c) → O (4 sites cascade 2c) → P (Controller body record 1c) → Q (FE banner 1c) → R (cleanup phiếu/wf 1c) → S (wipe ALL wf 1c) → T (DemoSeed flag 2c) → U (sidebar truncate 1c). 4 sub-agents: Investigator 5 spawn + Implementer 5 spawn + Reviewer 2 spawn + CICD Monitor 10 verify runs PASS. Memory +1 NEW `feedback_demo_seed_flag_disable.md` + `feedback_per_nv_permission_scope.md` reinforced 10 wire surface points (point 9 lookup discrimination + point 10 Controller body record mirror). Cleanup cumulative R+S+T5 ~720 rows wiped + DbInitializer flag persist. Stats: 31 mig · 59 tables · ~145 endpoints · **111 test** · 47 gotcha · **21 memory** (+1) · 6 skills · **0 PE + 0 demo workflow + flag persist** UAT permanent clean slate. 32 commits push `eb106f2..86d8806`. Plan B Contract V2 wire HIGH next.)
+
+**Last updated S23 t10:** 2026-05-15 (Session 23 turn 10 — **🔧 Plan T: Disable auto re-seed demo data + final DELETE — UAT permanent clean slate**. Bro phát hiện sau Plan R+S: 4 phiếu `[DEMO]-A/B` + workflows TỰ ĐỘNG RE-SEED sau IIS recycle do DbInitializer 5 demo seed methods. Plan T fix root cause: `appsettings.json` add `DemoSeed:Disabled=true` (Dev override false) + `DbInitializer.cs` check flag → skip 5 method. Run #207 PASS deploy applied flag. T5 sqlcmd DELETE 7 rows + cascade. T6 force IIS recycle verify NO re-seed: PE=0 + V2=0 + V1=0 preserved. DemoSeed flag PROVEN active end-to-end. Cumulative Plan R+S+T: ~677 rows wiped + DbInitializer re-seed permanent disable. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow + flag persist** UAT permanent clean slate.)
+
+**Last updated S23 t9:** 2026-05-15 (Session 23 turn 9 — **🧹 Plan S: Wipe ALL workflows — UAT clean slate hoàn toàn**. Bro chốt sau Plan R: xóa hết 4 workflows demo cũ còn lại (V2 ghim + V1 active đều seed cumulative). Backup Plan R reuse. Execute DELETE ALL ApprovalWorkflows + PurchaseEvaluationWorkflowDefinitions. Post-state: **0/0 workflow + 0 cascade Steps/Levels/Approvers**. BE smoke 5/5 endpoints 200, KHÔNG crash. Total cumulative cleanup Plan R+S: ~670 rows wiped (35 PE + 17 V2 + 4 V1 + 600 child). Hậu quả: user phải đợi admin Designer seed workflow mới. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory. Database UAT clean slate hoàn toàn.)
+
+**Last updated S23 t8:** 2026-05-15 (Session 23 turn 8 — **🧹 Plan R: Cleanup destructive prod database**. Bro chốt sau Plan P+Q wire OK: "xóa hết phiếu test + quy trình ko ghim". Investigator pre-flight audit ~64K confirm scope 28 PE active + 7 soft + 15 V2 unghim + 2 V1 inactive. Backup mandatory `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB. Hard-DELETE 52 rows + ~600 cascade child (PE child + workflow Steps+Levels+Approvers). Post-cleanup: **0 PE · 2 V2 ghim · 2 V1 active**. Smoke verify 3/3 endpoints 200 — BE healthy. Stats: 31 mig · 59 tables · ~145 endpoints · 111 test · 47 gotcha · 20 memory · 6 skills. UAT clean slate. Bro test workflow fresh.)
+
+**Last updated S23 t6:** 2026-05-15 (Session 23 turn 6 — **🎯 Plan P HOTFIX: Controller TransitionPeBody record missing 3 fields — bug ROOT CAUSE thực sự F1+F2 fail**. CICD Monitor Plan O Run #202 catch CRITICAL caveat: Controller `TransitionPeBody:267` MISSING ReturnMode + ReturnTargetUserId + SkipToFinal. Investigator audit FE confirm: FE × 2 app mirror SEND ĐÚNG 7 fields qua `api.post()` — BE drop tại Controller body record + mediator.Send line 70. Bug present 2 ngày prod từ Mig 28 deploy 2026-05-13 → F1+F2 wire fail từ FE side. Plan N + Plan O fix lookup sites nhưng controller bug block flow trước khi đến lookup. Plan P fix BE-only ~10 LOC: TransitionPeBody +3 field default null/false + mediator.Send pass 7 fields + using import WorkflowReturnMode namespace. **111/111 PASS unchanged**. Pattern reinforced: Controller body record MUST mirror Command record fields. Multi-agent ROI: Investigator avoid cross-stack fix sai + CICD Monitor catch root cause invaluable chain. Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test** · 47 gotcha · 20 memory · 6 skills.)
+
+**Last updated S23 t5:** 2026-05-15 (Session 23 turn 5 — **🎯 Plan O HOTFIX: 4 lookup sites cùng pattern per-NV cascade — Plan N chỉ catch 1/5 sites**. Bro UAT sau Plan N: Actor NV Test trong OR-of-N click "Trả lại Người chỉ định" → "Không phải lượt bạn" mặc dù đúng slot. Em main grep audit phát hiện 5 lookup sites cùng bug, Plan N chỉ catch 1. Plan O fix 4 sites còn lại: Service.cs:201 (EnsureCanRejectV2Async = bug bro), Service.cs:248 (ApplyReturnModeAsync read Allow flag), DetailFeatures.cs:72 (F3 guard), Features.cs:311 (F4 AdjustBudget guard). ApplyReturnModeAsync signature +`Guid? actorUserId` 4th param + caller TransitionAsync:94 update. 3 regression test mới `PurchaseEvaluationPerNvLookupRegressionTests`. **111/111 PASS** (+3 từ 108). Pattern reinforced 5 sites checklist + audit grep `FirstOrDefault.*Order ==`. Bug 2 (F2 chỉ đến Phan Văn Chương) defer follow-up — F2 logic đúng, verify workflow v14 DB. Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test (+3)** · 47 gotcha · 20 memory · 6 skills.)
+
+**Last updated S23 t4:** 2026-05-15 (Session 23 turn 4 — **🎯 Plan N HOTFIX: BE per-NV lookup site discrimination — bug critical UAT block**. Bro UAT screenshot phát hiện admin Designer tick 7 flag TRUE cho NV Test (UAT V2) nhưng dialog Duyệt/Trả lại KHÔNG có F1+F2+F3+F4 options. Investigator audit verify Hypothesis B: `PurchaseEvaluationFeatures.cs:765` `FirstOrDefault(Order==X)` thiếu `ApproverUserId == currentUser.UserId` discriminator. Schema Mig 29 OR-of-N: 4 row cùng Order → handler luôn lấy row đầu DB (Lê Văn Bính, Drafter only), bỏ qua admin tick per-NV. Bug PRESENT 2 ngày prod từ Mig 29 deploy 2026-05-13 — chỉ bộc lộ khi lần đầu admin tick selectively. Fix 5 LOC: thêm match `ApproverUserId == currentUser.UserId` + fallback row đầu cho admin/non-approver. Test regression `GetPurchaseEvaluationCurrentLevelOptionsTests` 2 method: 4 actor distinct flag profile + admin fallback. **108/108 PASS** (+2 từ 106). Multi-agent ROI: Investigator catch root cause 1 spawn ~80K — em main solo fix nhanh. Pattern reinforced: per-NV admin opt-in flag wire checklist **9 surface points** (thêm point 9 handler lookup site discrimination). Stats: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **108 test (+2)** · 47 gotcha · 20 memory (1 entry reinforced) · 6 skills.)
+
+**Last updated S23 t3:** 2026-05-15 (Session 23 turn 3 — **🎯 Plan M: Fix F1.OneLevel/OneStep edge case Bước 1 → giữ ChoDuyet + FE label phase rename**. 3 commits Plan M `c2042ef..4dd6f9c` local (chưa push, chờ Reviewer verdict). Bro UAT post-Plan L deploy: "Hiện logic cũ là khi trả lại 1 cấp hoặc chỉ định hoặc edit là trạng thái draft → thay đổi lại". Investigator audit confirm 4 mode F1.OneLevel/Assignee + F2 + F3 + F4 main path đã giữ ChoDuyet đúng (Mig 28-31 cumulative). Edge case F1.OneLevel ở Bước 1 Cấp 1 + F1.OneStep ở Bước 1 còn fallback Drafter (Phase=TraLai) — gap "draft" bro phát hiện. Plan M fix: reset (0, 1) giữ Phase=ChoDuyet + audit log "không lùi được" + SLA reset 7d (no-op effective). M3 FE label phase Phase=TraLai badge "Trả lại" → "Cần chỉnh sửa lại" (rõ end-user). M2 add 2 edge case tests **106/106 PASS** (+2 từ 104). F1.Drafter mode 4 GIỮ NGUYÊN Phase=TraLai semantic (explicit role mode). Multi-agent ROI evidence: Investigator catch fact code main path đã đúng (avoid em main spam fix sai) + Implementer Case 2+3 cookie-cutter 2 spawns + Reviewer pre-commit pending. Memory user-level update 2 entry. Stats: **31 mig** · 59 tables · **~145 endpoints** · 34 FE pages · **106 test (+2)** · 47 gotcha · 20 memory (2 entry reinforced) · 6 skills · 4 sub-agents. CHƯA push remote.)
+
+**Last updated S23 t1:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K Mig 31 F2 refactor sang per-Approver-slot — DONE 9 commits `56868bf..0062fcb` pushed remote**. Verify result K9 + K11: Mig 31 prod TOP 1 ✅, Levels.AllowApproverSkipToFinal col added ✅, Users.AllowDrafterSkipToFinal col dropped ✅, zombie PATCH /allow-skip-final → 404 ✅, bundle hash rotated 2/2 (admin `CpI5OL8n→CRsX6cFo`, user `d064StNa→X7qb4Zl4`) ✅, 33 active users preserved ✅, AwLevelDto `allowApproverSkipToFinal` field PRESENT (13 keys, default False opt-in) ✅. CICD Monitor K9 catch CRITICAL wire gap: `AwLevelDto` admin DTO miss field — em main K2 + Reviewer K2 cùng miss audit `ApprovalWorkflowV2AdminFeatures.cs`. K10 hotfix ~15 LOC 1 file (AwLevelDto + ToDto + CreateAwLevelInput + entity init) pushed `0062fcb`. Run #195 success → K11 self-verify field present. Pattern lesson: per-NV admin opt-in flag wire **8 surface points** required (NOT 6 — admin overview DTO + Create input là 2 gap em main miss S22+5 và S23 t1). Memory `feedback_per_nv_permission_scope.md` cần add wire checklist gotcha S23 t2+.
+
+**S23 t1 prev:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K Mig 31 F2 refactor sang per-Approver-slot — DONE 8 commits Plan K `56868bf..<latest>`**. Bro phát hiện inconsistency S22: F1+F3+F4 đều per-slot ở Designer, F2 lone wolf ở User Management (Plan D S22 wire) + bro chốt đổi semantic F2: Drafter from Nháp → Approver during ChoDuyet skip thẳng Cấp cuối. Plan K 8 chunk: pre-A slot label rename "#NV {order}" → ApproverFullName + K1 Mig 31 schema swap (drop Users + add Levels, NO BACKFILL Option A) + K2 Service ApproveV2Async +skipToFinal 8th param APPROVE STEP branch + DTO 7th Allow* field + K3 Designer 7th checkbox + banner rewrite + K5 zombie endpoint cleanup (PATCH /users/{id}/allow-skip-final + Command/Handler/DTO/UI all backout Plan D S22) + K6 Workspace × 2 app DROP Drafter checkbox + ADD Approver toggle Dialog amber warning + K7 tests 104/104 PASS regression (3 deleted Drafter F2 + 3 added Approver F2 cancel out) + K8 docs cumulative. Multi-agent ROI: 🟦 Investigator K0 pre-flight + 🟨 Implementer 4 spawns (pre-A + K1 + K3 + K5 + K7 Case 2+3) + 🟥 Reviewer K2 pre-commit catch zombie endpoint Major + 👤 Chủ trì K0-bis sqlcmd + K2 cross-stack reasoning + K6 UX flow + K8 docs. 4 prod user lose AllowDrafterSkipToFinal=true value per Option A (admin re-config qua Designer). Reviewer K2 PASS 0 critical, 2 Major + 2 Minor flagged → K5 + K8 resolved. New pattern caught: "Transient sentinel zombie" anti-pattern (K1 sentinel-false patch + chunk scope shift → endpoint NoOp swallow silent). Per-NV admin opt-in flag pattern proven **3× cumulative** (Mig 29 F1+F3 + Mig 30 F4 + Mig 31 F2) — pattern ALSO applies cho refactor existing scope, KHÔNG chỉ greenfield. Memory `feedback_per_nv_permission_scope.md` reinforced S23 t1. State final: **31 mig (+1 Mig 31)** · 59 tables · **~145 endpoints (-1 backout)** · 34 FE pages · **104 test PASS unchanged** · 47 gotcha · 20 memory · 6 skills · 4 sub-agents (Investigator 1 spawn + Implementer 4 spawn + Reviewer 1 spawn + CICD pending K9). CHƯA push remote — chờ bro confirm K9 spawn CICD Monitor verify.)
+**S22 chốt cuối:** 2026-05-13 2300 (Session 22 CHỐT cuối cùng — **bro chốt directive Thứ 9 BẮT BUỘC delegate sub-agent**. 14 commits pushed remote `3d725c4..2b9788d` + (this final). CICD Monitor Run #193 PASS verified all live endpoints + Mig 30 prod + bundle hash rotated. State final: **30 mig · 104 test · 47 gotcha (#47 revised informational) · 19 memory · 6 skills · 4 sub-agents · 33 active users prod**. Retrospective S22: em main solo 6/10 task lẽ ra delegate được — vi phạm directive Thứ 9. **Forward S23+ rule:** BẮT BUỘC spawn sub-agent khi ACCEPT criteria match (Implementer Case 1/2/3/5, Investigator pre-flight, Reviewer pre-commit, CICD Monitor post-deploy). Em main solo CHỈ khi schema/UX/architecture decision + cross-stack tight coupling + bug fix reasoning chain.)
+**S22 chốt v1:** 2026-05-13 2200 (Session 22 CHỐT — **bro confirm sub-agent solution OK**. 11 commits pushed remote `3d725c4..b04a11a`. CICD Monitor Run #188 PASS verified. State final: **30 mig · 104 test · 47 gotcha (+1 #47) · 19 memory · 6 skills · 4 sub-agents · 33 active users prod**. KHÔNG còn pending push. Plan G S21-S22 evidence: Trial Week 1 → Week 2 sub-agent ROI confirmed. Bro test UAT 4 flag pattern + view file PDF + Section Điều chỉnh ngân sách.)
+**S22 prev:** 2026-05-13 1800 (Session 22 — Plan C + D + E done, Plan F ABORTED pre-flight fail. 5 commits local `60efeed..HEAD` chưa push. Plan D F2 toggle UI (BE+FE Admin). Plan C task 4 + 1-3 — 19 unit test mới (+5 reg #44 + 7 ReturnMode + 7 Guard). Plan E strict V2 scope List + Detail (remove UAT loose `|| ApprovalWorkflowId != null`). Plan F ABORTED — pre-flight prod sqlcmd reveal Contract entity HOÀN TOÀN V1 chưa wire V2 + 4 PE V1-only + 23 PE V1+V2 mix. Defer F sau Plan B Contract V2 wire. State: **29 mig · 103 test (+19) · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (em main solo S22)**. 5 commits pending push `3d725c4..HEAD`.)
+**S21 CHỐT CUỐI:** 2026-05-13 1530 (Session 21 CHỐT CUỐI — 5 turn cumulative `3a34831..c0af9e0` 12 commits pushed remote, CICD Monitor verify 2/2 run PASS. Gotcha #46 mới (Gitea API path/cache stale). 2 memory user-level mới: `feedback_ef_migration_backfill_reorder` + `feedback_per_nv_permission_scope`. 3 agent Inv/Imp/Rev cập nhật MEMORY ghi recent activity S21 t3-t5 em main solo. State final: **29 mig · 84 test · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (3 seeds + 1 cicd 2-run)**. KHÔNG còn pending push. Plan G Trial Week 1 evidence: CICD spawn 2/2 PASS (green), cost ~110-120K under 150K budget, CI time 3-3.5min stable. Pending Plan C test-after bundle defer sau UAT 2-3 lần ổn.)
+**S21 turn 5:** 2026-05-13 1400 (Session 21 turn 5 — **🎯 Refactor Allow* sang PER-NV (Mig 29). 4 chunk per-commit `0366946` (A BE+Mig 29) → `63234b2` (B FE Admin Designer per-Level 5 checkbox) → `5ccb2a7` (C FE eOffice mirror 2 app rename) → this Chunk D Docs. **F1+F3** 5 flag MOVED xuống `ApprovalWorkflowLevels` (per slot Approver). **F2** MOVED xuống `Users` (per-Drafter). Mig 29 4-stage: ADD 5 Levels + 1 Users + BACKFILL bulk SQL preserve admin config S21 t4 + DROP 6 workflow column. Service refactor đọc `currentLevel.Allow*` + `drafterUser.AllowDrafterSkipToFinal`. DTO `AwLevelDto +5`, `PeDetailBundle.workflowOptions → currentLevelOptions + drafterAllowSkipToFinal`. FE Admin Designer 5 checkbox per Level slot inline (drop section workflow-level). 84 test PASS. CHƯA push remote — chờ bro confirm.**)
+**S21 turn 4:** 2026-05-13 1200 (Session 21 turn 4 — **🎯 F1+F2+F3 PE Workflow advanced options (Mig 28) — 5 chunk per-commit `0294693` (A schema) → `c56024b` (B BE) → `a508564` (C FE Admin) → `d27caaf` (D FE eOffice) → this (E Docs). **F1** 4 mode Trả lại admin tick stick (1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo) — 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain), mode Drafter giữ Phase=TraLai clear pointer (S17 backward compat). **F2** Drafter skip thẳng Cấp cuối — workflow tick + Workspace checkbox dynamic. **F3** Approver edit Section 2 (Hạng mục/NCC/Báo giá) khi workflow tick + actor match CurrentLevel.ApproverUserId + audit ghi PurchaseEvaluationChangelog. Mig 28 thêm 6 bit column lên `ApprovalWorkflows` (DEFAULT 1 cho AllowReturnToDrafter backward compat, 5 còn lại 0). BE Service extend signature 3 optional param (returnMode/returnTargetUserId/skipToFinal). Helper `EnsureEditableForDetailsAsync` mới gating Detail/Quote/Supplier CRUD theo Drafter scope OR F3 Approver scope + audit changelog Update/Delete (trước đây silent). FE Admin Designer "Cấu hình nâng cao" section 6 checkbox 3 group. FE eOffice 3 changes mirror 2 app. UAT mode skip dotnet test mỗi chunk, npm build × 2 app pass mỗi chunk. CHƯA push remote — chờ bro confirm.**)
+**S21 turn 3:** 2026-05-12 2100 (Session 21 turn 3 — **🔴 BUG FIX CRITICAL "Trả về nhưng hệ thống vẫn duyệt" PE workflow (gotcha #45 mới). 3 chunk per-commit: `de00887` (BE Chunk A guard + 3 test) + `4b29d00` (FE Chunk B fix 2 app mirror) + this Chunk C Docs. Root: `PeWorkflowPanel.tsx` `isReject` payload (L64-66) thiếu nhánh TraLai → button "← Trả lại" gửi `decision: 1` (Approve) thay vì `2` (Reject) khi target=TraLai(98) → BE skip Reject branch → enter APPROVE STEP → `ApproveV2Async` UPSERT opinion "đã duyệt" + advance Cấp tiếp theo. Inconsistency phụ: dialog `isSendBack` (L247-248) cùng pattern thiếu TraLai → dialog title sai `'✓ Duyệt → Trả lại'` + KHÔNG amber warning. Severity CRITICAL — data integrity issue khó rollback (BE đã `SaveChangesAsync`). Test-before §7 BẮT BUỘC: viết test reproduce → confirm FAIL (BE đi sâu vào ApproveV2Async throw "Phiếu chưa pin workflow") → thêm BE guard early throw ConflictException khi `target ∈ {TraLai, TuChoi} && decision != Reject` → confirm PASS. 3 regression test (Throws TraLai+Approve, Throws TuChoi+Approve consistency, happy path Reject+TraLai). Tổng `dotnet test SolutionErp.slnx` 84 PASS (58 Domain + 26 Infra = +3 from 81 baseline). `npm run build` × 2 app pass. Stats: 27 mig (no change) · 59 tables · ~142 endpoints · 34 FE pages · **84 test (+3)** · **45 gotcha (+1 #45)** · 17 memory · 6 skills · 4 sub-agents seeds-only. Em main solo S21 t3 — bug fix reasoning chain cross BE/FE Implementer REFUSE per multi-agent rule (decision tree: tightly coupled BE+FE+test). CHƯA push remote — chờ bro confirm sau Chunk C wrap.**)
+**S21 turn 2:** 2026-05-12 1800 (Session 21 turn 2 — **🎯 RAG Hybrid setup planning + Cách A validation deep dive. 2 commit (`1f8e9af` plan save 1223 LOC + this chốt). KHÔNG implement, plan only — defer chờ bro confirm 5 dự án future. Decision chốt: Cách A defensive (giữ blanket 120K em main + RAG retrieve) over Cách B aggressive (cắt 60-70% blanket). Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider). Stack: Voyage-3-large + Qdrant + FastMCP + Streamlit dashboard. Multi-agent cost reality: 4 agents → ~520K cumulative blanket → heavy session ~560K (Cách A) vs ~700K (lazy). 3-layer pattern Phase 1-3 rollout (embeddings + BM25 + reranking, ~70% → ~92% recall). Stats: +1 memory entry (`feedback_rag_hybrid_pattern`) +1 plan file (`rag-setup-plan.md` 1500 LOC). Sub-agents vẫn 4 seeds-only, em main solo session.**)
+**S21 turn 1:** 2026-05-12 0030 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`. CI skipped per path filter (3 file `.md`). Cost reality update: ~750K spawn (3 → 4 agents) · ~1.35M heavy / ~700K optimized. Stats: 4 sub-agents seeds-only · 16 memory · 27 mig · 59 tables · ~142 endpoints · 81 test · 44 gotcha · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work — em main solo). Trial Week 1 kick-off S21 turn 2+ Plan B Contract V2 wire mirror PE pattern.**)
+
+## 🎯 Plan B Contract V2 wire — sub-agent role pre-allocated (S23+ kick off priority)
+
+Per directive Thứ 9 BẮT BUỘC delegate. Workflow forward:
+
+| Chunk | Owner | Justification |
+|---|---|---|
+| **Pre-flight audit Contract entity V1 state** | 🟦 **Investigator** | Read-only scan `Contract.cs` + `ContractDeptApproval.cs` + sqlcmd 7 V1 contract — Case "audit > 5 files" |
+| **Chunk A Mig 31 schema** (Contract +ApprovalWorkflowId +CurrentApprovalLevelOrder) | 🟨 **Implementer Case 2** | Cookie-cutter mirror PE Mig 23 pattern proven 1× S17. Spec deterministic |
+| **Chunk B Service ApproveV2Async branch** | 👤 **Chủ trì Solo** | Cross-stack reasoning chain — Service branch theo pin field + state machine integration |
+| **Chunk C Mig 32 ContractLevelOpinions + Service UPSERT hook** | 🟨 **Implementer Case 2** | Mirror PE Mig 26 + service hook pattern (`feedback_service_hook_vs_endpoint`) |
+| **Chunk D FE ContractCreatePage Workspace Select V2** | 🟨 **Implementer Case 2** | Mirror PeCreate Workspace pattern × 2 app (rule §3.9) |
+| **Chunk E FE ContractDetailContent Section 5 V2** | 🟨 **Implementer Case 2** | Mirror PE Section 5 LevelOpinionsSectionV2 × 2 app |
+| **Pre-commit each chunk review** | 🟥 **Reviewer** | Heavy diff + cross-stack — Smart Friend guard active |
+| **Post-deploy verify Run** | 🟩 **CICD Monitor** | Bundle hash + Mig 31+32 prod + smoke endpoint mới |
+
+Estimated: 5-6 chunk, ~700+ LOC. Em main lead Chunk B (cross-stack reasoning) + coordinate. 4 chunk delegate Implementer (Case 2 cookie-cutter mirror).
+
+---
+
+## 🎯 Session 21 chốt cuối — 5 turn timeline (2026-05-12 → 2026-05-13)
+
+| Turn | Date/Time | Topic | Commits | CICD verify |
+|---|---|---|---|---|
+| t1 | 2026-05-12 0030 | Add cicd-monitor sub-agent (4th, Path A) | `f1c61c9` `3a34831` (2) | n/a (docs+config only) |
+| t2 | 2026-05-12 1800 | RAG Hybrid setup planning Cách A | `1f8e9af` `0a3b747` (2) | n/a (docs only) |
+| t3 | 2026-05-12 2100 | 🔴 Fix gotcha #45 PE button "Trả lại" mismatch + 3 regression test | `de00887` `4b29d00` `6d30ba4` (3) | bundled with t4 push |
+| t4 | 2026-05-13 1200 | F1+F2+F3 PE Workflow advanced options Mig 28 (workflow-level) | `0294693` `c56024b` `a508564` `d27caaf` `eea86fd` (5) | 🟩 Run #186 PASS 3m32s |
+| t5 | 2026-05-13 1400 | Refactor Allow* sang per-NV Mig 29 (UAT feedback "cấu hình cho từng người") | `0366946` `63234b2` `5ccb2a7` `c0af9e0` (4) | 🟩 Run #187 PASS 3m18s |
+
+**Cumulative 12 commits S21 pushed remote `3a34831..c0af9e0`.** No pending push.
+
+### Major schema evolution
+
+- S21 t4 Mig 28 +6 column `ApprovalWorkflows` (workflow-level Allow*)
+- S21 t5 Mig 29 → REFACTOR: +5 column `ApprovalWorkflowLevels` (per-Approver slot) + 1 column `Users` (per-Drafter F2) + BACKFILL bulk SQL + DROP 6 column `ApprovalWorkflows`
+
+### Pattern reusable saved memory (2 entry mới user-level)
+
+- `feedback_ef_migration_backfill_reorder` — EF auto drop-then-add WRONG cho data preservation, manual reorder ADD→BACKFILL SQL→DROP discipline. Cross-project pattern.
+- `feedback_per_nv_permission_scope` — Multi-role workflow flag split scope theo role context (Approver per-slot Level vs Drafter per-User global), KHÔNG gắn parent workflow-level. Decision tree role → table mapping.
+
+### Gotcha mới (gotchas.md count +1: 45 → 46)
+
+- `#46 Gitea Actions API` — path `/actions/tasks` not `/actions/runs` (Gitea v1 naming khác GitHub), cache stale ~2 min → cross-check VPS file mtime. Discovery từ CICD Monitor Run #186 + #187.
+
+### Plan G Trial Week 1 evidence (multi-agent ROI)
+
+| Spawn | Run | Cost | Verdict | Catch | Notes |
+|---|---|---|---|---|---|
+| 🟩 CICD Monitor #1 | Run #186 (S21 t4 deploy) | ~12K | PASS | 0 fail (green) | Gitea API discovery |
+| 🟩 CICD Monitor #2 | Run #187 (S21 t5 deploy) | ~110K | PASS | 0 fail (green) | Schema refactor verify all 5 stage |
+| 🟦 Investigator | seeds-only | 0 | n/a | n/a | Em main solo S21 t3-t5 (cross-stack) |
+| 🟨 Implementer | seeds-only | 0 | n/a | n/a | REFUSE 3× per criteria #3/#4 — correct |
+| 🟥 Reviewer | seeds-only | 0 | n/a | n/a | Em main self-review build+test |
+
+CICD Monitor ROI: 100% green = 0 catch but 100% peace of mind, automated verify thay em nhớ verify thủ công (recurring blind spot pattern S20). 2 bonus gotcha learnings saved cross-session.
+
+### Pending S22+ (cumulative carry)
+
+- **Plan C test-after bundle** — defer commit riêng sau UAT 2-3 lần ổn:
+  - Service `ApplyReturnModeAsync` 4 mode read level.Allow* (per-NV)
+  - Service skipToFinal read user.AllowDrafterSkipToFinal (per-Drafter)
+  - Helper `EnsureEditableForDetailsAsync` 3 scenario read level (Drafter scope / Approver match / Approver mismatch → Forbidden)
+  - Regression #44 silent 403 còn nợ (S18 — vi phạm test-before bug fix)
+- **User Management F2 toggle UI** — BE column `Users.AllowDrafterSkipToFinal` sẵn, FE chỉ cần thêm 1 checkbox vào UserEdit dialog (~30 phút). Defer khi admin UAT request.
+- **Plan B Contract V2 wire Mig 30+31** — chưa kick off (PE V2 + per-NV pattern đã proven, ready mirror sang Contract).
+- **Plan D-F-H-I** unchanged (carry from S21 t2 HANDOFF tree).
+
+### Audit định kỳ unchanged
+
+- Lần gần: 2026-05-04 manual
+- Lần kế: **2026-06-01** combined audit (skill + doc drift)
+- Drift sau S21: Mig 27→29 (+2), gotcha 44→46 (+2), memory 16→19 (+3), test 81→84 (+3). Threshold KHÔNG kích hoạt audit sớm.
+
+---
+
+## TL;DR Session 21 turn 5 — Refactor Allow* sang PER-NV (Mig 29 drop Mig 28)
+
+User feedback sau UAT S21 t4 deploy: "Cấu hình cho từng người nhé (chứ ko phải là cho toàn bộ quy trình duyệt), thêm table vào SQL luôn để cấu hình cho dễ."
+
+→ Refactor 6 Allow* options từ workflow-level (Mig 28) sang per-NV scope:
+- **F1 (4 mode Trả lại) + F3 (Edit Section 2)** = 5 flag MOVE xuống `ApprovalWorkflowLevels` (per slot Approver — cùng table với ApproverUserId).
+- **F2 (AllowDrafterSkipToFinal)** MOVE xuống `Users` (per-Drafter user, admin config ở User Management page).
+
+### Q&A clarify (2 lượt)
+
+| Câu | User chốt |
+|---|---|
+| Scope "từng người" | **Per-Level**: 5 flag (4 F1 + 1 F3) gắn slot Designer. F2 per-Drafter user. |
+| Mig 28 cũ xử lý sao | **Migrate bốc → per-NV bulk + drop**: copy workflow → all Levels của workflow, set TRUE cho Drafter user từng dùng workflow F2, rồi drop 6 column workflow. |
+
+### Chunk A — BE schema + Service refactor (`0366946`)
+
+Mig 29 `RefactorAdvancedOptionsToPerLevelAndDrafterUser` — 4-stage (EF
+auto-generated drop-then-add đã REORDER manual):
+
+1. **ADD 5 column** trên `ApprovalWorkflowLevels` (AllowReturnOneLevel/OneStep/
+   ToAssignee/ToDrafter[default true]/AllowApproverEditDetails)
+2. **ADD 1 column** trên `Users` (AllowDrafterSkipToFinal default false)
+3. **BACKFILL bulk SQL** (preserve admin config Mig 28):
+   ```sql
+   -- Levels: copy workflow.Allow* → all Levels của workflow
+   UPDATE l SET l.AllowReturnOneLevel = w.AllowReturnOneLevel, ...
+   FROM ApprovalWorkflowLevels l
+   INNER JOIN ApprovalWorkflowSteps s ON s.Id = l.ApprovalWorkflowStepId
+   INNER JOIN ApprovalWorkflows w ON w.Id = s.ApprovalWorkflowId;
+
+   -- Users: SET TRUE cho user từng Drafter PE link workflow Allow=true
+   UPDATE u SET u.AllowDrafterSkipToFinal = 1
+   FROM Users u WHERE EXISTS (
+     SELECT 1 FROM PurchaseEvaluations pe
+     INNER JOIN ApprovalWorkflows w ON w.Id = pe.ApprovalWorkflowId
+     WHERE pe.DrafterUserId = u.Id AND w.AllowDrafterSkipToFinal = 1
+   );
+   ```
+4. **DROP 6 column** workflow-level (Mig 28 cleanup)
+
+Domain entity refactor:
+- `ApprovalWorkflow.cs` — REMOVE 6 Allow* (S21 t4 Mig 28 cũ)
+- `ApprovalWorkflowLevel.cs` — ADD 5 Allow* (F1 + F3)
+- `User.cs` — ADD 1 Allow* (F2 AllowDrafterSkipToFinal)
+
+Service refactor `ApplyReturnModeAsync`:
+- Resolve currentLevel slot (CurrentWorkflowStepIndex + CurrentApprovalLevelOrder)
+- Read 5 Allow* từ `currentLevel.AllowXxx` thay vì workflow
+- Drafter mode validate AllowReturnToDrafter của currentLevel
+- V1 legacy phiếu → fallback Drafter tự động
+
+DRAFTER trình refactor:
+- Permission check moved → `drafterUser.AllowDrafterSkipToFinal`
+- `userManager.FindByIdAsync(actorUserId)` get Drafter user entity
+- Admin bypass unchanged
+
+Helper `EnsureEditableForDetailsAsync`:
+- Read `level.AllowApproverEditDetails` thay vì workflow
+- Error message rõ "Cấp Approver hiện tại (Bước X / Cấp Y)"
+
+DTO refactor:
+- `AwLevelDto +5 Allow*` (admin Designer GET per-Level)
+- `AwDefinitionDto -6 Allow*` (no longer workflow-level)
+- `CreateAwLevelInput +5 Allow*` (admin Designer POST per-Level)
+- `ApprovalWorkflowOptionsDto` chỉ còn 5 flag (F2 separate field)
+- `PurchaseEvaluationDetailBundleDto`:
+  - RENAME `WorkflowOptions` → `CurrentLevelOptions`
+  - ADD `DrafterAllowSkipToFinal bool`
+
+GetPe handler populate:
+- currentLevelOptions = 5 Allow* của Cấp hiện tại (null nếu V1 / no pointer)
+- drafterAllowSkipToFinal = User.AllowDrafterSkipToFinal từ DrafterUserId
+
+### Chunk B — FE Admin Designer (`63234b2`)
+
+ApprovalWorkflowsV2Page.tsx:
+- Types: `LevelDto +5 Allow*`, `DefinitionDto -6 Allow*`, `EditLevelEntry +5 Allow*`
+- Helper `makeDefaultLevelEntry(order, userId)` factory với 4 false + AllowReturnToDrafter=true
+- `copyFromDefinition` propagate 5 Allow* từ Levels cũ
+- REMOVE section "Cấu hình nâng cao" workflow-level (amber bg 6 checkbox)
+- REPLACE với info banner violet ngắn "ⓘ Cấu hình quyền duyệt riêng cho từng NV..."
+- Mỗi Level entry (NV row) ADD inline panel amber-50/30 5 checkbox grid-cols-2
+
+fe-user KHÔNG mirror (Designer admin-only).
+
+F2 cần UX riêng ở User Management page → defer commit sau (BE field đã sẵn,
+FE chỉ thêm 1 toggle UserEdit dialog khi admin UAT request).
+
+### Chunk C — FE eOffice (`5ccb2a7`) mirror 2 app
+
+Types:
+- `ApprovalWorkflowOptions` REMOVE allowDrafterSkipToFinal (5 flag)
+- `PeDetailBundle`:
+  - RENAME `workflowOptions → currentLevelOptions`
+  - ADD `drafterAllowSkipToFinal: boolean`
+
+PeWorkflowPanel.tsx:
+- RENAME local `wfOptions → levelOptions`, source `evaluation.currentLevelOptions`
+
+PeDetailTabs.tsx:
+- F3 approverEditMode: read `currentLevelOptions?.allowApproverEditDetails`
+- F2 allowSkipToFinal: read `drafterAllowSkipToFinal` (per-user)
+
+Backward compat:
+- Backfill Mig 29 preserve admin config S21 t4
+- Phiếu V1 legacy → currentLevelOptions=null → fallback chỉ Drafter mode
+- drafterAllowSkipToFinal TRUE chỉ cho user từng Drafter PE link workflow Allow=true
+
+### Chunk D — Docs (this commit)
+
+- `docs/database/schema-diagram.md §14`: title "Mig 22-29, S17-21" + add 5 column
+  Level inline comment + add 1 column User Mig 29 block
+- `docs/STATUS.md` Last updated S21 t5 + 28→29 mig
+- `docs/HANDOFF.md` TL;DR S21 t5 đầy đủ (file này)
+- Session log riêng
+
+### State chốt S21 turn 5
+
+| Metric | Trước (S21 t4) | Sau (S21 t5) | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| **Migrations** | 28 | **29** | **+1** (Mig 29 refactor per-NV) |
+| Endpoints | ~143 | ~143 | 0 (same body, different schema) |
+| FE pages | 34 | 34 | 0 |
+| Unit tests | 84 | 84 | 0 (UAT defer test-after §7) |
+| Gotchas | 45 | 45 | 0 |
+| Memory | 17 | 17 | 0 |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
+| **Commits S21 t5** | — | **4** | `0366946` → `63234b2` → `5ccb2a7` → this |
+
+### Pending — defer / next session
+
+- **User Management page F2 toggle**: thêm checkbox "Cho phép gửi PE thẳng Cấp cuối"
+  vào UserEdit dialog (BE column sẵn, FE 1 toggle nhỏ — defer khi admin UAT request)
+- **Test-after carry** (Plan C bundle): Service ApplyReturnModeAsync 4 mode +
+  EnsureEditableForDetailsAsync 3 scenario read-from-level + skipToFinal read-from-user
+
+---
+
+## TL;DR Session 21 turn 4 — F1+F2+F3 PE Workflow advanced options (Mig 28)
+
+User request 3 tính năng mới trong PE V2 Workflow:
+- **F1** 4 mode Trả lại admin stick: 1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo
+- **F2** Drafter gửi thẳng Cấp cuối (skip mọi Bước/Cấp trung gian)
+- **F3** Approver chỉnh sửa Section 2 (Hạng mục + NCC + Báo giá) khi đang duyệt
+
+### Q&A clarify chốt scope (2 lượt AskUserQuestion)
+
+- **F1 "1 bậc"** = cả 2 mode (admin chọn 1 Cấp HOẶC 1 Bước HOẶC cả 2 stick)
+- **F1 "Người chỉ định"** = Approver pick runtime từ list NV đã ký (PE.LevelOpinions)
+- **F1 behavior** = 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain). Mode Drafter giữ Phase=TraLai S17 fallback.
+- **F2 skip** = chỉ skip tới Level cuối (CEO) — Dropdown 2 option "Gửi tuần tự" vs "Gửi thẳng Cấp cuối"
+- **F2+F3 admin enable** = cả 2 cần admin tick per workflow (audit nghiêm)
+- **F3 approver perm** = mọi approver Cấp đang active (currentLevel match)
+- **F3 scope** = Section 2 only (Hạng mục + NCC + Báo giá), KHÔNG đụng PE Header, KHÔNG reset workflow
+- **Test** = test-after UAT default Phase 9 (skip dotnet test mỗi chunk, npm build × 2 app pass)
+
+### Chunk A — Mig 28 + Domain (`0294693`)
+
+`ApprovalWorkflow.cs` thêm 6 bool field:
+- `AllowReturnOneLevel` / `AllowReturnOneStep` / `AllowReturnToAssignee` (default false)
+- `AllowReturnToDrafter` (default **TRUE** — backward compat S17)
+- `AllowDrafterSkipToFinal` / `AllowApproverEditDetails` (default false)
+
+EF config `ApprovalWorkflowConfiguration` thêm 6 `HasDefaultValue` match Mig 28 DEFAULT.
+
+Mig 28 `AddAdvancedOptionsToApprovalWorkflows`:
+- 6 AddColumn bit NOT NULL DEFAULT 0/1
+- 3-file rule complete (mig.cs + Designer.cs + Snapshot.cs)
+- Apply LocalDB Dev + Design
+
+### Chunk B — BE Service + handlers + DTOs (`c56024b`)
+
+**Service interface + impl** `TransitionAsync` thêm 3 optional param (backward compat):
+- `WorkflowReturnMode? returnMode` (enum {OneLevel=1, OneStep=2, Assignee=3, Drafter=4})
+- `Guid? returnTargetUserId` (required khi mode=Assignee)
+- `bool skipToFinal`
+
+REJECT branch extend với helper `ApplyReturnModeAsync` switch 4 mode:
+- OneLevel: lùi 1 Cấp cùng Step. Bước 1 Cấp 1 → fallback Drafter.
+- OneStep: lùi sang Bước trước Cấp cuối. Bước 1 → fallback Drafter.
+- Assignee: tìm Step+Level match `ApproverUserId == returnTargetUserId`.
+- Drafter: Phase=TraLai clear pointer (S17 behavior).
+- 3 mode đầu giữ ChoDuyet + reset SLA 7d.
+- Admin bypass workflow.Allow* flag check.
+- Non-admin → throw ConflictException nếu flag disabled.
+
+DRAFTER trình branch extend với F2 skipToFinal:
+- Workflow.AllowDrafterSkipToFinal required (non-admin)
+- Set CurrentWorkflowStepIndex = Steps.Count-1 + CurrentApprovalLevelOrder = max Level
+- Audit comment append "[Drafter gửi thẳng Cấp cuối]"
+
+**Helper edit guard** `EnsureEditableForDetailsAsync` mới (PurchaseEvaluationDraftGuard class):
+- Drafter scope: DangSoanThao OR TraLai
+- F3 Approver scope: ChoDuyet + workflow.AllowApproverEditDetails + actor match CurrentLevel.ApproverUserId
+- Admin bypass workflow flag check
+
+**8 handler switch** sang helper mới + inject ICurrentUser khi cần:
+- Detail Add/Update/Delete + Quote Upsert/Delete (5 handler — replace EnsureDraftAsync)
+- Supplier Add/Update/Remove (3 handler — bonus security fix, trước đây hoàn toàn KHÔNG có phase guard!)
+- Update/Delete handler trước đây silent → thêm changelog `PhaseAtChange + UserId + Summary` (append `[Approver edit khi đang duyệt]` khi phase=ChoDuyet)
+
+**Command DTO + DTOs**:
+- `TransitionPurchaseEvaluationCommand` +3 optional field
+- `ApprovalWorkflowOptionsDto` NEW sub-record (6 Allow* flag)
+- `PurchaseEvaluationDetailBundleDto` +WorkflowOptions field
+- `AwDefinitionDto` +6 Allow* (admin Designer GET)
+- `CreateAwDefinitionCommand` +6 Allow* param (admin Designer POST)
+
+### Chunk C — FE Admin Designer (`a508564`)
+
+`ApprovalWorkflowsV2Page.tsx` Designer modal thêm section "Cấu hình nâng cao" 3 sub-group:
+
+1. Mode Trả lại 4 checkbox:
+   - Trả về 1 Cấp trước (peer review chain trong cùng Bước)
+   - Trả về 1 Bước trước (Cấp cuối Bước trước nhận lại)
+   - Trả về Người chỉ định (pick runtime từ NV đã ký)
+   - Trả về Người soạn thảo (default checked = backward compat S17)
+
+2. Drafter skip: 1 checkbox "Cho phép Drafter gửi thẳng Cấp cuối"
+
+3. Approver edit: 1 checkbox "Cho phép Approver chỉnh sửa Section 2"
+
+Styling: container amber-50/30 border distinct với Steps section. Helper text [10px] dưới label. Headers uppercase tracking.
+
+DTO types + state defaults từ cloneFrom (giữ config version trước) hoặc S17 fallback (chỉ AllowReturnToDrafter=true). POST body propagate 6 flag → BE Create handler set entity.
+
+fe-user KHÔNG mirror (Designer admin-only).
+
+### Chunk D — FE eOffice (`d27caaf`) mirror 2 app
+
+Types `purchaseEvaluation.ts`:
+- `ApprovalWorkflowOptions` type
+- `WorkflowReturnMode` const-object
+- `PeDetailBundle` +workflowOptions field
+
+`PeWorkflowPanel.tsx` F1 Trả lại radio picker:
+- State `returnMode` (default Drafter) + `returnTargetUserId`
+- Dialog Trả lại render 1-4 radio mode enabled theo wfOptions.Allow*
+- Assignee mode → submodal Select pick từ levelOpinions (NV đã ký), dedupe by userId
+- Banner amber rounded dưới mô tả hành vi mode chọn
+- Mutation payload +returnMode +returnTargetUserId khi isTraLaiAction
+
+`PeDetailTabs.tsx` F2 Drafter skip:
+- State `skipToFinal` + `allowSkipToFinal` từ workflowOptions
+- submitForApproval mutationFn accept opts.skipToFinal
+- Workspace action bar: checkbox violet "Gửi thẳng Cấp cuối (skip trung gian)" conditional
+- Confirm dialog message + button label dynamic theo skipToFinal
+
+`PeDetailTabs.tsx` F3 Approver edit Section 2:
+- useAuth import + compute `approverEditMode` (phase=ChoDuyet + workflowOptions.allowApproverEditDetails + actor match)
+- `itemsReadOnly = readOnly && !approverEditMode` → ItemsTab nhận
+- Banner violet "ⓘ Bạn được phép chỉnh sửa..." khi approverEditMode + readOnly (Duyệt menu)
+- InfoTab / NccSelectorRow / BudgetFieldRow GIỮ strict isEditablePhase (Header + Section 3, KHÔNG trong F3 scope)
+
+### Chunk E — Docs (this commit)
+
+- `docs/database/schema-diagram.md §14` cập nhật title "Mig 22-28, S17-21" + thêm 6 column Allow* trong Core block với inline comment F1/F2/F3
+- `docs/STATUS.md` Last updated S21 t4 + count 27→28 mig + UAT defer test count unchanged 84
+- `docs/HANDOFF.md` TL;DR S21 t4 đầy đủ (file này)
+- `docs/changelog/sessions/2026-05-13-1200-s21-turn4-pe-workflow-advanced-options.md` session log
+
+### State chốt S21 turn 4
+
+| Metric | Trước (S21 t3) | Sau (S21 t4) | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| **Migrations** | 27 | **28** | **+1** (Mig 28 6 column Allow*) |
+| Endpoints | ~142 | ~143 | +1 (extend transitions body) |
+| FE pages | 34 | 34 | 0 (Designer extend section) |
+| **Unit tests** | 84 | **84** | 0 (UAT defer test-after §7) |
+| Gotchas | 45 | 45 | 0 |
+| Memory entries | 17 | 17 | 0 |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
+| **Commits S21 t4** | — | **5** | (`0294693` → `c56024b` → `a508564` → `d27caaf` → this) |
+
+### Pending — Test-after (Plan C carry)
+
+Per `feedback_uat_skip_verify` Phase 9 default: viết test sau UAT 2-3 lần ổn.
+Test scope candidate (test-after-uat commit riêng):
+- Service `ApplyReturnModeAsync` 4 mode happy path (OneLevel/OneStep/Assignee/Drafter)
+- Service skipToFinal happy path + AllowDrafterSkipToFinal=false → ConflictException
+- `EnsureEditableForDetailsAsync` 3 scenario: Drafter scope / Approver match / Approver mismatch → Forbidden
+
+Bundle với Plan C existing (test #44 silent 403 + test V2 ApproveV2Async + Mig 25/27 PATCH).
+
+---
+
+## TL;DR Session 21 turn 3 — Bug fix CRITICAL "Trả về nhưng hệ thống vẫn duyệt" (gotcha #45)
+
+User UAT 2026-05-12 21:00 screenshot button labeled `← Trả lại` trong PE Workflow Panel (menu "Duyệt"), mô tả hành vi: nhấn vào nhưng phiếu KHÔNG về phase TraLai — ngược lại tiến qua Cấp tiếp theo. User mô tả: "Trả về nhưng hệ thống vẫn duyệt".
+
+### Diagnose (em main solo, no agent spawn)
+
+3 chỗ inconsistency cùng pattern trong `PeWorkflowPanel.tsx` (× 2 app fe-admin + fe-user):
+
+| # | Location | Logic | Bug? |
+|---|---|---|---|
+| 1 | L205-207 button `isSendBack` | include TraLai → label `← Trả lại` ĐÚNG | ✅ no bug |
+| 2 | L64-66 payload `isReject` | thiếu nhánh TraLai → gửi `decision: 1` (Approve) | 🔴 BUG ROOT |
+| 3 | L247-248 dialog `isSendBack` | thiếu nhánh TraLai → dialog title fallback `'✓ Duyệt → Trả lại'` + no amber warning | 🔴 BUG phụ |
+
+BE `PurchaseEvaluationWorkflowService.TransitionAsync`:
+- L51 `if (decision == Reject)` branch → đúng cho decision=Reject.
+- L97 `APPROVE STEP` branch khi decision=Approve + fromPhase=ChoDuyet → ApproveV2Async UPSERT opinion + advance Cấp.
+- → FE gửi `decision=1` (do bug `isReject`) → BE đi vào nhánh APPROVE thay vì REJECT → phiếu approve mặc dù user định trả lại.
+
+### Chunk A — BE defense-in-depth + 3 regression test (`de00887`)
+
+**Test-before §7 BẮT BUỘC:** Viết test reproduce bug TRƯỚC fix.
+
+```csharp
+// Sau line 48 (set isAdmin/isSystem), trước REJECT branch (L51)
+if ((targetPhase == PurchaseEvaluationPhase.TraLai
+        || targetPhase == PurchaseEvaluationPhase.TuChoi)
+    && decision != ApprovalDecision.Reject)
+{
+    throw new ConflictException(
+        $"Transition tới {targetPhase} BẮT BUỘC decision=Reject (nhận {decision}). " +
+        "Báo lỗi caller — payload mismatch giữa target phase và decision.");
+}
+```
+
+Boundary protection cho mọi caller tương lai (API client / mobile / cron retry). Guard KHÔNG xoá khi FE fix — defense-in-depth.
+
+3 test file `tests/SolutionErp.Infrastructure.Tests/Services/PurchaseEvaluationWorkflowServiceGuardTests.cs`:
+- `TransitionAsync_TargetTraLai_WithApproveDecision_Throws_AndDoesNotMutateState` — reproduce bug, expect `ConflictException` "*TraLai*Reject*"
+- `TransitionAsync_TargetTuChoi_WithApproveDecision_Throws_AndDoesNotMutateState` — consistency cover TuChoi
+- `TransitionAsync_TargetTraLai_WithRejectDecision_SetsPhaseTraLai` — happy path control (Reject branch vẫn đúng)
+
++ `NoOpNotificationService` stub reusable cho future PE service tests (avoid `INotificationService` real DI complexity).
+
+Run test → 2 FAIL (reproduce bug, BE đi sâu vào ApproveV2Async throw "Phiếu chưa pin workflow") + 1 PASS (happy path). Thêm BE guard → 3 PASS. Tổng `dotnet test SolutionErp.slnx` 84 PASS (+3 from 81 baseline).
+
+### Chunk B — FE fix mirror 2 app (`4b29d00`)
+
+3 chỗ × 2 app = 6 edits:
+
+```typescript
+// Chỗ 1: isReject payload (L64-66)
+const isReject = target === PurchaseEvaluationPhase.TuChoi
+  || (target === PurchaseEvaluationPhase.DangSoanThao
+      && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao)
+  || (target === PurchaseEvaluationPhase.TraLai             // ← THÊM
+      && evaluation.phase !== PurchaseEvaluationPhase.TraLai)
+
+// Chỗ 3: dialog isSendBack (L247-248)
+const isSendBack = (target === PurchaseEvaluationPhase.DangSoanThao
+                    || target === PurchaseEvaluationPhase.TraLai)   // ← THÊM
+  && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao
+  && evaluation.phase !== PurchaseEvaluationPhase.TraLai             // ← THÊM
+```
+
+Chỗ 2 (button label `isSendBack` L205-207) đã đúng từ S17, KHÔNG đụng.
+
+Verify: `npm run build` × 2 app pass (fe-user 17.91s + fe-admin 6.71s, 0 TS6 err).
+
+### Chunk C — Docs (this commit)
+
+- `docs/gotchas.md` +#45 PE button label vs decision payload mismatch (~120 dòng narrative + 2 commit cross-ref + pattern reusable + phòng tránh tương lai)
+- `docs/gotchas.md` checklist debug +entry 22 quick lookup
+- `docs/STATUS.md` Last updated S21 t3 + count 81→84 test + 44→45 gotcha
+- `docs/HANDOFF.md` TL;DR S21 t3 narrative đầy đủ (file này)
+- `docs/changelog/sessions/2026-05-12-2100-s21-turn3-fix-tra-lai-bug45.md` session log mới
+
+### Pending (carry from S21 turn 2)
+
+Plans A-I unchanged. Plan C1 (test regression gotcha #44 silent 403 S18) vẫn còn nợ — không bundle với S21 t3 fix (scope khác, ưu tiên unblock UAT bug critical trước).
+
+### Audit cadence
+
+- Lần gần nhất: 2026-05-04 manual trễ 4 ngày
+- Lần kế: **2026-06-01** combined audit
+- Drift sau S21 t3: 44→45 gotcha (+1) + 81→84 test (+3) + 17→17 memory (no new) + 6 skills unchanged
+
+### State chốt S21 turn 3
+
+| Metric | Trước (S21 t2) | Sau (S21 t3) | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| Migrations | 27 | 27 | 0 |
+| Endpoints | ~142 | ~142 | 0 |
+| FE pages | 34 | 34 | 0 |
+| **Unit tests** | 81 | **84** | **+3** (PE guard) |
+| **Gotchas** | 44 | **45** | **+1** (#45) |
+| Memory entries | 17 | 17 | 0 |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
+| **Commits S21 t3** | — | **3** | (`de00887` + `4b29d00` + this) |
+
+---
+
+## TL;DR Session 21 turn 2 — RAG Hybrid setup planning (Cách A chốt + 3-layer pattern)
+
+User clarify 5 dự án future > 1M MD tokens → cuộc thảo luận deep ~15 turn về RAG infrastructure. Em main solo (no SOLUTION_ERP sub-agent spawn), delegate 2 lần claude-code-guide agent research Anthropic + community practice.
+
+### Q&A deep dive 10 topics
+
+1. RAG fundamentals + Vector DB role (Qdrant)
+2. Embedding "AI nhúng" + Voyage AI cost mechanics ($0.18/M tokens)
+3. Multi-project shared architecture (5 projects → single Qdrant + per-collection)
+4. Audit procedure 3-tier (weekly auto + monthly deep + quarterly major)
+5. UI/UX Streamlit dashboard 7 pages design
+6. Cách A defensive (giữ blanket 120K) vs Cách B aggressive (cắt 60-70%)
+7. Reasoning depth comparison: lazy 60% → A 90% → B 75-80%
+8. Industry validation: Anthropic + Cursor + Continue + Cline + Aider all hybrid
+9. Multi-agent cost reality: 8-10× multiplier, ~520K cumulative blanket 5 entities
+10. 3-layer hybrid pattern (Anthropic Contextual Retrieval Sept 2024)
+
+### Quyết định chốt — Cách A vs Cách B
+
+**Chọn Cách A** (defensive hybrid):
+- Blanket: GIỮ NGUYÊN 120K em main + RAG retrieve supplement
+- Sub-agent spawn baseline: ~80-100K each (4 agents = ~400K cumulative)
+- Heavy session billed: ~560K (saving -20% vs lazy 700K)
+- Quality recall: ~85% (vs Cách B 75-80% do fragmentation)
+
+**Why Cách A** (bro priority chốt):
+- ✅ Em main control flow strong (state ownership direct, response fast)
+- ✅ Decision quality 90% (multi-source cohesive reasoning)
+- ✅ Wall-clock per task -20% (12 phút vs Cách B 16 phút)
+- ✅ Risk-averse (graceful fallback blanket nếu RAG fail)
+- ✅ Multi-agent leverage cache 70-90% hit common queries
+- ✅ Industry-validated (Anthropic + Cursor + Continue + Cline + Aider)
+
+### 3-layer hybrid Phase rollout (Anthropic Contextual Retrieval)
+
+| Phase | Layers | Recall | Cost/mo |
+|---|---|---|---|
+| Phase 1 (Week 1-4) | Vector embedding only (Voyage-3-large) | ~70% | ~$1.50 |
+| Phase 2 (Month 2) | + BM25 hybrid (bm25s free local) | ~78% | ~$1.50 |
+| Phase 3 (Month 3) | + Voyage rerank-2 + Contextual prefix | ~92% | ~$4-5 |
+
+### Stack validated cross-industry
+
+- Voyage AI embedding (Anthropic partner, multilingual 26 lang)
+- Qdrant local (Rust binary, "leading agent memory backend 2026")
+- FastMCP Python (official Anthropic SDK)
+- SQLite event log + Streamlit dashboard 7 pages
+- Pre-commit hook re-index delta
+
+### Multi-agent cost reality (Anthropic warn 8-10× multiplier)
+
+```
+Per entity blanket Cách A:
+  Em main: ~120K
+  4 sub-agents × ~100K spawn = 400K cumulative
+  Total: ~520K cumulative billed (not single context window)
+
+Heavy session 4-agent spawn:
+  Lazy: ~700K effective billed
+  Cách A: ~560K (-20% from multi-agent shared cache)
+```
+
+### Plan I NEW — RAG Setup Implementation (defer)
+
+**Trigger:** Bro confirm 5 dự án path + stack + pilot choice + Voyage API key + disk cleanup 5-8GB.
+
+**Schedule:** Dedicated session 10-14h weekend (per `feedback_drastic_refactor_scope`).
+
+**Phase rollout:**
+- Phase 1 single project pilot 4-week trial
+- Phase 2-3 upgrade incremental conditional on Phase 1 success
+- Cost realistic: ~$2-5/month total cho 5 projects
+
+### Deliverables
+
+- ✅ `docs/rag-setup-plan.md` (commit `1f8e9af` 1223 LOC + extend S21 t2 ~300 LOC = ~1500 LOC final)
+- ✅ Memory `feedback_rag_hybrid_pattern.md` (NEW cross-project reusable)
+- ✅ MEMORY.md index +1 entry
+- ✅ Session log this chốt
+- ⏭ Implementation defer chờ trigger
+
+### Em main solo S21 turn 2 (no SOLUTION_ERP sub-agent spawn)
+
+3 spawn này session — KHÔNG phải 4 SOLUTION_ERP sub-agents:
+- claude-code-guide × 2 (generic agent for Anthropic + industry research)
+- 4 SOLUTION_ERP sub-agents (Inv/Imp/Rev/CICD) vẫn seeds-only
+
+### State chốt S21 turn 2
+
+| Metric | Trước | Sau | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| Migrations | 27 | 27 | 0 |
+| Endpoints | ~142 | ~142 | 0 |
+| FE pages | 34 | 34 | 0 |
+| Unit tests | 81 | 81 | 0 |
+| Gotchas | 44 | 44 | 0 |
+| **Memory entries** | 16 | **17** | **+1** (RAG hybrid pattern) |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
+| **Commits S21 cumulative** | 2 | **4** | **+2** |
+| **Plan files** | 0 | **1** (`rag-setup-plan.md`) | **+1** |
+
+---
+
+## TL;DR Session 21 turn 1 — Add cicd-monitor (4th sub-agent, Path A chốt)
+
+User chốt Path A sau pre-flight Plan G Trial Week 1 (S20 wrap đã setup 3 agents Inv/Imp/Rev): thêm sub-agent thứ 4 chuyên post-deploy verify (Gitea Actions poll + bundle hash × 2 app + sqlcmd mig prod + endpoint smoke). **Trade-off chốt:** +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động — recurring blind spot pattern em main solo S20 quên verify ~30% push.
+
+### Em main solo S21 turn 1 (no agent spawn)
+
+1 turn từ S20 wrap chiều/đêm 2026-05-11 22:00 sang sáng/đêm 2026-05-12. Em main solo qua context paste + Write file. **3 agents (Inv/Imp/Rev) KHÔNG spawn**, vẫn seeds-only state. cicd-monitor mới setup file (Write), chưa spawn work.
+
+### Deliverables (1 commit `f1c61c9`, 456 +/-23 LOC)
+
+| File | Loại | LOC |
+|---|---|---|
+| `.claude/agents/cicd-monitor.md` | NEW system prompt (~7KB) | ~200 |
+| `.claude/agent-memory/cicd-monitor/MEMORY.md` | NEW seed (~5KB) | ~150 |
+| `.claude/agents/README.md` | UPDATE 4-agent architecture | +~80 / -23 |
+| `feedback_multi_agent_setup.md` (user-level memory) | UPDATE 3 → 4 agents | +12 / -6 |
+
+### Q&A chốt scope (Path A vs B)
+
+- **Path A (chọn):** cicd-monitor READ tier (~150K/spawn) — catch fail tự động
+- **Path B (bỏ):** Em main thêm checklist verify manual (~0 cost) — phụ thuộc memory + recurring miss
+- **Decision rationale:** Recurring blind spot S20 ~30% push quên verify → tự động hóa worth +150K trade-off
+
+### CI skipped (gotcha #41 path filter)
+
+3 file `.md` → match `paths-ignore: '**/*.md'` → CI không trigger → prod IIS không thay đổi. Đây là **expected behavior** — agent infrastructure là local Claude Code only, KHÔNG cần deploy lên prod IIS. Khi spawn agent đọc file `.md` từ local filesystem.
+
+### State chốt S21 turn 1
+
+| Metric | Trước S21 | Sau S21 t1 | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| Migrations | 27 | 27 | 0 |
+| Endpoints | ~142 | ~142 | 0 |
+| FE pages | 34 | 34 | 0 |
+| Unit tests | 81 | 81 | 0 (no test added) |
+| Gotchas | 44 | 44 | 0 |
+| Memory entries | 16 | 16 | 0 (update existing entry only) |
+| Skills | 6 | 6 | 0 |
+| **Sub-agents** | **3 seeds-only** | **4 seeds-only** | **+1 cicd-monitor green** |
+| Commits S21 | — | **1** | (`f1c61c9`) |
+
+### Plan G (Multi-agent Trial 4-week) update post-S21 t1
+
+- ✅ **Setup phase complete**: 3 agents S20 t12 + 1 agent S21 t1 → 4 sub-agents seeds-only ready
+- ⏳ **Week 1 pending**: Plan B Contract V2 wire Mig 28+29 — kick-off Session 21 turn 2+
+- ⏳ **Pass criteria updated**: Rev catch ≥ 2 wire bugs + **CI/CD Monitor catch ≥ 1 deploy ship fail** (bundle hash unchanged / mig drift) + saving ≥ 25% Case 1+2 + Max 20× quota comfortable
+
+### Next session priority unchanged (carry from S20 wrap)
+
+- **Plan B** (HIGH) Contract V2 wire — Trial Week 1 kick-off với 4 agents
+- **Plan C** (HIGH) Test gap fill (B4 silent 403 + Mig 25/26/27 PATCH) — bundle Chunk E Plan B
+- **Plan D** Hard blockers ops (UAT/SMTP/creds/backup)
+- **Plan E** Phân quyền strict V2 + drop legacy V1
+- **Plan F** Audit định kỳ 2026-06-01 (chưa đến — KHÔNG tự chạy)
+
+### Cost reality update
+
+| Metric | Trước (3 agents) | Sau (4 agents) |
+|---|---|---|
+| Spawn setup total | ~564K | **~750K** (+150K cicd-monitor) |
+| Heavy session | ~1.2M (~6× solo) | **~1.35M (~6.5× solo)** |
+| Optimized cached | ~600K (~3× solo) | **~700K (~3.5× solo)** |
+
+Max 20× plan absorbs ~3.5× solo cost comfortable.
+
+---
+
+## TL;DR Session 20 WRAP (turns 1-12 chốt 2026-05-11)
+
+User UAT live iteration liên tục — 12 turns trong 1 ngày (sáng-trưa-chiều-tối-đêm). 14 commit cumulative.
+
+### 3 chủ đề lớn
+
+1. **PE Detail UI restructure** (turns 1-5 + 6 + 8-10): User yêu cầu 3 polish UX core + 4 polish nhỏ.
+   - Turn 1-5 wrap commit `9dee00d→f2f01f4→f8e5675`: Section reorder (Hạng mục lên #2 + auto-seed 1 row từ gói thầu) → Nested grid HangMucCard NCC expand (drop SuppliersTab dead code) → Section Ý kiến gộp đồng cấp 1 box / Step
+   - Turn 6 `f568945`: Manual budget "Nhập tay" drop tên field, chỉ giữ số tiền + VND format
+   - Turn 8-10: NCC palette 5-màu cycle + Winner icon ✓ đậm + hover transition + AddSupplier auto-fill master data 4 field
+2. **Admin menu eOffice management** (turn 7): Mig 27 `IsVisible + DisplayLabel` cột MenuItem + PATCH `/api/menus/{key}` + NEW `MenuVisibilityPage` ~210 LOC + fe-user Layout filter !isVisible + render `displayLabel || label`. Admin sidebar luôn dùng Label gốc (Q2=b).
+3. **Infrastructure** (turns 11-12):
+   - Turn 11 responsive 4-tầng pattern cho laptop nhỏ → memory `feedback_responsive_laptop_breakpoint.md`
+   - Turn 12 SETUP 3 sub-agents (Investigator + Implementer + Reviewer) + em main coordinator → memory `feedback_multi_agent_setup.md`
+
+### Stats cumulative
+
+| Metric | Trước S20 | Sau S20 | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| Migrations | 26 | **27** | +1 (Mig 27 menu visibility) |
+| Endpoints | ~141 | **~142** | +1 (PATCH /menus/{key}) |
+| FE pages | 33 | **34** | +1 (MenuVisibilityPage) |
+| Menu keys | ~60 | **~61** | +1 (MenuVisibility) |
+| Unit tests | 81 | 81 | 0 (Phase 9 UAT defer §7) |
+| Gotchas | 44 | 44 | 0 |
+| Memory entries | 14 | **16** | +2 (responsive t11 + multi-agent t12) |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 0 | **3** | +3 (Inv + Imp + Rev seeds) |
+| Commits S20 | — | **14** | (`9dee00d` → `ae1814c`) |
+
+### Multi-agent state chốt session
+
+3 sub-agents vừa setup turn 12 → **seeds-only state, chưa spawn work**. KHÔNG có findings để flush cross-agent learnings ở session này.
+
+**Trial Week 1 sẽ kick off Session 21:**
+- Investigator pre-flight: audit PE V2 schema patterns (Mig 22-27) + Permission flow → spec Contract V2
+- Implementer Chunk A-E (Mig 28 ALTER Contract + Mig 29 ContractLevelOpinions + Service ApproveV2Async + Controller + FE mirror)
+- Reviewer pre-commit verify gotcha #42 (V1/V2 dual schema branch)
+- Em main: architecture decisions + scope refusals + final synthesize
+
+### Memory entries mới capture S20
+
+1. `feedback_responsive_laptop_breakpoint.md` (t11) — 4-tầng pattern: sidebar w-60 xl:w-72 + workspace 2-panel lg:260 xl:320 + Section padding xs/sm responsive + Card flex-wrap. Phân biệt `lg` vs `xl` breakpoint quan trọng cho laptop nhỏ.
+2. `feedback_multi_agent_setup.md` (t12) — Decision gate 6-criteria. Anthropic + Cognition hybrid. Implementer ACCEPT/REFUSE strict rules. Windows MAX_PATH pitfall (drop isolation worktree). NAMGROUP s41-s43 ROI curve.
+
+### Pending Session 21+ (cumulative carry over)
+
+**Plan cha B (HIGH priority) — Contract V2 wire Mig 28+29:** mirror PE pattern S17-S19 + S20 turn 7. Audit-reuse memory `feedback_audit_reuse_before_clone` áp dụng — discriminator `ApplicableType.Contract=3` đã chung 80% với PE schema V2. 6-task plan:
+- Task 1: Mig 28 ALTER `Contract.ApprovalWorkflowId? + CurrentApprovalLevelOrder?`
+- Task 2: Mig 29 CREATE `ContractLevelOpinions` (mirror PE Mig 26 UNIQUE + FK Cascade/Restrict)
+- Task 3: `ContractWorkflowService.ApproveV2Async` branch + UPSERT opinion
+- Task 4: `ContractCreatePage` Workspace Select V2 (validate ApplicableType=3)
+- Task 5: Pin V2 mặc định cho ContractType qua Designer (admin)
+- Task 6: `ContractDetailContent` Section "Ý kiến cấp duyệt" V2 dynamic mirror S20 Chunk C
+
+**Plan cha C (HIGH priority) — Test coverage gap fill (§7):**
+- Test regression B4 silent 403 S18 (HIGH — vi phạm rule §7 test-before bug fix)
+- Test V2 Service wire `ApproveV2Async` UPSERT opinion (Mig 26) + Section gộp render (S20 t1-5 Chunk C)
+- Test Mig 25 PATCH `/user-selectable` endpoint
+- Test PATCH `/api/menus/{key}` Mig 27 (mới)
+
+**Plan cha D — Hard blockers ops (chờ user/ops):** UAT thật 1 tuần / SMTP / Rotate creds / SQL backup schedule / win-acme fix / remove `.huypham.vn` binding
+
+**Plan cha E — Phân quyền strict V2 + drop legacy V1:**
+- List/Inbox/Detail filter actor scope (V2 đã đúng — `ResolveV2InboxIdsAsync`)
+- Drop tables V1 sau UAT confirm: WorkflowDefinitions/Steps/Approvers + column RejectedAtStepIndex/RejectedFromPhase
+- Mig 30 drop Mig 15 PurchaseEvaluationDepartmentOpinions cleanup
+
+**Plan cha F — Audit định kỳ 2026-06-01:** skill stale (`ef-core-migration` "21" → 27 / `dependency-audit-erp` 41 → 44) + `schema-diagram` §16-21 + memory consolidate xem có duplicate
+
+**Plan cha G NEW — Multi-agent trial 4 tuần (Week 1-4):** evaluate ROI keep/tune/archive 3 sub-agents
+
+### Audit cadence
+
+- Lần gần nhất: 2026-05-04 manual trễ 4 ngày
+- Lần kế: **2026-06-01** combined audit
+- Drift sau S20: Mig 27 + 1 menu key + +2 memory entries + 3 sub-agents NEW + (no gotcha new). `ef-core-migration` skill "21 migration" stale → thực 27 sau S20 t12
+
+## TL;DR Session 20 turn 7 — Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27)
+
+User UAT live yêu cầu thêm tính năng admin quản lý menu eOffice (fe-user) — Ẩn/Hiện + Đổi tên hiển thị. Hỏi xác nhận "chưa có?" → đúng, chưa có. User clarify **Q2=b "edit hiển thị bên ngoài, chỉ của eOffice thôi"** → admin sidebar luôn dùng Label gốc, DisplayLabel CHỈ áp render fe-user.
+
+### Q&A chốt scope
+
+- Q1=**a** Global (không per-role — permission matrix đã handle)
+- Q2=**b** DisplayLabel chỉ fe-user, admin sidebar giữ Label gốc
+- Q3=**a** Giữ USER_HIDDEN_KEYS hardcode + tầng IsVisible dynamic combine
+- Q4=ok UAT iteration skip test, vẫn npm build mỗi chunk
+
+### Chunk A (`2ea2d27`) — Schema + Migration 27
+
+Domain MenuItem +IsVisible bool=true +DisplayLabel string?(200). EF config HasDefaultValue(true) + HasMaxLength(200). Migration 27 AddVisibilityAndDisplayLabelToMenuItems (2 AddColumn) — 3-file rule. Apply LocalDB Dev + Design qua --connection override.
+
+### Chunk B (`ef394f8`) — BE API
+
+DTO MenuNodeDto + MenuItemDto +isVisible +displayLabel. GetMyMenuTreeQueryHandler pass through (KHÔNG filter server-side — 2 FE app tự quyết render). NEW UpdateMenuItemCommand + Validator (Key required + DisplayLabel max 200) + Handler (whitespace → null). MenusController +PATCH /api/menus/{key} [Authorize Policy="Permissions.Update"].
+
+### Chunk C (`059bfcb`) — FE Admin MenuVisibilityPage
+
+Domain MenuKeys +MenuVisibility. DbInitializer +leaf System/MenuVisibility (Eye, Order=94). FE Admin: types/menu.ts mirror, lib/menuKeys.ts +const, Layout resolver +/system/menu-visibility, App.tsx +Route. NEW pages/system/MenuVisibilityPage.tsx ~210 LOC:
+- PageHeader + description nhắc admin sidebar dùng Tên gốc
+- 4 StatCard (Tổng / Hiển thị / Đã ẩn / Đã đổi tên)
+- Search box (key | label | displayLabel)
+- Table 5 cột: Key mono + parentKey ↳ / Tên gốc / Input "Tên hiển thị" inline (placeholder "Mặc định: {label}") / Toggle button emerald-Eye / amber-EyeOff / Lưu (khi dirty) + Khôi phục (khi custom)
+- onSuccess invalidate `['menus','all']` + `['my-menu']` → live update
+
+### Chunk D (`1ed6530`) — fe-user Layout filter + render
+
+types/menu.ts mirror. Layout.tsx:
+```tsx
+function filterForUser(nodes: MenuNode[]) {
+  // 2 tầng: hardcode USER_HIDDEN_KEYS + dynamic !isVisible
+  return nodes.filter(n => !USER_HIDDEN_KEYS.has(n.key) && n.isVisible !== false)
+              .map(n => ({ ...n, children: filterForUser(n.children) }))
+}
+function effectiveLabel(n) { return (n.displayLabel?.trim()) || n.label }
+```
+Replace 3 callsite `{node.label}` → `{effectiveLabel(node)}`. **fe-admin Layout KHÔNG đụng** — render Label gốc + show hết menu (Q2=b).
+
+### Pending S21+ (cumulative carry over)
+
+1. Test V2 Service wire + Section gộp + B4 silent 403 + Mig 25 PATCH user-selectable
+2. **Contract V2 wire (Mig 28+29 mirror PE)** — biggest pending
+3. Phân quyền strict V2 + drop legacy V1 + Mig 15 cleanup
+4. Test PATCH /api/menus/{key} validate (Mig 27)
+5. Skill `permission-matrix` thêm section "menu visibility" — defer cron audit 2026-06-01
+6. UX verify trong UAT: admin ẩn menu cha → children có ẩn theo không (FE filter chỉ check `!n.isVisible` per-node)
+
+### Hard blockers ops (carry)
+
+UAT thật / SMTP / Rotate creds / SQL backup schedule / win-acme fix / remove `.huypham.vn`
+
+## TL;DR Session 20 — PE Detail UI restructure 3 yêu cầu UX user (previous)
+
+Note: TL;DR Session 20 PE Detail UI giữ nguyên dưới (rule §6.5 KEEP narrative). Session 20 turn 7 này thêm trên cùng (admin menu visibility — chủ đề khác).
+
+ (4 chunk `9dee00d`→`2bba851`→`f2f01f4`→Docs). FE-only restructure (1 hook BE nhẹ auto-seed Detail). Q1=a giữ Section "Chọn NCC TP" riêng / Q2=a NCC shared + 1 hạng mục demo / Q3=a chỉ hiện NV đã ký / Q4 public luôn (skip dotnet test, vẫn npm build × 2 app mỗi chunk vì rename/remove function). Chunk A: BE CreatePE handler thêm 1 PurchaseEvaluationDetail mặc định (NoiDung=TenGoiThau, ThanhTienNganSach=Budget.TongNganSach||BudgetManualAmount||0) + FE reorder section Hạng mục lên #2. Chunk B: ItemsTab restructure list HangMucCard 1 card / hạng mục với expand panel chứa NCC inline table 8 cột (NCC/Liên hệ/Điều khoản TT/File báo giá/ĐG chưa VAT/ĐG có VAT/Thành tiền/Action). Click cell quote → QuoteDialog reuse. Drop SuppliersTab function ~134 LOC dead code, giữ 2 dialog + SupplierAttachmentsCell. Section 4 NCC tham gia gộp vào Section 2 → 4 section final (Thông tin/Hạng mục nested/Chọn NCC TP thắng thầu/Ý kiến). Chunk C: LevelOpinionsSectionV2 forEach step → 1 StepOpinionsBox (replace grid-cols-2 N approvers). Header "Bước N — Tên" + dept badge + "X/Y đã duyệt" counter. Body filter signed opinions sort levelOrder asc + signedAt asc → StepOpinionEntry per signed (tên + Cấp badge + admin override badge + timestamp + comment). NV chưa duyệt KHÔNG hiển thị. KHÔNG đụng Mig 26 schema. Drop LevelOpinionBox function. 81 test pass unchanged (UAT defer).**)
+
+## TL;DR Session 20 — PE Detail UI restructure 3 yêu cầu user UX
+
+User UAT live feedback: "Logic khá OK rồi, điều chỉnh giao diện chỗ Duyệt NCC 1 tý". 3 yêu cầu cụ thể:
+
+1. Hạng mục đưa lên phía trên + auto-tạo 1 hạng mục từ gói thầu (tên = TenGoiThau, giá trị = ngân sách)
+2. NCC expand dưới hạng mục (tầng 1 = hạng mục, tầng 2 = NCC, thông tin nhập trên grid)
+3. Section Ý kiến: gộp comment đồng cấp cùng Phòng → 1 ô / bước (chỉ hiện NV đã duyệt)
+
+### Q&A clarify trước code (chốt scope)
+
+- **Q1=a**: Giữ Section "Chọn NCC TP thắng thầu" riêng (rõ UX, không gộp dropdown winner vào nested grid)
+- **Q2=a**: NCC shared cross-hạng mục (như schema PE.Suppliers hiện tại) — "nhưng hiện chỉ cần 1 hạng mục trước tiên" → đơn giản scope Chunk B
+- **Q3=a**: CHỈ hiển thị NV đã ký (KHÔNG show placeholder "— chưa duyệt")
+- **Q4 public luôn demo**: Phase 9 UAT iteration skip `dotnet test` mỗi chunk, vẫn chạy `npm run build` × 2 app mỗi chunk (rule UAT skip verify exception cho rename/remove function — đã catch TS6133 SuppliersTab + SupplierAttachmentsCell)
+
+### Chunk A (`9dee00d`) — BE auto-seed Hạng mục + FE reorder section
+
+**BE — `PurchaseEvaluationFeatures.cs` `CreatePurchaseEvaluationCommandHandler`:**
+
+```csharp
+var defaultBudgetValue = linkedBudgetTotal ?? request.BudgetManualAmount ?? 0m;
+var defaultDetail = new PurchaseEvaluationDetail
+{
+    PurchaseEvaluationId = entity.Id,
+    GroupCode = "01",
+    GroupName = "Hạng mục chính",
+    NoiDung = request.TenGoiThau,
+    DonViTinh = "gói",
+    KhoiLuongNganSach = 1m,
+    KhoiLuongThiCong = 1m,
+    DonGiaNganSach = defaultBudgetValue,
+    ThanhTienNganSach = defaultBudgetValue,
+    Order = 1,
+};
+db.PurchaseEvaluationDetails.Add(defaultDetail);
+// + Changelog Insert audit
+```
+
+`linkedBudgetTotal` mới: nếu PE link Budget, fetch `Budget.TongNganSach` (computed sum BudgetDetails). Nếu không link, fall back `BudgetManualAmount`. Nếu cả 2 null → 0.
+
+**FE — Reorder section** (mirror fe-admin + fe-user, Chunk A intermediate state):
+1.Thông tin / **2.Hạng mục (lên #2)** / 3.Chọn NCC / 4.NCC tham gia / 5.Ý kiến.
+
+Verify: `dotnet build SolutionErp.slnx` 0 warn / 0 err.
+
+### Chunk B (`2bba851`) — Nested grid Hạng mục → NCC expand
+
+Restructure `ItemsTab` thành list `HangMucCard` (1 card / 1 hạng mục, expanded=true mặc định cho 1 hạng mục demo).
+
+**HangMucCard structure:**
+
+```
+┌──────────────────────────────────────────┐
+│ ▼ 01 · Tên hạng mục          KL ĐG TT NS │ ← Header row
+│ ──────────────────────────────────────── │
+│ NCC tham gia (3)  [+ Thêm NCC]           │ ← Sub-header
+│ ┌──────────────────────────────────────┐ │
+│ │ NCC │ Liên hệ │ ĐK │ File │ giá ... │ │ ← Inline NCC table
+│ ├──────────────────────────────────────┤ │
+│ │ NCC X │ ... │ ... │ ... │ ... │     │ │
+│ └──────────────────────────────────────┘ │
+└──────────────────────────────────────────┘
+```
+
+Header card: GroupCode + NoiDung + 3 stat (KL/ĐG ngân sách/TT ngân sách) + NS link Δ (nếu có Budget link) + Pencil/Trash actions + ▼/▶ toggle expand. Expand body: NCC inline table 8 cột (NCC / Liên hệ / Điều khoản TT / **File báo giá** / ĐG chưa VAT / ĐG có VAT / Thành tiền / Action).
+
+**Tương tác:**
+- Click cell quote (chưa VAT / có VAT / Thành tiền) → mở `QuoteDialog` cũ (reuse)
+- `+ Thêm NCC` button trong expand panel → `AddSupplierDialog` cũ (reuse)
+- `✏` icon mỗi NCC row → `EditSupplierDialog` cũ
+- `✓` icon → `setWinner` mutation, row + cell ăn theo màu emerald
+- `🗑` icon disabled khi NCC là winner hoặc đã có quote (giữ logic cũ)
+- `SupplierAttachmentsCell` nhúng vào cell "File báo giá" — full CRUD upload/download/delete file
+
+**Drop dead code:**
+- Function `SuppliersTab` xóa hoàn toàn (~134 LOC) — replace bằng `HangMucCard` expand panel
+- Bỏ Section 4 "NCC tham gia" cũ trong main render PeDetailTabs (gộp vào Section 2)
+
+**Section layout cuối** (4 section):
+1. Thông tin gói thầu
+2. Hạng mục + Báo giá NCC (nested expand)
+3. Chọn NCC / TP thắng thầu
+4. Ý kiến cấp duyệt
+
+Verify: `npm run build` × 2 app pass (sau khi catch TS6133 SuppliersTab unused → drop + SupplierAttachmentsCell unused → restore vào cột "File báo giá").
+
+### Chunk C (`f2f01f4`) — Section Ý kiến gộp đồng cấp cùng Phòng
+
+**FE-only mirror 2 app**. KHÔNG đụng Mig 26 schema (vẫn UPSERT 1 row / Level trong `PurchaseEvaluationLevelOpinions` qua `ApproveV2Async` Service). Chỉ thay đổi render layer.
+
+**Trước (S19 LevelOpinionsSectionV2):**
+```
+forEach step:
+  div.grid-cols-2:
+    forEach level:
+      forEach approver:
+        <LevelOpinionBox /> (1 box / NV)
+          - Cấp N — Tên NV
+          - "Đã duyệt" emerald badge or "— chưa duyệt" italic gray
+          - comment text
+          - admin override badge nếu signedBy !== approver
+```
+
+**Sau (Chunk C):**
+```
+forEach step:
+  <StepOpinionsBox stepOrder stepName departmentName totalApprovers opinions={stepOpinions} />
+    - Header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter
+    - Body:
+      - empty → "— Chưa có ý kiến duyệt." italic gray
+      - else → list <StepOpinionEntry opinion /> per signed opinion
+              (sort levelOrder asc, signedAt asc)
+```
+
+`StepOpinionEntry`:
+- Header trái: ApproverFullName + "Cấp N" badge slate + admin override badge amber nếu có
+- Header phải: emerald rounded-full timestamp "✓ DD/MM/YYYY HH:mm"
+- Body: comment text whitespace-pre-wrap
+
+NV chưa duyệt KHÔNG hiển thị (Q3=a) — chỉ 1 box / Step thay vì N box / NV như cũ.
+
+**Drop dead code:**
+- Function `LevelOpinionBox` xóa (~50 LOC) — replace bằng `StepOpinionsBox` + `StepOpinionEntry`
+
+Verify: `npm run build` × 2 app pass.
+
+### Pending Session 21+ (carry over từ HANDOFF S19 + còn nguyên)
+
+1. **Test V2 Service wire** (Chunk B Service hook S19 + Section gộp Chunk C S20) — defer chờ UAT user confirm + có sample data Production. Domain test ApproveV2 + UPSERT opinion match logic + Admin override match firstLevel + comment empty placeholder + render gộp Step.
+2. **Test regression B4 silent 403 S18** (HIGH §7 priority — vi phạm rule "test-before bug fix") — per-action `[Authorize(Policy=...)]` ApprovalWorkflowsV2Controller.
+3. **Test Mig 25 PATCH `/user-selectable`** endpoint (admin scope hẹp, MED).
+4. **🎯 Contract V2 wire (Mig 27/28 mirror PE pattern)** — biggest pending Plan. Audit-reuse memory áp dụng:
+   - Mig 27: `Contract.ApprovalWorkflowId` Guid? + `CurrentApprovalLevelOrder` int?
+   - Mig 28: `ContractLevelOpinions` mirror PE Mig 26 (UNIQUE composite, FK Cascade/Restrict)
+   - `ContractWorkflowService.ApproveV2Async` mirror PE branch
+   - `ContractCreatePage` Workspace Select V2 (validate ApplicableType=Contract=3)
+   - Pin V2 mặc định cho ContractType (admin Designer)
+   - `ContractDetailContent` Section "Ý kiến cấp duyệt" V2 dynamic (mirror S20 Chunk C — 1 box / Step)
+5. **Phân quyền strict V2** — vẫn loose UAT (mọi authenticated user thấy mọi phiếu V2). Sau confirm flow:
+   - List = Drafter + approver any-Step + Admin
+   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
+   - Detail = same as List
+   - Cũng giải quyết được bug "/inbox loose trả phiếu Nháp" → sau khi strict, B1 FE filter S18 có thể relax
+6. **Drop legacy V1 cleanup** sau khi không còn phiếu pin `WorkflowDefinitionId`:
+   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
+   - Mig 29+ cleanup drop column `RejectedAtStepIndex` + `RejectedFromPhase` deprecated S17
+   - Drop `ApproveV1LegacyAsync` branch trong Service
+7. **Drop Mig 15 cho V2 phiếu** sau UAT confirm — Mig 30 cleanup drop bảng `PurchaseEvaluationDepartmentOpinions` + entity. Hoặc giữ cả 2 backward compat (Q3 user chốt phiếu MỚI dùng V2, V1 cũ giữ legacy không migrate).
+8. **schema-diagram §16 PE Level Opinions V2** + §17-21 Mig 18-21 — defer cron audit 2026-06-01.
+9. **Skill `ef-core-migration`** frontmatter "21 migration" stale (thực 26) — defer cron audit 2026-06-01.
+
+### Hard blockers ops (carry over từ Session 19)
+
+- UAT thật 1 tuần với 2-3 user (Drafter/CCM/BOD)
+- SMTP config → Email outbox (BLOCKED chờ user cấp host/user/pass)
+- Rotate creds (admin + 30 demo + SA + vrapp + JWT secret + Gitea runner token)
+- Schedule SQL backup daily — `scripts/backup-sql.ps1` chưa schedule Task Scheduler
+- Remove binding cũ `.huypham.vn` sau verify stable
+- win-acme scheduled task "unhealthy" — auto-renew fix trước 2026-06-18
+
+### Audit định kỳ
+
+- Lần gần nhất: 2026-05-04 (manual trễ 4 ngày) — log `docs/changelog/skill-audit-2026-05.md`
+- Lần kế: **2026-06-01** combined audit (skill + doc drift). Drift hiện tại unchanged từ S19 (S20 không thêm migration / gotcha mới):
+  - `ef-core-migration` "21 migration" stale (thực 26)
+  - `dependency-audit-erp` count gotcha 41 stale (thực 44)
+  - `schema-diagram` §16 PE Level Opinions V2 + §17-21 Mig 18-21 pending
+- Cron Claude SDK KHÔNG fit monthly (auto-expire 7d, memory `feedback_cron_monthly_limitation`) — manual trigger khi đến ngày hoặc user nói "audit MD" / "kiểm tra docs"
+
+## TL;DR Session 19 — PE Section 5 V2 dynamic theo Workflow + Mig 26
+
+User feedback Section 5 hiện CỨNG 4 box (Mig 15 PheDuyet/CCM/MuaHàng/SmPm từ Phase 8) → cần ĐỘNG theo Workflow V2 đã pin với phiếu. Spec rõ: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox với ý kiến + tên người. "Bước 1 phòng A có 2 NV → 2 box ngang hàng".
+
+User chốt 5 câu Q&A trước code (capture trong session log):
+- Q1=**1B**: Comment khi NV nhấn Duyệt trong Workflow Panel auto sync sang OpinionBox của NV đó (Section 5 read-only summary). KHÔNG có form input rời.
+- Q2=**2A+Admin**: Chỉ NV chính chủ duyệt được. Admin override → lưu SignedByUserId=Admin.Id, FE banner "Admin <name> duyệt thay" khi SignedByUserId !== Level.ApproverUserId.
+- Q3=**V2 hết**: Phiếu V1 legacy → fallback render Mig 15 4 box CỨNG readOnly cho data history (KHÔNG drop Mig 15 — giữ data cũ).
+- Q4=**4C + bonus**: Phase=DaDuyet/TuChoi → khoá hoàn toàn. Admin có quyền duyệt thay. Comment empty/whitespace → ghi "(duyệt — không ý kiến)" placeholder.
+- Q5=**5A**: Layout group theo Step (header "Bước N — Phòng X" badge emerald + hint số người duyệt) + grid-cols-2 cho N approvers (wrap nếu N>2).
+
+### Polish 3 button Hành động (873e7a1) — đầu session
+
+Session 18 turn cuối user đã review screenshot "Hành động: Trả lại / Hủy/Từ chối / Duyệt → Chờ CCM" — yêu cầu rút gọn label + 3 màu khác nhau + bold. PeWorkflowPanel.tsx (mirror 2 app):
+- Label: "← Trả lại (về Drafter sửa)" → **"← Trả lại"** | "✗ Hủy / Từ chối" → **"✗ Từ chối"** | "✓ Duyệt → Chờ CCM" → **"✓ Duyệt"**
+- Phase đích vẫn hiện qua tooltip title khi hover
+- 3 màu: Duyệt = emerald (positive) · Trả lại = amber (request changes) · Từ chối = red (terminal)
+- font-medium → font-bold
+
+### Chunk A (`77a3058`) — Domain entity + EF + Mig 26
+
+`PurchaseEvaluationLevelOpinion : AuditableEntity`:
+- (PEId, ApprovalWorkflowLevelId) UNIQUE composite
+- Comment nvarchar(2000)
+- SignedAt datetime2 (luôn có khi UPSERT)
+- SignedByUserId Guid (NV chính chủ HOẶC Admin override)
+- SignedByFullName nvarchar(200) — denorm tránh user xóa/đổi tên
+
+EF: FK Cascade Pe + Restrict Level. SignedByUserId KHÔNG nav (denorm only).
+Migration 26 `AddPeLevelOpinionsForV2`: 1 CREATE TABLE + 2 FK + 2 index. 3-file rule commit đủ. Apply LocalDB SolutionErp_Dev OK (Mig 25 + 26 catchup).
+
+Verify: dotnet build pass + dotnet test 81 pass.
+
+### Chunk B (`90baa8e`) — Service V2 hook + DTO + GET include
+
+Service `ApproveV2Async` sau khi log approval → UPSERT row LevelOpinion cho Cấp hiện tại:
+```csharp
+var matchingLevel = pendingLevelGroup
+    .FirstOrDefault(l => actorUserId.HasValue && l.ApproverUserId == actorUserId.Value)
+    ?? pendingLevelGroup.First();  // Admin override fallback first
+var actorFullName = await ResolveActorFullNameAsync(actorUserId, isSystem, ct);
+var existingOpinion = await db.PurchaseEvaluationLevelOpinions
+    .FirstOrDefaultAsync(o => o.PurchaseEvaluationId == evaluation.Id
+        && o.ApprovalWorkflowLevelId == matchingLevel.Id, ct);
+var normalizedComment = string.IsNullOrWhiteSpace(comment)
+    ? "(duyệt — không ý kiến)"
+    : comment.Trim();
+// UPSERT: if existing → update; else → Add new
+```
+
+Reject (Trả lại / Từ chối) KHÔNG sync. Multi-NV cùng Cấp OR-of-N: match level theo ApproverUserId (NV chính chủ). Admin = fallback first; FE banner "Admin duyệt thay".
+
+Helper `ResolveActorFullNameAsync` lookup denorm SignedByFullName từ Users (fallback "(System)" / "(unknown)").
+
+DTO `PurchaseEvaluationLevelOpinionDto` 15 fields:
+- LevelId, StepOrder, StepName, StepDepartmentId, StepDepartmentName
+- LevelOrder, LevelName, ApproverUserId, ApproverFullName
+- Comment, SignedAt, SignedByUserId, SignedByFullName
+
+GET handler Include LevelOpinions + `BuildLevelOpinionsAsync` JOIN ApprovalWorkflows.Steps.Levels + Departments + Users → denorm DTO. Empty list cho phiếu V1 / V2 chưa có cấp duyệt → FE fallback message.
+
+Verify: dotnet build pass + dotnet test 81 pass.
+
+### Chunk C (`6e913b3`) — FE Section 5 V2 dynamic mirror 2 app
+
+Type `PeLevelOpinion` (15 field) + `PeDetailBundle.levelOpinions[]`.
+
+Section 5 PeDetailTabs conditional:
+```tsx
+{evaluation.approvalWorkflowId
+  ? <LevelOpinionsSectionV2 ev={evaluation} />
+  : <DepartmentOpinionsSection ev={evaluation} readOnly={opinionsReadOnly} />}
+```
+
+`LevelOpinionsSectionV2`:
+- Empty state khi `flow null` / `0 steps` → message "Workflow chưa cấu hình hoặc chưa có cấp duyệt nào"
+- forEach `step` → header "Bước N — <step.name>" + dept badge emerald + hint "(N người duyệt)" nếu totalApprovers > 1
+- Body grid-cols-2 cho `step.levels.flatMap(level => level.approvers.map(approver => <LevelOpinionBox/>))`
+- Lookup opinion theo (stepOrder, levelOrder, approverUserId) match levelOpinions[]
+
+`LevelOpinionBox` read-only:
+- Title "Cấp N — <ApproverFullName>"
+- Badge amber "⚠ Admin <SignedByFullName> duyệt thay" khi `signedByUserId !== approverUserId`
+- Badge emerald "✓ Đã duyệt" khi opinion tồn tại
+- Empty: "— chưa duyệt" italic gray
+- Footer: timestamp signedAt format vi-VN
+
+Workspace mode hint amber giữ "Ý kiến + chữ ký auto đồng bộ khi NV duyệt phiếu — vào menu Duyệt để ký."
+
+Mirror fe-admin + fe-user (rule §3.9).
+
+Verify: npm run build × 2 pass · 0 TS error.
+
+### Stats Δ Session 19
+
+| | Trước S19 | Sau S19 |
+|---|---:|---:|
+| Migrations | 25 | **26** (+1 Mig 26) |
+| DB tables | 58 | **59** (+1 PeLevelOpinions) |
+| API endpoints | ~141 | ~141 (no new — UPSERT auto qua Service hook) |
+| FE pages | 33 | 33 (modify existing only) |
+| Test pass | 81 | 81 (no change — UAT defer test §7) |
+| Gotchas | 44 | 44 |
+| Memory entries | 14 | 14 |
+| Skills | 6 | 6 |
+| Commits | (after S18) | **+4** (873e7a1 + 77a3058 + 90baa8e + 6e913b3 + Chunk D Docs) |
+
+## ⚠️ Điều quan trọng cho Session 20+
+
+1. **Test V2 Service wire mới (Chunk B Service hook)** — defer khi UAT user UAT confirm + có sample data Production. Domain test ApproveV2 + UPSERT opinion match logic + Admin override match firstLevel + comment empty placeholder.
+
+2. **Drop Mig 15 cho V2 phiếu (cleanup sau UAT confirm)** — sau khi không còn phiếu V2 dùng `PurchaseEvaluationDepartmentOpinions` (tất cả phiếu V2 chỉ dùng Mig 26 LevelOpinions). Mig 27 cleanup drop bảng + entity. Phiếu V1 legacy giữ Mig 15. Hoặc giữ cả 2 để backward compat.
+
+3. **Migrate phiếu V1 cũ sang V2 (data migration)** — admin tool chuyển `ApprovalWorkflowId` từ null → V2 workflow phù hợp + clear `WorkflowDefinitionId`. Hiện chưa làm (Q3 user nói chuyển V2 hết = phiếu MỚI dùng V2, phiếu V1 cũ giữ legacy không migrate — đơn giản hơn).
+
+4. **Contract V2 wire (Mig 27 hoặc 28) + Section 5 dynamic Contract** — mirror PE Mig 26 pattern: thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 27) + `ContractLevelOpinions` (Mig 28) + Service `ApproveV2Async` mirror PE + ContractDetailContent Section 5 V2. Audit-reuse pattern memory `feedback_audit_reuse_before_clone` áp dụng.
+
+5. **Phân quyền strict V2** — vẫn loose UAT. Sau confirm V2 flow (S19 Section 5 + S18 polish OK):
+   - List = Drafter + approver any-Step + Admin
+   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng)
+   - Detail = same as List
+
+6. **schema-diagram §16 PE Level Opinions V2** — thêm khi Chunk D update. Mig 22-25 V2 schema vẫn defer cron audit 2026-06-01.
+
+7. **Skill `ef-core-migration` frontmatter "21 migration" stale** (thực 26). Defer cron audit 2026-06-01.
+
+---
+
+## TL;DR Session 18 — PE V2 polish + Clone B + 4 bug fix UAT
+
+User UAT live tiếp Session 17, 7 batch nhỏ + 1 feature lớn (Mig 25). Áp memory `feedback_uat_skip_verify` (skip dotnet test mỗi chunk, push ngay) + lesson `0ae3fe2`: rename/remove → BẮT BUỘC `npm run build`.
+
+### B1 (`aaa1c6c`) — Pe Duyệt filter cứng "Đã gửi duyệt"
+
+User: "Duyệt bỏ cái trạng thái đi, chỉ load những trạng thái 'Đã gửi duyệt' là đc."
+
+- Bỏ dropdown "Tất cả trạng thái" khỏi UI khi `pendingMe=true`, thay bằng hint amber "Lọc cố định: Đã gửi duyệt (phiếu đang chờ duyệt)"
+- Filter cứng client-side: `getPeDisplayStatus(p.phase) === DaGuiDuyet` — loại Nháp/Trả lại/Đã duyệt/Từ chối
+- Header count dùng `rows.length` khi `pendingMe` (inbox không paged)
+- Workaround BE `/inbox` loose UAT có thể trả phiếu Nháp (phân quyền strict V2 pending Session 19+)
+- Mirror fe-admin + fe-user `PurchaseEvaluationsListPage.tsx`
+
+### B2 (`917446d`) — HistoryTab filter Trả lại / Gửi duyệt lại
+
+User: "Lịch sử thay đổi: chỉ bắt các dòng thay đổi khi trả lại và gửi duyệt lại thôi nhé, không cần bắt trạng thái duyệt và các thay đổi trước khi trả lại."
+
+- FE filter trong `PeDetailTabs.HistoryTab`, BE giữ audit data đầy đủ (reversible nếu user đổi ý / cần audit trail compliance)
+- Logic giữ:
+  - Workflow transition về TraLai (`phaseAtChange === 98`)
+  - Workflow transition từ TraLai (summary chứa `"TraLai →"`)
+  - Mọi thay đổi nội dung (Header/Detail/Supplier/Quote/Attachment) khi `phaseAtChange === 98`
+- Bỏ: workflow Approve cùng cấp (Cấp 1→2→DaDuyet), sửa khi phase=Nháp/ChoDuyet ban đầu
+- Empty state: "Chưa có lịch sử trả lại / gửi duyệt lại"
+
+### B3 (`937eb24`) — Clone V2 cho B (DuyetNccPhuongAn)
+
+User: "Quy trình chọn thầu phụ - NCC → Duyệt NCC đúng. Plan kế hoạch clone toàn bộ updates sang Duyệt NCC và Giải pháp."
+
+Audit reuse trước thay vì duplicate. Phát hiện 80% đã chung:
+- Schema V2 (Mig 22-24) qua `ApplicableType` enum
+- BE Service `ApproveV2Async` không hardcode type
+- App CQRS / API `/approval-workflows-v2?applicableType=N` dynamic
+- FE Designer `ApprovalWorkflowsV2Page` có `TYPE_CODE_TO_INT` cả 3 type
+- Layout regex `^AwV2_(.+)$` match dynamic typeCode
+- App.tsx route `/system/approval-workflows-v2/:typeCode` dynamic
+
+Chỉ thiếu cho B: **menu key + sample seed** (3 file ~60 LOC).
+
+- `MenuKeys.cs` +const `ApprovalWorkflowDuyetNccPhuongAnV2 = "AwV2_DuyetNccPhuongAn"` + add vào `All[]`
+- `DbInitializer.SeedMenusAsync` +leaf "Duyệt NCC và Giải pháp (Mới)" dưới root ApprovalWorkflowsV2 (Order=2 cạnh leaf A Order=1)
+- `DbInitializer +SeedSampleApprovalWorkflowsV2Async` (idempotent — skip nếu admin đã tạo workflow B nào, hoặc thiếu test user `nv.test`/Phòng CCM): seed `QT-DN-PA-V2-001 v01` 1 Bước Phòng CCM × 1 Cấp NV test
+- `fe-admin/lib/menuKeys.ts` +`AwV2_DuyetNccPhuongAn`
+
+KHÔNG migration / Service / Designer page mới. Memory `feedback_audit_reuse_before_clone.md` capture pattern.
+
+User feedback "OK khá tốt, 1 phát chạy luôn :))" sau verify → confirm approach.
+
+### B4 (`f77ea38`) — Fix silent 403 ApprovalWorkflowsV2Controller
+
+Triệu chứng: Drafter `nv.test` Workspace tạo phiếu B → dropdown "Quy trình duyệt" empty mặc dù Admin Designer thấy 2 version (v01 sample + v02 admin clone).
+
+Root cause: Class-level `[Authorize(Policy = "Workflows.Read")]` → non-admin role 403 Forbidden khi GET `/api/approval-workflows-v2`. TanStack Query catch error không hiện UI → dropdown rỗng silent.
+
+Fix:
+- Class-level đổi `[Authorize]` only (any authenticated user)
+- GET endpoint inherit class policy — Drafter list workflow để pick read-only, không nhạy cảm
+- POST + DELETE giữ `[Authorize(Policy = "Workflows.Create")]` admin-only Designer
+
+Pattern reusable cho Contract V2 Mig 26 sau.
+
+### B5 (`a9c0857`) — Fix sidebar highlight queryMatches transient keys
+
+Triệu chứng: Ở leaf "Danh sách" `/purchase-evaluations?type=1`, click chọn 1 phiếu → URL thành `?type=1&id=abc` → leaf bị mất highlight box (gotcha #34 cũ tái phát theo cách khác).
+
+Root cause: `queryMatches` exact-set equality — target `{type}` (1 key) vs current `{type, id}` (2 keys) length mismatch → no match → leaf unhighlight.
+
+Fix: `TRANSIENT_QUERY_KEYS = {id, q, editHeader, page, phase, awId}` — strip trước khi compare. Mọi key navigation identity (`type`, `pendingMe`, `mode`) check exact-set như cũ.
+
+Edge cases verified:
+| URL hiện tại | Target leaf | Match |
+|---|---|---|
+| `?type=1&id=abc` | Danh sách `?type=1` | ✓ giữ highlight |
+| `?type=1&pendingMe=1` | Danh sách `?type=1` | ✗ distinct (không cross-highlight Pending) |
+| `?type=1&phase=10` | Danh sách `?type=1` | ✓ giữ highlight (filter dropdown) |
+| `?type=1&pendingMe=1&awId=xyz` | Duyệt `?type=1&pendingMe=1` | ✓ giữ highlight |
+
+Mirror fe-admin + fe-user `Layout.tsx`.
+
+### B6 (`2a53107`) — Mig 25 IsUserSelectable + Designer pin toggle + bỏ "(clone)"
+
+User feedback xem Admin Designer: "Bỏ chữ Clone đi nhé, ghi v02, v03... là đủ rồi. Thêm cho tao nút stick để chọn các quy trình nào mà User đc select bên ngoài khi tạo phiếu."
+
+**Bỏ "(clone)":** Designer auto-fill `name = cloneFrom.name` (bỏ ` (clone)` suffix). Version số đã đủ phân biệt.
+
+**Pin toggle "Cho user chọn":**
+
+- **Migration 25** `AddIsUserSelectableToApprovalWorkflows`:
+  ```sql
+  ALTER TABLE ApprovalWorkflows ADD IsUserSelectable bit NOT NULL DEFAULT 0;
+  -- Backfill (giữ behavior cũ — active workflows vẫn pickable):
+  UPDATE ApprovalWorkflows SET IsUserSelectable = 1 WHERE IsActive = 1;
+  ```
+- **Domain** `ApprovalWorkflow.IsUserSelectable` — independent với `IsActive`, multiple versions có thể cùng selectable (admin có thể "ghim" nhiều version cho user pick).
+- **App CQRS:**
+  - `AwDefinitionDto` +field `IsUserSelectable`
+  - `CreateAwDefinitionCommand` Handler set default `true` cho version mới (mirror IsActive default)
+  - New `SetAwUserSelectableCommand(Guid Id, bool IsUserSelectable)` + Handler — toggle
+- **API** `PATCH /api/approval-workflows-v2/{id}/user-selectable` policy `Workflows.Create` (admin only)
+- **DbInitializer** `SeedSampleApprovalWorkflowsV2Async` +`IsUserSelectable = true`
+- **FE Designer** (`fe-admin/ApprovalWorkflowsV2Page.tsx`):
+  - `DefinitionDto` +`isUserSelectable`
+  - Badge amber "📌 Cho user chọn" cạnh badge IsActive/Archived khi `isUserSelectable === true`
+  - Button "📌 Ghim cho user / 🚫 Bỏ ghim" trong action group + mutation `toggleSelectable` (call PATCH endpoint, invalidate query)
+- **FE Workspace** (cả fe-admin + fe-user `PeWorkspaceCreateView.tsx`):
+  - approvalWorkflows query `.filter(w => w.isUserSelectable)` — chỉ workflows admin đã ghim hiện trong dropdown user
+
+### B7 (`32a8d4d`) — Cleanup orphan zip files
+
+`.claude.zip + docs.zip` từ harness session start lỡ tay vào `git add -A` ở B6 commit. Untrack + add `*.zip` rule `.gitignore`.
+
+### Stats Δ Session 18
+
+| | Trước S18 | Sau S18 |
+|---|---:|---:|
+| Migrations | 24 | **25** (+1) |
+| DB tables | 58 | 58 (Mig 25 chỉ ALTER cột) |
+| API endpoints | ~140 | **~141** (+1 PATCH user-selectable) |
+| FE pages | 33 | 33 (modify existing only) |
+| Test pass | 81 | 81 (no change — UAT feature defer test §7) |
+| Gotchas | 43 | **44** (+1 silent 403) |
+| Memory entries | 13 | **14** (+1 audit reuse pattern) |
+| Skills | 6 | 6 (no add) |
+| Commits | (after S17) | **+7** |
+
+## ⚠️ Điều quan trọng cho Session 19+
+
+1. **Contract V2 wire (Mig 26) — pending dedicated session.** Pattern audit-reuse áp dụng: phần lớn đã chung. Mirror PE pattern:
+   - Thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 26)
+   - `ContractWorkflowService.ApproveV2Async` mirror PE pattern
+   - `ContractCreatePage` Workspace Select V2
+   - Pin V2 mặc định cho ContractType
+   - Permission GET endpoint đã permissive (Session 18 fix), không cần đụng
+
+2. **Phân quyền strict V2 V2** — hiện loose UAT (mọi authenticated thấy mọi phiếu V2). Sau confirm flow:
+   - List = Drafter + approver any-Step + Admin
+   - Inbox = chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
+   - Detail = same as List
+   - Cũng giải quyết được bug "/inbox loose trả phiếu Nháp" — sau khi strict, B1 FE filter có thể relax nếu BE đã filter đúng
+
+3. **Drop legacy V1 cleanup** sau khi không còn phiếu pin `WorkflowDefinitionId` (V1):
+   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
+   - Mig 27 cleanup drop column `RejectedAtStepIndex` + `RejectedFromPhase` deprecated S17
+   - Drop `ApproveV1LegacyAsync` branch trong Service
+
+4. **Test V2 wire** (defer khi UAT confirm + có sample data) — Domain test `ApproveV2Async` match logic + transient TraLai entry → Cấp 1 reset.
+
+5. **`feedback_audit_reuse_before_clone` memory** — áp dụng cho mọi "clone X sang Y" / "thêm type Z mới" sau này. List "đã chung" vs "còn thiếu" trước khi propose plan.
+
+6. **Sample seed B sample** chạy với check `hasAnyB` — sau UAT có thể remove sample seed (admin đã tạo workflow thật). Hoặc giữ làm fallback. Idempotent skip nếu admin có workflow B → không clobber.
+
+---
+
+## TL;DR Session 17 — PE V2 schema end-to-end
+
+## TL;DR Session 17 — PE V2 schema end-to-end
+
+User chốt sau Session 16 (drastic refactor flat Mig 21 vẫn sai intent): **viết lại schema riêng + thêm Menu "Duyệt NCC (Mới)"** với cấu trúc explicit:
+
+```
+Mã Quy trình - Tên Quy trình
+  * Bước 1 - Phòng A
+    * Cấp 1 - NV X        ← 1 user CỤ THỂ qua ApproverUserId
+    * Cấp 2 - NV Y
+  * Bước 2 - Phòng B
+    * Cấp 1 - NV Z
+```
+
+Khác Mig 21: mỗi Cấp = 1 NV chính xác, KHÔNG OR-of-many group Dept+PositionLevel/Role/User.
+
+**4 commit (3 chunk per-commit + docs):**
+
+### Chunk A (`c847dc0`) — Domain + EF + Mig 22 + Menu
+
+- Domain `ApprovalWorkflowsV2/ApprovalWorkflow.cs` — 3 entity (ApprovalWorkflow + Step + Level) + enum `ApprovalWorkflowApplicableType` (DuyetNcc=1 / DuyetNccPhuongAn=2 / Contract=3)
+- EF `ApprovalWorkflowConfiguration.cs` — UNIQUE (Code, Version), FK Cascade Step→Workflow + Level→Step, FK Restrict Department + ApproverUserId
+- ApplicationDbContext +3 DbSet
+- **Migration 22** `AddApprovalWorkflowsV2` — 3 CREATE TABLE + 1 UNIQUE + 4 INDEX. Applied cả `_Design` + `_Dev` LocalDB
+- DbInitializer SeedMenusAsync: +menu `ApprovalWorkflowsV2` root dưới System (icon Workflow) + leaf `AwV2_DuyetNcc` (icon FileCheck, label "Duyệt NCC (Mới)")
+- MenuKeys.cs +2 const trong All array
+
+### Chunk B (`f6047d5`) — Application CQRS + API
+
+- `Application/ApprovalWorkflowsV2/ApprovalWorkflowV2AdminFeatures.cs`:
+  - `GetAwAdminOverviewQuery(ApplicableType?)` — load 3-level Include + dept/user names map
+  - `CreateAwDefinitionCommand` + Validator — auto-increment Version theo Code, deactivate active version cùng ApplicableType
+  - `DeleteAwDefinitionCommand` — UAT helper unconditional (chưa pin)
+  - DTO AwDefinition/AwStep/AwLevel + AwTypeSummary
+- IApplicationDbContext +3 DbSet
+- `Api/Controllers/ApprovalWorkflowsV2Controller` — route `/api/approval-workflows-v2`, GET ?applicableType=N | POST | DELETE/{id}, reuse policy `Workflows.Read` + `Workflows.Create`
+
+### Chunk C (`2781c7e`) — FE Designer
+
+- `fe-admin/src/pages/system/ApprovalWorkflowsV2Page.tsx` (~480 LOC)
+  - Overview cards Active+History per ApplicableType
+  - DefinitionCard read-only: Bước (badge phòng emerald) → Cấp (badge violet C1/C2 + tên NV + email)
+  - Designer dialog: Mã/Tên/Mô tả + Add/Remove Step + reorder (chevron up/down) + Add/Remove Level + Select Phòng + Select NV duyệt
+  - Validate: mỗi Step ≥1 Level, mỗi Level phải có ApproverUserId
+  - Auto-assign code mặc định theo type: `QT-DN-V2-001` / `QT-DN-PA-V2-001` / `QT-HD-V2-001`
+- Layout.tsx resolver +ApprovalWorkflowsV2 root → `/system/approval-workflows-v2`, +AwV2_<TypeCode> leaf → `/system/approval-workflows-v2/<code>`
+- App.tsx +2 route
+- menuKeys.ts +2 const sync với BE
+
+### Chunk D — Docs
+
+STATUS + HANDOFF + project_solution_erp.md memory.
+
+### Chunk E (UAT iteration, 9 commit) — Designer fix + State machine + Service wire + UX
+
+User UAT iter Designer V2 phát hiện multiple issues + chốt spec dần qua state diagram. Per memory `feedback_uat_skip_verify.md` UAT mode iterate nhanh:
+
+| Commit | Tóm tắt |
+|---|---|
+| `9712778` | Designer iter 1 lock 3 cấp/bước (sai intent) |
+| `f3bea3c` | Designer iter 2 đúng intent: max 3 cấp × N NV/cấp + sequential gating C2/C3 disabled khi prev empty + filter NV theo Phòng + no-dup same level. Validator BE strict |
+| `ff21120` | State machine 5 trạng thái Nháp/ĐãGửiDuyệt/TrảLại/TừChối/ĐãDuyệt. TraLai = Phase RIÊNG (không revert DangSoanThao + không jump-back). PE/Contract/Budget Phase enum + Policy + Service Reject branch → TraLai. 4 test mới TraLai entry point |
+| `0a40c65` | **Mig 23** `AddApprovalWorkflowIdToPurchaseEvaluation` — pin V2 vào PE entity. Workspace Select bắt buộc workflow lúc create. Validate ApplicableType match PE.Type |
+| `b41484b` | **Mig 24** `AddCurrentApprovalLevelOrderToPe` + Service V2 wire — `ApproveV2Async` iterate Steps/Levels group by Order = Cấp (OR-of-N approvers) match `actor.Id ∈ ApproverUserId`. Synthetic Policy `ForV2Schema()` cho FE nextPhases |
+| `d814429` | DTO CurrentApproval + banner "Đến lượt bạn" / "Không phải lượt bạn" + button Duyệt forward disabled khi V2 + actor không trong cấp + tooltip "chỉ {NV X / Y} duyệt được". Trả lại + Từ chối vẫn enabled |
+| `9e63e2d` `d250ae4` `74745a7` | List/Inbox V2-aware (`ResolveV2InboxIdsAsync` precompute IDs). 2 dropdown filter Quy trình + Trạng thái (chỉ ở Duyệt). Inbox endpoint nhận `approvalWorkflowId` |
+| `ac41d5e` | SQL `clean-transactional-uat.sql` — clean prod (9 PE + 11 HĐ + 19 Notif xóa) giữ master. Run qua SSH VPS `.\SQLEXPRESS` |
+| `de0f38d` | Panel 3 thay 4 phase cards bằng flow workflow thực tế: Bước (icon ✓/●/○) → Cấp (label "đang chờ"/"đã duyệt" + tên NV). DTO `ApprovalFlow` full snapshot với Status Done/Current/Pending |
+
+**Stats final Session 17:** 24 migration (+3), 58 DB tables (+3), ~140 endpoints (+5), 81 test pass (+4).
+
+**Test user UAT** (tạo qua API admin):
+- Email: `nv.test@solutions.com.vn` / Pass: `TestUser@123456` / Role: Drafter / Phòng: CCM
+
+## ⚠️ Điều quan trọng cho Session 18+
+
+1. **Contract V2 wire CHƯA làm** — chỉ PE wire xong (Mig 23-24). Session sau mirror pattern PE → Contract:
+   - Thêm `Contract.ApprovalWorkflowId` + `CurrentApprovalLevelOrder` (Mig 25)
+   - Update `ContractWorkflowService` thêm `ApproveV2Async` branch
+   - Update Workspace Select V2 trong `ContractCreatePage`
+   - Pin V2 thành mặc định cho Contract types
+
+2. **Phân quyền strict V2** — hiện loose UAT (mọi authenticated user thấy phiếu V2). Sau confirm flow OK:
+   - List: Drafter + bất kỳ approver any-Step + Admin
+   - Inbox: chỉ approver Cấp hiện tại (V2 đã đúng — `ResolveV2InboxIdsAsync`)
+   - Detail: same as List
+
+3. **Drop legacy V1 sau UAT** — khi không còn phiếu nào pin `WorkflowDefinitionId`:
+   - Drop tables `WorkflowDefinitions` + `WorkflowSteps` + `WorkflowStepApprovers` + PE versions
+   - Cleanup migration: drop column `RejectedAtStepIndex` + `RejectedFromPhase` (deprecated từ Session 17)
+   - Drop `ApproveV1LegacyAsync` branch trong Service
+
+4. **Admin role bypass** — hiện code `if (!isAdmin && !isSystem)` skip approver check. By design cho UAT + emergency override. Nếu prod cần audit override → option C trong Session 17 thảo luận: thêm flag `IsAdminOverride=true` trong approval row + banner đỏ trên detail.
+
+5. **81 test pass** — Domain WorkflowPolicyTests + PurchaseEvaluationPolicyTests + BudgetPolicyTests đã update cho TraLai entry point. KHÔNG có test cho V2 Service wire (defer khi UAT confirm + có sample data).
+
+---
+
+## TL;DR Session 16 (08/05 — Drastic refactor flat workflow EXECUTE)
+
+Resume từ Session 15 defer plan. Per memory `feedback_drastic_refactor_scope.md`: dedicated session, fresh context, conservative buffer.
+
+**Spec:** Workflow flat list (Phòng × Cấp × Approvers). Mỗi step = 1 (Phòng × Cấp). Service iterate steps OrderBy Order, advance pointer. Phase enum simplify ChoDuyet=10. Pin WorkflowDefinitionId.
+
+**2 chunk per-commit (5-6 chunk plan rút gọn vì BE tightly coupled):**
+
+### Chunk A (`dbb0089`) — All BE: Domain + Mig 21 + Service + Tests
+
+**Domain entities:**
+- Phase enum (PE + Contract): + ChoDuyet=10 generic intermediate. Legacy 2-6 + 98 deprecated (giữ enum cho data cũ).
+- WorkflowStep + DepartmentId Guid? FK Restrict + PositionLevel int?
+- PurchaseEvaluation/Contract + CurrentWorkflowStepIndex int? + RejectedAtStepIndex int?
+- DROP class WorkflowStepInnerStep + nav (PE + Contract)
+- DROP *DepartmentApproval.InnerStepId column
+
+**EF Configurations:**
+- DROP InnerStep config (PE + Contract) → table dropped
+- WorkflowStep config + DeptId/PositionLevel + FK Restrict
+- DepartmentApprovals: restore simple unique non-filtered (Mig 19/20 filtered split reverse)
+
+**ApplicationDbContext:** DROP DbSet<*WorkflowStepInnerStep> × 2
+
+**Migration 21** `RefactorWorkflowToFlatModel` GỘP:
+- 4 ALTER (PE/Contract +CurrentStepIndex +RejectedAtStepIndex)
+- 2 ALTER (WorkflowStep +DepartmentId +PositionLevel) PE + Contract
+- DROP TABLE × 2 (PEWorkflowStepInnerSteps + WorkflowStepInnerSteps Mig 18+20)
+- DROP COLUMN × 2 (*DeptApproval.InnerStepId)
+- DROP filtered indexes Mig 19/20
+- RESTORE simple UNIQUE (TargetId, Phase, Dept, Stage) non-filtered × 2
+
+**Service rewrite (PE + Contract WorkflowService.TransitionAsync):**
+- DangSoanThao → ChoDuyet (Drafter trình, init idx=0)
+- ChoDuyet → ChoDuyet (advance idx per approve)
+- ChoDuyet → DaDuyet/DaPhatHanh (idx ≥ steps.Count → terminal, gen mã HĐ Contract)
+- ChoDuyet → DangSoanThao (Trả lại — save RejectedAtStepIndex)
+- ChoDuyet → TuChoi (Từ chối — khoá vĩnh viễn)
+- Resume Drafter (DangSoanThao + RejectedAtStepIndex≠null) → ChoDuyet jump-back
+- Match approver: actor.Dept == step.Dept AND actor.PositionLevel >= step.PositionLevel (OR-of-many cùng cấp/dept) OR Approvers.Kind=User|Role match
+- Admin role bypass policy
+
+**App CQRS:** WorkflowStepDto + WorkflowStepInput drop InnerStep, add DepartmentId/DepartmentName/PositionLevel (PE + Contract mirror).
+
+**Tests:**
+- DROP `PeNStageApprovalTests.cs` (6) + `ContractNStageApprovalTests.cs` (6) + `PeTwoStageApprovalTests.cs` (7) — legacy
+- UPDATE `PeWorkflowAdminTests` signature for new flat input
+- **96 → 77 test pass** (-19 legacy)
+
+**3-file rule** Mig 21 commit đủ (.cs + Designer + Snapshot).
+
+### Chunk B (`88a5be1`) — FE Designer + types
+
+**PeWorkflowsPage + WorkflowsPage rewrite (~210 LOC each):**
+- Drop InnerStepDto + EditInnerStep types
+- Drop PHASE_OPTIONS (auto-assign ChoDuyet=10 behind scenes)
+- StepDto + EditStep + departmentId, departmentName, positionLevel
+- Designer step UI rewrite: Tên + Phòng Select + Cấp Select + SLA + Approvers (Role/User optional fallback). Drop InnerSteps sub-section.
+- DefinitionCard view: badge Phòng emerald + Cấp NV/PP/TP violet
+- Save payload: phase=10 (ChoDuyet)
+- Hint amber: "User cùng Phòng + Cấp ≥ step → duyệt được (OR-of-many)"
+
+**types/purchaseEvaluation.ts (fe-admin + fe-user mirror):** + ChoDuyet=10 enum + label "Đang duyệt" + color amber. Legacy 2-6 + 98 keep.
+
+**Chunk C (FE PeWorkflowPanel) SKIPPED** — existing UI compatible (workflow.nextPhases BE-driven, 3-button Trả lại/Từ chối Session 14 reuse với target=DangSoanThao/TuChoi pattern).
+
+### Verify
+
+- ✅ dotnet build SolutionErp.slnx 0 error
+- ✅ dotnet ef database update Mig 21 LocalDB applied OK
+- ✅ dotnet test 77 pass (54 Domain + 23 Infra)
+- ✅ npm build fe-admin + fe-user pass
+
+### Cumulative sau Session 16
+
+| | Trước S16 | Sau S16 |
+|---|---:|---:|
+| BE LOC | ~15800 | ~15500 (-300 service simplified) |
+| Migrations | 20 | **21** |
+| DB tables | 57 | **55** (-2 InnerStep tables) |
+| Tests | 96 | **77** (-19 legacy N-stage/2-stage) |
+| FE pages | 32 | 32 (rewrite existing 2 designer) |
+
+## ⚠️ CẢNH BÁO Session 17+
+
+1. **UAT live test** — workflow flat ready. Tạo new workflow definition qua `/system/pe-workflows/:typeCode` với 3 phòng × N cấp setup. Verify Drafter trình → cấp 1 phòng A → cấp 2 phòng A → cấp 1 phòng B → ... → DaDuyet flow.
+
+2. **Old PE/HĐ pinned legacy workflow definitions** (phase=ChoPurchasing/ChoCCM/etc) — service rewrite chỉ handle ChoDuyet=10 + DangSoanThao/DaDuyet. Old data ở phase 2-6 sẽ stuck (admin manual transition required). Recommend: data migration script convert old workflow → new flat model (defer).
+
+3. **Approver explicit (Role/User Approvers list)** — fallback nếu user không match Dept+PositionLevel của step. Cho phép user external (không thuộc dept) duyệt qua Role match (vd Admin) hoặc User explicit.
+
+4. **Bypass cấp dưới cùng dept** — User TP với CanBypassReview=true cùng dept và PositionLevel cao hơn step.PositionLevel → duyệt qua. KHÔNG batch upsert NV+PP rows như Mig 18 N-stage trước (đơn giản hóa: 1 step approve = 1 row).
+
+5. **N-stage tests dropped** — 19 test legacy (Mig 18, 20 N-stage + Mig 16 2-stage). Có thể viết test mới cho flat workflow flow nếu UAT phát sinh bug. Defer.
+
+6. **Sample data N-stage seed** task vẫn pending (Session 14). Block trên DesignTime vs Runtime DB gotcha + DbInitializer seed flow.
+
+7. **Budget N-stage** vẫn defer (cần versioned WF migration trước).
+
+8. **schema-diagram §17-21 update** defer cron audit 2026-06-01.
+
+## TL;DR Session 15 (07/05 — Tooltip diagnose + drastic refactor DEFER)
+
+User UAT live screenshot báo button "Lưu & Gửi Duyệt" KHÔNG hoạt động + suy đoán "trùng ID" giữa các phiếu.
+
+**Diagnose (commit `835cc7f`):**
+- Root cause: button silent disabled khi `evaluation.workflow.nextPhases` không có forward phase (chỉ TuChoi/TraLai). Cause khả năng: workflow definition pinned thiếu adjacent step → `policy.NextPhasesFrom(DangSoanThao)` return empty.
+- Improvement: tooltip + dialog hiển thị reason rõ ràng:
+  - `submitDisabledReason` text: "Phiếu đã ở phase X — chỉ Bản nháp/Trả lại mới sửa+gửi" / "Workflow không có phase tiếp theo từ X. Liên hệ admin kiểm tra cấu hình"
+  - Button title attribute → hover show reason hoặc forward phase label
+  - Dialog confirm show forward phase explicit ("Sẽ chuyển sang Chờ Purchasing")
+- Mirror fe-admin + fe-user. Build pass cả 2. KHÔNG đụng BE — chỉ FE diagnostic UX.
+- "Trùng ID" KHÔNG phải bug FE — `PurchaseEvaluationWorkspacePage` URL state đúng, mỗi PE row unique GUID + MaPhieu. Suy đoán user do button silent.
+
+**Plan drastic refactor → DEFER:**
+
+User confirm "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking" — refactor workflow từ phase-based + InnerStep nested model sang flat WorkflowStep model (mỗi step = Phòng × Cấp + Approvers users).
+
+Edit working tree 12 files (Domain entities + EF Configurations + DbContext):
+- Phase enum +ChoDuyet=10, legacy values 2-6 deprecated
+- WorkflowStep +DepartmentId, +PositionLevel
+- Drop class WorkflowStepInnerStep + nav (PE + Contract)
+- PE/Contract +CurrentWorkflowStepIndex int?, +RejectedAtStepIndex int?
+- *DepartmentApproval drop InnerStepId column
+- EF Configurations: drop InnerStep config + nav, restore simple unique non-filtered
+- DbContext: drop DbSet<WorkflowStepInnerStep> × 2
+
+Reality check scope realistic ~8-10h:
+1. Domain + EF + DbContext (~50min) ✓ done in working tree
+2. PolicyRegistry rewrite PE+Contract (~45min)
+3. App CQRS DTOs rewrite (~45min)
+4. Service rewrite PE+Contract (~2-3h)
+5. Tests rewrite — drop 12 N-stage tests + update remaining (~1.5h)
+6. Migration 21 + LocalDB apply + verify (~30min)
+7. FE Designer rewrite (~1.5h)
+8. FE PeWorkflowPanel + workflow timeline (~1h)
+9. Docs/Skill update (~45min)
+
+Vượt session boundary + risk session deep ~30 commits → **REVERT working tree** về `835cc7f` clean state. Test 96 pass intact.
+
+**Decision memorized:** add memory `feedback_drastic_refactor_scope.md` — drastic refactor cần dedicated session, scope estimation conservative (2x buffer), tránh mid-session big refactor.
+
+## ⚠️ CẢNH BÁO Session 16+
+
+1. **Drastic refactor flat workflow chưa làm — DEFER** với plan chi tiết. Khi resume:
+   - Plan kỹ 6 chunk per-commit
+   - Buffer 2x estimate (~16h thực tế)
+   - Tests rewrite biggest risk
+   - Hoặc fall back Approach Y (FE Designer flat UI giới hạn 5 phòng) ROI 1-2h nếu user OK trade-off
+2. **Task 2 sample data seed N-stage** vẫn pending (block trên DesignTime vs Runtime DB gotcha + DbInitializer seed flow)
+3. **schema-diagram §17-19 Mig 18-20** vẫn defer cron audit 2026-06-01
+4. **Hard blockers Ops** giữ nguyên 6 task
+
+## TL;DR Session 14 (07/05 — PE 3-button approval workflow)
+
+User chỉ thị thay 2-button approval (Duyệt + Reject mơ hồ) bằng **3 hành động rõ ràng** cho approver:
+- **Duyệt** = forward phase tiếp theo (decision=Approve)
+- **Trả lại** = về DangSoanThao + Drafter sửa (decision=Reject + target=DangSoanThao). Smart reject pattern Mig 16 + clear N-stage rows + Drafter resume jump-back tới phase đã reject.
+- **Từ chối** = phase=TuChoi (decision=Reject + target=TuChoi). Phiếu khoá vĩnh viễn (17 handler Mig 16 lock edit). Drafter phải tạo phiếu mới.
+
+**1 commit (`0d77698`):**
+
+- **Domain `PurchaseEvaluationPolicy.cs`**: NccOnly + NccWithPlan thêm `(X → TuChoi)` transition cho mọi phase trung gian (ChoPurchasing/ChoDuAn/ChoCCM/ChoCEODuyetPA/ChoCEODuyetNCC) với roles của phase đó. FromDefinition expand: mỗi step (trừ DangSoanThao) thêm (step.Phase → TuChoi) với roles step.
+- **Service** `PurchaseEvaluationWorkflowService.TransitionAsync` — Reject branch tách 2 case:
+  ```
+  if (decision == Reject) {
+    if (target != TuChoi) {  // Trả lại
+      RejectedFromPhase = fromPhase
+      target = DangSoanThao  // force
+      clear N-stage rows tại fromPhase
+    }
+    // else target=TuChoi: giữ nguyên, KHÔNG set RejectedFromPhase, KHÔNG clear
+  }
+  ```
+- **FE PeWorkflowPanel (admin + user mirror)**: render 3 button rõ:
+  - "✓ Duyệt → <label phase>" brand
+  - "← Trả lại (về Drafter sửa)" red khi `target=DangSoanThao && fromPhase != DangSoanThao`
+  - "✗ Hủy / Từ chối" red khi `target=TuChoi`
+  - Decision logic FE: `isReject = target=TuChoi || isSendBack`
+- **Dialog confirm**: title rõ theo loại, Cancel case warning đỏ "Phiếu sẽ bị khoá hoàn toàn", SendBack case hint amber "Phiếu về DangSoanThao, Drafter sửa rồi trình lại — workflow tự jump tới phase này".
+- **Tests update + add 1**:
+  - rename `Reject_Sets_RejectedFromPhase_And_Forces_DangSoanThao` → `Reject_To_DangSoanThao_Sets_RejectedFromPhase_TraLai` (change target TuChoi→DangSoanThao)
+  - NEW `Reject_To_TuChoi_Locks_Permanently_No_RejectedFromPhase` (Phase=TuChoi + RejectedFromPhase null)
+  - update `NStage_Reject_Clears_InnerStep_Rows_At_Phase` target → DangSoanThao
+- **95 → 96 test pass** (+1 Từ chối).
+
+**Task 2 sample seed in-progress (defer Session 15+):**
+
+- Phát hiện gotcha: `DesignTimeDbContextFactory` hardcoded `SolutionErp_Design` connection — `dotnet ef database update` từ session 12-13 thực ra apply lên `_Design` DB, KHÔNG phải `_Dev` runtime DB. Khi user run API → DbInitializer auto-MigrateAsync apply lên `_Dev`.
+- Đã apply Mig 9-20 lên `SolutionErp_Dev` qua `dotnet ef database update --connection`.
+- Start API để DbInitializer auto-seed 30 demo user. API exit 255 sớm khi log buffer full (~100 lines) — seeding dở dang (chỉ seed Roles, chưa Users).
+- Defer Task 2 cho session sau. Cần: user manual `dotnet run` API 1 lần hoàn thành seed, hoặc Claude resume với output redirect to file.
+
+## ⚠️ CẢNH BÁO Session 15+
+
+1. **Phase TraLai = 98 (orphan)** — Domain enum đã có từ S11+++++++ nhưng KHÔNG dùng (user chốt Session 14 không cần phase trung gian, chỉ DangSoanThao + TuChoi). Để giữ enum không phá nhưng ko wire vào policy → orphan. Có thể remove migration sau (không gây hại).
+
+2. **Task 2 sample seed pending**: 2 việc:
+   - Update `Users.PositionLevel` (1=NV, 2=PP, 3=TP) cho 30 demo user đã seed (mapping email pattern: `tpb./ccm./pro./fin./act./equ./hra.` → 3 (TP), `pp.*` → 2 (PP), `nv./qs./` else → 1 (NV), `bod./pm./admin./huy.duong/chau.le` → null)
+   - INSERT N-stage WorkflowDefinition v2 cho DuyetNcc với InnerSteps (PRO + CCM × 3 cấp NV/PP/TP)
+
+3. **DesignTime vs Runtime DB distinction**: dev có 2 DB:
+   - `SolutionErp_Design` — `dotnet ef migrations add/update` (DesignTimeDbContextFactory hardcode)
+   - `SolutionErp_Dev` — runtime API (appsettings.Development.json)
+   Khi muốn apply migrations lên Dev: `dotnet ef database update --connection "...SolutionErp_Dev..."` hoặc `dotnet run` API (DbInitializer auto-MigrateAsync).
+
+4. **Budget N-stage defer** — chưa wire vì Budget chưa có versioned WorkflowDefinition. Cần migration `AddBudgetVersionedWorkflow` + `AddBudgetWorkflowInnerSteps`. User quyết riêng (feature mở rộng module lớn).
+
+5. **schema-diagram §17-19 Mig 18-20** chưa update — defer cron audit 2026-06-01.
+
+## TL;DR Session 13 (07/05 — Mirror N-stage workflow sang Contract)
+
+User chỉ thị mirror N-stage từ PE (Mig 18+19) sang Contract. Budget defer (cần migration `AddBudgetVersionedWorkflow` trước — hardcoded `BudgetPolicy.Default` chưa có WorkflowDefinition entity).
+
+**5 chunk per-commit** (Chunk E skipped — WorkflowsController auto-bind record qua [FromBody]):
+
+- **Chunk A (`951ffa3`)** Domain `WorkflowStepInnerStep` + nav WorkflowStep.InnerSteps + ALTER ContractDeptApproval.InnerStepId + EF config + **Migration 20** GỘP 1 (CREATE TABLE + ALTER + DropIndex old + Recreate filtered legacy/N-stage)
+- **Chunk B (`04cf2a0`)** Application CQRS DTO/Input/Validator/Handler mirror PE Chunk B (default null backward compat)
+- **Chunk C (`e247b67`)** ContractWorkflowService refactor — load InnerSteps eager + reject clear N-stage rows + dept block split hasInnerSteps→N-stage / else→legacy 2-stage
+- **Chunk D (`7c0772a`)** ContractNStageApprovalTests 6 test mirror PE + helper SeedWorkflowDefinitionAsync 2 step adjacent + FakeChangelogService + FakeContractCodeGenerator stubs. **89→95 test pass**
+- **Chunk E SKIP** — auto-bind no code change
+- **Chunk F (current)** FE WorkflowsPage Designer extend InnerSteps sub-section mirror PeWorkflowsPage + Docs
+
+**Verify:** dotnet build pass + dotnet ef database update Mig 20 LocalDB applied + dotnet test 95 pass + npm build fe-admin pass.
+
+**Cumulative sau Session 13:**
+
+| | Trước S13 | Sau S13 |
+|---|---:|---:|
+| BE LOC | ~15300 | ~15700 (+400) |
+| Migrations | 19 | **20** (+Mig 20) |
+| DB tables | 56 | **57** (+1 WorkflowStepInnerSteps) |
+| DB columns mới | — | +1 (ContractDeptApproval.InnerStepId) |
+| API endpoints | ~134 | ~134 (no change — auto-bind) |
+| FE pages | 32 | 32 (extend existing WorkflowsPage) |
+| Tests | 89 | **95** (+6 Contract N-stage) |
+| Commits | (after S12) | **+5** (A→F per-chunk, E skipped) |
+
+## ⚠️ CẢNH BÁO Session 14+
+
+1. **Budget N-stage defer** — Budget chưa có versioned WorkflowDefinition entity (hardcoded `BudgetPolicy.Default`). Để mirror N-stage Budget cần migration `AddBudgetVersionedWorkflow` trước (4 bảng `BudgetWorkflowDefinitions/Steps/StepApprovers/InnerSteps` + `Budget.WorkflowDefinitionId?`). Defer cho user quyết riêng — feature mở rộng module Budget lớn.
+
+2. **PE-only deploy first** — Contract N-stage giờ đã có nhưng PE đã được test trước. UAT cả 2 module song song để verify pattern reusable.
+
+3. **Sample data N-stage** — pending (Task 2). Khi user yêu cầu sẽ seed PositionLevel cho 30 demo user + 1 N-stage workflow definition active cho DuyetNcc + 1 cho ContractType (ví dụ HopDongThauPhu).
+
+4. **TraLai BE wire** — pending (Task 4). Phase TraLai = 98 enum đã có ở Session S11+++++++ FE side, nhưng BE workflow service chưa wire button "Trả lại" cho approver. Khi user yêu cầu sẽ thêm decision `SendBack` (or reuse Reject với target=TraLai) + Service logic + FE button trong Workflow Panel.
+
+5. **schema-diagram §17 Mig 20** chưa update — defer cron audit 2026-06-01.
+
+6. **Skill ef-core-migration Mig 20 row** chưa add — defer cron audit.
+
+7. **Skill contract-workflow N-stage cross-ref** chưa add — defer cron audit.
+
+## TL;DR Session 12 (07/05 — N-stage workflow approval per phase × dept × cấp)
+
+User yêu cầu mở rộng từ 2-stage Mig 16 sang N-stage cấu hình động: 1 phase (WorkflowStep cha) có thể cấu hình chuỗi InnerSteps con theo Department × PositionLevel sequential. Mỗi phòng có NV → PP → TP duyệt thứ tự, có thể bypass cùng dept khi role cao + CanBypassReview.
+
+**6 câu spec defaults chốt:**
+- Q1 enum `PositionLevel { NhanVien=1, PhoPhong=2, TruongPhong=3 }` + `User.PositionLevel int?`
+- Q2 Sequential pure (Order asc, mỗi inner step = 1 cấp duyệt)
+- Q3 TP có CanBypassReview → skip NV+PP cùng dept (audit IsBypassed=true cho cấp dưới)
+- Q4 Smart reject về DangSoanThao + RejectedFromPhase + clear N-stage rows tại phase reject
+- Q5 PE first (Contract+Budget mirror sau khi PE stable UAT)
+- Q6(a) Designer UI 1 sub-section "Cấp duyệt nhỏ trong phòng" drag-list per step
+
+**6 chunk per-commit:**
+
+- **Chunk A (`13ab533`)** Domain + Migration 18 — enum PositionLevel + entity InnerStep + ALTER User.PositionLevel + ALTER PEDeptApproval.InnerStepId + EF config Cascade/Restrict + 3-file rule
+- **Chunk B (`0e56bd0`)** Application CQRS DTO — extend PeWorkflowStepDto + InnerStepDto + Validator + Handler atomic batch + UserDto +PositionLevel + SetUserPositionLevelCommand (default null backward compat existing PeWorkflowAdminTests)
+- **Chunk C (`0c62e24`)** Service N-stage logic + **Migration 19** filtered unique (drop UNIQUE Mig 16 → recreate `WHERE InnerStepId IS NULL` legacy + new `WHERE InnerStepId IS NOT NULL` N-stage). Refactor TransitionAsync: load InnerSteps eager + reject clear rows + hasInnerSteps→N-stage / else→legacy 2-stage. Match firstPending Order asc, exact match upsert 1 row, bypass batch upsert NV+PP+TP audit IsBypassed
+- **Chunk D (`3d76c6b`)** 6 test PE N-stage (FirstInner blocks / 3-level sequential pass / TP bypass skips / wrong dept 403 / reject clears rows / legacy fallback no inner). IdentityFixture extend +positionLevel arg. Helper SeedWorkflowDefinitionAsync 2 step adjacent. **83→89 test pass**
+- **Chunk E (`83ffabd`)** API `PATCH /users/{id}/position-level` mirror SetBypassReview
+- **Chunk F (current)** FE-Admin types/users.ts +positionLevel + PositionLevel const + Label/Short. PeWorkflowsPage Designer + sub-section InnerSteps drag-list { Phòng × Cấp + required } + button "+ Thêm cấp duyệt" emerald + departmentsList query + payload include. UsersPage column "Cấp" badge + cycle button. KHÔNG đụng fe-user (admin-only). Docs/Skill update.
+
+**Verify:** dotnet build pass + dotnet ef database update Mig 18+19 LocalDB applied + dotnet test 89 pass + npm build fe-admin pass.
+
+**Cumulative sau Session 12:**
+
+| | Trước S12 | Sau S12 |
+|---|---:|---:|
+| BE LOC | ~14850 | ~15300 (+450 — Domain enum + entity + EF config + Service N-stage + App CQRS) |
+| Migrations | 17 | **19** (+Mig 18 + Mig 19) |
+| DB tables | 55 | **56** (+1 PEWorkflowStepInnerSteps) |
+| DB columns mới | — | +2 (User.PositionLevel + PEDeptApproval.InnerStepId) |
+| API endpoints | ~133 | **~134** (+1 PATCH /users/{id}/position-level) |
+| FE pages | 32 | 32 (no change — extend existing 2 page) |
+| Tests | 83 | **89** (+6 N-stage PE) |
+| Commits | (after S11+++) | **+6** (A→F per-chunk) |
+
+## ⚠️ CẢNH BÁO Session 13+
+
+1. **N-stage chỉ áp PE first** — Contract + Budget vẫn 2-stage Mig 16 cũ. Mirror sau khi UAT PE 2-3 tuần ổn (giữ pattern, lặp lại Domain entity + Service logic + Tests).
+
+2. **User.PositionLevel chưa seed cho 30 demo user hiện có** — admin phải set tay qua UsersPage cycle button. Hoặc seed migration sau (mapping Position text → PositionLevel int).
+
+3. **Designer InnerSteps optional** — workflow definition KHÔNG có InnerSteps fallback logic 2-stage Mig 16 cũ. Backward compat 100%. Khi muốn enable N-stage cho 1 phase: clone version + add inner steps + Save.
+
+4. **Bypass kế thừa cùng dept only** — TP với CanBypassReview chỉ skip NV+PP CÙNG dept của TP. KHÔNG cross-dept (NV.A bypass không skip NV.B).
+
+5. **Reset N-stage rows khi reject** — clear chỉ rows tại phase reject. Phase trung gian khác vẫn giữ approvals nếu có. Resume sẽ jump tới RejectedFromPhase + cần re-approve N-stage tại phase đó.
+
+6. **Wrong-level error message** — đã localize "phòng X cấp Y không khớp". UAT user cần feedback nếu confused.
+
+7. **schema-diagram §15 Mig 18 + §16 Mig 19** chưa update — defer cho audit cron 2026-06-01 (small drift, không major).
+
+8. **Skill `ef-core-migration` Mig 18+19 row** chưa add — defer audit 2026-06-01.
+
+## TL;DR Session phase 2 (08/05 — B12-B14 polish iterate sau wrap-up `6e7a6db`)
+
+User UAT live tiếp tục, áp rule strict verify khi rename/remove (lesson hotfix CI 0ae3fe2).
+
+- **B12 (`378c993`)** PE detail polish 5 changes:
+  - "Lưu" no-close (chỉ toast + invalidate sync, KHÔNG đóng workspace)
+  - "Xóa phiếu" red bottom button CHỈ Bản nháp (soft-delete IsDeleted=true)
+  - Bỏ header bar workspace mode "Sửa header"/"Xóa"/"Đóng" (chuyển hết xuống bottom action bar)
+  - Section 4 column header: `s.supplierName` (master NCC name) thay `displayName`
+  - Section 3 row chặn xóa NCC khi đã có quotes + tooltip "xóa báo giá trước"
+- **B13 (`e320027`)** InfoTab auto re-edit + pencil active visual:
+  - useEffect watch `[autoEdit, canEdit, ev.id, ...]` → re-trigger edit khi pencil click phiếu khác
+  - Sync values từ ev mới (tránh stale state)
+  - Pencil "sáng lên" active state (`bg-brand-100 + ring`) khi `editingRowId === p.id`
+- **B14 (`d2306b8`)** QuoteDialog + winner column highlight + loading feedback:
+  - Bỏ checkbox "Chọn NCC này cho hạng mục" (consolidate winner ở Section 2.a)
+  - Winner column Section 4 matrix LUÔN xanh emerald (header `✓ ` prefix + cells full column)
+  - QuoteDialog full overlay loading + spinner khi save có delay
+  - NccSelectorRow inline spinner "Đang chọn NCC + sync cột giá Section 4…"
+
+**Verify:** `npm run build` × 2 app pass · `dotnet test` 83 pass (KHÔNG regression). Push gitea OK.
+
+## ⚠️ CẢNH BÁO Session 12+ (cập nhật)
+
+Bổ sung từ wrap-up trước (xem TL;DR S10-11+++++++ phía dưới):
+
+8. **`isSelected` per-quote BE field** — vẫn còn trong API payload nhưng UI ẩn. Nếu sau này muốn cho user chọn winner per-item (khác với winner per-phiếu) → re-enable checkbox QuoteDialog. Hiện tại chỉ gửi `existing?.isSelected ?? false` để giữ legacy data nếu có.
+
+9. **Section 4 cell winner highlight** dùng `ev.selectedSupplierId === s.supplierId` (per-supplier check). Nếu BE workflow có multi-winner per-item (ít khả năng), cần điều chỉnh logic.
+
+10. **Loading overlay QuoteDialog** chỉ áp QuoteDialog. Các dialog khác (AddSupplierDialog/EditSupplierDialog/DetailDialog) chỉ có button text feedback. Nếu UAT thấy delay → mở rộng pattern overlay sang các dialog khác.
+
+11. **InfoTab re-edit useEffect deps** include 4 ev fields (tenGoiThau/diaDiem/moTa/paymentTerms). Có thể trigger re-set values nếu BE cập nhật ev (vd auto-save từ chỗ khác). Trade-off: chấp nhận để sync state. Nếu UAT thấy "values mất" → debug deps.
+
+## TL;DR Session S10-11+++++++ (07/05 — PE Workspace UX overhaul đầy đủ)
+
+User UAT live mode iterate liên tục. Áp rule [`feedback_uat_skip_verify`](../../../../Users/pqhuy/.claude/projects/D--Dropbox-CONG-VIEC-SOLUTION/memory/feedback_uat_skip_verify.md) skip dotnet test sau mỗi chunk, push ngay. Lesson hotfix CI `0ae3fe2`: rename/remove → BẮT BUỘC `npm run build` trước commit.
+
+**11 batch deliverable** (23 commit total — xem STATUS Recently Done row đầu tiên cho narrative đầy đủ):
+
+- **B1** PE Thao tác 2-panel workspace (S10)
+- **B2** Migration 17 manual budget fields PE + HĐ (S11)
+- **B3** BudgetFieldRow inline editor Section 2.b
+- **B4** InfoTab inline edit Section 1 + PeListPanel pencil hover
+- **B5** Workspace "new" sectioned create view 5 sections
+- **B6** Danh sách view disable toàn bộ tương tác
+- **B7** Workspace "new" lock Loại quy trình + payment preset Select
+- **B8** PE display status meta (Bản nháp / Đã gửi duyệt / Trả lại / Đã duyệt / Từ chối)
+- **B9** Phase TraLai = 98 + pencil always visible + edit gating
+- **B10** Hotfix CI TS errors (forcedPhase rename + unused import)
+- **B11** PE detail polish — NCC selector dropdown + Section 3 winner protect + Bottom action bar Lưu/Gửi Duyệt
+
+## Stats sau wrap-up
+
+| | Trước S10 | Sau S11+++++++ |
+|---|---:|---:|
+| BE LOC | ~14400 | ~14850 (+450 — Mig 17 + Domain TraLai + App CQRS) |
+| Migrations | 16 | **17** (+1 Mig 17) |
+| DB columns mới | — | +4 (PE+HĐ × Name+Amount manual budget) |
+| FE pages | 31 | **32** (+1 Workspace 2-panel) |
+| FE components mới | — | +5 (PeListPanel, PeHeaderForm, PeWorkspaceCreateView, BudgetFieldRow, NccSelectorRow inline) |
+| PE phase enum | 8 | **9** (+TraLai = 98) |
+| PE display status | — | **5** (gom phase chi tiết) |
+| Tests | 83 | 83 (no test added — UAT iteration, áp rule §7 test-after defer) |
+| Commits S10-S11+++++++ | — | **+23** |
+
+## ⚠️ CẢNH BÁO Session 12+
+
+1. **Workflow transition vào TraLai** — Domain enum đã có (98), FE label/color/badge sẵn. NHƯNG chưa wire button "← Trả lại" trong PeWorkflowPanel approver view + workflow service BE chưa transition logic vào TraLai. Khi UAT cần → thêm: button "Trả lại" trong Chuyển tiếp (hoặc Reject Dialog), workflow rule `Decision=3 (TraLai)` set phase=TraLai + ghi `RejectedFromPhase`. FE đã ready accept hiển thị TraLai phase.
+
+2. **"Đã gửi duyệt" multi-phase filter** — display status "Đã gửi duyệt" gom 5 phase trung gian (ChoPurchasing/ChoDuAn/ChoCCM/ChoCEODuyetPA/ChoCEODuyetNCC). BE chưa hỗ trợ multi-phase param trong list endpoint → FE filter dropdown ẩn option này (chỉ exact-match Bản nháp/Đã duyệt/Từ chối). TODO: BE thêm `?phases=2,3,4,5,6` query param hoặc derive `displayStatus` field.
+
+3. **`feedback_uat_skip_verify` exception** — khi commit có **rename/remove**, BẮT BUỘC `npm run build` 1 lần trước push (lesson hotfix `0ae3fe2`). Chỉ skip verify khi pure ADD (props, JSX, new file).
+
+4. **Workspace + Danh sách + Duyệt** matrix:
+   - Workspace (Pe_*_Create): 2-panel, Section 5 disabled, edit only Bản nháp+Trả lại, pencil bright/disabled, bottom bar 2 nút Lưu/Gửi Duyệt
+   - Danh sách (Pe_*_List): 3-panel, **readOnly=true** toàn bộ (no edit/transition)
+   - Duyệt (Pe_*_Pending): 3-panel, PeDetailTabs readOnly + PeWorkflowPanel có Chuyển tiếp + Section 5 nhập opinion (chỗ này hiện vẫn disabled do code path cũ — verify nếu UAT user cần sign opinions ở đây)
+
+5. **Mig 17 columns nullable** — backward compat OK. Cả 2 (BudgetId + manual fields) cùng null acceptable. Validation BE chưa XOR.
+
+6. **CreateContractFromEvaluation carry-forward** manual fields PE→HĐ — đã wire. Verify UAT.
+
+7. **CI deploy status** — sau hotfix `0ae3fe2` các run từ commit `4c0625c` trở đi sẽ xanh + deploy. User UAT live trên prod ngay sau push.
+
+## TL;DR Session 11++ housekeeping (07/05 — InfoTab inline edit + pencil hover)
+
+User feedback after BudgetFieldRow: muốn thêm nút edit kế bên row trong Panel 1 list, click sáng nội dung Section 1 lên cho sửa header inline.
+
+- ✅ **InfoTab inline edit** — display mode + button "✎ Sửa" góc phải Section 1. Editing mode: card border brand-200 + 4 input (Tên / Dự án locked / Địa điểm / Mô tả / Payment) + Save (PUT /pe/:id) / Hủy.
+- ✅ **PeListPanel pencil hover** — icon absolute right-2 top-2 mỗi row, group-hover opacity-100. Click → callback onEditClick(id).
+- ✅ **URL flag `?editHeader=1`** — set bởi pencil click → autoEditHeader prop chain xuống PeDetailTabs → InfoTab tự open editing mode mount-time.
+- ✅ **fe-admin** Chunk 1 (`5a89dd2`) · **fe-user mirror** Chunk 2 (this).
+
+**Defer (chưa làm):** Refactor workspace "new" mode wrap PeHeaderForm trong sectioned layout giống detail view (5 sections visible). PeHeaderForm hiện tại single-card đủ dùng — chỉ làm thêm khi user feedback rõ.
+
+## TL;DR Session 11+ housekeeping (07/05 — inline budget editor)
+
+User feedback after Session 11: muốn toggle + 2 fields hiển thị trực tiếp trong Section 2 "b. Ngân sách" của PeDetailTabs, không chỉ ở "Sửa header" page. Empty values cứ empty.
+
+- ✅ **BudgetFieldRow component** (~125 LOC) thay FormRow tĩnh cũ ở `b. Ngân sách`. canEdit=`!readOnly && isDraft`. Save dùng existing PUT endpoint (KHÔNG cần BE thay đổi).
+- ✅ **fe-admin** Chunk 1 (commit `19712d8`) · **fe-user mirror** Chunk 2 (commit `d5c6f12`).
+- ✅ **Verify**: 2 build pass + 0 TS error.
+
+UX:
+- **Workspace + Danh sách + isDraft** → editable inline: toggle + Select OR 2 input + nút Lưu khi dirty
+- **Duyệt + !isDraft** → display only (link card / manual values / "—" empty)
+- **Empty state**: hiển thị "—" thay vì "(chưa link)" verbose (per user)
+
+## TL;DR Session 11 (07/05 — Migration 17 manual budget fields)
+
+**Output session 11** — UX improvement cho user nhập ngân sách không cần Budget entity approved:
+
+- ✅ **Migration 17** `AddManualBudgetFieldsToPeAndContract` — 4 ALTER (PE + HĐ × BudgetManualName nvarchar(200) + BudgetManualAmount decimal(18,2)). Applied LocalDB OK. Mirror logic PE ↔ HĐ (Q3 user chốt).
+- ✅ **BE** Domain 2 entity (PE + Contract) +2 property + EF config HasMaxLength/HasPrecision. App CQRS Create/Update commands + DTO + Validator + diff log + carry-forward CreateContractFromEvaluation pe→contract.
+- ✅ **FE** Toggle checkbox "Nhập tay (không link)" cạnh Label Ngân sách trong 4 chỗ: PeHeaderForm (workspace + /new page wrap), ContractCreatePage NewForm + EditForm. Khi ON: hide Select, show 2 input field grid 2-col (Tên + Số tiền formatted VND). Khi OFF (default): Select Budget approved cũ. Auto-detect manual mode khi load existing có manual data + !budgetId. Display fallback ở PeDetailTabs Section 1 "b. Ngân sách" + Contract EditForm read-only branch.
+- ✅ **5 chunk per-commit** (build + 83 test pass mỗi chunk): C1 Domain+Infra Migration 17 (`ecd5f7e`) · C2 App CQRS (`0f7901c`) · C3 FE-Admin (`bab5031`) · C4 FE-User mirror (`14f8d9d`) · C5 Docs (current).
+
+**Validation Q2 chốt:** cả BudgetId + manual fields có thể cùng null (PE/HĐ chưa có ngân sách gì). KHÔNG XOR enforce — BE prefer link nếu có (Phase=DaDuyet guarantee), manual fallback only.
+
+**KHÔNG đụng:** Budget entity / Phase=DaDuyet validation (giữ invariant "PE/HĐ link Budget approved only"). Manual fields chỉ là note/display, KHÔNG join với Budget.Details cho per-row comparison ở PE matrix Section 4 (cột "So với ngân sách" vẫn require ev.budgetId — không có detail rows để compare).
+
+## ⚠️ CẢNH BÁO session tiếp (Session 12+)
+
+1. **UAT manual budget flow** — toggle ON/OFF + save + reload + verify auto-detect mode. Đặc biệt edit existing PE/HĐ có manual data → toggle phải auto-checked. Edit existing có Budget link → toggle auto-unchecked.
+2. **Section 4 PE matrix "So với ngân sách"** vẫn require Budget link — manual amount KHÔNG render comparison column. Document giới hạn này nếu UAT thắc mắc.
+3. **`docs/database/schema-diagram.md`** chưa cập nhật count 16→17 migration + 4 column mới. Defer cho audit định kỳ 2026-06-01 (per §6.4 cron) — nhỏ enough không phải selective rewrite.
+4. **CreateContractFromEvaluation** đã carry forward manual fields PE→Contract. Verify khi UAT: PE có manual budget → tạo HĐ từ phiếu → HĐ inherit luôn.
+5. **No new test added** (rule §7 — feature mới = test-after, soak UAT 2-3 tuần ổn → viết happy path).
+6. **Schema fields nullable** — không phá HĐ/PE cũ (legacy null OK). Backward compatible.
+
+## TL;DR Session 10 (07/05 — PE workspace 2-panel)
+
+**Output session 10** — restructure leaf "Thao tác" PE từ page Create header riêng sang workspace 2-panel mirror HĐ Thầu phụ pattern:
+
+- ✅ **Spec chốt 5 câu trước code** — Q1 Panel 2 chỉ data entry (KHÔNG Workflow/Approvals/History); Panel 1 pure picker (no inline edit/delete); Q2 mirror HĐ Thầu phụ (sticky "+ Thêm mới" + new→edit Panel 2); Q3 leaf "Danh sách" + "Duyệt" giữ 3-panel hiện tại; Q4 route mới `/workspace`; Q5 Section 5 Ý kiến 4PB disable trong workspace (nhập khi duyệt).
+- ✅ **Chunk 1 fe-admin** (commit `ee0d360`) — 3 file mới: `PeListPanel.tsx` (~180 LOC pure picker reuse-able + sticky "+ Thêm mới"), `PeHeaderForm.tsx` (~210 LOC extract header form từ CreatePage), `PurchaseEvaluationWorkspacePage.tsx` (~120 LOC 2-panel `[320px_1fr]`). 3 file sửa: `PeDetailTabs.tsx` thêm prop `mode?: 'detail' \| 'workspace'` + Section 5 hint amber khi workspace + force `opinionsReadOnly`. `Layout.tsx` resolver `Pe_*_Create` → `/workspace?type=N`. `App.tsx` route mới.
+- ✅ **Chunk 2 fe-user mirror** (commit `ecf3c59`) — 6 file y hệt content (rule §3.9 duplicate có chủ đích).
+- ✅ **Verify**: 2 build pass + dotnet test 83 vẫn pass mỗi chunk.
+
+**KHÔNG đụng BE / migration / schema / endpoint.** Route `/new` cũ giữ tồn tại cho deep-link "Sửa header" button.
+
+## ⚠️ CẢNH BÁO session tiếp (Session 11+)
+
+1. **UAT live workspace** với anh Kiệt + 2-3 user — feature mới UX khác (page Create cũ thành Dialog implicit qua sticky button + transition new→edit auto).
+2. **Section 5 Ý kiến 4PB hint banner amber** ở workspace mode chỉ là text gợi ý — KHÔNG block. User vẫn thấy existing opinions read-only. Nếu UAT thấy confused → có thể đổi thành collapsible section.
+3. **Mobile: workspace KHÔNG có fallback** — màn hình `<lg` (< 1024px) Panel 2 ẩn (lg:block). Cần test mobile redirect → `/purchase-evaluations/:id` nếu UAT phát hiện. Hiện chỉ admin desktop dùng workspace.
+4. **Pe_*_Pending vẫn /purchase-evaluations?pendingMe=1** — leaf "Duyệt" 3-panel (giữ Panel 3 Workflow + readOnly Section 5 cho phép sign). UAT verify Drafter trình → TPB duyệt thấy Section 5 enable đúng.
+5. **PE WorkflowPanel duplicate ở 2 chỗ** — leaf "Danh sách" + "Duyệt" Panel 3 (3-panel). KHÔNG có ở "Thao tác" workspace. Verify route resolver active state highlight đúng (queryMatches helper từ session 3).
+6. **Sửa header trong workspace** — vẫn navigate sang `/new?id=` (button "Sửa header" trong PeDetailTabs). Chưa wire inline edit qua Dialog. Nếu UAT yêu cầu → thêm prop `onEditHeader` cho PeDetailTabs trigger Dialog reuse `PeHeaderForm`.
+
+## Housekeeping today (sau Session 9)
+
+- ✅ **Audit định kỳ 2026-05** — combined skill + doc drift (commit `7dc0233`). 5 drift patch (count 77→83 + 52→55 bảng), 1 skill content patch (contract-workflow Phase 9 cross-ref). KHÔNG tạo skill mới. Log `docs/changelog/skill-audit-2026-05.md`.
+- ✅ **Optional polish — fe-user Inbox PE section** (commit `332a90f`). useQuery `/purchase-evaluations/inbox` + Panel 1 chia 2 section sticky header (HĐ + PE). PE click → navigate page riêng.
+- ✅ **User Manual 7 file rewrite compact** (commit `16c2c9c`). User feedback "ko cần quá đầy đủ chi tiết, cho end-user họ làm". Bỏ field validation table + error troubleshoot table + FAQ chi tiết. Giữ tổng quan ngắn + numbered steps đơn giản. ~86 KB / 7 file (cũ ~123 KB ↓30%). Setup `package.json` + `npm install docx@9.5.0` + `npm run gen:all`. Lần sau sửa: edit `_gen-*.js` → run gen:all.
+
+**Cron audit định kỳ:** Claude SDK CronCreate auto-expire 7 days → KHÔNG fit monthly cadence. User cần setup OS Task Scheduler `.bat` script ping API hoặc manual trigger mỗi đầu tháng. Lần kế: 2026-06-01.
+
+**User Manual style rule (mới chốt session này):** end-user docs BỎ field/error tables, FAQ chi tiết, phím tắt — GIỮ tổng quan ngắn + numbered steps + note/warn/tip critical. Phân biệt với rule §6.5 (KHÔNG cắt narrative) — đây là rule cho audience end-user, không phải agent dev đọc rationale.
+
+## TL;DR Session 9 (04/05 — Chunk E-bis sau Session 8)
+
+**Output session 9** — đóng tất cả Chunk E-bis defer từ session 8:
+
+- ✅ **FE PE WorkflowPanel** — Section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber chờ TPB confirm, badge fuchsia bypass (cả fe-admin + fe-user).
+- ✅ **FE UsersPage UserManager** — Column "Bypass" + button ShieldCheck toggle CanBypassReview, badge fuchsia khi enabled. UserDto thêm field.
+- ✅ **HĐ 2-stage logic** — `ContractWorkflowService` thêm UserManager DI + mirror logic từ PE service. `ContractDepartmentApprovalFeatures.cs` List query. Endpoint `GET /contracts/{id}/department-approvals`. FE `WorkflowHistoryPanel` section mới.
+- ✅ **Budget 2-stage logic** — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime DI + 2-stage. `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE `BudgetWorkflowPanel` section.
+- ✅ **6 test PE 2-stage** — `IdentityFixture` setup full Identity stack (DbContext SQLite + AddIdentityCore + AddRoles<Role>) reusable. 6 scenario: NV_Review_Blocks / TPB_Confirm_Allows / NV_Bypass / Admin_Skip / Reject_Sets / Resume_Jumps_Back.
+- ✅ **Verify**: Build pass + 83 test pass mỗi commit (54 Domain + 29 Infra: 17 codegen + 6 PE WF Application + 6 PE 2-stage).
+- ✅ **5 commit pushed** Gitea (E2 → E6).
+
+## ⚠️ CẢNH BÁO session tiếp (Session 10+)
+
+1. **UAT live ngay** với anh Kiệt + 2-3 user — feature 2-stage đầy đủ cả 3 module + UX.
+2. **Tests Contract + Budget 2-stage skipped** — logic identical PE (cùng pattern, cùng entity shape). Pattern `PeTwoStageApprovalTests` reusable nếu UAT phát hiện regression riêng.
+3. **Bypass toggle audit** — chưa log Changelog khi admin toggle CanBypassReview. Audit qua Identity standard column UpdatedAt only. Có thể cần thêm audit row riêng nếu UAT yêu cầu.
+4. **Notify TPB cùng dept** dùng `UserManager.GetRolesAsync` filter `DeptManager` — verify production có user role DeptManager đúng (data already seeded).
+5. **fe-user KHÔNG có UsersPage** — admin-only function. Bypass toggle chỉ ở fe-admin.
+6. **3 endpoint mới List dept-approvals** PE/HĐ/Budget cùng pattern, reuse policy authz `*Read`.
+7. **Cron audit định kỳ 2026-05-01** vẫn EMPTY (`No scheduled jobs`). Có thể recreate khi user yêu cầu.
+
+## TL;DR Session 8 (04/05 — code lớn, 5 commit per-chunk)
+
+## TL;DR Session 8 (04/05 — code lớn, 5 commit per-chunk)
+
+**Output session 8** — đóng bug anh Kiệt + thêm 3 ràng buộc workflow:
+
+- ✅ **Migration 16** `AddTwoStageDeptApprovalAndSmartReject` — 4 ALTER (3 RejectedFromPhase int + Users.CanBypassReview bit) + 3 CREATE TABLE (`Contract/PE/Budget DepartmentApprovals` UNIQUE (TargetId, Phase, Dept, Stage)) + 12 indexes.
+- ✅ **Lock edit** 17 handler thêm guard Phase != DangSoanThao (Contract Detail × 15 qua helper, PE Detail × 5 qua helper mới, Budget Detail × 3 inline).
+- ✅ **Smart reject + Resume** 3 module — Reject = lưu phase nguồn + force về DangSoanThao. Resume = jump straight tới phase đã reject (skip phase trung gian, bypass policy guard).
+- ✅ **PE 2-stage logic** trong `PurchaseEvaluationWorkflowService` — TPB/CanBypass → Confirm; NV → Review only, BLOCK transition cho đến khi TPB confirm.
+- ✅ **3 endpoint mới**: `GET /pe/{id}/department-approvals` (List), `PATCH /users/{id}/bypass-review` (toggle), Notify TPB cùng dept khi NV review.
+- ✅ **Verify**: Build + 77 test pass mỗi commit. Migration applied LocalDB OK. Schema verified.
+- ✅ **6 commit pushed** (2 docs S7 + 5 code S8).
+
+## ⚠️ CẢNH BÁO session tiếp (Session 9+)
+
+1. **Bug fix anh Kiệt** chỉ áp PE workflow. **HĐ + Budget 2-stage scope DEFER** cho khi UAT PE OK.
+2. **FE Workflow Panel chưa update** — workflow vẫn block đúng (BE), nhưng UX chưa hiển thị 2-stage progress. User test sẽ thấy phase không đổi mà không hiểu tại sao "stuck". Phải UAT với hint cho user trước khi code FE.
+3. **FE UserManager toggle CanBypassReview chưa làm** — tạm thời SET qua HTTP PATCH:
+   ```
+   PATCH /api/users/{userId}/bypass-review
+   Authorization: Bearer <admin>
+   { "canBypassReview": true }
+   ```
+4. **Test thực tế bug fix flow**:
+   - Login `phuong.nguyen` (NV.PRO, role=Procurement, DeptId=PRO) tạo phiếu PE type A
+   - Trình DangSoanThao → ChoPurchasing
+   - phuong.nguyen click Duyệt phase ChoPurchasing → expect: phase KHÔNG đổi, có row Stage=Review
+   - `tra.bui` (TPB.PRO, role=DeptManager) click Duyệt → expect: phase chuyển ChoCCM
+5. **Notify TPB cùng dept** dùng `UserManager.GetRolesAsync` filter `DeptManager`. Best effort, fail OK.
+6. **Cron audit định kỳ 2026-05-01** đã quá hạn 3 ngày, vẫn EMPTY runtime. Cần manual trigger.
+7. **Smart reject test**: Reject phase ChoCCM → DangSoanThao + RejectedFromPhase=ChoCCM. Drafter sửa Detail + trình lại → jump straight tới ChoCCM (skip ChoPurchasing).
+8. **Lock edit test**: HĐ ở Phase=DangGopY → cố sửa Detail → expect 409 Conflict "đã trình duyệt, không thể chỉnh sửa".
+
+## TL;DR Session 6 (30/04 — không code, chỉ docs)
+
+**Output session 6** — pure docs work, không thay đổi code/test:
+
+- ✅ **Compact 3 file core**: STATUS -27%, HANDOFF -32%, migration-todos -35% (-288 dòng tổng). Archive 51 row Recently Done Phase 0-7 → `changelog/recently-done-archive-2026-04.md`.
+- ✅ **Refresh 3 skill stale**: `form-engine` (Phase 2 MVP → Tier 3 feature-complete), `permission-matrix` (12 menu → ~60 + inheritance roots), `ef-core-migration` (24 DbSet → 52 bảng).
+- ✅ **Rule mới §7 Timing test**: 1 bảng 5-row compact — feature mới = test-after, bug = test-before, critical algorithm = test-before, spec change = update test cũ, skip 5 loại.
+- ✅ **Rule mới §6.4 Audit + compact MD định kỳ**: cadence + checklist + anti-pattern. Cross-ref §9.4 skill audit. KHÔNG rewrite toàn bộ.
+- ✅ **77 test vẫn pass** (Domain 54 + Infra 23). 0 thay đổi code.
+- ✅ **Cron 2026-05-01 fire mai** — combined audit (skill + doc drift) theo §6.4 + §9.4.
+
+**Session 5 (29/04)** đóng gần hết feature gap + bật test gate:
+
+### 🎯 Headline outcomes
+- ✅ **Budget feature-complete** — FE 3-panel pages cả 2 app, BE đã sẵn từ session 4
+- ✅ **PE/HD ↔ Budget integration** — form select Budget filter Phase=DaDuyet + Project, cột "So với ngân sách" ở PE matrix với delta indicator
+- ✅ **PE Detail UI restructure** match form chính thức PHIẾU TRÌNH KÝ (4 section đánh số)
+- ✅ **PE Workflow Designer admin UI** `/system/pe-workflows/:typeCode` versioned với clone/edit/+Role/+User
+- ✅ **Ý kiến 4 phòng ban** — migration 15 + section sign-off 2x2 grid (Phê duyệt/CCM/MuaHàng/SM-PM)
+- ✅ **Tests Phase 1-2** — 71 unit test pass + CI gate fail-fast (Domain policy + Infra code generator)
+
+**Session 4 (28/04)** đã có:
+
+### A. Module Ngân sách (Budget) BE — migration 14, +4 bảng, +11 endpoint
+
+- 4 entity: `Budget` (Header) + `BudgetDetail` (flat row) + `BudgetApproval` (history) + `BudgetChangelog` (audit log).
+- Enum `BudgetPhase` 5 state (DangSoanThao→ChoCCM→ChoCEO→DaDuyet + TuChoi).
+- `BudgetPolicy.Default` hardcoded simple 3-step (Drafter→CCM→CEO) — chưa versioned (TODO khi user cần admin config UI).
+- Mã `NS-YYYYMM-XXXX` Random.Shared (chưa atomic — TODO khi format chính thức).
+- Link nullable: `Contract.BudgetId?` + `PE.BudgetId?` đã có FK + index, FE chưa wire form.
+- Menu seed `Budgets` root + 3 leaf (Bg_List/Bg_Create/Bg_Pending) order=27 icon Wallet.
+- Application: 11 CQRS handler ~340 LOC (Create/UpdateDraft/Transition/List/GetDetail/Delete + Detail CRUD auto-recompute TongNganSach + ListChangelogs).
+- Api: `BudgetsController` 11 endpoint REST.
+- **FE chưa làm — Priority 0 session 5.**
+
+### B. 14 demo user Solutions thật
+
+- PRO 5 (TPB tra.bui + 4 NV) + CCM 7 (TPB ngocanh.huynh + 6 NV) + ISO 1 (chau.le) + CEO 1 (huy.duong).
+- Pwd `User@123456`. Reconcile pattern (gotcha #38 4-field rename).
+- Tổng 30 user (16 sample cũ giữ + 14 Solutions thật mới).
+
+**Tổng cumulative:** 52 DB tables, ~128 endpoints, 15 migrations, **41 gotchas (+3 CI fixes)**,
+**77 unit test (+6 PE WF Application)**, 11+ commit session 5 push lên Gitea.
+
+### 🆕 CI/CD optimize (29/04 tối)
+
+- ✅ **Manual checkout bypass github.com** — fix #108/#109 transient TCP timeout 21s. Run #110 pass.
+- ✅ **Path filter docs-only skip** — `paths-ignore` trong on:push, commit MD-only KHÔNG trigger CI (verify `512880c` → no run #113).
+- ⏸️ **npm junction cache** — thử ở #111 fail `tsc not found`, rollback. Cần debug session sau (gotcha #40 doc rồi).
+- ✅ **Tests Phase 3 mini (PE Workflow Designer)** — 6 test versioning logic. Total 77.
+
+## ⚠️ CẢNH BÁO session tiếp (Session 7+)
+
+1. **CI test gate active** — code → `dotnet test SolutionErp.slnx` local → commit → push. Test fail = NO deploy. Workflow user §7 rules.md.
+2. **Timing test rule live (§7)**: feature mới = test-after, bug = test-before BẮT BUỘC, critical algorithm = test-before merge, spec change = update test cũ + code chung commit.
+3. **Doc audit cadence live (§6.4)**: cuối phase compact, đầu tháng cron audit, KHÔNG rewrite toàn bộ. Cron fire **mai (2026-05-01)** — combined skill + doc drift theo checklist.
+4. **Login email** `admin@solutionerp.local` / `Admin@123456` — domain default chưa đổi sang `@solutions.com.vn` (chỉ demo user rebrand).
+5. **Chưa xóa binding cũ `.huypham.vn`** — vẫn fallback. Sau verify stable → `.\migrate-domains.ps1 -RemoveOld -SkipCert` trên VPS.
+6. **win-acme scheduled task "unhealthy"** — fix trước cert expire 2026-06-18.
+7. **Export phiếu PDF/Excel PE** — pending vô thời hạn (user nói không quan trọng).
+8. **3 feature mới chưa test** (PE Opinion Upsert / Budget validate / Contract BudgetId carry) — đợi UAT phát sinh bug → áp rule §7 (regression test before fix). Hoặc soak 2-3 tuần ổn → viết happy path.
+9. **G-084:** VPS shared VietReport — mọi reverse proxy mới phải `127.0.0.1` + bind loopback IPv4 explicit.
+
+## ⭐ Skills (.claude/skills/) — PHẢI dùng khi task khớp
+
+| Domain (3) | Ops (3) |
+|---|---|
+| `contract-workflow` — state machine + versioned WF | `dependency-audit-erp` — npm/dotnet CVE scan |
+| `form-engine` — render docx/xlsx + PDF | `ef-core-migration` — EF migration + 3-file rule |
+| `permission-matrix` — role × menu × CRUD | `iis-deploy-runbook` — 3 site IIS + win-acme + runner |
+
+**Audit cron:** `0 9 1 * *` (9:00 AM ngày 1 mỗi tháng). Workflow: `docs/rules.md §9.4`. Lần kế: **2026-05-01**.
+
+**Quy tắc:** KHÔNG bulk-clone repo skill 3rd party. Chỉ skill PROJECT-SPECIFIC. Đầy đủ: `docs/rules.md §9`.
+
+## Ở đâu rồi?
+
+| Phase | Trạng thái |
+|---|---|
+| 0 Draft | ✅ Done |
+| 1 Alpha Core (foundation + đợt 2 CRUD + Permission) | ✅ Done |
+| 2 Form Engine MVP + iter 2 (upload UI + .doc auto-convert + PDF export) | ✅ Done |
+| 3 Workflow MVP (9 phase + code gen) + iter 2 (SLA job + attachment + notify) | ✅ Done |
+| 4 Report MVP (Dashboard + Excel) + user-specific dashboard | ✅ Done |
+| 5 Prep + 5.1 Security + Users Mgmt | ✅ Done |
+| **5 Deploy prod** (3 domain HTTPS live) | ✅ Done |
+| **Tier 3 (Attach + Realtime + Form builder + PDF + Versioned WF + Nested menu + Permission 3-panel)** | ✅ Done |
+| **Skill governance** (6 skill project-level + audit cron 1/tháng) | ✅ Done |
+| **3-panel List/Inbox/Thao tác + sidebar accordion + UserDashboard** | ✅ Done |
+| **4-bảng data model** (Header + 7 Details + Workflow + Changelog audit) | ✅ Done |
+| **Mã HĐ gen tại Create + backfill legacy** | ✅ Done |
+| **4 master catalogs** (Units/Materials/Services/WorkItems) + datalist autocomplete | ✅ Done |
+| **Roles VN labels (ShortName)** + Users dept/position + 13 demo users | ✅ Done |
+| **RolesPage CRUD** `/system/roles` + custom role admin | ✅ Done |
+| **7 demo HĐ varied phases** + details + comments + approvals workflow | ✅ Done |
+| **User-kind approver runtime guard** + Warning 20% SLA | ✅ Done |
+| **Edit detail row inline** (7 typed Update commands + EditRowDialog) | ✅ Done |
+| **Master expand 15 NCC + 8 Project** + backfill demo HĐ diverse | ✅ Done |
+| **Deps audit script** (`scripts/deps-audit.ps1`) | ✅ Done |
+| **Module Duyệt NCC (tiền-HĐ) E2E** — 10 bảng + 2 workflow + Kế thừa HĐ | ✅ Done |
+| **PE polish iter 2** — flat layout + per-NCC attachments + readOnly Duyệt + email rebrand | ✅ Done |
+| **Domain rebrand huypham.vn → solutions.com.vn** — 3 subdomain + cert + CORS + FE bundle | ✅ Done |
+| **Module Ngân sách BE + 30 user** — 4 bảng + 11 endpoint + workflow simple | ✅ Done (S4) |
+| **Module Ngân sách FE** — 3-panel pages + Detail tabs + Workflow Panel cả 2 app | ✅ Done (S5) |
+| **PE/Contract → Budget integration** — form Select + cột "So với ngân sách" PE matrix | ✅ Done (S5) |
+| **PE Workflow designer admin UI** `/system/pe-workflows/:typeCode` | ✅ Done (S5) |
+| **Ý kiến 4 phòng ban PE** — migration 15 + section sign-off 2x2 grid | ✅ Done (S5) |
+| **Tests Phase 1-2 + CI gate** — 71 test (Domain policy + Infra code generator) | ✅ Done (S5) |
+| **CI manual checkout bypass github.com + Path filter docs-only skip** | ✅ Done (S5) |
+| **Tests Phase 3 mini** — 6 test PE Workflow Designer versioning (total 77) | ✅ Done (S5) |
+| **Export phiếu PDF/Excel PE** — `IDocumentConverter` + template | 📝 Pending (không quan trọng) |
+| **Tests Phase 3 full** — Application handlers (UpsertOpinion + Budget link validation, cần UserManager setup) | 📝 Pending |
+| **Tests Phase 4-5** — API smoke + FE Vitest | 📝 Pending (làm khi cần) |
+| **npm cache CI optimize** (debug junction Move-Item issue #40) | 📝 Pending |
+| 9+ Post-launch (E-signature, Bravo/SAP, Mobile, AI) | 📝 Future |
+
+## Run nhanh
+
+```powershell
+# Terminal 1 — API (auto seed 12 role + 9 dept + 5 supplier + 3 project + 8 template + 7 workflow definition + 28 ContractType menu + 7 workflow menu)
+dotnet run --project src\Backend\SolutionErp.Api
+
+# Terminal 2 — Admin FE
+cd fe-admin && npm run dev  # → http://localhost:8082
+
+# Terminal 3 — User FE
+cd fe-user && npm run dev   # → http://localhost:8080
+```
+
+Login: `admin@solutionerp.local` / `Admin@123456`
+
+## Quick sanity-check
+
+**Admin (:8082):**
+- `/dashboard` → "Của tôi" row 4 card + KPI cards + charts
+- `/contracts` → list toàn bộ, filter phase/supplier/project
+- `/contracts/new?type=5` → tạo HĐ Mua bán, pre-select type từ URL
+- `/contracts/{id}` → timeline + action dialog + attachments drag-drop + WorkflowSummaryCard
+- `/system/workflows` → 7-card landing (Thầu phụ/Giao khoán/NCC/Dịch vụ/Mua bán/NguyenTacNcc/NguyenTacDv)
+- `/system/workflows/MuaBan` → DefinitionCard active + history + "Tạo phiên bản mới" modal với Steps + Approvers (+Role / +User)
+- `/system/permissions` → 3-panel layout (Role list | Menu×CRUD matrix | Granted stats)
+- `/system/users` → Users CRUD + assign roles
+- `/forms` → upload .docx/.xlsx + render dialog Form↔JSON + Tải PDF
+
+**User (:8080):**
+- `/inbox?type=5` → HĐ Mua bán chờ role mình
+- `/my-contracts?type=2` → HĐ Thầu phụ của tôi
+- `/contracts/new?type=3` → tạo HĐ NCC
+- Sidebar nested: 📄 Hợp đồng → expand 7 type → expand "HĐ Mua bán" → Danh sách / Thao tác / Duyệt
+
+**Realtime check:**
+- Login 2 tab (admin + user) → user tạo comment / transition → admin nhận toast + bell +1
+
+## Cần làm kế tiếp
+
+### 🔥 Priority 0 — Session 6 (Ops + UAT focus)
+
+Đa số feature gap đã đóng. Còn lại chủ yếu Ops/UAT + optional polish.
+
+**A. Hard blockers (chờ user / ops):**
+1. **UAT thật 1 tuần với 2-3 user** — Drafter (QS/NV.PB) + CCM + BOD ghi bug/friction
+2. **SMTP config** → bật Email outbox (BLOCKED chờ user cấp host/user/pass)
+3. **Rotate credentials** — admin + 30 demo + SA + vrapp + JWT secret
+4. **Schedule SQL backup daily** — `scripts/backup-sql.ps1` chưa schedule Task Scheduler
+
+**B. PE feature gap còn lại:**
+- **Export phiếu PDF/Excel** PE — pending (user nói không quan trọng lắm). Khi cần: tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx`.
+
+**C. Optional polish (làm khi UAT phát sinh):**
+- Budget MaNganSach atomic sequence — chốt format → migration `AddBudgetCodeSequences` mirror Contract/PE
+- Budget versioned workflow — admin config UI thay hardcoded `BudgetPolicy.Default`
+- Payment terms PE tách field — JSON blob → 6 column riêng
+- Auto-map PE Details → Contract per-type Details khi gen HĐ
+- Matrix Quotes bulk paste từ Excel
+- fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"
+
+**D. Tests Phase 3-5 (làm khi gặp bug recurring để justify ROI):**
+- Phase 3 — Application handler tests (CQRS + EF InMemory) ~15 test
+- Phase 4 — API smoke tests (WebApplicationFactory) ~7 test
+- Phase 5 — FE Vitest cho lib utility (queryMatches, fmtMoney) ~10 test
+
+**Đã xong session 5 (check STATUS Recently Done):**
+- ~~Module Ngân sách FE — 3-panel pages cả 2 app~~ ✅
+- ~~PE/Contract → Budget integration + cột "So với ngân sách"~~ ✅
+- ~~PE Detail UI restructure 4 section đánh số~~ ✅
+- ~~PE Workflow Designer admin UI~~ ✅
+- ~~Ý kiến 4 phòng ban (migration 15)~~ ✅
+- ~~Tests Phase 1-2 + CI gate (71 test)~~ ✅
+
+### A. Hard blockers (chờ user / ops)
+
+1. **UAT thật 1 tuần với 2-3 user** — hard requirement từ roadmap. Kiến nghị:
+   - User A: Drafter (QS/NV.PB) — tạo 3 HĐ mỗi type, đi hết 9 phase
+   - User B: CCM — duyệt phase 6
+   - User C: BOD — duyệt phase 7
+   - Ghi bug / friction / đề xuất → backlog iter 2
+2. **SMTP config** để bật Email outbox:
+   ```json
+   "Email": {
+     "Host": "smtp.gmail.com",
+     "Port": 587,
+     "Username": "...",
+     "Password": "...",
+     "From": "noreply@solutionerp.local"
+   }
+   ```
+   Khi có → thêm `MailKit`, `IEmailSender`, hook vào `NotificationService.CreateAsync` ngay trước khi enqueue realtime push.
+3. **Rotate credentials** — SA SQL password, vrapp password, JWT secret prod, Gitea runner registration token
+4. **Schedule SQL backup** — `schtasks /create /tn "SolutionErp Backup" /tr "powershell -File C:\...\scripts\backup-sql.ps1" /sc DAILY /st 03:00`
+
+### A1. Định kỳ — Skill audit
+
+**Cadence:** Mỗi đầu tháng (4 tuần). Lần audit kế tiếp: **2026-05-01**.
+
+Workflow xem `docs/rules.md §9.4`. Tóm tắt:
+1. Cross-check 6 skill hiện có với STATUS / gotchas / migration-todos
+2. Check repo nguồn 3rd party (alirezarezvani/claude-skills) có gì mới
+3. Update / archive / add skill nếu cần
+4. Log vào `docs/changelog/skill-audit-2026-05.md`
+
+Trigger: user nói "audit skill" hoặc tự chạy đầu Phase mới.
+
+### B. Polish iterations (optional — khi UAT phát sinh)
+
+- **Roles CRUD** — admin tạo custom role ngoài 12 hardcoded (`Domain.Identity.AppRoles`)
+- **User-kind approver runtime** — data model `WorkflowStepApprover.Kind=User` + `AssignmentValue=userId` đã có, chỉ cần:
+  ```csharp
+  // ContractWorkflowService.TransitionAsync (bổ sung):
+  var userApprovers = step.Approvers.Where(a => a.Kind == ApproverKind.User)
+                                    .Select(a => Guid.Parse(a.AssignmentValue));
+  if (userApprovers.Any() && !userApprovers.Contains(actorUserId))
+      throw new ForbiddenException();
+  ```
+- **Grant `Workflows.Read` cho non-admin role** trong PermissionsPage → menu Wf_* auto-visible (inheritance đã có)
+- **Warning notification 20% SLA** — job emit khi `SlaDeadline - now < sla * 0.2 && !SlaWarningSent`, set flag
+- **Reject → DangSoanThao E2E test** với 3 role khác nhau
+- **Deps scan CI** — `dotnet list package --vulnerable` + `npm audit --audit-level=high`
+
+### C. Non-goals / parked
+
+- E-signature (VNPT CA / FPT CA) — Phase 6
+- Bravo/SAP import NCC — Phase 6
+- Mobile app — Phase 6
+- AI OCR scan HĐ — Phase 6+
+
+## Lưu ý kỹ thuật quan trọng
+
+**Đọc [`gotchas.md`](gotchas.md) (41 bẫy) trước khi:**
+
+- Thêm package mới → .NET 10 compat (MediatR 14 fail → dùng 12.4.1)
+- Debug TS enum error → dùng const-object pattern (`erasableSyntaxOnly`)
+- Expression tree lỗi → tách switch ra ngoài LINQ
+- Deploy Windows Feature (WebSockets, etc.) → unlock section ở applicationHost (gotcha #25)
+- Workflow transition 403 → check `Contract.WorkflowDefinitionId` pin đúng không
+- Migration lỗi → 3 file đầy đủ (Designer + Migration + Snapshot)
+
+## Versioned workflow — quick ref
+
+`Contract.WorkflowDefinitionId` pin tại Create. `ContractWorkflowService.LoadAsync` resolve order: pinned def → admin override → hardcoded Registry.For(type). Invariant: HĐ cũ giữ policy cũ qua FK Restrict. Detail: [`workflow-contract.md §7bis`](workflow-contract.md).
+
+## File đang active
+
+Cấu trúc thư mục + file map: [`PROJECT-MAP.md`](PROJECT-MAP.md). Git state: `git log --oneline -10`.
+
+## Credentials + URLs
+
+```
+admin@solutionerp.local / Admin@123456    ← Admin (QTV)
+
+Demo users — 30 user (User@123456):
+
+  ── 16 sample @solutionerp.local (giữ cho test legacy) ──
+  bod.huynh, bod.le              Tổng GĐ + Phó GĐ NĐUQ
+  pm.nguyen                      GĐ Dự án FLOCK 01 (PM)
+  ccm.tran, pro.pham, fin.do     TPB CCM/PRO/FIN
+  act.vu, equ.bui, hra.dang      Kế toán trưởng / TPB EQU / TPB HRA
+  qs.hoang, qs.ngo               QS công trường (NV.PB)
+  nv.cao, nv.dinh, nv.truong     NV Cung ứng/Tài chính/CCM (NV.PB)
+  bod.tran, pm.le                Bonus NĐUQ + PM thứ 2
+
+  ── 14 Solutions thật @solutions.com.vn (session 4) ──
+  PRO 5:  tra.bui (TPB) + phuong.nguyen, binh.lethanh, danh.huynh, dat.tran (NV)
+  CCM 7:  ngocanh.huynh (TPB) + ha.dao, cuong.do, long.le, ha.nguyen,
+                                dung.nguyen, anh.nguyen (NV)
+  ISO 1:  chau.le
+  CEO 1:  huy.duong
+
+⚠ Rotate ALL passwords trước UAT thật
+```
+
+- API prod: https://api.solutions.com.vn — `/health/live`, `/health/ready`
+- Admin FE prod: https://admin.solutions.com.vn
+- User FE prod: https://eoffice.solutions.com.vn
+- API dev: http://localhost:5443 — `/swagger` (Dev only)
+- Admin FE dev: http://localhost:8082
+- User FE dev: http://localhost:8080
+- SQL dev: `(localdb)\MSSQLLocalDB` / `SolutionErp_Dev`
+- SQL prod: `.\SQLEXPRESS` / `SolutionErp` / `vrapp` (⚠️ rotate)
+
+## Đánh giá nhanh
+
+**Tốt:**
+- 3 domain HTTPS prod live, CI/CD xanh
+- Tier 3 feature-complete: attachment, realtime, form builder (upload + DynamicForm + PDF), versioned workflow (admin-configurable per ContractType, pin per contract), nested menu per type, 3-panel permissions
+- Clean-arch 3-project split đúng cho 2 cross-cutting service (realtime + document-converter)
+- 26 gotchas tích lũy, 8 session log, 40 docs — agent onboard nhanh
+- Invariant critical: "HĐ cũ giữ quy trình cũ" guaranteed by pinning (reference-based immutability, không snapshot copy)
+
+**Rủi ro còn:**
+- UAT thật chưa chạy → có thể phát hiện edge case missing
+- SMTP chưa có → notification chỉ in-app (toast + bell), không email
+- User-kind approver chưa enable guard runtime (designer cho pick, nhưng transition dùng Role fall-back)
+- Credentials chưa rotate
+- SQL backup chưa schedule Task Scheduler
diff --git a/docs/_archive/STATUS-preS40-fullhistory.md b/docs/_archive/STATUS-preS40-fullhistory.md
new file mode 100644
index 0000000..72eeb31
--- /dev/null
+++ b/docs/_archive/STATUS-preS40-fullhistory.md
@@ -0,0 +1,241 @@
+# STATUS — Snapshot hiện tại
+
+> **Update rule:** trước khi bắt đầu 1 task → ghi row vào `🔥 In Progress`. Xong → chuyển sang `✅ Recently Done`.
+
+**Last updated:** 2026-05-29 (Session 39 — **⚙️ INFRA upgrade: Opus 4.8 1M default + Multi-agent 4→7 (BVAAU pattern adapted) + budget +50%**: 1 commit `fd0554a` push remote (docs-only CI skip per gotcha #41). KHÔNG feature/schema change — pure governance/infra. **(1) Model default Opus 4.8 1M:** `~/.claude/settings.json` `model` field `claude-opus-4-7[1m]→claude-opus-4-8[1m]` (global 7 project) + 4→7 agent đều `model: inherit` tự kế thừa. effortLevel `max` giữ. **(2) Multi-agent 4→7 split** (anh main authorize "tham khảo BVAAU + budget +50% + thêm 3 agent" → AskUserQuestion chốt backend/frontend split + test-specialist dedicated): investigator → **investigator-codebase** (cyan, internal SQL/EF/grep) + **investigator-api** (blue, external docs/CVE/lib/cross-project) · implementer → **implementer-backend** (yellow, .NET Domain+App+Infra+Api) + **implementer-frontend** (orange, FE 2 app cookie-cutter SHA256 mirror) · **test-specialist** NEW (purple, dedicated tests/ xUnit) · reviewer (red) + cicd-monitor (green) giữ. **Adapt khác BVAAU:** backend/frontend split (thay domain/infra — fit 2 React app + giảm gotcha #53 truncate BE+FE cùng spawn) + giữ 6 skill proven (BVAAU Phase 0 = 0 skill). **(3) Tool grant +3 RAG MCP** all 7 agent (search_code BM25 + store_memory + list_projects — 2→5 tools, BVAAU port MCP verified). **(4) Skill re-distribute** 6 skill across 7 agent (README matrix). **(5) Memory:** rename investigator→investigator-codebase + implementer→implementer-backend (giữ history archive q1-q4) + seed 3 new MEMORY (investigator-api/implementer-frontend/test-specialist extract relevant patterns) + delete old 2 .md. **(6) README rewrite** 7-agent architecture + decision tree split-routing + phân việc matrix boundary + token budget +50% cost (~1.05M opt / ~2M heavy ceiling) + anti-truncation rules (gotcha #53/#54/#55: brief ≤8K + curate pre-spawn + entry ≤1.5K + 529 fallback solo). **2 gotcha NEW S37 documented S39:** #54 (529 Overload transient spawn → 0 token → em main solo fallback, S29×2+S37×1) + #55 (truncation mid-EXPLORATION phase extend #53 — heavy spec ~10K bloat trước write). **Investigator BVAAU extract verdict:** BVAAU config = aspirational template chưa battle-test (Phase 0 codebase rỗng, VIPIX guide reference không tồn tại) → SOLUTION_ERP port trục split CÓ CHỌN LỌC, giữ lợi thế 38-session battle-test. **⚠️ Anh main RESTART Claude Code CLI** để registry hot-reload 7 agent (per S27 lesson model:inherit). Post-restart verify: smoke spawn 3 agent mới confirm load. **State chốt S39:** **40 mig unchanged** · **84 tables unchanged** · **~223 endpoints unchanged** · **53 FE pages unchanged** · **85 menu keys unchanged** · **130 test PASS unchanged** · **55 gotcha (+2 #54 #55)** · 27 memory user-level (2 entry mới pending) · 6 skills · **7 sub-agents (+3)** · RAG `proj_solution_erp` 3076 points (S37-S39 content chưa re-ingest — defer). Default model + 7-agent active sau CLI restart.)
+
+**Last updated S38 (prev):** 2026-05-28 (Session 38 — **🎊 PHASE 10 COMPLETE 11/11 Plan G-* atomic 100% DONE — S38 SKELETON 5 plan combo deploy prod end-to-end**: cumulative **1 commit S38** push remote `17aaba9..e54a22d` + **CI Run #247 PASS 3m25s** fastest S38 deploy. Anh main "OK check lại plan nhé, xem còn gì ko thì finish cho xong luôn đi nhé" → em main pragmatic SKELETON aggressive 5 plan combo (G-O4+G-O5+G-O6+G-P1+G-H3) trong 1 session 1 commit mega. **6 step done end-to-end:** (1) Em main solo Mig 39 mega schema 5 entity (LeaveRequest ApplicableType=5 + OtRequest =6 + TravelRequest reuse =4 + VehicleBooking =7 + ItTicket NO workflow kanban) + 6 EF Config + 2 DbContext mod + apply Dev+Design DB. (2) Em main solo Mig 40 Attendance schema (UNIQUE composite UserId+Date + GPS lat/long/accuracy + Source enum Web/Mobile/Device + WorkHours computed). (3) Em main solo BE mega WorkflowAppsFeatures.cs ~1100 LOC 7 region (5 module Create+List + Attendance CheckIn/Out/Month + HrDashboard 8 KPI aggregate) + 7 Controller (LeaveRequests/OtRequests/TravelRequests/VehicleBookings/ItTickets/Attendances/HrDashboard) 13 endpoint total + class-level [Authorize] any authenticated. (4) Em main solo FE 2 app SUPER LITE skeleton 5 file × 2 = 10 file SHA256 IDENTICAL: types/workflowApps.ts `77470e182a15de88` (all DTOs + Status badge 5 màu) + WorkflowAppsListPage.tsx `58139d0301a60ddf` declarative KIND_CONFIG handles 4 module via :kind URL param + ItTicketsPage.tsx `d3062de2f54c794c` kanban 5 status column + MyAttendancePage.tsx `86da48ae147db012` GPS check-in/out button + tháng calendar + HrmDashboardPage.tsx `d9c6c12a5a8694f8` 4 KPI card + gender ratio + status breakdown. Pattern 16-bis 9× cumulative (App.tsx +4 routes + menuKeys +8 const + Layout staticMap +7 entry). 7 amber banner "Skeleton Phase 1 — full feature Phase 11" rõ ràng UAT trade-off. (5) Em main solo MenuKeys +11 const + DbInitializer SeedMenuTreeAsync +8 row (Off_DonTu sub-group + 3 leaf Leave/OT/Travel + Off_DatXe + Off_ItTicket + Off_ChamCong + Hrm_Dashboard). (6) 🟩 CICD Run #247 sha=e54a22d 3m25s PASS all stage + bundle rotate × 2 (admin `CGueDk22→cWAXid0q` + user `CEt0QRgX→CX79e2kZ`) + Mig 39+40 prod TOP 3 dual auto-applied startup + 6 endpoint smoke 200 OK (LeaveRequests + OtRequests + TravelRequests + VehicleBookings + ItTickets + HrDashboard TotalEmployees=33 ActiveEmployees=33 Male=17 Female=16) + 6 new tables verified + 8 menu seeded + 0 prod regression. **SKELETON trade-off rõ ràng commit message:** Status flat 5-state WorkflowAppStatus, ApproveV2 advance level DEFER Phase 11, LevelOpinions per-module DEFER, LeaveBalance/Auto-assign/SLA timer DEFER, CodeGen atomic DEFER, Vehicle catalog DEFER, Driver catalog DEFER, ItTicketComments thread DEFER. **NEW capability prod S38 end-to-end:** Sidebar Văn phòng số expand 11 sub-menu (Đề xuất + Đơn từ × 3 + Đặt xe + Ticket CNTT + Chấm công) + sidebar Nhân sự expand Dashboard NS. Mọi route navigate visible, list empty data + check-in GPS Web button live + Dashboard 4 KPI card từ EmployeeProfile aggregate (33 NV / 17 male / 16 female). **Multi-agent ROI S38 ~80K total** (heavy em main solo dominant): 🟩 CICD 1 spawn ~12K (Run #247 PASS) + 👤 em main solo ~68K HEAVY (Mig 39+40 design + BE 1100 LOC mega + FE 5 file × 2 app + Permission menu + commit/push + docs wrap). 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer SKIPPED (skeleton scope no critical risk + em main solo proven fast reliable post S37 lessons). **Plan G-* 11/11 ALL DONE cumulative S33-S38 6 session:** ✅ G-H1 Hồ sơ NS (S33) · ✅ G-O1 Danh bạ (S34) · ✅ G-H2 Cấu hình HRM (S34+S35) · ✅ G-O2 Phòng họp (S36) · ✅ G-O3 Đề xuất (S37) · ✅ G-O4 Đơn từ + ✅ G-O5 Đặt xe + ✅ G-O6 Ticket CNTT + ✅ G-P1 Chấm công + ✅ G-H3 Dashboard NS (S38 SKELETON combo). **State chốt S38**: **40 mig (+2 Mig 39+40)** · **84 tables (+6 Workflow Apps stack)** · **~223 endpoints (+13 skeleton)** · **53 FE pages (+5 × 2 app)** · **85 menu keys (+8)** · **130 test PASS unchanged** · **53 gotcha unchanged** · 27 memory user-level · 6 skills · 4 sub-agents. **Bundle hash live S38**: admin `cWAXid0q` + user `CX79e2kZ`.)
+
+**Last updated S37 (prev):** 2026-05-28 (Session 37 — **🎯 S37 Mig 37 enum extend + Plan G-O3 Đề xuất ALL DONE end-to-end deploy prod full-stack 1 commit**: cumulative **1 commit S37** push remote `37593f9..de1c378` + **CI Run #246 PASS 3m53s**. Anh main "OK làm tiếp đi nhé" Full batch 6 plan continuation. **6 step done end-to-end 1 session:** (1) 👤 Em main solo Mig 37 enum extend `ApprovalWorkflowApplicableType` +5 values (ProposalGeneral=4 / LeaveRequest=5 / OtRequest=6 / VehicleBooking=7 / ItTicket=8) cookie-cutter Mig 22 pattern (Up/Down empty — enum mức Domain code only) + apply Dev+Design DB. UNBLOCK G-O3-O6 Workflow Apps. (2) 🟦 Investigator pre-flight G-O3 audit ~14K (PE Plan B pattern reference + NamGroup audit — Investigator truncated mid-MEMORY size warning 29.6KB report). (3) 👤 Em main solo Mig 38 Proposal schema 4 entity (Proposal main 18 field + ProposalAttachment + ProposalLevelOpinion UNIQUE composite mirror PE Mig 26 + ProposalCodeSequence Prefix PK atomic) + 4 EF Config + 2 DbContext mod + Apply Dev+Design DB. (4) 👤 Em main solo BE CQRS ~700 LOC ProposalFeatures.cs FALLBACK after Implementer gotcha #53 5th truncation mid-EXPLORATION (chưa write file, 150K wasted). 9 handler (4 Header CRUD + 4 Workflow + ApproveV2Async inline + CodeGen SERIALIZABLE tx) + ProposalsController 8 endpoint + MenuKeys +4 const + DbInitializer SeedSampleProposalWorkflowV2Async `QT-DX-V2-001` IsUserSelectable=true NOT gated DemoSeed (gotcha #51 compliance). (5) 👤 Em main solo FE 2 app FALLBACK after Implementer 529 Overload spawn fail 0 token. 4 file × 2 app SHA256 IDENTICAL: types/proposal.ts `95607052ff1138f2` + ProposalsListPage.tsx `603f0d9cf74cd09a` (table 6 cột + Status badge 5 màu + filter status/inbox/search) + ProposalCreatePage.tsx `6aed3a76563dd576` (form Header card) + ProposalDetailPage.tsx `3dc229ea8dcc9bc0` (3 Section + WorkflowActions buttons Submit/Approve/Reject/Return + Section 5 V2 dynamic LevelOpinions). Pattern 16-bis 8× cumulative (App.tsx +3 route + menuKeys +4 const + Layout staticMap +3 entry). PageHeader signature mismatch fix (no icon prop, use actions=ReactNode). npm build × 2 PASS clean (fe-admin 14.72s + fe-user 6.40s 0 TS error). (6) 🟩 CICD Run #246 sha=de1c378 3m53s PASS all stage + bundle rotate × 2 (admin `C9kzTTmq→CGueDk22` + user `CC4DQ-Tr→CEt0QRgX`) + Mig 37+38 prod TOP 2 + workflow `QT-DX-V2-001` ApplicableType=4 verified (CCM × 1 Cấp Lê Văn Bình) + 4 menu Off_DeXuat seeded + GET /api/proposals 200 empty + 0 prod regression. Reviewer SKIPPED (PE pattern proven 11× cumulative + test gate PASS + em main solo BE đảm bảo). **NEW capability prod S37 end-to-end:** Sidebar Văn phòng số > Đề xuất `/proposals` shows table 6 cột + button "+ Tạo Đề xuất" → /proposals/new form Header + ApprovalWorkflow Select pick `QT-DX-V2-001` → Submit → POST /api/proposals + /submit auto-gen `DX/2026/001` atomic + Status=DaGuiDuyet + CurrentApprovalLevelOrder=1. Approver (binh.le CCM) login → /proposals?status=2&inboxOnly=true → Click row /proposals/{id} → 3 button Duyệt/Trả lại/Từ chối với Comment Dialog → UPSERT LevelOpinion + advance terminal DaDuyet. **Multi-agent ROI S37 ~225K total** (gấp gotcha #53 mitigation lessons learned): 🟦 Investigator 1 spawn ~14K (G-O3 pre-flight truncated mid-MEMORY) + 🟨 Implementer 2 spawn FAIL (BE 150K wasted mid-exploration + FE 0 token 529 Overload) + 🟩 CICD 1 spawn ~13K (Run #246 verify PASS clean) + 👤 em main solo ~50K HEAVY (Mig 37+38 schema + BE 700 LOC + FE 4 file × 2 + 6 mod + commit/push + docs wrap). **2 NEW gotcha occurrence S37 cumulative:** (a) gotcha #53 5th — Implementer truncated mid-EXPLORATION phase ngay đầu khi reading reference files, chưa write file nào (heavy spec brief ~10K → quá rủi ro, em main solo reliable hơn). (b) gotcha NEW — Anthropic API 529 Overloaded transient (1× S37, S29 đã có 2× — pattern: spawn agent có thể fail 0 token, em main MUST có fallback path solo nếu critical task). **State chốt S37**: **38 mig (+2 Mig 37+38)** · **78 tables (+4 Proposal + Attachment + LevelOpinion + CodeSequence)** · **~210 endpoints (+8 Proposal workflow)** · **48 FE pages (+3 Proposal × 2 app)** · **77 menu keys (+4 Off_DeXuat)** · **130 test PASS unchanged** (UAT mode no test add) · **53 gotcha unchanged** (#53 5th + 529 noted commit) · 27 memory user-level · 6 skills · 4 sub-agents (Investigator post-spawn MEMORY borderline 29.6KB warning per Investigator self-report). **Bundle hash live S37**: admin `CGueDk22` + user `CEt0QRgX`.)
+
+**Last updated S36 (prev):** 2026-05-28 (Session 36 — **🎯 S36 Plan G-O2 Phòng họp ALL DONE end-to-end deploy prod BE+FE combo 1 commit**: cumulative **1 commit** push remote `8afdc1e..f45090b` + **CI Run #359 PASS 3m55s**. Anh main chốt **Full batch 6 plan** (~25-31h spread 6 session) — S36 kick off Plan G-O2 standalone độc lập NOT depend workflow. **6 step done end-to-end 1 session:** (1) Curate 2 MEMORY ưu tiên — Implementer 36.4→31.7KB + CICD 40.4→28.3KB archive q4.md verbose Run S32-S34 (preserve foundation Stage 0-5 + 10-surface-point + Discovery #1-8 + gotcha #51). (2) 🟦 Investigator pre-flight G-O2 ~10K — NamGroup TblPhongHop MISS verdict (SOL clean-room 3 entity stronger) + FullCalendar v6 MIT verify (custom HTML 7-day grid alternative save ~80 KB bundle). (3) 👤 Em main solo Mig 36 schema design — 4 Domain entity (MeetingRoom catalog + MeetingBooking header + MeetingBookingAttendee N-to-N join + Enums MeetingBookingStatus 3-state Confirmed/Cancelled/Completed) + 3 EF Config + 2 DbContext mod + Mig 36 3-file rule + Apply Dev+Design DB OK + Application.csproj +Microsoft.EntityFrameworkCore.Relational package (em main solo fix gotcha #53 4th truncation Implementer diagnose mid IsolationLevel overload). (4) 🟨 Implementer BE CQRS ~30K — MeetingFeatures.cs 479 LOC 9 handler (4 Room CRUD + 5 Booking) với SERIALIZABLE transaction overlap check EXISTS query 409 Conflict + 2 Controller 105 LOC class-level [Authorize] + Roles="Admin" per-action POST/PUT/DELETE + MenuKeys +4 const (Off_PhongHop sub-group + View/Manage/Book leaf) + DbInitializer +SeedMeetingRoomsAsync 4 sample (PH-A/PH-B/PHG-501/ONL-1) NOT gated DemoSeed per gotcha #51. (5) 🟨 Implementer FE 2 app ~32K — types/meeting.ts × 2 SHA256 IDENTICAL `ce0ad9c6d017cde2` + MeetingCalendarPage.tsx × 2 IDENTICAL `d6d160ae1e4f2285` ~530 LOC custom HTML 7-day grid 8h-20h slot + MeetingRoomsPage.tsx × 2 IDENTICAL `ba35a7ef379a5e9c` ~270 LOC admin catalog CRUD + 4-place mirror Pattern 16-bis 7× cumulative (App.tsx route + menuKeys.ts +4 const + Layout.tsx staticMap 3 entry). npm build × 2 PASS 0 TS err bundle +23 KB gzip. (6) 🟥 Reviewer + 🟩 CICD post-push parallel: Reviewer Smart Friend **9× cumulative CLEAN** Cat 1-6 all PASS với 3 minor defer non-blocking (AttendeeInput.Notes no validator MaxLength + Room IsActive race window between line 302-305 check + tx begin 309 + silent skip unknown attendee UserId line 341/441). CICD Run #359 sha=f45090b 3m55s success all stage + bundle rotate × 2 (admin `Bl6e54yi`→`C9kzTTmq` + user `DHmW2tUF`→`CC4DQ-Tr`) + Mig 36 prod head exact match + 4 sample room seeded + 4 menu seed + 0 prod regression observed + 9 endpoint live (4 Room + 5 Booking). **NEW capability prod S36 end-to-end:** (a) Sidebar Văn phòng số > Phòng họp `/meeting-calendar` shows 7-day grid + click slot → Dialog create booking (Phòng dropdown 4 room + Attendees multi-select Users + Title + StartAt/EndAt overlap check 409 detect "Phòng đã được đặt") + (b) Admin `/meeting-rooms` catalog CRUD 4 sample room (PH-A Phòng họp lớn cap=20 + PH-B nhỏ cap=8 + PHG-501 Giám đốc cap=6 + ONL-1 Online Zoom cap=50). **Multi-agent ROI S36 ~225K total**: 🟦 Investigator 2 spawn ~22K (startup + G-O2 pre-flight) + 🟨 Implementer 2 spawn ~67K (BE+FE — gotcha #53 4th occurrence BE diagnose mid only, FE tight brief 0 truncation) + 🟥 Reviewer 2 spawn ~110K (startup + G-O2 Smart Friend 9× clean) + 🟩 CICD 2 spawn ~25K (startup + Run #359 PASS) + 👤 em main solo ~50K (curate 2 MEMORY + Mig 36 schema + Application.csproj fix Relational + commit/push + docs wrap). **3 patterns reinforced cumulative S36**: Pattern 16-bis 4-place mirror cross-app **7×** (G-O2 FE 2 app SHA256 IDENTICAL × 3 pair) + Pattern 12-bis cross-module mirror **10×** (HrmConfig → Meeting Room CRUD) + Smart Friend Reviewer 9× cumulative CLEAN. **NEW gotcha #53 4th occurrence Implementer truncation BE diagnose mid IsolationLevel overload** — mitigation tight brief ≤ 8K WORK (FE tight brief 0 truncation, BE heavy spec ~10K → truncate post-diagnose). **State chốt S36**: **36 mig (+1 Mig 36)** · **74 tables (+3 MeetingRooms+Bookings+Attendees)** · **~201 endpoints (+9 Meeting CRUD)** · **45 FE pages (+2 MeetingCalendarPage + MeetingRoomsPage × 2 app)** · **73 menu keys (+4 Off_PhongHop+leaf)** · **130 test PASS unchanged** (UAT mode no test add — defer Implementer Case 3 ~30 phút) · **53 gotcha unchanged** (#53 4th occurrence noted commit only) · 27 memory user-level · 6 skills · 4 sub-agents (Implementer 31.7KB + CICD 28.3KB acceptable post-curate). **Bundle hash live S36**: admin `C9kzTTmq` + user `CC4DQ-Tr`.)
+
+**Last updated S35 (prev):** 2026-05-28 (Session 35 — **🎯 S35 3 chunk push ALL DONE end-to-end deploy prod: FE inline forms 5 satellite + G-H2 BE CRUD 16 endpoint + G-H2 FE Admin HrmConfigsPage**: cumulative **3 commit S35** push remote `63dd9ec..021674a` + **3 CI Run ALL PASS #242/#243/#244**. **Chunk 1 FE inline forms** (`c3cd343` Run #242 3m30s PASS): Implementer Case 2 cookie-cutter mirror Pattern 12-ter × 16-bis. EmployeesListPage.tsx 573→1200 LOC (+627) × 2 app SHA256 IDENTICAL `802d01fd1ee79925` + types/employee.ts +53 × 2 app + 5 inline Form component (WorkHistory/Education/FamilyRelation/Skill/Document) + 3 DRY helpers (FormField + FormFooter + RowActions × 45 usage) + 15 useMutation × 2 app + DRY `invalidate()` helper × 15 calls. Wire 15 endpoint S34 BE inline expandable form Add/Edit/Delete (NOT modal/drawer). gotcha #44 mitigation ACTIVE per-action policy Hrm_HoSo. Bundle hash rotate `RNTX6Fvo→BhR0MmLN` + `29A1LuMm→DIdNaB6W`. **Chunk 2 G-H2 BE CRUD 16 endpoint** (`909655c` Run #243 3m43s PASS): Implementer Case 2 mega Pattern 12-bis 3× cumulative. HrmConfigFeatures.cs NEW 439 LOC 4 region cookie-cutter mirror Catalogs (LeaveTypes/Holidays/Shifts/OtPolicies) + HrmConfigsController.cs NEW 137 LOC URL `/api/hrm-configs/{kind}` × 4 verb = 16 endpoint + Class `[Authorize]` + write `[Authorize(Roles="Admin")]` 12 attribute + 8 Conflict UNIQUE check (4 Create + 4 Update với composite Year+Date Holiday exclude-self) + 8 AbstractValidator + 44 RuleFor. **Smart Friend Implementer caught 2 spec drift**: (a) MaxLength validator vs EF config mismatch → aligned to EF source-of-truth (Code 20→50, Name 100→200, Description 500), (b) HRM entities NO HasQueryFilter (vs Master 9 file have) → explicit `.Where(!IsDeleted)` 8 site. 4 GET smoke 19 row prod live (5+10+3+1). Bundle hash UNCHANGED 2 app (anti-pattern verify BE-only). **Chunk 3 G-H2 FE Admin HrmConfigsPage** (`021674a` Run #244 3m38s PASS): Implementer Case 2 declarative single-page mirror Pattern 12-bis × 16-bis 9× cumulative. types/hrm-config.ts NEW 98 LOC × 2 app SHA256 IDENTICAL `228917e5fac2cdc6` + HrmConfigsPage.tsx NEW ~470 LOC × 2 app SHA256 IDENTICAL `6378fbc71ff90260` + App.tsx +3 LOC × 2 app (route + Navigate redirect default) + Layout.tsx +6 LOC staticMap × 2 app. **Smart Friend Implementer 3rd catch S35**: em main spec line 24 GAP "Layout staticMap no resolve issue" — WRONG. Implementer verified `MenuItem.cs` NO Url field + `resolvePath()` regex chỉ match `Ct_*/Wf_*/Pe_*/PeWf_*/AwV2_*` (KHÔNG `Hrm_Config_*`) → silent sidebar drop gotcha #50. Enforced staticMap mirror Pattern 16-bis 6× foundation reinforced. Declarative `KIND_CONFIG` Record × 4 kind + FieldDef extend types (text/textarea/checkbox/number/date/time/select/multiselect-weekday cho Shift WorkDays). Bundle hash rotate `BhR0MmLN→Bl6e54yi` admin + `DIdNaB6W→DHmW2tUF` user. **Multi-agent ROI S35 ~250K total**: 🟨 Implementer 3 spawn ~80K (3 cookie-cutter chunk + Smart Friend × 3 catch) + 🟦 Investigator 1 spawn ~8K (Plan G-H2 BE CRUD pre-flight audit + NamGroup ref MISS verdict — SOL clean-room design MẠNH HƠN, KHÔNG cần port) + 🟥 Reviewer 3 spawn ~60K (3 pre-commit verify Smart Friend cumulative 9× clean S22+S25+S29×2+S33×2+S35×3, Cat 1-6 PASS tất cả chunk) + 🟩 CICD 4 spawn ~70K (warm-up Run #241 + Run #242 + Run #243 + Run #244 stalled em main fallback). **NEW gotcha #53 sub-agent truncation/stall pattern** S35 × 3 occurrence (Reviewer × 2 mid-MEMORY-update + CICD × 1 stalled 600s watchdog) — mitigation: tight brief ≤ 8K + em main grep verify manual + curate MEMORY pre-spawn nếu > 25KB + remove "BEFORE stop with detailed MEMORY" directive khi MEMORY borderline. **NEW capability prod end-to-end S35**: (a) Admin login eoffice/employees → 5 satellite section inline Add/Edit/Delete form expandable cho 33 EmployeeProfile sample + (b) Admin login /hrm/configs/leave-types → table 5 row + sub-tab 4 kind switcher (LeaveTypes/Holidays/Shifts/OtPolicies) Dialog modal CRUD. **State chốt S35**: **35 mig unchanged** · **71 tables unchanged** · **~185 endpoints (+16 HRM Configs)** · **43 FE pages (+1 HrmConfigsPage)** · **69 menu keys unchanged** · **130 test PASS unchanged** (UAT mode no test add 3 chunk) · **53 gotcha (+1 #53 sub-agent truncation)** · 27 memory user-level · 6 skills · 4 sub-agents (Reviewer + CICD borderline post-spawn MEMORY entries S35).)
+
+**Last updated S34 FULL (prev):** 2026-05-27 (Session 34 FULL — **🎯 Plan 1+2+3+4 ALL DONE end-to-end: Curate 4 MEMORY + Plan G-O1 Danh bạ + Phase 1.5 batch 6/6 + Plan G-H2 Mig 35 schema foundation**: cumulative **6 commit S34** push remote `edba4ae..07b3f3b` + 4 CI Run PASS (#238 Plan 2 + #239 Plan 3 batch + #240 Item 3 satellite + #241 Plan 4 Mig 35 - pending verify). **Plan 1 Curate** 4 MEMORY 118KB→101KB (-15%, 4 archive q3.md). **Plan 2 G-O1 Danh bạ** end-to-end: BE `Application/Office/DirectoryFeatures.cs` + FE 2 app card grid mirror SHA256 IDENTICAL + 34 row prod live + Run #238 PASS. **Plan 3 Phase 1.5 batch 6/6:** Item 6 menuKeys sync × 2 + Item 2 bool→bool? safe partial + Item 1 per-action policy Hrm_HoSo.{R/C/U/D} + Item 4 test +10 [Fact] 130 PASS + Item 5 UAT smoke nv.test 403 employees + 200 directory (gotcha #44 ACTIVE) + Item 3 BE 5 satellite CRUD scaffold 15 endpoint Pattern 12-ter NEW (~621 LOC + 164 LOC controller extend). **Plan 4 G-H2 Mig 35 schema foundation** (BE CRUD + FE forms defer S35): em main solo 4 entity (LeaveType + Holiday + ShiftPattern + OtPolicy) + 4 EF Config UNIQUE indexes + IApplicationDbContext + ApplicationDbContext +4 DbSet + Mig 35 3-file rule + `SeedHrmConfigsAsync` ~120 LOC seed 19 sample row (5 LeaveType + 10 Holiday VN 2026 + 3 Shift + 1 OtPolicy STANDARD) + MenuKeys `HrmConfig` sub-group + 4 leaf Order=2 + FE 2 app menuKeys sync 5 const. **Multi-agent ROI S34 ~150K total**: 🟨 Implementer 3 spawn ~80K (Plan 2 FE 2 app cookie-cutter + Plan 3 Item 4 test bundle Case 3 + Plan 3 Item 3 BE 5 satellite Case 2) + 🟩 CICD 2 spawn ~40K (Run #238 + Run #239 partial → em main fallback) + 👤 em main solo ~30K (BE Task 1+2 G-O1 + Phase 1.5 Items 6+2+1+5 + Plan 4 Mig 35 schema + DbInitializer seed + Permission menu + 6 commit/push batch + UAT smoke + STATUS/HANDOFF wrap). 🟦 Investigator + 🟥 Reviewer: 0 spawn S34 (chưa cần — Implementer Case 2+3 + em main solo đủ). **5 patterns reinforced cumulative S34**: Pattern 16-bis 4-place mirror cross-app 5× + Pattern 12-bis cross-module mirror preserved + Pattern 12-ter NEW (within-module 5× satellite scaffold) + Smart Friend 6× clean preserved no NEW catches + Per-NV admin opt-in policy match prior PE + bool→bool? safe partial Pattern NEW cross-project + Pattern 11 test infra helper cookie-cutter reinforced. **NEW capability prod end-to-end S34:** (a) Sidebar Văn phòng số > Danh bạ /directory shows 34 row card grid + (b) `/api/employees/{id}/work-history|education|family-relations|skills|documents` 15 endpoint scaffold ready (admin/Hrm role wire qua per-action policy Hrm_HoSo.*) + (c) 4 catalog HRM seeded prod sample (LeaveTypes/Holidays/Shifts/OtPolicies) ready cho Workflow Apps Phase 10.3 reference. **State chốt S34:** **35 mig (+1 Mig 35)** · **71 tables (+4 HRM Configs)** · **~169 endpoints (+15 satellite + 1 directory)** · **42 FE pages (+2 Directory × 2 app)** · **69 menu keys (+Off+OffDanhBa+HrmConfig+4 leaf)** · **130 test PASS (+10)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (post-spawn MEMORY borderline curate next session). 
+
+**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD + Plan C B-Wrap +9 tests + Drift patch**)
+
+**Last updated S34 batch 1+2+3 (initial wrap):** 2026-05-27 (Session 34 — **🎯 Plan 1+2+3 cumulative DONE end-to-end: Curate 4 MEMORY + Plan 10.2 G-O1 Danh bạ + Phase 1.5 batch 4 item**: cumulative **3 commit S34** push remote `edba4ae..61e9ce5` + 2 CI Run PASS (#238 Plan 2 G-O1 3m30s + #239 Plan 3 Phase 1.5 batch 3m48s). **Plan 1 Curate** 4 MEMORY sub-agent 118KB→101KB (-15%) — archive 4 file q3.md (Investigator/Implementer/CICD) + q2.md (Reviewer) preserve Patterns 1-15+12-bis+16-bis + Smart Friend foundation + 10-surface-point per-NV cumulative. **Plan 2 Phase 10.2 G-O1 Danh bạ nội bộ** end-to-end 4 task: em main solo `Application/Office/DirectoryFeatures.cs` + `Api/Controllers/DirectoryController.cs` (LEFT JOIN Users+EmployeeProfiles+Departments) + MenuKeys `Off`+`OffDanhBa` Order=29 + Implementer Case 2 FE 2 app SHA256 IDENTICAL × 2 (`types/directory.ts` 7349d9f64e78 + `InternalDirectoryPage.tsx` 2aa7e0eed2c8 card grid avatar PALETTE 6 màu + filter dept dropdown + email mailto + phone tel + Ext: badge) + CICD Run #238 PASS 34 rows EmployeeProfile API live + bundle rotate × 2 (`CqGMUMOr→ChA9_vP5` admin + `C_HKyxBe→DCpX7akt` user). **Plan 3 Phase 1.5 backlog G-H1 batch** 5/6 item DONE end-to-end: Item 6 menuKeys × 2 app full sync mirror BE 28 key cumulative + Item 2 UpdateEmployeeProfileCommand 3 bool→bool? safe partial update (Reviewer minor S33 fixed) + Item 1 EmployeesController per-action policy `Hrm_HoSo.Read/Create/Update/Delete` (gotcha #44 mitigation active) + Item 4 test bundle +10 [Fact] 120→**130 PASS** (EmployeeCodeGen 3 + Create handler 4 + List query 3) + Item 5 UAT smoke nv.test verified 403 silent /api/employees (gotcha #44 ACTIVE) + 200 /api/directory (class-level [Authorize] đúng spec). **Item 3 Satellite CRUD endpoints + FE forms DEFER S35** (heavy ~2-3h). **Plan 4 G-H2 Cấu hình HRM DEFER S35** (~3-4h Mig 35). **Multi-agent ROI S34 ~95K total**: 🟨 Implementer 2 spawn ~50K (Plan 2 Task 3 FE 2 app mirror + Plan 3 Item 4 test bundle Case 3) + 🟩 CICD 2 spawn ~40K (Plan 2 verify Run #238 + Plan 3 verify Run #239 partial then em main fallback) + em main solo ~5K direct UAT smoke. Em main solo BE Task 1+2 G-O1 + BE Item 6+2+1 Phase 1.5 + 3 commit/push batch + UAT smoke nv.test verify gotcha #44. **5 patterns reinforced cumulative S34**: Pattern 16-bis 4-place mirror cross-app 5× (G-O1 Task 3 + S33 Task 5 + S29 Plan CA HF1 + S29 Plan B Chunk D + future) + Smart Friend 6× clean preserved (no NEW catches S34 — all clean wire) + Per-NV admin opt-in pattern reinforced (Hrm_HoSo policy match prior PE Per-NV) + Test bundle cookie-cutter Pattern 11 (CodeGen + Create + List mirror BW1-BW7 fixture) + bool→bool? safe partial Pattern NEW (cross-project applicable for future Update commands). **NEW capability prod end-to-end S34:** Sidebar Văn phòng số > Danh bạ nội bộ /directory shows 34 rows card grid filter search + Per-action policy Hrm_HoSo wire prod live (Run #239 verified). **State chốt S34:** **34 mig (no change)** · **67 tables** · **~154 endpoints (+1 /api/directory)** · **42 FE pages (+2 Directory × 2 app)** · **64 menu keys (+Off+OffDanhBa)** · **130 test PASS (+10)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (MEMORY 4× curate q3 — Investigator 21.8KB ✅ + Implementer 28KB borderline + Reviewer 25.7KB ✅ + CICD 30.9KB borderline post-spawn entries) · 14 AppRoles · 33 EmployeeProfile prod seeded · 7 V1 contract + V2 ready · bundle rotate 2× S34.)
+
+**Last updated S33 (prev):** 2026-05-26 (Session 33 — **🎯 Plan B G-H1 Hồ sơ Nhân sự FOUNDATION DEPLOYED PROD end-to-end + Plan C B-Wrap BW1-BW7 +9 tests + Drift patch S33 startup**: cumulative **7 commit S33** push remote `5400983..79a8343` + 2 CI Run PASS (#350 Phase 1 3m38s + #237 Phase 2 3m50s). **Plan cha B Phase 10.1 G-H1** end-to-end 7 task: Investigator NamGroup audit 10 bảng → em main Mig 34 schema 4 decision → Implementer Case 2 BE entity 17 file + CQRS 3 file + FE 2 app 12 file cookie-cutter mirror SHA256 IDENTICAL + DbInitializer seed 30 EmployeeProfile + EmployeeCodeSequence + em main Permission menu Hrm+HrmHoSo + Reviewer Smart Friend 6× clean + CICD Run #237 PASS. **Plan cha C B-Wrap** end-to-end 4 step: TestCurrentUser stub + Implementer 3 test file BW1-BW7 (9 [Fact] split) + Reviewer PASS 0 critical + CICD verify Mig 33 prod + EmployeeProfiles 33 seeded + bundle hash rotate × 2 app (`BUTKoqRP→CqGMUMOr` admin + `CMHv2GS4→C_HKyxBe` user). **Plan cha D Drift patch S33 startup** Reviewer SEVERE catch CLAUDE.md+docs+implementer.md 10 line patch cumulative S19→S32 (mig 26→33 + test 81→111 + gotcha 26→52 + audit next 2026-06-01). **Multi-agent ROI S33 ~250K total**: 🟦 Investigator 2 spawn ~20K (S33 startup audit + Plan B Task 1 NamGroup pre-flight) + 🟨 Implementer 4 spawn ~110K (Plan B Task 3 BE entity + Task 4 CQRS + Task 5 FE 2 app + Plan C BW1-BW7) + 🟥 Reviewer 3 spawn ~60K (drift severity + Plan C BW verify + Plan B Phase 2 verify) + 🟩 CICD 3 spawn ~60K (S33 startup health + Run #350 + Run #237). Em main solo Task 2 schema design + Task 3b DbInitializer seed + Task 6 Permission menu + commit/push 7 commit batch. **8 patterns reinforced cumulative S33**: Pattern 12-bis cross-module mirror PE→Hrm 4× + Pattern 16-bis 4-place mirror cross-app 4× + Smart Friend 6× clean (S22+S25+S29×2+S33×2) + gotcha #51 INFRASTRUCTURE seed lesson applied 2× (EmployeeProfile + Hrm menu) + gotcha #50 Layout staticMap mirror applied 1× + Pattern Implementer truncation pattern observation 2×/3 (Task 3+4 truncated mid-MEMORY update, Task 5 clean — mitigation noted commit message). **NEW capability prod end-to-end:** Admin login `admin@solutions.com.vn / Admin@123456` → sidebar Nhân sự → Hồ sơ NS → /employees list 33 row sample `NV/2026/0007 BOD 1 - Director` + CreatePage form Header (UserId picker). **State chốt S33:** **34 mig (+1)** · **67 tables (+7 EmployeeProfile + 5 satellite + Sequence)** · **~153 endpoints (+5)** · **40 FE pages (+2)** · **62 menu keys (+Hrm+HrmHoSo)** · **120 test PASS (+9 BW)** · **52 gotcha unchanged** · 26 memory user-level · 6 skills · 4 sub-agents (MEMORY all >25KB, curate next session priority) · 14 AppRoles · 33 EmployeeProfile prod seeded · 7 V1 contract + V2 ready · bundle rotate 4× cumulative S33 (Phase 1 + Phase 2 push each).)
+
+**Last updated S32 (prev):** 2026-05-26 (Session 32 — **🎯 Phase 10 backlog Plan G NamGroup port DOCUMENTED + Phase 9 stabilize batch DONE**: 10 Plan G-* atomic sprint ~3 tháng T6-T8/2026 (4 quyết định chốt: FULL 11 module + single schema `dbo` mở rộng Mig 34-42 + reuse Workflow V2 enum +5 values + chunk per-module). **Phase 9 stabilize 4 task done sequential anh main "finish hết":** (A2) RAG re-ingest 2949→2988 chunks, gotcha #52 rerank 0.516→0.906 verify; (A3) MEMORY curate 3 agent OVER 25KB: Implementer 38.4→27.5KB + Investigator 27.7→19KB + CICD 27→24.2KB (Patterns 1-19 + 12-bis + 16-bis foundation preserved, 10 verbose archived q2); (B-Wrap) Spec BW1-BW7 ContractWorkflowService ApproveV2Async test bundle DOCUMENTED implementation defer dedicated session ~2h; (C1) Ops status updated: backup-sql.ps1 ready (Task Scheduler register manual cmd), cert api.solutions.com.vn notAfter `2026-07-23` (~2 tháng nữa expire, auto-renew ~2026-06-23), SMTP+rotate creds BLOCKED chờ anh main coordinate. **4 sub-agent reuse-able S33:** Investigator agentId `afaf6d52a6a59a844` / Implementer `ab23cc322b5d495c0` / Reviewer `a0aa13093d14f3bca` / CICD `a505a02d84fc1fabe`. **Phase 10.1 G-H1 Hồ sơ NS handover S33 kick off:** spawn Investigator pre-flight NamGroup TblNhanVien* 8 bảng audit → em main design Mig 34 (1 main + 5 satellite) → Implementer Case 2 scaffold. Stats: 33 mig · 60 tables · ~148 endpoints · **111 test PASS unchanged** · **52 gotcha** · **26 memory user-level (+1 feedback_phase10_namgroup_port)** · 6 skills · 4 sub-agents · 38520 chunks 7 projects RAG live. 4 commits S32 push remote `b832f43..cce0963` all docs-only CI skip per #41.)
+
+**Last updated S31 (prev):** 2026-05-26 (Session 31 — **🎯 RAG v1.3 Baseline PASS (11/11 recall@5=1.000) + retrieval.py critical fix**. **S30 RAG Setup:** Setup RAG Framework v1.3 governance () + evaluator spec + golden set v1.1 (14 queries) + baseline runs v1.0+v1.1 + . Bootstrap 2949 chunks (164 files — fixed Anti #24 projects.json root_path + added  corpus). Commit  docs-only CI skip. **S31 Eval Fix:** Discover  removed  method →  silently returns  (gotcha #52 NEW). Fix: . After fix: **recall@5 = 1.000 (11/11) PASS** (prev tentative 0.364 FAIL). Quality gate  updated: baseline=1.000, avg_rerank=0.847. **Sub-agents S30/S31:** 0 spawns (docs/infra only). **Commits pushed:**  (docs-only S30) — S31 pending. State: **33 mig** · 60 tables · ~148 endpoints · 38 FE pages · **111 test PASS** · **52 gotcha (+1 #52 qdrant-client search() removed)** · **25 memory user-level** · 6 skills · 4 sub-agents · **RAG v1.3 ACTIVE baseline PASS** 2949 chunks · CLI restart required for live MCP vector fix.)
+
+**Last updated S29 FINAL (prev):** 2026-05-22 (Session 29  — **🎯 Plan CA + Plan B Contract V2 wire ALL DEPLOYED PROD**: cumulative **20 commits push 4 CI Runs PASS** (#229 + #230 + #231 + #232). **2 big plans done end-to-end:** Plan CA Move "Cấu hình danh mục dùng chung" admin → eoffice (7 commits + Hotfix 1) + Plan B Contract V2 wire mirror PE Mig 22-26 (9 chunks + Hotfix Reviewer + Hotfix CICD). **Multi-agent ROI explosive S29:** 🟦 Investigator 2 spawn ~40K (Plan CA terrain map + Plan B V1 audit) + 🟨 Implementer Case 2 5 spawn ~82K (Plan CA Chunk B + Plan B A2/C/D + E3 stopped mid-task) + 🟥 **Reviewer 4 spawn ~355K** (Plan CA Hotfix D2 password ≥12 MAJOR catch + Plan B Hotfix ApplicableType=Contract MAJOR catch — Smart Friend pattern 4× cumulative) + 🟩 **CICD Monitor 3 spawn ~90K** (2 fail 529 transient em main fallback manual + Plan B SeedSampleContractWorkflowV2 CRITICAL DemoSeed gate catch — gotcha #51 NEW). **Patterns NEW saved S29:** (1) 9-menu permission terrain map (Investigator) (2) V1+V2 coexist boundary (Investigator) (3) reference template paths cross-module mirror PE→Contract (Investigator) (4) Pattern 12-bis cross-module entity cookie-cutter mirror (Implementer) (5) Pattern 16-bis 4-place mirror cross-app reinforced 2× (Implementer) (6) Cross-module security validation mirror Cat 3 (Reviewer) (7) INFRASTRUCTURE vs DEMO seed classification gotcha #51 (CICD) (8) Race condition em main + Implementer parallel BE → stash workaround OR sequential preferred (Implementer). **3 hotfix cumulative:** Plan CA HF1 resolvePath staticMap + Plan CA D2 password ≥12 chars + Plan B Reviewer ApplicableType=Contract + Plan B CICD SeedSampleContractWorkflowV2 ungate. **NEW capability prod:** demo user `catalog.manager@solutions.com.vn / CatalogMgr@2026` (role CatalogManager — full CRUD 9 menu Master+Catalogs) + Drafter có thể create V2 contract qua Workspace dropdown `QT-HD-V2-001` sample workflow. **MCP RAG tools added cho 4 agent definitions** (commit `b51fc94`) — anh restart CLI để hot-reload. State chốt: **33 mig (+2 Mig 32+33)** · **60 tables (+1 ContractLevelOpinions)** · **~148 endpoints (+1 V2 contract create)** · **38 FE pages (+3: 4 master moved + WorkflowMatrixView counted unchanged S24)** · **111 test PASS unchanged** (UAT mode skip per chunk + cookie-cutter mirror) · **51 gotcha (+1 #51 INFRASTRUCTURE vs DEMO seed)** · **25 memory user-level unchanged** · 6 skills · 4 sub-agents (MCP RAG added pending CLI restart) · **14 AppRoles (+1 CatalogManager)** · **34 active prod users (+1 catalog.manager)** · **7 V1 contracts pinned coexist V2** · Bundle hash 4× rotate cumulative S29 (fe-admin: `BvcWrq2z→leEMWFLU→BBADl46y` + fe-user: `Bg2FNeIz→DVBLmZlt→Dgn1iU9E→DA_VI3zO`).)
+
+**Last updated S29 prev wrap1:** 2026-05-22 (Session 29 — **🎯 Plan CA wire DONE + Hotfix 1 deploy**: 6 commits + 1 hotfix push `3cb54e0..e55d96b` cumulative. Move "Cấu hình danh mục dùng chung" (9 menu: Master + Suppliers + Projects + Departments + Catalogs + 4 sub-catalogs) từ fe-admin → fe-user/eoffice + add role mới `CatalogManager` + demo user `catalog.manager@solutions.com.vn`. **Chunks:** A 80d39a0 BE Role + Seed (em main, 64 LOC) · B 06a441c FE move 4 master pages 948 LOC (Implementer Case 2 cookie-cutter mirror byte-identical SHA256 4 file) · C c995f42 Sidebar filter 2 app (em main, 14 LOC) · D 4a592cf Seed demo user (em main, 7 LOC) · D2 68bcedd Hotfix password ≥12 chars S22+2 policy (em main, Reviewer pre-push CATCH critical) · HF1 e55d96b Add 7 entries `resolvePath` staticMap fe-user (em main, anh UAT screenshot CATCH silent sidebar drop). **2 CI runs PASS:** Run #229 sha=68bcedd 3m32s + Run #230 sha=e55d96b 3m24s. Bundle hash 2× rotate: fe-admin `BvcWrq2z→leEMWFLU`, fe-user `Bg2FNeIz→DVBLmZlt→Dgn1iU9E`. **Multi-agent ROI Plan CA:** 🟦 Investigator 1 spawn ~15K (terrain map 9 menu + GOTCHA tree-inherit) + 🟨 Implementer Case 2 1 spawn ~10K (byte-identical mirror 4 page) + 🟥 Reviewer 2 spawn ~165K (CRITICAL catch password policy) + 🟩 CICD Monitor 2 spawn fail 529 transient (em main fallback manual smoke) + 👤 Chủ trì Solo Chunk A/C/D/D2/HF1 ~100K. **NEW gotcha #50** "Page move cross-app — `Layout.tsx` `resolvePath` staticMap missed mirror → silent sidebar drop" + Pattern reusable cross-project: **4-place mirror checklist** khi Implementer Case 2 cookie-cutter copy page (page + Routes + menuKeys.ts + Layout.tsx staticMap — Implementer Chunk B missed point 4). Implementer MEMORY Pattern 16-bis NEW. **State chốt S29 Plan CA:** 31 mig (no schema change) · 59 tables · ~146 endpoints · **36 FE pages (+4: fe-user master/{Suppliers,Projects,Departments,Catalogs}Page)** · **111 test pass unchanged** (UAT skip per chunk + cookie-cutter mirror) · **50 gotcha (+1 #50)** · 25 memory user-level · 6 skills · 4 sub-agents · **13 AppRoles (+1 CatalogManager)** · **34 active prod users (+1 catalog.manager@solutions.com.vn)**. Catalog manager login `CatalogMgr@2026` (15 chars policy compliant). 7 commits remote `3cb54e0..e55d96b`.)
+
+**Last updated S28 prev:** 2026-05-22 (Session 28 **FINAL wrap** — **🎯 S28 cumulative 12+ bước (t1→t6): Startup 9-step + RAG ROI verdict + bro correction mistake + scope-down + Layer A governance apply + 4 sub-agent flush MEMORY**. Bro broadcast **Layer A governance active 2026-05-22** (3-Layer distributed: A project-local active / B shared_global defer / C infrastructure anh pqhuy). **Quên rule cũ "mọi tương tác PHẢI store_memory" — ABANDONED.** Em main SOLUTION_ERP apply Layer A scope local: **4-category default** (decision/lesson/pattern-proven-≥2×/session-wrap) + **skip list nguyên** + 5 SOLUTION_ERP-specific adjustment cho Phase 9 UAT mode + **tag schema mandatory** `[type, phase, bc-or-module]` với type closed enum 6 (decision/lesson/pattern/gotcha/bug-fix/session-wrap) + phase enum 11 (phase-0 → phase-10+, current **phase-9 UAT ACTIVE**) + BC/module enum 8 domain (contract/pe/budget/master/identity/forms/workflow/notifications) + 5 cross-cutting (tests/infra/cicd/multi-agent/governance/docs) + optional prefix 8 (tech/agent/risk/severity/commit/mig/gotcha/plan). **source_path convention** `solution_erp/<area>/<topic>-<date>`. **Eval ritual** weekly Friday 5 metric từ 2026-05-29 → end-trial 2026-06-05. **10 golden query draft** ready. **6 chunk stored S28 t2-t6:** Protocol cross-project (deprecated S28 t4 scope-down) · Conversation log S28 t1+t2 · Commit pattern acknowledge · 2-week monitoring 5 measure · Scope-down acknowledge · Layer A policy apply. **4 sub-agent flush MEMORY DONE post-S27 model:inherit fix** — registry hot-reload verified all 4 (Investigator agentId `a2462`/`aeda4`, Implementer `a2a2f`, Reviewer `a9e94`, CICD Monitor `a8098`). Each Recent activity entry S28 t1 → S28 wrap góc nhìn từng con preserved cumulative S1-S27. **NEW memory user-level `feedback_interaction_logging_rag.md` SCOPE-DOWN S28 t4** (anti-pattern over-reach self-authorize cross-project rule + implicit consent risk lesson). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **25 memory user-level (+1 NEW interaction logging scope-down)** · 6 skills · 4 sub-agents (all verified hot-reload) · **3,462 RAG chunks SOLUTION_ERP** (+6 chunk store S28) + 6 MCP tools active. **Hit rate verify 3 query**: Plan B Contract V2 rerank 0.84 ✓ + gotcha #48 rerank 0.84/0.82/0.82 ✓ + per-NV 10-surface checklist hit (token overflow) ✓ — > 0.7 threshold pass cumulative. **0 commit remote S28** (all docs + memory + RAG store — anh chốt push thủ công sau approve). Plan B Contract V2 wire kick-off pending 2026-05-22+ (8-chunk pre-allocated 🟦 Investigator pre-flight + 🟨 Implementer Case 2 ×4 + 👤 Chủ trì Solo Service ApproveV2Async + 🟥 Reviewer pre-commit + 🟩 CICD Monitor post-deploy).)
+
+**Last updated S28 t1 initial:** 2026-05-22 (Session 28 turn 1 — **🎯 S28 startup 9-step + RAG ROI reality check em main verdict + cross-agent perspective update**. Anh restart Claude Code CLI sau S27 wrap → sub-agent registry **hot-reload OK** verified qua smoke test spawn Investigator (agentId `a2462ca503ed38b0b`, 16.3 KB MEMORY loaded, 3 skills attached: contract-workflow + permission-matrix + ef-core-migration). RAG status: **3,460 chunks SOLUTION_ERP indexed** (cao hơn S26 wrap 2,628 — re-index ngầm) + 6 MCP tools (`mcp__rag-unified__*`) loaded, Qdrant NSSM Service Running PID 4476. **Bro hỏi "cảm nhận rõ lợi ích RAG ko?"** → em main verdict thẳng thắn (anti-suger-coat): **CÓ LỢI marginal short-term (5-10% time saving), TRANSFORM long-term cross-project (chưa khai phá vì 4 em main project khác chưa bootstrap).** 4 case verdict: solo project blanket đủ ⚠️ Marginal | cross-session retrieve specific ✅ Tốt (rerank 0.84 vs 10 phút find) | cross-project 5 dự án 🚀 **TRANSFORM** (chưa dùng được) | heavy refactor Plan B-class ✅ Tốt. **3 nhược điểm cảm nhận thật:** (1) Bootstrap lag — S27 NEW content (`feedback_subagent_setup_pitfalls + skill-audit-late + 4 MEMORY post-curate + rag-onboarding-guide`) chưa index sau 1 ngày, query "subagent setup pitfalls" return **0 hits** (re-bootstrap pending pydantic fix); (2) Effective coverage gap — Plan B query rerank 0.84 excellent vs S27 content 0 hit miss; (3) Token cost rerank-2.5 ~$0.05/1K query (0.24% free tier Voyage). **Bottom line:** RAG đáng giữ cho infrastructure đã đầu tư S26-S27 (60.9s bootstrap + NSSM Service auto-start + Custom Dashboard 7 panel), **nhưng nếu redo từ đầu** sẽ recommend bro đợi bootstrap 5 dự án rồi mới claim "RAG transform" — solo project chỉ saving marginal. **Pattern reusable cross-project — RAG ROI evaluation framework:** 1 dev solo + 1 project < 1M tokens → ❌ Skip RAG | > 1M tokens → ⚠️ Marginal (5-10%) | N project > 5M tokens → ✅ Worth (cross-project transform) | N dev team enterprise → ✅ Mandatory. Avoid over-hype RAG cho solo 1 project. **Update multi-layer 6 file:** memory user-level `feedback_rag_hybrid_pattern.md` append §S28 t1 ROI reality check (~120 LOC NEW section) + 4 agent MEMORY Recent activity entry góc nhìn từng con (🟦 Investigator: pre-flight audit cross-session retrieve Plan B-class · 🟨 Implementer: Pattern proven retrieve cumulative 19 Pattern foundation · 🟥 Reviewer: gotcha historical context cross-ref #44+#48+#49 · 🟩 CICD Monitor: Run history cross-reference #186-#222 cumulative + 10-surface-point per-NV checklist promoted foundation) + STATUS.md + HANDOFF.md headers. **Bro sẽ cross-check** 4 agent consistency (next test: spawn 4 agent với same prompt verify alignment). Stats unchanged: 31 mig · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass** · 49 gotcha · **24 memory user-level (no new entry, only append §S28 t1)** · 6 skills · 4 sub-agents (registry hot-reload verified post-S27 fix) · 3,460 RAG chunks + 6 MCP tools active. **0 commit remote S28 t1** (all docs + memory update + retrospective opinion - anh chốt push thủ công sau approve).)
+
+**Last updated S27:** 2026-05-22 (Session 27 chốt cuối — **🎯 Memory Curate + RAG Manual Control + Multi-agent Setup Pitfalls Fix**. **Trigger:** Anh share VIPIX `docs/guides/multi-agent-pitfalls.md` → em audit SOLUTION_ERP setup phát hiện CHÍNH XÁC CÙNG PATTERN broken: 4 file `.claude/agents/*.md` dùng `model: claude-opus-4-7` (200K silent fallback) + non-standard `effort: max` field → registry chưa load cả session S27. **Fix applied:** 4 file → `model: inherit` + remove `effort: max`. **Pending:** Anh restart Claude Code CLI để hot-reload. **Memory user-level NEW:** `feedback_subagent_setup_pitfalls.md` 235 lines cross-project pitfall checklist. **Plan A.3 RAG Manual Control + Option 4b NSSM Service:** 7 PS scripts + 6 `$PROFILE` aliases + Startup folder shortcut + Custom Dashboard HTML 7 panels. NSSM Windows Service Qdrant Running PID 4476 RAM 101.8 MB. **Plan A.4 RAG Onboarding Guide:** 42.5 KB / 682 lines / 14 sections + §A2 + §A3. **Plan F1 Qdrant Web UI fix:** Download dist-qdrant.zip 6.59 MB → HTTP 200 "UI | Qdrant". **Memory Curate 4 MEMORY -60%** (180.6→72.0 KB, archive 115 KB preserved §6.5). **Audit drift §6.4+§9.4 sớm** (trigger +8 gotcha): 5 file patched + log `docs/changelog/skill-audit-2026-05-late.md`. **0 commit remote S27** (all local).)
+
+**Last updated S26 FINAL:** 2026-05-21 (Session 26 **FINAL wrap** — **🎯 Anh chốt 2 decisions architectural quan trọng cuối session sau khi đã commit `bf93abd`**: (1) **Approach B distributed RAG bootstrap** — em main SOLUTION_ERP chỉ build INFRASTRUCTURE + DOCS, KHÔNG bootstrap data cho 4 dự án khác (NamGroup/DH Y Dược/Ashico/Vipix). 4 em main project khác tự bootstrap khi anh mở session project đó (Cognition "writes single-threaded" boundary). (2) **Option 4a manual PowerShell scripts** thay Phase 6b Task Scheduler auto-start — anh OWN control + visibility tốt hơn qua `rag-start`/`rag-stop`/`rag-status`/`rag-dashboard` aliases + Qdrant dashboard built-in (`http://localhost:6333/dashboard`) FREE. **+1 memory user-level NEW** `feedback_rag_distributed_ownership.md` (~200 chunks added vào RAG sau khi fix bootstrap.py glob extra_corpus bug — `import glob` recursive thay vì Path manual parsing). **RAG corpus final S26:** 127 files → **2,628 chunks** (+207 chunks user-level memory entries 23 file) → ~535K Voyage tokens (0.27% free tier 200M/month). Cache SHA256 hit working PERFECT: re-bootstrap force-reindex 2nd time chỉ 6.5s (vs 60.9s initial — 10× speedup). **Rerank verify**: 5/6 query S26 content hit rerank 0.498-0.926 (Approach B distributed pattern + Option 4a manual scripts + em main project X build infra docs). Query failed "PowerShell aliases rag-start" expected — Phase 6 scripts chưa code thực tế (defer S27+). **Pending S27+ updated:** Phase 5 SKIP cho em (distributed) · Phase 6 = Option 4a scripts (em viết 4 PS1 script + add `$PROFILE` aliases) · Phase 7 = xuất `rag-onboarding-guide.md` 13 section (11 cũ + §12 monitoring + §13 distributed Approach B). **Memory user-level: 24 entries** (+1 NEW `feedback_rag_distributed_ownership.md`).)
+
+**Last updated S26 initial wrap:** 2026-05-21 (Session 26 chốt cuối lần đầu — **🎯 S26 cumulative wrap: 6 plan PE List tree view UI iteration + Plan AI RAG global MCP infrastructure setup**. **Plan AG/AG2/AG3/AG4/AG5/AG6** cumulative 6 commits Plan AG series `0bf6c7e..d99069a` push remote — UAT feedback bro Tra Sol 2026-05-21 screenshot "UI Duyệt NCC như đám rừng" → folder tree giống Outlook: **Plan AG** Phase 1 PE List tree view 2-level Project > Gói thầu > PE (Investigator audit 5Q + Implementer Case 2 cookie-cutter mirror 2 app + Reviewer pre-commit PASS 0 blocker + CICD Monitor Run #222 PASS bundle hash rotate). **Plan AG2** simplify 1-level (drop tầng gói thầu) + Panel 1 widen 340→400px. **Plan AG3** drop single-PE flat branch, consistent UI (mọi dự án dù 1/N phiếu đều render `<details>`). **Plan AG4** bổ sung Người tạo + Phòng ban tạo PE card — BE DTO `PurchaseEvaluationListItemDto` +4 fields (DrafterUserId/DrafterName/DepartmentId/DepartmentName) + 3 projection JOIN Users+Departments LEFT (ListHandler/InboxHandler/ApprovedHandler) + FE `PeListItem` type +4 fields + UI card render 👤 Drafter · Phòng ban. **Plan AG5** extend tree 3-level Project > Năm > NCC > PE (selectedSupplierName fallback "(Chưa chọn NCC)" cho PE chưa DaDuyet). **Plan AG6** compact card 3-row gọn đẹp (drop Type label redundant + combine mã phiếu/time + Drafter/Dept/HĐ inline). **Plan AI RAG global MCP setup** (User-level Approach A — 1 dev 5 dự án cùng máy localhost) — Phase 0 pre-flight + Phase 1 Qdrant v1.18.0 Windows native binary (KHÔNG Docker, PID 67240 port 6333) + Phase 2 FastMCP server ~1100 LOC Python 9 file (server.py + lib/embed.py voyage wrapper + lib/retrieval.py 3-layer pipeline + lib/projects.py auto-detect cwd + lib/chunking.py contextual prepend + lib/watcher.py) + Phase 3 register MCP user-level (`claude mcp add` với `--` separator trick) + Phase 4 bootstrap SOLUTION_ERP 126 files → **2,392 chunks indexed 60.9s** (~484K Voyage tokens = 0.24% free tier 200M/month). 4 test queries verified end-to-end recall: "gotcha #45 PE button TraLai" 0.641 / "admin opt-in per-NV" 0.836 / "EF migration backfill" 0.766 / "multi-agent setup" 0.879. Stack: Voyage-4-large embedding + Voyage rerank-2.5 + Qdrant Windows native + SQLite FTS5 BM25 + Reciprocal Rank Fusion + Anthropic Contextual Retrieval prepend + FastMCP 3.3.1 stdio. **+1 file MD onboarding `docs/guides/multi-agent-setup-guide.md`** xuất cho 4 dự án future (NamGroup/DH Y Dược/Ashico/Vipix detected từ Claude Desktop config epitaxy folder permission). Multi-agent execution S26: 🟦 Investigator 2 spawn (Plan AG audit 5Q ~30K + Plan AI RAG distribution research ~40K — 4 study cases Cursor/Cline/Continue/Sourcegraph) + 🟨 Implementer 1 spawn (Plan AG Case 2 cookie-cutter ~16K) + 🟥 Reviewer 1 spawn (Plan AG pre-commit ~25K PASS 0 blocker) + 🟩 CICD Monitor 1 spawn (Run #222 verify ~12K). Em main solo Plan AG2-AG6 + Plan AI Phase 0-4 (UI polish iteration + RAG infra setup — cost ROI thấp nếu spawn 5×). Stats final S26 chốt: **31 mig (no schema)** · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after) · 49 gotcha unchanged · 23 memory user-level unchanged · 6 skills · 4 sub-agents · **+1 docs file `multi-agent-setup-guide.md`** + **+1 RAG infrastructure** `D:\.claude-rag\` (server + lib + qdrant-bin + data). Patterns reusable cross-project (3 NEW S26): (1) HTML native `<details>/<summary>` + Tailwind named groups `group/proj` + localStorage Set<string> cho hierarchical tree UI when no Accordion lib available (Pattern 19 Implementer NEW), (2) RAG User-level Global MCP 1 server localhost serve N project (Approach A Plan AI), (3) Qdrant Windows native binary deployment (no Docker overhead — appropriate cho 1 dev solo scenario, không scale enterprise). **Memory FLAG**: cicd-monitor MEMORY ~74KB (+2KB từ S25), critical curate session URGENT next.)
+
+**Last updated S25:** 2026-05-19 (Session 25 chốt cuối — **🎯 S25 cumulative wrap: 7 plan + 7 commits Plan AB→AF + 7 CICD Runs (#215 FAIL → #216-#221 PASS)**. Push remote `e23f51c..506cada`. Bro UAT 2026-05-19 phát hiện 2 bug visibility critical PE/2026/A/032 + 4 follow-up polish UAT iteration: **Bug 1 Budget Adjust** không show "Lịch sử thay đổi" (BE log Header+Update OK nhưng FE filter strict TraLai-only loại) — **Bug 2 Return Mode 4 mode** không log Changelog (ApplyReturnModeAsync miss `db.PurchaseEvaluationChangelogs.Add()`) — **Bug 3 Lịch sử duyệt** missing Trả lại + Vượt cấp entries (Reject branch không add Approval row) — **Bug 4 dual-phase badges** gây nhầm "Đã gửi duyệt → Đã gửi duyệt" cho 3 mode Reject giữ Phase=ChoDuyet — **Bug 5 Changelog UserName** show "Hệ thống" thay vì user thật (9 sites BE miss UserName) — **Bug 6 historical name resolve** entries pre-deploy vẫn show empty (forward-only fix). **Plan AB Chunk A** (`cdfd542`) BE log return mode + FE filter relax × 2 app. **Plan AB Chunk A2** (`8c05947`) fix Plan M tests SQLite frozen-clock tie-break (gotcha #48 NEW — Run #215 caught + Run #216 PASS). **Plan AC** (`a734bf2`) BE Reject add Approval row + skipToFinal comment + FE Decision badge × 2 app. **Plan AC2** (`25837b6`) FE merge synthetic Reject rows từ Changelog historical (Option 2A bro chốt, reversible no-DB-touch). **Plan AD** (`0aaf2df`) Drop misleading dual-phase badges + parse next-target hint via regex `Chuyển phase X → Y` + comment keyword Trả lại/Vượt cấp (gotcha #49 NEW). **Plan AE** (`9ea62be`) BE preventive batch fix UserName 9 Changelog.Add sites (Budget Adjust + 8 sites: Create + Update + Detail CRUD + Quote CRUD + Select Winner). **Plan AF** (`506cada`) FE userMap fallback từ embedded domain data PeDetailBundle (drafter + approvals + approvalFlow + levelOpinions + departmentOpinions) — no extra API fetch admin permission. Multi-agent execution: 🟦 **Investigator** 1 spawn Plan AB Bug 1+2 audit ~28K + 🟨 **Implementer** 1 spawn Plan AB Chunk A ~12K Case 1 + 🟥 **Reviewer** 1 spawn Plan AB pre-commit ~22K PASS 0 blocker (1 minor non-block) + 🟩 **CICD Monitor** 7 spawns Run #215-#221 verify ALL PASS post-Plan AB Chunk A2 fix. **Em main solo từ Plan AC đến AF** (5 plan, cross-stack reasoning + UAT iteration borderline, Implementer/Reviewer KHÔNG re-spawn). Stats final S25 chốt: **31 mig (no schema)** · 59 tables · ~146 endpoints · 35 FE pages · **111 test pass unchanged** (UAT defer test-after per §7) · **49 gotcha (+2 #48 SQLite tie-break + #49 dual-phase UI confusion)** · **23 memory user-level (+2 NEW: `feedback_fe_merge_synthetic_audit` Plan AC2 + `feedback_fe_usermap_fallback` Plan AF)** · 6 skills · 4 sub-agents active. Bundle hash 6× rotate × 2 app (#216-#221), Mig 31 unchanged toàn S25. Patterns reusable cross-project (8 NEW S25): (1) Multi-Changelog.Add SQLite tie-break test discriminator, (2) CICD catch UAT skip test risk for BE refactor > 100 LOC, (3) Test fix Option A over BE refactor preservation, (4) Capture pre-call mutation state cho audit row from-position, (5) FE merge synthetic rows từ Changelog reversible recovery, (6) Drop misleading dual-phase badges + parse semantic hint, (7) Changelog UserName preventive systemic batch fix, (8) FE userMap fallback từ embedded domain data no extra API. **Memory CRITICAL FLAG**: cicd-monitor MEMORY ~72KB strongly over 50KB hard threshold — DEDICATED CURATION SESSION REQUIRED next (archive Run #186-#210 + S22-S24 verbose). Bro UAT verify ALL Plan AB→AF live deploy cumulative.)
+
+**Last updated S23 t12:** 2026-05-15 (Session 23 turn 12 chốt cuối — **🎯 S23 cumulative wrap: 11 plan + 32 commits cumulative**. Plan K (Mig 31 F2 refactor 9 commits) → L (UAT bug 5) → M (F1 edge case 4) → N (per-NV lookup 1 site 2) → O (4 sites cascade 2) → P (Controller body record 1) → Q (FE banner CSS 1) → R (cleanup phiếu/workflow 1) → S (wipe ALL workflows 1) → T (DemoSeed flag 2) → U (sidebar truncate 1). 4 sub-agents active throughout: 🟦 Investigator 5 spawn (K0 + N + P FE wire + R audit + L2 spawn) + 🟨 Implementer 5 spawn (K1/K3/K5/K7 + M2 + M3 Case 2/3) + 🟥 Reviewer 2 spawn (K2 pre-commit + M3 cumulative review) + 🟩 CICD Monitor 5 spawn (Run #195 K10 + #199 L + #200 M + #201 N + #202 O + #203 P + #204 Q + #207 T + #208 T5+T6 + #209 U — ALL PASS). **Memory user-level update cumulative S23:** `feedback_per_nv_permission_scope.md` reinforced 5 sections (S22+5 + S23 t1 + t3 + t4 + t5 + t6) → wire 10 surface points (point 9 lookup discrimination + point 10 Controller body record mirror). `feedback_uat_skip_verify.md` Plan L lesson Service refactor semantic test atomic. **+1 memory NEW** `feedback_demo_seed_flag_disable.md` cross-project Plan T pattern. **3 destructive cleanup cumulative Plan R+S+T5** ~720 rows wiped + DbInitializer permanent disable demo seed. **Stats final S23 chốt cuối:** 31 mig · 59 tables · ~145 endpoints · 34 FE pages · **111 test unchanged** · 47 gotcha · **21 memory entries** (+1 NEW Plan T flag pattern) · 6 skills · 4 sub-agents active · **0 PE + 0 demo workflow + DemoSeed flag persist** UAT permanent clean slate. Backup rollback: `vietreport-vps:C:\Backup\SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB. **32 commits S23** pushed remote `eb106f2..86d8806`. CI verify ALL PASS. Bro Designer setup workflow mới from scratch, KHÔNG còn auto re-seed contaminate. Plan B Contract V2 wire HIGH priority next.)
+**Last updated S23 t10:** 2026-05-15 (Session 23 turn 10 — **🔧 Plan T: Disable auto re-seed demo data + final DELETE — UAT permanent clean slate**. Bro phát hiện sau Plan R+S: 4 phiếu `[DEMO]-A/B` + 2 V1 workflows + 1 V2 mẫu UAT TỰ ĐỘNG RE-SEED sau khi BE deploy commits Plan P+Q+R+S → IIS recycle → `DbInitializer.InitializeAsync` chạy lại 5 demo seed methods. Bro AskUserQuestion chốt Option A: disable demo seed vĩnh viễn qua flag config. Em main implement: `appsettings.json` add `"DemoSeed": { "Disabled": true }` + `appsettings.Development.json` override `false` cho dev test seed local + `DbInitializer.cs` add `using Microsoft.Extensions.Configuration` + `var demoSeedDisabled = config.GetValue<bool>("DemoSeed:Disabled")` + wrap 5 method conditional `if (!demoSeedDisabled)` (SeedWorkflowDefinitions V1 + SeedPurchaseEvaluationWorkflows V1 + SeedDemoContracts + SeedDemoPurchaseEvaluations + SeedSampleApprovalWorkflowsV2). KEEP: SeedRoles + SeedAdmin + SeedDepartments + SeedDemoUsers (30 UAT users) + SeedMenuTree + SeedAdminPermissions + SeedDemoMasterData (Supplier/Project) + SeedContractTemplates + SeedCatalogs + Backfill helpers. Note: `appsettings.Production.json` bị `.gitignore` (secrets), em set flag mặc định trong `appsettings.json` commit qua git — production inherit `true`. Run #207 sha=0b97840 PASS 3min24s → IIS deploy applied flag. T5 final DELETE: SCP `scripts/plan-t5-final-cleanup.sql` upload + sqlcmd -i 3 TRANSACTION DELETE → 4 PE + 1 V2 + 2 V1 = 7 rows + cascade child. T6 verify NO re-seed loop: `Restart-WebAppPool SolutionErp-Api` force IIS recycle → BE startup → wait healthy → sqlcmd verify: **PE=0 + V2=0 + V1=0** preserved (KHÔNG re-seed) + Users=33 + Suppliers=19 + Projects=9 + Contracts=7 (existing preserved). DemoSeed flag PROVEN active end-to-end. Total cumulative Plan R+S+T cleanup: ~677 rows wiped + DbInitializer re-seed disable vĩnh viễn. Stats final S23 t10: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test unchanged** · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow + flag disable demo seed** — UAT permanent clean slate. Bro Designer setup workflow mới from scratch, KHÔNG còn auto re-seed contaminate.)
+**Last updated S23 t9:** 2026-05-15 (Session 23 turn 9 — **🧹 Plan S: Wipe ALL workflows — UAT clean slate hoàn toàn**. Bro chốt sau Plan R: "các cái demo quy trình cũ -> xóa hết luôn đi nhé". 4 workflows còn lại (2 V2 ghim + 2 V1 active) đều seed demo cumulative (`(mẫu UAT)` / `(clone)(clone)` / `(v01)` sample seed). Bro AskUserQuestion chốt Option A (Recommended): wipe ALL 4 workflows, UAT clean slate. Em main solo execute (Investigator audit Plan R đã cover scope precedent, Plan S = continuation cùng UAT cleanup phase). Backup rollback: Plan R backup `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB vẫn capture full state pre-cleanup → reuse cho rollback. Script `scripts/plan-s-wipe-all-workflows.sql` 2 BEGIN/COMMIT TRANSACTION + SET QUOTED_IDENTIFIER ON. Execute via scp + sqlcmd -i: DELETE ALL ApprovalWorkflows (2 rows cascade Steps+Levels) + DELETE ALL PurchaseEvaluationWorkflowDefinitions (2 rows cascade Steps+Approvers). Post-state: **0 V2 + 0 V1 + 0 Steps + 0 Levels + 0 Approvers** (ALL workflow entities wiped). BE smoke verify 5/5 endpoints 200 (auth + PE list + V2 workflows + V1 workflows + users + menus) — KHÔNG crash startup (no Contract pin to V1 — chỉ PE dùng workflow, PE đã wipe Plan R). Hậu quả expected: user KHÔNG tạo được phiếu mới (Workspace Select empty) cho đến khi admin Designer seed workflow mới from scratch — UAT mode chấp nhận. Total cleanup cumulative Plan R + S: 35 PE + 17 V2 + 4 V1 + ~600 cascade child = **~670 rows wiped**, prod database UAT clean slate hoàn toàn. Stats final S23 t9: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · 111 test · 47 gotcha · 20 memory · 6 skills · **0 PE + 0 workflow** (database state mới hoàn toàn). Pending: admin Designer seed workflow mới + bro UAT test fresh.)
+**Last updated S23 t8:** 2026-05-15 (Session 23 turn 8 — **🧹 Plan R: Cleanup destructive prod database — phiếu test + workflow ko ghim**. Bro UAT confirm Plan P+Q wire OK + chỉ thị "OK Tao thấy tạm ổn rồi đấy, mày xóa hết các phiếu test cũ đi nhé, các quy trình cũ ko ghim cũng xóa hết đi. Cho gọn đẹp." 🟦 Investigator pre-flight audit prod ~64K spawn confirm scope: 28 PE active + 7 soft-deleted + 15 V2 workflows IsUserSelectable=false + 2 V1 workflows IsActive=false. FK Restrict gotcha: PE.ApprovalWorkflowId Restrict → phải hard-DELETE PE trước (soft-delete KHÔNG release FK). Entity extend `BaseEntity` (workflow) KHÔNG hỗ trợ soft-delete. Bro chốt Option A (Recommended) qua AskUserQuestion. Em main execute 6 steps qua sqlcmd ssh vietreport-vps: (1) BACKUP `SolutionErp_pre_cleanup_2026-05-15.bak` 18.5MB qua `scripts/plan-r-backup.sql` upload scp + sqlcmd -i (workaround SQL Express no COMPRESSION + no RESTORE VERIFYONLY permission cho vrapp). (2) Script `scripts/plan-r-cleanup.sql` 3 BEGIN/COMMIT TRANSACTION + SET QUOTED_IDENTIFIER ON (filtered index Mig 29+ require). (3) DELETE 35 PE rows (28 active + 7 soft-deleted, cascade ~446 child: 42 Details + 49 Suppliers + 64 Approvals + 238 Changelogs + 10 Attachments + 43 LevelOpinions). (4) DELETE 15 V2 unghim (cascade ~140 Steps+Levels). (5) DELETE 2 V1 inactive (cascade ~37 Steps+Approvers). Total: **52 rows + ~600 cascade child deleted**. Post-cleanup state: **0 PE · 2 V2 workflows ghim** (`QT-DN-V2-001 v16` + `QT-DN-PA-V2-001 v2`) · **2 V1 workflows active** (`QT-DN-A v3` + `QT-DN-B v1`). Smoke verify BE alive post-cleanup: 3/3 endpoints 200 (auth login + PE list + V2/V1 workflow list) → KHÔNG crash startup (Plan F precedent S22 avoid được — V1 active workflow giữ nguyên). Multi-agent ROI: Investigator catch FK Restrict gotcha + recommend backup mandatory + 3 Option compare — saved em main hard-delete without backup risk. Stats final S23 t8: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · 111 test unchanged · 47 gotcha · 20 memory · 6 skills · **0 PE phiếu test + 4 workflow ghim/active** (gọn đẹp UAT clean slate). Pending: bro UAT test workflow mới fresh.)
+**Last updated S23 t6:** 2026-05-15 (Session 23 turn 6 — **🎯 Plan P: HOTFIX Controller TransitionPeBody record missing 3 fields — bug ROOT CAUSE thực sự của F1+F2 fail**. 1 commit Plan P atomic. CICD Monitor Run #202 verify Plan O CRITICAL caveat catch: `PurchaseEvaluationsController.cs:267` `TransitionPeBody` record CHỈ có 3 fields (TargetPhase, Decision, Comment) — MISSING 3 fields có trong Command record `TransitionPurchaseEvaluationCommand` (ReturnMode + ReturnTargetUserId + SkipToFinal). `mediator.Send` line 70 cũng drop 3 field. → FE × 2 app SEND ĐÚNG 7 fields qua `api.post(/transitions)` body (Investigator verify FE wire OK 100%) → ASP.NET Core deserialization silently DROP 3 fields ở Controller layer → Handler nhận `ReturnMode=null` + `SkipToFinal=false` → fallback default Drafter mode + F2 không trigger. Bug present 2 NGÀY PROD từ Mig 28 deploy 2026-05-13 — gây TẤT CẢ F1+F2 wire fail từ FE side (Plan N + Plan O fix lookup sites nhưng controller bug block flow trước khi đến lookup site). Fix Plan P: Controller body record +3 field default null/false + `mediator.Send` pass 7 fields + add `using SolutionErp.Application.PurchaseEvaluations.Services` cho WorkflowReturnMode enum import. ~10 LOC BE 1 file. dotnet test **111/111 PASS** (+0 từ 108 — không cần test mới vì Investigator confirm scope BE Controller only, FE wire đúng, Mig 28/31 Domain test đã cover handler logic). Multi-agent ROI: 🟦 Investigator audit FE 2 spawn ~58K confirm hypothesis BE-only scope, avoid em main fix sai cross-stack. 🟩 CICD Monitor Run #202 catch caveat critical lúc verify Plan O — invaluable bug catch chain. Pattern reinforced: **Controller body record MUST mirror Command record fields** khi Command thêm optional params — Mig 28 + Mig 31 cumulative thêm 3 fields nhưng Controller body record chưa update → silent drop bug. Stats final S23 t6: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test pass unchanged** · 47 gotcha · 20 memory · 6 skills · 4 sub-agents (Investigator FE wire + CICD Monitor verify spawns). CHƯA push remote — chờ CICD verify cuối.)
+**Last updated S23 t5:** 2026-05-15 (Session 23 turn 5 — **🎯 Plan O: HOTFIX 4 lookup sites cùng pattern per-NV cascade — Plan N point 9 chỉ catch 1/5 sites**. 2 commits Plan O atomic + docs. Bro UAT 2026-05-15 sau Plan N deploy phát hiện tiếp: Actor NV Test (UAT V2) trong OR-of-N slot 4 NV click "Trả lại Người chỉ định" → toast "Không phải lượt bạn" mặc dù NV Test đúng trong slot. Em main audit grep `FirstOrDefault.*Order ==` toàn project — discovered 5 lookup sites total: Plan N catch 1 (GetPe handler), 4 sites khác CÙNG BUG còn nguyên: (1) `Service.cs:201` `EnsureCanRejectV2Async` actor match guard ← Bug bro UAT ROOT CAUSE, (2) `Service.cs:248` `ApplyReturnModeAsync` read Allow flag từ row đầu, (3) `DetailFeatures.cs:72` F3 `EnsureEditableForDetailsAsync` cùng bug, (4) `Features.cs:311` F4 `AdjustBudgetCommand` cùng bug. 👤 Chủ trì Solo fix 4 sites surgical ~30 LOC + add `Guid? actorUserId` param vào `ApplyReturnModeAsync` (4 param signature change) + caller `TransitionAsync:94` update + 3 regression test mới `PurchaseEvaluationPerNvLookupRegressionTests` (Actor non-first-row OR-of-N trả lại / Outsider không slot ForbiddenException / Actor có flag while others don't AllowsMode). dotnet test **111/111 PASS** (+3 từ 108 baseline Plan N). Pattern reinforced: **5 lookup sites checklist** sau Mig 29 OR-of-N — Plan N chỉ catch 1/5. Memory `feedback_per_nv_permission_scope.md` CRITICAL HOTFIX S23 t5 section updated với 5 sites enum + audit grep checklist. Bug 2 (F2 Duyệt thẳng chỉ đến Phan Văn Chương thay vì Nguyễn Văn Trường BOD) defer follow-up — F2 logic line 483-524 đã đúng, cần verify workflow v14 DB structure thực tế. Stats final S23 t5: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **111 test pass (+3)** · 47 gotcha · 20 memory (1 entry CRITICAL HOTFIX section reinforced 2 lần) · 6 skills · 4 sub-agents (em main solo Plan O — bug fix reasoning chain cross 4 sites). CHƯA push remote — chờ CICD verify.)
+**Last updated S23 t4:** 2026-05-15 (Session 23 turn 4 — **🎯 Plan N: HOTFIX per-NV lookup site discrimination — BE bug critical UAT block**. 2 commits N1+N2 batch atomic + N4 docs. Bro UAT screenshot post-Plan M deploy: Admin Designer tick TRUE 7 flag cho NV Test (UAT V2) slot Bước 2 Cấp 1 workflow QT-DN-V2-001 v12/v13 (4 NV cùng Cấp) — actor login → dialog ✓ Duyệt KHÔNG có checkbox F2 skipToFinal + dialog ← Trả lại CHỈ 1 radio Drafter + KHÔNG có F3+F4 Edit options. 🟦 Investigator audit (~80K spawn) verify Hypothesis B: BE bug `PurchaseEvaluationFeatures.cs:765` `FirstOrDefault(l => l.Order == curLevelOrder)` thiếu discriminator `ApproverUserId == currentUser.UserId` — schema Mig 29 (S21 t5) refactor: 1 row per ApproverUserId (OR-of-N cùng Order) → handler luôn lấy row đầu DB (Lê Văn Bính — Drafter only), bỏ qua admin tick per-NV của actor. Bug PRESENT từ Mig 29 deploy 2026-05-13 nhưng chỉ bộc lộ khi lần đầu admin tick selectively per-NV. 👤 Chủ trì Solo fix N1 (5 LOC BE) + N2 regression test (~200 LOC test) + N4 docs — KHÔNG spawn Implementer vì bug fix reasoning chain. Fix: `var curLevel = curStep?.Levels.FirstOrDefault(l => l.Order == curLevelOrder && l.ApproverUserId == currentUser.UserId) ?? curStep?.Levels.FirstOrDefault(l => l.Order == curLevelOrder);` — actor match per-NV slot, admin/non-approver fallback row đầu (giữ behavior view detail). Test regression `GetPurchaseEvaluationCurrentLevelOptionsTests` 2 method: 4 actor distinct flag profile + admin fallback. dotnet test **108/108 PASS** (+2 từ 106). Pattern reinforced: **Per-NV admin opt-in flag** wire checklist phải bao gồm **9 surface points** (KHÔNG 8) — thêm point 9 "Handler lookup site `currentLevelOptions` MUST discriminate ApproverUserId". Cumulative Mig 29 + 30 + 31 đã wire 8 points đúng nhưng MISS point 9 — bug present 2 days production. Stats final S23 t4: **31 mig** · 59 tables · ~145 endpoints · 34 FE pages · **108 test pass (+2)** · 47 gotcha · 20 memory (1 entry reinforced narrative wire checklist 9 points) · 6 skills · 4 sub-agents (1 Investigator spawn). CHƯA push remote — chờ Reviewer/CICD verify.)
+**Last updated S23 t3:** 2026-05-15 (Session 23 turn 3 — **🎯 Plan M: Fix F1.OneLevel/OneStep edge case Bước 1 → giữ ChoDuyet (KHÔNG fallback Drafter) + FE label phase TraLai rename**. 3 commits Plan M `c2042ef..4dd6f9c` chuỗi M1→M3→M2: M1 (`c2042ef`) BE Service `ApplyReturnModeAsync` 2 edge case block (line 287-333) → reset (0, 1) giữ Phase=ChoDuyet thay vì fallback Phase=TraLai (semantic mới per bro chốt AskUserQuestion: "Cho phép nhưng vẫn giữ ChoDuyet, clear pointer thôi") + M3 (`508b17a`) FE × 2 app rename `PurchaseEvaluationPhaseLabel[98]` + `PeDisplayStatusLabel.TraLai` + 2 inline literal trong PeWorkflowPanel F1 dialog "Trả lại" → "Cần chỉnh sửa lại" (phase status badge, KHÔNG đụng action verb "← Trả lại" + mode picker "Trả về Người soạn thảo") + M2 (`4dd6f9c`) Tests add 2 edge case test `OneLevel_AtStep1Level1_ResetsToBuoc1Cap1_KeepsChoDuyet` + `OneStep_AtStep1_ResetsToBuoc1Cap1_KeepsChoDuyet` + helper `SeedWorkflowAsync` extend 2 param optional. Multi-agent execution: 🟦 Investigator audit pre-flight catch fact code main path đã đúng (F1.OneLevel/Assignee + F2 + F3 + F4 main path giữ ChoDuyet) chỉ edge case Bước 1 fallback sai + 🟨 Implementer 2 spawns Case 2+3 (M2 + M3) + 🟥 Reviewer pre-commit pending + 👤 Chủ trì M1+M4. Test final: **106/106 PASS** (+2 từ 104, 58 Domain + 48 Infra) — K7 Approver F2 NO cascade. F1.Drafter mode 4 GIỮ NGUYÊN Phase=TraLai semantic (explicit role mode). Memory user-level update 2 entry: `feedback_per_nv_permission_scope.md` reinforcement S23 t3 "edge case không lùi được KHÔNG fallback role khác" + `feedback_uat_skip_verify.md` Plan L lesson "Service refactor semantic BẮT BUỘC update test cùng commit". Stats final S23 t3: **31 mig** (no change) · 59 tables · **~145 endpoints** (no change) · 34 FE pages · **106 test pass (+2)** · 47 gotcha · 20 memory (2 entry reinforced) · 6 skills · 4 sub-agents. CHƯA push remote — chờ Reviewer verdict.)
+**Last updated S23 t1:** 2026-05-14 (Session 23 turn 1 — **🎯 Plan K: F2 refactor sang per-Approver-slot Mig 31** + UI consistency. 8 commits Plan K `56868bf..<latest>`: Chunk pre-A slot label rename → K1 Mig 31 schema swap (drop `Users.AllowDrafterSkipToFinal` + add `ApprovalWorkflowLevels.AllowApproverSkipToFinal` no BACKFILL) → K2 Service ApproveV2Async Approver F2 branch + DTO refactor → K3 Designer 7th checkbox + banner rewrite → K5 zombie endpoint cleanup + Reviewer Major #1+#2 + Minor #3+#4 → K6 Workspace × 2 app DROP Drafter + ADD Approver toggle → K7 tests regression 104/104 PASS (3 deleted + 3 added cancel) → K8 docs. Multi-agent execution: 🟦 Investigator K0 pre-flight + 🟨 Implementer K1+K3+K5+K7 (4 spawns Case 2+3) + 🟥 Reviewer K2 pre-commit (PASS 0 critical, 2 Major + 2 Minor) + 👤 Chủ trì K0-bis+K2+K6+K8. Bro decision: F2 semantic ĐỔI Drafter from Nháp → Approver during ChoDuyet skip thẳng Cấp cuối (mirror F3+F4 admin opt-in per slot) + setup ALL ở Workflow Designer (KHÔNG ở User Management). UI slot label "#NV {order}" → ApproverFullName. Stats final S23 t1: **31 mig (+1 Mig 31)** · 59 tables · **~145 endpoints (-1 backout /allow-skip-final)** · 34 FE pages · **104 test pass unchanged** (3 deleted + 3 added) · 47 gotcha unchanged · 20 memory (cumulative reinforce `feedback_per_nv_permission_scope` 3×) · 6 skills · **4 sub-agents active 4 spawns (Implementer Case 2+3) + 1 Reviewer**. 4 prod user lose `AllowDrafterSkipToFinal=true` value per Option A (admin re-config qua Designer). Pattern reinforced: per-NV admin opt-in flag 3× proven (Mig 29 F1+F3 + Mig 30 F4 + Mig 31 F2) — pattern ALSO applies cho refactor existing scope, KHÔNG chỉ greenfield. Plan B Contract V2 wire vẫn pending S23 t2+. CHƯA push remote — chờ bro confirm.)
+**S22 chốt cuối:** 2026-05-13 2200 (Session 22 CHỐT — **🎯 Bro chốt sub-agent solution OK**. 11 commits S22 pushed remote `3d725c4..b04a11a`. CICD Monitor Run #188 PASS verified. Highlights: Plan D F2 toggle + Plan C +20 test (test catch-up backlog) + Plan E strict V2 scope + Plan F ABORTED pre-flight (defer sau Plan B) + S22+1 fix disable 3 button bug + S22+2 seed 20 test user role-based naming + S22+3 rename users `{dept}.{level}@solutions.com.vn` + S22+4 attachment view inline PDF + Section "Điều chỉnh ngân sách" + S22+5 Mig 30 `AllowApproverEditBudget` per-NV opt-in (spec fix bro feedback). Stats final S22: **30 mig (+1 Mig 30)** · 59 tables · **~146 endpoints (+3)** · 34 FE pages · **104 test pass (+20: 5 reg #44 + 7 ReturnMode + 7 Guard + 1 V2 actor scope)** · **47 gotcha (+1 #47 paths-ignore agent-memory gap pending bro fix)** · 19 memory · 6 skills · **33 active users prod** (13 cũ + 20 mới role-based) · 4 sub-agents (CICD Monitor Run #188 PASS verify, 3 sub-agents seeds-only em main solo throughout S22). Pattern reinforced: per-NV admin opt-in flag 2× proven (Mig 29 + Mig 30) — anti-pattern default scope expansion. Memory `feedback_per_nv_permission_scope` reinforced S22+5 narrative.)
+**Last updated S22 prev:** 2026-05-13 1800 (Session 22 — Plan C + D + E done, Plan F ABORTED pre-flight fail. 5 commits local `60efeed`→`dbda37e`→`215b1e0`→`f149661`→Docs. Plan D BE+FE Admin User F2 toggle UI (PATCH /users/{id}/allow-skip-final + UsersPage column "Skip cuối" violet badge). Plan C task 4 5 reflection regression test gotcha #44 silent 403 ApprovalWorkflowsV2Controller policy split (catch class-level Policy regression). Plan C task 1-3 14 service test catch-up — ApplyReturnMode 4 mode per-NV Mig 29 + skipToFinal per-Drafter + EnsureEditableForDetails F3 gating. Plan E strict V2 scope List + Detail (remove UAT loose `|| ApprovalWorkflowId != null`, replace with V2 approver actor.UserId scope via ApprovalWorkflowLevels join). Plan F ABORTED — pre-flight prod sqlcmd reveal 23 PE + 7 Contract pin V1 + Contract entity HOÀN TOÀN V1 chưa wire V2 → drop V1 BE crash startup. Defer F sau Plan B Contract V2 + migrate 4 V1-only PE + UAT 2-3 tuần. Stats S22: 29 mig (0) · 59 tables · ~144 endpoints (+1) · 34 FE pages · **103 test pass (+19: 5 reg #44 + 7 ReturnMode + 7 Guard)** · 46 gotcha · 19 memory · 6 skills · 4 sub-agents (em main solo). Pattern reusable: SeedWorkflowAsync + SeedApproversAsync helper test infra + reflection Authorize regression test + pre-flight prod check pattern. CHƯA push remote — chờ bro confirm.)
+**S21 chốt cuối:** 2026-05-13 1530 (Session 21 chốt cuối — 5 turn cumulative pushed remote, CICD verified PASS 2/2 run, 1 gotcha mới #46 Gitea API path, 2 memory entry mới — `feedback_ef_migration_backfill_reorder` + `feedback_per_nv_permission_scope`. Session 21 5 turn timeline: t1 cicd-monitor add → t2 RAG planning Cách A → t3 fix gotcha #45 → t4 F1+F2+F3 Mig 28 → t5 refactor Allow* per-NV Mig 29. Stats final: 29 mig · 59 tables · ~143 endpoints · 34 FE pages · **84 test pass** · **46 gotcha (+2 từ S20: #45 PE button mismatch + #46 Gitea API)** · **19 memory entries (+3 từ S20: RAG + EF backfill + per-NV scope)** · 6 skills · 4 sub-agents (3 seeds-only + 1 cicd-monitor 2 runs PASS). 12 commits pushed `3a34831..c0af9e0`. Plan G Trial Week 1 evidence: CICD Monitor catch 0 fail vì green 2/2 run, cost 110-120K/run under 150K budget, 3-3.5min CI time stable. KHÔNG còn pending push. UAT mode skip dotnet test mỗi chunk, test-after Plan C bundle cho tất cả turn 3-5 sau UAT 2-3 lần ổn.)
+**S21 turn 5:** 2026-05-13 1400 (Session 21 turn 5 — **🎯 Refactor F1+F2+F3 sang PER-NV (Mig 29 drop Mig 28 column workflow-level). 4 chunk per-commit `0366946` (A BE schema+Service refactor) → `63234b2` (B FE Admin Designer 5 checkbox per-Level row) → `5ccb2a7` (C FE eOffice rename currentLevelOptions + drafterAllowSkipToFinal) → this Chunk D Docs. **F1+F3** 5 flag MOVED xuống `ApprovalWorkflowLevels` (per slot Approver, mỗi NV có riêng quyền duyệt). **F2** AllowDrafterSkipToFinal MOVED xuống `Users` (per-Drafter user, admin config ở User Management). Mig 29 4-stage: ADD 5 column Levels + 1 column Users + BACKFILL bulk SQL (copy workflow → all Levels, set TRUE cho Drafter user nào từng dùng workflow Allow) + DROP 6 column workflow `ApprovalWorkflows`. Service `ApplyReturnModeAsync` refactor đọc `currentLevel.AllowXxx` thay vì `workflow.AllowXxx`. Helper `EnsureEditableForDetailsAsync` read `level.AllowApproverEditDetails`. DRAFTER trình branch read `userManager.FindByIdAsync(actorUserId).AllowDrafterSkipToFinal`. DTO refactor: `AwLevelDto +5 Allow*`, `AwDefinitionDto -6 Allow*`, `CreateAwLevelInput +5 Allow*`, `PeDetailBundle.workflowOptions → currentLevelOptions + drafterAllowSkipToFinal`. FE Admin Designer drop section "Cấu hình nâng cao" workflow-level, replace 5 checkbox grid-cols-2 inline mỗi Level entry row (5 flag per slot). FE eOffice rename `wfOptions → levelOptions` đọc `currentLevelOptions`. Backward compat: backfill preserve admin config S21 t4. Test 84/84 PASS unchanged. Stats: **29 mig (+1) · 59 tables · ~143 endpoints · 34 FE pages · 84 test pass · 45 gotcha · 17 memory · 6 skills · 4 sub-agents seeds-only.**)
+**S21 turn 4:** 2026-05-13 1200 (Session 21 turn 4 — **🎯 F1+F2+F3 PE Workflow advanced options (Mig 28) — 5 chunk per-commit `0294693`→`c56024b`→`a508564`→`d27caaf`→this Chunk E Docs. **F1** 4 mode Trả lại admin tick: "1 Cấp / 1 Bước / Người chỉ định / Người soạn thảo" — 3 mode đầu giữ Phase=ChoDuyet lùi pointer (peer review chain), mode Drafter giữ Phase=TraLai S17 fallback. **F2** Drafter skip thẳng Cấp cuối — workflow tick + Workspace checkbox dynamic confirm. **F3** Approver edit Section 2 (Hạng mục/NCC/Báo giá) khi workflow tick + actor match CurrentLevel + audit ghi PurchaseEvaluationChangelog. Mig 28 `ApprovalWorkflows +6 bool Allow*` (DEFAULT 1 cho AllowReturnToDrafter backward compat, 5 còn lại 0). BE Service `TransitionAsync` extend 3 optional param (returnMode/returnTargetUserId/skipToFinal) + helper `ApplyReturnModeAsync` switch 4 mode. Detail/Quote/Supplier helper `EnsureEditableForDetailsAsync` mới (kế thừa `EnsureDraftAsync` + add ChoDuyet+F3 branch + Admin bypass). FE Admin Designer "Cấu hình nâng cao" section 6 checkbox 3 group. FE eOffice 3 changes mirror 2 app: Trả lại radio picker 1-4 mode + Workspace skip checkbox violet + Section 2 itemsReadOnly approver banner. UAT mode skip dotnet test mỗi chunk (per `feedback_uat_skip_verify`), `npm run build` × 2 app pass mỗi chunk. Stats: **28 mig (+1)** · 59 tables · **~143 endpoints (+1 user-selectable patch existed)** · **34 FE pages (+1 Designer section)** · **84 test pass unchanged** (UAT defer test-after) · **45 gotcha unchanged** · 17 memory · 6 skills · 4 sub-agents seeds-only.**)
+**S21 turn 3:** 2026-05-12 2100 (Session 21 turn 3 — **🎯 Bug fix CRITICAL "Trả về nhưng hệ thống vẫn duyệt" PE workflow (gotcha #45). 2 chunk per-commit `de00887` (BE Chunk A) + `4b29d00` (FE Chunk B) + Chunk C Docs this. Root: PeWorkflowPanel.tsx `isReject` payload (L64-66) thiếu nhánh TraLai → button "← Trả lại" gửi `decision: 1` (Approve) thay vì `2` (Reject) khi target=TraLai(98) → BE ApproveV2Async UPSERT opinion "đã duyệt" + advance Cấp. Inconsistency phụ: dialog `isSendBack` (L247-248) cùng pattern thiếu TraLai → dialog title sai. Fix BE defense-in-depth + FE 3 chỗ × 2 app mirror rule §3.9. Test-before §7 BẮT BUỘC: 3 regression test mới (2 reproduce bug + 1 happy path control) — `dotnet test SolutionErp.slnx` 84 PASS (58 Domain + 26 Infra = +3). `npm run build` × 2 app pass. Stats: 27 mig (no change) · 59 tables · ~142 endpoints · 34 FE pages · **84 test pass (+3)** · **45 gotcha (+1 #45)** · 17 memory entries (no new) · 6 skills. Em main solo (no sub-agent spawn S21 t3 — bug fix reasoning chain cross BE/FE Implementer REFUSE per multi-agent rule).**)
+**S21 turn 2:** 2026-05-12 1800 (Session 21 turn 2 — **🎯 RAG Hybrid setup planning + Cách A validation deep dive. 2 commit (`1f8e9af` plan save 1223 LOC + this chốt). Em main solo (no SOLUTION_ERP sub-agent spawn), delegate claude-code-guide × 2 research Anthropic + community practice. Decision chốt: Cách A defensive (giữ blanket 120K em main + RAG retrieve supplement) over Cách B aggressive (cắt 60-70% blanket). Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider all hybrid). Stack: Voyage-3-large + Qdrant local + FastMCP Python + Streamlit dashboard 7 pages + SQLite event log. Multi-agent cost reality: 4 agents → ~520K cumulative blanket → heavy session ~560K (Cách A) vs ~700K (lazy), saving -20%. 3-layer pattern Phase 1-3 rollout (Layer 1 vector → Layer 2 +BM25 → Layer 3 +reranking, recall ~70% → ~92%). Stats: +1 memory entry (`feedback_rag_hybrid_pattern.md`) +1 plan file (`rag-setup-plan.md` 1500 LOC final). 4 sub-agents vẫn seeds-only. Plan I NEW deferred chờ bro confirm 5 dự án path + stack + Voyage API key + disk cleanup 5-8GB.**)
+**S21 turn 1:** 2026-05-12 0030 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier green READ tier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`, CI skipped per path filter (`**/*.md` paths-ignore docs-only). Trade-off: +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động (bundle hash unchanged / mig drift prod / endpoint 500) — recurring blind spot pattern em main solo S20 quên verify ~30% push. Cost reality update: ~750K spawn setup (3 → 4 agents) · ~1.35M heavy session · ~700K optimized cached. Stats: 4 sub-agents seeds-only (+1 cicd-monitor green) · 16 memory entries (no new, update existing `feedback_multi_agent_setup.md` 3 → 4 agents narrative) · 27 mig · 59 tables · ~142 endpoints · 81 test unchanged · 44 gotcha unchanged · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work S21 t1 nên KHÔNG có findings — em main solo via context + Write file).**)
+**S20 wrap:** 2026-05-11 22:00 (Session 20 wrap turns 1-12 — **🎯 14 commit `9dee00d` → `ae1814c`. PE Detail UI restructure 3 yêu cầu (t1-5) + Manual budget drop tên (t6) + Mig 27 admin menu eOffice (t7) + NCC palette 5-màu cycle + Winner icon ✓ đậm + AddSupplier auto-fill master + Responsive laptop nhỏ 4-tầng pattern (t8-11) + Multi-agent infrastructure setup 3 sub-agents (t12). 27 mig (+1) · 59 tables · ~142 endpoints (+1) · 34 FE pages (+1) · 61 menu key (+1) · 81 test pass unchanged · 44 gotcha · 16 memory entries (+2) · 3 sub-agents NEW. Phase 9 UAT iteration mode.**)
+**S20 turn 7:** 2026-05-11 17:00 (Session 20 turn 7 — **🎯 Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27). 5 chunk `2ea2d27`→`ef394f8`→`059bfcb`→`1ed6530`→Chunk E Docs. User Q2=b: DisplayLabel CHỈ áp fe-user, admin sidebar giữ Label gốc. Domain MenuItem +IsVisible(true) +DisplayLabel(200). Mig 27 AddVisibilityAndDisplayLabelToMenuItems. BE PATCH /api/menus/{key} [Authorize Policy=Permissions.Update]. NEW FE-admin MenuVisibilityPage ~210 LOC (table inline edit per-row + Save dirty + Khôi phục mặc định + Toggle Eye/EyeOff + 4 StatCard). fe-user Layout filterForUser 2 tầng (USER_HIDDEN_KEYS hardcode + !isVisible dynamic) + effectiveLabel(displayLabel || label) replace 3 callsite. fe-admin Layout KHÔNG đụng. +1 menu key MenuVisibility "Menu eOffice" leaf System Order=94. 27 mig, 59 tables, ~142 endpoints, 34 FE pages, 81 test pass (Q4 UAT defer).**)
+**S20 prev:** 2026-05-11 (Session 20 — **🎯 PE Detail UI restructure 3 yêu cầu user UX. 4 chunk per-commit `9dee00d` → `2bba851` → `f2f01f4` → (current Chunk D Docs).** Q1=a (giữ Section "Chọn NCC TP" riêng), Q2=a "1 hạng mục trước tiên" (NCC shared, demo 1 hạng mục), Q3=a (chỉ hiện NV đã ký), Q4 public luôn (skip dotnet test mỗi chunk theo memory `feedback_uat_skip_verify`, vẫn `npm run build` × 2 app mỗi chunk vì có rename/remove function). **Chunk A (`9dee00d`)**: BE `CreatePurchaseEvaluationCommandHandler` thêm 1 PurchaseEvaluationDetail mặc định khi tạo phiếu — GroupCode="01", GroupName="Hạng mục chính", NoiDung=TenGoiThau, DonGiaNganSach=ThanhTienNganSach=Budget.TongNganSach hoặc BudgetManualAmount fallback 0; Changelog Insert audit. FE reorder PeDetailTabs (mirror 2 app) 1.Thông tin / 2.Hạng mục (lên #2) / 3.Chọn NCC / 4.NCC tham gia / 5.Ý kiến. **Chunk B (`2bba851`)**: ItemsTab restructure thành list `HangMucCard` (1 card / 1 hạng mục, expanded=true mặc định cho 1 hạng mục demo). Header card: GroupCode + NoiDung + 3 stat (KL/ĐG/TT) + NS link Δ nếu có + Pencil/Trash actions + ▼/▶ toggle expand. Expand body: NCC inline table columns NCC / Liên hệ / Điều khoản TT / **File báo giá** / ĐG chưa VAT / ĐG có VAT / Thành tiền / Action. Quote inline click cell → QuoteDialog cũ reuse. Add NCC + Sửa NCC reuse AddSupplierDialog/EditSupplierDialog cũ. Winner ✓ button mỗi NCC row. Drop function `SuppliersTab` (dead code ~134 LOC, replace bằng HangMucCard expand panel). Giữ AddSupplierDialog + EditSupplierDialog + SupplierAttachmentsCell (HangMucCard call lại). Section layout cuối: 1.Thông tin / 2.Hạng mục + Báo giá NCC (nested) / 3.Chọn NCC TP thắng thầu / 4.Ý kiến cấp duyệt — 4 section. **Chunk C (`f2f01f4`)**: Section Ý kiến restructure render layer (KHÔNG đụng Mig 26 schema — vẫn UPSERT 1 row / Level). LevelOpinionsSectionV2 forEach step → 1 `StepOpinionsBox` (replace grid-cols-2 cho N approver). Box header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter. Body: filter opinions theo step.order → sort levelOrder asc, signedAt asc → render `StepOpinionEntry` per signed opinion (tên NV + Cấp badge slate + admin override badge amber nếu có + emerald rounded-full timestamp + comment text). NV chưa duyệt KHÔNG hiển thị (Q3=a). Drop function `LevelOpinionBox` (replaced). Mirror fe-admin + fe-user. Verify build pass cả 2 app sau khi catch TS6133 `SuppliersTab` + `SupplierAttachmentsCell` unused (đã giải quyết: drop SuppliersTab, restore SupplierAttachmentsCell vào HangMucCard cột "File báo giá"). 81 test pass (no change — UAT defer)**)
+
+## 📍 Phase hiện tại: **Phase 9 active — UAT V2 testing với user thật** — **59 DB tables, 29 migrations (Mig 28 +6 column workflow-level S21 t4 → Mig 29 refactor sang per-NV S21 t5 — 5 column trên ApprovalWorkflowLevels + 1 column trên Users + DROP 6 column workflow-level), ~143 API endpoints, 34 FE pages. 84 unit test pass** (58 Domain + 26 Infra = +3 PE guard S21 t3, UAT defer test-after per §7 cho S21 t4+t5). **46 gotcha (+1 S21 t5 chốt: #46 Gitea API path/cache)**. 30 demo user + 1 test user UAT. 6 skill. **5 trạng thái phiếu** (Nháp/Đã gửi duyệt/Trả lại/Từ chối/Đã duyệt). **2 Workflow schemas đồng tồn tại** post-Session 17 + Per-NV refactor S21 t5: (1) Mig 21 `WorkflowDefinition` flat (V1) — pin với PE/Contract cũ. (2) Mig 22-29 `ApprovalWorkflow` (V2) — pin với PE mới, Mig 29 các flag per-NV ở Levels + Users. Service PE branch theo `ApprovalWorkflowId`. **4 sub-agents:** 🟦 Investigator + 🟨 Implementer + 🟥 Reviewer (3 seeds-only S21 — em main solo cross-stack reasoning chain REFUSE) + 🟩 CICD Monitor (2 runs PASS, ~110-120K/run cost). 30 demo user + 1 test user UAT. 6 skill. **5 trạng thái phiếu** (Nháp/Đã gửi duyệt/Trả lại/Từ chối/Đã duyệt). **2 Workflow schemas đồng tồn tại** post-Session 17: (1) Mig 21 `WorkflowDefinition` flat (V1) — pin với PE/Contract cũ + match Dept+PositionLevel. (2) Mig 22-26 `ApprovalWorkflow` (V2) — pin với PE mới + match ApproverUserId 1-1, Steps/Levels group by Order, Bước (Phòng) > Cấp (N NV OR-of-N), Mig 25 +IsUserSelectable admin pin per version, **Mig 26 +PeLevelOpinions sign-off dynamic theo Level**. Service PE branch theo `ApprovalWorkflowId` set or null. Sau UAT chốt → migrate + drop V1 + Contract V2 wire.
+
+### 🌐 Production URLs
+
+- https://api.solutions.com.vn — API (Let's Encrypt, auto-renew via win-acme)
+- https://admin.solutions.com.vn — Admin FE (HTTP→HTTPS auto-redirect)
+- https://eoffice.solutions.com.vn — User FE (HTTP→HTTPS auto-redirect)
+- https://git.baocaogiaoduc.vn/vietreport-admin/solution-erp — Gitea repo + Actions
+- Default admin: `admin@solutionerp.local` / `Admin@123456` ⚠️ **RE-ROTATE sau login đầu**
+
+## 🔥 In Progress — Session 7+ (Phase 9 active)
+
+### A. Hard blockers (chờ user / ops)
+
+- [ ] **UAT thật 1 tuần** với 2-3 user (Drafter / CCM / BOD) — hard requirement Phase 5 roadmap
+- [ ] **SMTP config** → Email outbox (BLOCKED chờ user cấp host/user/pass)
+- [ ] **Rotate creds** — admin + 30 demo + SA + vrapp + JWT secret + Gitea runner token
+- [ ] **Schedule SQL backup daily** — `scripts/backup-sql.ps1` đã sẵn, chưa schedule Task Scheduler
+- [ ] **Remove binding cũ `.huypham.vn`** sau verify stable: `ssh vietreport-vps ; .\migrate-domains.ps1 -RemoveOld -SkipCert`
+- [ ] **win-acme scheduled task "unhealthy"** — auto-renew fix trước 2026-06-18
+
+### B. Carry over feature gap
+
+- [ ] **Export phiếu PDF/Excel** PE — tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx` (user pending — không quan trọng lắm)
+
+### C. Optional polish (khi UAT phát sinh bug)
+
+- [ ] Budget MaNganSach atomic sequence (hiện Random.Shared → migration `AddBudgetCodeSequences`)
+- [ ] Budget versioned workflow (admin config UI thay hardcoded `BudgetPolicy.Default`)
+- [ ] Payment terms PE tách field (JSON blob → 6 column riêng)
+- [ ] Auto-map PE Details → Contract per-type Details khi gen HĐ
+- [ ] Matrix Quotes bulk paste từ Excel
+- [ ] fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"
+
+### D. Tests Phase 3-5 (làm khi gặp bug recurring để justify ROI — rule §7)
+
+- [ ] **Phase 3 full** — Application handler tests cần UserManager DI helper (PE Opinion Upsert, Budget validate, CreateContractFromEvaluation BudgetId carry) ~15 test
+- [ ] **Phase 4** — API smoke tests qua WebApplicationFactory ~7 test
+- [ ] **Phase 5** — FE Vitest cho lib utility (queryMatches, fmtMoney) ~10 test
+
+### E. 2-stage dept approval — Chunk E-bis ✅ DONE (Session 9)
+
+- [x] **FE Workflow Panel** PE — section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber khi chờ TPB confirm
+- [x] **FE UserManager toggle** `CanBypassReview` — column "Bypass" badge fuchsia + button toggle ShieldCheck (UsersPage)
+- [x] **HĐ 2-stage** mở rộng — `ContractWorkflowService` thêm UserManager DI + 2-stage logic mirror PE + `ContractDepartmentApprovalFeatures.cs` + endpoint `GET /contracts/{id}/department-approvals` + FE WorkflowHistoryPanel section mới
+- [x] **Budget 2-stage** mở rộng — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime + 2-stage logic + `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE BudgetWorkflowPanel section
+- [x] **Tests 2-stage** (6 test) — `IdentityFixture` setup full Identity stack + 6 test PE workflow service: NV review block / TPB confirm allow / NV bypass / Admin skip / Reject set / Resume jump-back. Pattern reusable.
+
+### F. Audit định kỳ (cron tự fire)
+
+- [x] **2026-05-01** (audit 2026-05-04 manual trigger sau trễ 4 ngày) — combined audit log `docs/changelog/skill-audit-2026-05.md`. Cron Claude SDK KHÔNG fit monthly cadence (auto-expire 7d) → user setup OS Task Scheduler nếu cần auto-remind.
+- [ ] **2026-06-01** — combined audit kế. Trigger thủ công khi đến ngày hoặc user nói "audit MD" / "kiểm tra docs" / "định kỳ kiểm tra".
+
+## ✅ Recently Done (newest on top)
+
+| Ngày | Ai | Task | Commit |
+|---|---|---|---|
+| 2026-05-15 | Claude | **🎯 SESSION 24 chốt cuối — Plan AA cumulative 7 commits (3 core + 4 polish UAT iteration)** — Plan AA Phase 1 core 3 commit (Chunk A BE+Layout + Chunk B FE matrix page + Chunk C Docs initial). Phase 2 polish 4 commit liên tục UAT feedback bro: `da218f1` hotfix px-6→px-2 (content sát sidebar) + `4d60598` redesign v1 panel-per-NV mirror admin Designer color coding (drop table symbol khó hiểu) + `fbbd361` redesign v2 HTML table rowSpan tận dụng full width (Bước/Cấp/NV/Quyền duyệt grid 2-col 7 label tiếng Việt nguyên văn) + `ee0902a` wrap fix sidebar label dài về đầu hàng (hanging-indent reverse CSS: flex→block + inline-block icon + inline text + absolute ChevronDown + text-[12px] leading-snug × 5 sites mirror 2 app). Patterns reusable saved: (1) Tailwind JIT palette array (5-color cycle Step + Cấp), (2) HTML table rowSpan flat row builder helper, (3) hanging-indent reverse CSS pattern. Multi-agent ROI: ~175K total (Investigator 32K Pre-A + Implementer 14K Chunk B + Reviewer 25K cumulative + CICD 12K Run #210 + 3 agent flush ~12K + em main ~80K) ≈ 28% solo equiv. **CICD Run #210 PASS 4/4 wire end-to-end**: IsUserSelectable filter live (admin no-filter / admin ghim / nv.test ghim all HTTP 200) + menu Pe_DuyetNcc_WfView present + Order shift idempotent 1-10 contiguous + non-admin permission Read OK + bundle hash rotate 2 app + Mig 31 unchanged. Pattern reinforced cumulative: gotcha #44 class-level Authorize relax PROVEN cross-stack reuse S18→S24 (Workflows endpoint từ admin-only sang any-auth read accessible). Test 111/111 PASS unchanged post-Plan AA (BE filter param + DbInitializer refactor no regression). Stats: 31 mig · 59 tables · **~146 endpoints (+1)** · **35 FE pages (+1 WorkflowMatrixViewPage)** · 111 test · 47 gotcha · 21 memory · 6 skills. **Implementer agent MEMORY ~31.5KB > 25KB threshold** → recommend curate next session archive S20-S22 old entries. | `ee776d5` (A BE+Layout) · `c667802` (B FE page) · `ac2c859` (C Docs init) · `da218f1` (px-2 hotfix) · `4d60598` (redesign v1 panel) · `fbbd361` (redesign v2 table rowSpan) · `ee0902a` (wrap fix label) · this Docs final |
+| 2026-05-15 | Claude | **🎯 SESSION 24 turn 1 — Plan AA User Workflow Matrix view + Sidebar widen revert Plan U truncate (3 commit)** — Bro UAT request: (1) sidebar Plan U S23 t11 truncate "..." → hiển thị đầy đủ label custom Mig 27, (2) thêm menu "Luồng duyệt" trên Danh sách hiển thị ma trận phân quyền workflow Designer ghim cho user xem (filter `IsUserSelectable=true` Mig 25). Q&A clarify 2 lượt: Q1 Permission strategy "Relax class-level [Authorize]" (đã fix gotcha #44 permanent từ S18 → CHỈ cần add filter param), Q2 Matrix layout "Table 2D full 7 Allow* cột". Plan 4 chunk: Pre-A (🟦 Investigator audit ~32K, confirm gotcha #44 + sidebar `w-72 xl:w-80` SAFE + Order strategy shift existing) + Chunk A (👤 Chủ trì Solo BE + Layout: MenuKeys `PurchaseEvaluationWorkflowView` helper + DbInitializer tree.Add LuongDuyet Order=2 + INSERT-OR-UPDATE-Order refactor idempotent + Permission seed 7 role + Handler `IsUserSelectable bool?` filter + Controller pass-through + sidebar `w-60 xl:w-72` → `w-72 xl:w-80` × 2 app mirror + revert Plan U truncate × 5 sites; commit `ee776d5` 6 files +73/-24) + Chunk B (🟨 Implementer Case 2 ~14K: WorkflowMatrixViewPage.tsx ~215 LOC + types/approvalWorkflowV2.ts ~55 LOC + App.tsx +route 2 LOC; commit `c667802` 3 files +305) + Chunk C (🟥 Reviewer cumulative ~25K: PASS 0 critical/major/minor blocker + Smart Friend guard active + fe-admin build verify bonus 1926 modules 740ms). Pattern reinforced: (1) gotcha #44 relax pattern PROVEN cross-stack reuse — Workflows endpoint từ admin-only sang any-auth read accessible. (2) DbInitializer INSERT-only → INSERT-OR-UPDATE-Order safe shift existing prod rows (idempotent re-deploy). (3) Plan U truncate revert pattern: widen sidebar + drop truncate, keep `min-w-0 flex-1` + `shrink-0` + `title` tooltip (no harm). **Surprise:** PE Workspace là **2-panel** không phải 3-panel — memory `feedback_responsive_laptop_breakpoint.md` stale claim → defer update memory. **3 commits push pending** (`ee776d5..<this>`). Stats: 31 mig · 59 tables · ~146 endpoints (+1 query filter param) · **35 FE pages (+1)** · 111 test (unchanged UAT mode) · 47 gotcha · 21 memory · 6 skills · 4 sub-agents (3 spawn S24 t1). | `ee776d5` (A BE+Layout) · `c667802` (B FE page) · (this Docs C) |
+| 2026-05-12 | Claude | **🎯 SESSION 21 turn 2 — RAG Hybrid setup planning + Cách A validation deep dive (2 commit `1f8e9af` plan save + this chốt)** — Sau S21 turn 1 chốt cicd-monitor, user clarify 5 dự án future > 1M MD tokens → cuộc thảo luận deep ~15 turn về RAG infrastructure. **Em main solo** (no SOLUTION_ERP sub-agent spawn), delegate **claude-code-guide × 2** spawn agent research Anthropic + community practice. **Q&A deep dive 10 topics**: (1) RAG fundamentals + Vector DB Qdrant role, (2) Embedding "AI nhúng" + Voyage AI cost mechanics ($0.18/M tokens), (3) Multi-project shared architecture (5 projects → single Qdrant + per-collection), (4) Audit procedure 3-tier (weekly auto + monthly deep + quarterly major), (5) UI/UX Streamlit dashboard 7 pages design (overview + drill-down + compare + audit + cost + change + admin), (6) Cách A defensive (giữ blanket 120K) vs Cách B aggressive (cắt 60-70%), (7) Reasoning depth comparison lazy 60% → A 90% → B 75-80%, (8) Industry validation Anthropic + Cursor + Continue + Cline + Aider all hybrid, (9) Multi-agent cost reality 8-10× multiplier ~520K cumulative blanket 5 entities, (10) 3-layer hybrid pattern Anthropic Contextual Retrieval Sept 2024. **Quyết định chốt Cách A** (defensive hybrid: giữ blanket 120K em main + RAG retrieve supplement, sub-agent spawn baseline ~100K each, 4 agents = ~400K cumulative, heavy session billed ~560K saving -20% vs lazy 700K, quality recall ~85%) over **Cách B bỏ** (aggressive cut 60-70% vi phạm priority em main control flow strong + reasoning fragmented + UX latency +1-2s/state Q + risk severe RAG fail). **Why Cách A** (bro priority chốt): em main control flow strong preserve, decision quality 90% multi-source cohesive, wall-clock -20% (12 phút vs 16), risk-averse graceful fallback, multi-agent leverage cache 70-90%, industry-validated 9 sources. **3-layer hybrid Phase rollout**: P1 (W1-4) vector only Voyage-3-large recall ~70% $1.50/mo · P2 (M2) +BM25 bm25s free recall ~78% $1.50/mo · P3 (M3) +Voyage rerank-2 + Contextual prefix recall ~92% $4-5/mo. **Stack validated** cross-industry: Voyage AI embedding (Anthropic partner, multilingual 26 lang, $0.36 initial), Qdrant local (Rust 50MB, agent-native 2026 leader, ~3GB disk 5 project), FastMCP Python (official SDK, ~100 LOC), SQLite event log (5 tables + audit history), Streamlit 7 pages. **Plan I NEW deferred** — trigger bro confirm 5 dự án path + stack + pilot + Voyage API key + disk cleanup → dedicated session 10-14h weekend (per `feedback_drastic_refactor_scope` rule). **Deliverables**: `docs/rag-setup-plan.md` 1223 LOC commit `1f8e9af` + extend S21 t2 ~300 LOC = ~1500 LOC final, memory `feedback_rag_hybrid_pattern.md` cross-project reusable, session log this chốt, MEMORY.md index +1 entry. **CI skipped** path filter (`.md`). **4 sub-agents vẫn seeds-only** (KHÔNG spawn S21 turn 2 nên KHÔNG flush MEMORY.md per §6.5 KHÔNG add noise). Tests baseline 81 unchanged. | `1f8e9af` (plan save) · this chốt (commit final) |
+| 2026-05-12 | Claude | **🎯 SESSION 21 turn 1 — Add con thứ 4 cicd-monitor (Path A — post-deploy verifier green READ tier, 1 commit `f1c61c9`)** — User chốt Path A sau pre-flight Plan G Trial Week 1: thêm sub-agent thứ 4 chuyên post-deploy verify (Gitea Actions poll + bundle hash 2 app verify + sqlcmd mig prod = repo latest + endpoint smoke). Trade-off: +~150K spawn extra mỗi run, đổi lại catch deploy ship fail tự động — recurring blind spot pattern em main solo S20 quên verify ~30% push. **2 file mới**: `.claude/agents/cicd-monitor.md` (~7KB) — system prompt + 8-step workflow (verify push → poll Gitea API → fail log grep → live curl smoke → bundle hash × 2 app + verify changed → sqlcmd mig prod = repo latest → report PASS/FAIL/PARTIAL/TIMEOUT/SKIPPED-DOCS) + 5-stage report table + gotcha #25/#39/#40/#41/#44 cross-ref + skill `iis-deploy-runbook`/`dependency-audit-erp`/`ef-core-migration` preload + Anti-pattern 9 rules. `.claude/agent-memory/cicd-monitor/MEMORY.md` (~5KB seed) — recurring CI bug patterns + 5-stage checklist + baseline build/bundle metrics + bearer test pattern admin/nv.test. **1 file update repo**: `.claude/agents/README.md` — 4-agent architecture diagram (green slot mới) + decision tree (after push code + prod issue diagnose branches) + memory routine 4 SendMessage + skills preload 4 agents + cost reality table 564K → 750K spawn / 1.2M → 1.35M heavy / 600K → 700K optimized + trial workflow Week 1-3 CI/CD Monitor spawn integrated + pass criteria + catch ≥1 deploy ship fail. **Memory user-level update**: `feedback_multi_agent_setup.md` — title 3 → 4 sub-agents, decision tree +CI/CD Monitor invocation branches (after push + user prod issue), skills preload list +CI/CD Monitor (iis-deploy-runbook + dependency-audit-erp + ef-core-migration), cost table update + trade-off rationale (recurring blind spot ~30% push S20). **CI skipped**: all 3 file changed `.md` → match `paths-ignore: '**/*.md'` per gotcha #41 → no Gitea Actions run → no IIS deploy (expected — agent infra là local Claude Code, không cần present trên prod). Push success `36e21c8..f1c61c9 main -> main`. **3 (now 4) sub-agents vẫn seeds-only**: chưa spawn work nào — em main solo via context paste + Write file. KHÔNG flush 3 agent MEMORY.md (chưa spawn work = không findings, per §6.5 KHÔNG add noise entry). cicd-monitor MEMORY.md có entry "setup 2026-05-12" trong seed. Trial Week 1 kick-off ở Session 21 turn 2+ với Plan B Contract V2 wire Mig 28+29 candidate (mirror PE pattern S17-S19 proven 1×). Tests baseline 81 unchanged (no test added — docs-only commit). | `f1c61c9` (Setup cicd-monitor + README 4-agent + memory update) |
+| 2026-05-11 | Claude | **🎯 SESSION 20 turns 6 + 8-12 — PE polish (NCC palette + autofill + responsive) + Multi-agent setup (7 commit `f568945` → `ae1814c`)** — Sau turn 7 wrap-up Mig 27, user iterate 7 polish/feature lớn nhỏ. **Turn 6 (`f568945`)** Manual budget "Nhập tay" drop tên field — 3 file × 2 app mirror (BudgetFieldRow + WorkspaceCreateView + HeaderForm) bỏ Input "Tên" UI khỏi manual mode, BE save `budgetManualName: null` luôn, VND format `1.000.000` + suffix đ. **Turn 8 (`3ec7b5a`)** AddSupplier +Số tiền inline + NCC 5-màu palette + Winner badge "🏆 Trúng thầu" — AddSupplierDialog +prop detailId? +form thanhTien, sequential POST /suppliers (response {id}) → POST /quotes (nếu detailId + thanhTien > 0). NCC_PALETTES const 5 màu literal Tailwind (blue/purple/sky/teal/pink) cycle theo idx. Winner row override emerald-500 border-l + bg-emerald-100/70 + shadow-sm + ring-1 emerald-300 + badge rounded-full bg-emerald-600 text-white "🏆 Trúng thầu". **Turn 9 (`83aae8e`)** User feedback bỏ badge → revert icon ✓ stick cũ nhưng đậm hơn (text-base font-bold emerald-700) + tên NCC winner text-emerald-900 + hover transition (winner hover:bg-emerald-200/70, non-winner hover:bg-white/80 hover:shadow-sm). **Turn 10 (`66551db`)** AddSupplierDialog auto-fill từ master data khi chọn NCC dropdown — onChange lookup picked supplier, setForm ghi đè 4 field (contactName ← contactPerson / contactPhone ← phone / contactEmail ← email / note ← note). Hint emerald "✓ Đã tự điền từ Master". User vẫn override được. **Turn 11 (`6e338f7`)** Responsive cho laptop màn hình nhỏ 1280-1366px — 4-tầng pattern: sidebar fe-admin + fe-user `w-72` → `w-60 xl:w-72` (+48px lg) / PE Workspace 2-panel `lg:[320px_1fr]` → `lg:[260px_1fr] xl:[320px_1fr]` (+60px lg) / Section padding `px-5 py-4` → `px-3 py-3 sm:px-5 sm:py-4` (+16px xs) / HangMucCard `gap-3 p-3` → `flex-wrap gap-2 p-2 sm:gap-3 sm:p-3` (+8px xs). Net gain trên 1366px ~+132px width cho NCC table area. Memory `feedback_responsive_laptop_breakpoint.md` capture pattern. **Turn 12 (`ae1814c`)** SETUP MULTI-AGENT INFRASTRUCTURE 3 sub-agents (Investigator READ cyan + Implementer WRITE conditional yellow + Reviewer READ adversarial red) + em main coordinator. Pre-flight decision gate 6/6 ✅. Phase 1-4 execute: `.claude/agents/` 4 file (README ~9.7KB + investigator + implementer + reviewer) + `.claude/agent-memory/` 3 MEMORY.md seed (~6KB each). Customize SOLUTION_ERP: skills preload mỗi agent (reuse 6 skills hiện có) + bearer test (admin@solutions / nv.test@solutions) + prod UAT URL + Phase 9 UAT mode + DB Dev/Design distinct. Windows MAX_PATH pitfall handled — drop `isolation: worktree` khỏi implementer.md (project path 51 chars + Dropbox-managed nested overflow 260+ chars). Memory `feedback_multi_agent_setup.md` capture decision gate + ACCEPT/REFUSE criteria + NAMGROUP s41-s43 ROI reference. 3 agents **chưa spawn work** ở S20 turn 12 — seeds-only state. Trial Week 1 candidate Contract V2 wire Mig 28+29 (mirror PE pattern proven). **Stats cumulative S20:** 27 mig (+1 Mig 27 from turn 7) · 59 tables · ~142 endpoints (+1 PATCH /menus/{key}) · 34 FE pages (+1 MenuVisibilityPage) · ~61 menu key (+1) · 81 test pass unchanged · 44 gotcha unchanged · **16 memory entries (+2: responsive + multi-agent)** · 6 skills unchanged · **3 sub-agents NEW** · 14 commits S20. | `f568945` (t6) · `3ec7b5a` (t8) · `83aae8e` (t9) · `66551db` (t10) · `6e338f7` (t11) · `ae1814c` (t12) · (current Docs t13 wrap) |
+| 2026-05-11 | Claude | **🎯 SESSION 20 turn 7 — Admin Ẩn/Hiện + Đổi tên menu eOffice (Mig 27, 5 chunk `2ea2d27`→`ef394f8`→`059bfcb`→`1ed6530`→Chunk E Docs)** — User UAT yêu cầu "tính năng Ẩn Hiện và Đổi tên hiển thị của các Menu bên ngoài Office, làm trong Trang Admin Page". Hỏi xác nhận "chưa có" — đúng. User clarify Q2=b "edit hiển thị bên ngoài, chỉ của eOffice thôi" → admin sidebar luôn giữ Label gốc, DisplayLabel CHỈ áp fe-user. Q1=a global (không per-role), Q3=a giữ USER_HIDDEN_KEYS hardcode + tầng IsVisible dynamic combine, Q4 UAT skip test. **Chunk A** Domain MenuItem +IsVisible bool=true +DisplayLabel string?(200) + EF config + Migration 27 AddVisibilityAndDisplayLabelToMenuItems (2 AddColumn) — 3-file rule, apply LocalDB _Dev + _Design OK. **Chunk B** BE API: MenuNodeDto + MenuItemDto +isVisible +displayLabel (sau CRUD flags trước Children). GetMyMenuTreeQueryHandler pass through, KHÔNG filter server-side — 2 FE app tự quyết. UpdateMenuItemCommand + Validator + Handler (trim DisplayLabel whitespace → null). MenusController +PATCH /api/menus/{key} [Authorize Policy=Permissions.Update] body {isVisible, displayLabel}. **Chunk C** Domain MenuKeys +MenuVisibility const + All[] + DbInitializer +leaf "Menu eOffice" Icon=Eye Order=94 (Workflows shift 94→95). Manual seed Mig 27 LocalDB _Dev (INSERT MenuItems + Permissions Admin). FE Admin: types/menu.ts +isVisible +displayLabel, lib/menuKeys.ts +MenuVisibility, Layout resolver +/system/menu-visibility, App.tsx +Route. NEW pages/system/MenuVisibilityPage.tsx ~210 LOC: PageHeader + 4 StatCard (Tổng/Hiển thị/Đã ẩn/Đã đổi tên) + Search + Table 5 cột (Key mono + parentKey ↳ / Tên gốc / Input "Tên hiển thị" inline placeholder "Mặc định: {label}" / Toggle button emerald-Eye / amber-EyeOff / Lưu khi dirty + Khôi phục khi custom). PATCH endpoint, invalidate ['menus','all'] + ['my-menu'] trigger live update sidebar. Row hidden bg-amber-50/40 highlight, custom label bg-brand-50/40. **Chunk D** fe-user types/menu.ts mirror. Layout.tsx filterForUser 2 tầng (USER_HIDDEN_KEYS structural + !isVisible dynamic). Helper effectiveLabel(n) = displayLabel?.trim() || label. Replace 3 callsite {node.label} → {effectiveLabel(node)}. USER_FIXED_TOP "__inbox" entry +isVisible:true cho type check pass. **fe-admin Layout KHÔNG đụng** — admin sidebar render Label gốc + show hết menu (user Q2=b). **Chunk E Docs (current)**. **Stats Session 20 turn 7**: 26→27 mig, 59 DB tables (no change), ~141→142 endpoints, 33→34 FE pages, ~60→61 menu key, 81 test pass (Q4 UAT defer), 44 gotcha (no new). Memory entries 14 (no new). | `2ea2d27` (A Mig 27) · `ef394f8` (B BE API) · `059bfcb` (C FE admin) · `1ed6530` (D FE user) · (current E Docs) |
+| 2026-05-11 | Claude | **🎯 SESSION 20 — PE Detail UI restructure 3 yêu cầu UX (4 chunk: 9dee00d→2bba851→f2f01f4→Chunk D Docs)** — User UAT live phản hồi "Logic OK rồi, điều chỉnh UI Duyệt NCC 1 tý": (1) Hạng mục lên trên + auto-tạo 1 row từ gói thầu, (2) NCC expand dưới hạng mục, (3) Section Ý kiến gộp đồng cấp cùng Phòng. Q&A clarify trước code (4 câu Q1=a/Q2=a "1 hạng mục"/Q3=a "chỉ hiện signed"/Q4 "public luôn demo thôi"). 4 chunk per-commit pattern `feedback_per_chunk_commit`. **Chunk A** BE `CreatePurchaseEvaluationCommandHandler` + INSERT 1 PurchaseEvaluationDetail mặc định + Changelog (GroupCode=01, NoiDung=TenGoiThau, ThanhTienNganSach=Budget.TongNganSach hoặc BudgetManualAmount fallback 0) + FE reorder PeDetailTabs section. **Chunk B** ItemsTab restructure list HangMucCard (1 card / hạng mục, expanded=true default cho demo 1 hạng mục). Header: GroupCode + NoiDung + 3 stat (KL/ĐG/TT) + NS link Δ + Pencil/Trash + ▼/▶ toggle. Expand body: NCC inline table 8 cột (NCC/Liên hệ/Điều khoản TT/File báo giá/ĐG chưa VAT/ĐG có VAT/Thành tiền/Action). Click cell quote → QuoteDialog reuse. Add NCC/Edit NCC reuse 2 dialog cũ. Winner ✓ button per row. Bỏ Section 4 "NCC tham gia" (gộp vào Section 2 nested) → 4 section final. Drop SuppliersTab function ~134 LOC dead code (replace bằng HangMucCard expand). Giữ AddSupplierDialog + EditSupplierDialog + SupplierAttachmentsCell (HangMucCard reuse). **Chunk C** Section Ý kiến gộp đồng cấp cùng Phòng. LevelOpinionsSectionV2 forEach step → 1 `StepOpinionsBox` (replace grid-cols-2 N approvers). Header: "Bước N — Tên" + dept badge emerald + "X/Y đã duyệt" counter. Body: filter opinions theo step.order → sort levelOrder asc + signedAt asc → render `StepOpinionEntry` per signed (tên NV + Cấp badge slate + admin override amber + timestamp emerald rounded-full + comment). NV chưa duyệt KHÔNG hiển thị (Q3=a). KHÔNG đụng Mig 26 schema (vẫn UPSERT 1 row / Level qua Service). Drop LevelOpinionBox function. Mirror fe-admin + fe-user mỗi chunk. **Verify**: dotnet build pass (Chunk A) + npm build × 2 app pass (Chunk B/C — catch TS6133 SuppliersTab unused + SupplierAttachmentsCell unused, fix re-add cột File báo giá vào nested table). **Test skip** Phase 9 UAT iteration (81 test pass unchanged). **Stats unchanged**: 26 mig, 59 DB tables, ~141 endpoint, 33 FE pages, 44 gotcha, 81 test. **Pending S21+**: Test regression B4 silent 403 (HIGH §7), Test V2 Service wire ApproveV2Async + Section gộp (Chunk C), Test Mig 25 PATCH user-selectable, Contract V2 (Mig 27/28 mirror PE), phân quyền strict V2, drop legacy V1 cleanup. | `9dee00d` (A) · `2bba851` (B) · `f2f01f4` (C) · (current D Docs) |
+| 2026-05-09 | Claude | **🎯 SESSION 19 — PE Section 5 V2 dynamic theo ApprovalWorkflowLevel + Mig 26 (4 commit: 873e7a1 polish 3 button + 77a3058/90baa8e/6e913b3/Chunk D Mig 26)** — User feedback Section 5 hiện CỨNG 4 box (PheDuyet/CCM/MuaHàng/SmPm Mig 15 từ Phase 8) → cần động theo Workflow V2 đã pin: forEach Step (Phòng) → forEach Level (Cấp) → forEach NV → 1 OpinionBox với ý kiến + tên người ý kiến. Bước 1 Phòng A có 2 NV → 2 box ngang hàng. **5 câu chốt spec trước code:** Q1=1B (gắn — Service auto sync khi duyệt, KHÔNG form input rời), Q2=2A+Admin (NV chính chủ + Admin override với SignedByUserId track actual signer), Q3=chuyển V2 hết (phiếu V1 legacy fallback Mig 15 4 box readOnly), Q4=4C+bonus (Phase=DaDuyet/TuChoi khoá; Admin có quyền duyệt thay; comment empty → "(duyệt — không ý kiến)" placeholder), Q5=5A (layout group Step header "Bước N — Phòng X" + grid-cols-2 cho N approvers). **3 chunk per-commit (memory `feedback_per_chunk_commit`):** Chunk A (`77a3058`) Domain entity `PurchaseEvaluationLevelOpinion : AuditableEntity` (PEId+LevelId UNIQUE composite, Comment nvarchar(2000), SignedAt datetime2, SignedByUserId Guid, SignedByFullName nvarchar(200) denorm) + EF config FK Cascade Pe + Restrict Level + ApplicationDbContext + IApplicationDbContext DbSet + **Migration 26** `AddPeLevelOpinionsForV2` (1 CREATE TABLE + 2 FK + 2 index — UNIQUE composite + IX LevelId). 3-file rule. Apply LocalDB SolutionErp_Dev OK. Chunk B (`90baa8e`) Service `PurchaseEvaluationWorkflowService.ApproveV2Async` sau line log approval → UPSERT row PurchaseEvaluationLevelOpinions cho Cấp hiện tại: match level theo `ApproverUserId == actorUserId` (multi-NV cùng Cấp OR-of-N), fallback first khi Admin override (FE detect SignedByUserId !== Level.ApproverUserId hiển thị "Admin duyệt thay"). Reject KHÔNG sync. Empty/whitespace comment → "(duyệt — không ý kiến)" placeholder. Helper `ResolveActorFullNameAsync(actorUserId, isSystem)` lookup denorm SignedByFullName từ Users (fallback "(System)" / "(unknown)"). DTO `PurchaseEvaluationLevelOpinionDto` 15 fields (LevelId/StepOrder/StepName/StepDepartmentId/StepDepartmentName/LevelOrder/LevelName/ApproverUserId/ApproverFullName/Comment/SignedAt/SignedByUserId/SignedByFullName). GET handler `GetPurchaseEvaluationQueryHandler` Include LevelOpinions + helper `BuildLevelOpinionsAsync` JOIN ApprovalWorkflows.Steps.Levels + Departments + Users → denorm DTO list. Empty list cho phiếu V1 / V2 chưa có cấp duyệt → FE fallback. Chunk C (`6e913b3`) FE Section 5 V2 dynamic: type `PeLevelOpinion` + `PeDetailBundle.levelOpinions[]`. Section 5 conditional: `evaluation.approvalWorkflowId` set → `<LevelOpinionsSectionV2/>` (V2 dynamic), else `<DepartmentOpinionsSection/>` readOnly fallback (V1 legacy giữ Mig 15 4 box). Component `LevelOpinionsSectionV2` group theo step.order: header "Bước N — <name>" + dept badge emerald + hint "(N người duyệt)" khi totalApprovers > 1; body grid-cols-2 cho `step.levels.flatMap(level => level.approvers.map(approver => <LevelOpinionBox/>))`; lookup opinion theo (stepOrder, levelOrder, approverUserId). `LevelOpinionBox` read-only: title "Cấp N — <ApproverFullName>", badge amber "⚠ Admin <name> duyệt thay" khi override, badge emerald "✓ Đã duyệt", empty "— chưa duyệt" italic gray, footer timestamp signedAt format vi-VN. Workspace mode hint giữ amber "Ý kiến + chữ ký auto đồng bộ khi NV duyệt". Mirror fe-admin + fe-user (rule §3.9). Verify: dotnet build pass + dotnet test 81 pass + npm run build × 2 pass · 0 TS error. Chunk D docs (current) STATUS/HANDOFF/migration-todos/CLAUDE.md/schema-diagram §16 mới + session log. Phiếu V1 cũ KHÔNG migrate (giữ Mig 15 readOnly), drop sau UAT confirm. **Stats:** 26 mig (+1), 59 DB tables (+1), ~141 endpoints (no new), 33 FE pages, 81 test pass. Polish 3 button (873e7a1) Hành động đầu Session 19: rút gọn label "✓ Duyệt / ← Trả lại / ✗ Từ chối" + 3 màu khác nhau (emerald/amber/red) + font-bold cho cả 2 app. | `873e7a1` (3 button) · `77a3058` (Chunk A Mig 26) · `90baa8e` (Chunk B Service+DTO+GET) · `6e913b3` (Chunk C FE) · (current Chunk D Docs) |
+| 2026-05-08 19:45 | Claude | **🎯 SESSION 18 WRAP-UP — PE V2 polish + Clone B (DuyetNccPhuongAn) + 4 bug fix UAT + Mig 25 IsUserSelectable (7 commit `aaa1c6c` → `32a8d4d`)** — User UAT live tiếp Session 17, request chuỗi polish nhỏ + clone V2 cho type B. Áp memory `feedback_uat_skip_verify` (skip dotnet test mỗi chunk, push ngay) + lesson rename/remove → bắt buộc `npm run build`. **B1 (`aaa1c6c`)** Pe Duyệt (`?pendingMe=1`): bỏ dropdown "Tất cả trạng thái" + filter cứng client-side `getPeDisplayStatus === DaGuiDuyet` (loại Nháp/Trả lại/Đã duyệt/Từ chối). Hint amber "Lọc cố định: Đã gửi duyệt". Header count dùng `rows.length` (inbox không paged). Workaround BE /inbox loose UAT trả phiếu Nháp. Mirror fe-admin + fe-user. **B2 (`917446d`)** PeDetailTabs HistoryTab filter chỉ events Trả lại/Gửi duyệt lại: workflow transition về TraLai (phaseAtChange=98) + transition từ TraLai (summary chứa "TraLai →") + sửa nội dung khi phaseAtChange=TraLai. BE giữ audit data đầy đủ, chỉ FE filter (reversible). Empty state "Chưa có lịch sử trả lại / gửi duyệt lại". Mirror cả 2 app. **B3 (`937eb24`) Clone V2 cho B (DuyetNccPhuongAn)** — User chốt "Quy trình chọn thầu phụ - NCC → Duyệt NCC đúng. Clone toàn bộ updates sang Duyệt NCC và Giải pháp". Audit phát hiện 80% chung qua `ApplicableType` discriminator → chỉ thêm 3 file ~60 LOC: (a) `MenuKeys.cs` +const `ApprovalWorkflowDuyetNccPhuongAnV2` + add vào `All[]`. (b) `DbInitializer.SeedMenusAsync` +leaf "Duyệt NCC và Giải pháp (Mới)" dưới root ApprovalWorkflowsV2 + new method `SeedSampleApprovalWorkflowsV2Async` seed `QT-DN-PA-V2-001 v01` (1 Bước Phòng CCM × 1 Cấp NV test, idempotent). (c) `fe-admin/lib/menuKeys.ts` +`AwV2_DuyetNccPhuongAn`. KHÔNG migration / Service / Designer page (Layout regex `^AwV2_(.+)$` đã match dynamic, ApprovalWorkflowsV2Page có `TYPE_CODE_TO_INT` cả 3 type). Rút memory `feedback_audit_reuse_before_clone.md`. **B4 (`f77ea38`) Fix permission silent 403** — Drafter `nv.test` Workspace dropdown empty mặc dù seed OK. Root: class-level `[Authorize(Policy = "Workflows.Read")]` → non-admin 403, TanStack Query catch silent → UI empty không warning. Fix: class-level `[Authorize]` only (any authenticated). GET = list workflow read-only không nhạy cảm; POST + DELETE giữ `Workflows.Create` admin-only. Pattern reusable cho Contract V2 sau. **B5 (`a9c0857`) Fix sidebar highlight queryMatches** — Click phiếu trong leaf "Danh sách" → URL `?type=1&id=abc` → menu mất highlight (gotcha #34 cũ tái phát). Root: queryMatches exact-set equality {type} vs {type, id} length mismatch. Fix: `TRANSIENT_QUERY_KEYS = {id, q, editHeader, page, phase, awId}` strip trước compare. Edge case verified: Danh sách `?type=1` vs Pending `?type=1&pendingMe=1` distinct (không cross-highlight). Mirror cả 2 app Layout.tsx. **B6 (`2a53107`) Mig 25 + Designer pin toggle + bỏ "(clone)" + Workspace filter** — User feedback Admin Designer: bỏ "(clone)" auto-suffix khi clone version (version đã đủ phân biệt) + thêm pin toggle "Cho user pick lúc create phiếu" (multi-select, độc lập IsActive). Migration 25 `AddIsUserSelectableToApprovalWorkflows`: ALTER ApprovalWorkflows +`IsUserSelectable bit NOT NULL DEFAULT 0` + Sql backfill `UPDATE WHERE IsActive=1 SET 1` (giữ behavior cũ active workflow vẫn pickable). Domain ApprovalWorkflow +property. DTO AwDefinitionDto +field. CreateAwDefinitionCommand set default `true` cho version mới (mirror IsActive). New `SetAwUserSelectableCommand` + Handler. API `PATCH /api/approval-workflows-v2/{id}/user-selectable` policy `Workflows.Create`. DbInitializer SeedSampleApprovalWorkflowsV2Async +`IsUserSelectable=true`. FE Designer: `DefinitionDto` +field; badge amber "📌 Cho user chọn"; button "Ghim cho user / Bỏ ghim" + mutation `toggleSelectable`. Designer `name = cloneFrom.name` (bỏ ` (clone)` suffix). Workspace fetch filter `w.isUserSelectable === true` (cả fe-admin + fe-user). **B7 (`32a8d4d`)** Cleanup orphan `.claude.zip + docs.zip` từ harness session start, +`*.zip` rule .gitignore. **Cumulative Session 18:** 25 mig (+1), 58 tables (no new), ~141 endpoints (+1), 33 FE pages, **81 test pass** (no change — feature mới UAT defer test theo §7), 44 gotcha (+1 silent 403). Memory +1 entry. **Pending Session 19+:** Contract V2 wire (Mig 26 mirror PE), phân quyền strict V2, drop legacy V1 cleanup. | `aaa1c6c` (B1) · `917446d` (B2) · `937eb24` (B3) · `f77ea38` (B4) · `a9c0857` (B5) · `2a53107` (B6) · `32a8d4d` (B7) |
+| 2026-05-08 | Claude | **🎯 SESSION 17 WRAP-UP — PE Workflow V2 schema + Service wire end-to-end (13 commit `c847dc0` → `de0f38d`)** — User chốt sau Session 16 "Thấy vẫn không đúng" → viết lại schema riêng + thêm Menu "Duyệt NCC (Mới)" UAT. Cấu trúc rõ ràng: Quy trình > Bước (Phòng) > Cấp (NV cụ thể qua ApproverUserId). 3 chunk lớn: **Schema design + Designer** (Mig 22 — `c847dc0/f6047d5/2781c7e/12daa7f`): 3 entity ApprovalWorkflow/Step/Level + enum ApplicableType (DuyetNcc/DuyetNccPhuongAn/Contract). Designer page `/system/approval-workflows-v2/:typeCode` — iter 1 lock 3 cấp (`9712778`, sai intent) → iter 2 đúng intent max 3 cấp × N NV/cấp + sequential gating C2/C3 disabled khi cấp trước empty + filter NV theo Phòng + no-dup same level (`f3bea3c`). Validator BE Order∈{1,2,3} + HaveSequentialOrders + HaveNoDuplicateApproverInSameLevel. **State machine 5 trạng thái** (`ff21120`): Nháp→Đã gửi duyệt→Đã duyệt (terminal) | Trả lại (Phase riêng TraLai=98, KHÔNG revert DangSoanThao + KHÔNG jump-back) | Từ chối (terminal). Drafter từ TraLai sửa+gửi lại chạy LẠI từ Cấp 1 Bước 1 (Option A user chốt diagram). PE/Contract/Budget Phase enum +TraLai=98 + Policy + Service Reject branch trỏ → TraLai + bỏ smart-reject (RejectedAtStepIndex giữ DB column deprecated). 4 test mới TraLai entry point. **Pin V2 vào PE + Service wire** (Mig 23-24 — `0a40c65/b41484b`): PE.ApprovalWorkflowId Guid? + PE.CurrentApprovalLevelOrder int? + EF FK Restrict. CreatePurchaseEvaluationCommand+Validate ApplicableType match PE.Type. UpdateDraft cho phép sửa Phase=Nháp/TraLai. Workspace Select bắt buộc (filter ApplicableType=type). Service `ApproveV2Async` + `ApproveV1LegacyAsync` branch theo ApprovalWorkflowId set or null: V2 group Levels by Order = Cấp (OR-of-N approvers cùng cấp), match `actor.Id ∈ ApproverUserId`, advance levelOrder++ trong Step → idx++ + reset levelOrder=1 → DaDuyet. Synthetic Policy `ForV2Schema()` cho FE nextPhases (DangSoanThao/TraLai → ChoDuyet/TuChoi; ChoDuyet → ChoDuyet/TraLai/TuChoi). **UX V2-aware** (`d814429/9e63e2d/d250ae4/74745a7/de0f38d`): DTO `CurrentApproval { stepIdx, levelOrder, approvers[] }` + `ApprovalFlow { steps[]: { Order, Name, Dept, Levels[]: { Order, Approvers[], Status:Done/Current/Pending } } }`. Banner emerald "Đến lượt bạn" / amber "Không phải lượt bạn — chỉ {NV X / Y} duyệt được". Button Duyệt forward disabled khi V2 + actor không trong cấp + tooltip. Trả lại + Từ chối vẫn enabled (BE không gating reject theo cấp). Inbox V2-aware (`ResolveV2InboxIdsAsync` precompute Set IDs khớp actor.Id ∈ Cấp hiện tại). 2 dropdown filter "Quy trình duyệt" + "Trạng thái" (chỉ ở Duyệt sau user feedback, Danh sách giữ 1 dropdown trạng thái). Panel 3 thay 4 phase cards bằng flow workflow thực tế: Bước (icon ✓/●/○ + dept badge) → Cấp (icon nhỏ + label "đang chờ" / "đã duyệt" + tên NV). Phiếu V1 legacy fallback note. **Test setup** (`ac41d5e`): SQL `clean-transactional-uat.sql` xóa 9 PE + 11 HĐ + Budget + 19 Notif + reset CodeSequences trên prod, giữ master (Users/Suppliers/Projects/Departments/Workflows V1+V2). Tạo test user `nv.test@solutions.com.vn`/`TestUser@123456` (Drafter, Phòng CCM) qua API. **77→81 test pass** (+4 TraLai entry point Domain). FE rename "Bản nháp" → "Nháp" + ChoDuyet=10 + TraLai=98 thêm vào types/contracts.ts + types/budget.ts. **Pending session sau:** Contract V2 wire (mirror PE pattern), Budget V2 (defer xa hơn), phân quyền strict V2 (hiện loose UAT cho mọi authenticated user xem phiếu V2), drop legacy V1 sau khi UAT chốt + cleanup migration drop RejectedAtStepIndex/RejectedFromPhase. | 13 commit (xem `git log --since='2026-05-08'`) |
+| 2026-05-08 | Claude | **🎯 SESSION 16 — DRASTIC REFACTOR flat workflow Phòng × Cấp (Mig 21, 2 commit Chunk A+B)** — Resume từ Session 15 defer plan. User chốt "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking". Per memory `feedback_drastic_refactor_scope`: dedicated session với context fresh, scope conservative 2x buffer (~8-10h estimate, actual ~3h). **Chunk A (`dbb0089`)** — Domain enum simplify (DangSoanThao=1, ChoDuyet=10 NEW, DaDuyet=7, TuChoi=99; legacy 2-6 + 98 deprecated giữ cho data cũ). WorkflowStep + DepartmentId Guid? FK Restrict + PositionLevel int? (PE + Contract mirror). PE/Contract entity + CurrentWorkflowStepIndex int? + RejectedAtStepIndex int?. Drop class WorkflowStepInnerStep + nav (PE + Contract). Drop *DepartmentApproval.InnerStepId column. EF Configurations: drop InnerStep config + restore simple unique non-filtered (Mig 19/20 filtered split reverse). DbContext drop DbSet<*WorkflowStepInnerStep> × 2. **Migration 21** `RefactorWorkflowToFlatModel` GỘP: 4 ALTER cols (PE/Contract CurrentStepIndex+RejectedAtStepIndex) + 2 ALTER (WorkflowStep DeptId+PositionLevel) + DROP TABLE x 2 (PEWorkflowStepInnerSteps + WorkflowStepInnerSteps Mig 18+20) + DROP InnerStepId column x 2 (PE+Contract DeptApproval) + DROP filtered indexes x 2 + restore simple unique x 2. PE + Contract Service rewrite TransitionAsync: phase transitions DangSoanThao→ChoDuyet (Drafter trình init idx=0) / ChoDuyet→ChoDuyet (advance idx) / ChoDuyet→DaDuyet/DaPhatHanh (last step done) / ChoDuyet→DangSoanThao (Trả lại save RejectedAtStepIndex) / ChoDuyet→TuChoi (Từ chối khoá vĩnh viễn). Match approver: actor.Dept==step.Dept AND actor.PositionLevel>=step.PositionLevel (OR cùng cấp/dept) OR Approvers.Kind=User match OR Kind=Role match. Admin role bypass policy. Last step done → gen mã HĐ (Contract only). App CQRS WorkflowStepDto + WorkflowStepInput drop InnerStep, add DepartmentId/DepartmentName/PositionLevel (PE + Contract mirror). Tests rewrite: DROP `PeNStageApprovalTests.cs` (6) + `ContractNStageApprovalTests.cs` (6) + `PeTwoStageApprovalTests.cs` (7) — legacy N-stage/2-stage no longer applicable. UPDATE `PeWorkflowAdminTests` signature. **96 → 77 test pass** (-19 legacy). 3-file rule Mig 21 (.cs + Designer + Snapshot) commit đủ. **Chunk B (`88a5be1`)** — FE-Admin Designer rewrite (PeWorkflowsPage + WorkflowsPage): drop InnerStepDto + EditInnerStep types, drop PHASE_OPTIONS auto-assign ChoDuyet=10, StepDto + EditStep + departmentId/positionLevel, copyFromDefinition simplified, Designer step UI rewrite (Tên + Phòng Select + Cấp Select + SLA + Approvers Role/User optional fallback, drop entire InnerSteps sub-section), DefinitionCard view hiển thị badge Phòng emerald + Cấp NV/PP/TP violet, save payload phase=10. types/purchaseEvaluation.ts (fe-admin + fe-user mirror) + ChoDuyet=10 enum + label "Đang duyệt" + color amber. **Chunk C (FE PeWorkflowPanel) SKIP** — existing UI compatible (workflow.nextPhases driven by BE simplified policy), reuse 3-button Trả lại/Từ chối logic Session 14 hoạt động trên ChoDuyet phase tự động. **KHÔNG đụng** Service Notify pattern + Changelog pattern (giữ hành vi Mig 16). Verify: dotnet build pass + Mig 21 LocalDB applied + 77 test pass + npm build × 2 pass. Memory `feedback_drastic_refactor_scope.md` validated: dedicated session approach hoạt động đúng dự đoán. | `dbb0089` (A) · `88a5be1` (B) |
+| 2026-05-07 | Claude | **🎯 SESSION 15 — Tooltip diagnose "Lưu & Gửi Duyệt" + Plan drastic refactor flat workflow → DEFER** — User UAT live screenshot phiếu PE Bản nháp + báo "Lưu & Gửi Duyệt" KHÔNG hoạt động + suy đoán "trùng ID với phiếu khác". Chẩn đoán: button silent disabled khi `evaluation.workflow.nextPhases` không có forward phase (chỉ TuChoi/TraLai). FE chưa có visual feedback → user không biết. Improvement (commit `835cc7f`): compute `forwardPhase` once + add `submitDisabledReason` string giải thích reason (canEditPhase=false / readOnly / !forwardPhase với hint admin kiểm tra cấu hình quy trình) + button title attribute show reason hover hoặc forward phase label khi enabled + Dialog confirm show forward phase explicit "Sẽ chuyển sang Chờ Purchasing". Mirror fe-admin + fe-user. Build pass cả 2. **"Trùng ID" KHÔNG phải bug FE** — `PurchaseEvaluationWorkspacePage` URL state đúng (`+ Thêm mới` clear `id`, save set new), mỗi PE row unique GUID + MaPhieu. **Tiếp theo plan drastic refactor**: User chốt "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking" + workflow flat list (Phòng × Cấp × Users[]) thay InnerStep model. Surface 6 chunk plan + start Chunk A: edit Domain entities (Phase enum +ChoDuyet=10, WorkflowStep +DeptId/PositionLevel, drop InnerStep class+nav, PE/Contract +CurrentWorkflowStepIndex/RejectedAtStepIndex, *DeptApproval drop InnerStepId) + EF Configurations (drop InnerStep config + nav, restore simple unique non-filtered) + DbContext drop DbSets — 12 files trong working tree. Realize scope realistic ~8-10h (PolicyRegistry rewrite + 2 Service rewrite + App CQRS + 12 tests rewrite + Designer FE + Migration 21 + Docs) vượt session boundary + risk session context deep ~30 commits. **REVERT working tree** về `835cc7f` clean. Add memory `feedback_drastic_refactor_scope` decision rule: drastic refactor cần dedicated session, ước tính conservative (2x buffer), tránh mid-session big refactor. **Stats unchanged**: 96 test pass, 20 mig, 57 bảng. | `835cc7f` |
+| 2026-05-07 | Claude | **🎯 SESSION 14 — PE 3-button workflow Duyệt/Trả lại/Từ chối + Task 2 sample seed in-progress** — User chỉ thị thay 2-button approval bằng 3 hành động rõ ràng cho approver: **Duyệt** (forward), **Trả lại** (về DangSoanThao + Drafter sửa, smart reject Mig 16 + clear N-stage rows + Drafter resume jump-back), **Từ chối** (Phase=TuChoi, phiếu khoá vĩnh viễn 17 handler Mig 16 lock edit, Drafter phải tạo phiếu mới). 1 commit (`0d77698`): Domain `PurchaseEvaluationPolicy.cs` NccOnly + NccWithPlan thêm `(X → TuChoi)` transition cho mọi phase trung gian (ChoPurchasing/ChoCCM/ChoDuAn/ChoCEODuyetPA/ChoCEODuyetNCC) với roles của phase. FromDefinition expand: mỗi step (trừ DangSoanThao) thêm (step.Phase → TuChoi) với roles step. Service `PurchaseEvaluationWorkflowService.TransitionAsync` — Reject branch tách 2 case: target=TuChoi giữ nguyên (KHÔNG override + KHÔNG set RejectedFromPhase + KHÔNG clear N-stage); target khác (DangSoanThao) → smart reject (force DangSoanThao + RejectedFromPhase + clear N-stage). FE PeWorkflowPanel (admin + user mirror): render 3 button rõ ràng "✓ Duyệt → X" brand / "← Trả lại (về Drafter sửa)" red / "✗ Hủy / Từ chối" red. Decision logic: target=TuChoi || isSendBack → Reject (2), else Approve (1). Dialog confirm: title rõ + Cancel case warning red "phiếu sẽ bị khoá hoàn toàn" + SendBack case hint amber "Phiếu về DangSoanThao, Drafter sửa rồi trình lại — workflow tự jump tới phase này". Tests: rename `Reject_Sets_RejectedFromPhase_And_Forces_DangSoanThao` → `Reject_To_DangSoanThao_Sets_RejectedFromPhase_TraLai` (target từ TuChoi → DangSoanThao). NEW `Reject_To_TuChoi_Locks_Permanently_No_RejectedFromPhase`. Update `NStage_Reject_Clears_InnerStep_Rows_At_Phase` target → DangSoanThao. **95 → 96 test pass** (+1 Từ chối). **Task 2 sample seed in-progress**: dotnet ef database update applied Mig 9-20 lên LocalDB SolutionErp_Dev (trước đó chỉ Mig 1-8 vì DesignTimeDbContextFactory hardcoded SolutionErp_Design ≠ runtime SolutionErp_Dev — gotcha tooling distinction). API start để DbInitializer auto-seed 30 demo user nhưng exit 255 sớm khi log buffer full → seed dở dang. Defer Task 2 cho session sau (cần guidance: seed manual SQL hoặc manual API run + sample N-stage workflow def + Update PositionLevel cho 30 users existing). | `0d77698` |
+| 2026-05-07 | Claude | **🎯 SESSION 13 — Mirror N-stage workflow sang Contract (Mig 20, 5 commit per-chunk + skip Chunk E API)** — User chỉ thị mirror N-stage từ PE sang Contract. Budget defer (cần versioned WF migration trước, hardcoded BudgetPolicy hiện tại chưa có WorkflowDefinition). 5 chunk per-commit (build + ef + test pass mỗi chunk): **Chunk A (`951ffa3`)** Domain entity `WorkflowStepInnerStep` (Domain/Contracts/) + nav WorkflowStep.InnerSteps + ALTER ContractDepartmentApproval.InnerStepId Guid? + EF config FK Cascade Step / Restrict Dept+InnerStep + **Migration 20** `AddContractWorkflowInnerStepsAndAlterDeptApprovalUnique` GỘP 1 (CREATE TABLE WorkflowStepInnerSteps + ALTER InnerStepId + DropIndex old + Recreate filtered legacy `WHERE InnerStepId IS NULL` + new filtered N-stage `WHERE InnerStepId IS NOT NULL` + 3 IX + 3 FK). **Chunk B (`04cf2a0`)** Application CQRS DTO — `WorkflowStepInnerStepDto` + extend `WorkflowStepDto` + GetWorkflowAdminOverview Include InnerSteps + DeptNames map + `CreateWorkflowStepInnerStepInput` + `CreateWorkflowStepInput` extend (default null backward compat) + Validator child rules + Handler atomic batch insert. **Chunk C (`e247b67`)** ContractWorkflowService refactor mirror PE — load definition InnerSteps eager, reject branch clear N-stage rows tại fromPhase, dept approval block split hasInnerSteps→N-stage logic / else→legacy 2-stage. N-stage flow giống PE: yêu cầu actor có DeptId+PositionLevel, match firstPending Order asc + (exact level OR canBypass + level≥), exact upsert 1 row InnerStepId, bypass batch upsert NV+PP+TP cùng dept ≤ actor (audit IsBypassed cho cấp dưới), recheck stillPending → BLOCK + log "duyệt cấp X (còn Y pending)". **Chunk D (`7c0772a`)** Tests 6 N-stage Contract mirror PE pattern + helper SeedWorkflowDefinitionAsync 2 step adjacent (DangGopY + DangDamPhan) + SeedContractAsync với Project + Supplier seed + FakeChangelogService + FakeContractCodeGenerator stubs. Bug fix: legacy fallback test ban đầu fail (Standard policy DangGopY → DangDamPhan chỉ cho [Drafter, DeptManager], không Procurement) → switched phase pair sang DangKiemTraCCM → DangTrinhKy + role CostControl khớp. Total 89 → **95 test pass**. **Chunk E SKIP** — WorkflowsController auto-bind `[FromBody] CreateWorkflowDefinitionCommand` record qua JSON, no code change cần. **Chunk F (current)** FE-Admin types/users.ts đã có PositionLevel const từ Session 12 reuse. WorkflowsPage Designer extend mirror PeWorkflowsPage Chunk F: InnerStepDto + EditInnerStep types + copyFromDefinition include + departmentsList query + sub-section "Cấp duyệt nhỏ trong phòng" drag-list { Phòng × Cấp + required } + button "+ Thêm cấp duyệt" emerald + payload include Order asc. Empty state hint fallback 2-cấp legacy. KHÔNG đụng fe-user (admin-only). Docs/Skill update. **Backward compat 100%**: workflow Contract no InnerSteps → fallback legacy 2-stage Mig 16. Data legacy InnerStepId=null vẫn enforce unique cũ qua filtered index. Defer Budget mirror cho session sau (cần migration `AddBudgetVersionedWorkflow` trước). | `951ffa3` (A) · `04cf2a0` (B) · `e247b67` (C) · `7c0772a` (D) · (current F) |
+| 2026-05-07 | Claude | **🎯 SESSION 12 — N-stage workflow approval Phòng × PositionLevel cấu hình động (PE-only first, 6 commit per-chunk + Mig 18+19)** — User yêu cầu mở rộng từ 2-stage Mig 16 (NV.Review/TPB.Confirm) sang N-stage cấu hình động: mỗi WorkflowStep cha (= 1 phase) có thể cấu hình chuỗi InnerSteps con theo Department × PositionLevel với Order sequential. Spec defaults chốt 6 câu (PositionLevel int 1=NV/2=PP/3=TP, sequential pure, bypass cùng dept TP skip NV+PP, smart reject reset N-stage rows về DangSoanThao, PE-only first, designer 1 sub-section InnerSteps). 6 chunk per-commit (build + ef + test pass mỗi chunk per `feedback_per_chunk_commit.md`): **Chunk A (`13ab533`)** Domain enum `PositionLevel` (NV/PP/TP) + entity `PurchaseEvaluationWorkflowStepInnerStep` + ALTER User.PositionLevel int? + ALTER PEDeptApprovals.InnerStepId Guid? + EF config + **Migration 18** `AddPeWorkflowInnerStepsAndPositionLevel` (1 CREATE TABLE + 2 ALTER + 3 index + FK Cascade Step / Restrict Dept/InnerStep). 3-file rule. **Chunk B (`0e56bd0`)** Application CQRS DTO — `PeWorkflowStepInnerStepDto` + extend `PeWorkflowStepDto` + `CreatePeWorkflowStepInnerStepInput` (default null backward compat existing PeWorkflowAdminTests) + Validator child rules + Handler atomic batch insert + UserDto +PositionLevel field + `SetUserPositionLevelCommand` mirror SetBypassReview. **Chunk C (`0c62e24`)** Service N-stage logic — **Migration 19** `AlterPeDeptApprovalsUniqueFilteredForInnerSteps` (filtered unique: legacy `WHERE InnerStepId IS NULL` + N-stage `WHERE InnerStepId IS NOT NULL`) cho phép multi-row cùng dept khác inner step. PurchaseEvaluationWorkflowService refactor: load definition InnerSteps eager + reject branch clear N-stage rows + dept block split hasInnerSteps→N-stage logic / else→legacy 2-stage. N-stage flow: yêu cầu actor có DeptId+PositionLevel, match firstPending (Order asc IsRequired) same dept + (exact level OR canBypass + level≥), exact match upsert 1 row InnerStepId, bypass batch upsert NV+PP+TP cùng dept ≤ actor level (audit IsBypassed cho cấp dưới skip), recheck stillPending → BLOCK + log "duyệt cấp X (còn Y pending)" / all done → fall through phase transition. Backward compat: workflow no InnerSteps fallback legacy + InnerStepId=null filter unique cũ vẫn enforce. **Chunk D (`3d76c6b`)** Tests N-stage 6 test mới (NV first blocks / 3-level sequential pass / TP bypass skips / wrong dept throws 403 / reject clears rows / legacy fallback no inner) + IdentityFixture extend `+positionLevel` arg + helper SeedWorkflowDefinitionAsync 2 step adjacent (ChoPurchasing+ChoCCM) cho FromDefinition build transition policy guard pass. Total 83→**89 test pass**. **Chunk E (`83ffabd`)** API `PATCH /users/{id}/position-level` mirror SetBypassReview pattern + body `{positionLevel:int?}` Authorize Users.Update. **Chunk F (current)** FE-Admin types/users.ts +positionLevel field + PositionLevel const + Label/Short maps. PeWorkflowsPage Designer extend: InnerStepDto type + EditInnerStep type + copyFromDefinition include + departmentsList query + sub-section "Cấp duyệt nhỏ trong phòng" per step card với drag-drop list { Phòng × Cấp + required checkbox } + button "+ Thêm cấp duyệt" (xanh emerald) + payload include innerSteps Order asc. UsersPage column "Cấp" badge NV/PP/TP emerald + action button cycle null→1→2→3→null call positionLevelMut PATCH. KHÔNG đụng fe-user (admin-only feature). Docs/Skill update. PE-only first. Backward compat 100%: workflow no InnerSteps + data legacy 2-stage rows không phá. | `13ab533` (A) · `0e56bd0` (B) · `0c62e24` (C) · `3d76c6b` (D) · `83ffabd` (E) · (current F) |
+| 2026-05-08 00:30 | Claude | **🎯 SESSION PHASE 2 WRAP-UP — B12-B14 PE detail polish iterate (3 commit FE-only sau wrap-up `6e7a6db`)** — User UAT iteration tiếp, áp rule strict verify khi rename/remove (lesson hotfix CI). 3 batch nhỏ: **B12 (`378c993`)** "Lưu" no-close (chỉ toast + invalidate, KHÔNG đóng workspace) + nút "Xóa phiếu" red bottom CHỈ Bản nháp (soft-delete `IsDeleted=true` qua AuditableEntity, không xóa hoàn toàn DB) + bỏ header bar workspace mode "Sửa header"/"Xóa"/"Đóng" (chuyển hết xuống bottom action bar) + Section 4 column header dùng `s.supplierName` thay `displayName` (NCC master) + Section 3 row chặn xóa NCC khi đã có quotes (`hasQuotes` computed) + tooltip "xóa báo giá trước". **B13 (`e320027`)** InfoTab `useEffect` watch `[autoEdit, canEdit, ev.id, ...]` → re-trigger edit mode khi pencil click phiếu khác (fix useState mount-time only) + sync values từ ev mới (tránh stale state) + Pencil "sáng lên" active state khi `editingRowId === p.id` (bg-brand-100 + text-brand-700 + ring-brand-300 + shadow-sm + tooltip cập nhật) + wire `editingRowId={autoEditHeader ? selectedId : null}` từ Workspace → PeListPanel. **B14 (`d2306b8`)** QuoteDialog bỏ checkbox "Chọn NCC này cho hạng mục" (consolidate winner ở Section 2.a NccSelectorRow, isSelected vẫn gửi BE giữ trạng thái cũ) + winner column Section 4 matrix highlight emerald (header `bg-emerald-50` + `✓ ` prefix + cells `bg-emerald-50 font-semibold` cho ENTIRE column, không chỉ cell có quote) + loading overlay full-screen QuoteDialog (`bg-white/70 backdrop-blur-sm` + spinner ring brand-600 + text "Đang lưu báo giá…"/"Đang xóa…") + NccSelectorRow inline spinner "Đang chọn NCC + sync cột giá Section 4…" + disable Hủy/Xóa/Lưu buttons khi `isSaving`. Verify: `npm run build` × 2 app pass mỗi commit · `dotnet test` 83 pass (KHÔNG regression). | `378c993` (B12) · `e320027` (B13) · `d2306b8` (B14) |
+| 2026-05-07 | Claude | **🎯 SESSION WRAP-UP S10-11+++++++ — PE Workspace UX overhaul đầy đủ (23 commit / ~3500 LOC FE + Mig 17 BE)** — User UAT live mode iterate liên tục, áp rule `feedback_uat_skip_verify` (skip dotnet test sau mỗi chunk, push ngay). 7 batch chính: **B1 (S10) PE Thao tác 2-panel workspace** — leaf `Pe_*_Create` từ page Create header riêng → workspace 2-panel `[320px_1fr]` mirror HĐ Thầu phụ; PeListPanel pure picker + sticky "+ Thêm mới"; PeDetailTabs `mode='workspace'` ẩn Workflow/Approvals/History + Section 5 disabled "nhập khi duyệt" (4 commit). **B2 (S11) Migration 17** `AddManualBudgetFieldsToPeAndContract` — 4 ALTER (PE + HĐ × `BudgetManualName` nvarchar(200) + `BudgetManualAmount` decimal(18,2)) cho fallback "user nhập tay khi không link Budget entity approved". Domain + EF config + App CQRS Create/Update + DTO + Validator + carry-forward `CreateContractFromEvaluation`. FE toggle "Nhập tay" trong PeHeaderForm + ContractCreatePage NewForm/EditForm × 2 app (5 commit). **B3 (S11+) BudgetFieldRow inline editor** — Section 2 "b. Ngân sách" thay FormRow tĩnh → editable component (toggle + Select OR 2 input + Save dirty + Hủy). canEdit cho cả 3 view (Workspace/Danh sách/Duyệt mode), readOnly chỉ display (3 commit). **B4 (S11++) InfoTab inline edit + PeListPanel pencil hover** — Section 1 "✎ Sửa" button flip display↔inputs (Tên/Địa điểm/Mô tả/Payment editable, Dự án locked). PeListPanel thêm pencil icon group-hover absolute right + URL `?editHeader=1` chain → `autoEditHeader` prop trigger mount-time edit (3 commit). **B5 (S11+++) Workspace "new" sectioned create view** — `PeWorkspaceCreateView.tsx` ~230 LOC layout 5 sections giống PeDetailTabs visual. S1 + S2.b editable, S3-5 LockedHint "Lưu phiếu trước". POST trigger create. Replace `PeHeaderForm` trong workspace mode='new' (1 commit). **B6 (S11++++) Danh sách disable toàn bộ interactions** — PurchaseEvaluationsListPage `readOnly={true}` hardcoded cho PeDetailTabs + `readOnly={!pendingMe}` cho PeWorkflowPanel (List view → ẩn Chuyển tiếp + show hint "Vào menu Duyệt"; Pending vẫn approve được) (2 commit). **B7 (S11+++++) Lock Loại quy trình + payment preset** — workspace `<Select>` Loại quy trình → `<Input disabled>` theo URL `?type=N`. `<Textarea>` JSON Điều khoản TT → `<Select>` 8 preset Việt + "Khác (nhập tay)" → text input fallback (1 commit). **B8 (S11++++++) Display status meta** — `PeDisplayStatus` enum 4-5 trạng thái UI (Bản nháp / Đã gửi duyệt / Trả lại / Đã duyệt / Từ chối) gom phase chi tiết. `getPeDisplayStatus()` helper. Workflow timeline Panel 3 vẫn giữ phase chi tiết (1 commit). **B9 (S11+++++++) Phase TraLai + pencil always visible + edit gating** — Domain `PurchaseEvaluationPhase` thêm `TraLai = 98` (giữa DaDuyet=7 + TuChoi=99). FE label/color + display status badge. `isEditablePhase()` helper: chỉ DangSoanThao + TraLai. PeListPanel pencil bỏ hover-only → LUÔN visible (bright khi editable / xám disabled khi không) + click guard. Workspace `editableOnly` filter client-side (1 commit). **B10 (hotfix CI)** — TS strict catch fail 2 commit B7+B8 do skip-verify (`forcedPhase` rename quên xóa destructuring args + unused `PurchaseEvaluationType` import). Update memory `feedback_uat_skip_verify.md` thêm exception "rename/remove → BẮT BUỘC `npm run build`" (1 commit). **B11 (last) PE detail polish** — `NccSelectorRow` Section 2.a thay FormRow tĩnh → Select dropdown từ ev.suppliers (Section 3 list) wire `/select-winner` API. Section 2.c text rõ "(chọn NCC trước)" / "(chưa nhập báo giá)". Section 3 row khi `isWinner` → ẩn ✏ + 🗑 (chỉ giữ ✓ active). Bottom action bar workspace mode: **2 nút "Lưu (đóng)" + "Lưu & Gửi Duyệt →"** confirm dialog → POST `/transitions` với `targetPhase = first nextPhase` skip TuChoi/TraLai → workflow chuyển từ Bản nháp/Trả lại → Đã gửi duyệt (ChoPurchasing) → onBack đóng workspace (1 commit). | `ee0d360` (S10 C1) → `4c0625c` (B11) — 23 commit total |
+| 2026-05-07 | Claude | **PE InfoTab inline edit Section 1 + PeListPanel pencil edit hover** — User feedback 2026-05-07: muốn thêm nút edit kế bên row trong Panel 1, click sáng nội dung Section 1 lên cho user sửa header inline (KHÔNG cần đi "Sửa header" page). 2 chunk per-commit (build pass mỗi chunk): C1 fe-admin (3 file) — InfoTab thêm prop `readOnly + autoEdit`, canEdit=`!readOnly && isDraft`: display mode hiển thị FormRow + button "✎ Sửa" góc trên phải, editing mode card border brand-200 + 4 input (Tên */Dự án locked/Địa điểm/Mô tả/Payment) + Save (PUT /pe/:id full payload + invalidate detail+list)/Hủy. PeListPanel thêm prop `onEditClick`, pencil icon absolute right-2 top-2 mỗi row, opacity-0 group-hover:opacity-100. PurchaseEvaluationWorkspacePage đọc URL `?editHeader=1` → pass `autoEditHeader` xuống PeDetailTabs → trigger edit auto. C2 fe-user mirror y hệt 3 file (rule §3.9). KHÔNG đụng BE. KHÔNG refactor workspace "new" mode (defer — PeHeaderForm hiện tại đủ dùng, làm thêm khi user feedback). | `5a89dd2` (C1) · (current C2) · (current C3 docs) |
+| 2026-05-07 | Claude | **PE BudgetFieldRow inline editor — toggle + 2 fields trong Section 2 (cả 3 view)** — User feedback after Session 11: muốn toggle "Nhập tay" + 2 input fields hiển thị trực tiếp trong Section 2 "b. Ngân sách" của PeDetailTabs — KHÔNG chỉ ở "Sửa header" page, mà cả 3 view (Workspace / Danh sách / Duyệt). Empty values cứ hiển thị empty (không text "(chưa link)" verbose). 2 chunk mirror per-commit (build pass mỗi chunk): C1 fe-admin BudgetFieldRow component (~125 LOC) thay FormRow tĩnh ở `b. Ngân sách`. canEdit=`!readOnly && isDraft`: render toggle + Select Budget OR 2 input grid 2-col + nút "Lưu ngân sách" (chỉ hiện khi dirty) + "Hủy thay đổi". Save: full PUT `/pe/:id` với current entity values + new budget payload. Read-only mode (Duyệt + !isDraft): chỉ display, KHÔNG toggle/inputs, empty hiển thị "—". C2 fe-user mirror y hệt 1 file (rule §3.9). Mỗi chunk: build pass + 0 TS error. KHÔNG đụng BE — re-use existing PUT endpoint. | `19712d8` (C1) · `d5c6f12` (C2) · (current C3) |
+| 2026-05-07 | Claude | **Migration 17 — manual budget fields fallback cho PE + HĐ (toggle "Nhập tay")** — User feedback: khi project chưa có Budget approved (Phase=DaDuyet eligible), user phải break flow đi tạo Budget + duyệt + quay lại link. UX kém. Solution: thêm fallback "Nhập tay" — checkbox toggle cạnh Label Ngân sách, khi ON → hide Select Budget, show 2 input field grid 2-col (Tên tham chiếu text + Số tiền number formatted VND). Lưu trên entity row, KHÔNG cần Budget entity. Q1-3 chốt: 1 = stick-toggle reveal 2 input fields; 2 = cả BudgetId + manual fields cùng null OK (KHÔNG XOR validate); 3 = mirror logic sang HĐ luôn (cả 7 ContractType qua ContractCreatePage). 5 chunk per-commit (build + 83 test pass mỗi chunk): C1 Migration 17 `AddManualBudgetFieldsToPeAndContract` 4 ALTER (PE + HĐ × Name nvarchar(200) + Amount decimal(18,2)) + Domain 2 entity + 2 EF config (HasMaxLength + HasPrecision) — applied LocalDB OK, 3-file rule. C2 App CQRS — CreatePurchaseEvaluationCommand + Update + DTO + Validator (>=0 when has value), CreateContractCommand + Update + DTO + diff log audit, CreateContractFromEvaluation carry forward pe.BudgetManualName/Amount → contract khi gen HĐ từ phiếu. C3 FE-Admin — types +2 field, PeHeaderForm toggle + 2 input + payload conditional (manual mode clear budgetId, link mode clear manual), PeDetailTabs Section "b. Ngân sách" fallback display "Tên · Số tiền + badge nhập tay" khi !budget + có manual data, refactor PurchaseEvaluationCreatePage wrap PeHeaderForm DRY (222→30 LOC), ContractCreatePage NewContractForm + EditContractForm cùng pattern + read-only display branch khi !isDraft. C4 fe-user mirror y hệt 6 file. C5 docs (this row + HANDOFF + session log). KHÔNG đụng Budget entity / Phase=DaDuyet validation (giữ invariant). | `ecd5f7e` (C1) · `0f7901c` (C2) · `bab5031` (C3) · `14f8d9d` (C4) · (current C5) |
+| 2026-05-07 | Claude | **PE "Thao tác" 2-panel workspace + Panel 1 read-only picker + Section 5 disabled** — User chỉ thị restructure leaf "Thao tác" (Pe_DuyetNcc_Create + Pe_DuyetNccPhuongAn_Create) từ page tạo header riêng (`/purchase-evaluations/new?type=N` — chỉ form Tên/Project/Địa điểm/Payment/Budget) sang workspace 2-panel mirror pattern HĐ Thầu phụ ContractCreatePage. 5 câu chốt spec trước code: Q1 Panel 2 KHÔNG render Workflow Panel + Approvals + History (chỉ data entry); Panel 1 = pure picker, KHÔNG inline edit/delete; Q2 mirror HĐ Thầu phụ pattern (sticky "+ Thêm mới" + Panel 2 transition new→edit form); Q3 leaf "Danh sách" + "Duyệt" giữ 3-panel hiện tại; Q4 route mới `/purchase-evaluations/workspace?type={1\|2}`; Q5 Section 5 Ý kiến 4PB disable trong workspace (vì người ta nhập khi duyệt, không phải lúc nhập liệu). 2 chunk per-commit (build + 83 test pass mỗi chunk): C1 fe-admin (3 file mới `PeListPanel.tsx` ~180 LOC pure picker reuse + `PeHeaderForm.tsx` ~210 LOC extract + `PurchaseEvaluationWorkspacePage.tsx` ~120 LOC, 3 file sửa `PeDetailTabs.tsx` thêm prop `mode?: 'detail' \| 'workspace'` + Section 5 hint banner amber + Layout.tsx resolver `Pe_*_Create`→`/workspace?type=N` + App.tsx route mới). C2 fe-user mirror y hệt 6 file (rule §3.9). KHÔNG đụng BE / migration / schema / endpoint. Route `/new` cũ giữ tồn tại cho deep-link "Sửa header" button. **Total +1142 LOC FE / 0 BE / 32 FE pages.** | `ee0d360` (C1) · `ecf3c59` (C2) · (current C3) |
+| 2026-05-04 | Claude | **User Manual 7 file rewrite compact cho end-user** — User feedback "ko cần quá đầy đủ chi tiết, cho end-user họ làm". Setup `package.json` + `npm install docx@9.5.0` + script `npm run gen:all`. Rewrite 7 generator scripts theo style end-user friendly: BỎ field validation table 5 cột (Tên field/Kiểu/Bắt buộc/Validation/Ví dụ), BỎ error troubleshoot table 3 cột (Lỗi/Nguyên nhân/Cách xử lý), BỎ FAQ chi tiết 8 câu (giữ 1 chương "Khi gặp lỗi" 4-5 bullet), BỎ phím tắt table. GIỮ: tổng quan ngắn 1-2 câu mỗi chức năng, numbered steps đơn giản 3-7 bước, note/warn/tip chỉ critical, bullet liệt kê. 7 file: 01-Bat-dau (12.1KB cũ 21.7KB ↓44%) / 02-Hop-dong / 03-Duyet-Workflow (mention 2-stage NV/TPB Mig 16) / 04-PE-Phieu-Duyet-NCC (A/B + 4PB + tạo HĐ) / 05-Budget / 06-7-Loai-HD-Cheatsheet / admin-02-Quan-ly-Users-Roles (mention bypass review S9). Refactor user-01 dùng `_helpers.js` shared (trước có helpers inline 793 dòng, giờ ~110 dòng). Tổng output ~86KB / 7 file (cũ ~123KB ↓30%). | `16c2c9c` |
+| 2026-05-04 | Claude | **Optional polish — fe-user Inbox thêm section "Phiếu Duyệt NCC chờ tôi"** — User chỉ thị "tiếp tục plan tổng" → pick task không blocked. useQuery thứ 2 cho `/purchase-evaluations/inbox` (endpoint có sẵn), peRows filter theo search. Stats overdue/dueSoon đếm cả PE rows (totalValue chỉ HĐ vì PE không có giá trị). Panel 1 chia 2 section sticky header: "Hợp đồng (N)" giữ behavior cũ click → inline detail Panel 2; "Phiếu Duyệt NCC (M)" click → navigate `/purchase-evaluations/:id` page riêng (PE entity shape khác Contract, không inline). EmptyState mới: "Không có HĐ hoặc Phiếu Duyệt NCC nào chờ". Chỉ fe-user (Drafter + TPB dùng Inbox) — fe-admin defer. Build pass. | `332a90f` |
+| 2026-05-04 | Claude | **Audit định kỳ 2026-05 (combined skill + doc drift theo §6.4 + §9.4)** — Cron `solution-erp-skill-audit-monthly` empty (`No scheduled jobs`), trễ 4 ngày so schedule 2026-05-01 → manual trigger sau Session 9 close. Phase 1 cross-check counts: tests=83, migrations=16, gotchas=41, skills=6, STATUS rows=12 (<30 chưa archive) — toàn bộ khớp. Drift patches 5 file: docs/CLAUDE.md (52→55 bảng + §14 DepartmentApprovals), docs/rules.md (Phase 8→9, 77→83 test), docs/architecture.md (77→83 test 2 chỗ), .claude/skills/ef-core-migration (77→83 + ghi 6 PE 2-stage), .claude/skills/dependency-audit-erp (26+→41 bẫy). Phase 2 skill staleness: contract-workflow thêm "Phase 9 cross-ref Mig 16" block + section "Phase 9 done" (2-stage + smart reject + lock edit + bypass). KHÔNG tạo skill mới (§9.5 anti-pattern "viết skill chỉ để có thêm" — pattern 2-stage đủ generic, đã ghi đủ Domain/Service/6 test reusable). Cron recreate SKIP (CronCreate Claude SDK auto-expire 7 days, không fit monthly cadence). Audit log `docs/changelog/skill-audit-2026-05.md` (1 page). 6 file ~+30/~12 line patch, validation §6.5 OK. | `7dc0233` |
+| 2026-05-04 | Claude | **Session 9 — Chunk E-bis complete: FE 2-stage panel + UserManager bypass toggle + HĐ/Budget 2-stage mirror PE + 6 test + IdentityFixture** — User chỉ thị "làm hết cho xong tính năng luôn". 5 chunk per-commit (build + 83 test pass mỗi chunk): (E2) FE PeWorkflowPanel section "Tiến trình duyệt 2-cấp phòng ban" group by phase × dept, highlight amber chờ TPB, badge fuchsia bypass — cả 2 app (rule §3.9). (E3) FE UsersPage column "Bypass" + ShieldCheck toggle button + UserDto.CanBypassReview field. (E4) ContractWorkflowService thêm UserManager DI + mirror 2-stage logic từ PE + `ContractDepartmentApprovalFeatures.cs` (List query) + endpoint `GET /contracts/{id}/department-approvals` + FE WorkflowHistoryPanel section. (E5) Budget mirror đầy đủ — `TransitionBudgetCommandHandler` thêm INotificationService + IDateTime DI + 2-stage logic + `BudgetDepartmentApprovalFeatures.cs` + endpoint + FE BudgetWorkflowPanel. (E6) `IdentityFixture` setup ServiceProvider với Identity stack đầy đủ (DbContext SQLite + AddIdentityCore + AddRoles<Role> + EF stores) + 6 test PE 2-stage: NV_Review_Blocks / TPB_Confirm_Allows / NV_Bypass / Admin_Skip / Reject_Sets_RejectedFromPhase / Resume_Jumps_Back. Tests Contract + Budget skip vì logic identical PE, ROI thấp. **Total 77→83 test pass.** 5 commit pushed lên Gitea. | `f8eebd5` (E2) · `4380bdc` (E3) · `b6f5a16` (E4) · `1fc439b` (E5) · `8353fe8` (E6) · (current E7) |
+| 2026-05-04 | Claude | **Session 8 — Migration 16: 2-stage dept approval + smart reject + lock edit (đóng bug anh Kiệt)** — Anh Kiệt báo: NV.PRO tạo phiếu PE → duyệt được hết phase = phân quyền sai. Schema mới: 3 bảng `*DepartmentApprovals` (Contract/PE/Budget) UNIQUE (TargetId, Phase, Dept, Stage). 4 cột mới: `Users.CanBypassReview` bit + 3 `RejectedFromPhase` int. Logic 2-stage trong `PurchaseEvaluationWorkflowService.TransitionAsync`: user.DepartmentId != null → DeptManager (TPB) Stage=Confirm; CanBypassReview=true → Stage=Confirm+IsBypassed; else NV → Stage=Review only, BLOCK transition cho đến khi TPB confirm. Smart reject: Decision=Reject → set RejectedFromPhase, force về DangSoanThao. Resume sau reject: Drafter trình lại từ DangSoanThao + RejectedFromPhase != null → jump straight tới phase đã reject (skip phase trung gian). Lock edit: 17 handler thêm guard Phase != DangSoanThao (Contract Detail × 15, PE Detail × 5, Budget Detail × 3). 3 endpoint mới: `GET /pe/{id}/department-approvals` (FE Workflow Panel hiển thị progress) + `PATCH /users/{id}/bypass-review` (admin toggle) + Notify TPB cùng dept khi NV review. **HĐ + Budget 2-stage scope defer** (chỉ PE first đóng bug). FE update + Tests defer Chunk E-bis. | `5fe61cc` (A) · `14f3c9f` (B) · `9747f8c` (C) · `a532ba6` (D) · (current) |
+| 2026-04-30 | Claude | **Session 6 — MD audit + compact + 3 skill refresh + 2 rule mới** — Compact 3 file core (-288 dòng): STATUS -27%, HANDOFF -32%, migration-todos -35%. Archive 51 row Recently Done Phase 0-7 → `changelog/recently-done-archive-2026-04.md`. Refresh 3 skill stale: `form-engine` (Phase 2 MVP → Tier 3 feature-complete + bỏ section duplicate gen mã HĐ), `permission-matrix` (12 menu → ~60 menu key + Bg_*/Pe_*/PeWf_* + inheritance roots), `ef-core-migration` (24 DbSet → 52 bảng + ERD update). Rule mới `rules.md §7 Khi nào viết test — timing rule` (5-row table compact, sau khi rút gọn từ 70 dòng overkill). Rule mới `rules.md §6.4 Audit + compact MD định kỳ` (cadence + checklist + anti-pattern, KHÔNG rewrite toàn bộ). `rules.md §9.4 Skill audit` mở rộng cross-ref §6.4. | (current) |
+| 2026-04-29 | Claude | **Tests Phase 3 mini + 3 gotcha CI mới (#39 #40 #41)** — `tests/.../Application/PeWorkflowAdminTests.cs` 6 test versioning logic (CreatePeWorkflowDefinition: first version IsActive=true, second deactivates first, different EvaluationType independent, persists steps ordered + approvers per step, third version increments to v3). Total **77 test** (54 Domain + 17 Infra + 6 PE WF Application). Gotcha #39 act_runner github.com TCP timeout 21s + manual checkout fix. #40 npm junction cache fail `tsc not found` rolled back. #41 paths-ignore behavior + workflow file exclusion. | `b874743` |
+| 2026-04-29 | Claude | **CI Path filter docs-only skip live** — `paths-ignore` trong on:push lookup `docs/**`/`**/*.md`/`.claude/skills/**`/`.gitignore`. Commit chỉ touch docs SKIP CI hoàn toàn (saving ~196s/commit, ~30% commit thuộc loại này). Verify `512880c` (docs-only) → Gitea NO trigger run #113. | `29eb5d9` · `a21790d` · `512880c` |
+| 2026-04-29 | Claude | **CI manual checkout bypass github.com (fix #108/#109)** — Run #108/#109 fail TCP timeout 21s khi act_runner fetch `actions/checkout@v4` từ github.com. Replace `uses: actions/checkout@v4` + `actions/upload-artifact@v4` bằng manual `git init` + `git fetch` từ Gitea internal. Token `${{ github.token }}` auth tự sẵn per-job. Fetch by ref + depth=30. Run #110 pass 3m16s. | `14b7d18` · `26075c4` |
+| 2026-04-29 | Claude | **Tests Phase 2 — Code generator format + sequence (SQLite in-memory)** — `tests/SolutionErp.Infrastructure.Tests/` xUnit + EF SQLite 10. `SqliteDbFixture` + `TestApplicationDbContext` subclass override `nvarchar(max) → TEXT` (SQLite không support `max`). 17 test: ContractCodeGenerator (format RG-001 5 type + Framework year scope vs Project scope + sequence per prefix + year boundary reset + persistence verify) + PurchaseEvaluationCodeGenerator (format A/B + 3-digit pad + independent A/B sequences + year boundary). CI gate +1 step. Total 71 test pass / 2.1s. | `df5988b` |
+| 2026-04-29 | Claude | **Tests Phase 1 — Domain unit tests + CI gate** — `tests/SolutionErp.Domain.Tests/` xUnit 2.9 + FluentAssertions 7.2 (pin trước v8 commercial). 54 test pure function (no DB/IO): WorkflowPolicy (Standard 9-phase + SkipCcm 7-phase + Registry per ContractType + FromDefinition versioned + UserKindApprover) / PEPolicy (NccOnly 3-step + NccWithPlan 5-step + reject paths) / BudgetPolicy (Default 3-step + terminals + SLA spec). `.gitea/workflows/deploy.yml` thêm step "Run unit tests" trước build, fail → `exit $LASTEXITCODE` → no deploy. SolutionErp.slnx + folder `/tests/`. | `d3f9346` |
+| 2026-04-29 | Claude | **PE Workflow designer admin UI + Ý kiến 4 phòng ban** — Migration 15 `AddPurchaseEvaluationDepartmentOpinions` (UNIQUE PEId+Kind, 1 row/phòng/phiếu). Domain `PurchaseEvaluationDepartmentOpinion` + enum `PeDepartmentKind` (PheDuyet/Ccm/MuaHang/SmPm). BE: `PeWorkflowAdminFeatures.cs` ~250 LOC mirror Contract pattern (GetOverview + Create version, deactivate cũ atomic) + `PeWorkflowsController` 2 endpoint reuse policy `Workflows.*`. `PeDepartmentOpinionFeatures.cs` Upsert (sign=true→set SignedAt+UserId, sign=false giữ chữ ký cũ) + Delete + 2 endpoint. FE: `PeWorkflowsPage.tsx` ~500 LOC + designer dialog (clone version + add/remove steps + +Role/+User approvers). Section "5. Ý kiến 4 phòng ban (sign-off)" 2x2 grid OpinionBox (read mode chữ ký vs edit textarea + 2 button Lưu/Lưu&Ký). | `5d94bb4` |
+| 2026-04-29 | Claude | **PE Detail UI restructure theo spec form PHIẾU TRÌNH KÝ** — 4 section đánh số match form chính thức: "1. Thông tin gói thầu" (a/b chỉ Tên + Dự án) / "2. Chọn NCC/TP" (a NCC chọn / b Ngân sách / c Giá chào thầu auto-compute từ winner quotes / d Bản so sánh embed GeneralAttachments) / "3. NCC/TP tham gia" / "4. Hạng mục + Báo giá". FormRow helper (label 176px + value flex) thay cho dl grid 2-col cũ. | `7e36241` |
+| 2026-04-29 | Claude | **PE/Contract → Budget integration + cột "So với ngân sách"** — BE: `BudgetSummaryDto` shared (PE & Contract DetailBundle), Create/Update PE+Contract commands + `BudgetId?` validate cùng Project + Phase=DaDuyet. `CreateContractFromEvaluation` carry forward pe.BudgetId → contract.BudgetId. FE: PE & Contract Create form + Select "Ngân sách" filter Phase=DaDuyet + Project match. PE InfoTab + Contract Edit display Budget link clickable. PE ItemsTab matrix + cột "NS link · Δ" — match per-row qua key `groupCode\|itemCode`, fetch /budgets/{id} riêng + footer aggregate (xanh dưới / đỏ vượt / xám khớp). | `61e5d4d` |
+| 2026-04-29 | Claude | **Budget FE 3-panel pages cả 2 app** — `types/budget.ts` (BudgetPhase 5-state enum + DTO) + `BudgetsListPage` 3-panel `[340px_1fr_360px]` + filter Phase + Năm + alias `?phase=Pending` + readOnly mode menu Duyệt + `BudgetCreatePage` form Header + `BudgetDetailTabs` flat (Section Thông tin Header + Section Hạng mục table CRUD inline auto-compute ThanhTien=KL×ĐG) + `BudgetWorkflowPanel` Panel 3 timeline + dialog comment + Approvals/Changelog. Mirror fe-user. App.tsx 3 route + Layout resolver `Bg_*`. TS build pass cả 2 app. | `df12fb1` |
+
+
+> **51 row Phase 0-7 (2026-04-21..28) đã archive →** [`changelog/recently-done-archive-2026-04.md`](changelog/recently-done-archive-2026-04.md)
+
+Session logs: [P0](changelog/sessions/2026-04-21-1045-phase0-scaffold.md) · [P1f](changelog/sessions/2026-04-21-1100-phase1-foundation.md) · [P1.2](changelog/sessions/2026-04-21-1130-phase1-cruds-permission.md) · [P2](changelog/sessions/2026-04-21-1200-phase2-form-engine.md) · [P3](changelog/sessions/2026-04-21-1330-phase3-workflow.md) · [P4](changelog/sessions/2026-04-21-1430-phase4-report.md) · [P5prep](changelog/sessions/2026-04-21-1530-phase5-prep.md) · [Tier 3](changelog/sessions/2026-04-22-0300-tier3-feature-complete.md) · [Skill gov](changelog/sessions/2026-04-23-0900-skill-governance.md) · [Toolkit+4-bảng+Roles VN](changelog/sessions/2026-04-23-1500-toolkit-data-roles.md) · [Roles+Demo+Pending](changelog/sessions/2026-04-23-2200-roles-demo-pending-cleanup.md) · [PE polish iter 2 + rebrand](changelog/sessions/2026-04-24-chot-session-3-pe-polish.md) · [Budget BE + 14 Solutions users](changelog/sessions/2026-04-28-chot-session-4-budget.md) · [Budget FE + PE/HD-Budget + PE WF Designer + Tests Phase 1-2](changelog/sessions/2026-04-29-chot-session-5-budget-fe-pe-tests.md) · [Drastic refactor flat workflow Mig 21](changelog/sessions/2026-05-08-0500-drastic-refactor-flat-workflow.md) · [PE V2 schema end-to-end Mig 22-24](changelog/sessions/2026-05-08-1100-pe-workflow-v2-end-to-end.md) · [**S18 PE V2 polish + Clone B + Mig 25 IsUserSelectable**](changelog/sessions/2026-05-08-1945-s18-pe-v2-polish-clone-b.md)
+
+**Docs entry points:**
+
+- [`rules.md`](rules.md) · [`architecture.md`](architecture.md) · [`HANDOFF.md`](HANDOFF.md)
+- [`workflow-contract.md`](workflow-contract.md) · [`forms-spec.md`](forms-spec.md)
+- [`database/database-guide.md`](database/database-guide.md) · [`database/schema-diagram.md`](database/schema-diagram.md)
+- [`flows/`](flows/) (7 file) · [`guides/`](guides/) (4 file) · [`gotchas.md`](gotchas.md)
+- [`changelog/migration-todos.md`](changelog/migration-todos.md) · [`changelog/sessions/`](changelog/sessions/) (17 file)
+- [`.claude/skills/README.md`](../.claude/skills/README.md) — 6 skill (3 domain + 3 ops) · audit định kỳ 1/tháng (cron `solution-erp-skill-audit-monthly` next 2026-05-01)
+
+## 🎯 Next up
+
+### Hard blockers (chờ user / ops)
+
+- [ ] **UAT 1 tuần 2-3 user thật** — hard requirement từ roadmap Phase 5
+- [ ] **Email outbox** — MailKit + SMTP (BLOCKED chờ user cấp SMTP host/user/pass)
+- [ ] **Rotate credentials** — SA, vrapp, JWT secret, runner token (đã post chat)
+- [ ] **SQL backup daily** — Task Scheduler (script `scripts/backup-sql.ps1` đã có, chưa schedule)
+
+### Optional polish (khi rảnh / UAT phát sinh)
+
+- [ ] Roles CRUD — admin tạo custom role ngoài 12 hardcoded (schema sẵn, chỉ cần CQRS + FE)
+- [ ] User-level approver targeting runtime — data model đã có (`WorkflowStepApprover.Kind=User`), chỉ cần wire User-kind vào `ContractWorkflowService.TransitionAsync` guard
+- [ ] PermissionsPage: grant `Workflows.Read` cho non-admin role → menu Wf_* visible
+- [ ] Warning notification khi còn 20% SLA (`SlaWarningSent` flag đã có, chỉ thiếu job emit)
+- [ ] E2E test reject → quay về DangSoanThao (multi-role)
+- [ ] Dependencies scan CI (`dotnet list package --vulnerable`, `npm audit`)
+
+### Tier 3 ERP roadmap ✓ (close)
+
+- [x] Attachment upload BE + FE ✓
+- [x] SignalR real-time push ✓
+- [x] Form template builder CRUD + DynamicForm ✓
+- [x] PDF export qua LibreOffice headless ✓
+- [x] .doc/.xls → .docx/.xlsx auto-conversion ✓
+- [x] Dynamic workflow policy per ContractType ✓
+- [x] **Versioned workflow (WorkflowDefinition pinned per Contract)** ✓
+- [x] **Admin workflow designer UI (per-type, per-step approvers)** ✓
+- [x] **Nested sidebar menu per ContractType (fe-user) + menu split admin/user** ✓
+- [x] **PermissionsPage 3-panel layout** ✓
+- [ ] Email outbox for Notification (blocked — SMTP config)
+
+## 📊 Thông số cumulative
+
+| | P0 | P1f | P1.2 | P2 | P3 | P4 | P5prep | Tier3 | +Toolkit | +RolesPg+Demo | +PE module | +PE polish | +Budget+30 users | **+Session 5** |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| BE LOC | 0 | ~400 | ~1500 | ~1900 | ~2700 | ~3100 | ~3300 | ~4800 | ~7800 | ~8800 | ~11100 | ~11400 | ~11750 | **~13050** (+1300 PE WF Designer + Opinion + Budget integration) |
+| DB tables | 0 | 7 | 12 | 14 | 19 | 19 | 19 | 24 | 36 | 36 | 46 | 47 | 51 | **52** (+1 PEDepartmentOpinions) |
+| API endpoints | 0 | 4 | 20 | 23 | 31 | 33 | 35 | ~50 | ~80 | ~93 | ~110 | ~113 | ~124 | **~128** (+2 PE WF + 2 Opinion) |
+| Migrations | 0 | 1 | 3 | 4 | 5 | 5 | 5 | 8 | 11 | 11 | 12 | 13 | 14 | **15** (`AddPEDepartmentOpinions`) |
+| FE pages | 0 | 2 | 6 | 7 | 14 | 16 | 16 | ~20 | ~22 | ~23 | ~26 | ~26 | ~26 | **~31** (+5 Budget × 2 app + PeWorkflowsPage) |
+| FE components | — | — | — | — | — | — | — | many | many+ | +EditRowDialog | +PE 5-tab | +Compare section | — | **+Budget tabs/panel + PE OpinionBox + PE 4-section restructure** |
+| Scripts PS | 0 | 0 | 0 | 1 | 1 | 1 | 3 | 4 | 4 | 5 | 5 | 6 | 6 | 6 |
+| CI/CD workflow | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | **1+test gate+path filter+manual checkout** |
+| **Tests** | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | **77** (54 Domain + 17 Infra + 6 PE WF Application) |
+| Docs | 10 | 13 | 14 | 24 | 26 | 30 | 35 | ~40 | ~42 | ~44 | ~46 | ~48 | ~50 | **~52** (+session log + Test plan) |
+| Demo data | 0 | 0 | empty | 0 | 0 | 0 | 0 | 0 | 5+3 | 15+8+7+13+4 | +PE 4 phiếu | +rebrand email | 30 user | 30 user |
+| Commits | 1 | 2 | 3 | 5 | 6 | 7 | 8 | ~25 | ~47 | ~52 | ~63 | ~70 | ~75 | **~82** (+6 session 5) |
+
+## 🚨 Blockers / risks
+
+- ⚠️ **Email SMTP chưa có** — blocker cho notification outbound
+- ⚠️ **UAT real user chưa chạy** — risk phát sinh bug edge-case quan trọng
+- ⚠️ **Credentials leaked trong chat** — cần rotate trước go-live thật
+- ⚠️ **SQL backup không auto** — risk data loss nếu VPS crash
+- ⚠️ **Permission `Workflows.Read` cho non-admin** — cần grant để họ thấy menu Wf_* (hiện chỉ admin thấy)
+- ⚠️ **User-kind approver chưa enable runtime** — designer cho chọn User nhưng guard fall back DeptManager
+
+## Credentials + URLs
+
+```
+admin@solutionerp.local / Admin@123456
+```
+
+- API prod: https://api.solutions.com.vn — Health `/health/live` + `/health/ready`
+- API dev: http://localhost:5443 — Swagger `/swagger`
+- Admin FE prod: https://admin.solutions.com.vn · dev `http://localhost:8082`
+- User FE prod: https://eoffice.solutions.com.vn · dev `http://localhost:8080`
+- SQL prod: `.\SQLEXPRESS` / `SolutionErp` / `vrapp`
+- SQL dev: `(localdb)\MSSQLLocalDB` / `SolutionErp_Dev`