System Analysis: ACAP Platform

Tổng quan

ACAP Platform (Autonomous Chat Agent Platform) là một hệ thống chatbot tự động hóa đa kênh. Nền tảng này sử dụng LLM để quản lý các kịch bản tương tác, quản lý tri thức, tự động phân tích độ hài lòng, và chuyển qua tổng đài viên (escalation) trong trường hợp khẩn cấp.

1. Công Nghệ Sử Dụng (Tech Stack)

Hệ thống được thiết kế theo mô hình Monorepo (Client & Server nằm chung).

• Frontend:

  • React 19, Vite
  • Tailwind CSS v4, Radix UI (shadcn/ui), Framer Motion
  • React Hook Form, Zod (Form Validation)
  • @tanstack/react-query & @trpc/react-query (State & Data Fetching)
  • wouter (Routing)

• Backend:

  • Node.js, Express
  • tRPC (Typesafe API)
  • Drizzle ORM (Quản lý Database MySQL)
  • AWS SDK (Lưu trữ S3)
  • LLM Integration (invokeLLM)

• Shared:

  • Cấu trúc thư mục chia sẻ TypeScript types và constraints (client, server, shared).

2. Kiến trúc Data Flow & Modules

Data Flow

1. Client Request: Từ React client qua tRPC Hook.
2. Backend API: tRPC router xử lý yêu cầu, parse payload thông qua Zod schema.
3. Logic Xử lý: routers.ts đảm nhiệm phân nhánh (auth, conversation, message, v.v...).
4. Database Operations: db.ts thực thi SQL với Drizzle tới MySQL.
5. LLM Calls (Ngoại vi): Hàm invokeLLM gọi ra external model để AI tổng hợp tri thức (knowledgeRouter) hay suy luận kịch bản (scenarioRouter).

Các Modules Quan trọng

Module Router	Chức năng (Business Logic)
Auth	Quản lý đăng nhập, session cookies.
Channel	Quét thiết lập mạng kênh phân phối (Zalo, Facebook, Web, API).
Conversation	Lưu trữ phiên chat của khách hàng, cập nhật trạng thái (active, waiting, escalated).
Message & AI Reply	Gửi/nhận tin nhắn; tích hợp endpoint aiReply tiêm prompt kịch bản theo ngữ cảnh người dùng.
Knowledge Base	Tạo bài viết hỗ trợ từ crawl web (Onboarding Router) hoặc nhập thủ công phục vụ tìm kiếm.
Scenario	Kịch bản CSKH tự tạo bằng AI giúp chatbot phản hồi mượt mà hơn.
Quality & Escalation	AI đánh giá điểm chất lượng cuộc gọi (Quality Score); nếu quá thấp hoặc khách giận dữ, tự động bắn qua luồng Escalation cho nhân viên người thật.

3. Đánh giá Coverage & Kiến trúc

• Điểm mạnh:
  • End-to-End Type Safety: tRPC giúp hệ thống chắc chắn 100% về type từ DB lên Server qua tới Frontend.
  • Dễ Mở rộng: routers.ts gộp (merge) từng cụm nhỏ.
• Lưu ý:
  • Quản lý phiên token LLM và Rate Limit nên được kiểm tra để tránh hao tốn tài nguyên. (Ref evolutionRouter).