vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[CLAUDE] Docs: S104 reconcile Mig 62 Supplier docs-lag

Browse Source 
Commit 778fc98 (Mig 62 expand Supplier 9->27 field, today 16:06) shipped
BE+FE+deploy Run #488 but skipped docs closeout -> STATUS/HANDOFF stuck at
"Mig 61/S103". S104 session-start caught it: governance-detectors 1 HIGH
(STATUS Mig=61 vs disk=62) + 2 monitor (H1 patch-list D1-D4, H2 5-axis
CLEAN + investigator-harvest-in-HEAD moved-not-cut) + dotnet test 440 PASS
re-verified (#65 no-bite despite Create/UpdateSupplierCommand signature).

Reconcile (derived-flush to disk/prod ground-truth = em-main execution):
- STATUS.md: Migrations 61->62 + Mig 62 blurb; mega-line S104; Sub-agents
  flip-chain +S104-Opus; In-Progress S104 (S103 collapsed <details>);
  Maintenance-backlog Supplier Phase-A shipped (Phase B Excel-map defer).
- HANDOFF.md: S104 blurb + NEXT-em/NEXT-anh carry.
- ef-core-migration SKILL: description+header Mig 62 + table row 62 + Total.
- session log 2026-07-06-S104-mig62-supplier-reconcile.md.

State: Mig 62 . 89 tables . 440 test . gotcha 79 . menu 54. No prod-code;
docs/memory-only -> CI path-filter skip (#41), no deploy (Mig 62 already
shipped Run #488).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
pqhuy1987
2026-07-06 16:36:51 +07:00
parent 9f9a78e2da
commit af5f9d34ba
4 changed files with 57 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
.claude/skills/ef-core-migration/SKILL.md
View File

@ -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ó nhiều migration (số hiện tại → docs/STATUS.md canonical; mới nhất Mig 61 BackfillEndedByLevelFinalizeFromChangelog, S97). 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ó nhiều migration (số hiện tại → docs/STATUS.md canonical; mới nhất Mig 62 ExpandSupplierFields, S104). 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 (số hiện tại → `docs/STATUS.md` canonical; mới nhất Mig 61)
## Migration history (số hiện tại → `docs/STATUS.md` canonical; mới nhất Mig 62)
| # | Name | Tables added / changed |
|---|---|---|
@ -81,8 +81,9 @@ when-to-use:
| **59** | **`AddCcmBudgetPeriodToPurchaseEvaluation`** | **🎯 S87 — PurchaseEvaluations +`CcmBudgetPeriodAmount` decimal(18,2)? (ngân sách CCM cột Section-B kỳ này, per-PE, mirror `BudgetPeriodAmount` phía PRO). 1 AddColumn additive-nullable, no new table.** |
| **60** | **`AddPeEndedByLevelFinalize`** | **🎯 S97 — PE +`EndedByLevelFinalize bit NOT NULL DEFAULT 0` — cờ RUNTIME "phiếu ĐÃ kết thúc sớm bằng level-finalize" (set-true CHỈ nhánh finalize trong service); display `EndsBeforeCeo` cho phiếu DaDuyet đọc RUNTIME thay suy-CONFIG (gotcha #78 — phiếu opt-out lên CEO hết báo sai "không qua CEO"). Kèm `Sql()` backfill marker ⚠️ soi NHẦM bảng `Approvals` → match 0 (xem Mig 61). 1 AddColumn, no new table.** |
| **61** | **`BackfillEndedByLevelFinalizeFromChangelog`** | **🎯 S97 — DATA-ONLY no-schema (đính chính Mig 60): backfill query ĐÚNG bảng `PurchaseEvaluationChangelogs.ContextNote LIKE N'%Duyệt KẾT THÚC tại%'` + PhaseAtChange=7. PE 2 bảng lịch-sử TÁCH VAI: `Approvals` = per-approver record vs `Changelogs.ContextNote` = transition+marker (`LogTransitionAsync`). Idempotent, SQL-Server-only, prod-verified A/005/A/008 flag 0→1 + A/010 control unchanged (gotcha #79 — xác định đúng bảng-writer + verify marker-count prod TRƯỚC khi tin backfill; backfill=0-rows = cờ đỏ).** |
| **62** | **`ExpandSupplierFields`** | **🎯 S104 — Supplier 9→27 field (Phase A của 30-col NCC Excel import, anh Kiệt FDC): 18 AddColumn nullable + 18 DropColumn Down + `SupplierType +CaHai=6` append-only + enum `SupplierStatus` mới + guarded un-cram `Sql()` (clear legacy crammed Note 4 seeded rows exact-match, reversible). **No new table (89 giữ — 18 AddColumn/0 CreateTable)**. Seed fill-nulls-if-exists 30-field TRUONGGIANG/TANPHU/TGN/DONGDUONG idempotent. Commit `778fc98` shipped UN-closed-out → S104 docs-reconcile; prod-verified Run #488 PASS; 440 test #65-no-bite dù đổi chữ ký Create/UpdateSupplierCommand. Phase B (Excel-auto-map) defer.** |
Total: **89 bảng** `sys.tables` (= 88 dbo-app + `__EFMigrationsHistory`; re-ground S97 cicd Run #482 LIVE — số canonical → `docs/STATUS.md`; last schema-changing Mig 50 net 93→88-app, Mig 51-61 đều AddColumn/index/data-only không đổi số bảng). Xem `docs/database/schema-diagram.md` migration table + §11-15 module ERD (§16+ Mig 27-61 chi tiết pending).
Total: **89 bảng** `sys.tables` (= 88 dbo-app + `__EFMigrationsHistory`; re-ground S97 cicd Run #482 LIVE — số canonical → `docs/STATUS.md`; last schema-changing Mig 50 net 93→88-app, Mig 51-62 đều AddColumn/index/data-only/schema-expand không đổi số bảng). Xem `docs/database/schema-diagram.md` migration table + §11-15 module ERD (§16+ Mig 27-62 chi tiết pending).
## N-stage workflow pattern (Mig 18-20 — Session 12-13)