Tạo KCN + Lô đất + Kho

Tạo KCN + Lô đất + Kho

KCN là đơn vị quản lý chính trong Parkone. Mọi cơ hội, báo giá, hợp đồng đều gắn với 1 KCN cụ thể. Đại tạo KCN đầu tiên ngay sau khi setup company.

Tiền điều kiện

• Setup Cấu hình công ty trước
• Có thông tin KCN: tên, vị trí, diện tích, danh sách lô đất + kho
• Có ảnh mặt bằng KCN (PNG/JPG) — cho site plan map

Cấu trúc dữ liệu KCN

KCN (zone.project)
├── Investor (res.partner)  ← Nhà đầu tư của KCN
├── Lô đất (zone.land.lot)
│   ├── Lô A1: 5000 m², lease_land
│   ├── Lô A2: 8000 m², lease_land
│   └── ...
├── Kho (zone.warehouse.unit)
│   ├── Kho W01: 1200 m², office
│   ├── Kho W02: 800 m², cold_storage
│   └── ...
├── Site Plan Image
└── Map (lat/long, zoom)

Bước 1: Tạo KCN

1.1. Mở menu

Khu công nghiệp (top bar) → Khu công nghiệp (sidebar) → click “Mới”

📸 Screenshot: list KCN với nút Mới

1.2. Điền thông tin cơ bản

Field	Vd	Ghi chú
Tên KCN	KCN Tân Hoà	Tên hiển thị, có thể đổi sau
Mã (Code)	THE-IP	Mã ngắn dùng trong report, vd “THE-IP” cho Tân Hoà
Nhà đầu tư (investor_id)	Apave Vietnam	M2o → res.partner. Click 🔗 chọn / Tạo mới
Quốc gia	Việt Nam	Auto-fill
Tỉnh / Thành	Long An	M2o res.country.state
District (legacy)	Đức Hoà	Optional — cấp huyện cũ
Phường / Xã	Mỹ Hạnh Bắc	Theo VN-2025 reform
Địa chỉ đầy đủ	KCN Tân Hoà, xã Mỹ Hạnh Bắc, Long An	Auto-compose hoặc tự gõ

Nhà đầu tư = ai?

Investor là pháp nhân sở hữu KCN (chủ đầu tư hạ tầng). KHÔNG phải res.company (Parkone workspace owner).

Vd: Apave Vietnam là chủ đầu tư KCN Demo Site Plan → Investor = res.partner “Apave Vietnam”.

Khi render hợp đồng, placeholder {{ record.project_id.investor_id.name }} lấy tên nhà đầu tư này.

1.3. Diện tích & thông số

Section “Diện tích”:

Field	Đơn vị	Vd
Total area	ha	120
Industrial area	ha	80 (đất công nghiệp cho thuê)
Green area	ha	15 (cây xanh)
Road area	ha	18 (đường giao thông)
Public works area	ha	7 (PCCC, trạm điện, …)

Leased / Available / Occupancy rate auto-tính từ lô đất đã ký HĐ.

1.4. Giấy phép

Section “Giấy phép”:

Field	Vd
Quyết định thành lập	1234/QĐ-TTg
Ngày thành lập	15/3/2010
Số GP đầu tư	INV-LA-2010-001
Ngày cấp GP đầu tư	20/3/2010
Thời hạn dự án (năm)	50

1.5. Save

Click “Save” (☁️). KCN record được tạo. ID auto-gen (vd 20).

Bước 2: Upload Site Plan

2.1. Chuẩn bị ảnh

• Format: PNG hoặc JPG
• Kích thước: 1500-3000px chiều rộng (chi tiết nhưng không quá nặng)
• File size: < 5 MB
• Nội dung: ảnh tổng thể KCN, có đánh số lô đất rõ

2.2. Upload

Trong form KCN → tab “Site Plan” → click vào ảnh placeholder → chọn file local → Upload.

📸 Screenshot: form KCN tab Site Plan với ảnh đã upload

2.3. Cấu hình map center + zoom

Nếu KCN có vị trí thực trên Google Maps:

Field	Vd	Lấy từ đâu
Map Center Lat	10.762622	Google Maps → click vào KCN → copy lat
Map Center Lng	106.660172	Google Maps → copy lng
Default Zoom	15	14-17 cho KCN nhỏ-vừa, 12-13 cho KCN lớn

2.4. Equipment markers (optional)

Trên site plan, có thể vẽ marker cho các thiết bị quan trọng:

• Trạm điện
• Bể nước
• Trạm cứu hoả
• Cổng vào

Click “Place equipment marker” → click trên ảnh để đặt vị trí.

Bước 3: Tạo Lô đất

Một KCN có nhiều lô đất. Mỗi lô có thuộc tính riêng.

3.1. Mở list Lô đất

Khu công nghiệp → Lô đất → Mới

Hoặc trong form KCN → tab “Lô đất” → click “Add a line”.

3.2. Thông tin Lô đất

Field	Vd	Ghi chú
Mã lô	A1-001	Unique trong KCN, vd theo block + số
Tên hiển thị	Lô A1	Friendly name
KCN	KCN Tân Hoà	M2o → zone.project (auto-fill nếu tạo từ tab)
Loại lô	Lease land	lease_land / sale_land / RBF (Ready-Built Factory) / Yard
Diện tích (m²)	5000	Số nguyên
Mặt tiền (m)	50	Optional — width của lô
Chiều sâu (m)	100	Optional
Vị trí (vùng)	Block A	Optional — group lô theo block
Trạng thái	Sẵn sàng	available / reserved / leased / sold / unavailable

3.3. Loại lô đất chi tiết

Loại	Mô tả	Use case
lease_land	Đất công nghiệp cho thuê	Phổ biến nhất — KH FDI thuê đất xây nhà máy
sale_land	Đất bán hẳn	Less common — chuyển nhượng quyền sử dụng đất
rbf	Ready-Built Factory	Nhà xưởng có sẵn cho thuê
yard	Sân bãi	Cho thuê làm bãi chứa hàng

Loại lô ảnh hưởng Lease Policy áp dụng (giá thuê khác nhau).

3.4. Vẽ vị trí trên site plan

Trong form Lô đất → tab “Vị trí trên bản đồ” → click chuột trên ảnh site plan → drag để vẽ polygon hoặc rectangle bao quanh lô.

Save lại — vị trí được lưu, sẽ highlight khi user click vào lô từ bản đồ tổng thể KCN.

Bulk import lô đất qua Excel

Nếu KCN có 50+ lô, nhập tay mất thời gian. Dùng Excel import:

1. Khu công nghiệp → Lô đất → menu icon ⚙️ → Import records

2. Tải template Excel mẫu — file có cột:

   • Mã lô (External ID)
   • Tên hiển thị
   • KCN (External ID hoặc tên)
   • Loại lô
   • Diện tích (m²)
   • …

3. Điền data vào Excel + save

4. Upload lại → Parkone parse + tạo records hàng loạt

5. Review errors (nếu có) → sửa Excel → re-import

Bước 4: Tạo Kho (Warehouse Unit)

Kho khác lô đất:

• Lô đất: đất trống cho KH thuê xây nhà máy
• Kho: nhà / kho có sẵn cho thuê (RBF, office, cold storage…)

4.1. Mở list Kho

Khu công nghiệp → Kho → Mới

4.2. Thông tin Kho

Field	Vd	Ghi chú
Mã kho	W01	Unique
Tên kho	Kho A1	Friendly
KCN	KCN Tân Hoà	M2o
Lô gốc (parent_lot_id)	Lô A1	Optional — kho thuộc lô nào
Loại kho	RBF / Office / Cold storage / Yard	Selection
Diện tích (m²)	1200
Chiều cao thông thuỷ (m)	6	Cho RBF
Số cửa xuất nhập (dock)	2
Có gác lửng văn phòng	✅	Boolean
Trạng thái	Sẵn sàng	available / leased / unavailable

4.3. Giá thuê tham khảo

Field	Vd	Ghi chú
Giá thuê tham khảo (VNĐ/m²/tháng)	5,000,000	Giá list — báo giá thực có thể khác
Phí quản lý tham khảo (VNĐ/m²/tháng)	500,000

Giá này hiển thị trên bản đồ tổng quan KCN cho KH tham khảo.

Bước 5: Tạo Equipment (Tài sản)

Equipment = thiết bị hạ tầng KCN (trạm điện, hệ thống nước, camera, …). Khác hàng hoá bán/cho thuê.

Equipment dùng cho:

• Bảo trì định kỳ
• Predictive maintenance (cảnh báo gần hư)
• Theo dõi warranty

5.1. Mở list Equipment

Bảo trì → Thiết bị → Mới

5.2. Thông tin Equipment

Field	Vd	Ghi chú
Tên thiết bị	Máy phát điện 500 kVA
Loại	Electric / HVAC / Plumbing / Fire / IT / Other	Selection
KCN	KCN Tân Hoà	M2o
Vị trí	Trạm điện trung tâm	Free text
Nhà sản xuất	Caterpillar
Model	CAT-3406
Số serial	SN-2023-001
Ngày lắp đặt	1/1/2024	Date
Hạn warranty	1/1/2027	Date
Cost	800.000.000 VND	Monetary

5.3. Schedule bảo dưỡng

Tab “Lịch bảo dưỡng”:

Field	Vd
Tần suất	Mỗi 3 tháng
Loại bảo dưỡng	Preventive
Assigned to	Maintenance team
Last serviced	1/3/2026
Next due	1/6/2026 (auto-calculated)

Kiểm tra setup KCN

Sau khi tạo xong KCN + lô + kho:

Trên dashboard

Khu công nghiệp → click vào KCN → trang chi tiết hiện ra với:

• Tổng diện tích, % lấp đầy
• Bản đồ site plan với lô đất overlay
• List lô đất + kho (sortable, filterable)
• KPI: doanh thu KCN này, số HĐ active, …

SQL check (Admin)

docker exec zonepro-db psql -U odoo -d <workspace> -c "
SELECT
  p.name AS kcn,
  COUNT(DISTINCT l.id) AS so_lo,
  SUM(l.area_sqm) AS tong_dien_tich,
  COUNT(DISTINCT w.id) AS so_kho
FROM zone_project p
LEFT JOIN zone_land_lot l ON l.project_id = p.id
LEFT JOIN zone_warehouse_unit w ON w.project_id = p.id
GROUP BY p.id, p.name;
"

Output cho thấy số lô + kho mỗi KCN. Verify khớp expectation.

Cập nhật trạng thái lô đất

Trong vòng đời, lô đất chuyển trạng thái:

available  →  reserved  →  leased  →  (sau HĐ kết thúc) → available
                        ↘  sold (nếu lease_type = sale_land)

            ↘  unavailable (vd lô cần GPMB)

Đại có thể đổi trạng thái thủ công (Sales rep / Admin) khi:

• KH đặt cọc → state = reserved
• HĐ ký → state = leased / sold
• HĐ chấm dứt → state = available

Hoặc auto-update qua workflow:

• Đặt cọc state=signed → lô đất linked → reserved (auto)
• HĐ state=active → lô đất → leased (auto)

Câu hỏi thường gặp

KCN của tôi có nhiều phân khu — quản lý sao?

Có 3 approach:

Approach 1: Tạo 1 KCN + group lô đất theo “Vị trí (vùng)”

• Field lô.location = “Block A” / “Block B” / …
• Filter lô đất theo location khi xem

Approach 2: Tạo 1 KCN parent + nhiều KCN con (sub-projects)

• Cần Dev mode để add parent_project_id
• Phức tạp hơn

Approach 3: Tạo nhiều KCN riêng biệt (nếu phân khu thực sự độc lập về pháp lý)

Khuyến nghị Approach 1 cho hầu hết case.

Diện tích cho thuê tự update khi nào?

leased_area_ha được compute từ:

SUM(area của các lô đất có state = 'leased' trong KCN)

Auto-update mỗi khi:

• Tạo HĐ thuê đất mới
• Đổi state lô đất

occupancy_rate = leased_area_ha / industrial_area_ha × 100.

Site plan map tải chậm?

Ảnh > 5MB sẽ load chậm. Compress trước upload:

• tinypng.com — giảm 50-70% size, giữ chất lượng
• Target: file < 2MB cho UX tốt

Có thể xóa KCN không?

Có, nhưng:

• Chỉ xoá được nếu KHÔNG có lô đất / HĐ / hoá đơn liên quan
• Khuyến nghị: archive (set inactive=False) thay vì xoá

Archive KCN → ẩn khỏi list mặc định nhưng giữ history.

Bước tiếp theo

Tạo Khách hàng

Partner profile cho khách thuê — FDI/DDI, MST, legal rep, bank.

Đọc →

Cấu hình chính sách giá

Lease Policy theo lô đất + loại KH (FDI/DDI/SME).

Đọc →