[CLAUDE] PurchaseEvaluation: endsBeforeCeo theo RUNTIME (Mig 60 EndedByLevelFinalize) — phiếu lên CEO hết báo sai "không qua CEO" (anh Kiệt FDC UAT)

- Bug: phiếu có cấp AllowApproverFinalize nhưng approver opt-out → lên CEO thật + CEO duyệt, nhưng sơ đồ báo sai "kết thúc tại CCM, không qua CEO" + làm mờ Bước CEO (endsBeforeCeo tính theo CONFIG workflow) - Fix: +field runtime EndedByLevelFinalize (set true CHỈ ở nhánh level-finalize service) → EndsBeforeCeo cho phiếu DaDuyet đọc runtime thay config; ChoDuyet giữ heads-up config - BE: entity + EF config + service + 4 projection (detail/List/Inbox/ListApproved) runtime-aware - Mig 60 AddPeEndedByLevelFinalize + backfill (dò marker "Duyệt KẾT THÚC tại" set phiếu finalize-sớm cũ; ccm-delegation không match → giữ false) - FE: gate làm-mờ finalizeFlowStep theo endsBeforeCeo (2 app SHA-mirror b7abbc2f) - Test 440 PASS (repro peFinButWentCeo: config-finalize + EndedByLevelFinalize=false → false) + reviewer PASS 0-issue Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 19:23:03 +07:00
parent 051d0493ae
commit 8037fa01d1
12 changed files with 6423 additions and 28 deletions
--- a/fe-admin/src/components/pe/PeWorkflowPanel.tsx
+++ b/fe-admin/src/components/pe/PeWorkflowPanel.tsx
@ -118,9 +118,12 @@ export function PeWorkflowPanel({
  // KHÔNG cần ô-tích). FE dùng cờ này để: (1) hiện banner cảnh báo + (2) bắt chọn giá chốt.
  const approverFinalizeEligible = levelOptions?.allowApproverFinalize === true
  // [S89 anh Kiệt FDC] Cấp "Duyệt thay CEO" (finalize) ĐẦU-TIÊN theo thứ tự duyệt trong flow →
-  // badge cấp đó + làm mờ Bước/Cấp SAU ("không trình tới") để người xem phiếu biết quy trình
-  // DỪNG ở cấp này (duyệt thay CEO), không lên Ban Giám đốc.
-  const finalizeFlowStep = evaluation.approvalFlow?.steps.find(s => s.levels.some(l => l.allowApproverFinalize)) ?? null
+  // badge cấp đó + làm mờ Bước/Cấp SAU để người xem phiếu biết quy trình DỪNG ở cấp này.
+  // [S97 anh Kiệt FDC] GATE theo endsBeforeCeo (runtime): phiếu đã đi HẾT lên CEO (approver opt-out
+  // finalize) → BE trả endsBeforeCeo=false → KHÔNG làm mờ, hiện đúng CEO đã duyệt (bug "CEO duyệt mà mờ").
+  const finalizeFlowStep = evaluation.endsBeforeCeo
+    ? (evaluation.approvalFlow?.steps.find(s => s.levels.some(l => l.allowApproverFinalize)) ?? null)
+    : null
  const finalizeFlowLevelOrder = finalizeFlowStep?.levels.find(l => l.allowApproverFinalize)?.order ?? null
  const isStepAfterFinalize = (stepOrder: number) => finalizeFlowStep != null && stepOrder > finalizeFlowStep.order
  const isLevelAfterFinalize = (stepOrder: number, levelOrder: number) =>
--- a/fe-user/src/components/pe/PeWorkflowPanel.tsx
+++ b/fe-user/src/components/pe/PeWorkflowPanel.tsx
@ -118,9 +118,12 @@ export function PeWorkflowPanel({
  // KHÔNG cần ô-tích). FE dùng cờ này để: (1) hiện banner cảnh báo + (2) bắt chọn giá chốt.
  const approverFinalizeEligible = levelOptions?.allowApproverFinalize === true
  // [S89 anh Kiệt FDC] Cấp "Duyệt thay CEO" (finalize) ĐẦU-TIÊN theo thứ tự duyệt trong flow →
-  // badge cấp đó + làm mờ Bước/Cấp SAU ("không trình tới") để người xem phiếu biết quy trình
-  // DỪNG ở cấp này (duyệt thay CEO), không lên Ban Giám đốc.
-  const finalizeFlowStep = evaluation.approvalFlow?.steps.find(s => s.levels.some(l => l.allowApproverFinalize)) ?? null
+  // badge cấp đó + làm mờ Bước/Cấp SAU để người xem phiếu biết quy trình DỪNG ở cấp này.
+  // [S97 anh Kiệt FDC] GATE theo endsBeforeCeo (runtime): phiếu đã đi HẾT lên CEO (approver opt-out
+  // finalize) → BE trả endsBeforeCeo=false → KHÔNG làm mờ, hiện đúng CEO đã duyệt (bug "CEO duyệt mà mờ").
+  const finalizeFlowStep = evaluation.endsBeforeCeo
+    ? (evaluation.approvalFlow?.steps.find(s => s.levels.some(l => l.allowApproverFinalize)) ?? null)
+    : null
  const finalizeFlowLevelOrder = finalizeFlowStep?.levels.find(l => l.allowApproverFinalize)?.order ?? null
  const isStepAfterFinalize = (stepOrder: number) => finalizeFlowStep != null && stepOrder > finalizeFlowStep.order
  const isLevelAfterFinalize = (stepOrder: number, levelOrder: number) =>
--- a/src/Backend/SolutionErp.Application/PurchaseEvaluations/CreateContractFromEvaluationFeatures.cs
+++ b/src/Backend/SolutionErp.Application/PurchaseEvaluations/CreateContractFromEvaluationFeatures.cs
@ -190,11 +190,10 @@ public class ListApprovedPurchaseEvaluationsQueryHandler(IApplicationDbContext d
                 join sup in db.Suppliers on sw.SupplierId equals sup.Id
                 orderby sup.Name
                 select sup.Name).ToList(),                       // [S69] cờ gấp + [Mig 58] winner names
-                // [S89 Mig 58] "Duyệt là KẾT THÚC (không trình CEO)" — 3 subquery riêng mirror
-                // winner-names (EF-safe). Cùng DTO PurchaseEvaluationListItemDto. V1 → false/null.
-                (from lv in db.ApprovalWorkflowLevels
-                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == e.ApprovalWorkflowId
-                 select 1).Any(),
+                // [S89 Mig 58] "Duyệt là KẾT THÚC (không trình CEO)" — FinalizeStep/LevelName mirror
+                // winner-names (EF-safe). [S97] EndsBeforeCeo: ListApproved = DaDuyet-only (filter trên)
+                // → đọc THẲNG runtime flag EndedByLevelFinalize (phiếu opt-out lên CEO → false, hết badge sai).
+                e.EndedByLevelFinalize,
                (from lv in db.ApprovalWorkflowLevels
                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == e.ApprovalWorkflowId
                 orderby lv.Step!.Order, lv.Order
--- a/src/Backend/SolutionErp.Application/PurchaseEvaluations/PurchaseEvaluationFeatures.cs
+++ b/src/Backend/SolutionErp.Application/PurchaseEvaluations/PurchaseEvaluationFeatures.cs
@ -642,9 +642,13 @@ public class ListPurchaseEvaluationsQueryHandler(
                // (mirror winner-names — EF-safe; record-ctor projection KHÔNG cho biến trung
                // gian nên không gộp tuple). lv.Step!.Name = simple navigation chắc translate.
                // ApprovalWorkflowId==null → subquery rỗng → false/null (V1 tự đúng).
-                (from lv in db.ApprovalWorkflowLevels
-                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
-                 select 1).Any(),
+                // [S97] runtime: phiếu DaDuyet đọc EndedByLevelFinalize (finalize sớm THẬT);
+                // chưa xong → config-subquery. Phiếu-đã-lên-CEO KHÔNG hiện badge "Kết thúc" sai.
+                x.e.Phase == PurchaseEvaluationPhase.DaDuyet
+                    ? x.e.EndedByLevelFinalize
+                    : (from lv in db.ApprovalWorkflowLevels
+                       where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
+                       select 1).Any(),
                (from lv in db.ApprovalWorkflowLevels
                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
                 orderby lv.Step!.Order, lv.Order
@ -758,9 +762,13 @@ public class GetMyPurchaseEvaluationInboxQueryHandler(
                // [S89 Mig 58] "Duyệt là KẾT THÚC (không trình CEO)" — 3 subquery riêng mirror
                // winner-names (EF-safe). lv.Step!.Name simple navigation. ApprovalWorkflowId
                // ==null → subquery rỗng → false/null (V1 tự đúng).
-                (from lv in db.ApprovalWorkflowLevels
-                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
-                 select 1).Any(),
+                // [S97] runtime: phiếu DaDuyet đọc EndedByLevelFinalize (finalize sớm THẬT);
+                // chưa xong → config-subquery. Phiếu-đã-lên-CEO KHÔNG hiện badge "Kết thúc" sai.
+                x.e.Phase == PurchaseEvaluationPhase.DaDuyet
+                    ? x.e.EndedByLevelFinalize
+                    : (from lv in db.ApprovalWorkflowLevels
+                       where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
+                       select 1).Any(),
                (from lv in db.ApprovalWorkflowLevels
                 where lv.AllowApproverFinalize && lv.Step!.ApprovalWorkflowId == x.e.ApprovalWorkflowId
                 orderby lv.Step!.Order, lv.Order
@ -1139,7 +1147,12 @@ public class GetPurchaseEvaluationQueryHandler(
                {
                    var finalizeLevel = finalizeStep.Levels
                        .Where(l => l.AllowApproverFinalize).OrderBy(l => l.Order).FirstOrDefault();
-                    endsBeforeCeo = true;
+                    // [S97] endsBeforeCeo theo RUNTIME cho phiếu DaDuyet (đọc EndedByLevelFinalize):
+                    // phiếu đi HẾT lên CEO (approver opt-out finalize) → false, KHÔNG hiện "không qua
+                    // CEO". Phiếu chưa xong (ChoDuyet…) giữ heads-up config (còn cấp finalize phía trước).
+                    endsBeforeCeo = phase == PurchaseEvaluationPhase.DaDuyet
+                        ? e.EndedByLevelFinalize
+                        : true;
                    finalizeStepName = finalizeStep.DepartmentId is Guid fsd
                        && stepDeptNames.TryGetValue(fsd, out var fsdn) ? fsdn : finalizeStep.Name;
                    finalizeLevelName = finalizeLevel?.Name;
--- a/src/Backend/SolutionErp.Domain/PurchaseEvaluations/PurchaseEvaluation.cs
+++ b/src/Backend/SolutionErp.Domain/PurchaseEvaluations/PurchaseEvaluation.cs
@ -97,6 +97,13 @@ public class PurchaseEvaluation : AuditableEntity
    public decimal? ApprovedPriceAmount { get; set; }
    public string? ApprovedPriceSource { get; set; }

+    // [S97 2026-07-01 — anh Kiệt FDC] RUNTIME fact: phiếu này ĐÃ kết thúc sớm bằng level-finalize
+    // ("Duyệt thay CEO", short-circuit TRƯỚC cấp cuối/CEO)? Set true DUY NHẤT ở nhánh finalize của
+    // ApproveV2Async. Default false = phiếu đi HẾT quy trình (qua CEO). Phân biệt CONFIG "workflow
+    // CÓ cấp finalize" vs RUNTIME "phiếu NÀY finalize sớm" — EndsBeforeCeo (display) đọc field này
+    // cho phiếu DaDuyet để phiếu-đã-lên-CEO KHÔNG còn hiện sai "không qua CEO" (bug anh Kiệt S97).
+    public bool EndedByLevelFinalize { get; set; }
+
    public List<PurchaseEvaluationSupplier> Suppliers { get; set; } = new();
    public List<PurchaseEvaluationDetail> Details { get; set; } = new();
    public List<PurchaseEvaluationQuote> Quotes { get; set; } = new();
--- a/src/Backend/SolutionErp.Infrastructure/Persistence/Configurations/PurchaseEvaluationConfiguration.cs
+++ b/src/Backend/SolutionErp.Infrastructure/Persistence/Configurations/PurchaseEvaluationConfiguration.cs
@ -38,6 +38,8 @@ public class PurchaseEvaluationConfiguration : IEntityTypeConfiguration<Purchase
        // nullable, KHÔNG index (free-text). Mirror HoSoLink + PeWorkItemBudget.CcmNote.
        b.Property(x => x.ProSuggestedPriceNote).HasMaxLength(1000);
        b.Property(x => x.CcmSuggestedPriceNote).HasMaxLength(1000);
+        // [S97 2026-07-01] Runtime finalize-fact — bit NOT NULL default false (mirror IsUrgent* bool).
+        b.Property(x => x.EndedByLevelFinalize).HasDefaultValue(false);

        b.HasIndex(x => x.MaPhieu).IsUnique().HasFilter("[MaPhieu] IS NOT NULL");
        b.HasIndex(x => new { x.Phase, x.IsDeleted });
--- a/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/20260701120138_AddPeEndedByLevelFinalize.Designer.cs
+++ b/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/20260701120138_AddPeEndedByLevelFinalize.Designer.cs
--- a/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/20260701120138_AddPeEndedByLevelFinalize.cs
+++ b/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/20260701120138_AddPeEndedByLevelFinalize.cs
@ -0,0 +1,42 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace SolutionErp.Infrastructure.Persistence.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddPeEndedByLevelFinalize : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<bool>(
+                name: "EndedByLevelFinalize",
+                table: "PurchaseEvaluations",
+                type: "bit",
+                nullable: false,
+                defaultValue: false);
+
+            // [S97 anh Kiệt FDC] Backfill: phiếu DaDuyet (Phase=7) đã kết thúc SỚM bằng level-finalize
+            // để lại marker "[Duyệt KẾT THÚC tại ...]" trong LogTransition comment → set =1. Phiếu đi
+            // HẾT lên CEO (không marker) giữ default 0 → EndsBeforeCeo hiện đúng "qua CEO". SQL-Server-only
+            // (Dev/prod migrations); tests dùng EnsureCreated KHÔNG replay migration (gotcha #63).
+            migrationBuilder.Sql(@"
+UPDATE pe SET EndedByLevelFinalize = 1
+FROM PurchaseEvaluations pe
+WHERE pe.Phase = 7
+  AND EXISTS (
+      SELECT 1 FROM PurchaseEvaluationApprovals a
+      WHERE a.PurchaseEvaluationId = pe.Id
+        AND a.Comment LIKE N'%Duyệt KẾT THÚC tại%');");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "EndedByLevelFinalize",
+                table: "PurchaseEvaluations");
+        }
+    }
+}
--- a/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/ApplicationDbContextModelSnapshot.cs
+++ b/src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/ApplicationDbContextModelSnapshot.cs
@ -4653,6 +4653,11 @@ namespace SolutionErp.Infrastructure.Persistence.Migrations
                    b.Property<Guid?>("DrafterUserId")
                        .HasColumnType("uniqueidentifier");

+                    b.Property<bool>("EndedByLevelFinalize")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bit")
+                        .HasDefaultValue(false);
+
                    b.Property<decimal?>("ExpectedRemainingAmount")
                        .HasPrecision(18, 2)
                        .HasColumnType("decimal(18,2)");
--- a/src/Backend/SolutionErp.Infrastructure/Services/PurchaseEvaluationWorkflowService.cs
+++ b/src/Backend/SolutionErp.Infrastructure/Services/PurchaseEvaluationWorkflowService.cs
@ -866,6 +866,9 @@ public class PurchaseEvaluationWorkflowService(
        // auto-finalize im lặng) theo phản hồi UAT "cái này option thôi". Default true = giữ auto cũ.
        if (matchingLevel.AllowApproverFinalize && applyLevelFinalize)
        {
+            // [S97 anh Kiệt FDC] Đánh dấu RUNTIME: phiếu kết thúc sớm tại cấp finalize (không lên CEO)
+            // → EndsBeforeCeo display đọc cờ này thay vì suy từ config (phiếu opt-out lên CEO hiện đúng).
+            evaluation.EndedByLevelFinalize = true;
            ApplyApprovedPriceOnFinalize(evaluation, isSystem, approvedPriceAmount, approvedPriceSource);
            evaluation.Phase = PurchaseEvaluationPhase.DaDuyet;
            evaluation.CurrentWorkflowStepIndex = null;
--- a/tests/SolutionErp.Infrastructure.Tests/Application/PeFinalizeProjectionTests.cs
+++ b/tests/SolutionErp.Infrastructure.Tests/Application/PeFinalizeProjectionTests.cs
@ -9,13 +9,24 @@ using SolutionErp.Infrastructure.Tests.Common;
 namespace SolutionErp.Infrastructure.Tests.Application;

 // [S89 anh Kiệt FDC] PE finalize-note (Mig 58 AllowApproverFinalize) — TRANSLATION-SMOKE
-// cho 3 subquery mới (EndsBeforeCeo / FinalizeStepName / FinalizeLevelName) trong list
-// projection. Subquery: (from lv in db.ApprovalWorkflowLevels where lv.AllowApproverFinalize
+// cho subquery FinalizeStepName / FinalizeLevelName trong list projection. Subquery:
+// (from lv in db.ApprovalWorkflowLevels where lv.AllowApproverFinalize
 // && lv.Step!.ApprovalWorkflowId == e.ApprovalWorkflowId orderby lv.Step!.Order, lv.Order
 // select lv.Step!.Name / lv.Name).FirstOrDefault() — PHẢI translate trên EF SQLite (rủi ro
 // reviewer cảnh báo). Target = ListApprovedPurchaseEvaluationsQuery (sạch nhất: chỉ
-// Phase==DaDuyet, KHÔNG role-paging) — cùng subquery xuất hiện ở List + Inbox projection.
-// Verify: translate (không ném) + first-reachable (Step.Order↑→Level.Order↑) + V1 null→false.
+// Phase==DaDuyet, KHÔNG role-paging).
+//
+// ⚠️ [S97 2026-07-01 SPEC CHANGE — anh Kiệt FDC] EndsBeforeCeo ĐỔI CONFIG-driven → RUNTIME-driven.
+//   Bug: workflow CÓ cấp AllowApproverFinalize NHƯNG người duyệt chọn trình tiếp → phiếu LÊN CEO
+//   thật → sơ đồ vẫn báo sai "Duyệt là KẾT THÚC, không qua CEO" (vì suy từ config = luôn true).
+//   Fix (em-main BE): field PurchaseEvaluation.EndedByLevelFinalize (bool, Mig 60) set true DUY
+//   NHẤT ở nhánh level-finalize của ApproveV2Async. ListApproved (DaDuyet-only) đọc THẲNG field
+//   này thay 3-subquery-Any cũ (CreateContractFromEvaluationFeatures.cs:196). FinalizeStep/LevelName
+//   VẪN từ config-subquery (chỉ nhãn hiển-thị tên cấp finalize, không phải cờ true/false).
+//   → test cũ (finalize-config nhưng KHÔNG set field) giờ EndsBeforeCeo=FALSE → seed field=true.
+//   → repro case MỚI: config-có-finalize + field=false (đi hết lên CEO) → PHẢI false (chính bug).
+// Verify: EF translate (không ném) + config-name first-reachable (Step.Order↑→Level.Order↑) +
+//   runtime-field độc-lập-config + V1 null→false.
 // IdentityFixture: ApproverUserId là Guid non-null (FK) → cần 1 User row thật.
 public class PeFinalizeProjectionTests
 {
@ -57,7 +68,12 @@ public class PeFinalizeProjectionTests
        return wf;
    }

-    private static Guid SeedApprovedPe(TestApplicationDbContext db, Guid projectId, Guid? wfId, string code)
+    // [S97] endedByLevelFinalize = RUNTIME fact phiếu ĐÃ finalize sớm tại cấp "Duyệt thay CEO"
+    // (short-circuit TRƯỚC CEO). ListApproved đọc THẲNG field này (DaDuyet-only) → EndsBeforeCeo.
+    // Config "workflow CÓ cấp finalize" (wfId có slot AllowApproverFinalize) KHÔNG còn quyết định.
+    private static Guid SeedApprovedPe(
+        TestApplicationDbContext db, Guid projectId, Guid? wfId, string code,
+        bool endedByLevelFinalize = false)
    {
        var id = Guid.NewGuid();
        db.PurchaseEvaluations.Add(new PurchaseEvaluation
@ -71,12 +87,13 @@ public class PeFinalizeProjectionTests
            ContractId = null,                          // chưa gen HĐ → lọt picker
            DrafterUserId = null,
            ApprovalWorkflowId = wfId,
+            EndedByLevelFinalize = endedByLevelFinalize,
        });
        return id;
    }

    [Fact]
-    public async Task ListApproved_FinalizeFields_Translate_FirstReachable_V1False()
+    public async Task ListApproved_FinalizeFields_Translate_RuntimeDriven_ConfigNamesOnly_V1False()
    {
        using var fix = new IdentityFixture();
        var db = fix.Services.GetRequiredService<TestApplicationDbContext>();
@ -86,28 +103,44 @@ public class PeFinalizeProjectionTests
        db.Projects.Add(project);

        // Bước 1 (Cấp 1, no-flag) → Bước 2 (Cấp 1, FINALIZE). first-reachable = Bước 2 · Cấp 1.
+        // 1 workflow CÓ cấp finalize dùng cho 2 phiếu (khác nhau CHỈ ở runtime field) → chứng
+        // minh EndsBeforeCeo lấy từ EndedByLevelFinalize, KHÔNG suy từ config workflow.
        var wfFin = BuildWorkflow("QT-FIN", approver.Id,
            ("Bước 1", new[] { ("Cấp 1", false) }),
            ("Bước 2", new[] { ("Cấp 1", true) }));
        db.ApprovalWorkflows.Add(wfFin);
-        // Không cấp nào finalize → endsBeforeCeo=false.
+        // Không cấp nào finalize → config-name null + field mặc-định false.
        var wfPlain = BuildWorkflow("QT-PLAIN", approver.Id, ("Bước 1", new[] { ("Cấp 1", false) }));
        db.ApprovalWorkflows.Add(wfPlain);

-        var peFin = SeedApprovedPe(db, project.Id, wfFin.Id, "PE-FIN");
+        // [S97] peFin: config-có-finalize + phiếu ĐÃ finalize sớm (EndedByLevelFinalize=true) → true.
+        var peFin = SeedApprovedPe(db, project.Id, wfFin.Id, "PE-FIN", endedByLevelFinalize: true);
+        // 🔴 [S97 REPRO — bug anh Kiệt] CÙNG workflow-có-finalize NHƯNG người duyệt trình tiếp →
+        // phiếu LÊN CEO thật (EndedByLevelFinalize=false) → EndsBeforeCeo PHẢI false (không được
+        // suy từ config = true như trước fix). Đây là contrast quyết định runtime-vs-config.
+        var peFinButWentCeo = SeedApprovedPe(db, project.Id, wfFin.Id, "PE-FIN-CEO", endedByLevelFinalize: false);
        var pePlain = SeedApprovedPe(db, project.Id, wfPlain.Id, "PE-PLAIN");
        var peV1 = SeedApprovedPe(db, project.Id, null, "PE-V1");   // V1 legacy: no workflow
        await db.SaveChangesAsync(CancellationToken.None);

        var handler = new ListApprovedPurchaseEvaluationsQueryHandler(db);
-        // Nếu 3 subquery KHÔNG translate → ném InvalidOperationException = FAIL (blocker).
+        // Nếu FinalizeStep/LevelName subquery KHÔNG translate → ném InvalidOperationException = FAIL.
        var res = await handler.Handle(new ListApprovedPurchaseEvaluationsQuery(), CancellationToken.None);

+        // Phiếu finalize sớm THẬT → true; FinalizeStep/LevelName vẫn từ config (nhãn cấp finalize).
        var fin = res.Single(x => x.Id == peFin);
-        fin.EndsBeforeCeo.Should().BeTrue();
+        fin.EndsBeforeCeo.Should().BeTrue("phiếu ĐÃ kết thúc sớm tại cấp finalize (runtime field true)");
        fin.FinalizeStepName.Should().Be("Bước 2");   // first-reachable bỏ qua Bước 1 no-flag
        fin.FinalizeLevelName.Should().Be("Cấp 1");

+        // 🔴 REPRO: cùng config finalize nhưng phiếu đi hết lên CEO → EndsBeforeCeo=false (bug fix).
+        var finCeo = res.Single(x => x.Id == peFinButWentCeo);
+        finCeo.EndsBeforeCeo.Should().BeFalse(
+            "config CÓ cấp finalize nhưng phiếu lên CEO thật (EndedByLevelFinalize=false) → KHÔNG hiện 'không qua CEO'");
+        // FinalizeStep/LevelName vẫn phản ánh config (workflow này có cấp finalize) — chỉ EndsBeforeCeo runtime.
+        finCeo.FinalizeStepName.Should().Be("Bước 2");
+        finCeo.FinalizeLevelName.Should().Be("Cấp 1");
+
        res.Single(x => x.Id == pePlain).EndsBeforeCeo.Should().BeFalse();
        res.Single(x => x.Id == peV1).EndsBeforeCeo.Should().BeFalse();   // V1 null-workflow tự đúng
    }
--- a/tests/SolutionErp.Infrastructure.Tests/Services/PeApproverFinalizeTests.cs
+++ b/tests/SolutionErp.Infrastructure.Tests/Services/PeApproverFinalizeTests.cs
@ -164,6 +164,8 @@ public class PeApproverFinalizeTests
            pe.SlaDeadline.Should().BeNull("terminal → SLA null");
            pe.ApprovedPriceAmount.Should().Be(ValidApprovedPrice, "giá chốt bind khi finalize");
            pe.ApprovedPriceSource.Should().Be(ValidApprovedSource);
+            // [S97 anh Kiệt FDC] nhánh level-finalize set RUNTIME flag → EndsBeforeCeo display đọc field này.
+            pe.EndedByLevelFinalize.Should().BeTrue("finalize sớm tại cấp này → cờ runtime = true");

            // CEO KHÔNG được ghi opinion (bị bỏ qua — chỉ approver Bước 1 ký).
            var opinions = await db.PurchaseEvaluationLevelOpinions
@ -212,6 +214,8 @@ public class PeApproverFinalizeTests
            pe.CurrentApprovalLevelOrder.Should().Be(1);
            pe.SlaDeadline.Should().Be(clock.UtcNow.AddDays(7), "SLA reset cho CEO");
            pe.ApprovedPriceAmount.Should().BeNull("chưa terminal → chưa bind giá chốt");
+            // [S97] KHÔNG qua nhánh finalize (advance lên CEO) → cờ runtime giữ false → EndsBeforeCeo false.
+            pe.EndedByLevelFinalize.Should().BeFalse("advance lên CEO (không finalize) → cờ runtime = false");
        }
    }

@ -360,6 +364,10 @@ public class PeApproverFinalizeTests
            pe.CurrentApprovalLevelOrder.Should().Be(1);
            pe.SlaDeadline.Should().Be(clock.UtcNow.AddDays(7), "SLA reset cho CEO");
            pe.ApprovedPriceAmount.Should().BeNull("opt-out → chưa terminal → chưa bind giá chốt");
+            // [S97 bug anh Kiệt] config-có-finalize NHƯNG opt-out → lên CEO thật → cờ runtime PHẢI
+            // false (đây chính là kịch bản projection repro EndsBeforeCeo=false, không hiện sai badge).
+            pe.EndedByLevelFinalize.Should().BeFalse(
+                "opt-out finalize → phiếu lên CEO thật → cờ runtime false → EndsBeforeCeo sẽ false");

            // approver VẪN ghi opinion (đã duyệt cấp mình), CEO chưa.
            var opinions = await db.PurchaseEvaluationLevelOpinions