Giao diện
@digiforce-nc/plugin-spreadsheet
Plugin bảng tính Excel-like — hiển thị và chỉnh sửa dữ liệu dưới dạng bảng tính giống Excel/Google Sheets, hỗ trợ chia sẻ qua URL công khai.
Plugin này làm gì?
Plugin cung cấp Spreadsheet Block nhúng trong trang và Spreadsheet Page riêng biệt với giao diện bảng tính đầy đủ: chỉnh sửa trực tiếp ô, copy-paste từ Excel, hệ thống plugin mở rộng, và chia sẻ qua URL.
Tính năng chính
| # | Tính năng | Mô tả |
|---|---|---|
| 1 | Spreadsheet Block | Nhúng bảng tính trong page layout |
| 2 | Spreadsheet Page | Trang riêng biệt (/spreadsheet/:id) |
| 3 | Inline editing | Click đúp ô để sửa trực tiếp |
| 4 | Copy/Paste | Hỗ trợ paste từ Excel/Google Sheets |
| 5 | Chia sẻ | Share qua URL (private / public view / public edit) |
| 6 | Plugin system | Hệ thống plugin mở rộng (VD: dgRecords — kết nối Collection) |
| 7 | Auto-save | Thay đổi lưu trực tiếp, không cần nút Save |
Database
Bảng spreadsheet
| Field | Kiểu | Mô tả |
|---|---|---|
id | uid (PK) | ID duy nhất |
name | string | Tên spreadsheet |
description | text | Mô tả |
content | jsonb | Nội dung bảng tính (cells, format, formulas) |
shareMode | string | Chế độ chia sẻ (private/public) |
shareToken | string | Token chia sẻ |
permission | array | Danh sách quyền |
version | integer | Phiên bản (optimistic locking) |
createdBy / updatedBy | — | Người tạo / cập nhật |
API endpoints
| Endpoint | Quyền | Mô tả |
|---|---|---|
spreadsheet:* | Admin (snippet ui.spreadsheet) | CRUD spreadsheet |
spreadsheet:getData | Đã đăng nhập | Lấy nội dung dạng HTML (cho embed/iframe) |
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/client | Client UI framework |
@digiforce-nc/server | Server framework |
@digiforce-nc/spreadsheet (1.0.7) | Spreadsheet engine |
@odoo/owl (2.5.1) | UI framework cho spreadsheet engine |