solution-erp/docs/changelog/sessions/2026-06-19-S77-pe-ux-batch-10-deploy.md

# S77 (2026-06-19) — PE UX batch: 10 deploy prod-verified (anh Kiệt FDC + Tra Sol + Bích Phượng)

> Buổi sản phẩm RẤT LỚN, HMW-mode ON. Anh forward liên-tục chat Zalo từ 3 người dùng (anh Kiệt FDC + chị Trà Sol + Bích Phượng) — loạt tinh-chỉnh module Duyệt NCC (PE) realtime. Em-main điều phối + spawn specialist lẻ + cicd-monitor verify từng deploy. Cuối buổi anh "Xong thì session-end luôn".

## Kết quả tổng

| Chỉ số | Trước | Sau |
|---|---|---|
| Deploy | — | **10** (#320→#329), **10/10 cicd PASS** |
| Migrations | 56 | **57** (`AddPeSuggestedPriceNotes`) |
| Tests | 344 | **354** (+10) |
| Bundle | jOqxW4-p / DbsznVvR | **BqKD3Y23 / Cn-i349D** (Run #329) |
| SQL tables | 88 | 88 (additive cols) |
| Gotchas | 70 | 70 (tái dùng #70) |

## 10 deploy

| # | Commit | Việc | Người yêu cầu |
|---|---|---|---|
| #320 | `8e68ed1` | Cờ GẤP **pill** 🔴 GẤP (PRO) / 🟢 GẤP (CCM) đồng bộ MỌI danh sách + inbox. NEW `PeUrgentChips` ×2 app (single source of truth). Data đã có từ S69 (Mig 53) — chỉ chưa render ở `PeListPanel` + `InboxPage` (chỉ tree-list + detail có). FE-only, 0 BE. | anh Kiệt |
| #321 | `398b01d` | PE **focus mode**: bấm phiếu → overlay full-bleed trượt từ phải, ẩn menu+list, phiếu full-width tự cuộn + panel duyệt. + responsive laptop nhỏ. | anh Kiệt |
| #322 | `3b98845` | **Revert** list về layout gốc (3-panel bám-trái lấp-đầy, KHÔNG canh giữa). Anh: "giữ như cũ" (overlay quá tay). Recover từ FD process-death. | anh |
| #323 | `94e0e12` | **Mig 57** `AddPeSuggestedPriceNotes` (ô ghi chú giá đề xuất PRO/CCM, 2 cột nvarchar(1000)) + **số phân cách VND** (`VndInlineEdit`/`BudgetCell`) + sửa chính tả "Bản"→"Bảng so sánh giá" + **guard #70** stale-echo. | Tra Sol + anh Kiệt |
| #324 | `e42d103` | Số âm → **đỏ + ngoặc** `(5.000.000)` hàng 7/8/9 (đồng bộ hàng "So sánh" đã có `fmtVndSigned`). | Tra Sol |
| #325 | `e29391e` | Mục con **thụt dòng + gạch đầu dòng** (`BudgetRow +indent`) phân biệt mục có-số (1-9, cha) vs không-số (con). | Tra Sol |
| #326 | `b5aa72d` | Cờ gấp authz **BẤT ĐỐI XỨNG**: GẮN = NV chức năng (Procurement/CostControl/Admin) / GỠ = chỉ **Trưởng phòng** (`DeptManager` + role chức năng) hoặc Admin. Handler `SetPurchaseEvaluationUrgent` gate theo `IsUrgent`; FE nút gate theo trạng thái hiện tại. | Tra Sol (clarify giữa-chừng) |
| #327 | `fa6654b` | **Tách chọn-phiếu (inline 3-panel "như cũ") khỏi mở-rộng (overlay)** + nút **"Xem mở rộng"** (`Maximize2`) mỗi dòng. `?expand=1` decouple `?id`: click row=inline (wide) / overlay (narrow); "Xem mở rộng"=id+expand; Thu gọn=bỏ expand giữ id; approve/đóng=về list. | anh (annotate) |
| #328 | `424131d` | **Chuông báo người duyệt** khi phiếu vào cấp họ (submit + mỗi approve-advance). `LogTransitionAsync` +block: `toPhase==ChoDuyet` → resolve current-level approvers (step.Levels Order==CurrentApprovalLevelOrder, exclude actor) → `NotifyManyAsync` Generic "Phiếu cần bạn duyệt". Best-effort, V2-only. BE-only no-mig. | Bích Phượng + Tra Sol |
| #329 | `e823694` | **Banner phiếu Trả lại** ở chế độ Xem (readOnly) hướng dẫn ✏️ Sửa → "Lưu & Gửi Duyệt" (nút submit chỉ hiện khi Sửa). | Bích Phượng |

## Cách chạy (orchestration)

- **em-main** điều phối + tự review diff TRƯỚC mỗi commit + commit/push + chốt scope.
- **frontend-designer ×3** (focus #321 / revert #322 / decouple #327) — FD2 visual loop, nhưng backend `:5443` DOWN cả buổi → stub-verify layout (gotcha #3); live authed verify = post-deploy (anh UAT).
- **implementer-frontend** — pill #320 + notes/separator/spelling #323 (2 app SHA-mirror).
- **implementer-backend ×2** — Mig 57 #323 + approver-notify #328.
- **test-specialist ×3** — suggested-price notes +7 (#323) · urgent authz **symmetric → asymmetric REDO** (#326, do Tra Sol clarify sau khi đã dispatch).
- **cicd-monitor ×10** — verify từng deploy (run + bundle rotate + Mig + smoke); 10/10 PASS.

## Bài học

1. **Review-TRƯỚC-deploy bắt 3 lỗi mà "build PASS" KHÔNG thấy** (đều là runtime, không phải compile):
   - **guard #70 (stale-echo):** ô ghi chú giá đề xuất dùng absolute-set echo từ server-snapshot → lưu giá rồi lưu chú liên-tiếp đè mất. impl-FE bê đúng echo nhưng SÓT `peFetching` guard (đã có ở bảng ngân sách S76). Em-main grep-so-với-budget-pattern → vá.
   - **luật cờ-gấp bất-đối-xứng:** Tra Sol clarify GIỮA-CHỪNG (sau khi em đã dispatch test-specialist cho luật symmetric "TP cho cả gắn+gỡ") → luật cuối = GẮN-NV/GỠ-TP. Em fix BE+FE + REDO test (1 vòng test-specialist thừa). **Lesson: spec đang được người dùng clarify realtime → confirm luật TRƯỚC khi dispatch sub-agent (tránh redo).**
   - **double-mount (Task H):** FD viết comment "render khi chọn && CHƯA mở rộng" nhưng code điều-kiện sót `!isExpand` → inline `PeDetailTabs`/`PeWorkflowPanel` mount SAU overlay khi expand. Intent-comment ≠ implementation → em-main review render-condition + vá.
2. **frontend-designer process-death giữa Task H** (CLI thoát) → in-process state mất, task FAILED. Recovery: tin **disk/git truth** (edit hoàn-chỉnh trên disk + build PASS) — em-main build-verify + mirror fe-admin + commit, KHÔNG re-spawn (agent-kill recovery, `feedback_agent_kill_recovery`).
3. **Batch rapid tweaks:** anh fire tinh-chỉnh liên-tục → em gom build+verify trước, deploy tuần-tự, verify từng cái độc lập (cicd). 10 deploy nhưng mỗi cái isolated → dễ rollback + UAT từng bước. 0 production bug lọt.
4. **Backend-down (gotcha #3):** FD2 visual loop chạy stub layout-shell (backend :5443 down) → layout verify OK nhưng live-data verify defer post-deploy. Build PASS + em-main logic review = đủ tin để deploy; anh UAT confirm.

## §L auto-maintain (light — product session)

- **§L.a error-ledger:** 0 bug-production (3 lỗi bắt PRE-deploy = success của review-gate, không phải bug lọt). Không AS-class hit mới. test-spec REDO = process-inefficiency (clarify-after-dispatch) — ghi lesson, không RCA formal.
- **§L.b:** (a) STATUS Recently Done +S77 ✅ · (c) chore-flag = curate L1 over-cap (archive-gate dry-run: reviewer 45KB/cicd 37.6KB/inv 35.6KB keep-floor-hit manual; FD/test-spec WATCH; **A7 GATE PASS 186/186** integrity OK); sleep-check = last_sleep 2026-06-18 <7d, KHÔNG cần · (d) flush = 5 sub self-flush MEMORY khi return (git-status verified: cicd/FD/impl-BE/impl-FE/test-spec modified) · (e) pending = UAT items + carry logged specifics · (f) harvest = self-flush (KHÔNG dùng run-trace folder session này, toàn Agent-tool spawn lẻ) · (g) tooling-freshness = KHÔNG đổi skill/plugin/roster (toàn product).
- **Infra-adoption:** N/A (no infra/governance adoption — product-only session).

## 🔴 NEXT SESSION

- **Em (carry GẤP):** curate L1 over-cap — reviewer **45KB** + cicd-monitor 37.6KB + inv-codebase 35.6KB (keep-floor-hit → **manual SPLIT/condense** newest large entries, KHÔNG auto-drain; archive integrity A7 PASS — chỉ L1-hot truncate on-inject). FD 26KB / test-spec 27.7KB WATCH strike-1. Làm như op tập-trung (precedent S70/S71).
- **UAT (anh/anh Kiệt/Tra Sol/Bích Phượng):** cờ gấp GỠ chỉ TP · chuông báo người duyệt · banner Trả-lại · "Xem mở rộng" · ô ghi chú PRO/CCM · số phân cách + số-âm-đỏ-ngoặc + indent.
- **Ops giữ S58/S59:** tzutil VPS UTC+7 · anh Chương email typo · 5 real-staff pw · gán CNTT. **Monthly audit 2026-07-01:** re-tier STATUS/HANDOFF (history bloated) · docs/CLAUDE count-flush (Mig 57, test 354) + schema §16+ Mig 32-57.