Giao diện
@digiforce-nc/plugin-charts
Plugin biểu đồ cơ bản (deprecated) — tạo biểu đồ đơn giản từ dữ liệu collection. Đã thay thế bởi plugin-data-visualization và plugin-data-visualization-pro.
Plugin này làm gì?
Lưu ý: Plugin này đã deprecated. Với dự án mới, hãy sử dụng
@digiforce-nc/plugin-data-visualizationhoặc@digiforce-nc/plugin-data-visualization-pro.
Plugin cung cấp khả năng tạo biểu đồ cơ bản (bar, line, pie) từ dữ liệu collection. Admin chọn collection, field aggregation, và loại chart — plugin tự query dữ liệu và render biểu đồ.
Cơ chế hoạt động
Tính năng chính
| # | Tính năng | Mô tả |
|---|---|---|
| 1 | Chart types | Bar, Line, Pie, Area (cơ bản) |
| 2 | Aggregation | COUNT, SUM, AVG, MIN, MAX |
| 3 | Dimension | Group by field (date, category) |
| 4 | Filter | Lọc dữ liệu trước khi aggregate |
| 5 | Auto-refresh | Tự cập nhật theo chu kỳ |
API endpoints
| Endpoint | Mô tả |
|---|---|
charts CRUD | Tạo, sửa, xóa chart |
charts:query | Query dữ liệu cho chart |
Database
| Bảng | Mô tả |
|---|---|
charts | Cấu hình chart (type, collection, measure, dimension, filter) |
Thành phần client
| Thành phần | Mô tả |
|---|---|
ChartBlock | Block hiển thị chart trong page layout |
ChartConfig | Form cấu hình chart |
ChartRenderer | Render biểu đồ (G2/AntV) |
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/server | Server framework |
@digiforce-nc/database | Database ORM — aggregation query |
@digiforce-nc/client | Client UI framework |
@ant-design/charts | Chart rendering library |
Migration sang data-visualization
Nếu đang dùng plugin-charts, nên chuyển sang plugin-data-visualization:
| plugin-charts | plugin-data-visualization |
|---|---|
| Chart types cơ bản | Nhiều chart types hơn |
| Không có dashboard | Dashboard kéo-thả |
| Aggregation đơn giản | Query builder nâng cao |
| Không export | Export PDF/PNG |