vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dd7db21301c7027dd807ff1db2278bc8d8e38502
solution-erp/.claude/agent-memory/cicd-monitor/MEMORY.md
pqhuy1987 c621fded0e wal: flush 20260801T1731
2026-08-01 17:31:18 +07:00

17 KiB
Raw Blame History

CI/CD Monitor Agent — Persistent Memory

  • S168 (08-01) a2b37dc..0bfadc2 GĐ3-D Panel-3 + Lines-editor KHKK (7 FE + 2 BE + 1 test, 0-mig) — PASS 6/6 (#444 6m28s · gate 644=45+599 Δ+5 = đúng 5 Fact mới · Mig GIỮ 71 · tables 97 · bundle RgvHZkPH→DLRf9TeA + D65FJPGd→C7TGA4Kn). 🔑 BÀI TỐT NHẤT — WIRE-PROOF BẰNG THÔNG-ĐIỆP-LỖI GỌI TÊN FIELD: PUT route mới + bearer + GUID toàn-0 trả 400 liệt kê ĐỦ 3 field PlanId/LineId/CatalogEntryId ⇒ command+validator MỚI chạy end-to-end Api→Application — mạnh hơn hẳn 401 (401 chỉ chứng route tồn tại). Kèm miễn phí: đây là chứng pool đang phục vụ BINARY MỚI, mạnh hơn đo w3wp StartTime (StartTime chỉ nói 'có restart', không nói 'code nào'). 🔑 CHỤP PRE KỊP GIỜ = tài sản rẻ nhất: spawn 17:10 / push 17:08 ⇒ đo PRE (bundle + marker 0-hit + route 404) TRƯỚC khi deploy land 17:13 ⇒ có differential THẬT 404→401 và 0→1. Vào việc là chụp PRE ngay, đừng poll trước. 🔑 MARKER BẤT-ĐỐI-XỨNG > marker đối-xứng: lg:max-h-none = 1 (admin) : 2 (eoffice) đúng bằng số trang Panel-3 mỗi app ⇒ xác suất trùng-hợp ~0; comment cùng chuỗi bị Vite strip nên không nhiễu. 🔑 CSS = nhân chứng ở ARTIFACT KHÁC (Tailwind gen .lg\:max-h-none 0→1 cả 2 file .css) ⟂ JS. ⚠️ grep -P CHẾT trên Git-Bash locale ⇒ trích byte quanh marker bằng python str.find+slice. Evidence runs/2026-07-31-S164-4gd-khkk-fanout/sub-cicd-verify-gd3d-lineeditor.md. Tag [run-444, wire-proof-400-ten-field, chup-PRE-kip-gio, marker-bat-doi-xung, css-nhan-chung]

  • (08-01 aaed699 S167 K7 bridge KHKK→HĐ — PARTIAL 4/6+1: #442 (run #441 CANCELLED), gate 639. 🔴 PUSH-ĐÈ NUỐT DEPLOY = gotcha #86 (mục 🚨 dưới). 🔑 kiểm-tra-TIỀN-ĐỀ marker trước khi tin 0-hit (nghi unicode-escape/code-split → bác bằng ĐO). 🔑 control-dương = chuỗi bản TIỀN-commit của CHÍNH file đang sửa. 🔑 seeder báo 2/3 upgraded = chứng idempotent tầng-row miễn phí (log lần-2 IM LẶNG do guard). ⚠️ appcmd list wp map PID→pool BẮT BUỘC. ⚠️ CẤM lấy Admin-qua-được tuyên grant đã ăn. verbatim → archive/2026-08.md)

  • (08-01 1c6d77a S167 K6 admin thu-gọn menu 12-key — PASS 5/5: #440, gate 622 delta 0. 🔴 0-hit marker SAI 2 LẦN do CƠ-CHẾ REGEX (minify→BACKTICK · pattern-chứa-backtick qua biến làm grep -cE gãy im lặng) ⇒ LUẬT grep -F + trích byte thật TRƯỚC khi kết luận vắng-mặt. 🔑 COUNT-DELTA khi literal đã tồn tại (12/12 +1). 🔑 log CI in dist/assets/index-<hash>.js <size> = nhân chứng thứ 4, tách FROZEN-lành-tính khỏi bundle-kẹt. 🔑 menu ẩn 12/12 mà route 68→68 ⇒ ẩn client KHÔNG thu quyền (#82). verbatim → archive/2026-08.md)

  • (Arc S155→S166 (#416 · #419 · #422-#427 · #432 · #434-#439) — gate 551→622. 🔑 #439 marker differential element-wise (K5 vào CẢ 2 app · K4c CHỈ eoffice) + Δsize cùng chiều; ⚠️ bar 'FE route 200' KHÔNG CÓ RĂNG với SPA-fallback. 🔑 #438 PHỦ 2 RUN 1 LƯỢT ⇒ delta khép kín; mốc PRE đề bài SAI, bắt bằng ĐO (mốc PRE lão hoá sau MỖI deploy); PERM row ≠ policy. 🔑 #436 dự-đoán-TRƯỚC-khi-đo; marker = tên biến local thì 0 bit (minifier đổi). 🔴 #435 PARTIAL ACCEPTANCE CHÂN-LÝ-RỖNG (0 dòng cả 2 phía ⇒ 0==0 xanh mà 0 bit) → INFORMATION_SCHEMA · liệt-kê-TRỌN-HỌ index · wire-proof bind-error 400. 🔑 #434 TAM-GIÁC 3 NGUỒN (source-parse ⟂ sqlcmd ⟂ API-materialize-qua-EF). 🔴 #432 LUẬT CẤM HEAD~1 → neo SHA X^..X; control ÂM phải ĐỘC-QUYỀN. 🔴 #423 PARTIAL revoker UNGATED lật 447/494 row, sót vì đo TRƯỚC recycle → luật 3-CHÂN-KIỀNG; #427 ĐO-CỜ không đếm ROW; #419 count = SỐ FILE trong diff. verbatim → archive/2026-08.md + 2026-07.md via _INDEX)

Persistent diary cross-session. Auto-injected first ~200 lines at spawn (L1 HOT). Update BEFORE every stop. Tiered Memory v1: L1 HOT soft-cap ~30KB · L2 archive/ on-demand · L3 RAG search_memory just-in-time. Keep entry ≤ 1.5K chars (gotcha #53). Verbatim cũ → archive/2026-0{5,6,7,8}.md (+ 2026-05-{runs,q2,q3,q4}, .gist) + git d2f52ba. 🗺️ Lookup: archive/_INDEX.md — 1 dòng/bản-ghi + con-trỏ substring (sha-keyed).

🎯 Role baseline

Read-only CI/CD + post-deploy verifier SOLUTION_ERP. Poll Gitea Actions API, verify test-gate + deploy-ship + prod health. Output PASS/FAIL + evidence <500 words. Skills: iis-deploy-runbook · dependency-audit-erp · ef-core-migration.

⚠️ cicd-lane return-garble tracker (#53)

cicd-lane trả nhầm slice transcript thay verdict — tao TÁI PHẠM dai nhất roster (×5/6 qua S114; S117/S118 ×3 → feedback_agent_return_garble_recover). ⚠️ Từng tự dán nhãn 'CLEAN-return' SAI ⇒ KHÔNG tự phong return sạch. 🔒 Đối-sách: ghi-đĩa TRONG LÚC LÀM — prompt KHÔNG chặn được, artifact mới chặn ⇒ file trong run-folder là SẢN PHẨM CHÍNH, ghi từng mục ngay khi có bằng chứng, kết bằng END … VERDICT=; return chỉ là tóm tắt.

🚨 Recurring CI/CD bug patterns (catch priority)

  • #39 act_runner github.com TCP timeout — run hang "Set up job" 21s. Log dial tcp github.com:443 i/o timeout. Fix: manual checkout bypass hardcoded .gitea/workflows/deploy.yml. KHÔNG revert.
  • #40 npm cache tsc not found — build_fe_admin fail post cache: npm. DISABLED rolled back a21790d. KHÔNG re-enable.
  • #41 paths-ignore docs-only skip — code commit không trigger CI? Check git diff --name-only <base>..<head> vs 7-glob (D10 S111 8aa3869): ['docs/**','**/*.md','.claude/skills/**','.claude/agent-memory/**','.claude/workflows/runs/**','.gitignore','scripts/**.md']. Gitea evaluate push range — ≥1 commit có file non-ignored → toàn range build. ⚠️ AS-6: memory-push/run-trace HẾT trigger CI.
  • #25 IIS WebSocket — notification-hub/negotiate 401/404 prod. Fix: WebSocket module enable web.config site api (skill iis-deploy-runbook).
  • #48 SQLite tie-break — OrderByDescending(CreatedAt).First() pick wrong khi 2+ .Add() cùng frozen-clock. Fix: discriminator filter BEFORE OrderBy.
  • Bundle hash unchanged = ship FAIL — push+action success nhưng prod không đổi. Verify via INDEX.HTML ref (curl -s https://admin.solutions.com.vn/ | grep -oE '/assets/index-[A-Za-z0-9_-]+\.(js|css)'), NOT by GETting a hash-named asset directly. ⚠️ verify MUST sau status=success (Run #242 false-positive: check khi "running" → stale hash).
    • 🔴 #69 TWO-MODE — FE hash vừa có thể ROTATE vừa có thể FROZEN. deploy.yml copy dist\* UNCONDITIONALLY mọi run ⇒ 0-FE-change vẫn rotate (mode-A); src y hệt ⇒ Vite byte-identical ⇒ FROZEN (mode-B). Cả hai lành tính ⟹ hash-delta KHÔNG phải ship-proof. Ship-proof THẬT = Last-Modified in deploy-window + real-size + byte-marker. 🔑 FROZEN-lành-tính vs bundle-cũ-kẹt: xem LM — in-window = re-ship byte-identical (OK) · LM cũ = deploy không chạm file (cờ đỏ).
    • ⚠️ SPA-fallback 200 trap (S72): server rewrite /*→index.html ⇒ GET /assets/index-<BỊA>.js vẫn 200. Discriminator sạch = Content-Type (text/html ~876-919B = trap · application/javascript ~1,6MB = thật); size drift per-build nên đừng neo số byte. Hash CŨ rơi về text/html = bundle cũ biến mất khỏi đĩa = chứng ghi-đè (control âm tầng-2).
  • 🔴 Durability: đo SAU recycle + 3 CHÂN KIỀNG — pool restart ở CUỐI deploy-window ⇒ query DB lúc running = trạng thái CŨ (tao sai đúng chỗ này ở #423). Khuôn: (i) chứng minh restart thật (w3wp StartTime in-window + dòng ĐẦU log Applying migrations...), (ii) đo chỉ-số đích SAU mốc đó, (iii) control ÂM chứng checker còn sống (thiếu (iii) thì 'fix' kiểu xoá checker cũng xanh). Data-change ngoài CI luôn re-verify SAU status=success.
  • Migration drift prod vs repo — compare ls .../Persistence/Migrations/*.cs vs sqlcmd __EFMigrationsHistory. Fix: check Program.cs/DbInitializer app.MigrateDatabase() + app pool recycle. Mig-applied proof = __EFMigrationsHistory top==repo-HEAD; stuck-old ⟹ pool didn't recycle ⟹ FAIL even if status=success+bundle-rotated.

📋 5-stage checklist (EVERY run)

  • Stage 0 RAG infra: Get-Service Qdrant Running + http://localhost:6333/healthz. Collection proj_solution_erp.
  • Stage 1 Push+filter: git log -1 --format='%H %s' + git log origin/main..HEAD empty + diff vs paths-ignore (docs-only → SKIPPED-DOCS return).
  • Stage 2 Gitea poll (max 10 iter × 60s): API .../actions/tasks?limit=5 (NOT /runs 404). Match head_sha (NOT run_number — cancelled runs shift numbering). ⚠️ updated_at stale ~2min (gotcha #46) → cross-check VPS mtime. Foreground-sleep BLOCKED Windows → Monitor-style busy-wait-curl-spin ~30s/iter.
  • Stage 3 Test gate: baseline 644 PASS (45 Domain + 599 Infra; run #444 0bfadc2 08-01; climb 644/639/622/621/614/609/598/590/566/551/532/509). CI chạy cả 2 proj TRƯỚC build/deploy ⇒ status:success = gate passed (tasks KHÔNG populate conclusion — tin status). Local grep undercount (Theory/InlineData). Phase 9 UAT skip OK.
  • Stage 4 Post-deploy (if SUCCESS): auth login bearer (admin + nv.test gotcha #44; token=accessToken route /api/auth/login) → 3-5 endpoint smoke 2XX (incl new — NEW-endpoint bodyless-POST returns 411 IIS Length-Required pre-auth NOT 404; re-probe WITH body → 401 confirms wired) → FE bundle hash 2 app (per #69 = real-size-vs-fake not hash-delta) → SignalR negotiate (gotcha #25) → EF mig prod==repo.
    • Stage 4.6 (S29): sqlcmd seed verify post-deploy (NOT chỉ schema) — seed = runtime-row-insert (history/tables KHÔNG nhích) ⇒ verify bằng DB-query, không bằng bundle-frozen.
    • enum cần input SỐ (no JsonStringEnumConverter). INFRASTRUCTURE seed ungated / DEMO seed gated → #51.
  • Stage 5 Report PASS/FAIL + evidence + MEMORY update.

⚠️ Anti-patterns (DO NOT)

  1. ❌ Push fix code — READ only, escalate em main · 2. ❌ Speculate fail without log · 3. ❌ Skip post-deploy bundle hash (biggest catch) · 4. ❌ Skip MEMORY · 5. ❌ Poll forever (max 10 iter) · 6. ❌ Auto-rollback (escalate + recommend) · 7. ❌ Verify docs-only (SKIPPED-DOCS return ngay)

🧠 SOLUTION_ERP CI/CD essentials (S80 verified — re-ground từ docs/STATUS.md canonical)

  • Gitea: git.baocaogiaoduc.vn/vietreport-admin/solution-erp · workflow .gitea/workflows/deploy.yml · paths-ignore 7-entry (D10 S111 #495): ['docs/**','**/*.md','.claude/skills/**','.claude/agent-memory/**','.claude/workflows/runs/**','.gitignore','scripts/**.md']. Anon API works (public repo) when GITEA_TOKEN absent.
  • Prod: api/admin/eoffice .solutions.com.vn · SSH ssh vietreport-vps (Administrator, id_ed25519) · IIS phys paths: API C:\inetpub\solution-erp\api · admin \fe-admin · user \fe-user. DB .\SQLEXPRESS/SolutionErp/vrapp SQL-auth. Conn key = ConnectionStrings.Default (NOT DefaultConnection). DB pw = buKL3TGBkD0wDDbYVw65QeX9 (User Id=vrapp; ⚠️ Password field has NO vrapp/ prefix — S89 login-failed when prefix included; read verbatim from prod appsettings.Production.json ConnectionStrings.Default when $env:PROD_DB_PASSWORD empty).
    • SSH→PS quoting (S42): bash→ssh→powershell nuốt $var/\" ⇒ viết .sql/.ps1 rồi scp + sqlcmd -i / powershell -File (đừng nhét inline). sqlcmd -W -h -1 pw-inline. sys-catalog concat → COLLATE DATABASE_DEFAULT.
  • Tests baseline: 644 PASS (45 Domain + 599 Infra · 0 fail/skip; run #444 0bfadc2 08-01). 🔑 Số lấy ở web-UI log https://git.baocaogiaoduc.vn/vietreport-admin/solution-erp/actions/runs/{run_number}/jobs/0/logs (~18KB, KHÔNG có /api/v1/ — api/v1 logs 404) → mỗi project 1 dòng Passed! - Failed: 0, Passed: N, Skipped: 0; đối chiếu TÁCH-PHẦN (45/599) chứ đừng chỉ khớp tổng, và so delta với số Fact mới khai trong commit-msg. ⚠️ Flaky đã khai DeleteContractSigningPlan_SoftDeletes — xanh liên tục #439→#444.
  • Mig latest repo: Mig 71 AddKhkkApprovalGroupCatalogAndFinalizeRuntime (20260731085624, S164 K2) — applied-prod #435, GIỮ qua #436-#444. Path src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/. 🔴 Đếm phải NEO ĐUÔI grep -vE 'Designer\.cs$|ModelSnapshot\.cs$' (recipe cũ grep -v Snapshot ăn nhầm Mig 67 AddPeApprovedBudgetSnapshot). Mạnh hơn khớp-tổng = set-diff repo↔prod 2 chiều (comm -23/-13, cả 2 phải rỗng). Prod: ssh vietreport-vps + sqlcmd -S .\SQLEXPRESS -d SolutionErp -E (⚠️ $env:PROD_DB_PASSWORD KHÔNG tồn tại trên VPS ⇒ dùng -E Windows-auth). ⚠️ sys.tables(is_ms_shipped=0)=97; AddColumn/data-only KHÔNG đổi số. NO-Mig proof = history NOT-advance + empty git diff <base>..<head> -- '*Migrations*'. Bảng mig đầy đủ → skill ef-core-migration.
  • Bundle hash live: baseline #444 (08-01) admin DLRf9TeA/IuRRquXK · eoffice C7TGA4Kn/DesmJ6-_. 🔑 Ship-proof rẻ nhất = so LM prod với dòng dist/assets/index-<hash>.js <size> IN TRONG LOG CI (size khớp tới từng byte: 1,767.41 kB→1767413). ⚠️ marker chuỗi: rolldown/Vite 8 minify ra BACKTICK → grep -F. ⚠️ SNAPSHOT-per-run (#69) → LUÔN re-snapshot LIVE sau status=success; ship-proof = LM-in-window + real-size + marker, KHÔNG phải hash-delta. Control-âm tầng-2 = hash CŨ phải rơi về text/html ~876-900B (SPA-fallback ⇒ bundle cũ đã bị ghi đè). ⚠️ id ≠ run_number (key theo head_sha).
  • Prod DB anchor (POST #438, đứng im tới #444): MenuItems=200 · Permissions=2221 · Roles=13 · họ Khkk% = 56 menu / 728 perm (=56×13) · control revoker Hrm*/Off* CanRead=1 = 29/377. PK MenuItems = [Key] (KHÔNG MenuKey); Permissions(Id,RoleId,**MenuKey**,CanRead,CanCreate,CanUpdate,CanDelete).
  • Bearer: admin admin@solutions.com.vn/Admin@123456 (full) · UAT nv.test@solutions.com.vn/TestUser@123456 (Drafter CCM, gotcha #44 check).
  • API Serilog: sink THẬT C:\inetpub\solution-erppi\logs\solution-erp-YYYYMMDD.log (skill-runbook …\Logs\log-*.txt STALE). Level=Information (seed/revoke lines CÓ ghi). ⚠️ deploy xoá logs/ ⇒ chỉ còn từ deploy cuối.

🔑 Critical config (flag commit nếu tái xuất)

Node CI 20.x (feedback_node_cicd) · MediatR 12.4.1 (gotcha #1, flag Version="14) · Swashbuckle 6.9.0 (gotcha #2) · act_runner manual checkout (#39) · npm cache DISABLED (#40, flag cache: npm)

  • Per-NV opt-in wire (S22-S23) → feedback_per_nv_permission_scope (10 điểm). 2 điểm HAY SÓT: (9) Lookup discrimination (FirstOrDefault thêm ApproverUserId==actorId + admin fallback) · (10) Controller body record count == Command record count.

📊 Run stats baseline

BE ~90s · FE ×2 ~60s/app · deploy ~30s · total ~3min code / 0s docs-only; gần đây 5m3x-6m3x. >8min → escalate.

📅 Recent runs (compressed — verbatim → archive via _INDEX.md)

  • (S98-S132 #383-#397 + PASS-pattern library S69b→S104 #307-#494 all GO (gate 440→509): AS-6 #41 soi TỪNG file vs 7-glob · conclusion:None dù success ⇒ tin status · 411-refine (endpoint MỚI bodyless-POST = 411 IIS pre-auth; re-probe CÓ body → 401/415 = đã wire) · LM mới hơn cửa-sổ đã verify = detector 'có run bỏ sót' · recipe SCHEMA-ADD / DATA-BACKFILL / DATA-SEED · #472 PROD Identity table NON-prefix Roles. verbatim → archive/2026-07.md + 2026-06.md)

  • Older (S83 #325 ← S29 #232) → git d2f52ba + archive/2026-06.md (incl #291 06-16 FAIL [gotcha #65]); pre-S38 → archive/2026-05-*.

🔄 Curate trigger

  • ~30KB → archive recent runs → L2 archive/<period>.md (byte-exact append) + _INDEX.md substring pointer. Dup failure patterns → merge. Stale >3mo → remove.

  • Last curate: 2026-08-01 S168 (self #444-run: 21.3KB→~16.6KB — K7/K6/K5-K4c/K4ab verbatim→archive/2026-08.md NEW + 4 _INDEX pointer; #416→#439 gộp 1 arc-line; baselines gate 644 + bundle #444 + Mig 71 + -E Windows-auth). ⚠️ giữ luật: script sửa MEMORY phải build chuỗi XONG → temp → os.replace → verify byte>0.
  • Prev: S166 08-01 (27.3→16.5) · S162 07-30 (26.9→17) · S118 · S111 · S107 · S104 · S98 (2026-07.md NEW) · S80 38.8→16 · S70 65.2→23.2 · S66 · S40.