[CLAUDE] Docs: chốt session 2 — PE skeleton + G-084 + skill audit

User feedback: "phần Duyệt NCC chưa xong đâu đấy nhé, còn chỉnh nhiều" → mark PE module skeleton (not feature-complete), liệt kê chi tiết chức năng/UX/edge-case còn missing cho session tiếp. Update 7 file: - STATUS.md — phase = "PE skeleton + refinement WIP", In Progress liệt kê 4 nhóm: A Chức năng MISSING (9 item), B UX/Polish (6 item), C Edge case (4 item), D Deploy/Ops (1 item). +G-084 row Recently Done. - HANDOFF.md — TL;DR "PE skeleton, còn chỉnh nhiều" + Priority 0 section cho session tiếp (9 task PE refinement) + cảnh báo runner + G-084. - migration-todos.md — Phase 7 checklist (A/B/C/D nhóm) trước Phase 8 post-launch. Pending migrations: PaymentTermFields + DepartmentOpinions + CodeSequences. - architecture.md — Section 9 PurchaseEvaluation module (ERD + workflow A/B + kế thừa HĐ flow). - CLAUDE.md (root) — 5 file đọc đầu (thêm HANDOFF), Modules table, 12 migration 46 bảng, +PurchaseEvaluation commit scope. - .claude/skills/ — 4 skill cross-ref Phase 6: * README: trạng thái updated với Phase 6 note * contract-workflow: note PE workflow tách table riêng * permission-matrix: +Pe_*/PeWf_* menu keys + TODO grant non-admin * ef-core-migration: 12 migration history + Phase 7 pending - docs/changelog/sessions/2026-04-23-2359-chot-session-pe-skeleton.md — session log full commits + MD files updated + session tiếp priorities + notes (PE là skeleton, runner check, G-084 rule, MaPhieu format).
2026-04-23 17:46:41 +07:00
parent 3990066b04
commit 7ca6c914fa
10 changed files with 303 additions and 34 deletions
--- a/.claude/skills/README.md
+++ b/.claude/skills/README.md
@ -8,17 +8,17 @@ Skill này là tài liệu chuyên biệt để Claude (và developer khác) dù

 | Skill | Mục đích | Trigger ví dụ | Trạng thái |
 |---|---|---|---|
-| `contract-workflow` | State machine 9 phase + versioned workflow per ContractType + role × phase guard + SLA + auto-gen mã HĐ RG-001 | "approve contract", "chuyển phase", "versioned workflow", "HĐ cũ giữ cũ" | ✅ Tier 3 updated |
+| `contract-workflow` | State machine 9 phase + versioned workflow per ContractType + role × phase guard + SLA + auto-gen mã HĐ RG-001 | "approve contract", "chuyển phase", "versioned workflow", "HĐ cũ giữ cũ" | ✅ Tier 3 + Phase 6 cross-ref PE workflow |
 | `form-engine` | Render template docx/xlsx + FieldSpec JSON + DynamicForm + PDF export LibreOffice | "export contract as word", "điền form", "render template", "PDF export" | ✅ Active |
-| `permission-matrix` | Role × MenuKey × CRUD + seed + 3-layer resolution + inherit Contracts/Workflows | "permission denied", "gán role", "menu không hiện", "inherit permission" | ✅ Active |
+| `permission-matrix` | Role × MenuKey × CRUD + seed + 3-layer resolution + inherit Contracts/Workflows/PurchaseEvaluations | "permission denied", "gán role", "menu không hiện", "inherit permission" | ✅ Active (Phase 6 +Pe_*/PeWf_*) |

 ### Ops/infra skills (devops + security + schema)

 | Skill | Mục đích | Trigger ví dụ | Trạng thái |
 |---|---|---|---|
 | `dependency-audit-erp` | Scan CVE NuGet + npm 2 FE, respect pin constraint (MediatR 12.4.1, Swashbuckle 6.9.0) | "npm audit", "dotnet vulnerable", "deps scan", "nâng cấp package" | ✅ New Tier 3 |
-| `ef-core-migration` | Tạo/revert EF Core 10 migration, 3-file rule, DesignTimeDbContextFactory, 8 migration history | "thêm migration", "EF migration", "schema update", "snapshot lỗi" | ✅ New Tier 3 |
-| `iis-deploy-runbook` | 3 IIS site + win-acme cert + gitea-runner + LibreOffice + debug 500/502/SignalR prod | "prod 500", "IIS fail", "cert hết hạn", "restart app pool", "deploy IIS" | ✅ New Tier 3 |
+| `ef-core-migration` | Tạo/revert EF Core 10 migration, 3-file rule, DesignTimeDbContextFactory, **12 migration history** (+ Phase 7 pending) | "thêm migration", "EF migration", "schema update", "snapshot lỗi" | ✅ Updated Phase 6 |
+| `iis-deploy-runbook` | 3 IIS site + win-acme cert + gitea-runner + LibreOffice + debug 500/502/SignalR prod + **G-084 IPv4/IPv6 hardening** | "prod 500", "IIS fail", "cert hết hạn", "restart app pool", "deploy IIS", "port hijack" | ✅ Updated (G-084) |

 ## Format chuẩn 1 skill

--- a/.claude/skills/contract-workflow/SKILL.md
+++ b/.claude/skills/contract-workflow/SKILL.md
@ -17,7 +17,15 @@ when-to-use:

 # Contract Workflow Skill

-> **Status:** Tier 3 FEATURE-COMPLETE — State transitions + code gen + SLA job + attachment + realtime notify + versioned workflow admin-configurable. Còn thiếu: email outbox (SMTP), User-kind approver runtime, warning 20% SLA.
+> **Status:** Tier 3 FEATURE-COMPLETE — State transitions + code gen + SLA job + attachment + realtime notify + versioned workflow admin-configurable. Còn thiếu: email outbox (SMTP), warning 20% SLA.
+>
+> **Phase 6 cross-ref (2026-04-23):** Module `PurchaseEvaluation` (tiền-HĐ) có
+> **workflow SEPARATE** — `PurchaseEvaluationPolicy` + registry +
+> `FromDefinition` mirror pattern này nhưng tách table riêng (3 bảng
+> `PurchaseEvaluationWorkflow*`) vì Phase enum khác. Xem:
+> - `Domain/PurchaseEvaluations/PurchaseEvaluationPolicy.cs`
+> - `Infrastructure/Services/PurchaseEvaluationWorkflowService.cs`
+> - Kế thừa HĐ từ phiếu `DaDuyet` qua `CreateContractFromEvaluationCommand` — pin `Contract.WorkflowDefinitionId` theo ContractType user chọn.

 ## Domain entities (implemented)

--- a/.claude/skills/ef-core-migration/SKILL.md
+++ b/.claude/skills/ef-core-migration/SKILL.md
@ -1,6 +1,6 @@
 ---
 name: ef-core-migration
-description: Tạo/sửa/revert EF Core 10 migration cho SOLUTION_ERP. Dùng khi thêm entity mới, thay đổi schema, rollback migration, debug DesignTimeDbContextFactory fail. Đã có 8 migration sẵn (Init → AddVersionedWorkflows). Snapshot + Designer + Migration 3-file rule bắt buộc commit đủ.
+description: Tạo/sửa/revert EF Core 10 migration cho SOLUTION_ERP. Dùng khi thêm entity mới, thay đổi schema, rollback migration, debug DesignTimeDbContextFactory fail. Đã có 12 migration sẵn (Init → AddPurchaseEvaluations). Snapshot + Designer + Migration 3-file rule bắt buộc commit đủ.
 when-to-use:
  - "thêm migration"
  - "EF Core migration"
@ -16,7 +16,7 @@ when-to-use:

 > **Context:** .NET 10 + EF Core 10 + SQL Server. DbContext: `ApplicationDbContext` ở `Infrastructure/Persistence/`. Startup: `SolutionErp.Api`.

-## Migration history (8 migration hiện có)
+## Migration history (12 migration hiện có)

 | # | Name | Tables added / changed |
 |---|---|---|
@ -28,8 +28,17 @@ when-to-use:
 | 6 | `AddNotifications` | Notifications |
 | 7 | `AddWorkflowTypeAssignments` | WorkflowTypeAssignments (legacy admin override) |
 | 8 | `AddVersionedWorkflows` | WorkflowDefinitions, WorkflowSteps, WorkflowStepApprovers + `Contracts.WorkflowDefinitionId` FK |
+| 9 | `AddContractDetailsAndChangelog` | 7 per-type Details (ThauPhu/GiaoKhoan/NhaCungCap/DichVu/MuaBan/NguyenTacNcc/NguyenTacDv) + ContractChangelogs |
+| 10 | `AddMasterCatalogs` | UnitsOfMeasure, MaterialItems, ServiceItems, WorkItems |
+| 11 | `AddRoleShortNameAndUserDepartment` | +Role.ShortName + User.DepartmentId/Position (cột thêm, không bảng mới) |
+| **12** | **`AddPurchaseEvaluations`** | **10 bảng module Duyệt NCC: PurchaseEvaluations + Suppliers + Details + Quotes + Approvals + Changelogs + Attachments + WorkflowDefinitions/Steps/StepApprovers** |

-Total: **24 bảng** dbo + `__EFMigrationsHistory`. Xem `docs/database/schema-diagram.md` ERD đầy đủ.
+Total: **46 bảng** dbo + `__EFMigrationsHistory`. Xem `docs/database/schema-diagram.md` ERD đầy đủ.
+
+**Phase 7 pending (session tiếp):**
+- `AddPePaymentTermFields` — tách `PurchaseEvaluations.PaymentTerms` JSON thành 6 column riêng
+- `AddPeDepartmentOpinions` — thêm 4 field Ý kiến phòng ban (Phê duyệt/CCM/MuaHàng/SM-PM) vào header hoặc table riêng
+- `AddPurchaseEvaluationCodeSequences` — atomic MaPhieu sequence (nếu user chốt format mới)

 ## Commands (chạy từ root repo)

--- a/.claude/skills/permission-matrix/SKILL.md
+++ b/.claude/skills/permission-matrix/SKILL.md
@ -12,7 +12,16 @@ when-to-use:

 # Permission Matrix Skill

-> **Status:** Phase 1 đợt 2 IMPLEMENTED.
+> **Status:** Phase 1 đợt 2 IMPLEMENTED + extended qua các phase sau (28 Ct_* + 7 Wf_* + Phase 6 thêm 13 Pe_*/PeWf_*).
+>
+> **Phase 6 cross-ref (2026-04-23):** Thêm menu keys module Duyệt NCC:
+> - `PurchaseEvaluations` (root group) + `PeWorkflows` (admin root, WIP)
+> - `Pe_<Code>_<Action>` cho 2 type × 3 action = 6 leaf
+>   (`Pe_DuyetNcc_List/Create/Pending`, `Pe_DuyetNccPhuongAn_List/Create/Pending`)
+> - `PeWf_<Code>` cho admin designer UI (FE chưa build)
+> - Inheritance: `PurchaseEvaluations.Read` → auto grant Pe_* descendants (pattern Contracts → Ct_*)
+> - FE resolver Layout.tsx: `Pe_<Code>_List` → `/purchase-evaluations?type=N` (1=NccOnly / 2=NccWithPlan)
+> - **TODO session tiếp:** grant non-admin role `PurchaseEvaluations.Read` qua `/system/permissions` để user thấy menu Pe_*.

 ## Model

--- a/CLAUDE.md
+++ b/CLAUDE.md
@ -4,17 +4,18 @@

 ---

-**SOLUTION_ERP** — Hệ thống Quản lý Hợp đồng Nhà cung cấp / Thầu phụ / Tổ đội cho Công ty TNHH Xây dựng Solutions.
+**SOLUTION_ERP** — Hệ thống Quản lý Hợp đồng Nhà cung cấp / Thầu phụ / Tổ đội + **Phiếu Duyệt NCC tiền-HĐ** cho Công ty TNHH Xây dựng Solutions.

 Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Server + IIS**.

-## 🚀 BẮT ĐẦU SESSION — 4 file đọc trước tiên
+## 🚀 BẮT ĐẦU SESSION — 5 file đọc trước tiên

 ```
-1. docs/STATUS.md                        ← Snapshot HIỆN TẠI (phase nào, việc gì đang làm)
-2. docs/PROJECT-MAP.md                   ← Bản đồ toàn cảnh (nên đọc đầu dự án)
-3. docs/changelog/migration-todos.md     ← Atomic tasks theo từng phase
-4. docs/workflow-contract.md             ← ⭐ State machine 9 phase — ảnh hưởng mọi thiết kế
+1. docs/STATUS.md                        ← Snapshot HIỆN TẠI (phase nào, việc gì đang làm — PE module CÒN CHỈNH NHIỀU)
+2. docs/HANDOFF.md                       ← Brief 5 phút: session trước làm gì + cảnh báo session tiếp
+3. docs/PROJECT-MAP.md                   ← Bản đồ toàn cảnh
+4. docs/changelog/migration-todos.md     ← Atomic tasks theo phase (Phase 7 PE refinement mới)
+5. docs/workflow-contract.md             ← ⭐ State machine 9 phase HĐ — base pattern cho PE workflow
 ```

 ## ⚡ Quick Rules
@ -44,11 +45,23 @@ Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Ser
 ### Database conventions

 - Schema: `dbo` (single schema)
- Table: **PascalCase tiếng Anh** (Contracts, Suppliers, Projects, ContractApprovals, ...)
+- Table: **PascalCase tiếng Anh** (Contracts, Suppliers, Projects, ContractApprovals, PurchaseEvaluations, ...)
 - PK: `Id` (Guid), FK: `{Entity}Id`
 - 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ó 12 migration → 46 bảng** (Phase 6 thêm migration 12 `AddPurchaseEvaluations` — 10 bảng)
+
+### Modules
+
+| Module | Namespace | Migration | Trạng thái |
+|---|---|---|---|
+| Contract (HĐ) | `Domain/Contracts/` | 1-11 | Feature-complete (7 ContractType × 9 phase) |
+| PurchaseEvaluation (Duyệt NCC tiền-HĐ) | `Domain/PurchaseEvaluations/` | 12 | **Skeleton — còn chỉnh nhiều (Phase 7 WIP)** |
+| Master (Supplier/Project/Department) | `Domain/Master/` | 2, 10 | Feature-complete |
+| Identity (User/Role/Permission/MenuItem) | `Domain/Identity/` | 1, 3, 11 | Feature-complete |
+| Forms (Template + Clause) | `Domain/Forms/` | 4 | Feature-complete |
+| Notifications | `Domain/Notifications/` | 6 | In-app + SignalR OK, email SMTP TODO |

 ### Commit convention

@ -56,7 +69,7 @@ Kiến trúc: **.NET 10 Clean Architecture + 2 React FE (admin + user) + SQL Ser
 [CLAUDE] <scope>: <imperative message>
 ```

-**Scope:** `Contract` · `Form` · `Workflow` · `Supplier` · `Auth` · `Admin` · `Api` · `App` · `Domain` · `Infra` · `FE-Admin` · `FE-User` · `Docs` · `CICD` · `Scripts` · `Skill`
+**Scope:** `Contract` · `PurchaseEvaluation` · `Form` · `Workflow` · `Supplier` · `Auth` · `Admin` · `Api` · `App` · `Domain` · `Infra` · `FE-Admin` · `FE-User` · `Docs` · `CICD` · `Scripts` · `Skill`

 ## 🛠️ Skills (.claude/skills/) — 6 skill PHẢI dùng khi task khớp

@ -81,10 +94,10 @@ Quy tắc: KHÔNG bulk-clone repo skill 3rd party. Chỉ thêm skill PROJECT-SPE
 | [`docs/PROJECT-MAP.md`](docs/PROJECT-MAP.md) | Bản đồ tổng quan |
 | [`docs/changelog/migration-todos.md`](docs/changelog/migration-todos.md) | Roadmap 5 phase + atomic tasks |
 | [`docs/CLAUDE.md`](docs/CLAUDE.md) | Full context — tech stack chi tiết |
-| [`docs/workflow-contract.md`](docs/workflow-contract.md) | State machine 9 phase + role matrix |
+| [`docs/workflow-contract.md`](docs/workflow-contract.md) | State machine 9 phase HĐ + role matrix |
 | [`docs/forms-spec.md`](docs/forms-spec.md) | Catalog 8 form + quy định mã HĐ RG-001 |
 | [`docs/database/database-guide.md`](docs/database/database-guide.md) | DB conventions + migration workflow + cheatsheet |
-| [`docs/database/schema-diagram.md`](docs/database/schema-diagram.md) | ⭐ ERD + luồng DB + data flow 19 table |
+| [`docs/database/schema-diagram.md`](docs/database/schema-diagram.md) | ⭐ ERD + luồng DB + data flow 46 table (+ §11 PE module) |
 | [`docs/flows/README.md`](docs/flows/README.md) | Index 6 flow (auth, permission, contract, form, SLA) |
 | [`docs/gotchas.md`](docs/gotchas.md) | ⭐ 26 bẫy đã gặp — đọc trước khi debug tương tự |
 | [`.claude/skills/`](.claude/skills/README.md) | 6 skill: contract-workflow, form-engine, permission-matrix, dependency-audit-erp, ef-core-migration, iis-deploy-runbook |
--- a/docs/HANDOFF.md
+++ b/docs/HANDOFF.md
@ -1,18 +1,28 @@
 # HANDOFF — Brief 5 phút cho session tiếp theo

-**Last updated:** 2026-04-23 (Phase 6 — PurchaseEvaluation module E2E)
+**Last updated:** 2026-04-23 tối (Phase 6 — PE skeleton + G-084 hardening, **PE còn chỉnh nhiều**)

 ## TL;DR

-**Module Duyệt NCC (tiền-HĐ) E2E.** 2 quy trình A/B config được admin
-(tái dùng framework versioned workflow), 10 bảng mới (7 core + 3
-workflow config), 17 endpoint mới, 3 FE page × 2 app + PeDetailTabs
-5-tab + PeWorkflowPanel timeline. Kế thừa HĐ 1-click từ phiếu DaDuyet:
-Gen Contract draft với SupplierId/ProjectId/GiaTri kế thừa, link 2
-chiều PE.ContractId.
+**PE module skeleton E2E** — 2 quy trình A/B config được admin, 10 bảng, 17
+endpoint, 3 page × 2 app + kế thừa HĐ 1-click. BE + FE + migration đã push
+lên Gitea main (`2c6f0ca..3990066`, 6 commit). **CHƯA XONG — nhiều polish
+ feature thiếu cho session tiếp** (xem STATUS.md §🔥 In Progress đầy đủ).

-**Tổng:** 46 DB tables, ~110 endpoints, 12 migrations. Còn blockers
-user/ops cũ: UAT thật + SMTP + rotate creds.
+**G-084 hardening:** localhost → 127.0.0.1 trong scripts + skill, doc gotcha
+#33 từ bài học VietReport (IPv4/IPv6 port hijack trên VPS shared).
+
+**Tổng:** 46 DB tables, ~110 endpoints, 12 migrations, 33 gotchas. Blocker
+user/ops cũ vẫn còn: UAT thật + SMTP + rotate creds + runner apply.
+
+## ⚠️ CẢNH BÁO session tiếp
+
+1. **Runner có thể đang stopped sau VPS restart** → `/api/purchase-evaluations`
+   vẫn 404. Kiểm tra + start `gitea-runner` service trước khi test PE endpoint.
+2. **PE chỉ là skeleton** — user nói "còn chỉnh nhiều". Nhóm A/B/C/D tasks
+   đầy đủ ở STATUS.md §🔥 In Progress.
+3. **Chú ý G-084:** VPS shared với VietReport — mọi reverse proxy / backend
+   service mới phải dùng `127.0.0.1` + bind loopback IPv4 explicit.

 ## ⭐ Skills (.claude/skills/) — PHẢI dùng khi task khớp

@ -92,6 +102,25 @@ Login: `admin@solutionerp.local` / `Admin@123456`

 ## Cần làm kế tiếp

+### 🔥 Priority 0 — PE module refinement (session tiếp)
+
+Xem **STATUS.md §🔥 In Progress** đầy đủ (nhóm A/B/C/D). Tóm tắt nhanh:
+
+1. **PE Workflow admin designer UI** `/system/pe-workflows/:typeCode` — mirror pattern từ `WorkflowsPage.tsx` + `WorkflowDesigner.tsx`. BE cần `PeWorkflowAdminFeatures.cs` + `PeWorkflowsController.cs`. Framework backend đã sẵn, chỉ thiếu wire UI.
+2. **PE Attachments upload** — copy pattern `ContractAttachmentFeatures.cs` + `ContractAttachmentsSection.tsx`. Entity + enum có sẵn.
+3. **Ý kiến 4 phòng ban** (Phê duyệt / P.CCM / P.MuaHàng / SM-PM) — Excel form có, entity chưa map. Cần design: 4 text field + signoff date, hoặc dùng Approvals với role-kind.
+4. **Payment terms tách field** từ JSON blob → 6 field riêng (Tạm ứng / TT tạm / Quyết toán / Bảo hành / Hạn mức / Đánh giá) theo Excel section D.
+5. **Seed demo PE data** — 2-3 phiếu cho UAT + screenshot.
+6. **Permission grant Pe_* cho non-admin role** — `/system/permissions` tick `PurchaseEvaluations.Read` + CRUD cho role Drafter/PRO/CCM/BOD.
+7. **MaPhieu format chính thức** — user confirm.
+8. **Export phiếu PDF/Excel** — tái dùng `IDocumentConverter` + template.
+9. **Auto-map PE Details → Contract Details** khi gen HĐ (optional — nâng cấp).
+
+**Deploy blocker hiện tại:** commit `3990066` chưa apply prod. Check runner:
+```powershell
+Get-Service *gitea-runner* ; Start-Service gitea-runner
+```
+
 ### 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ị:
--- a/docs/STATUS.md
+++ b/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-04-23 (Phase 6 — PurchaseEvaluation module E2E, migration 12, 46 DB tables)
+**Last updated:** 2026-04-23 tối (Phase 6 — PE module **skeleton E2E + G-084 hardening, CÒN CHỈNH NHIỀU**)

-## 📍 Phase hiện tại: **Module Duyệt NCC (tiền-HĐ) live E2E** — Prod live 3 domain, 46 DB tables (+10 PE), ~110 endpoints (+17 PE), 12 migrations. 2 quy trình Duyệt NCC config được admin (QT-DN-A 3-step / QT-DN-B 5-step). Kế thừa HĐ 1-click từ phiếu DaDuyet.
+## 📍 Phase hiện tại: **Module Duyệt NCC (tiền-HĐ) — skeleton deployed, refinement WIP** — 46 DB tables (+10 PE), ~110 endpoints (+17 PE), 12 migrations, 6 commits PE push Gitea (`2c6f0ca..3990066`). Skeleton BE + FE + kế thừa HĐ hoạt động; còn nhiều polish + feature thiếu (designer UI, attachments, details mapping, export PDF).

 ### 🌐 Production URLs

@ -14,14 +14,55 @@
 - 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
+## 🔥 In Progress — PE module chưa xong (session tiếp xử lý)

-_(không có — Tier 3 + skill governance đóng gói xong, chờ UAT + chờ cron audit fire 2026-05-01)_
+> **User feedback (2026-04-23 tối session 2):** "phần Duyệt NCC chưa xong đâu đấy nhé, còn chỉnh nhiều".
+
+### A. Chức năng MISSING trong MVP (phải làm)
+
+- [ ] **PE Workflow admin designer UI** `/system/pe-workflows/:typeCode` — framework versioned WF đã có (3 bảng + policy `FromDefinition`). Chỉ thiếu:
+  - BE `PeWorkflowAdminFeatures.cs` (mirror `WorkflowAdminFeatures.cs` — GetOverview + CreateNewVersion)
+  - `PeWorkflowsController.cs` — GET overview + POST create-version
+  - FE `PeWorkflowsPage.tsx` + `PeWorkflowDesigner.tsx` (mirror `WorkflowsPage.tsx` + `WorkflowDesigner.tsx`)
+  - Menu leaf `PeWf_*` đã seed rồi, resolver Layout.tsx đã map `/system/pe-workflows/:code`
+- [ ] **PE Attachments upload** — pattern copy từ `ContractAttachmentFeatures.cs` + FE `ContractAttachmentsSection.tsx`. Entity + `PurchaseEvaluationAttachmentPurpose` enum đã sẵn (QuoteDocument/RequirementSpec/DecisionExport).
+- [ ] **Auto-map PE Details → Contract 7 per-type Details khi gen HĐ** — hiện `CreateContractFromEvaluationCommand` chỉ copy header + GiaTri, KHÔNG copy Details. Cần mapping per ContractType (PE Detail schema flat ≠ 7 Contract Details schemas).
+- [ ] **Demo PE data seed** — chưa có `[DEMO]` PE nào. Cần 2-3 phiếu seed (1 NccOnly đã DaDuyet chưa tạo HĐ, 1 NccWithPlan ở phase ChoCCM giữa chừng, 1 TuChoi) cho UAT + screenshot.
+- [ ] **MaPhieu format chính thức** — hiện `PE-YYYYMM-XXXX` random 4-digit. User said "tính sau". Cần confirm format: `{ProjectCode}/PE/{seq:D3}` hoặc atomic sequence bảng như `ContractCodeSequences`.
+- [ ] **Section "Ý kiến các phòng ban" (Phê duyệt/P.CCM/P.MuaHàng/SM-PM) ở tab Thông tin** — Excel form mẫu có, entity hiện chưa map. Cần thêm 4-8 text field + signoff date (hoặc dùng Approvals row như ContractApprovals).
+
+### B. UX / Polish cần chỉnh
+
+- [ ] **Payment terms chi tiết** — hiện JSON blob. UX tách field riêng (Tạm ứng / TT tạm / Quyết toán / Bảo hành / Hạn mức / Đánh giá) theo Excel section D.
+- [ ] **Matrix Quotes bulk paste** — click cell → popup: OK. Nhưng bulk paste column giá từ Excel chưa có (power user feature).
+- [ ] **Export phiếu PDF/Excel** — user cần bản in ký. Tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx`.
+- [ ] **Permission grant Pe_* cho non-admin role** — admin thấy menu Pe_*, non-admin chưa. Cần vào `/system/permissions` tick `PurchaseEvaluations.Read` cho role Drafter/Procurement/CostControl/Director.
+- [ ] **fe-user Inbox** — hiện chỉ HĐ. Cần thêm section "Phiếu Duyệt NCC chờ tôi" (hoặc route `/pe-inbox` riêng).
+- [ ] **Sidebar accordion fe-user** — test `Pe_DuyetNcc` group với `Ct_*` accordion context (Layout.tsx fe-user accordion hiện chỉ track `Ct_<code>`, có thể cần extend cover `Pe_<code>`).
+
+### C. Edge case chưa test
+
+- [ ] Reject path E2E: DangSoanThao → ChoPurchasing → (CCM reject) → DangSoanThao — verify approval row vẫn log
+- [ ] Xóa phiếu khi đã có Contract kế thừa (PE.ContractId set) — cascade delete child OK, Contract standalone không break, nhưng nên warning dialog
+- [ ] Admin tạo PE workflow v02 sau khi có phiếu pin v01 — invariant "phiếu cũ giữ cũ" chưa test (pattern giống HĐ, nên pass)
+- [ ] Change EvaluationType (A ↔ B) sau create — form hiện disable, đúng. User có đổi nhầm → phải xóa + tạo lại.
+
+### D. Deploy / Ops
+
+- [ ] **Verify CI/CD apply commit 3990066 lên prod** — hiện `/api/purchase-evaluations` trả 404 (phiên bản cũ). Check runner status:
+  ```powershell
+  Get-Service *gitea-runner* ; & "C:\nssm\nssm.exe" status gitea-runner
+  # Nếu Stopped → Start-Service gitea-runner
+  ```
+  Sau đó recheck `curl https://api.huypham.vn/api/purchase-evaluations` → 401 = deploy OK.
+
+## ✅ Recently Done (newest on top)

 ## ✅ Recently Done (newest on top)

 | Ngày | Ai | Task | Commit |
 |---|---|---|---|
+| 2026-04-23 | Claude | **G-084 hardening** — localhost → 127.0.0.1 trong `deploy-iis.ps1` + skill `iis-deploy-runbook`. Thêm gotcha #33 (IPv4/IPv6 port hijack) ref VietReport incident + 3 rules (reverse-proxy IP literal / backend loopback IPv4 explicit / service dependency). SOLUTION_ERP risk thấp (API in-process IIS, no ARR proxy) nhưng chuẩn hóa cho tương lai. | `3990066` |
 | 2026-04-23 | Claude | **Kế thừa HĐ từ phiếu PE** — `CreateContractFromEvaluationCommand` guard DaDuyet + SelectedSupplier + ContractId=null → tạo Contract draft với SupplierId/ProjectId/GiaTri kế thừa. Link 2 chiều PE.ContractId. 2 endpoint mới (approved-pending-contract + create-contract). FE PeDetailTabs InfoTab banner emerald + CreateContractDialog pick ContractType 7 loại. | `a385d70` |
 | 2026-04-23 | Claude | **PE FE — 2 app pages (List/Create/Detail 3-panel)** — Types + PurchaseEvaluationsListPage 3-panel + PurchaseEvaluationCreatePage + PeDetailTabs (5 tab: Thông tin/NCC/Hạng mục+Quote matrix/Duyệt/Lịch sử) + PeWorkflowPanel timeline. Menu resolver Pe_* → /purchase-evaluations?type=N. fe-user mirror. TS build pass cả 2 app. | commit Phase 3 |
 | 2026-04-23 | Claude | **PE App+Api CQRS** — ~900 dòng: Create/UpdateDraft/Transition/List/Inbox/GetDetail bundle/Delete + Supplier CRUD + Detail CRUD + Quote Upsert + SelectWinner + Changelog list. PurchaseEvaluationWorkflowService policy-based guard + notification push. PurchaseEvaluationsController ~15 endpoint. | commit Phase 2 BE |
--- a/docs/architecture.md
+++ b/docs/architecture.md
@ -241,7 +241,33 @@ Claude auto-invoke theo description matching.
 | Observability | Serilog console | + file rolling daily + Seq/ELK |
 | Security | JWT + HTTPS dev | + rate limit + audit log + CSP |

-## 9. Liên quan
+## 9. PurchaseEvaluation (Phase 6 — tiền-HĐ)
+
+Module mới song song Contract — phiếu trình duyệt so sánh giá N NCC × M hạng mục, duyệt xong kế thừa làm HĐ.
+
+```
+PurchaseEvaluation (Header) ─< PurchaseEvaluationSupplier (N:M × Supplier)
+                            ─< PurchaseEvaluationDetail (hạng mục) ─< PurchaseEvaluationQuote (báo giá N×M)
+                            ─< PurchaseEvaluationApproval (workflow history)
+                            ─< PurchaseEvaluationChangelog (audit)
+                            ─< PurchaseEvaluationAttachment (file)
+                            ─> PurchaseEvaluationWorkflowDefinition (PINNED at create)
+                            ─> Contract? (nullable FK — set khi gen HĐ từ phiếu DaDuyet)
+```
+
+**Workflow** (tách riêng vì Phase enum khác ContractPhase):
+- A `DuyetNcc` — 3 step: Drafter → Procurement → CostControl → Director → DaDuyet
+- B `DuyetNccPhuongAn` — 5 step: + ProjectManager sau Procurement, + Director duyệt PA trước duyệt NCC
+
+**Kế thừa HĐ** (`CreateContractFromEvaluationCommand`):
+- Guard: phase = DaDuyet, SelectedSupplierId != null, ContractId = null
+- User pick ContractType (1-7) → gen Contract draft với SupplierId/ProjectId/GiaTri kế thừa
+- Pin `Contract.WorkflowDefinitionId` theo ContractType chọn
+- Link 2 chiều: `PurchaseEvaluation.ContractId = contract.Id`
+
+Chi tiết: [`database/schema-diagram.md §11`](database/schema-diagram.md).
+
+## 10. Liên quan

 - [`rules.md`](rules.md) — coding conventions
 - [`database/database-guide.md`](database/database-guide.md) — DB schema chi tiết
--- a/docs/changelog/migration-todos.md
+++ b/docs/changelog/migration-todos.md
@ -310,7 +310,61 @@
 - [ ] **PE Attachments upload** (pattern reuse ContractAttachmentFeatures) — optional
 - [ ] **Auto-map PE Details → Contract Details per-type** khi gen HĐ — phức tạp vì 7 ContractType schema khác nhau, user điền lại manual — optional

-## Post-launch (Phase 6+ — future)
+## Phase 7 — PE refinement (session tiếp)
+
+**User feedback (2026-04-23 tối session 2):** "phần Duyệt NCC chưa xong đâu đấy nhé, còn chỉnh nhiều"
+
+### A. Chức năng MISSING trong MVP
+
+- [ ] **PE Workflow admin designer UI** `/system/pe-workflows/:typeCode`
+  - BE `Application/PurchaseEvaluations/PeWorkflowAdminFeatures.cs` — mirror `WorkflowAdminFeatures.cs` (GetOverview + CreateNewVersion)
+  - `Api/Controllers/PeWorkflowsController.cs` — GET overview + POST create-version (`[Authorize(Policy = "PeWorkflows.Create")]`)
+  - FE `fe-admin/src/pages/system/PeWorkflowsPage.tsx` — URL-driven, landing + per-type
+  - FE `fe-admin/src/components/workflow/PeWorkflowDesigner.tsx` — Steps + Approvers modal
+  - Route `/system/pe-workflows/:typeCode` trong App.tsx (menu `PeWf_*` + resolver đã sẵn)
+- [ ] **PE Attachments upload** — pattern copy từ `ContractAttachmentFeatures.cs`
+  - BE `Application/PurchaseEvaluations/PurchaseEvaluationAttachmentFeatures.cs` (Upload/Download/Delete)
+  - 3 endpoint POST/GET/DELETE `/api/purchase-evaluations/{id}/attachments`
+  - FE `components/pe/PeAttachmentsSection.tsx` — drag-drop với purpose selector
+- [ ] **Ý kiến 4 phòng ban** (Phê duyệt / P.CCM / P.MuaHàng / SM-PM từ Excel form)
+  - Option A: Thêm 4 text field (NhậnXétPheDuyet/CCM/MuaHang/SmPm) + 4 date field + 4 UserId vào `PurchaseEvaluations` header
+  - Option B: Dùng existing `PurchaseEvaluationApprovals` với roleKind extra field
+  - UX: tab Thông tin hiển thị 4 box sign-off như Excel
+- [ ] **Payment terms tách field** từ JSON → 6 columns hoặc subtable
+  - Migration `AddPurchaseEvaluationPaymentTerms` — cột/bảng: TamUng%, ThanhToanTam%, QuyetToan%, BaoHanh%, HanMucCongNo, DanhGia
+  - FE form field-based (loại bỏ JSON textarea)
+- [ ] **Auto-map PE Details → Contract Details khi gen HĐ** (optional — nâng cấp)
+  - 7 mapping function per ContractType (khó vì schema khác biệt)
+  - MVP: skip, user nhập manual
+- [ ] **Demo PE data seed** — `SeedDemoPurchaseEvaluationsAsync`
+  - 1 NccOnly DaDuyet chưa tạo HĐ (showcase kế thừa button)
+  - 1 NccWithPlan phase ChoCCM (showcase workflow middle)
+  - 1 TuChoi (showcase reject path)
+- [ ] **MaPhieu format chính thức** — hiện `PE-YYYYMM-XXXX` random. User confirm format + atomic sequence:
+  - Option A: `{ProjectCode}/PE/{yyyy}/{seq:D3}` — atomic via `PurchaseEvaluationCodeSequences` bảng mới
+  - Option B: Tái dùng `ContractCodeSequences` với Prefix = `PE-{yyyy}-{ProjectCode}`
+
+### B. UX / Polish
+
+- [ ] Matrix Quotes **bulk paste** từ Excel column giá → paste matrix row
+- [ ] **Export phiếu PDF/Excel** — tái dùng `IDocumentConverter` + template `PE-TrinhDuyet.docx` upload qua FormsPage
+- [ ] **Permission grant Pe_* cho non-admin role** — 1 click trong PermissionsPage matrix (Pe_* inherit từ `PurchaseEvaluations.Read` tương tự Contracts inheritance)
+- [ ] **fe-user Inbox** thêm section "Phiếu Duyệt NCC chờ tôi" (hoặc route `/pe-inbox`)
+- [ ] **Sidebar accordion fe-user** extend cover `Pe_<code>` (hiện chỉ track `Ct_<code>`)
+- [ ] **Dashboard** — thêm KPI "PE phiếu chờ tôi", "PE đã duyệt tháng này", "PE cần tạo HĐ"
+
+### C. Edge case + E2E test
+
+- [ ] Reject path E2E: DangSoanThao → ChoPurchasing → (CCM reject) → DangSoanThao
+- [ ] Admin tạo PE workflow v02 sau khi có phiếu pin v01 — invariant test
+- [ ] Xóa phiếu khi PE.ContractId set — warning dialog
+- [ ] 2 admin đồng thời tạo v02 cho cùng type — race condition (atomic dealsactivate old)
+
+### D. Deploy
+
+- [ ] Verify commit `3990066` apply prod (runner status + `/api/purchase-evaluations` → 401 expected)
+
+## Post-launch (Phase 8+ — future)

 - [ ] **Email outbox** (MailKit + SMTP) — blocked chờ SMTP config
 - [x] **Roles CRUD** — admin tạo custom role ngoài 12 hardcoded (commit 072ad6d)
--- a/docs/changelog/sessions/2026-04-23-2359-chot-session-pe-skeleton.md
+++ b/docs/changelog/sessions/2026-04-23-2359-chot-session-pe-skeleton.md
@ -0,0 +1,80 @@
+# Session 2026-04-23 ~23:59 — Chốt session 2: PE skeleton + G-084 + docs
+
+**Focus:** Chốt toàn bộ MD trước khi sang session mới. PE module còn
+CHỈNH NHIỀU (user nhấn mạnh), G-084 hardening apply preemptively.
+
+## Commits session này (7 total)
+
+| Commit | Nội dung |
+|---|---|
+| `2c6f0ca` | Domain+Infra — 10 bảng PE + migration 12 + seed menu/workflow |
+| `4678d19` | App+Api — PurchaseEvaluation CQRS (~900 LOC) + Controller 15 endpoint + WorkflowService |
+| `a737196` | FE 2 app — PE pages (List/Create/Detail tabs) + menu resolver Pe_*/PeWf_* |
+| `a385d70` | Kế thừa HĐ — CreateContractFromEvaluationCommand + FE dialog pick ContractType |
+| `aaf03be` | Docs Phase 6 — STATUS/HANDOFF/schema-diagram/migration-todos/session log |
+| `3990066` | G-084 hardening — localhost → 127.0.0.1 scripts + skill + gotcha #33 |
+| `(this)` | Chốt session — STATUS/HANDOFF/migration-todos/skills/CLAUDE/architecture |
+
+Tất cả đã push lên Gitea `main`. Runner cần verify apply deploy.
+
+## MD files updated
+
+| File | Changes |
+|---|---|
+| `docs/STATUS.md` | Phase hiện tại + In Progress PE refinement (nhóm A/B/C/D), +G-084 row Recently Done |
+| `docs/HANDOFF.md` | TL;DR session 2 + Priority 0 PE refinement + cảnh báo session tiếp |
+| `docs/changelog/migration-todos.md` | Phase 7 PE refinement checklist (A/B/C/D) |
+| `docs/architecture.md` | Section 9 PurchaseEvaluation module (ERD + workflow + kế thừa HĐ) |
+| `docs/database/schema-diagram.md` | §11 PE module full (done session trước) |
+| `docs/gotchas.md` | #33 G-084 IPv4/IPv6 port hijack (done session trước) |
+| `CLAUDE.md` (root) | Scope commit `PurchaseEvaluation`, 5 file đọc đầu, 12 migration, 46 bảng, modules table |
+| `.claude/skills/README.md` | 3 skill cross-ref Phase 6 PE |
+| `.claude/skills/contract-workflow/SKILL.md` | Cross-ref PE workflow separate tables |
+| `.claude/skills/permission-matrix/SKILL.md` | +Pe_*/PeWf_* menu keys + TODO grant non-admin |
+| `.claude/skills/ef-core-migration/SKILL.md` | 12 migration history + Phase 7 pending |
+| `.claude/skills/iis-deploy-runbook/SKILL.md` | +Hardening section G-084 + localhost→127.0.0.1 (done session trước) |
+
+## Session tiếp cần làm — đọc STATUS.md §🔥 In Progress
+
+**User feedback khóa chốt:** "phần Duyệt NCC chưa xong đâu đấy nhé, còn chỉnh nhiều"
+
+### Priority 0 (PE refinement)
+1. PE Workflow admin designer UI `/system/pe-workflows/:typeCode`
+2. PE Attachments upload (reuse ContractAttachment pattern)
+3. Ý kiến 4 phòng ban section (Phê duyệt/CCM/MuaHàng/SM-PM)
+4. Payment terms tách field từ JSON blob → 6 column
+5. Demo PE data seed
+6. Permission grant Pe_* cho non-admin role
+7. MaPhieu format chính thức (user confirm)
+8. Export PDF/Excel
+9. Auto-map PE Details → Contract Details (optional)
+
+### Priority 1 (blockers user/ops)
+- UAT thật, SMTP, rotate creds, SQL backup schedule
+- Verify commit 3990066 đã apply prod (runner status)
+
+### Audit cron
+- `solution-erp-skill-audit-monthly` fire 2026-05-01 9:00 AM
+- Log vào `docs/changelog/skill-audit-2026-05.md`
+
+## Stats cuối session 2
+
+| | Đầu session 2 | Cuối session 2 | Δ |
+|---|---:|---:|---:|
+| BE LOC | ~8800 | ~11100 | +2300 |
+| DB tables | 36 | 46 | +10 |
+| Migrations | 11 | 12 | +1 |
+| API endpoints | ~93 | ~110 | +17 |
+| FE pages | ~23 | ~26 | +3 × 2 app |
+| Gotchas | 32 | 33 | +1 (G-084) |
+| Commits | 52 | 59 | +7 |
+| Skills | 6 | 6 | 0 (audit + cross-ref) |
+
+## Notes cho session 3
+
+1. **PE là skeleton** — đừng treat as feature-complete. Ưu tiên Priority 0.
+2. **Runner VPS có thể stopped** sau khi restart — check trước khi debug "endpoint 404".
+3. **G-084 rule** áp dụng mọi service mới: `127.0.0.1` thay `localhost` trong reverse proxy / backend bind.
+4. **Workflow audit** cron đã set — không cần manual trigger trừ khi có skill mới thêm nhiều.
+5. **MaPhieu PE** hiện random — PHẢI confirm format với user trước khi seed demo data hoặc go-live thật.
+6. **Không fix localhost trong FE dev configs** (vite.config.ts, launchSettings.json, docs dev-only) — đó là dev context, risk zero. Chỉ fix prod deploy/proxy paths.