vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d6975e2dfd8a17daa5c223fb53553a95375c4dcc
solution-erp/.claude/agent-memory/implementer-backend/archive/2026-07.md
pqhuy1987 b827fd393b wal: flush 20260801T1228
2026-08-01 12:28:55 +07:00

10 KiB
Raw Blame History

Archive 2026-07 — implementer-backend (L2, moved-not-cut từ L1 @S161 curate)

Verbatim entries dời khỏi MEMORY.md L1 khi chạm ~93% autoinject_cap (25.600B). KHÔNG nén — nguyên văn.

  • S134 (07-17) PE lũy kế TẠM TÍNH BE [wf_58302bd5-b9f INV-2.A · return sạch 0-garble] [engine: opus-worker]: +ComputePendingAsync + PePendingAccumulation (PeBudgetAccumulator.cs pure-add +68/0) + PePendingPriorPeDto + PeBudgetSummaryDto append-cuối 5 field (2 construction site: :946 frozen-defaults 0/0/0/0/null · :985 live-fill) + D4 audit-note TRONG ApplyBudgetSnapshotOnFinalizeAsync (Action=Update KHÔNG Transition — #49 tránh UI đọc 2 lần chuyển-phase; insertion-only +30/0; signature GIỮ → 5 call-site 0-diff, site cuối line-shift :1112→:1142 content bất động). Build slnx 0/0 · 0 mig · ComputeAsync body 0-diff (A1). Learned: (1) insertion-only diff (grep '^-' = 0 real-removal) = bằng-chứng MẠNH NHẤT "thân method/call-site bất động" — mạnh hơn đọc-mắt, chống báo-số-sai kiểu #53; (2) derived-audit thêm vào helper KHÔNG cần đổi signature nếu tính nội bộ từ field entity sẵn có (giữ call-site 0-diff); (3) accumulator ns ≠ DTO ns (...Dtos) → cần using tường minh dù cùng project. Tag [s134, pe-luyke-tam-tinh, computepending, insertion-only-proof, d4-changelog-update-not-transition]

  • S133 (07-17) PE budget-freeze BE [wf_4bef08b8-730 INV-B · #53 return-fail → disk-truth + em-main-solo hoàn tất; entry on-behalf]: lane sửa XONG 6 file + PeBudgetAccumulator.cs mới (Domain 11 props ApprovedBudget* + Config precision/maxlength + DTO append BudgetFrozen=false cuối positional-record + display-gate frozen/live 2-nhánh trong GetPurchaseEvaluationQuery + helper ApplyBudgetSnapshotOnFinalizeAsync gọi 4-site :862/:901/:934/:1109 + 2 terminal-guard block-CẢ-Admin) rồi CHẾT TRƯỚC bước sinh migration → em-main solo: scaffold Mig 67 sạch 11 AddColumn (0 RenameColumn #63) + backfill Sql() OUTER APPLY ×3 khớp accumulator TỪNG điều kiện (Suppliers/Quotes = BaseEntity KHÔNG soft-delete filter → SQL không thêm IsDeleted trên s/q; WorkItemId-null → 4 lũy kế NULL mirror helper, SnapshotAt vẫn set) + apply 2 DB — Dev lòi drift Mig 66 committed-chưa-apply-local, catch-up luôn — + filter test 44/44 (T0 RED→GREEN không sửa test). Phát hiện đáng giữ của lane: TransitionAsync KHÔNG SaveChanges nội bộ :537 → snapshot flush qua SaveChanges của caller (mirror ApprovedPrice pattern); khuôn backfill THẬT Mig 61/65 = plain Sql() KHÔNG C# provider-guard (SQLite EnsureCreated không replay = guard kiến trúc). Tag [s133, pe-budget-freeze, mig67, 53-writelane-disk-recover]

  • (FIFO @S167 — 4 entry 2026-07-12/13 dời verbatim từ L1 khi hook read-limit-guard bắn @22.4KB; moved-not-cut: S116 PE giá ÂM · S113 Supplier import v2 Mig 64 · S112 PE sign-off · S112 Supplier Excel-import Mig 63.)

  • 2026-07-13 (S116 PE cho nhập giá ÂM — submit-guard 1-line BE, owner anh Kiệt PROD-UAT-live, NO mig/FE/test, spec deterministic exact-line → ACCEPT Case 1): Giá âm ô "Số tiền báo giá hạng mục" (form.thanhTien→Quote.ThanhTien) = phát-sinh-giảm/hoàn-tiền NCC = giá-trị THẬT (KHÔNG lỗi). Rule "có giá là được": ≥1 quote-selected khác 0 (âm/dương) → gửi được; CHỈ all-zero (chưa báo giá) mới chặn. THAY DUY NHẤT PurchaseEvaluationWorkflowService.cs:206 submit-guard selectedThanhTien.Sum() <= 0 → .All(x => x == 0). Guard Count==0 (chưa chọn NCC) ở if phía trên GIỮ RIÊNG → else if chỉ chạy khi list non-empty → .All(==0) = "mọi quote chọn đúng bằng 0". Message giữ "Đơn vị được chọn chưa có giá chào thầu". KHÔNG đụng (owner R1/R3/R-CEO): validator ≥0 khác (budget/price PeFeatures/PeWorkItemBudget/PeSuggestedPrice) GIỮ · clamp CreateContractFromEvaluationFeatures.cs:88-100 GIỮ (Contract.GiaTri cho âm R1) · CEO-threshold winnerQuoteTotal NET GIỮ · KHÔNG thêm validator quote. DB nhận âm sẵn (Mig 65, decimal(18,2) 0 CHECK, 0 validator). Build SolutionErp.Api 0 warn/0 err (Api ref Infrastructure → file compiled). ⚠️ Comment :193-195 ("tổng ≤0"/"D5 giữ >0"/"winner phải có giá") giờ STALE vs all-zero-logic — KHÔNG sửa (owner "THAY DUY NHẤT :206"), flag owner quyết. LESSON: domain "âm là giá-trị-thật" → presence-check dùng .All(==0) KHÔNG Sum()<=0/>=0 (sum-guard nhầm âm-lớn với chưa-nhập). Tag [s116, pe-negative-quote, submit-guard-1line, all-zero-not-sum, co-gia-la-duoc, no-mig, stale-comment-flagged].

  • 2026-07-12 (S113 Supplier import v2 BE — spec wf_e7896ca6 fable-clone-ensemble, owner anh Kiệt, Mig 64, D1/D2/D3 pre-chốt → ACCEPT Case 1+2; ⚠️ return-1 garbled #53 → coordinator SendMessage-resume, xong solo): IsPublic publish-gate + dedup MST-primary. Mig 64 AddSupplierPublishState (Supplier +bool IsPublic NOT NULL default false + Sql("UPDATE Suppliers SET IsPublic=1") backfill 22 prod + DropIndex→CreateIndex đổi Code-unique filter [IsDeleted]=0 AND [Code]<>'' cho draft-row Code="" coexist; no new table 89). Service SupplierExcelImportService: (a) re-bake ExpectedHeaderTokens BYTE-EXACT raw-\n form = single-source cho validator(NormalizeHeader collapse \n→space)+BuildTemplate (spec §② 30 token, c7 trailing-space); (b) dedup MST-primary + Code-backstop — BuildMstIndex(NormalizeMst=Trim+strip-inner-ws \s+→"" OrdinalIgnoreCase, blank→skip) precedence existing-MST→existing-Code→batch-MST→batch-Code, countedUpdates HashSet<Supplier> tránh double-count, blank-MST KHÔNG vào batchByMst (2 blank=2 insert); (c) BỎ hard-error blank-Code (=draft), GIỮ Name+all-or-nothing; (d) New IsPublic=!blank(Code), update-path KHÔNG đụng IsPublic; +MstMissing(soft-warn) +DraftCount; (e) BuildTemplate() ClosedXML sheet "Sheet1" 30 token ROW4 WrapText+FreezeRows. PublishSupplierCommand(Id,MaNcc?,Publish): set Code+unique-CI-check + gate Publish→Code-non-empty ConflictException, KHÔNG UpdateSupplierCommand (#73 clobber). API THẬT: GET /api/suppliers/import/template(xlsx "Mau-Database-NCC.xlsx") · POST /api/suppliers/{id}/publish body{maNcc?,publish} · GET /api/suppliers?published={t/f} filter · SupplierDto +bool IsPublic append-CUỐI (sửa 2 projection List+Get). D3 authz: import preview/confirm/template/publish [Roles=Admin,CatalogManager]→[Policy="Suppliers.Update"] (khớp FE PermissionGuard). DbInit +IsPublic=true 4 real+18 sample. Build slnx 0/0, apply BOTH DB (Dev catch-up+Design). KHÔNG commit/FE/test. LESSON: S112 CI-dedup-at-service mở rộng → dual-key MST-primary; blank-key KHÔNG index. Tag [s113, supplier-import-v2, mig64, ispublic-publish-gate, dedup-mst-primary-code-backstop, blank-code-draft, buildtemplate-single-source, publish-cmd-no-#73].

  • 2026-07-12 (S112 PE sign-off close-review implement — wf_7df56b89-7bb GO-WITH-ADJ, owner anh Kiệt PROD-UAT-live, 4-region/1 file PurchaseEvaluationWorkflowService.cs, NO mig/FE/test → ACCEPT Case 1): C1 A1 (ApplyDrafterBypassOnSubmitAsync): người soạn KÝ TAY ô cấp mình — k=Max→minOwn=Min(drafterSlots.Order), bypass <=k→<minOwn (chỉ NV cấp dưới THUẦN), XÓA canned-opinion UPSERT (không tự ký hộ ai) + dead maxLevelOrder/ownSlot; advance 3-nhánh→1 if(minOwn>1){pointer=minOwn} STOP tại minOwn (người soạn tự ApproveV2Async); minOwn=1→bypass rỗng pointer giữ (0,1); non-contiguous Cấp1+Cấp3 ký tay đúng thứ tự. C2 EDGE-5 hard-lock: top TransitionAsync sau isAdmin/isSystem TRƯỚC mọi branch → if(fromPhase is DaDuyet or TuChoi && !isAdmin && !isSystem) throw Conflict (chặn non-admin lật phiếu terminal; Admin+System MIỄN); KHÔNG đụng EnsureCanRejectV2Async. C3 no self-finalize (owner oQ1 permission-driven). C4 opinion-history (ApproveV2Async UPSERT else): old.Comment→Changelog (Workflow/Update/EntityId=level.Id) TRƯỚC overwrite chỉ khi non-empty — NO mig/bảng/endpoint. Build slnx 0/0. Infra 4 FAIL/401 pass: fail=C1 (PeSubmitGuardAndBypassTests 9/10/12/14 assert OLD auto-sign/terminal-on-submit); C2/C4 break 0 test → test-specialist ADD. LESSON: behavior-change write-site → run consumer tests, hand VERIFIED fail-list (KHÔNG sửa test). Tag [s112, pe-signoff, a1-sign-own-level, edge5-hardlock, opinion-history-changelog, consumer-test-verified-handoff].

  • 2026-07-12 (S112 Supplier Excel-import Phase B BE — wf_e2f23a84 invest-ensemble → wf_75d6149b close-review GO-WITH-ADJ, owner anh Kiệt, commit e100ef0, Mig 63 → ACCEPT Case 1/2): Service SupplierExcelImportService (preview + confirm 2-stage) + 2 endpoint (/suppliers/import/preview [415 non-xlsx] · /suppliers/import/confirm [401 auth]) + Mig 63 AddSupplierImportSourceFields (Supplier +SourceUpdatedAt datetime2?+SourceUpdatedBy nvarchar(200)? provenance cột 29/30; 2 AddColumn nullable no-new-table 89). FE 2-app byte-identical (SupplierImportDialog). LESSONS: (1) dedup Code = OrdinalIgnoreCase ở SERVICE — DB unique-index CI-collation lật (SQLite fixture BINARY KHÔNG bắt, prod SQL Server CI bắt) → dedup KHÔNG dựa DB; (2) parser absolute cell-index (row-4 header-fingerprint), KHÔNG CellsUsed() (column-drift); (3) all-or-nothing gate TRƯỚC mutate (1 hard-error→Committed=false DB unchanged); (4) fill-nulls SKIP Code/Name/Type (chỉ điền field trống); (5) .Normalize(FormC) cho real-file NFD (close-review adjust bake 30 RealFileHeaderTokens byte-verify). SURPRISE: Approach-B (extend seed) ĐÃ ship 4 NCC prod (Mig 62) → spec "partial" SAI; import ghi entity TRỰC TIẾP (fill-where-non-empty) KHÔNG qua UpdateSupplierCommand (tránh NULL-clobber #73). Shipped Run #496 PASS, reviewer GO-WITH-ADJ (BE 6/6 axes). Tag [s112, supplier-excel-import, mig63, ordinalignorecase-dedup-at-service, abs-cell-index-parser, all-or-nothing, fill-nulls-safe, normalize-formc-nfd, direct-entity-write].