ChopCal · User flow theo vai trò
Bài tập tuần 4 BTO Master, phần 2 · vẽ từ bản đặc tả ChopCal v0.6.4 (đã duyệt 18/11/2026) · mỗi cột dọc là một làn (lane) của một vai trò, đọc từ trên xuống: từ lúc cài app tới lúc nhận giá trị (bữa đầu đã lưu với khoảng kcal), nhánh 2 là mua Plus.
Chặng 1 · Vào app
Chặng 2 · Chụp và quét
Chặng 3 · Nhận giá trị
Nhánh 2 (tùy chọn) · Mua Plus
Mũi tên liền: yêu cầu · mũi tên đứt: trả lời
- AI chỉ gọi tên món, khẩu phần, độ tin; mọi con số dinh dưỡng do máy chủ tra từ bảng món có nguồn USDA.
- Free có 5 lượt quét mỗi ngày (giờ UTC); Plus không giới hạn trên màn hình, máy chủ vẫn chặn ở 60 lượt/ngày.
- Thu tiền chỉ qua Google Play; phần thu tiền trên máy chủ đã dựng nhưng đang tắt, chờ vòng thử thật.
Mã Mermaid của sơ đồ
sequenceDiagram
autonumber
participant U as Người dùng
participant A as App ChopCal
participant W as Máy chủ ChopCal (Worker)
participant AI as Dịch vụ AI (Gemini/Claude)
participant G as Google Play
rect rgb(243, 240, 252)
Note over U,G: Chặng 1 · Vào app
U->>G: tìm ChopCal, bấm Cài đặt
G-->>U: tải app về máy
U->>A: mở app, Sign up bằng email + mật khẩu (18+)
A->>W: tạo tài khoản
W-->>A: trả token đăng nhập
A-->>U: màn Welcome, nút Add your first meal
U->>A: bấm Add your first meal
A-->>U: màn Consent nêu Google Gemini và Anthropic Claude
U->>A: bấm Agree
end
rect rgb(236, 246, 251)
Note over U,G: Chặng 2 · Bữa đầu tiên: chụp và quét
A->>W: hỏi số lượt còn (quota)
W-->>A: scansLeft 5, đặt lại 00:00 UTC
A-->>U: màn Scan hiện "5 scans left" trước khi chụp
U->>A: chạm Take photo
A->>W: gửi ảnh tối đa 1280 px, chờ tối đa 15 giây
alt quá 15 giây hoặc mất mạng
A-->>U: "Scan didn't finish", Try again giữ ảnh
else đã dùng hết 5 lượt hôm nay
W-->>A: 429 hết lượt
A-->>U: màn hết lượt: Search food hoặc một lời mời Plus
else còn lượt
W->>AI: gửi ảnh, nhờ gọi tên món (Gemini trước)
AI-->>W: tên món, khẩu phần, độ tin (Claude thay khi Gemini lỗi, quá 5 giây hoặc tin dưới 0,90)
W->>W: tra bảng món USDA, nhân theo gram ra khoảng
W-->>A: món, khoảng kcal/đạm/béo/carb, nhãn tin cậy, scansLeft 4
A-->>U: màn Result: khoảng + nhãn tin cậy (tin thấp thì "Not sure", 3 lối)
end
end
rect rgb(237, 248, 238)
Note over U,G: Chặng 3 · Nhận giá trị: bữa đầu đã lưu với khoảng kcal
U->>A: sửa phần, chọn S/M/L hoặc Swap món
A->>A: tính lại khoảng ngay trên máy, không gọi mạng
U->>A: bấm Add to diary
A->>W: lưu bữa (rớt mạng thì xếp hàng gửi sau)
W-->>A: đã lưu, không lưu ảnh
A-->>U: Today: bữa đầu đã lưu, khoảng kcal so với mục tiêu
end
rect rgb(253, 245, 230)
Note over U,G: Nhánh 2 (tùy chọn) · Mua Plus, chỉ qua Google Play
U->>A: chạm See Plus (từ màn hết lượt hoặc Settings)
A->>G: đọc giá gói từ store
G-->>A: giá thực thu, chu kỳ
A-->>U: màn Plus: giá in to, dòng Free, cách hủy
U->>G: bấm Subscribe, xác nhận trên tờ thanh toán
G-->>A: mã giao dịch
A->>W: gửi mã giao dịch để kiểm
W->>G: kiểm giao dịch
G-->>W: giao dịch hợp lệ
W-->>A: bật quyền Plus
A-->>U: "Plus is on.", quét không giới hạn (trần 60 lượt/ngày)
end