CHECKLIST.md - Tiến độ dự án ScapBot#

Tổng quan Roadmap#

┌─────────────────────────────────────────────────────────────────────────────┐
│                         LỘ TRÌNH PHÁT TRIỂN SCAPBOT                          │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  GIAI ĐOẠN 1      GIAI ĐOẠN 2      GIAI ĐOẠN 3      GIAI ĐOẠN 4      G.Đ 5  │
│  Nghiên cứu &     MVP              Tăng trưởng      Kết hợp          Mở rộng│
│  Nền tảng         AI-CHAT          AI-SALE          6 Modules        Toàn cầu│
│  ──────────       ─────────        ─────────        ─────────        ────── │
│  [■■■■■■■■░░]     [░░░░░░░░░░]     [░░░░░░░░░░]     [░░░░░░░░░░]     [░░░░] │
│  ~70%             0%               0%               0%               0%     │
│                                                                              │
│  Hiện tại: Giai đoạn 1 - Nghiên cứu & Nền tảng                              │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Giai đoạn 1: Nghiên cứu & Nền tảng#

1.1 Tài liệu & Chiến lược ✅#

Công việcTrạng tháiFile
Database schema (27 bảng)✅ XongDATABASE.md
AI Mode & 3-Layer Learning✅ XongAIMODE.md
Chiến lược lợi thế cạnh tranh✅ XongMOAT.md
Marketing & Ra mắt thị trường✅ XongMARKETING.md
Danh sách kiểm tra phát triển✅ XongCHECKLIST.md

1.2 Setup cơ bản#

  • Tạo project structure theo Go Standard Layout
  • Init go.mod
  • Tạo CLAUDE.md (project context)
  • Tạo PLAN.md (kế hoạch tổng quan)
  • Cài đặt Claude Skills

1.3 Tích hợp nền tảng - Facebook Messenger#

  • Tạo Facebook App (App ID: 2642280396158962)
  • Cấu hình Messenger API
  • Setup webhook endpoint /webhooks/facebook
  • Verify webhook với Facebook
  • Kết nối Page “ScapBot Testing”
  • Generate Page Access Token
  • Test nhận tin nhắn (webhook → server)
  • Test gửi tin nhắn (server → Facebook API)
  • Phân tích payload Facebook thành model thống nhất
  • Lưu tin nhắn vào database

1.4 Tích hợp nền tảng - Telegram#

  • Tạo webhook handler structure
  • Tạo Telegram Bot (@BotFather)
  • Setup webhook với Telegram API
  • Test nhận tin nhắn
  • Test gửi tin nhắn

1.5 Tích hợp nền tảng - Zalo#

  • Tạo webhook handler structure (placeholder)
  • Đăng ký Zalo Official Account
  • Cấu hình webhook
  • Test nhận/gửi tin nhắn

1.6 Kiến trúc cốt lõi#

  • Thiết kế URL riêng cho từng platform
  • Tạo router với cơ chế bật/tắt platform
  • Tạo unified Message model
  • Thiết kế kiến trúc High Throughput (documented)
  • Thiết kế database schema (27 tables, AI Assistant-centric)
  • Multi-tenant architecture design
  • Implement message queue interface

1.7 Hạ tầng#

  • Setup cloudflared tunnel cho test
  • Tạo Dockerfile
  • Tạo docker-compose.yml (5 containers)
  • Setup PostgreSQL container
  • Setup Valkey container
  • Setup MinIO container
  • Run database migrations
  • Test docker-compose full stack

Giai đoạn 2: MVP - AI-CHAT Module#

Mục tiêu: 100 người dùng beta, Xác nhận sản phẩm-thị trường phù hợp

2.1 Triển khai Database#

  • Setup PostgreSQL với schema từ DATABASE.md
  • Triển khai bảng core (tenants, users, ai_assistants, contacts)
  • Triển khai bảng messaging (conversations, messages, attachments)
  • Triển khai partitioning cho bảng messages
  • Thiết lập indexes & constraints

2.2 Quy trình xử lý thông lượng cao#

  • Setup Valkey
  • Triển khai Valkey producer (đẩy vào queue)
  • Triển khai Valkey consumer (worker pool)
  • Chèn hàng loạt vào PostgreSQL
  • Kiểm tra tải với k6 hoặc wrk (mục tiêu: 10k msg/s)

2.3 Tính năng cốt lõi AI-CHAT#

  • Tích hợp LLM (OpenAI/Anthropic API)
  • Tải lên & embedding Knowledge Base
  • Triển khai quy trình RAG
  • Sinh phản hồi AI
  • Chuyển đổi AI Mode (BẬT/TẮT/GỢI Ý)

2.4 3-Layer Learning (AI-CHAT)#

  • Triển khai bảng global_patterns
  • Triển khai bảng industry_templates
  • Triển khai bảng ai_learning_patterns
  • Quy trình trích xuất mẫu
  • Logic áp dụng mẫu (Global → Industry → Assistant)

2.5 Vòng lặp phản hồi#

  • Triển khai bảng ai_feedback
  • Theo dõi Chấp nhận/Chỉnh sửa/Từ chối
  • Theo dõi kết quả (hội thoại → đơn hàng)
  • Trích xuất phản hồi ẩn
  • Quy trình đẩy mẫu lên

2.6 Dashboard MVP#

  • Xác thực (đăng nhập/đăng ký)
  • Giao diện hộp thư thống nhất
  • Quản lý hội thoại
  • Cài đặt AI Mode
  • Quản lý Knowledge Base
  • Phân tích cơ bản

2.7 Ra mắt thị trường (100 người dùng)#

  • Đăng ký domain scapbot.vn
  • Trang đích với “Đăng ký miễn phí”
  • Tạo Facebook Group “Hội chủ shop dùng ScapBot”
  • Tuyển 100 người dùng beta từ mạng lưới
  • Thu thập phản hồi & cải tiến

Giai đoạn 3: Tăng trưởng - AI-SALE Module#

Mục tiêu: 1,000 người dùng, K-factor > 0.8

3.1 Tính năng AI-SALE#

  • Engine gợi ý upsale
  • Gợi ý combo
  • Tối ưu chiến lược giảm giá
  • Phục hồi giỏ hàng bỏ rơi
  • Luồng tạo đơn hàng

3.2 Học liên module (CHAT → SALE)#

  • Triển khai bảng module_signals
  • Triển khai bảng cross_module_patterns
  • Phát hiện ý định trong CHAT
  • Truyền tín hiệu sang SALE
  • Học mẫu từ kết quả liên module

3.3 Nền tảng bổ sung#

  • Tích hợp WhatsApp Business
  • Tích hợp Viber Bot
  • Tích hợp Line Bot

3.4 Tính năng tăng trưởng#

  • Chương trình giới thiệu
  • Khoảnh khắc đáng chia sẻ (báo cáo, thành tích)
  • Mẫu case study & bộ sưu tập
  • Quy trình content marketing

Giai đoạn 4: Kết hợp - 6 Modules#

Mục tiêu: 10,000 người dùng, giới thiệu freemium

4.1 AI-MARKETING Module#

  • Tự động hóa chiến dịch
  • Kích hoạt remarketing
  • Engine thử nghiệm A/B
  • Tối ưu thời gian gửi tốt nhất

4.2 AI-SHIP Module#

  • AI chọn đơn vị vận chuyển
  • Ước tính thời gian giao hàng
  • Tối ưu COD
  • Phục hồi giao hàng thất bại

4.3 AI-TAX Module#

  • Tự động tạo hóa đơn
  • Theo dõi & cảnh báo VAT
  • Giám sát tuân thủ
  • Tạo báo cáo

4.4 AI-CALL Module#

  • Lịch gọi
  • Tối ưu kịch bản
  • Tích hợp Voice AI
  • Tự động gọi lại

4.5 Dashboard thống nhất#

  • Thông tin liên module
  • Dashboard thông minh kinh doanh
  • Gợi ý chủ động
  • Phân tích hiệu suất

4.6 Kiếm tiền#

  • Triển khai giới hạn gói miễn phí
  • Cổng tính năng gói Pro
  • Cổng tính năng gói Business
  • Tích hợp thanh toán (VNPay, Stripe)
  • Quản lý đăng ký

Giai đoạn 5: Mở rộng & Toàn cầu#

Mục tiêu: 50,000+ người dùng, mở rộng Đông Nam Á

5.1 Củng cố sản phẩm#

  • Xét duyệt & Phê duyệt Facebook App
  • Mở rộng ngang (nhiều instance server)
  • Thiết lập Valkey Cluster
  • PostgreSQL read replicas
  • Thiết lập CDN

5.2 Giám sát & Vận hành#

  • Bộ giám sát (Prometheus, Grafana)
  • Hệ thống cảnh báo
  • Tổng hợp log
  • Theo dõi lỗi (Sentry)
  • APM hiệu suất

5.3 Mở rộng Đông Nam Á#

  • Hỗ trợ đa ngôn ngữ (Thái, Bahasa, Tiếng Anh)
  • Trung tâm dữ liệu khu vực
  • Phương thức thanh toán địa phương
  • Mẫu theo thị trường cụ thể

5.4 Tính năng doanh nghiệp#

  • Tích hợp SSO
  • Truy cập API
  • Tích hợp tùy chỉnh
  • Giám sát SLA
  • Cổng hỗ trợ chuyên dụng

Thông tin quan trọng#

Facebook App#

  • App ID: 2642280396158962
  • Page: ScapBot Testing (ID: 306252805907692)
  • Webhook URL: https://{domain}/webhooks/facebook
  • Verify Token: scapbot_test_123

Server#

  • Cục bộ: http://localhost:2631
  • Tunnel: https://tract-scuba-admit-always.trycloudflare.com (tạm thời)
  • Chạy: go run cmd/server/main.go

Chỉ số quan trọng cần theo dõi#

Giai đoạnNgười dùng mục tiêuChỉ số quan trọng
Giai đoạn 2100NPS > 40, Kích hoạt 80%
Giai đoạn 31,000K-factor > 0.8
Giai đoạn 410,000K-factor > 1.0, Sẵn sàng kiếm tiền
Giai đoạn 550,000+15% chuyển đổi trả phí, Có lãi

Tài liệu tham khảo#

Tài liệuNội dung
DATABASE.mdSchema 27 bảng
AIMODE.md3-Layer Learning, Học liên module
MOAT.mdData Moat, Chiến lược cạnh tranh
MARKETING.mdRa mắt thị trường, Chiến lược MIỄN PHÍ

Cập nhật lần cuối: 2026-01-22

Backward DATABASE - Cấu trúc cơ sở dữ liệu