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
Google PlayDịch vụ AI(Gemini/Claude)Máy chủ ChopCal(Worker)App ChopCalNgười dùngGoogle PlayDịch vụ AI(Gemini/Claude)Máy chủ ChopCal(Worker)App ChopCalNgười dùngChặng 1 · Vào appChặng 2 · Bữa đầu tiên: chụp và quétalt[quá 15 giây hoặc mất mạng][đã dùng hết 5 lượt hôm nay][còn lượt]Chặng 3 · Nhận giá trị: bữa đầu đã lưu với khoảng kcalNhánh 2 (tùy chọn) · Mua Plus, chỉ qua Google Playtìm ChopCal, bấm Cài đặt1tải app về máy2mở app, Sign up bằng email + mậtkhẩu (18+)3tạo tài khoản4trả token đăng nhập5màn Welcome, nút Add your firstmeal6bấm Add your first meal7màn Consent nêu Google Gemini vàAnthropic Claude8bấm Agree9hỏi số lượt còn (quota)10scansLeft 5, đặt lại 00:00 UTC11màn Scan hiện "5 scans left" trước khichụp12chạm Take photo13gửi ảnh tối đa 1280 px, chờ tối đa 15giây14"Scan didn't finish", Try again giữ ảnh15429 hết lượt16màn hết lượt: Search food hoặc mộtlời mời Plus17gửi ảnh, nhờ gọi tên món (Geminitrước)18tên món, khẩu phần, độ tin (Claudethay khi Gemini lỗi, quá 5 giây hoặctin dưới 0,90)19tra bảng món USDA, nhântheo gram ra khoảng20món, khoảng kcal/đạm/béo/carb,nhãn tin cậy, scansLeft 421màn Result: khoảng + nhãn tin cậy (tinthấp thì "Not sure", 3 lối)22sửa phần, chọn S/M/L hoặc Swap món23tính lại khoảng ngay trênmáy, không gọi mạng24bấm Add to diary25lưu bữa (rớt mạng thì xếp hàng gửisau)26đã lưu, không lưu ảnh27Today: bữa đầu đã lưu, khoảng kcal sovới mục tiêu28chạm See Plus (từ màn hết lượt hoặcSettings)29đọc giá gói từ store30giá thực thu, chu kỳ31màn Plus: giá in to, dòng Free, cáchhủy32bấm Subscribe, xác nhận trên tờ thanh toán33mã giao dịch34gửi mã giao dịch để kiểm35kiểm giao dịch36giao dịch hợp lệ37bật quyền Plus38"Plus is on.", quét không giới hạn(trần 60 lượt/ngày)39
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