Hướng dẫn 2 - TẠO DỰ ÁN

🚀 Menu TẠO DỰ ÁN — Quy trình chuẩn

Menu này dựng toàn bộ bảng ngân sách của dự án từ dữ liệu gốc 1.BOQ + 2.DGCT. Chạy đúng thứ tự Bước 1 → 2 → 3, sau đó mới dùng các Công cụ 4–10 để tinh chỉnh (chỉ chạy Bước 0 khi cần đổi vị trí cột). Mọi lệnh đều kiểm tra bản quyền và chỉ chạy được khi ô M4 của 4.BAO CAO ở trạng thái Đang thiết lập.

🧭 Trình tự thực hiện một dự án mới

Chuẩn bị dữ liệu đầu vào

Nhập/dán dữ liệu vào 1.BOQ (tiêu đề dòng 5–6, dữ liệu từ dòng 9) và 2.DGCT (tiêu đề dòng 1, dữ liệu từ dòng 2).

Dòng hạng mục La Mã (I, II, III…) đặt ở cột A, không có mã hiệu ở cột B.
Dòng chi tiết: STT là số thường (1, 2, 3…), bắt buộc có mã hiệu ở cột B.
Nếu file dự toán khách gửi sai format cột → dán vào 2a.data DGCT rồi chạy Bước 0 (xem hướng dẫn ở mục bên dưới).

Bước 1 · Phân loại Budget

Add-on điền cột M của 1.BOQ: 1.TG 2.NC 3.VT+NC. Kiểm tra lại cột M bằng mắt, sửa tay nếu máy phân sai; điền GK_XD_*/GK_ME_* vào cột N cho công việc khoán gói.

(Khuyến nghị) Kiểm tra ngược lệch Vật tư

Chạy 🔍 Kiểm tra ngược lệch Vật tư để đối chiếu tiền vật tư giữa 1.BOQ và 2.DGCT trước khi dựng bảng. Sai lệch phát hiện sớm rẻ hơn sửa sau Bước 2 rất nhiều.

Bước 2 · Chạy dự án (Tạo bảng)

Dựng mới 3.NS và 4.BAO CAO. Nếu BOQ có từ 2 hạng mục La Mã trở lên, add-on mở hộp thoại ĐẶT TÊN HẠNG MỤC DỰ ÁN để bạn đặt tên từng hạng mục.

⚠️ Lệnh này xóa và dựng lại 3.NS — mọi chỉnh tay trên 3.NS sẽ mất.

Bước 3 · Gộp nhóm tự động bảng 3.NS

Tạo dấu +/− (row group) 2 tầng cho toàn bộ 3.NS rồi thu gọn tất cả.

Tinh chỉnh bằng Công cụ 4–10 (tùy nhu cầu)

Chuyển nhóm · Gộp · Tách · Thêm mới · Sắp xếp · Đổi đơn vị · Đổi phân loại. Sau nhóm lệnh này luôn chạy lại Bước 3 và Công cụ 8.

Chuyển sang giai đoạn vận hành

Sang menu 📊 QUẢN TRỊ CCM: tạo kho vật tư, cấu hình Telegram, đặt M4 = Bắt đầu tổ chức báo cáo.

🔒 Hai chiếc khóa luôn có mặt trong mọi lệnh

Khóa	Ý nghĩa
Khóa bản quyền	Mỗi lệnh tự gọi kiểm tra license. Menu ANTRONICPRO luôn hiện đầy đủ khi mở file, nhưng chưa kích hoạt Key thì bấm lệnh sẽ báo ⛔ LỖI BẢN QUYỀN. Kích hoạt tại 🔑 Kích hoạt / Đổi Key Bản quyền ở đầu menu.
Khóa hệ thống (M4)	Các lệnh dựng/sửa bảng (Bước 0, 1, 2, Kiểm tra lệch VT…) bị chặn khi `4.BAO CAO!M4` = "Bắt đầu tổ chức báo cáo". Muốn sửa dự án phải trả M4 về "Đang thiết lập".
Khóa đồng thời	Hai người cùng chạy lệnh trên một file → người sau nhận ⏳ FILE ĐANG BẬN. Đợi vài giây rồi bấm lại.

🔄 Bước 0 · Cập nhật ĐGCT (chỉ dùng khi file sai thứ tự cột)

💡

Ghi chú: Dùng để đổi vị trí cột.
Chỉ sử dụng khi file dự toán của khách hàng gửi có đủ cột nhưng sai thứ tự cột so với cấu trúc của 2.DGCT chuẩn.
Cách làm: Dán dữ liệu thô vào sheet 2a.data DGCT (từ dòng 2), sau đó chạy lệnh 0️⃣ Bước 0 : Cập nhật ĐGCT để chương trình tự động ánh xạ cột theo tên tiêu đề sang sheet 2.DGCT.

0️⃣ Bước 0 : Cập nhật ĐGCT (Chuyển dữ liệu sang Format Chương Trình)

📥 2a.data DGCT → 2.DGCT DONG_BO_DGCT_CLIENT

Dùng khi nào: file dự toán của khách có đủ cột nhưng sai thứ tự cột so với 2.DGCT chuẩn.

Ánh xạ theo tên tiêu đề (dòng 1 của cả 2 sheet). So sánh sau khi bỏ hết khoảng trắng và không phân biệt hoa/thường — nên "Mã Hiệu" và "mãhiệu" vẫn khớp nhau.
Vùng dữ liệu cũ của 2.DGCT (từ dòng 2) bị xóa sạch trước khi dán. Copy nguyên cột nên giữ nguyên định dạng, sau đó ép cỡ chữ 11.
Cột nào ở 2.DGCT không tìm thấy tiêu đề tương ứng bên 2a thì bị bỏ qua (để trống).
Kết quả: thông báo "Đã chuyển N dòng x M cột". Nếu báo "Không có cột nào khớp tiêu đề" → tiêu đề 2 sheet đang lệch nhau, sửa lại dòng 1 rồi chạy lại.

1️⃣ Bước 1 : Phân loại Budget

🏷️ Gán loại chi phí vào cột M của 1.BOQ BUOC_1_PHAN_LOAI_FORMAT

Đọc 1.BOQ + 2.DGCT, tự phân loại từng dòng công việc rồi ghi vào cột M:

Nhãn cột M	Nghĩa	Sẽ nằm ở đâu trong 3.NS
1.TG	Giao thầu trọn gói (thầu giá)	Mục II
2.NC	Chỉ nhân công (đơn giá vật tư cột F = 0)	Mục I
3.VT+NC	Vật tư + nhân công (cột F > 0)	Mục I (công việc) + Mục III (bung vật tư từ 2.DGCT)

Lệnh còn tự động:

Nới 1.BOQ lên tối thiểu 30 cột (AA/AB/AC = khối "đã thanh toán CĐT"; AD = ghi đè phân loại thủ công).
Tô nền xanh + in đậm toàn bộ dòng hạng mục La Mã.
Sinh lại công thức các cột tính tiền: I = E×F, J = E×G, K = E×H, L = I+J+K, và tổng SUM cho dòng La Mã.
Gắn dropdown cột N với 20 lựa chọn GK_XD_1…10 / GK_ME_1…10. Riêng dòng 1.TG ô N bị đặt "Không Nhập" và tô vàng.

⚠️

Việc bắt buộc của người dùng sau Bước 1: rà lại cột M (máy phân theo tiền tố mã hiệu nên có thể sai với mã lạ) và điền GK_XD_*/GK_ME_* vào cột N cho các công việc khoán gói theo m². Sai ở đây sẽ kéo sai toàn bộ 3.NS.

2️⃣ Bước 2 : Chạy dự án (Tạo bảng)

🚀 Dựng 3.NS + 4.BAO CAO BUOC_3_CHAY_DU_AN

Cổng chặn: nếu còn dòng có mã hiệu mà cột M trống, lệnh dừng và báo "⚠️ CHƯA THỂ CHẠY BƯỚC 2 — phát hiện N dòng chưa phân loại" → quay lại chạy Bước 1.
Hộp thoại đặt tên hạng mục: khi BOQ có ≥ 2 hạng mục La Mã, add-on mở hộp thoại ĐẶT TÊN HẠNG MỤC DỰ ÁN — nhập tên cho từng mục (I, II, III…) rồi bấm chạy. Nếu chỉ có 1 hạng mục, lệnh chạy thẳng không hỏi.
Kết quả: 3.NS phân cấp 2 tầng (26 cột; cột ẩn V/W/X = mốc báo cáo lần trước, Y = mã hiệu đã chốt, Z = UID) và 4.BAO CAO đầy công thức.
Mã hiệu trùng nhau nhưng khác đơn giá sẽ được đánh phiên bản .a, .b…

🛑

Mất dữ liệu: 3.NS bị xóa và dựng lại từ đầu. Mọi ghi chú, đơn giá NTP, phân nhóm bạn đã sửa tay trên 3.NS sẽ mất. Mốc 24h (V/W/X) cũng được reset. Hãy sao lưu trước khi chạy lại trên một dự án đang vận hành.

3️⃣ Bước 3 : Gộp nhóm tự động bảng 3.NS

🗂️ Tạo dấu +/− 2 tầng (Ông – Cha) BUOC_3_GOP_NHOM_TU_DONG

Gỡ toàn bộ group cũ rồi dựng lại theo cột A: hạng mục La Mã = tầng 0, nhóm cấp 1 (I.1) = tầng 1, nhóm con và dòng chi tiết = tầng 2. Kết thúc lệnh, bảng được thu gọn toàn bộ — bấm dấu + để mở từng nhóm.

ℹ️

Chạy lại Bước 3 sau mỗi lần dùng Công cụ 4, 5, 6, 7, 10 (các lệnh thêm/xóa/dời dòng làm hỏng cấu trúc group).

🔍 Kiểm tra ngược lệch Vật tư (1.BOQ ↔ 2.DGCT) MỚI

🔍 Đối chiếu tiền vật tư giữa BOQ và bảng phân tích đơn giá KIEM_TRA_LECH_VAT_TU

So sánh, với từng dòng thuộc nhóm 2.NC và 3.VT+NC: tiền vật tư ghi ở 1.BOQ (KL cột E × đơn giá VT cột F) và tiền vật tư tính lại từ chi tiết hao phí trong 2.DGCT. Ngưỡng bỏ qua nhiễu làm tròn: chênh ≤ 100 đ hoặc ≤ 0,01%.

Add-on trả về 3 thứ

Trên 1.BOQ: ô cột F được tô màu + gắn ghi chú. CAM = lệch đơn giá; ĐỎ = lỗi nặng (thiếu khối định mức trong 2.DGCT / dò trật mã / dòng 2.NC nhưng vẫn có tiền vật tư).
Sheet KT_Lệch_VT (tự tạo, ghi đè mỗi lần chạy): bảng chi tiết từng dòng lệch, có link bấm thẳng tới dòng tương ứng ở 1.BOQ và 2.DGCT, kèm tổng chênh lệch.
Popup tổng hợp: tổng VT theo BOQ, tổng VT theo DGCT, chênh lệch, số dòng lệch; cảnh báo nếu số công việc ở 1.BOQ ≠ số khối định mức ở 2.DGCT, và cảnh báo STT trùng trong cùng một hạng mục.

✅

Không có dòng nào vượt ngưỡng → "Tổng vật tư BOQ khớp DGCT". Đây là điều kiện lý tưởng trước khi chạy Bước 2.

⚠️

Luật chung sau khi dùng công cụ: chạy lại 3️⃣ Bước 3 (Gộp nhóm) và 🔢 8. SẮP XẾP. Nếu công cụ có động tới vật tư (Mục III), chạy thêm 🔄 Cập nhật KHO VẬT TƯ bên menu QUẢN TRỊ CCM để vá #REF! và cấp UID cho dòng mới.

Danh sách 7 công cụ

🔀 4. PHÂN NHÓM: Chuyển CV/VT sang nhóm khác UI_CHUYEN_NHOM_CONG_VIEC

Bôi đen các dòng cần chuyển ở 3.NS → mở hộp thoại chọn nhóm đích → add-on dời dòng và tính lại tổng của cả nhóm nguồn lẫn nhóm đích.

Hộp thoại liệt kê nhóm đang có trong hạng mục, và nhóm chuẩn chưa có (chọn thì add-on tự tạo nhóm mới).
Nhóm chuẩn của Mục III (vật tư): CƠ ĐIỆN · SẮT, THÉP & KIM LOẠI KHÁC · XI MĂNG, CÁT, ĐÁ & BÊ TÔNG · GẠCH XÂY, ỐP LÁT & ĐÁ TỰ NHIÊN · GỖ, VÁN PHIM & CẤU KIỆN GỖ · SƠN, BẢ, CHỐNG THẤM & HÓA CHẤT · KÍNH, NHÔM & PHỤ KIỆN · TRẦN, VÁCH NGĂN & THẠCH CAO · VẬT TƯ KHÁC · VẬT TƯ PHÁT SINH. Riêng CƠ ĐIỆN có 6 nhóm con (dây cáp, ống luồn, thiết bị điện, ống nước, thiết bị nước, vật tư phụ).
Chỉ chuyển được trong cùng một hạng mục La Mã.

🔗 5. GỘP: Gộp các CV/VT thành một GOP_CONG_VIEC_VAT_TU

Gộp nhiều dòng thành 1 dòng tổng. Điều kiện: chọn ≥ 2 dòng, cùng hạng mục, cùng đơn vị tính, và đều là dòng chi tiết (không gộp dòng tiêu đề nhóm in đậm).

Khối lượng và thành tiền được nối thành công thức sống (vẫn chảy theo 1.BOQ/2.DGCT), không phải số chết.
Mã hiệu mới sinh ra bằng cách cụm hóa các mã thành phần; tên là danh sách tên đã khử trùng.
Add-on lưu ảnh chụp dữ liệu gốc vào sheet ẩn _GOP_SNAPSHOT để lệnh TÁCH khôi phục được. Tuyệt đối không xóa sheet ẩn này.

✂️ 6. TÁCH: Tách CV/VT đã được gộp TACH_CONG_VIEC_VAT_TU

Hoàn tác lệnh GỘP: bôi đen dòng đã gộp → add-on đọc snapshot và bung trở lại các dòng gốc.

Nếu dòng gộp bị copy–dán nhân bản (trùng UID), add-on từ chối tách và báo rõ số dòng để bạn xóa bản thừa (tránh nhân đôi dữ liệu).
Kết thúc lệnh bắt buộc chạy 🔢 8. SẮP XẾP.

➕ 7. THÊM CV/VT MỚI (chèn dưới dòng bôi đen) TAO_CV_VT_MOI

Trỏ vào một dòng chi tiết hoặc dòng trống trong 3.NS → mở form nhập công việc/vật tư mới → dòng mới được chèn ngay bên dưới.

Không cho chèn ngay tại dòng tiêu đề (La Mã I, II… hoặc nhóm I.1, I.1.a) — add-on sẽ báo "⛔ Không hợp lệ".

🔢 8. SẮP XẾP: Sắp xếp lại thứ tự CV/VT và đánh lại STT SAP_XEP_VA_DANH_LAI_STT

Chạy trên toàn bộ 3.NS (không cần bôi đen):

Sắp xếp A→Z theo tên (cột C) trong từng khối dòng chi tiết.
Đánh lại STT dòng chi tiết (1, 2, 3…) và số nhóm cấp 1 (I.1, I.2…). Phần chữ của nhóm con (I.1.a…) do bạn đặt được giữ nguyên.
Dựng lại toàn bộ công thức tổng của mọi nhóm trong mọi hạng mục — đây là lệnh "dọn dẹp" chuẩn hóa sau khi bạn cắt/dán dòng thủ công.

📏 9. ĐỔI ĐƠN VỊ: Đổi đơn vị hoặc tách nhỏ Vật tư UI_CHIA_NHO_VAT_TU

Bôi đen 1 dòng vật tư → add-on hỏi xác nhận → mở hộp thoại đổi đơn vị / chia nhỏ theo hệ số quy đổi.

Hộp thoại tự liệt kê các vật tư cùng đơn vị, cùng nhóm nhỏ nhất để bạn tích chọn đổi hàng loạt.
Mọi lần đổi đơn vị được ghi nhật ký vào sheet _DVT_LOG — nhật ký này sẽ được gửi kèm khi bạn "Đẩy vật tư lên Web App".
Khuyến cáo của add-on: làm xong Công cụ 4, 5, 6, 7 (sắp xếp CV/VT cho hợp lý) rồi mới đổi đơn vị.

🏷️ 10. ĐỔI PHÂN LOẠI: Sửa TG/NC cho dòng bôi đen ở 1.BOQ DOI_PHAN_LOAI_DONG

MỚI Công cụ duy nhất chạy trên sheet 1.BOQ. Cho phép đổi loại chi phí của 1 dòng công việc mà không cần chạy lại Bước 2.

Cách dùng

Mở 1.BOQ, bôi đen đúng 1 dòng công việc (từ dòng 9), chạy lệnh.
Gõ loại đích: 1.TG · 2.NC · 3.VT+NC (gõ tắt TG/NC/VT cũng được).

7 tình huống add-on xử lý

Chuyển đổi	Add-on làm gì
NC ↔ TG	Dời dòng công việc giữa Mục I và Mục II, đổi công thức đơn giá tương ứng. Không đụng vật tư.
VT+NC → NC	Hỏi xác nhận rồi xóa các dòng vật tư của công việc đó ở Mục III, tính lại tổng nhóm.
NC → VT+NC	Đọc lại `2.DGCT`, bung vật tư của công việc vào nhóm "VẬT TƯ PHÁT SINH" (Mục III).
TG → VT+NC	Dời dòng về Mục I + bung vật tư. Máy thi công (Mục IV) không tự thêm — phải bổ sung tay.
VT+NC → TG	Xóa vật tư Mục III + dời dòng sang Mục II. Máy thi công (Mục IV) không tự bỏ — kiểm tra tay.
VT thuần → TG	Công việc chỉ có vật tư (nhân công = máy = 0, nên Bước 2 không tạo dòng ở Mục I). Add-on hỏi xác nhận, xóa các dòng vật tư ở Mục III và tạo mới dòng trọn gói ở Mục II (đơn giá = F + G + H của 1.BOQ).
VT thuần → VT+NC	Giữ nguyên bảng vật tư ở Mục III và tạo mới dòng nhân công ở Mục I (đơn giá = G + H của 1.BOQ). Nếu G + H vẫn bằng 0, add-on không tạo dòng giá 0 — hãy nhập đơn giá nhân công/máy vào 1.BOQ trước rồi chạy lại.

ℹ️

Tự động TÁCH: nếu dòng công việc/vật tư liên quan đang bị GỘP chung, add-on tự tách ra trước rồi mới đổi loại. Trường hợp không tách an toàn được (UID bị sao chép), add-on dừng và chỉ rõ dòng nào cần bạn TÁCH thủ công.

⚠️

Chỉ áp dụng cho dòng đang nằm ở Mục I hoặc Mục II (hoặc công việc VT thuần — chỉ đổi được sang 1.TG hoặc 3.VT+NC), và 1 dòng mỗi lần. Sau khi xong: chạy Bước 3 → Công cụ 8 → Cập nhật KHO VẬT TƯ.

Thông báo	Nguyên nhân & cách xử lý
KHÓA HỆ THỐNG "Vui lòng chuyển ô M4 về Đang thiết lập"	File đang ở chế độ báo cáo. Vào `4.BAO CAO`, đổi ô M4 thành "Đang thiết lập" rồi chạy lại. Nhớ trả về "Bắt đầu tổ chức báo cáo" khi xong.
⚠️ CHƯA THỂ CHẠY BƯỚC 2	Còn dòng có mã hiệu nhưng cột M trống. Chạy Bước 1 trước; nếu vẫn còn, kiểm tra các dòng mới thêm tay vào 1.BOQ.
⛔ LỖI BẢN QUYỀN	Chưa kích hoạt hoặc Key sai/hết hạn. Vào 🔑 Kích hoạt / Đổi Key Bản quyền. Mỗi Key gắn với một file — copy file ra bản mới thì cần Key mới.
⏳ FILE ĐANG BẬN	Người khác đang chạy lệnh trên cùng file. Đợi vài giây và bấm lại.
Các mục được chọn không cùng đơn vị / không cùng hạng mục	Lệnh GỘP chỉ nhận các dòng cùng ĐVT và cùng một hạng mục La Mã. Bỏ bớt dòng lệch rồi gộp lại.
⚠️ Dòng gộp bị sao chép (UID trùng)	Bạn đã Ctrl+C/Ctrl+V nguyên dòng đã gộp. Xóa bản sao thừa rồi TÁCH lại.
`#REF!` ở sheet `9.KHO_Vật tư`	Bước 2 dựng lại 3.NS làm vỡ tham chiếu. Chạy 📦 Tạo mới KHO VẬT TƯ → 🔄 Cập nhật KHO VẬT TƯ (menu QUẢN TRỊ CCM).
Cảnh báo: Không có cột nào khớp tiêu đề (Bước 0)	Dòng tiêu đề (dòng 1) của `2a.data DGCT` và `2.DGCT` không có tên nào giống nhau. Sửa lại tên tiêu đề cho khớp.
⚠️ STT trùng (kết quả Kiểm tra ngược)	Trong cùng một hạng mục có 2 dòng cùng STT → việc ghép chi tiết vật tư có thể dò trật. Đánh lại STT liên tục trong hạng mục đó.

TẠO DỰ ÁN