# YC-029 — Mô tả 3 ảnh anh gửi @S190 (2026-08-12 ~16:33) — KẾT TINH TỪ ẢNH, lane đọc file này thay ảnh

> Nguồn: 3 screenshot anh đính kèm lệnh YC-029 (sổ yêu-cầu). Người chép: lead (em-main) — mô tả
> TRUNG THỰC những gì thấy, phần ĐỌC-Ý đánh dấu `⇒ đọc-ý (bậc-2)`. Lane invest PHẢI đối chiếu
> code để xác nhận/bác cách đọc-ý trước khi khoá spec.

## Ảnh 1 — eoffice `/my-contracts?type=1` (user FE, đăng nhập Administrator)

- Header trang: **"HĐ của tôi · HĐ Thầu phụ (0)"** + nút "+ Tạo HĐ mới" góc phải.
- Sidebar trái (menu eoffice): nhóm **DUYỆT NCC** (1. Duyệt Nhà Cung Cấp - Thầu phụ (NCC -TP)) →
  nhóm **KẾ HOẠCH KÝ KẾT HĐ** (8 mục: 1. Thiết bị, máy móc, vật tư phụ (A1) · 2. Kết cấu, hạ tầng,
  phá dỡ & DV hỗ trợ thi công (A2-A3) · 3. Hoạt động văn phòng (A4) · 4. Vật tư (B1) · 5. Thầu phụ
  xây dựng (B2) · 6. Thầu phụ MEP (B3) · 7. BCH công trường (C1-C3) · 8. HĐ chưa ủy quyền — CEO (5.2))
  → nhóm **DUYỆT HỢP ĐỒNG** (01. HĐ Thầu phụ — đang mở, submenu: Luồng duyệt · **Danh sách** (active)
  · Thao tác · Đang duyệt · Đã duyệt · Đã xóa · 02. HĐ Giao khoán · 03. HĐ Nhà cung cấp · 04. HĐ Dịch vụ
  · 05. HĐ Mua bán · 06. HĐ Nguyên tắc NCC · 07. HĐ Nguyên tắc Dịch vụ).
- **KHOANH ĐỎ #1**: cột danh-sách HĐ (giữa-trái) — search "Tìm theo mã / tên / NCC..." + empty-state
  "Không có HĐ — Loại HĐ này chưa có dữ liệu".
- Cột giữa: placeholder "Chọn 1 HĐ ở danh sách bên trái — Chi tiết HĐ + thông tin / góp ý / file đính kèm".
- **KHOANH ĐỎ #2**: panel bên PHẢI **"CÂY TOÀN TRÌNH (45 gói)"** — search "Lọc dự án / hạng mục / mã
  phiếu..." + tree: `Năm 2026 (48)` → `BVN01 (12)` → gói thầu (vd "2 Mat Thép cây, Thép lưới hàn (1)")
  → 4 GĐ con: **Duyệt NCC (1) · Kế hoạch Hợp đồng (2) · Duyệt Hợp đồng (0) · Hợp đồng cứng (0)**;
  gói "4 Sub Kết cấu thép" mở GĐ "Duyệt Hợp đồng" → "Chưa có dữ liệu ở giai đoạn này". Nhiều gói khác
  (8 MEP Sub Hệ thống solar · 9 Mat Gạch trồng cỏ · 10 Mat Gạch ốp lát · 10 Sub Cơ khí hoàn thiện lan
  can · 12 Mat Sơn nước (2) · 14 Mat PVC, vải địa · 15 Sub Vách ngăn vệ sinh …).
- **MŨI TÊN ĐỎ**: từ khung CÂY TOÀN TRÌNH (phải) chỉ SANG khung cột danh-sách (trái).
- Lời anh: **"Thứ 1 (Ành 1): Bỏ phần này sang bên này nhé."**
- ⇒ đọc-ý (bậc-2): **DỜI panel "Cây toàn trình" từ cột PHẢI sang cột TRÁI** (vị trí danh-sách hiện
  tại), tức bố cục giống trang KHKK (cây đứng trái làm trục điều hướng). Danh-sách HĐ đi đâu (nhập
  vào cây / thành cột giữa) = lane invest đối chiếu khuôn KHKK rồi đề xuất.

## Ảnh 2 — cùng trang eoffice, khoanh MENU

- **KHOANH ĐỎ**: 7 mục menu loại HĐ trong nhóm DUYỆT HỢP ĐỒNG: `01. HĐ Thầu phụ` (kèm submenu
  Luồng duyệt/Danh sách/Thao tác/Đang duyệt/Đã duyệt/Đã xóa) · `02. HĐ Giao khoán` · `03. HĐ Nhà cung
  cấp` · `04. HĐ Dịch vụ` · `05. HĐ Mua bán` · `06. HĐ Nguyên tắc NCC` · `07. HĐ Nguyên tắc Dịch vụ`.
- Nhiều mũi tên đỏ từ 7 mục chỉ vào box chữ đỏ: **"Cái này là mỗi 1 hợp đồng 1 quy trình khác nhau."**
- Lời anh: **"Thứ 2 (Ảnh 2): Điều chỉnh."**
- ⇒ đọc-ý (bậc-2): mỗi LOẠI HĐ = 1 quy-trình duyệt RIÊNG (đúng 7 workflow `HD-*` đã seed @S188) —
  UI/menu/trang từng loại phải thể hiện + lọc ĐÚNG dữ liệu + quy trình của loại đó, không dùng chung
  lẫn lộn. Kết hợp Thứ-3 (bug menu nhảy lẫn) — lane truy cả hai cùng lúc.

## Ảnh 3 — ADMIN `Quy trình duyệt (Mới)` + dialog Sửa-tại-chỗ (khuôn ĐÍCH cho Thứ-5)

- Sidebar admin: Tổng quan quy trình · HỆ THỐNG (Người dùng · Vai trò · Phân quyền · Menu eOffice) ·
  **Quy trình duyệt (Mới)** mở rộng: `Duyệt NCC (Mới)` (active) · `Duyệt NCC và Giải pháp (Mới)` ·
  `Duyệt KHKK — Nhóm 1` … `Duyệt KHKK — Nhóm 8`.
- Nội dung: tiêu đề "Quy trình duyệt (Mới): Duyệt…" + chú "Mỗi Bước = 1 Phòng. Mỗi Cấp trong Bước…"
  + card **"Quy trình Duyệt NCC QT-DN-V2-…"**: Bước 1 — Phòng 1 (Cấp 1: Nguyễn Thị Bích Phượng, Châu
  Tạ Kim Long, Nguyễn Văn Duy, Binh Le Thanh · Cấp 2: Bùi Lê Thủy Trà) · Bước 2 — Phòng 2 (Cấp 1: Hồ
  Thị Nữ Nguyên, Trần Xuân Lưu, Lê Trần Đăng Trường, Lê Văn Bình · Cấp 2: Phan Văn Chương) · Bước 3 —
  Phòng 3 (Cấp 1: Nguyễn Văn Trường) + khối "Lịch sử versions" bên dưới (card version với roster +
  badge `NS PRO`).
- Dialog đang mở: **"Sửa tại chỗ — QT-DN-V2-001 v04 (giữ nguyên phiên bản)"** — mỗi NV một khối
  "QUYỀN DUYỆT <TÊN>" với 9 checkbox: `Trả về 1 Cấp trước` · `Trả về 1 Bước trước` · `Trả về Người
  chỉ định` ✓ · `Trả về Drafter (mặc định)` ✓ · `Cho phép chỉnh sửa Section 2 (Hạng mục/NCC/Báo giá)
  lúc đang duyệt` ✓ · `Cho phép chỉnh sửa Section ngân sách lúc đang duyệt` ✓ · `Cho phép duyệt thẳng
  Cấp cuối khi đang duyệt` · `Duyệt là KẾT THÚC quy trình (không trình tiếp CEO)` (chữ xanh) · `Cho
  phép NV này XÓA phiếu khi đến lượt duyệt của mình` (chữ đỏ). Nút `Hủy` + `Lưu thay đổi (giữ nguyên
  phiên bản)`.
- Lời anh: **"Thứ 5: Bên trong Admin -> Cấu hình Menu đúng chính xác cho từng loại HĐ nguyên tắc,
  thầu phụ -> Cấu trúc Menu tương tự giống với KHKK và Duyệt NCC (Ảnh 3)"**
- ⇒ đọc-ý (bậc-2): sidebar admin "Quy trình duyệt (Mới)" phải có **mục RIÊNG cho TỪNG loại HĐ**
  (vd `Duyệt HĐ — Thầu phụ` … `Duyệt HĐ — Nguyên tắc DV`, 7 mục) y khuôn KHKK Nhóm 1-8, mỗi mục vào
  Designer đầy đủ (xem steps/cấp/NV · Sửa-tại-chỗ per-NV 9-checkbox · Tạo phiên bản mới · Ghim ·
  lịch sử versions) cho đúng workflow `HD-*` của loại đó. Hiện trạng @S188: Designer GĐ3 = type-3
  family-slice — lane xác nhận sidebar admin đã có mục per-loại chưa hay đang gộp.

## Lời anh — 2 mục KHÔNG có ảnh

- **"Thứ 3: Phần hợp đồng Menu đang bị lẫn lộn, click vào menu này thì nhảy sang Menu khác, điều
  chỉnh lại nhé."** ⇒ BUG điều hướng menu 7 loại HĐ (nghi lớp gotcha #34 NavLink query-param /
  staticMap Layout / menu-key OR-gate #85 — lane truy root-cause bằng code, không đoán).
- **"Thứ 4: Phần thao tác, duyệt, xóa ... -> Cấu trúc tương tự như KHKK."** ⇒ bộ hành-vi thao-tác
  của GĐ3 (submenu Thao tác · Đang duyệt · Đã duyệt · Đã xóa + nút duyệt/trả/xóa trong màn) phải
  theo Y KHUÔN KHKK đã chạy prod (luật owner S176: đã-deploy = CHUẨN).
