EN
Web app
Đang vận hành

OrderManager

App đặt đồ uống cho nhóm: gom đơn, chia nợ, chat nhóm realtime, quiz, và trợ lý AI đọc menu từ ảnh, đặt món ngay trong group chat.

Thiết kế & phát triển

order.devbyspark.com

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 + chiREST API, middleware chia tầng: đăng nhập → chặn tài khoản khách → admin.
pgx + PostgreSQLDù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/websocketHub 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-jwtFrontend 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 goroutineChạ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 GoTool 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 visionModel 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.
VietQRLấ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 6App 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 + ArgoCD2 image (api, fe) gắn tag theo commit. Ingress chia /api sang backend, còn lại sang frontend. ArgoCD tự đồng bộ.
OrderManager — Dự án của Vũ Xuân Bình