🧭 Tổng quan dành cho Developer
Xbook là nền tảng quản trị doanh nghiệp được xây dựng trên kiến trúc ERP mô-đun (Python + PostgreSQL, giao diện web). Mỗi nghiệp vụ là một phân hệ (addon) độc lập, có thể bật/tắt và mở rộng.
🏗️ Kiến trúc tổng thể
| Lớp | Vai trò |
|---|---|
| Phân hệ (addons) | Mỗi addon định nghĩa model dữ liệu, business logic, view và quyền truy cập. |
| ORM | Truy xuất dữ liệu qua model thay vì SQL trực tiếp; mọi API đều đi qua ORM. |
| Web / RPC | Giao diện web và các điểm tích hợp (REST/JSON-RPC) dùng chung tầng dịch vụ. |
| PostgreSQL | Cơ sở dữ liệu chính. |
🔌 Các cách tích hợp với Xbook
- REST / JSON-RPC API — đọc/ghi dữ liệu từ hệ thống ngoài. Xem Xác thực và REST API.
- Webhook — nhận sự kiện realtime khi dữ liệu thay đổi. Xem Webhook.
- Addon tùy biến — thêm nghiệp vụ riêng ngay trong nền tảng. Xem Viết addon.
- Tích hợp sẵn — Zalo ZNS, cổng thanh toán (VietQR/VNPay), n8n, MCP… Xem Tích hợp.
✅ Yêu cầu trước khi bắt đầu
- Tài khoản có quyền Developer / API trên một database Xbook.
- Biết cơ bản về HTTP, JSON và một ngôn ngữ gọi API (Python, JavaScript…).
👉 Bắt đầu nhanh trong 5 phút tại Quickstart.