babyvibe

deplao-builder

# Deplao <p> <strong>🌐 Language:</strong> &nbsp;🇻🇳 <strong>Tiếng Việt</strong> &nbsp;|&nbsp; 🇬🇧 <a href="./README.en.md">English</a> </p> *Giới thiệu*: https://babyvibe.github.io/deplao-builder/ --- > Phần mềm desktop quản lý Zalo Đa tài khoản tích hợp CRM, ERP, POS, Workflow và AI Assistant giúp đội nhóm bán hàng, chăm sóc khách hàng và marketing trên Zalo vận hành tập trung trong một ứng dụng duy nhất. [](#) [](#-runtime-requirements) [](#) [](#) [](#) [](#) [](#) [](#) [](#) [](https://github.com/babyvibe/deplao-builder/issues) ## ⬇️ Tải xuống <table> <tr> <td align="center" width="33%"> <a href="https://github.com/babyvibe/deplao-builder/releases/latest/download/Deplao-Setup-26.4.8.exe"> <img src="https://img.shields.io/badge/🪟_Windows-v26.4.8-0078d4?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows" /> </a> <br> _{Deplao-Setup-26.4.8.exe} </td> <td align="center" width="33%"> <a href="https://github.com/babyvibe/deplao-builder/releases/latest/download/Deplao-26.4.8-arm64.dmg"> <img src="https://img.shields.io/badge/🍎_macOS_M1+-v26.4.8-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Apple Silicon" /> </a> <br> _{Deplao-26.4.8-arm64.dmg} </td> <td align="center" width="33%"> <a href="https://github.com/babyvibe/deplao-builder/releases/latest/download/Deplao-26.4.8.dmg"> <img src="https://img.shields.io/badge/🍎_macOS_Intel-v26.4.8-333333?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Intel" /> </a> <br> _{Deplao-26.4.8.dmg} </td> </tr> </table> <p align="center"> 👉 <strong><a href="https://github.com/babyvibe/deplao-builder/releases">Xem tất cả phiên bản</a></strong> </p> <details> <summary>⚠️ Lưu ý khi mở file cài đặt (bị chặn bởi Windows / macOS)</summary> Do Deplao chưa được ký chứng chỉ (code signing) - nói thẳng ra là nghèo, nên hệ điều hành có thể hiển thị cảnh báo khi mở file. Bạn có thể làm theo hướng dẫn dưới đây: --- ### 🪟 Windows (.exe) Khi mở file `.exe`, Windows có thể hiển thị cảnh báo **"Windows protected your PC"**: 👉 Cách xử lý: 1. Nhấn **More info** 2. Chọn **Run anyway** --- ### 🍎 macOS (.dmg) Khi mở file `.dmg`, macOS có thể báo **"cannot be opened because it is from an unidentified developer"** 👉 Cách xử lý: **Cách 1:** - Chuột phải vào file → chọn **Open** - Nhấn **Open** lần nữa **Cách 2 (nếu vẫn bị chặn):** 1. Vào **System Settings → Privacy & Security** 2. Kéo xuống phần Security 3. Nhấn **Open Anyway** </details> <p align="center"> <img src="./assets/deplao-overview-map.svg" alt="Sơ đồ trực quan mô tả Deplao là workspace desktop tập trung cho bán hàng và chăm sóc khách hàng trên Zalo" width="960" /> </p> ## 🛠️ Công nghệ & ngôn ngữ sử dụng Deplao hiện được xây dựng trên các công nghệ chính sau: - **Thư viện:** zca-js - https://github.com/RFS-ADRENO/zca-js - **Ngôn ngữ:** TypeScript, JavaScript, SQL, HTML, CSS - **Ứng dụng desktop:** Electron, React, Vite - **Giao diện:** Tailwind CSS, PostCSS, React Router - **Lưu trữ dữ liệu cục bộ:** SQLite qua `better-sqlite3` - **State & UI chuyên biệt:** Zustand, React Flow, Recharts, Quill - **Backend dịch vụ:** Node.js + Express - **Tích hợp & automation:** Axios, Google APIs / Google Sheets, node-cron, Discord.js, Telegram Bot API, OpenAI API, v.v. --- ## Cài đặt <details open> <summary>🛠️ Tự build từ source</summary> ### Yêu cầu - Windows 10/11 hoặc macOS - Node.js 18+ khuyến nghị - npm 9+ ### Cài đặt ```powershell npm install --legacy-peer-deps ``` ### Chạy development ```powershell npm run dev ``` ### Build app ```powershell npm run production ``` ### Dữ liệu cục bộ - Dữ liệu app dùng SQLite cục bộ - Có thể đổi thư mục lưu trữ trong phần `Cài đặt` </details> ## 🗺️ Sơ đồ kiến trúc & luồng hoạt động --- ### 1️⃣ Luồng Build ```mermaid flowchart LR subgraph SRC["📁 Source Code"] E("⚡ electron/\n*.ts") S("🔧 services/\n*.ts") R("🎨 src/ui/\n*.tsx") end subgraph COMPILE["🔨 Compile"] TSC("tsc\ntsconfig.electron") VITE("vite build\n+ Tailwind CSS") end subgraph OUT["📦 Output"] DE("dist-electron/\nmain · services · ipc") D("dist/\nindex.html · assets") end subgraph PKG["🚀 Đóng gói"] EB(("electron\nbuilder")) WIN("🪟 Windows\n.exe / dir") MAC("🍎 macOS\n.dmg arm64 + x64") end E & S --> TSC --> DE R --> VITE --> D DE & D --> EB --> WIN & MAC ``` --- ### 2️⃣ Kiến trúc Runtime ```mermaid mindmap root((🖥️ Deplao)) ⚙️ Main Process 📡 IPC Handlers login · zalo · crm workflow · erp · sync facebook · relay · file 🔧 Services DatabaseService WorkspaceManager WorkflowEngine CRMQueueService HttpConnectionManager FileStorageService AIAssistantService 🎨 Renderer ⚛️ React Pages Dashboard Chat & Inbox CRM & Campaign Workflow Editor POS & Tích hợp ERP · Settings 🗃️ Zustand State accountStore chatStore workspaceStore employeeStore 📱 Giao thức Zalo zca-js QR Login Cookie Session WebSocket realtime 🌐 External APIs OpenAI · Google Sheets Telegram · Discord KiotViet · Haravan · Sapo GHN · GHTK ``` --- ### 3️⃣ Mô hình Boss ↔ Nhân viên ```mermaid flowchart TB subgraph BOSS["🖥️ Máy BOSS — Local Workspace"] BZ("📱 Zalo / FB\nAccounts") BSV("🔧 Services\nCRM · ERP · AI · Workflow") BSD[("🗄️ SQLite DB\n+ Media Files")] BRL("🔁 Relay Server\nExpress + WebSocket :9900") end subgraph NET["🌐 Kết nối"] LAN("🏠 LAN\n192.168.x.x:9900") WAN("🌍 Tunnel / VPN\ntruy cập từ xa") end subgraph EMP["💻 Nhân Viên — Remote Workspace"] EA("📲 Deplao App\nEmployee Mode") EP("🔐 Permission Filter\nerp · crm · workflow · ...") EU("👁️ UI\nchỉ thấy TK được gán") end BZ --> BSV BSV <--> BSD BSV --> BRL BRL <-->|HTTP + WS| LAN & WAN LAN <-->|IPC relay| EA WAN <-->|IPC relay| EA EA --> EP --> EU EP -.->|forward request| BRL ``` > Nhân viên vẫn có **workspace riêng** (DB, media) trên máy. Do Zalo chỉ cho phép 1 kết nối cùng lúc, mọi request Zalo được **relay về Boss** để xử lý theo quyền đã cấp. --- ### 4️⃣ Đa tài khoản & Lưu trữ ```mermaid flowchart LR subgraph ACCS["👤 Tài khoản"] Z1("Zalo #1\nzca-js") Z2("Zalo #2\nzca-js") ZN("Zalo #N\nzca-js") FB("Facebook\nGraph API") end subgraph STORE["💾 Lưu trữ cục bộ"] DB[("🗄️ SQLite\ndeplao-tool.db\nmessages · contacts\ncrm · workflow · erp")] MED("📁 FileStorage\n~/media/\nảnh · video · file") ES("🔑 electron-store\ncookies · tokens\nsettings") end subgraph WS["🗂️ Workspace Manager"] WA("🏠 Local WS\nDefault") WB("🌐 Remote WS\nBoss") WC("⚙️ Custom WS\npath tuỳ chỉnh") end Z1 & Z2 & ZN & FB -->|"tin nhắn · danh bạ"| DB Z1 & Z2 & ZN & FB -->|"ảnh · video · file"| MED ES -->|"cookie session"| Z1 & Z2 & ZN DB & ES <-->|"path resolve\nswitch workspace"| WS WA & WB & WC -.-|"mỗi WS = DB riêng"| DB ``` > Mỗi **Workspace** có DB + media folder độc lập — đổi hoặc di chuyển sang ổ đĩa khác không mất dữ liệu. --- ## 🚀 Deplao là gì? Nếu nhìn nhanh, có thể hiểu Deplao là: - **trung tâm vận hành Zalo**: nhiều tài khoản, inbox tập trung, trả lời nhanh - **lớp quản lý khách hàng**: CRM, nhãn, lịch sử tương tác, campaign - **lớp tự động hóa**: workflow, AI, trigger và action chạy nền - **lớp kết nối kinh doanh**: POS, vận chuyển, API và công cụ ngoài - **lớp quản trị nội bộ**: báo cáo, ERP, phân quyền, workspace nhân viên ## ✨ Điểm nổi bật - 👤 **Đa tài khoản Zalo** — đăng nhập không giới hạn tài khoản, chuyển đổi qua lại nhanh - 💬 **Hộp thư tập trung** — chế độ gộp tài khoản giúp gom và xử lý hội thoại từ nhiều tài khoản trong một giao diện duy nhất - 👥 **CRM & Campaign** — quản lý liên hệ, nhãn, ghi chú nội bộ, chăm sóc khách cũ. Quét thành viên nhóm ẩn, nhóm chưa tham gia để tìm khách mới. - ⚙️ **Workflow tự động hóa** — kéo-thả Trigger → Node → Action hoặc dùng AI tạo quy trình, chạy nền 24/7 không cần code - 🤖 **AI Assistant** — hỗ trợ gợi ý câu trả lời, chat trực tiếp trong hội thoại. Còn giúp phân loại tin nhắn, trả lời khách hàng 24/7. - 🔗 **Tích hợp ngoài** — POS, vận chuyển, thanh toán, Google Sheets, Telegram, Discord, Email, HTTP Request... Kết hợp sử dụng khi chat hoặc workflow - 📈 **Báo cáo & phân tích** — theo dõi tin nhắn, liên hệ, nhãn, nhân viên, chiến dịch, workflow, AI. - 🗂️ **ERP nội bộ** — task, lịch làm việc, notes và phối hợp vận hành nội bộ ngay trong cùng hệ thống - 🧑‍💼 **Workspace boss ↔ nhân viên** — kết nối qua **LAN hoặc WAN** (Cloudflare Tunnel), phân quyền chi tiết và theo dõi hiệu suất từng nhân viên - 🔒 **Proxy per-account** — gán Proxy riêng cho từng tài khoản Zalo trước khi đăng nhập - 🔐 **Dữ liệu lưu cục bộ** — ưu tiên quyền kiểm soát dữ liệu và bảo mật trên máy người dùng ### Xem nhanh giao diện Deplao Các màn hình dưới đây được sắp theo luồng sử dụng thực tế: từ dashboard → chat → CRM → workflow → POS / báo cáo / ERP. <table> <tr> <td> <img src="./assets/dashboard.png" alt="Dashboard quản lý đa tài khoản Zalo trong Deplao" width="360" /> <br /> _{<strong>Dashboard đa tài khoản</strong>} </td> <td> <img src="./assets/chat.png" alt="Giao diện chat tập trung trong Deplao" width="360" /> <br /> _{<strong>Chat tập trung tích hợp AI gợi ý trả lời</strong>} </td> <td> <img src="./assets/crm.png" alt="Màn hình CRM và quản lý liên hệ trong Deplao" width="360" /> <br /> _{<strong>CRM & liên hệ</strong>} </td> </tr> <tr> <td> <img src="./assets/scan-members-group.png" alt="Quét thành viên nhóm Zalo trong Deplao" width="360" /> <br /> _{<strong>Quét thành viên nhóm</strong>} </td> <td> <img src="./assets/campaign.png" alt="Chiến dịch gửi tin hàng loạt trong Deplao" width="360" /> <br /> _{<strong>Chiến dịch gửi tin hàng loạt</strong>} </td> <td> <img src="./assets/workflow.png" alt="Trình thiết kế workflow kéo thả trong Deplao" width="360" /> <br /> _{<strong>Workflow editor</strong>} </td> </tr> <tr> <td> <img src="./assets/detail-workflow.png" alt="Chi tiết cấu hình workflow trong Deplao" width="360" /> <br /> _{<strong>Chi tiết workflow</strong>} </td> <td> <img src="./assets/workflow-ai.png" alt="Workflow kết hợp AI trong Deplao" width="360" /> <br /> _{<strong>Ra lệnh tạo Workflow bằng AI</strong>} </td> <td> <img src="./assets/pos.png" alt="Tích hợp POS và bán hàng trong Deplao" width="360" /> <br /> _{<strong>Tích hợp POS, VC, Thanh toán</strong>} </td> </tr> <tr> <td> <img src="./assets/report.jpg" alt="Báo cáo và phân tích hiệu suất trong Deplao" width="360" /> <br /> _{<strong>Báo cáo & phân tích</strong>} </td> <td> <img src="./assets/report-employee.png" alt="Báo cáo hiệu suất nhân viên trong Deplao" width="360" /> <br /> _{<strong>Báo cáo nhân viên</strong>} </td> <td> <img src="./assets/erp.png" alt="ERP nội bộ và phối hợp vận hành trong Deplao" width="360" /> <br /> _{<strong>ERP nội bộ</strong>} </td> </tr> </table> ## 🎯 Phù hợp với ai? Deplao phù hợp cho: - shop online và đội ngũ chốt đơn qua Zalo - doanh nghiệp SME cần nhiều nhân viên xử lý inbox cùng lúc - marketing agency hoặc freelancer quản lý nhiều tài khoản khách hàng - spa, phòng khám, giáo dục, F&B và các mô hình cần chăm sóc khách hàng định kỳ - đội nhóm muốn kết hợp chat, CRM, workflow, AI và ERP trong một desktop app duy nhất ## 🧩 Các nhóm tính năng chính ### 1) Quản lý đa tài khoản & inbox tập trung - đăng nhập nhiều tài khoản Zalo bằng QR Code - dashboard quản lý tài khoản trực quan - gộp nhiều tài khoản vào một inbox hợp nhất - tìm kiếm theo tên, biệt danh, số điện thoại - lọc nhanh theo chưa đọc, chưa trả lời, nhãn và trạng thái hội thoại - **proxy per-account**: gán Proxy riêng cho từng tài khoản Zalo ### 2) Chat đầy đủ tính năng - gửi tin nhắn văn bản, ảnh, video, file - emoji, sticker, reply, tag thành viên - poll, ghi chú nhóm, nhắc nhở, gửi danh thiếp - quick messages để lưu mẫu tin và gọi nhanh bằng từ khóa - ghim tin nhắn không giới hạn, quản lý media và file đính kèm ### 3) CRM & chăm sóc khách hàng - đồng bộ bạn bè, thành viên nhóm và hồ sơ liên hệ - lưu số điện thoại, giới tính, ngày sinh, ghi chú nội bộ - tạo và quản lý nhãn Zalo hai chiều - lọc liên hệ theo nhiều tiêu chí để chăm sóc đúng nhóm khách hàng - tạo campaign gửi tin, kết bạn, mời vào nhóm với tiến độ realtime ### 4) Workflow tự động hóa - workflow kéo-thả không cần code - tích hợp trợ lý AI hỗ trợ tạo node chỉ bằng vài dòng prompt không cần kéo-thả - hỗ trợ trigger từ tin nhắn, nhãn, react, lịch cron, sự kiện nhóm... - action gửi tin, gửi ảnh/file, tìm user, quản lý nhóm, mute, forward, recall... - tích hợp logic, Google Sheets, AI, Telegram, Discord, Email, Notion và HTTP Request - có lịch sử chạy để kiểm tra và debug dễ dàng ### 5) Tích hợp phục vụ bán hàng - POS: KiotViet, Haravan, Sapo, Nhanh.vn, Pancake POS - vận chuyển: GHN, GHTK - AI Assistant dùng để gợi ý câu trả lời, chat nhanh trực tiếp khi trò chuyện hoặc workflow - dễ kết hợp thành quy trình bán hàng và chăm sóc khách hàng khép kín ### 6) Báo cáo, ERP và nhân viên - báo cáo tin nhắn, liên hệ, chiến dịch, workflow, AI, nhân viên - ERP nội bộ gồm Task, Calendar, Notes - mô hình boss ↔ nhân viên và phân quyền module - hỗ trợ theo dõi hiệu suất làm việc theo từng người và từng giai đoạn ## 🔒 Bảo mật & dữ liệu Deplao ưu tiên kiến trúc chạy cục bộ trên máy người dùng: - tất cả dữ liệu tin nhắn, danh bạ, CRM, cài đặt và media được lưu trên máy - đăng nhập bằng QR Code, không yêu cầu lưu mật khẩu Zalo, Cookie được mã hóa lưu trên máy - người dùng có thể đổi thư mục lưu trữ dữ liệu sang ổ đĩa khác khi cần - phù hợp với đội nhóm muốn kiểm soát dữ liệu nội bộ chặt chẽ hơn ## 💻 Yêu cầu vận hành - kết nối Internet 24/7 ổn định để đồng bộ hội thoại và automation - nên để app hoạt động liên tục nếu dùng workflow hoặc vận hành đội nhóm --------------------------------------------------------------------------------------------------------------------------------------------- ## 📣 Liên hệ - Báo lỗi, góp ý hoặc cần hỗ trợ: 👉 [Tạo issue tại đây](https://github.com/babyvibe/deplao-builder/issues) ## 🙏 Lời cảm ơn Deplao xin gửi lời cảm ơn đến dự án: 👉 https://github.com/RFS-ADRENO/zca-js Nhờ những đóng góp và nền tảng từ dự án này, Deplao mới có thể được hoàn thiện và ra mắt như ngày hôm nay. Rất trân trọng những giá trị mà cộng đồng open-source mang lại 💙 ---