[CLAUDE] PurchaseEvaluation: cờ gấp PRO/CCM + CCM duyệt-final theo ngưỡng giá trị (Mig 53) + 14 test

Yêu cầu anh Kiệt FDC (sau họp sếp). Mig 53 AddPeUrgentAndCeoApprovalThreshold — 3 AddColumn, no new table (Mig 52→53). Rollout an toàn: cột nullable, ngưỡng null = giữ luồng duyệt cũ 100% cho tới khi admin set.

B — CCM duyệt-final theo NGƯỠNG GIÁ TRỊ ("gói CEO phân quyền theo giá trị"):
- ApprovalWorkflow += CeoApprovalThreshold (decimal?, admin nhập trong Workflow Designer).
- ApproveV2Async: actor role CostControl (CCM) + winnerQuoteTotal (tổng giá NCC được chọn) < ngưỡng → DaDuyet luôn (bỏ CEO); ≥ ngưỡng → đẩy lên CEO như cũ. Ngưỡng null = luồng tuyến tính cũ. Q4 chốt nhận diện theo ROLE người duyệt.
- reviewer PASS 0 blocker: cascade-safe (Off/role không lan), tested load-bearing (CCM dưới ngưỡng → DaDuyet skip CEO).

A — cờ gấp per-vai (visibility-only, Q3 KHÔNG đổi luồng):
- PE += IsUrgentByPro (PRO đỏ) / IsUrgentByCcm (CCM xanh).
- Endpoint PUT /purchase-evaluations/{id}/urgent role-gated (Procurement→ByPro, CostControl→ByCcm, Admin→cả 2, khác→Forbidden) + notify CEO (Director) khi MỚI bật (best-effort).

FE ×2 app: Workflow Designer ô "Ngưỡng giá trị gói CEO" (fe-admin) + PE detail nút bật/tắt cờ gấp đỏ/xanh theo role + badge GẤP + hint "giá trị gói vs ngưỡng → CCM duyệt-final/cần CEO" + PE list badge gấp.
DTO: PE detail += isUrgentByPro/Ccm + winnerQuoteTotal + ceoApprovalThreshold; list += isUrgentByPro/Ccm; workflow V2 += ceoApprovalThreshold.

+14 test (292→306): PeCcmThresholdFinalizeTests 5 (B routing) + PeUrgentToggleAuthzTests 9 (A authz). Build slnx 0/0 · npm build ×2 0 err · dotnet test 306 PASS.

C (sau duyệt xong chuyển phiếu đến dự án) — chờ anh Kiệt làm chi tiết form, CHƯA làm.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/Backend/SolutionErp.Infrastructure/Persistence/Configurations/ApprovalWorkflowConfiguration.cs

@@ -16,6 +16,10 @@ public class ApprovalWorkflowConfiguration : IEntityTypeConfiguration<ApprovalWo
         e.Property(x => x.Description).HasMaxLength(1000);
         e.Property(x => x.ApplicableType).HasConversion<int>();
 
+        // [S69 2026-06-17] Ngưỡng giá trị "gói CEO" — decimal(18,2), nullable
+        // (null = không áp ngưỡng, giữ luồng tuyến tính cũ).
+        e.Property(x => x.CeoApprovalThreshold).HasPrecision(18, 2);
+
         e.HasIndex(x => new { x.Code, x.Version }).IsUnique();
         e.HasIndex(x => new { x.ApplicableType, x.IsActive });
 

src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/20260617060207_AddPeUrgentAndCeoApprovalThreshold.cs

@@ -0,0 +1,52 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace SolutionErp.Infrastructure.Persistence.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddPeUrgentAndCeoApprovalThreshold : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<bool>(
+                name: "IsUrgentByCcm",
+                table: "PurchaseEvaluations",
+                type: "bit",
+                nullable: false,
+                defaultValue: false);
+
+            migrationBuilder.AddColumn<bool>(
+                name: "IsUrgentByPro",
+                table: "PurchaseEvaluations",
+                type: "bit",
+                nullable: false,
+                defaultValue: false);
+
+            migrationBuilder.AddColumn<decimal>(
+                name: "CeoApprovalThreshold",
+                table: "ApprovalWorkflows",
+                type: "decimal(18,2)",
+                precision: 18,
+                scale: 2,
+                nullable: true);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "IsUrgentByCcm",
+                table: "PurchaseEvaluations");
+
+            migrationBuilder.DropColumn(
+                name: "IsUrgentByPro",
+                table: "PurchaseEvaluations");
+
+            migrationBuilder.DropColumn(
+                name: "CeoApprovalThreshold",
+                table: "ApprovalWorkflows");
+        }
+    }
+}

src/Backend/SolutionErp.Infrastructure/Persistence/Migrations/ApplicationDbContextModelSnapshot.cs

@@ -137,6 +137,10 @@ namespace SolutionErp.Infrastructure.Persistence.Migrations
                     b.Property<int>("ApplicableType")
                         .HasColumnType("int");
 
+                    b.Property<decimal?>("CeoApprovalThreshold")
+                        .HasPrecision(18, 2)
+                        .HasColumnType("decimal(18,2)");
+
                     b.Property<string>("Code")
                         .IsRequired()
                         .HasMaxLength(100)
@@ -4624,6 +4628,12 @@ namespace SolutionErp.Infrastructure.Persistence.Migrations
                     b.Property<bool>("IsDeleted")
                         .HasColumnType("bit");
 
+                    b.Property<bool>("IsUrgentByCcm")
+                        .HasColumnType("bit");
+
+                    b.Property<bool>("IsUrgentByPro")
+                        .HasColumnType("bit");
+
                     b.Property<string>("MaPhieu")
                         .HasMaxLength(100)
                         .HasColumnType("nvarchar(100)");

src/Backend/SolutionErp.Infrastructure/Services/PurchaseEvaluationWorkflowService.cs

@@ -813,6 +813,46 @@ public class PurchaseEvaluationWorkflowService(
             }
         }
 
+        // [S69 2026-06-17] CCM duyệt-final theo NGƯỠNG GIÁ TRỊ (anh Kiệt FDC). Khi NV
+        // duyệt có role CostControl (CCM) + quy trình set CeoApprovalThreshold + giá trị
+        // gói (tổng giá NCC được chọn, winnerQuoteTotal) < ngưỡng → DaDuyet luôn, BỎ các
+        // Bước/Cấp còn lại (CEO). Q4 chốt: nhận diện theo ROLE người duyệt. Ngưỡng null =
+        // bỏ qua (luồng tuyến tính cũ — rollout an toàn). Cờ gấp KHÔNG ảnh hưởng routing
+        // (visibility-only, Q3). Guard "chưa ở slot cuối" → chỉ skip-forward (nếu CCM đã
+        // ở Cấp cuối Bước cuối thì normal-advance bên dưới cũng ra DaDuyet). Giả định quy
+        // trình đặt CCM ngay trước CEO — UAT anh Kiệt xác nhận cấu trúc.
+        if (aw.CeoApprovalThreshold is decimal ceoThreshold
+            && actorRoles.Contains(AppRoles.CostControl)
+            && !(currentIdx == steps.Count - 1 && currentLevelOrder == maxLevelOrder))
+        {
+            var winnerSupplierRowIds = await db.PurchaseEvaluationSuppliers.AsNoTracking()
+                .Where(s => s.PurchaseEvaluationId == evaluation.Id
+                    && s.SupplierId == evaluation.SelectedSupplierId)
+                .Select(s => s.Id)
+                .ToListAsync(ct);
+            var winnerQuoteTotal = winnerSupplierRowIds.Count == 0 ? 0m
+                : await db.PurchaseEvaluationQuotes.AsNoTracking()
+                    .Where(q => winnerSupplierRowIds.Contains(q.PurchaseEvaluationSupplierId))
+                    .SumAsync(q => (decimal?)q.ThanhTien, ct) ?? 0m;
+
+            if (winnerQuoteTotal < ceoThreshold)
+            {
+                evaluation.Phase = PurchaseEvaluationPhase.DaDuyet;
+                evaluation.CurrentWorkflowStepIndex = null;
+                evaluation.CurrentApprovalLevelOrder = null;
+                evaluation.SlaDeadline = null;
+                await LogTransitionAsync(
+                    evaluation,
+                    PurchaseEvaluationPhase.ChoDuyet,
+                    PurchaseEvaluationPhase.DaDuyet,
+                    actorUserId,
+                    ApprovalDecision.Approve,
+                    $"[CCM duyệt cuối — gói {winnerQuoteTotal:N0}đ < ngưỡng CEO {ceoThreshold:N0}đ, không cần CEO duyệt] {comment ?? ""}".Trim(),
+                    ct);
+                return;
+            }
+        }
+
         // Advance: nếu còn cấp tiếp trong Step → levelOrder++; else → next Step + level 1
         if (currentLevelOrder < maxLevelOrder)
         {