Bài toán
Mỗi ngày cả nhóm đặt đồ uống: người gom đơn phải hỏi từng người, chép menu, tính tiền và đòi nợ. OrderManager biến việc đó thành một app nhỏ có cả chat nhóm và trợ lý AI.
Tính năng
- Quán & menu: thêm quán, nhập menu từ nhiều ảnh chụp bằng model vision, xác nhận trước khi lưu.
- Đặt đơn & công nợ: chọn món, chốt đơn. Công nợ tính theo cặp (người tạo đợt đặt là chủ nợ), có ma trận ai nợ ai, thanh toán bằng VietQR. Công nợ cũ nhập lại được từ ảnh bảng Excel.
- Chat nhóm realtime: online, đang gõ, đã đọc, thông báo. Tin nhắn hẹn giờ lặp lại, AI có thể viết lại nội dung. Người ngoài vào chat bằng tài khoản khách tạm thời, tên và avatar là một loại đồ uống ngẫu nhiên.
- Quiz: AI sinh đề từ chủ đề hoặc từ ảnh, tính điểm theo tốc độ, bảng xếp hạng realtime.
- Trợ lý AI trong nhóm: gõ
@AIđể hỏi menu, đặt món, xem ai chưa đặt… qua SPARK AI Gateway. AI còn nhận ra ý định đặt món trong tin nhắn thường để gợi ý.
Công nghệ sử dụng
| Công nghệ | Dùng để làm gì, dùng như thế nào |
|---|---|
| Go 1.22 + chi | REST API, middleware chia tầng: đăng nhập → chặn tài khoản khách → admin. |
| pgx + PostgreSQL | Dùng pgxpool. Migration nhúng vào binary bằng go:embed, chạy theo thứ tự tên file mỗi lần khởi động, viết idempotent với IF NOT EXISTS. |
| gorilla/websocket | Hub chỉ phát sự kiện: tin nhắn, đơn, quiz, gợi ý, thông báo, online, đang gõ, đã đọc, và stream câu trả lời AI. Ghi dữ liệu vẫn đi qua REST. Một người mở được nhiều tab, nhiều thiết bị cùng lúc. |
| Google Identity Services + golang-jwt | Frontend nạp script GSI. Backend tự kiểm ID token RS256 bằng JWKS của Google (có cache key), rồi phát JWT của app. |
| Scheduler bằng goroutine | Chạy nền định kỳ: gửi tin hẹn giờ, tự đóng đợt đặt, xoá khách hết hạn, chuyển câu quiz. |
| Vòng ReAct viết bằng Go | Tool list_shops, list_menu, create_order, get_my_debt, who_hasnt_ordered, có giới hạn số bước. Chỉ chạy tool trong danh sách cho phép; userID luôn lấy từ JWT, không lấy từ tham số LLM sinh ra. Mọi lời gọi, kể cả bị từ chối, ghi vào bảng ai_tool_audit. |
| SPARK AI Gateway | @AI trong group: mỗi cuộc trò chuyện giữ một phiên, câu trả lời stream về qua WebSocket, có lệnh /reset. |
| 9Router · Gemini vision | Model chữ dùng cho chat AI 1-1 (SSE kiểu OpenAI), gợi ý đặt món, sinh quiz, viết tin hẹn giờ. Model vision Gemini Flash-Lite đọc menu từ nhiều ảnh trong một request và trả về JSON; đọc cả ảnh bảng công nợ cũ. |
| Cloudflare R2 | Ảnh chat và ảnh menu tải thẳng lên bằng presigned PUT. Chữ ký AWS SigV4 tự cài, không cần aws-sdk. |
| VietQR | Lấy danh sách ngân hàng (có cache), dựng ảnh QR từ thông tin ngân hàng trong hồ sơ người nhận tiền. |
| Next.js 14 + MUI 6 | App Router, build standalone. Form dùng react-hook-form + zod; framer-motion làm hiệu ứng; react-markdown hiển thị câu trả lời AI; lottie cho trạng thái chờ của bot. |
| Kubernetes + ArgoCD | 2 image (api, fe) gắn tag theo commit. Ingress chia /api sang backend, còn lại sang frontend. ArgoCD tự đồng bộ. |