solution-erp/docs/changelog/sessions/2026-05-07-2600-tooltip-defer-drastic.md

Session 2026-05-07 (S15) — Tooltip diagnose "Lưu & Gửi Duyệt" + drastic refactor DEFER

Dev: Claude Duration: ~1h Base commit: 7c83ac8 (sau Session 14 wrap-up docs) Final commit: 835cc7f (+ working tree refactor revert) Total commits: 1

Bối cảnh

User UAT live screenshot phiếu PE Bản nháp "huy test 1" (PE/2026/A/004) trên eoffice.solutions.com.vn/purchase-evaluations/workspace?type=1&id=.... Báo button "Lưu & Gửi Duyệt" KHÔNG hoạt động + suy đoán "Hình nó đang bị trùng ID với thằng khác? Mỗi lần tạo mới Phiếu Duyệt NCC là 1 phiếu độc lập nhé".

Phần 1 — Diagnose tooltip (commit 835cc7f)

Root cause analysis

PeDetailTabs.tsx line 220: disabled={!canSubmitForApproval || submitForApproval.isPending}. Khi canSubmitForApproval=false button visually clickable nhưng không fire onClick → user không biết tại sao silent.

canSubmitForApproval = mode === 'workspace' && canEditPhase && !readOnly && evaluation.workflow.nextPhases.some(p => p !== TuChoi && p !== TraLai).

Hypothesis: phiếu pin WorkflowDefinitionId của 1 version cấu hình thiếu adjacent step → policy.NextPhasesFrom(DangSoanThao) empty (legacy data hoặc admin chưa setup workflow).

Fix UX (PeDetailTabs.tsx, fe-admin + fe-user mirror)

const forwardPhase = evaluation.workflow.nextPhases.find(p =>
  p !== TuChoi && p !== TraLai)
const canSubmitForApproval = mode === 'workspace' && canEditPhase && !readOnly && forwardPhase != null

const submitDisabledReason = !canEditPhase
  ? `Phiếu đã ở phase X — chỉ Bản nháp / Trả lại mới sửa + gửi được.`
  : readOnly
    ? 'Chế độ chỉ đọc.'
    : !forwardPhase
      ? `Workflow không có phase tiếp theo từ X. Liên hệ admin kiểm tra cấu hình quy trình.`
      : null

Button:

• title={submitDisabledReason ?? "Gửi phiếu sang \"<forward phase label>\""} — hover tooltip show reason hoặc forward phase
• Dialog confirm thay text generic "Gửi phiếu vào quy trình duyệt?" → explicit "Sẽ chuyển sang "Chờ Purchasing". Sau khi gửi sẽ KHÔNG sửa được nữa (trừ khi approver Trả lại)."

Mirror fe-admin + fe-user. KHÔNG đụng BE.

Build pass cả 2 app.

"Trùng ID" KHÔNG phải bug FE

PurchaseEvaluationWorkspacePage.tsx URL state đúng:

• + Thêm mới → setParams({ mode: 'new', id: null })
• POST tạo phiếu → BE gen new GUID + MaPhieu mới (atomic SERIALIZABLE qua PurchaseEvaluationCodeGenerator)
• Save → URL set id=<new> thay thế

Mỗi PE row unique GUID + MaPhieu (UNIQUE filtered). Không có path share ID. User suy đoán có thể do button silent disabled → tưởng load lại record cũ.

Phần 2 — Plan drastic refactor flat workflow → DEFER

User chốt drastic refactor: "bỏ phase enum hoàn toàn, dùng ChoDuyet=10 đơn nhất + currentStepIndex tracking".

Spec mới (theo user)

Workflow = list flat (Phòng × Cấp × Users[]). Ví dụ Quy trình A:

• Phòng A (2 cấp): cấp 1 NV A, cấp 2 NV B
• Phòng B (3 cấp): cấp 1 NV C, cấp 2 [NV D 1, D 2, D 3], cấp 3 NV E
• Phòng C (1 cấp): NV C

Rules:

• Phòng 1 cấp → 1 user duyệt = pass phòng đó
• Phòng N cấp → tuần tự cấp 1 → 2 → ... → N
• Cùng cấp + cùng phòng = OR (1 user duyệt = pass cấp)
• Hết tất cả phòng → DaDuyet
• PE pin Quy trình ID, không thay đổi giữa chừng

Plan refactor 6 chunk (theo feedback_per_chunk_commit.md)

Chunk	Scope	Estimate
A	Domain enum + entity changes + Migration 21	50min
B	App CQRS + Policy registry rewrite	45min
C	PE Service rewrite TransitionAsync flat	2-3h
D	Contract Service rewrite + Tests update (drop 12 N-stage tests)	1.5h
E	FE Designer flat UI (PeWorkflowsPage + WorkflowsPage)	1.5h
F	FE PeWorkflowPanel + Docs	1h

Tổng realistic: ~8-10h focused. Vượt session boundary + risk session deep ~30 commits.

Attempt → REVERT

Edit working tree 12 file (Chunk A partial):

• PurchaseEvaluationPhase.cs: + ChoDuyet=10 enum value
• ContractPhase.cs: + ChoDuyet=10
• PurchaseEvaluation.cs: + CurrentWorkflowStepIndex, RejectedAtStepIndex
• Contract.cs: + same 2 fields
• WorkflowDefinition.cs (Contract): drop class WorkflowStepInnerStep + nav, WorkflowStep + DepartmentId, PositionLevel
• PurchaseEvaluationWorkflowDefinition.cs: same pattern
• ContractDepartmentApproval.cs: drop InnerStepId
• PurchaseEvaluationDepartmentApproval.cs: drop InnerStepId
• WorkflowDefinitionConfiguration.cs: drop InnerStep config + add DeptId/PositionLevel cấu hình + FK Restrict
• PurchaseEvaluationConfiguration.cs: same
• DepartmentApprovalsConfiguration.cs: drop InnerStepId FK + filtered indexes, restore simple unique non-filtered
• ApplicationDbContext.cs: drop DbSet<*WorkflowStepInnerStep> × 2

Realize codebase chưa compile (Service + App + Tests dùng WorkflowStepInnerStep đã drop). Need rewrite ALL dependent code trong cùng Chunk A → blow scope vượt session.

Decision REVERT working tree về 835cc7f clean. Tests 96 pass intact.

Memory entry mới

feedback_drastic_refactor_scope.md — decision rule: drastic refactor cần dedicated session với context fresh, scope estimation conservative (2x buffer), tránh mid-session big refactor (risk session context deep + breaking states giữa chunk + tests rewrite biggest risk).

Verify

• ✅ git restore 12 files reverted
• ✅ dotnet test 96 pass (54 + 42) — state intact
• ✅ working tree clean (chỉ 2 untracked .zip backup files)
• ✅ commit 835cc7f (tooltip) pushed gitea OK

Stats cumulative (sau Session 15)

	Trước S15	Sau S15	Diff
BE LOC	~15800	~15800	0 (FE-only commit + revert)
Migrations	20	20	0
DB tables	57	57	0
FE pages	32	32	0
Tests	96	96	0
Docs	~58	~59	+1 (session log này)
Memory entries	11	12	+1 (drastic refactor scope)
Commits S15	—	+1	835cc7f

Plan organization sau Session 15

Plan cha: Phase 9 active — UAT
├── Plan con A-S14: Tất cả ✅ DONE (xem session logs trước)
├── Plan con S15: Tooltip diagnose + drastic refactor DEFER
│   ├── ✅ FE PE button "Lưu & Gửi Duyệt" tooltip + dialog reason rõ
│   └── ⏸ Drastic refactor flat workflow — DEFER session sau (~8-10h)
└── Plan con Defer S16+:
    ├── Drastic refactor flat workflow (Mig 21, ~8-10h, dedicated session)
    │   OR fallback Approach Y (FE flat UI giới hạn 5 phòng, 1-2h)
    ├── Task 2 sample data seed N-stage (block DesignTime vs Runtime DB)
    ├── Budget N-stage (cần migration `AddBudgetVersionedWorkflow`)
    ├── schema-diagram §17-19 Mig 18-20 (defer cron audit 2026-06-01)
    └── Hard blockers Ops (UAT, SMTP, Rotate creds, SQL backup, Remove huypham.vn, win-acme)

Handoff

UAT iteration mode. Phiếu PE Bản nháp giờ có tooltip rõ reason khi không gửi được. User test hover → biết admin cần kiểm tra cấu hình workflow definition.

Drastic refactor pending dedicated session. Khi resume:

1. Fresh session start với context clean
2. Plan kỹ 6 chunk per-commit
3. Buffer 2x estimate (~16h thực tế nếu phát sinh)
4. Test rewrite biggest risk — pattern reusable nhưng nội dung phải mới hoàn toàn

Cron audit kế: 2026-06-01 (~25 ngày).