Một hệ thống cho toàn bộ nghiệp vụ của bạn.

flowchart LR
  S1["1️⃣ Tiếp nhận
KH → Dự án → Nhu cầu"] --> S2["2️⃣ Tìm người & gán
4 nguồn → HR duyệt"]
  S2 --> S3["3️⃣ Chấm công
file đối tác + GPS"]
  S3 --> S4["4️⃣ Chốt công
xử lý lỗi → duyệt → KHÓA 🔒"]
  S4 --> S5["5️⃣ Đối soát
2 biên bản + tối đa 2 vòng"]
  S4 --> S6["6️⃣ Trả lương
+ BHXH, thuế"]
  S5 --> S7["Vendor xác nhận/
phản đối"]
  S6 --> S8["Phiếu lương
chỉ NET, không âm"]
  style S4 fill:#FFF1E4,color:#C2410C,stroke:#F97316,stroke-width:2px
  style S5 fill:#FFF1E4,color:#C2410C
  style S6 fill:#FFF1E4,color:#C2410C

flowchart TD
  A["📝 HR tạo biên bản
CHO_VENDOR"] --> B{"Vendor xem"}
  B -->|"✅ Xác nhận"| LOCKED["🔒 Khóa biên bản
HOÀN TẤT"]
  B -->|"❌ Phản đối
vòng 1"| C["⚠️ Phản đối vòng 1
HR chỉnh sửa"]
  C -->|"Gửi lại
vòng 2"| A
  C -->|"❌ Phản đối
vòng 2"| FL["🔒 FORCE LOCK
HR Manager/Kế toán chốt
lý do + bằng chứng + audit"]
  C -->|"⏰ Quá 3 ngày
không trả lời"| AUTO["⏰ Tự xác nhận
không ai câu giờ được"]
  A -->|"⏰ Quá 3 ngày
Vendor im lặng"| AUTO
  AUTO --> LOCKED
  FL --> LOCKED
  note["📌 Quy tắc: Phản đối tối đa 2 vòng.
Quá 2 vòng → HR Manager/Kế toán FORCE LOCK
(lý do + bằng chứng + audit — G17-B1)."]:::rule
  AUTO -.-> note
  style LOCKED fill:#DCFCE7,color:#15803D,stroke:#15803D,stroke-width:2px
  style AUTO fill:#FEF3C7,color:#B45309,stroke:#B45309,stroke-width:2px
  style C fill:#FEF3C7,color:#B45309
  style FL fill:#FEE2E2,color:#B91C1C,stroke:#B91C1C,stroke-width:2px
  style note fill:#FFF1E4,color:#C2410C,stroke:#F97316,stroke-width:1px,stroke-dasharray:4

flowchart TD
  A["Bảng công
đã khóa 🔒"] --> B{"Loại lao động?"}
  B -->|"Chính thức
≥ 3 tháng"| C1["Thuế lũy tiến 5/10/15/20/25%
+ BHXH 10.5% (NLĐ)
(DN đóng 22%)"]
  B -->|"Vãng lai
≥ 2 triệu/lần"| C2["Thuế 10% khấu trừ
tại nguồn"]
  C1 --> D["Lương NET"]
  C2 --> D
  D --> E{"NET < 0?"}
  E -->|"Có"| F["⚠️ Bù thiếu
chuyển trừ kỳ sau
KT duyệt từng ca"]
  E -->|"Không"| G["✅ Chuyển khoản
STK đã xác thực"]
  F --> H["📋 Phiếu lương
chỉ hiện NET"]
  G --> H
  style F fill:#FEF3C7,color:#B45309
  style G fill:#DCFCE7,color:#15803D

flowchart LR
  A["📋 Bảng ca
hôm nay"] --> B["👆 Vuốt phải = có mặt
Vuốt trái = vắng"]
  B --> C{"🌐 Có mạng?"}
  C -->|"Có"| S1["Sync server
HR thấy ngay"]
  C -->|"Không"| S2["💾 Lưu local
+ queue"]
  S2 -->|"Có mạng lại"| S1
  B --> D["🤝 Điểm danh hộ
LĐ không có ĐT"]
  B --> E["🚨 Báo sự cố
3 chạm"]
  B --> F["✅ Duyệt đơn
1 chạm"]
  B --> G["🔄 Chuyển nhóm
hàng loạt"]
  style S2 fill:#FFF1E4,color:#C2410C,stroke:#F97316,stroke-width:2px
  style S1 fill:#DCFCE7,color:#15803D

flowchart LR
  subgraph UT["🗂️ Ứng tuyển"]
    U1["Mới"] --> U2["Sàng lọc"]
    U2 --> U3["Đạt ✅"]
    U2 -->|"loại"| U4["Loại ❌"]
    U2 -->|"rút"| U5["Rút ↩️"]
    U3 -->|"gộp trùng"| U6["Gộp 🔀"]
  end
  subgraph HS["📋 Hồ sơ giấy tờ"]
    H1["Chưa đủ
thông tin"] --> H2["Chờ xác
minh"]
    H2 --> H3["Đã xác
minh ✅"]
    H2 -->|"không hợp lệ"| H4["Bị từ chối ❌"]
    H4 -->|"khiếu nại / bổ sung"| H2
  end
  subgraph QH["🤝 Quan hệ lao động"]
    Q1["Chưa có"] --> Q2["Đang làm 🟢"]
    Q2 --> Q3["Tạm nghỉ 🔵"]
    Q3 --> Q2
    Q2 -->|"nghỉ việc"| Q4["Nghỉ việc 🔴"]
  end
  subgraph DA["🏢 Tại dự án"]
    D1["Chờ xếp
việc"] --> D2["Đang làm 🟢"]
    D2 --> D3["Tạm dừng 🔵"]
    D3 --> D2
    D2 -->|"kết thúc HĐ"| D4["Kết thúc ⚪"]
    D2 -->|"chuyển dự án
ghi đến phút"| D5["Chuyển dự án ↔️"]
    D2 -->|"ngang ≥3 ngày
tự cảnh báo"| D6["HR đóng hồ sơ"]
    D2 -->|"huỷ điều động"| D7["Hủy ⚪"]
  end
  subgraph RR["⚠️ Rủi ro"]
    R1["Bình thường"] --> R2["Xem xét"]
    R2 -->|"bỏ việc /
kỷ luật"| R3["Chặn 🚫"]
    R2 --> R1
    R3 -->|"HR gỡ sau kỳ"| R1
  end
  UT -.->|"HR / ứng viên"| HS
  HS -.->|"HR / Vendor"| QH
  QH -.->|"HR / Vendor"| DA
  RR -.->|"mọi portal
cùng thấy"| DA

flowchart TD
  F["Đối tác gửi file
CSV / XLSX"] --> P["Parse & validate
theo mẫu đã khai"]
  P -->|"định dạng sai"| E1["❌ LỖI ĐỊNH DẠNG
từ chối nguyên file"]
  P -->|"OK"| M["Ghép mã NV
employee_code / CCCD"]
  M -->|"mã lạ"| E2["⚠️ MÃ LẠ
KT dò tay 24h"]
  M -->|"CCCD trùng 2 người"| E3["⚠️ TRÙNG CCCD
HR Manager gộp"]
  M -->|"OK"| R["Bảng công thô
status: DRAFT"]
  R -->|"thiếu check"| E4["⚠️ THIẾU CHECK
PM xác minh"]
  R -->|"ngoài ca > 1h"| E5["⚠️ NGOÀI CA
PM xác nhận OT"]
  R -->|"scan trùng < 30s"| E6["⚠️ TRÙNG SCAN
tự bỏ dòng sau"]
  R -->|"OK"| C["Chuẩn hoá
status: READY"]
  C --> K["Kế toán duyệt →
KHÓA KỲ 🔒"]
  K -->|"sai sau khóa?"| ADJ["Tạo dòng ADJUSTMENT
ở kỳ sau kèm lý do"]
  K --> LOCKED["ĐÃ KHÓA — bất biến
chỉ xem, không sửa"]
  style E1 fill:#FEE2E2,color:#B91C1C
  style E2 fill:#FEF3C7,color:#B45309
  style E3 fill:#FEF3C7,color:#B45309
  style E4 fill:#FEF3C7,color:#B45309
  style E5 fill:#FEF3C7,color:#B45309
  style E6 fill:#FEF3C7,color:#B45309
  style K fill:#FFF1E4,color:#C2410C,stroke:#F97316,stroke-width:2px
  style LOCKED fill:#DCFCE7,color:#15803D

stateDiagram-v2
  direction LR
  state profile_status {
    INCOMPLETE --> PENDING_VERIFY: nộp hồ sơ
    PENDING_VERIFY --> VERIFIED: HR duyệt
    PENDING_VERIFY --> REJECTED: HR từ chối
  }
  state submission_status {
    NEW --> SCREENING: HR sàng lọc
    SCREENING --> QUALIFIED: đạt
    SCREENING --> REJECTED: loại
    SCREENING --> WITHDRAWN: rút
    QUALIFIED --> MERGED: gộp trùng
  }
  state employment_status {
    NONE --> ACTIVE: ký HĐ
    ACTIVE --> SUSPENDED: tạm nghỉ
    ACTIVE --> TERMINATED: chấm dứt
    SUSPENDED --> ACTIVE: phục hồi
  }
  state assignment_status {
    PLANNED --> ACTIVE: vào ca
    ACTIVE --> PAUSED: tạm dừng
    ACTIVE --> ENDED: kết thúc
    ACTIVE --> TRANSFERRED: chuyển dự án
    PLANNED --> CANCELLED: hủy
  }
  state risk_status {
    NORMAL --> REVIEW: cảnh báo
    REVIEW --> BLOCKED: khóa
    REVIEW --> NORMAL: xác minh OK
  }

stateDiagram-v2
  direction LR
  [*] --> PENDING
  PENDING --> HR_APPROVED: APPROVE_HR
  HR_APPROVED --> APPROVED: APPROVE_FINAL
  APPROVED --> PAID: PAY
  PAID --> CLOSED: CLOSE
  PENDING --> REJECTED: REJECT
  HR_APPROVED --> REJECTED: REJECT
  PENDING --> CANCELLED: CANCEL (worker)
  HR_APPROVED --> CANCELLED: CANCEL (worker)
  CLOSED --> [*]
  CANCELLED --> [*]
  REJECTED --> [*]

stateDiagram-v2
  direction LR
  [*] --> DRAFT
  DRAFT --> SENT: gửi
  SENT --> CONFIRMED: vendor OK (hoặc quá SLA)
  SENT --> DISPUTED: vendor báo lỗi
  DISPUTED --> CONFIRMED: HRP xử lý xong
  DISPUTED --> DRAFT: tạo version mới
  DISPUTED --> LOCKED: quá 2 vòng → FORCE LOCK (HR Manager/KT, audit)
  CONFIRMED --> LOCKED: chốt (bất biến)
  LOCKED --> PAID: chi trả
  PAID --> [*]

sequenceDiagram
  autonumber
  actor V as 🏢 Vendor Long Vân
  participant VP as 🌐 Cổng vendor
  participant SYS as ⚙️ HRP Core
  participant HR as 👔 HR
  actor NLD as 👷 Ứng viên
  participant P as 📱 App HRP
  V->>VP: Đăng nhập (tài khoản vendor riêng)
  V->>VP: Upload hồ sơ: tên, CCCD, SĐT, ảnh
  VP->>SYS: POST /api/vendors/applicants
  SYS->>SYS: Check 1: tiến cử 7 ngày?
  SYS->>SYS: Check 2: đang hưởng hoa hồng?
  SYS->>SYS: Check 3: đang hưởng lương vendor?
  alt Trùng 1 trong 3 điều kiện
    SYS-->>VP: ❌ BLOCKED + lý do
    VP->>V: Ứng viên đã có người tiến cử
  else OK
    SYS->>HR: 🔔 Hồ sơ mới
    HR->>NLD: SMS + Zalo nhận hồ sơ
    NLD->>P: Đăng ký bằng CCCD
    P->>SYS: Xác nhận đúng người
    HR->>SYS: ✅ Duyệt → MATCHED
    SYS-->>VP: Hồ sơ đã duyệt
    alt Sau 30 ngày làm liên tục
      SYS-->>VP: 💰 Hoa hồng giữ chân
    end
  end

stateDiagram-v2
  [*] --> CHODUYET: Người lao động tạo đơn
  CHODUYET --> HRXACNHAN: HR xác nhận hợp lệ
  CHODUYET --> TUCHOI: Từ chối (ghi lý do)
  CHODUYET --> RUTDON: Tự rút đơn
  HRXACNHAN --> DUYET: Kế toán duyệt chi
  HRXACNHAN --> TUCHOI
  HRXACNHAN --> RUTDON
  DUYET --> DACHI: Kế toán chi tiền
  DUYET --> DONG: Đóng đơn
  DACHI --> DONG
  DONG --> [*]

sequenceDiagram
  autonumber
  actor NLD as 👷 Người lao động
  participant APP as 📱 App HRP
  participant HR as 👔 HR
  participant KT as 💰 Kế toán
  participant BANK as 🏦 Ngân hàng
  participant AUD as 📋 Audit log
  NLD->>APP: Tạo đơn tạm ứng 2.000.000 đ
  APP->>APP: Validate hạn mức theo policy/project (Q#8)
  APP->>HR: 🔔 HĐ-2026-0089 chờ duyệt
  HR->>APP: Xem hồ sơ + lịch sử đơn
  HR->>APP: ✅ Xác nhận hợp lệ
  HR->>AUD: Ghi HR xác nhận 14:32
  HR->>KT: 🔔 Kế toán duyệt chi
  KT->>APP: Kiểm tra quỹ tạm ứng
  KT->>APP: ✅ Duyệt chi
  KT->>AUD: Ghi KT duyệt 15:10
  KT->>BANK: Chuyển 2.000.000 đ → STK ****5678
  BANK-->>KT: ✅ Thành công
  KT->>APP: Trạng thái = ĐÃ CHI
  APP->>NLD: 🔔 Đã chuyển vào VCB ***5678
  APP->>AUD: Ghi đóng đơn 15:14

gantt
  title HRP v4.20 — Lộ trình triển khai
  dateFormat YYYY-MM-DD
  axisFormat %d/%m
  section Sprint 0 — Discovery (2 tuần)
  Dữ liệu thật + state model + 2 spike :s0, 2026-08-24, 14d
  section Wave 1 — Backbone vận hành (~90 MD)
  M0 Platform + M1 Auth + M3 core + M5 :w1a, 2026-09-07, 35d
  A-04 Job board công cộng (kéo về W1, Q#23) :w1b, after w1a, 14d
  section Wave 2 — Chấm công & Đối soát (~80 MD)
  M7 import/chốt + M8 tối giản :w2, 2026-10-12, 28d
  section UAT MVP (2 tuần)
  Chạy dữ liệu thật + đào tạo :uat, 2026-11-09, 14d
  Go-live MVP nội bộ :milestone, 2026-11-23, 0d
  section Wave 3 — Mở 3 cổng bên ngoài (~145 MD)
  Worker Portal + PWA + GPS :w3a, 2026-11-23, 21d
  Vendor Portal :w3b, after w3a, 21d
  CTV Portal core :w3c, after w3b, 14d
  M3 hoàn thiện + M5 dedup/export :w3d, after w3c, 14d
  M7 ticket (ticket workflow hoàn chỉnh) :w3e, after w3d, 14d
  PM Field App (PWA hiện trường) :w3f, after w3e, 14d
  section Wave 4 — Tài chính đầy đủ (~90 MD)
  M8 đầy đủ (pay run, payslip, reports) :w4a, 2027-01-18, 28d
  M6 commission ledger :w4b, after w4a, 14d
  M0 hardening :w4c, after w4b, 14d
  Go-live M0–M8 đầy đủ :milestone, 2027-02-22, 0d
  section Sau core (~40 MD)
  M9 HRM + mở rộng theo điều kiện :m9, 2027-02-22, 28d
  section Phase Compliance (sau cùng)
  TNCN/BHXH phức tạp (mẫu 02/05/07/TK1-TS) :comp, after m9, 21d