Fastie WebApp
Ứng dụng khách hàng trên web. Quản lý doanh thu và giao dịch, sổ doanh thu, tóm tắt thuế, hóa đơn, gói dịch vụ, analytics và kết nối backend. React + TypeScript + Vite.
Các bề mặt sản phẩm
Sản phẩm Fastie
Các sản phẩm phục vụ hộ kinh doanh, đội ngũ vận hành và đối tác.
Fastie Mini App
Ứng dụng chạy trong Zalo, dùng ZMP SDK/UI. Có cấu trúc app, trang tính năng, dịch vụ API và state riêng; là kênh giảm bước cài app cho chủ hộ.
Fastie Admin
Ứng dụng back-office cho đội nội bộ: quản trị user/organization, giao dịch và module vận hành theo quyền. React + TypeScript + Vite.
Affiliate portal
Portal phục vụ đăng ký, theo dõi và quản lý hoạt động giới thiệu/hoa hồng affiliate; có frontend riêng và dùng API backend.
Fastie Agent · Zalo OA
Dịch vụ chatbot/RAG cho Zalo OA. Node/Express, Google Gemini, LangChain và pgvector hỗ trợ hỏi đáp và quy trình báo cáo trên Zalo OA.
Fastie Landing
Website giới thiệu, SEO và nội dung sản phẩm, build bằng React/Vite; được đóng gói thành static assets và phục vụ qua Nginx.
Fastie Backend
API và domain services. Cấu trúc module cho organization/user, doanh thu/tài chính, sổ, thuế, hóa đơn, subscriptions, integrations, sales team, receivables, affiliate, notification, storage và hơn thế.
Hermes Supervisor
Dịch vụ Python nội bộ cho các job read-only health/revenue/reconciliation/events, lịch sử job và cảnh báo hạ tầng deduplicate. Chạy như service nội bộ trên production VPS, không mở port ra host.
Luồng hệ thống khái quát
Từ điểm chạm tới dịch vụ dữ liệu
Sơ đồ dưới đây thể hiện các lớp chính của sản phẩm và hạ tầng Fastie.
Chủ hộ / kế toánWebApp · Mini App · Zalo OA
FrontendReact/Vite · Nginx
Backend APINestJS · business rules
Data & jobsPostgreSQL · Redis/BullMQ
Dịch vụ ngoàiZalo · ngân hàng · Shopee · e-invoice
Đội vận hành sử dụng
Admin portal, affiliate portal, Google Sheets/Zalo cho quy trình nội bộ và các công cụ kiểm tra/giám sát. Quyền production cấp theo nhiệm vụ.
Nhánh AI và giám sát
Agent phục vụ một số luồng hỏi đáp; Hermes gọi boundary được bảo vệ ở backend cho job read-only. Supervisor không được thiết kế để truy cập trực tiếp PostgreSQL/Redis.
Nền tảng công nghệ
Stack theo từng phần, không phải một framework duy nhất
API & dữ liệu
Node.jsTypeScriptNestJS 11TypeORMPostgreSQL 15Redis 7BullMQ
Backend dùng NestJS/Express adapter, TypeORM migrations, queue, scheduled jobs và PostgreSQL; Redis làm queue/cache.
Web clients
ReactTypeScriptViteReact RouterTailwind CSSJotai/Zustand
WebApp, Admin, Affiliate, Landing có package/version khác nhau; analytics trong WebApp có hướng dẫn consent và tránh gửi PII.
Zalo Mini App
React 18ZMP SDKZaUIViteJotai
Build và publish theo Zalo Mini App tooling/CLI; phụ thuộc quyền và cấu hình ứng dụng Zalo.
AI/agent & supervisor
ExpressGoogle GeminiLangChainpgvectorPython 3.12SQLite ledger
Agent lưu vector/search theo Postgres/pgvector; Hermes Supervisor độc lập là service Python, SQLite cho ledger công việc/cảnh báo.
Build & serving
DockerDocker ComposeNginxNode 20Linux containers
Frontend thường build thành static bundle rồi Nginx serve; API và worker chạy trong container. Env Vite có thể được nhúng ở thời điểm build.
Integrations thể hiện trong code
ZaloSePay / CASFPT eInvoiceShopeeTikTokWebhooks
Có code client/module cho các tích hợp này. Điều đó không bảo đảm từng kết nối đã được bật hoặc cấp cho mọi khách.
Infrastructure theo cấu hình hiện có
Compose tách production và staging
Production và staging chạy tách biệt bằng Docker Compose. Backend API kết nối PostgreSQL 15 và Redis 7; Admin, Affiliate và các service nội bộ nằm trên network được phân quyền. Hermes Supervisor chạy private trong production VPS.
Các lớp được nhìn thấy
- Frontend static được build thành image Nginx.
- API chạy container riêng, nối PostgreSQL và Redis trong Docker network.
- Volumes cho dữ liệu Postgres/Redis, uploads và logs.
- Cấu hình env theo từng deployment; không đưa secret vào trang training.
- Staging có database, cache, network, host port và file env riêng.
- Hermes là private internal service; có Docker/read-only boundary và host watchdog được ghi trong docs.
Điều đội mới cần hiểu
- Không sửa production data/config khi chưa được cấp nhiệm vụ và review.
- Vite `VITE_*` thường là build-time config; đổi env container sau build có thể không đổi bundle.
- Không ghi token, dữ liệu cá nhân hoặc số liệu tài chính thật vào analytics/logs.
- Yêu cầu deploy, migration, quyền server và credentials chuyển qua Tech owner.