Tạo hợp đồng

Hợp đồng là trung tâm của 1 dự án trong DVDPM — gắn với BoQ, đợt thanh toán, VO, bảo lãnh, và toàn bộ tài chính.

Loại hợp đồng

Loại	Direction	Ý nghĩa	Phù hợp chế độ
Incoming (HĐ vào)	từ CĐT → mình	Mình là bên thực hiện, nhận tiền	Tổng thầu chính
Outgoing (HĐ ra)	từ mình → thầu phụ/NCC	Mình là bên giao thầu, trả tiền	CĐT, Tổng thầu (cho thầu phụ)

DVDPM tự suggest direction dựa trên project mode + party type khi anh/chị chọn đối tác.

Tạo hợp đồng mới

Tab DVDPM → Hợp đồng.
Click + Mới.
Điền thông tin:

Trường	Bắt buộc	Mô tả
Số hợp đồng	✓	Vd `HĐ-2026-001`. Unique trong dự án.
Direction	✓	Incoming / Outgoing (tự suggest theo party)
Đối tác	✓	Chọn từ danh bạ (xem Đối tác)
Giá trị	✓	VND, > 0
% Tạm ứng		0-100. Mặc định 0. Vd 30 = 30% tạm ứng.
% Giữ lại bảo hành		0-100. Mặc định 5.
Ngày ký	✓	Date picker
Ngày hiệu lực		Phải ≥ ngày ký
Ngày hoàn thành dự kiến		Phải > ngày ký
Status		Draft / Active / Completed / Terminated. Default Draft.
File hợp đồng đính kèm		Path tới file PDF/DOCX scan HĐ — xem mục dưới

Click Lưu.

Đính kèm file hợp đồng (PDF/DOCX scan)

Khi điền form, ô File hợp đồng đính kèm có 2 nút:

... — mở file picker để chọn file local
Open — mở file đã lưu (khi anh/chị quay lại edit HĐ)

DVDPM lưu đường dẫn tuyệt đối vào DB. Nếu di chuyển file, link sẽ broken.

Bảo mật: DVDPM chỉ cho mở file có extension an toàn (.pdf .doc .docx .xls .xlsx .jpg .png .txt…). File .exe .lnk .bat sẽ bị từ chối — chỉ highlight trong Explorer.

Status workflow

Draft → Active → Completed
          ↓
       Terminated

Status	Khi nào
Draft	Đang lập, chưa ký chính thức
Active	Đã ký, đang triển khai
Completed	Đã hoàn tất nghiệm thu + thanh toán
Terminated	Chấm dứt giữa chừng (do vi phạm, force majeure…)

Đổi status: edit HĐ → dropdown Status → Save.

Paste from Excel — bulk import

Nếu đã có danh sách HĐ trong Excel:

Trong dialog Hợp đồng → click Paste from Excel.
Format cột Excel (theo thứ tự):

Direction | Số HĐ | Tên đối tác | Giá trị | % Tạm ứng | % Giữ lại | Ngày ký | Ngày hiệu lực | Hoàn thành | Status

Trong Excel: chọn vùng data (KHÔNG header) → Ctrl+C.
Quay lại DVDPM → click Paste → DVDPM auto-parse + import.
Lỗi từng dòng (nếu có) hiển thị summary cuối.

Xoá hợp đồng

DVDPM chặn xoá nếu HĐ có:

BoQ items đã import → phải Replace All với file rỗng trước
Đợt thanh toán → xoá đợt trước
Variation Order → archive/xoá VO trước

Đây là bảo vệ tránh mất reference. Nếu thực sự cần xoá, chuyển status = Terminated thay vì xoá.