Flexbiz-server

Thư viện nền tảng cho hệ thống Flexbiz ERP — nhân mã nguồn mở + hệ sinh thái gói mở rộng.

flexbiz-server là gói điểm vào (meta): cài nó là có ngay nhân ERP (flexbiz-server-core) và engine Workflow (flexbiz-server-flow), đồng thời giữ tương thích 100% với code cũ dùng layout require('flexbiz-server/server/...'). Các tính năng nâng cao (AI Agent, Marketing đa kênh, đóng gói module người dùng) cần gói thương mại cài thêm khi cần.

Flexbiz ERP bao trùm đầy đủ nghiệp vụ: CRM, bán hàng, mua hàng, kho, sản xuất, kế toán tài chính, nhân sự, quản trị — và khác biệt cốt lõi là tích hợp sẵn Workflow tự động hoá + AI Agent điều hành.

Cài đặt

npm i flexbiz-server        # -> tự kéo theo flexbiz-server-core + flexbiz-server-flow (đều MIT, public)

const express = require('express');
const Server = require('flexbiz-server/server/app');   // hoặc: require('flexbiz-server-core')
const app = express();
Server(app, { configs, port, useSocket: true });

Yêu cầu hạ tầng: Node.js ≥ 22, MongoDB (Replica Set), Redis.

Bản đồ gói & giấy phép

| Gói | License | Registry / Link | Vai trò | |---|---|---|---| | flexbiz-server | MIT | npm (public) | Gói điểm vào + tương thích ngược (re-export core theo layout cũ). | | flexbiz-server-core | MIT | npm (public) | Nhân ERP: model/controller CRUD, kế toán/kho/công nợ/thuế, báo cáo, quản trị công ty, plugin host + auto-loader. | | flexbiz-server-flow | MIT | npm (public) | Workflow engine + node built-in. Là dependency của core → tự cài & tự bật. | | @pvtruong/server-agent | Commercial | GitHub Packages (private) | AI Agent điều hành + node AI trong workflow. | | @pvtruong/server-marketing | Commercial | GitHub Packages (private) | Marketing / Đa kênh: hộp thư tập trung, quảng cáo (Ads), hiệu quả bài post, kết nối Facebook. | | @pvtruong/server-usermodule | Commercial | GitHub Packages (private) | Đóng gói & quản lý module người dùng: cài/gỡ, chèn menu, nhân bản mẫu theo công ty. |

Gói công khai trên npm: flexbiz-server · flexbiz-server-core · flexbiz-server-flow. Gói thương mại (@pvtruong/*) phát hành private trên GitHub Packages — cần giấy phép để truy cập.

Tính năng: MIT (có sẵn) vs cần gói THƯƠNG MẠI

✅ Có sẵn khi cài flexbiz-server (MIT — không cần gì thêm)

• Toàn bộ module ERP (flexbiz-server-core): Bảng điều khiển, CRM, Bán hàng, Mua hàng, Nhà phân phối, Quản lý kho, Sản xuất, Kế toán tài chính, Quản lý nhân sự, Quản trị hệ thống — có phân quyền chi tiết.
• Workflow engine + node built-in (flexbiz-server-flow): Lịch chạy, Webhook, Switch, Chống trùng lặp (Idempotency), Xử lý dữ liệu (JS sandbox), For Each, Gửi Email, Gửi thông báo, Http Request, Chứng từ/Danh mục, Báo cáo, Nhập liệu (User Form), Debug, Lưu trữ.

🔒 Cần cài thêm gói THƯƠNG MẠI

| Tính năng | Gói cần cài | Ghi chú | |---|---|---| | AI Agent điều hành (phân tích tài chính/kho/công nợ tức thời, hành động trên hệ thống, quản trị PDCA/OKR/KPI, hỏi đáp RAG) và node "AI Agent" (aianalysis) trong Workflow | @pvtruong/server-agent | Node AI trong flow chỉ chạy khi có gói này; chưa cài sẽ báo lỗi rõ khi node chạy. | | Marketing / Đa kênh: hộp thư đa kênh tập trung (Facebook/Zalo/Website) & node channelsendmessage; đồng bộ Quảng cáo (Ads → CPL/CPA/ROAS) & node adssync; hiệu quả bài post Facebook & node facebookpostinsights; toàn bộ node Facebook/Zalo trong Workflow (facebook webhook, facebooksendmessage, facebookconversations, facebookcreatepost, zalosendmessage); trợ lý kết nối Facebook (OAuth/webhook); module Marketing | @pvtruong/server-marketing | | | Đóng gói & quản lý User Module: cài/gỡ module người dùng qua UI, bật/tắt menu, nhân bản mẫu (flow/seed/report) theo công ty, khu vực tài liệu API | @pvtruong/server-usermodule | Cơ chế nạp module vẫn có ở core; gói này thêm giao diện quản trị. |

Node Workflow thuộc gói nào

| Nhóm node | Node | Gói cung cấp | |---|---|---| | Input / Logic / Function / Output / Company (built-in) | inject, webhook, switch, checkaction (chống trùng), function, foreachitem, delay, email, pushnotification, savedata, debug, httprequest, data, event, report, userform, aggregate, merge, trycatch, exportinvoice, customer | flexbiz-server-flow (MIT, có sẵn) | | AI | aianalysis | @pvtruong/server-agent (Commercial) | | Đa kênh / Facebook / Zalo / Quảng cáo | channelsendmessage, adssync, facebookpostinsights, facebook (webhook), facebooksendmessage, facebookconversations, facebookcreatepost, zalosendmessage | @pvtruong/server-marketing (Commercial) |

Kiến trúc auto-discovery: cứ cài thêm gói là tính năng tương ứng tự bật khi khởi động lại, không cần sửa cấu hình. Với Workflow, node của gói mới tự xuất hiện ở danh sách node (GET /api/flow/nodes) và cho AI agent tool. Node của gói CHƯA cài bị ẩn khỏi danh sách; nếu flow cũ vẫn gọi tới, node đó báo lỗi rõ NODE_DEP_MISSING (các flow khác vẫn chạy bình thường).

Cài gói thương mại

Gói thương mại phát hành trên GitHub Packages (private). Thêm .npmrc:

@pvtruong:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

npm i @pvtruong/server-agent @pvtruong/server-marketing @pvtruong/server-usermodule

(Hoặc cài offline từ source/tarball nếu được cấp — xem docs/DISTRIBUTE-SOURCE.md.)

Tương thích ngược (code cũ)

Gói flexbiz-server mirror toàn bộ core theo layout cũ flexbiz-server/server/... (1000+ file re-export), nên service & bản override cũ chạy KHÔNG cần sửa code:

const Server     = require('flexbiz-server/server/app');
const controller = require('flexbiz-server/server/controllers/controller');
const utils      = require('flexbiz-server/server/libs/utils');

Override endpoint gốc qua configs.paths.modules vẫn hoạt động như trước.

Giấy phép

Hệ thống dùng giấy phép theo từng gói:

• flexbiz-server, flexbiz-server-core, flexbiz-server-flow — MIT. Tự do dùng, sửa, phân phối; xây dựng & kinh doanh sản phẩm trên nền tảng này thoải mái.
• @pvtruong/server-agent, @pvtruong/server-marketing, @pvtruong/server-usermodule — FlexBiz Commercial License. Copyright © FlexBiz. All rights reserved. Cần giấy phép hợp lệ để sử dụng; không phân phối lại, không đảo ngược mã nguồn. Xem file LICENSE trong từng gói.

Liên hệ giấy phép thương mại & hỗ trợ: qua GitHub @pvtruong (hoặc trang npm của gói). Mã nguồn gói thương mại để private vì lý do bản quyền.