Cấu hình License & Quota

Parkone theo mô hình open-core: phần Community miễn phí + mã nguồn mở, phần Enterprise được cấp phép qua License key offline (không call-home). Bạn không cần internet để verify license — Parkone tin tưởng chữ ký số Ed25519 trên key.

Hai loại license

🆓 Free Forever — không cần key

Mặc định khi cài mới. Đầy đủ tính năng Enterprise trong hạn mức:

✅ 1 Khu công nghiệp (zone.project)
✅ 10 khách thuê hoạt động (hợp đồng active)
✅ 5 người dùng nội bộ (internal users — không tính portal users)
✅ Khách thuê portal user: không giới hạn
✅ Nhà cung cấp: không giới hạn

Vượt 1 trong 3 con số trên → hệ thống chặn mềm: hiện thông báo thân thiện, dữ liệu cũ vẫn nguyên, chỉ không cho tạo thêm tới khi nâng hạn mức.

💼 Tier trả phí — dán key vào `odoo.conf`

Khi cần hơn 10 khách thuê hoặc hơn 1 KCN, liên hệ anh Đại để mua key:

Tier	KCN	Tenants	Users	Self-host	Managed
Standard	3	100	20	✅	✅
Pro	10	500	50	✅	✅
Unlimited	∞	∞	∞	✅	✅

Self-host = bạn quản lý VPS, Parkone HQ chỉ cấp key.
Managed = Parkone HQ host trên VPS riêng cho bạn + giám sát 24/7.

Kích hoạt license key

Khi nhận được key dạng eyJhbGciOiJFZERTQSIs... (rất dài):

SSH vào VPS Parkone:
Terminal window
```
cd ~/parkone
```
Mở odoo.conf (ở thư mục gốc nơi cài):
Terminal window
```
nano odoo.conf
```

Thêm dòng (hoặc sửa nếu đã có):

parkone_license_key = eyJhbGciOiJFZERTQSIs...

Khởi động lại container:
Terminal window
```
docker compose restart odoo
```
Kiểm tra trong UI: vào Cấu hình → Subscription & Quotas → tier đã đổi sang Standard/Pro/Unlimited.

Trang Subscription & Quotas (trong app)

Đường dẫn: Cấu hình → Subscription & Quotas. Trang này hiển thị:

Tier hiện tại (Free Forever / Standard / Pro / Unlimited / Managed)
3 thanh tiến độ (KCN / Tenants / Users) — xanh khi dưới 80%, vàng 80-95%, đỏ trên 95%
Số đã dùng / hạn mức cho từng loại
Cảnh báo “Gần đầy” khi vượt 80%
Nút 🔄 Refresh from license — đọc lại key từ odoo.conf (khi vừa dán key mới mà không muốn restart container)
Nút 💼 Upgrade — mở email soạn sẵn tới daibt@bsdinsight.com

Khi vượt hạn mức

Hệ thống chặn mềm — không cho tạo mới, KHÔNG xoá / khoá dữ liệu cũ. Ví dụ thông báo:

Vượt quota Khu công nghiệp: tier hiện tại (Free Forever) cho phép tối đa 1, đang dùng 1. Thêm Khu công nghiệp: liên hệ anh Đại 📞 0918 339 689 hoặc ✉️ daibt@bsdinsight.com.

Vượt quota tenant (hợp đồng): tier hiện tại (Free Forever) cho phép tối đa 10, đang dùng 10. Thêm khách thuê: liên hệ anh Đại…

Vượt quota internal user: tier hiện tại (Free Forever) cho phép tối đa 5, đang dùng 5…

Vẫn làm được khi vượt hạn mức:

Đọc + sửa dữ liệu hiện có (KCN, hợp đồng, user cũ)
Xoá hợp đồng → giải phóng hạn mức → tạo mới
Nâng tier bất cứ lúc nào

Gia hạn — key sắp hết hạn

License key trả phí có claim exp (Unix timestamp). Khi gần hết hạn:

30 ngày trước hạn: Parkone HQ tự gửi email nhắc tới parkone_license_email (đặt khi cài).
Khi hết hạn: tier tự về Free Forever + chatter cảnh báo admin. Dữ liệu nguyên vẹn.
Nâng key mới: anh Đại gửi key gia hạn → dán vào odoo.conf → restart → bấm 🔄 Refresh from license.

Khi nào cần liên hệ anh Đại

Tình huống	Hành động
Sắp đến 10 tenants, cần thêm khách thuê	Email anh Đại sớm để chuẩn bị key Standard
Mở rộng sang KCN thứ 2	Cần tier Standard trở lên (3 KCN)
Cần hơn 5 user nội bộ (sales, FC, IT)	Mở key Standard (20 users)
Khách hỏi báo giá bản trả phí	Anh Đại tư vấn tier + báo giá bespoke
Mất key / key bị lộ	Anh Đại thu hồi + cấp key mới
Khách muốn Parkone host giùm (Managed)	Anh Đại báo giá VPS + phí vận hành riêng

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

Tôi self-host nhưng không có internet được không? Được. License verify hoàn toàn offline — Parkone không call-home. Internet chỉ cần khi pull Docker image lần đầu hoặc gia hạn license.

Đổi tier có mất dữ liệu không? Không bao giờ. Tier chỉ điều khiển hạn mức tạo mới + bật/tắt tính năng Enterprise. Dữ liệu của bạn là của bạn, mãi mãi.

Chạy nhiều instance với 1 key được không? Không. Mỗi key gắn với 1 instance (1 database). Cần nhiều instance → mua nhiều key, hoặc liên hệ anh Đại để bàn license multi-deployment.

Code Enterprise có mã nguồn mở không? Phần Community (~70% module) là AGPL-3, công khai tại github.com/bsdinsight/parkone. Phần Enterprise (Đặt cọc, Phụ lục, GPMB, CPQ Engine) là OPL-1, repo private, chỉ khách trả phí được pull.

Đang dùng Free tier, test thử Enterprise được không? Có sẵn rồi. Free Forever bao gồm đầy đủ tính năng Enterprise trong hạn mức 1 KCN + 10 tenants. Test thoải mái — khi cần scale lên 100+ tenants mới mua key.

Nếu Parkone HQ ngừng hoạt động, tôi mất gì? Bạn vẫn dùng được. Community code AGPL-3 công khai, tự fork maintain được. Enterprise module còn license thì còn dùng — chỉ không có support / cập nhật mới.

Liên hệ

Kênh	Khi nào dùng
✉️ daibt@bsdinsight.com	Mua key, gia hạn, đổi tier
📞 0918 339 689 (anh Đại)	Khẩn cấp, demo, tư vấn kiến trúc
🐛 GitHub Issues	Báo lỗi Community code