Appearance
D3 · Developer / Admin flow — Marketplace & Mini App
💡 Cho cả Admin & Developer
Phần cài Mini App (D3.1, D3.4) ai cũng dùng được. Phần tự xây Mini App (D3.2, D3.3, D3.5) dành cho lập trình viên.
Marketplace là chợ ứng dụng mở rộng (Mini App) cho CNV Work. Workspace cài Mini App từ catalog → tính năng xuất hiện ngay trong sidebar mà không cần code. Developer có thể tự build Mini App (server-driven UI) và publish lên Marketplace.
D3.1 · Admin duyệt catalog & cài Mini App
🟠 Quy tắc nghiệp vụ. Cài Mini App chỉ Admin/Owner thực hiện. Cấp quyền là all-or-nothing — không thể chọn lọc permission. App paid bắt đầu charge sau trial period (nếu có), tự huỷ subscription nếu uninstall trong trial.
D3.2 · Mini App hoạt động (server-driven UI)
🟠 Quy tắc nghiệp vụ. Mini App không chạy code trên client — backend của publisher trả về JSON schema, CNV Hub render bằng widget catalog có sẵn (8 loại). Điều này đảm bảo bảo mật (không inject script vào hub) + cross-platform (chạy được cả mobile native).
D3.3 · Catalog widget được phép
| Widget | Mục đích | Config chính |
|---|---|---|
list | Bảng dữ liệu phân trang | columns, filters, sort, row_action |
form | Form nhập liệu | fields[type, validation, default], submit_action |
chart | Biểu đồ | type (line/bar/pie/area), data_source, x/y axes |
kanban | Board kéo thả | columns, card_template, drag_action |
calendar | Lịch tháng/tuần | event_source, color_by, click_action |
timeline | Dòng thời gian sự kiện | items, group_by |
kpi-card | Thẻ số tổng | label, value, delta, unit |
html-block | HTML readonly (markdown-safe) | content (sanitized) |
🟠 Quy tắc nghiệp vụ. Hub sanitize HTML (cấm
<script>,<iframe>, inline JS). Widget không hỗ trợ tự đăng ký, phải dùng catalog → đảm bảo upgrade hub không break Mini App.
D3.4 · Uninstall Mini App
🟠 Quy tắc nghiệp vụ. Uninstall không tự xoá data Mini App đã tạo trong workspace (vd: deal nó tạo, message nó gửi) — luôn hỏi user. Token & webhook revoke ngay, app server không thể access workspace nữa.
D3.5 · Publish Mini App lên Marketplace (Developer)
🟠 Quy tắc nghiệp vụ. Mini App private (chỉ workspace mình thấy) skip review — dùng API tạo trực tiếp. Public Mini App phải qua review. Revenue share 70/30 (developer/CNV) thanh toán hàng tháng qua bank transfer hoặc Stripe Connect.
D3.6 · Mini App ví dụ có sẵn
| App | Mô tả | Pricing |
|---|---|---|
| Sync Haravan | 2-chiều order/customer giữa CNV CRM và Haravan | Free |
| Misa Accounting Bridge | Đẩy invoice + payment sang Misa SME | 299k/tháng |
| Báo cáo gameSPS | Dashboard hoa hồng theo game vendor | Free |
| NPS Survey | Gửi survey NPS sau khi đóng ticket | Free |
| Slack Notifier | Forward CNV event sang Slack channel | Free |
| Zalo ZNS Templates | Quản lý + gửi ZNS template từ CRM | 99k/tháng |
| e-Invoice MeInvoice | Phát hành HĐĐT từ invoice CNV | 199k/tháng |
🟠 Quy tắc nghiệp vụ. App được verify (badge xanh) đã pass kiểm bảo mật chuyên sâu của CNV. App "Community" tự phát hành, dùng với chú ý. Workspace có thể block app cụ thể không cho cài (Cài đặt → Marketplace → Blocked apps).