[CLAUDE] Docs: chốt session 9+ housekeeping log + STATUS+HANDOFF+migration-todos update

Session log mới `2026-05-04-1900-chot-session-9-plus-housekeeping.md`:
chốt 4 commit Session 9+ post-Session-9 (Audit 2026-05 + Inbox PE +
Housekeeping docs + User Manual 7 file rewrite). Full narrative
+ context + lessons + stats + cảnh báo session 10+.

STATUS Recently Done +1 row mới (User Manual rewrite 16c2c9c) +
Phase header refresh "Session 9+ chốt" + "7 file User Manual ~86 KB
compact end-user style".

HANDOFF Housekeeping section +1 mục User Manual rewrite + thêm note
"User Manual style rule mới chốt session này": phân biệt với §6.5
(end-user docs vs dev docs).

migration-todos thêm section "Session 9+ housekeeping done" với 3
task tick (audit + Inbox PE + User Manual).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

docs/HANDOFF.md

@@ -1,14 +1,17 @@
 # HANDOFF — Brief 5 phút cho session tiếp theo
 
-**Last updated:** 2026-05-04 (Session 9 + housekeeping — **Audit 2026-05 combined skill+doc drift + fe-user Inbox PE section. 83 test pass. Cron audit kế 2026-06-01 manual trigger.**)
+**Last updated:** 2026-05-04 (Session 9+ chốt — **Chunk E-bis + Audit 2026-05 + Inbox PE + User Manual 7 file rewrite. 83 test pass. 10 commit pushed. Phase 9 còn lại = Hard blockers chờ user.**)
 
 ## 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:

docs/STATUS.md

@@ -2,9 +2,9 @@
 
 > **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-04 (Session 9 — **Chunk E-bis complete: FE 2-stage panel cả 3 module + bypass toggle + HĐ/Budget 2-stage mirror PE + 6 test 2-stage + IdentityFixture helper.**)
+**Last updated:** 2026-05-04 (Session 9+ chốt — **Chunk E-bis + Audit 2026-05 + Inbox PE section + User Manual 7 file rewrite. 83 test pass. 10 commit pushed.**)
 
-## 📍 Phase hiện tại: **Phase 9 active — UAT** — **55 DB tables, 16 migrations, ~133 API endpoints (+2 List dept-approvals HĐ/Budget), 31 FE pages (3 panel update 2-stage). 83 unit test pass** (54 Domain + 29 Infra: 17 codegen + 6 PE WF + 6 2-stage). 41 gotcha. 30 demo user. 6 skill.
+## 📍 Phase hiện tại: **Phase 9 active — UAT** — **55 DB tables, 16 migrations, ~133 API endpoints (+2 List dept-approvals HĐ/Budget), 31 FE pages (3 panel update 2-stage + Inbox 2 section). 83 unit test pass** (54 Domain + 29 Infra: 17 codegen + 6 PE WF + 6 2-stage). 41 gotcha. 30 demo user. 6 skill. **7 file User Manual** (~86 KB compact end-user style).
 
 ### 🌐 Production URLs
 
@@ -61,6 +61,7 @@
 
 | Ngày | Ai | Task | Commit |
 |---|---|---|---|
+| 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) |

docs/changelog/migration-todos.md

@@ -213,6 +213,12 @@ Session log: `2026-05-04-1230-chot-session-8-2-stage-dept-approval.md`.
 - [x] **Rule mới rules.md §6.4** — Audit + compact MD định kỳ (cadence + checklist + anti-pattern)
 - [x] **rules.md §9.4** — Mở rộng skill audit cross-ref §6.4
 
+### ✅ Session 9+ housekeeping done (2026-05-04 — sau Session 9 close)
+
+- [x] **Audit định kỳ 2026-05** — combined skill + doc drift (commit `7dc0233`). Log `skill-audit-2026-05.md`.
+- [x] **Optional polish — fe-user Inbox PE section** (commit `332a90f`). HĐ + PE 2 section trong InboxPage.
+- [x] **User Manual 7 file rewrite compact** (commit `16c2c9c`). End-user style: bỏ field/error tables, giữ numbered steps đơn giản. ~86 KB total.
+
 ### A. Hard blockers (chờ user / ops)
 
 - [ ] UAT thật 1 tuần với 2-3 user (30 demo: 16 sample + 14 Solutions thật)

docs/changelog/sessions/2026-05-04-1900-chot-session-9-plus-housekeeping.md

@@ -0,0 +1,237 @@
+# Session log — 2026-05-04 chốt session 9+ housekeeping
+
+**Topic:** Sau khi Session 9 close Chunk E-bis (xem `2026-05-04-1700-chot-session-9-chunk-e-bis-complete.md`), user yêu cầu "Tiếp tục công việc Plan tổng" + sau đó "làm lại file hướng dẫn Word cho end-user". Session 9+ là phần housekeeping post-session: 4 commit độc lập sau khi Session 9 đã chốt chính thức.
+
+**Dev:** Claude (Opus 4.7) + user (pqhuy1987@gmail.com)
+**Duration:** ~2 giờ (audit ~30 phút + Inbox PE ~20 phút + housekeeping docs ~10 phút + User Manual rewrite ~45 phút + chốt session ~15 phút).
+**Base commit:** `d206e14` (chốt session 8 ending) → đã commit qua Session 9 (E2-E7) + 4 commit Session 9+.
+
+## Context
+
+User chỉ thị "tiếp tục plan tổng" sau Session 9 close. Plan tổng remaining có:
+- Hard blockers (UAT/SMTP/rotate creds/SQL backup/...) — BLOCKED chờ user input
+- Optional polish (5 task) — "khi UAT phát sinh"
+- Tests Phase 3-5 — "khi bug recurring" / investment cao
+- Audit định kỳ 2026-05-01 — đã quá hạn 4 ngày
+- Cron `solution-erp-skill-audit-monthly` recreate
+
+→ Pick task realistic + actionable: Audit định kỳ (đã đến cadence), sau đó Inbox PE polish (low-risk, không cần UAT), sau đó housekeeping docs.
+
+User feedback giữa session: "cái file hướng dẫn word thì chỉ cần các bước thực hiện đơn giản của các chức năng thôi nhé, ko cần quá đầy đủ chi tiết, cho end-user họ làm" → trigger task User Manual rewrite (4 task housekeeping).
+
+## Commits Session 9+
+
+4 commit:
+
+- `7dc0233` — Audit định kỳ 2026-05 (combined skill + doc drift theo §6.4 + §9.4)
+- `332a90f` — fe-user Inbox PE section (Optional polish HANDOFF §C)
+- `bdd175c` — Docs housekeeping (STATUS+HANDOFF+migration-todos reflect 2 task done)
+- `16c2c9c` — User Manual 7 file rewrite compact cho end-user
+
+## Task A — Audit định kỳ 2026-05 (commit 7dc0233)
+
+**Bối cảnh:** Cron `solution-erp-skill-audit-monthly` empty (`No scheduled jobs`), trễ 4 ngày so với schedule 2026-05-01. Manual trigger sau Session 9 close.
+
+**Phase 1 — Cross-check counts:**
+- tests=83 ✅ (Domain 54 + Infra 29)
+- migrations=16 ✅
+- gotchas=41 ✅
+- skills=6 ✅
+- STATUS Recently Done rows=12 (<30 chưa cần archive) ✅
+
+**Drift patches 5 file:**
+- `docs/CLAUDE.md:70` — `52 bảng → 55 bảng (+§14 DepartmentApprovals Mig 16)`
+- `docs/rules.md:368` — `Phase 8 active — 77 test → Phase 9 — 83 test`
+- `docs/architecture.md:329, 365` — `77 test → 83 test` (2 chỗ)
+- `.claude/skills/ef-core-migration/SKILL.md:52` — `77 → 83 + ghi 6 PE 2-stage S9`
+- `.claude/skills/dependency-audit-erp/SKILL.md:153` — `26+ → 41 bẫy`
+
+**Phase 2 — Skill content patch:**
+- `contract-workflow/SKILL.md` — thêm "Phase 9 cross-ref Mig 16" block + section "Phase 9 done" (2-stage + smart reject + lock edit + bypass)
+
+**KEEP per §6.5:**
+- `docs/rules.md:328` "52 bảng" example minh họa rule §6.5 — KHÔNG drift
+- `docs/changelog/migration-todos.md:152, 196` "77 test" — historical session record (Phase 8 / Session 8 verify)
+- 9 session log mention 77/52 — TẤT CẢ snapshot lịch sử
+
+**Phase 3 — Feature gap audit:**
+- 2-stage dept approval Mig 16 cross 3 module — **KHÔNG tạo skill mới** (§9.5 anti-pattern "viết skill chỉ để có thêm" — pattern đủ generic, đã ghi đủ Domain/Service/6 test reusable)
+- Cross-ref vào `contract-workflow` SKILL đủ
+
+**Cron limitation phát hiện:** Claude SDK `CronCreate` auto-expire 7 days → KHÔNG fit monthly cadence. Skip recreate cron technical, note manual trigger.
+
+**Audit log:** `docs/changelog/skill-audit-2026-05.md` (1 page max per cadence). 6 file ~+30/~12 lines patch, validation §6.5 OK.
+
+## Task B — fe-user Inbox PE section (commit 332a90f)
+
+**Bối cảnh:** Optional polish item từ HANDOFF §C "fe-user Inbox thêm section Phiếu Duyệt NCC chờ tôi". Drafter + TPB vào Inbox sẽ thấy cả HĐ + PE pending thay vì phải vào /purchase-evaluations riêng.
+
+**Changes:**
+- `useQuery` thứ 2 cho `/purchase-evaluations/inbox` (endpoint đã sẵn từ Phase 6)
+- `peRows` filter theo search query (mã / tên gói thầu / project)
+- 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ờ"
+
+**Note:** chỉ fe-user (Drafter + TPB dùng Inbox). fe-admin có `/system/inbox` riêng — defer.
+
+**Verify:** Build pass + CI #117 success.
+
+## Task C — Docs housekeeping (commit bdd175c)
+
+Reflect 2 task vừa làm vào MD chính:
+- STATUS Recently Done +2 row mới (audit + Inbox PE)
+- STATUS Section F audit định kỳ tick `2026-05-01` done + ghi cron limitation
+- HANDOFF +section "Housekeeping today" tóm tắt 2 commit
+- migration-todos Phase 9 §C tick "fe-user Inbox PE section" done
+
+Docs-only commit → paths-ignore skip CI.
+
+## Task D — User Manual 7 file rewrite (commit 16c2c9c)
+
+**User feedback:** "cái file hướng dẫn word thì chỉ cần các bước thực hiện đơn giản của các chức năng thôi nhé, ko cần quá đầy đủ chi tiết, cho end-user họ làm".
+
+**Bối cảnh:** 7 file user manual đã có từ trước Session 9 (chưa từng commit, untracked). File cũ rất chi tiết với:
+- Bảng field validation 5 cột (Tên field/Kiểu/Bắt buộc/Validation/Ví dụ)
+- Bảng error troubleshoot 3 cột (Lỗi/Nguyên nhân/Cách xử lý)
+- FAQ chi tiết 8 câu hỏi
+- Bảng phím tắt
+- Mock screenshot placeholder
+
+→ Quá overkill cho audience end-user (Drafter, TPB, BOD, NV không tech).
+
+**Setup:**
+- `package.json` mới với `docx@9.5.0` dependency + script `npm run gen:all`
+- `npm install` trong `docs/_user-guide/` (22 packages)
+- Refactor `_gen-user-01.js` từ 793 dòng (helpers inline) xuống ~110 dòng (dùng `_helpers.js` shared như 6 file khác)
+
+**Style mới (BỎ):**
+- Bảng field validation 5 cột (`fieldTable` helper)
+- Bảng error troubleshoot 3 cột (`errorTable` helper)
+- FAQ chi tiết 8 câu (giữ 1 chương "Khi gặp lỗi" 4-5 bullet)
+- Bảng phím tắt
+- Mock screenshot placeholder thừa
+
+**Style mới (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 / Warning / Tip chỉ khi critical
+- Bullet list cho liệt kê (vd 7 loại HĐ, 9 phase)
+
+**7 file output:**
+
+| File | Chương | Nội dung cốt lõi |
+|---|---|---|
+| 01-Bat-dau (12.1KB) | 9 chương | Mở hệ thống / Đăng nhập / Đổi pwd lần đầu / Hồ sơ / Dashboard / Sidebar 3 cấp / Chuông notification / Đăng xuất / Khi gặp lỗi |
+| 02-Hop-dong (12.4KB) | 10 chương | 7 loại HĐ liệt kê / Inbox vs My Contracts / Tạo HĐ / Chi tiết / Sửa nháp / Trình duyệt / Đính kèm / Comment / Xóa nháp / Tìm + Filter |
+| 03-Duyet-Workflow (12.2KB) | 10 chương | 9 phase / Inbox / Duyệt 1 HĐ / **2-stage NV-TPB Mig 16** / Reject / Resume jump-back / Comment / SLA / Lịch sử / Quy tắc đặc biệt |
+| 04-PE-Phieu-Duyet-NCC (12.4KB) | 10 chương | Tạo phiếu A/B / Thêm NCC / Hạng mục + báo giá / Đính kèm / Chọn winner / Ý kiến 4PB / Trình duyệt / Tạo HĐ từ phiếu / Sửa-xóa |
+| 05-Budget-Ngan-sach (12.0KB) | 9 chương | Tạo NS / Hạng mục / Sửa / Trình duyệt 3-step / Liên kết HĐ-PE / Cột Δ / Changelog / Xóa |
+| 06-7-Loai-HD-Cheatsheet (12.8KB) | 7 cheatsheet + Mẹo chung | Mỗi loại 1 page: use case + bypass CCM? + field đặc thù + format mã |
+| admin-02-Quan-ly-Users-Roles (12.7KB) | 12 chương | Tạo user / Sửa / Roles / Reset pwd / Lock-Unlock / Active / **Bypass Review S9** / Search / Roles page / Permissions matrix |
+
+**Tổng:** ~86 KB / 7 file (cũ ~123 KB ↓30%).
+
+**Note:** ContractType label "Phương án" → "Giải pháp" (đã rebrand session 3) đã reflect đúng. 2-stage dept approval mention ở Phần 03 + admin-02.
+
+**Lần sau sửa nội dung:**
+```bash
+cd docs/_user-guide
+# Edit _gen-*.js
+npm run gen:all
+# Output 7 file docx ở user/ + admin/
+```
+
+## Verify
+
+```
+✓ Build pass mỗi commit (BE + 2 FE)
+✓ 83 unit test pass cuối session (54 Domain + 29 Infra)
+   - Trước Session 9: 77 (54 + 17 + 6)
+   - Sau Session 9: 83 (+6 PE 2-stage)
+   - Sau Session 9+: 83 (không test mới Session 9+)
+✓ CI #117 success cho commit 332a90f (Inbox PE)
+✓ 3 commit còn lại (audit + housekeeping + User Manual) docs-only → paths-ignore skip CI đúng
+✓ All 10 commit Session 9 + Session 9+ pushed lên Gitea
+```
+
+## Files touched Session 9+ (4 commit)
+
+```
+.claude/skills/contract-workflow/SKILL.md                       (Audit refresh — Phase 9 cross-ref)
+.claude/skills/dependency-audit-erp/SKILL.md                    (Audit drift — 26→41 bẫy)
+.claude/skills/ef-core-migration/SKILL.md                       (Audit drift — 77→83 test)
+docs/CLAUDE.md                                                  (Audit drift — 52→55 bảng)
+docs/rules.md                                                   (Audit drift — Phase 8→9, 77→83)
+docs/architecture.md                                            (Audit drift — 77→83 test)
+
+docs/changelog/skill-audit-2026-05.md                           (NEW — audit log)
+docs/STATUS.md                                                  (Recently Done +3 row + Phase header)
+docs/HANDOFF.md                                                 (TL;DR + Housekeeping section)
+docs/changelog/migration-todos.md                               (Phase 9 §C tick + Session 9+ section)
+
+fe-user/src/pages/InboxPage.tsx                                 (Inbox PE section)
+
+docs/_user-guide/package.json                                   (NEW)
+docs/_user-guide/package-lock.json                              (NEW)
+docs/_user-guide/_gen-user-01.js                                (Rewrite compact)
+docs/_user-guide/_gen-user-02.js                                (Rewrite compact)
+docs/_user-guide/_gen-user-03.js                                (Rewrite compact + 2-stage section)
+docs/_user-guide/_gen-user-04.js                                (Rewrite compact)
+docs/_user-guide/_gen-user-05.js                                (Rewrite compact)
+docs/_user-guide/_gen-user-06.js                                (Rewrite cheatsheet)
+docs/_user-guide/_gen-admin-02.js                               (Rewrite compact + bypass section)
+docs/_user-guide/_helpers.js                                    (Existing — không sửa)
+docs/_user-guide/user/01-Bat-dau.docx                           (Regen 12.1 KB)
+docs/_user-guide/user/02-Hop-dong.docx                          (Regen 12.4 KB)
+docs/_user-guide/user/03-Duyet-Workflow.docx                    (Regen 12.2 KB)
+docs/_user-guide/user/04-PE-Phieu-Duyet-NCC.docx                (Regen 12.4 KB)
+docs/_user-guide/user/05-Budget-Ngan-sach.docx                  (Regen 12.0 KB)
+docs/_user-guide/user/06-7-Loai-HD-Cheatsheet.docx              (Regen 12.8 KB)
+docs/_user-guide/admin/02-Quan-ly-Users-Roles.docx              (Regen 12.7 KB)
+
+docs/changelog/sessions/2026-05-04-1900-chot-session-9-plus-housekeeping.md   (NEW — file này)
+```
+
+## Lessons learned (Session 9+)
+
+1. **Audit định kỳ pattern hoạt động** — 4 ngày trễ chấp nhận được, drift nhỏ (1 file CLAUDE.md count + 5 spot 77→83). Nếu trễ 1 tháng có thể drift lớn hơn nhiều. Patch 6 file qua targeted Edit chứ KHÔNG rewrite, validation §6.5 pass.
+
+2. **Cron Claude SDK auto-expire 7d** mismatch với monthly cadence — phát hiện khi định recreate cron audit. Workaround: manual trigger / OS Task Scheduler. Note vào HANDOFF + memory để session sau biết.
+
+3. **End-user docs khác dev docs** — feedback "ko cần quá đầy đủ chi tiết, cho end-user họ làm" → bỏ field/error tables (overkill cho audience non-tech). Phân biệt với rule §6.5 (KHÔNG cắt narrative — đó cho dev đọc rationale). Memory entry mới ghi rule này.
+
+4. **Refactor file 01 user manual** — file 01 (793 dòng) định nghĩa helpers inline, 6 file khác dùng `_helpers.js` shared. Khi rewrite, gộp tất cả về pattern shared → dòng giảm ~85% (793 → 110). Maintainable hơn.
+
+5. **Per-task commit + push từng cái** — pattern Session 8/9 vẫn hiệu quả: 4 commit nhỏ độc lập, có thể rollback granular. CI #117 chỉ trigger 1 lần (commit code Inbox PE), 3 commit docs skip CI tự nhiên qua paths-ignore.
+
+6. **Plan tổng → check → pick task → execute** workflow user yêu cầu hoạt động — tôi show plan + plan chi tiết task A → execute → check plan + plan task B → execute → ... → khi hết task actionable → đề xuất options A-F user pick.
+
+## Cảnh báo session 10+
+
+1. **UAT live ngay** với anh Kiệt + 2-3 user — feature 2-stage đầy đủ + Inbox 2 section + User Manual 7 file đã in/share được.
+2. **Cron audit kế 2026-06-01** — manual trigger / setup OS Task Scheduler. Đến ngày 1 user có thể nói "audit MD" / "kiểm tra docs" / "định kỳ kiểm tra".
+3. **User Manual cần refresh khi thêm feature mới** — edit `_gen-*.js` → `npm run gen:all`. Tránh sửa file `.docx` trực tiếp (sẽ bị overwrite lần regen sau).
+4. **fe-admin chưa có Inbox** — chỉ fe-user. Nếu admin cần Inbox 2 section (HĐ + PE) → mirror pattern fe-user/InboxPage.tsx.
+5. **Hard blockers vẫn pending** — UAT/SMTP/rotate creds/SQL backup/remove `.huypham.vn`/win-acme. Tất cả cần user input.
+6. **Tests Phase 5 FE Vitest** skipped Session 9+ vì cần extract `queryMatches`/`fmtMoney` ra `lib/` trước (refactor + test combo > 1h, vi phạm "quick win").
+
+## Stats sau Session 9+
+
+| | Trước S9 | Sau S9 | Sau S9+ |
+|---|---:|---:|---:|
+| BE LOC | ~13750 | ~14400 | ~14400 (Inbox FE only) |
+| DB tables | 55 | 55 | 55 |
+| Migrations | 16 | 16 | 16 |
+| API endpoints | ~131 | ~133 | ~133 |
+| FE pages | ~31 | ~31 | ~31 (Inbox 2 section + 1 col Bypass UsersPage) |
+| Tests | 77 | 83 | 83 |
+| Test fixtures | SqliteDbFixture | + IdentityFixture | (+ IdentityFixture reusable) |
+| Gotchas | 41 | 41 | 41 |
+| Demo user | 30 | 30 | 30 |
+| Skills | 6 | 6 (3 refresh) | 6 (1 thêm refresh contract-workflow Phase 9) |
+| Commits S9+ | 0 | 6 (E2-E7) | **10** (+4 housekeeping) |
+| Session log | 19 | 20 | **21** |
+| User Manual files | (existing untracked) | (existing untracked) | **7 commit + compact ~86 KB** |