Cấu hình ban đầu

Sau khi cài xong, cấu hình theo 8 bước trước khi tạo dữ liệu sản xuất:

1. Tạo công ty (MST, GPKD, địa chỉ)
2. Cấu hình ngân hàng + chi nhánh
3. Tạo loại thuế VAT (8% / 10%)
4. Tạo người dùng + gán quyền
5. Sequences đã ship sẵn — xem để biết
6. Cấu hình từng module (Loan / Project / Đấu thầu / Tiến độ)
7. Master nhà thầu — import danh sách
8. Smoke test — tạo DA mẫu → gói thầu → ký HĐ → BBN

Mẹo

Làm lần lượt từ trên xuống. Bỏ qua bước nào → bước sau sẽ block (vd thiếu ngân hàng → không tạo được HĐ tín dụng).

Tạo công ty

Module địa chỉ VN

Realty Project ship sẵn vn_administrative_units — chuẩn 34 tỉnh + phường/xã Việt Nam mới nhất. Settings → Apps → search “Vietnam Administrative Units” → Install. Sau đó các form địa chỉ có ward picker thay vì free-text, tránh nhập sai “Hồ Chí Minh” vs “Tp HCM”.

Thông tin công ty

Settings → Users & Companies → Companies → chọn công ty:

Field	Ví dụ	Cần cho
Tên công ty	”Công ty TNHH XYZ”	Báo cáo, HĐ, hoá đơn
Đường + số nhà	”123 Nguyễn Văn Cừ”	Hoá đơn, HĐ
Phường/Xã (ward picker)	Chọn từ dropdown	Đối tác hợp lệ
Quận/Huyện · Tỉnh/TP	Tự fill khi pick ward	—
Mã số thuế	”0123456789” (13 số nếu chi nhánh)	Báo cáo thuế, HĐ
Currency	VND	Mặc định mọi báo cáo

Community = 1 công ty

Realty Project Community chỉ hỗ trợ 1 công ty. Tập đoàn nhiều pháp nhân → bản Enterprise hoặc deploy nhiều stack riêng.

Cấu hình ngân hàng

20 NHTM lớn VN ship sẵn khi cài re_loan (Big 4: Vietcombank, BIDV, VietinBank, Agribank · TMCP: Techcombank, MB, ACB, VPBank, Sacombank, HDBank, SHB, TPBank, Eximbank, OCB, MSB, LPBank · nước ngoài: ANZ, Shinhan, HSBC, Standard Chartered) — mỗi NH có BIC code chuẩn ISO 9362.

• Thêm chi nhánh: Settings → Companies → Banks → chọn NH → tạo Branch (tên + địa chỉ + BIC).
• TK công ty: Settings → Companies → Bank Accounts → tạo (số TK + NH + đối tác = công ty + currency VND). Mỗi TK = 1 record; auto-fill “TK trích thu” trong Trích thu tự động sẽ filter theo NH.

Cấu hình thuế VAT

Settings → Accounting → Taxes (cần module account):

	VAT 8% (xây dựng VN)	VAT 10% (chuẩn)
Tax computation	Percentage of price	Percentage of price
Amount	8	10
Tax type	Purchases (NCC) / Sales	Purchases / Sales

HĐ nhà thầu có sẵn vat_rate = 8.0 default — đổi 10 cho HĐ đặc thù.

Người dùng & phân quyền

3 nhóm quyền, mỗi nhóm có hierarchy User → Manager → Admin:

Nhóm	Vai trò
Realty Sales	Bao trùm — view projects, units, master data. Pick 1 cho mọi user
Realty Loan	HĐTD, KW, giải ngân, trích thu — kế toán vay vốn
Realty Progress	BBN nghiệm thu, tiến độ — PM, kỹ sư công trường

Hierarchy: User (đọc) → Manager (đọc/ghi/tạo, không xoá) → Administrator (full CRUD + config). Mỗi cấp implies cấp dưới.

Tạo user

Settings → Users & Companies → Users → Tạo: Name · Email (login + notification) · User Type “Internal User” · pick mức cho từng nhóm (Realty Sales / Loan / Progress).

Mẫu phân quyền điển hình

Vai trò	Sales	Loan	Progress
Kế toán vay vốn	User	Manager	—
PM dự án	Manager	User	Manager
Bộ phận đấu thầu	Manager	—	—
Chỉ huy công trường	User	—	User
CĐT duyệt BBN	User	—	Manager
Giám đốc	Admin	Manager	Manager

ACL Odoo 19

Realty Project dùng pattern Odoo 19 mới (res.groups.privilege): trên form User → tab “Other”, các nhóm quyền hiện dạng radio button dưới header section thay vì checkbox rời → giảm gán nhầm.

Sequences (tự động)

Các sequence ship sẵn cùng module — không cần config tay:

Code	Prefix	Module
re.loan.note.disbursement	GN/YYYY/	re_loan
re.loan.bank.advice	GBC/YYYY/	re_loan
rp.progress.acceptance	BBN-YYYY-	rp_progress
re.guarantee.request	BL-YYYY-	re_guarantee
re.guarantee.certificate	CTBL-YYYY-	re_guarantee

Đổi prefix: Settings → Technical → Sequences → tìm code → sửa. Các sequence dùng %(year)s → tự reset về 00001 mỗi năm, không cần can thiệp.

Cấu hình từng module

• Quản lý Vay (re_loan): không có config bắt buộc — tạo qua master: HĐTD → Facility (phân hạn mức) → KW (auto sinh lịch lãi).
• Quản lý Dự án (rp_cost_base): tạo Cost Categories (nhóm chi phí, vd “9.1 Lãi vay capitalized” cho VAS) trước; Specialties ship sẵn 12 chuyên môn chuẩn VN.
• Đấu thầu (rp_estimate): tiêu chuẩn đánh giá HSDT không có data mặc định — dùng button “Tạo bộ tiêu chí mẫu” trên mỗi gói (4 capacity + 3 technical + 1 price), chỉnh sau.
• Tiến độ (rp_progress): SLA CĐT duyệt BBN default 7 ngày (sla_response_days trên HĐ, đổi mỗi HĐ); UoM ship sẵn các đơn vị xây dựng VN (m, m², m³, kg, tấn, cái, bộ, ca, công).

Master nhà thầu — import

Nếu đã có danh sách 50-200 nhà thầu trong Excel:

1. Chuẩn bị Excel với cột tối thiểu: Tên NT · Mã NT · MST · Số GPKD · Số chứng chỉ năng lực + Hạng (1/2/3) · Ngày hết hạn · Loại NT · Liên hệ + SĐT + email.
2. Import: Settings → Realty → Nhà thầu → upload Excel (import chuẩn Odoo).
3. Duyệt: mọi NT import = “Prospect”. Duyệt từng NT (approved) trước khi cho tham gia đấu thầu — dropdown bidder chỉ hiện NT approved.

Smoke test post-setup

Test end-to-end với data mẫu trước khi go-live:

1. Dự án mẫu — Realty Project → Project Master → Dự án → tạo “DA Test Setup” (code “TEST”), thêm 1 phân khu + 1 hạng mục có ngày BĐ/KT kế hoạch.
2. Gói thầu — tạo gói, chọn dự án, add hạng mục, hình thức “Chỉ định thầu”, deadline tương lai, giá trần 100.000.000 ₫ → Duyệt KH.
3. Bidder — tab Danh sách nhà thầu → thêm 1 bidder (cần ≥1 NT approved), giá 90.000.000 ₫ → “Chọn trúng”.
4. Đi hết workflow tới Ký HĐ → tự tạo rp.contract draft.
5. Mở HĐ — điền VAT 8%, 1 milestone “Tạm ứng 20%”, post → signed.
6. BBN nghiệm thu — Tiến độ → BBN KLCV → tạo, pick HĐ, thêm 1 line, submit → CĐT duyệt.

Verify: hạng mục % nghiệm thu cập nhật từ BBN · Gantt hiện 2 cấp Hạng mục → HĐ · HĐ amount_paid chưa đổi (chưa giải ngân — đúng). → Setup OK, sẵn sàng tạo data thực.

---

Tiếp theo: Quản lý Dự án →