Bảo trì & Yêu cầu dịch vụ

KCN có hàng nghìn thiết bị hạ tầng — trạm biến áp, hệ thống cấp nước, đường nội bộ, đèn chiếu sáng, hệ thống PCCC, xử lý nước thải. Mỗi thiết bị cần bảo trì định kỳ + sửa chữa khi hỏng. Khách thuê (tenant) cũng phát sinh yêu cầu hằng ngày: “đèn đường khu A cháy”, “đường ngập nước”, “máy phát điện báo lỗi”.

Module Bảo trì của Parkone giải quyết:

Quản lý thiết bị (maintenance.equipment + zone.equipment.meter)
Lịch bảo trì định kỳ (mở rộng từ maintenance.request của Odoo)
Yêu cầu dịch vụ từ tenant (zone.service.request) — kèm SLA + chuyển PO sang nhà cung cấp
Đọc công tơ (zone.equipment.reading) cho điện / nước / khí
Predictive maintenance — alert khi reading vượt ngưỡng

Cấu trúc 5 entity

flowchart LR
    A["zone.project<br/>KCN"] --> B["maintenance.equipment<br/>Thiết bị"]
    B --> C["zone.equipment.meter<br/>Công tơ"]
    C --> D["zone.equipment.reading<br/>Lần đọc"]
    B --> E["maintenance.request<br/>Yêu cầu bảo trì nội bộ"]
    A --> F["zone.service.request<br/>Yêu cầu dịch vụ KH"]
    F --> G["purchase.order<br/>PO sang NCC"]

Model	Vai trò
`maintenance.equipment`	Mở rộng module `maintenance` Odoo — thêm field KCN, vị trí, marker GPS, ngày bảo hành, supplier maintainer
`zone.equipment.meter`	Công tơ gắn vào equipment (điện kWh / nước m³ / khí m³)
`zone.equipment.reading`	Lịch sử reading — ngày, value, recorded_by
`maintenance.request`	Yêu cầu bảo trì nội bộ KCN (thay dầu, hiệu chuẩn, sửa) — Odoo native + Parkone tag KCN
`zone.service.request`	Yêu cầu dịch vụ từ tenant (khác maintenance) — có SLA + chuyển PO sang NCC

Quản lý thiết bị

Tạo equipment

KCN > Bảo trì > Thiết bị > Mới:

Field	Mô tả
`name`	Tên thiết bị (vd “Trạm biến áp T1 — Khu A”)
`category_id`	Loại (Trạm điện / Trạm nước / PCCC / Đèn chiếu sáng / Máy phát …)
`zone_project_id`	KCN thuộc về
`location`	Vị trí mô tả + GPS marker (xem Site plan markers)
`serial_no`	Số seri nhà sản xuất
`purchase_date`	Ngày mua
`cost`	Giá mua
`warranty_end_date`	Hết bảo hành
`x_warranty_state`	Computed: `under_warranty` / `expiring_soon` (≤ 30 ngày) / `expired`
`maintainer_id`	Nhà cung cấp bảo trì (link `res.partner` supplier)
`parent_id`	Thiết bị mẹ (nếu là phụ kiện)

Site plan markers

Mỗi equipment có thể đặt marker GPS trên bản đồ KCN. Vào KCN > Lô đất > Site Plan → bấm 🛠️ Place equipment marker → click vào vị trí trên map → chọn equipment. Marker hiện trên bản đồ kèm icon theo category.

Lưu trong field x_geo_marker (JSON {lat, lng}). Render bằng Leaflet trong UI.

Lịch bảo trì định kỳ

Tạo maintenance.request lặp lại trong Settings > Maintenance: vd “Hiệu chuẩn trạm biến áp T1 — mỗi 6 tháng”. Cron Odoo tự sinh request mới khi tới hạn. Parkone enrich thêm:

Tab “Equipment KCN” với filter theo zone_project_id.
Activity nhắc rep / maintainer N ngày trước.
PDF check-list (template per category).

Đọc công tơ

Tạo công tơ

Equipment có thể có nhiều công tơ:

Field	Mô tả
`name`	Tên công tơ (vd “Đồng hồ điện chính”)
`meter_type`	`electricity` / `water` / `gas` / `other`
`unit`	kWh / m³ / khác
`last_reading_value`	Reading gần nhất (computed)
`last_reading_date`	Ngày reading gần nhất
`threshold_value`	Ngưỡng cảnh báo (đầy / tiêu thụ bất thường)

Ghi lần đọc

Trên công tơ, bấm 📊 Ghi reading mới: Ngày + giờ · Value (số đếm hiện tại — KHÔNG phải delta) · Người ghi (default user hiện tại) · Ghi chú.

Hệ thống tự tính delta = value - last_reading.value + period_consumption = delta / (date - last_date).

Predictive maintenance alerts

Cron daily _cron_check_meter_thresholds:

Reading có value ≥ threshold_value → tạo maintenance.request “Inspect — meter exceeded threshold”.
Reading có period_consumption vượt 130% so với 3 kỳ trước → alert “Tiêu thụ bất thường — kiểm tra rò rỉ”.
Ping maintainer_id qua activity.

Yêu cầu dịch vụ từ tenant

Khác với maintenance.request (bảo trì nội bộ), zone.service.request là yêu cầu của KH thuê:

State machine

stateDiagram-v2
    [*] --> new: 🆕 Tenant gửi yêu cầu
    new --> in_progress: 👷 Assign cho staff
    in_progress --> resolved: ✅ Đã xử lý
    resolved --> closed: 🔒 KH xác nhận xong
    new --> cancelled: ❌ Hết hiệu lực
    in_progress --> cancelled: ❌ KH huỷ
    closed --> [*]
    cancelled --> [*]

State	Nhãn UI	Hành động chính
`new`	New	Vừa tạo, chưa assign
`in_progress`	In Progress	Đang xử lý — clock bắt đầu chạy
`resolved`	Resolved	Đã sửa, đợi KH xác nhận
`closed`	Closed	KH OK, đóng request
`cancelled`	Cancelled	Huỷ trước khi xử lý

Field quan trọng

Field	Mô tả
`request_type_id`	`zone.service.request.type` — phân loại (Điện / Nước / Đường / An ninh / …)
`contract_id`	HĐ của KH (auto-filter lô đất theo contract)
`land_lot_id`	Lô đất bị ảnh hưởng (filter theo `contract_id.land_lot_ids`)
`equipment_id`	Equipment liên quan (nếu có)
`priority`	Low / Normal / High / Urgent (4 mức)
`sla_response_hours`	Default theo type (Urgent = 2h, Normal = 24h)
`sla_response_due`	Computed: `create_date + sla_response_hours`
`is_sla_breached`	Boolean computed: quá hạn SLA mà state vẫn `new` / `in_progress`
`description`	Mô tả vấn đề
`resolution_note`	Kết luận

SLA tracking

Field is_sla_breached hiện đỏ trên list view. Activity nhắc rep gần tới giờ SLA. Báo cáo SLA breach % per type / per assigned employee.

Tạo PO sang nhà cung cấp

Nếu cần thuê NCC bên ngoài xử lý (vd sửa máy lạnh phức tạp), bấm 📦 Tạo PO:

Sinh purchase.order draft.
partner_id = NCC chọn từ recommendation (theo category_id).
Line: dịch vụ + ước tính giá.
Link 2 chiều: service_request.po_id ↔ po.service_request_id.

Khi PO done + invoiced → service request auto in_progress → resolved.

Khuyến nghị NCC

Khi tạo PO, Parkone gợi ý NCC dựa trên: partner.x_supplier_category_ids chứa category của request · partner.x_supplier_status = approved / preferred · partner.x_supplier_rating cao · lịch sử on-time delivery + giá cạnh tranh.

Rep có thể override gợi ý nhưng phải nhập lý do (audit).

Tenant portal — KH tự gửi yêu cầu

Module customer portal cho phép tenant đăng nhập + gửi service request qua web form:

URL: parkone.bsdinsights.com/my/service-requests
Login = portal user của tenant (auto-tạo khi convert deposit → contract).
KH chỉ thấy request của HĐ mình + lô đất mình thuê.
Form tối thiểu: type / land lot / description / priority / ảnh đính kèm.

Yêu cầu tạo qua portal có flag is_from_portal = True → assigned rep biết origin.

Báo cáo

KCN > Bảo trì > Báo cáo: số request theo type / theo tháng · SLA breach rate % · Top 5 equipment có nhiều request nhất (= cần thay thế?) · tổng chi phí PO bảo trì theo quý · equipment hết bảo hành 30 ngày tới.

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

Gắn 1 yêu cầu vào 2 HĐ (KH share đường nội bộ) được không? Hiện 1 service request = 1 contract. Trường hợp nhiều KH cùng bị ảnh hưởng (vd mất điện cả khu) → tạo nhiều request riêng, mỗi KH 1 cái. Có thể tag chung qua parent_request_id (planning).

Tắt predictive alert cho 1 công tơ được không? Được. Đặt threshold_value = 0 → cron skip. Hoặc is_predictive_enabled = False → tắt hẳn check cho công tơ đó.

Reading nhập sai (vd 100 thay vì 1000) ảnh hưởng gì? Hệ thống validate value ≥ last_reading.value. Nhập lùi → UserError. Nếu công tơ thực sự reset (thay mới), bấm Reset meter + nhập value mới — delta tính lại từ reset point.

Tenant gửi request qua portal nhưng mất login? Rep tạo thay (mode “On behalf of tenant”). Hoặc reset portal password trong KH > Liên hệ > [chọn KH] > Action > Send invitation email.

Cron predictive maintenance chạy bao lâu 1 lần? Mặc định daily 04:00. Đổi trong Settings > Technical > Scheduled Actions > “Parkone: check meter thresholds”.

PO done rồi nhưng request chưa auto resolved? Logic auto-resolve check po.state = done AND po.invoice_status = invoiced. Nếu PO done nhưng invoice chưa post → vẫn in_progress. Bấm ✅ Mark resolved manual.

Liên kết liên quan

Module GPMB Sau GPMB cần cải tạo + lắp thiết bị.

Module Hợp đồng Tenant của HĐ là người gửi service request.

Bắt đầu nhanh Setup KCN đầu tiên.