[CLAUDE] Contract: UAT S174 dot-D + C3 — O6/O4/O7/O8 + 2 tong toan phieu (FE-only, 0-mig)

Owner S175 chot cach doc "sum tong" (gate TIEN): (1) truc = CHI TONG TOAN PHIEU, KHONG co
dong tong per-NCC; (2) hien 2 TONG RIENG canh nhau — Sigma gia DE XUAT ⟂ Sigma gia DUYET,
dat PHIA TREN bang. Mirror 9 CAP file sha256 khop 9/9; build XANH ca 2 app, 0 error TS.

=== O6 — bam card PE tren cay GIU NGUYEN man KHKK ===
+callback `onOpenPe` (usePipelineStages) mirror DOI XUNG `onOpenKhkk` cua leaf GD2.
KHONG truyen => giu `navigate('/purchase-evaluations?id=..&expand=1')` => 5 host cay con lai
0 doi hanh vi (da verify: chi KhkkListPage truyen).
Host: `?pe=<id>` render `PeDetailTabs readOnly mode="workspace"` ngay panel 2 — DUNG LAI
renderer that cua man PE thay vi dung ban rut gon thu hai (2 ban = 2 su that).
🔴 `pe` va `id` LOAI TRU NHAU (2 setter cung xoa key kia): panel 2 chi ve duoc mot thu, de
ca hai thi lan chon sau khong xoa duoc lan truoc.
`<lg` roi ve duong cu (khong co panel 2 thi xem-tai-cho la bat kha).
Panel 3 doi chu khi dang xem PE — cau cu "se hien khi chon phieu" la SAI (phieu DA chon roi).

=== O4 — shopdrawing / can cu ho so cho dinh kem file (FE-only) ===
🔴 0 BE MOI — rail da du: controller `[FromForm] Guid? dossierItemId` (:181) + DTO
`KhkkAttachmentDto.dossierItemId` (:241) co tu Mig 69. FE truoc day don gian la KHONG BAO GIO
gui truong do len => moi file roi ve muc PHIEU. Nay upload gui kem dossierItemId.
Chia 2 ro: file gan can cu hien ngay DUOI dong can cu do; Section 4 chi con file muc phieu —
khong chia thi file hien o CA HAI cho, nguoi dung dem 2 lan.
Dong-con file hien CA KHI read-only (nguoi duyet can xem shopdrawing, chi khong them/xoa).

=== O7 — nut edit tren card KHKK (man Thao tac) ===
But chi khuon `PeListPanel:208-232`. LUON hien roi MO DI khi khong sua duoc: nut chi-hien-khi-
hover thi tren may cam-ung khong ai tim ra; an han khi phieu khoa thi nguoi dung tuong chuc
nang khong ton tai thay vi hieu la phieu da di duyet.
🔴 Nut NGOAI the <button> cua card — long button trong button la HTML khong hop le.
Host: but chi => mo che-do SUA; than card => chi xem nhu cu. Guard readOnly Y HET
`KhkkListPage:147-150` (cung mot cau hoi "ai duoc sua" phai cho cung mot cau tra loi o moi man).
Da verify khong phai co-hoc: `KhkkDetailContent:161` `isDraft = draftPhase && !readOnly`.

=== O8 — cay 2 cap Du an > Hang muc ===
🔴 0 ENDPOINT MOI: `workItemName` DA co san trong `KhkkPeCandidateDto:423` => cap 2 la gom lai
tren du-lieu dang co. Truoc day 1 cap theo du an nen mot du an nhieu goi thau do ra danh sach
phang dai, khong thay ranh gioi hang muc.
🔴 2 muc `z` khac nhau (z-20 cha / z-10 con): cung z thi header hang muc truot DE len header
du an khi cuon, mat cap cha.

=== C3 — Field: value ve slate-900, label giu brand-600 ===
Truoc day MOI value deu to brand => mau thuong-hieu mat het suc nang: ca trang deu la mau nhan
thi khong con gi la nhan, va khong chua duoc mau cho thu THAT SU can noi (NCC trung thau,
canh bao vuot ngan sach). PE giu slate cho value dung vi ly do nay.

=== O3 — MOI LAND VE (2). VE (1) CHUA LAM — xem CON NO ===
🔴 KHONG cong gop 2 cot thanh mot so "hien hanh": de-xuat va duyet la 2 so co y nghia phap-ly
khac nhau (mot cai chua ai chot, mot cai da qua choke-point `ApplyApprovedValuesOnFinalize`);
tron lai la bia ra mot so khong ton tai trong ho-so nao.
Tong duyet chi cong phan DA co, va noi ro con bao nhieu dong chua chot.

=== 🔴 CON NO — O3 ve (1) "hang muc cho chon NHIEU" KHONG PHAI FE-ONLY ===
Spec ghi O3 = "N-ROW 0-migration". "0-migration" DUNG (unique 3 cot PlanId+SupplierId+
CatalogEntryId co tu Mig 71) NHUNG KHONG co nghia la 0 BE. Do that:
  · KHONG co endpoint TAO line. Chi co `PUT /{id}/lines/{lineId}` = gan catalogEntryId cho
    dong DA CO (Controller:121). Danh sach route day du: 0 route POST/DELETE line.
  · Line duoc auto-sinh 1-dong-moi-NCC-trung-thau luc TAO PHIEU (`Features.cs:508-527`),
    tien moi = tong bao gia DUOC CHON cua NCC do.
=> Muon 1 NCC co N hang muc phai TACH tien cua NCC do ra N phan — va KHONG CO quy tac nao
   trong he thong noi chia the nao. Do la cau hoi TIEN, chua ai tra loi.
🔸 Tin tot: BE cau HD da nhan N dong san (`CreateContractFromSigningPlanFeatures:101-115`
   nhan `LineIds` list, chi rao "moi HD 1 NCC"). Cai hep la FE dialog dung radio single-select
   (`KhkkDetailPage:310`) — do la UI, doi duoc.

=== CON NO KHAC ===
🔴 CHUA soi mat tren prod 375/1366/1440 (5 lane NO-SCREENSHOT, gotcha #3) — moi ket luan la
DOC MA, khong phai da nhin.

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

fe-admin/src/components/khkk/KhkkWorkListPanel.tsx

@@ -24,7 +24,7 @@
 // con). Người chỉ có quyền PE mà không có KHKK sẽ ăn 403 rải khắp cột. ⇒ gate bằng ĐÚNG key
 // của endpoint, và khi thiếu quyền thì NÓI RA thay vì để cột trắng trông như "chưa có gì".
 import { useQuery } from '@tanstack/react-query'
-import { FileCheck, FileSignature, Lock } from 'lucide-react'
+import { FileCheck, FileSignature, FolderTree, Lock, Pencil } from 'lucide-react'
 import { usePermission } from '@/hooks/usePermission'
 import { api } from '@/lib/api'
 import { cn } from '@/lib/cn'
@@ -79,6 +79,7 @@ export function KhkkWorkListPanel({
   onPickPlan,
   selectedPeId,
   selectedPlanId,
+  onEditPlan,
 }: {
   /** Bấm PE ở tầng trên → host nạp phiếu đó vào form tạo (Ở LẠI màn, không điều hướng). */
   onPickPe: (peId: string) => void
@@ -87,6 +88,9 @@ export function KhkkWorkListPanel({
   onPickPlan: (planId: string) => void
   selectedPeId?: string | null
   selectedPlanId?: string | null
+  /** [S175 · O7] Bấm bút chì trên card KHKK → host mở phiếu ở chế-độ SỬA. Không truyền ⇒
+   *  không vẽ bút chì (cột giữ đúng hình cũ). */
+  onEditPlan?: (planId: string) => void
 }) {
   const { can } = usePermission()
   // 🔴 ĐÚNG key policy của endpoint — KHÔNG dùng `Khkk_*` (đó là key MENU, tầng hiển thị).
@@ -114,15 +118,26 @@ export function KhkkWorkListPanel({
   // trong cache React Query (DTO trước K2 không có field này) — thiếu guard thì `.length` nổ.
   const awaiting = (candidates.data ?? []).filter((p) => (p.existingGroups ?? []).length === 0)
 
-  // Gom theo DỰ ÁN — đúng chữ "theo dự án" của anh. `Map` giữ thứ tự chèn nên dự án nào có
-  // phiếu mới nhất (BE trả sẵn theo thứ tự) thì nổi lên trước.
-  const byProject = new Map<string, KhkkPeCandidateDto[]>()
+  // [S175 · O8] CÂY 2 CẤP **Dự án › Hạng mục** — anh chốt "cho cây thư mục dự án hạng mục
+  // ra luôn nhé". Trước đây chỉ gom 1 cấp theo dự án, nên một dự án nhiều gói thầu đổ ra
+  // một danh sách phẳng dài, không thấy được ranh giới hạng mục.
+  // 🔴 0 ENDPOINT MỚI: `workItemName` ĐÃ có sẵn trong `KhkkPeCandidateDto` (`khkk.ts:423`)
+  // ⇒ cấp 2 là gom lại trên dữ-liệu đang có, không phải gọi thêm cửa nào.
+  // `Map` giữ thứ tự chèn ở CẢ HAI cấp nên dự án/hạng mục có phiếu mới nhất nổi lên trước
+  // (BE đã trả sẵn theo thứ tự).
+  const byProject = new Map<string, Map<string, KhkkPeCandidateDto[]>>()
   for (const pe of awaiting) {
-    const key = pe.projectName ?? '(chưa gán dự án)'
-    const bucket = byProject.get(key)
+    const pKey = pe.projectName ?? '(chưa gán dự án)'
+    const wKey = pe.workItemName ?? '(chưa gán hạng mục)'
+    let byWorkItem = byProject.get(pKey)
+    if (!byWorkItem) { byWorkItem = new Map(); byProject.set(pKey, byWorkItem) }
+    const bucket = byWorkItem.get(wKey)
     if (bucket) bucket.push(pe)
-    else byProject.set(key, [pe])
+    else byWorkItem.set(wKey, [pe])
   }
+  /** Đếm phiếu của cả một dự án (cộng mọi hạng mục con) — số ở header cấp 1. */
+  const countProject = (byWorkItem: Map<string, KhkkPeCandidateDto[]>) =>
+    [...byWorkItem.values()].reduce((s, arr) => s + arr.length, 0)
 
   // [S174 owner] "chỗ thao tác chỉ hiển trả lại và nháp, từ chối thôi nhé" ⇒ DANH-SÁCH-TRẮNG
   // 3 trạng thái, KHÔNG phải loại-trừ. 🔴 Đổi từ loại-trừ sang danh-sách-trắng là CÓ CHỦ ĐÍCH:
@@ -175,43 +190,57 @@ export function KhkkWorkListPanel({
                 Mọi phiếu đã duyệt đều đã có kế hoạch ký kết.
               </p>
             )}
-            {[...byProject.entries()].map(([projectName, items]) => (
+            {/* [S175 · O8] CẤP 1 = Dự án (sticky, `z-20`) · CẤP 2 = Hạng mục (sticky dưới nó,
+                `z-10` + thụt lề + vạch trái). 🔴 Hai `z` khác nhau là BẮT BUỘC: cùng `z` thì
+                header hạng mục trượt ĐÈ lên header dự án khi cuộn, mất mất cấp cha. */}
+            {[...byProject.entries()].map(([projectName, byWorkItem]) => (
               <div key={projectName}>
-                <div className="sticky top-0 z-10 flex items-center gap-1.5 border-b border-slate-100 bg-white/95 px-3 py-1 backdrop-blur">
-                  <span className="min-w-0 flex-1 truncate text-[10px] font-semibold uppercase tracking-wide text-slate-500">
+                <div className="sticky top-0 z-20 flex items-center gap-1.5 border-b border-slate-200 bg-slate-50/95 px-3 py-1 backdrop-blur">
+                  <FolderTree className="h-3 w-3 shrink-0 text-slate-400" aria-hidden />
+                  <span className="min-w-0 flex-1 truncate text-[10px] font-semibold uppercase tracking-wide text-slate-600">
                     {projectName}
                   </span>
-                  <span className="shrink-0 text-[10px] text-slate-500">{items.length}</span>
+                  <span className="shrink-0 text-[10px] tabular-nums text-slate-500">{countProject(byWorkItem)}</span>
                 </div>
-                <ul className="divide-y divide-slate-100">
-                  {items.map((pe) => (
-                    <li key={pe.id}>
-                      <button
-                        type="button"
-                        // Bấm = nạp THẲNG phiếu này vào form tạo bên panel 2. Không điều hướng,
-                        // không mở lại màn khác — đúng "click vào cột này để tạo luôn KHKK".
-                        onClick={() => onPickPe(pe.id)}
-                        title="Lập kế hoạch ký kết cho phiếu này"
-                        className={cn(
-                          'block w-full px-3 py-2 text-left transition hover:bg-amber-50/60',
-                          selectedPeId === pe.id && 'bg-amber-50 ring-1 ring-inset ring-amber-300',
-                        )}
-                      >
-                        <div className="flex items-center gap-1.5">
-                          <span className="font-mono text-[10px] text-brand-700">{pe.maPhieu ?? '—'}</span>
-                          <span className="text-[10px] text-slate-400">·</span>
-                          <span className="truncate text-[10px] text-slate-500">{formatDate(pe.createdAt)}</span>
-                        </div>
-                        <div className="truncate text-[12px] font-medium text-slate-800">{pe.tenGoiThau}</div>
-                        {pe.winnerSupplierNames.length > 0 && (
-                          <div className="mt-0.5 truncate text-[10px] text-emerald-700">
-                            ✓ {pe.winnerSupplierNames.join(' · ')}
-                          </div>
-                        )}
-                      </button>
-                    </li>
-                  ))}
-                </ul>
+                {[...byWorkItem.entries()].map(([workItemName, items]) => (
+                  <div key={workItemName}>
+                    <div className="sticky top-[1.375rem] z-10 flex items-center gap-1.5 border-b border-slate-100 bg-white/95 py-1 pl-6 pr-3 backdrop-blur">
+                      <span className="min-w-0 flex-1 truncate text-[10px] font-medium text-slate-500">
+                        {workItemName}
+                      </span>
+                      <span className="shrink-0 text-[10px] tabular-nums text-slate-400">{items.length}</span>
+                    </div>
+                    <ul className="divide-y divide-slate-100 border-l-2 border-slate-100 pl-1">
+                      {items.map((pe) => (
+                        <li key={pe.id}>
+                          <button
+                            type="button"
+                            // Bấm = nạp THẲNG phiếu này vào form tạo bên panel 2. Không điều hướng,
+                            // không mở lại màn khác — đúng "click vào cột này để tạo luôn KHKK".
+                            onClick={() => onPickPe(pe.id)}
+                            title="Lập kế hoạch ký kết cho phiếu này"
+                            className={cn(
+                              'block w-full px-3 py-2 text-left transition hover:bg-amber-50/60',
+                              selectedPeId === pe.id && 'bg-amber-50 ring-1 ring-inset ring-amber-300',
+                            )}
+                          >
+                            <div className="flex items-center gap-1.5">
+                              <span className="font-mono text-[10px] text-brand-700">{pe.maPhieu ?? '—'}</span>
+                              <span className="text-[10px] text-slate-400">·</span>
+                              <span className="truncate text-[10px] text-slate-500">{formatDate(pe.createdAt)}</span>
+                            </div>
+                            <div className="truncate text-[12px] font-medium text-slate-800">{pe.tenGoiThau}</div>
+                            {pe.winnerSupplierNames.length > 0 && (
+                              <div className="mt-0.5 truncate text-[10px] text-emerald-700">
+                                ✓ {pe.winnerSupplierNames.join(' · ')}
+                              </div>
+                            )}
+                          </button>
+                        </li>
+                      ))}
+                    </ul>
+                  </div>
+                ))}
               </div>
             ))}
           </Tier>
@@ -248,7 +277,7 @@ export function KhkkWorkListPanel({
             )}
             <ul className="divide-y divide-slate-100">
               {planItems.map((k) => (
-                <li key={k.id}>
+                <li key={k.id} className="relative">
                   <button
                     type="button"
                     // 🔴 CHỈ XEM tại chỗ — KHÔNG `navigate('/khkk/:id')`. Anh chốt: "cho hiện
@@ -258,6 +287,8 @@ export function KhkkWorkListPanel({
                     className={cn(
                       'block w-full px-3 py-2 text-left transition hover:bg-violet-50/60',
                       selectedPlanId === k.id && 'bg-violet-50 ring-1 ring-inset ring-violet-300',
+                      // [S175 · O7] Chừa chỗ cho bút chì để tên gói thầu dài không chui xuống dưới nó.
+                      onEditPlan && 'pr-9',
                     )}
                   >
                     <div className="flex items-center gap-1.5">
@@ -280,6 +311,34 @@ export function KhkkWorkListPanel({
                       {k.peTenGoiThau ?? '(chưa có tên gói thầu)'}
                     </div>
                   </button>
+                  {/* [S175 · O7] Bút chì — khuôn `PeListPanel.tsx:208-232`. LUÔN hiện (không
+                      chỉ khi hover) rồi MỜ ĐI khi không sửa được: nút chỉ-hiện-khi-hover thì
+                      trên máy cảm-ứng không ai tìm ra, còn ẩn hẳn khi phiếu khoá thì người
+                      dùng tưởng chức năng không tồn tại thay vì hiểu là phiếu đã đi duyệt.
+                      🔴 Nút NGOÀI thẻ <button> của card — lồng button trong button là HTML
+                      không hợp lệ, React sẽ cảnh báo và bấm sẽ kích cả hai. */}
+                  {onEditPlan && (() => {
+                    const editable = k.phase === KhkkPhase.DangSoanThao || k.phase === KhkkPhase.TraLai
+                    return (
+                      <button
+                        type="button"
+                        onClick={() => editable && onEditPlan(k.id)}
+                        disabled={!editable}
+                        title={editable
+                          ? 'Sửa kế hoạch này'
+                          : 'Kế hoạch đã gửi duyệt / đã duyệt — không sửa được'}
+                        aria-label={editable ? `Sửa kế hoạch ${k.maKeHoach ?? ''}` : undefined}
+                        className={cn(
+                          'absolute right-2 top-2 rounded p-1.5 transition',
+                          editable
+                            ? 'cursor-pointer text-violet-600 hover:bg-violet-100 hover:shadow-sm'
+                            : 'cursor-not-allowed text-slate-300',
+                        )}
+                      >
+                        <Pencil className="h-3.5 w-3.5" />
+                      </button>
+                    )
+                  })()}
                 </li>
               ))}
             </ul>