OmiScan User Flows

F-M02

Chụp 1 sản phẩm — Happy path

Cán bộ Viện DD đứng tại siêu thị, chụp 4 ảnh 1 sản phẩm bánh mì. AI on-device trích xuất, validate sơ bộ, đẩy lên server. Tổng thời gian < 90 giây.

Người thực hiện: P1 Cán bộ khảo sát (Anh Tuấn) · Thiết bị: iPhone 15 Pro

Mở app, nhấn "Chụp"

S-M03

9:41📶 📡 🔋

Xin chào, Anh Tuấn 👋

Chụp

Đạt

Chờ

Tháng 5/2026

45 sản phẩm

📷 Chụp sản phẩm mới

🏠📷📋🔍👤

Cán bộ thấy tổng quan ngày + nút lớn "Chụp sản phẩm". Tap nút → mở camera.

Quality gate báo mờ

S-M04

9:41📶 📡 🔋

● Mờ ● Sáng ● Nghiêng ● Đầy

⚠️ Ảnh mờ. Giữ máy chắc

Camera preview hiện 4 indicator. Blur đỏ → reason text "Ảnh mờ", nút Chụp disabled.

Chỉnh tư thế, chụp OK

S-M04

9:41📶 📡 🔋

● Mờ ● Sáng ● Nghiêng ● Đầy

🍞

Tất cả 4 indicator xanh → nút active → user chụp ảnh Front. App chạy M3 (Gemma 4 + ML Kit OCR) ~3s.

Sửa Natri (hallucinate)

S-M07

9:41📶 📡 🔋

← Sửa thông tin

Tên · 🟢

Bánh mì sandwich Staff

Năng lượng · 🟢

245 kcal

Đạm · 🟢

6.5 g

Natri · 🔴 Không chắc

320 mg → sửa 32

VLM=320 vs OCR='32 mg'

✓ Lưu và xem lại

Field Natri đỏ. User tap "Xem ảnh nguồn" → verify trên ảnh thực sự là 32 mg. Sửa, save.

Submit thành công

S-M08

9:41📶 📡 🔋

✓

Đã gửi thành công!

MÃ

OMI-...001234

⚠️ 1 cảnh báo

Natri cao so với WHO

📷 Chụp tiếp theo

Server validation chạy ~2s. Trả về 1 advisory "Natri cao theo WHO" — vẫn pass nhưng có note.

Ghi chú flow

Tổng thời gian: ~75 giây từ tap "Chụp" đến "Đã gửi thành công" (test trên iPhone 15 Pro với 3 ảnh chính)
Mất bao nhiêu lượt re-shoot: Trung bình 1.2 lần / sản phẩm (do ánh sáng siêu thị thường không đều). Section 11 target ≤ 20% sản phẩm cần reshoot
Cross-check OCR↔VLM: Natri là field bị hallucinate phổ biến nhất (mất 1 chữ số 0). Pipeline regex match Dart-side → flag trước khi user submit
Offline: Nếu mất mạng tại bước 5, submission đi vào local queue (M4), sync khi có mạng. User vẫn thấy "Đã lưu vào hàng đợi"
Server validation: Trigger qua EventBridge sau ingest. M6 (validation engine) áp 23 rule v1 → kết quả cập nhật vào submission record sau ~2s

F-D01

P2 review queue — buổi sáng thứ Hai

Chuyên viên xử lý dữ liệu Nguyễn Mai mở dashboard, review 28 submission flag từ tuần trước. Sửa OCR sai cho 1 submission, batch duyệt 23 cái.

Người thực hiện: P2 Chuyên viên xử lý data (Nguyễn Mai) · Thiết bị: Laptop, Chrome

Mở Queue Review

S-D05

app.omiscan.vn/queue

⚙ OmiScan

📦 Queue

189 cần xem

⏰ Cũ nhất 5 ngày

🍞 Bánh mì... mismatch

🍫 KitKat... low

🍫 Chocopie... halluc

P2 thấy queue 189 submission. Filter mặc định "pending_review", sort cũ trước. Click row đầu OMI-...001234.

Mở detail drawer + xem flag

S-D04

.../OMI-001234

Bánh mì sandwich Staff

⚠ Natri: VLM=320, OCR='32'

🍞

📋

📊

🏷️

Natri 320 mg [Sửa]

"Natri 32 mg"

Drawer hiện 4 ảnh + JSON + OCR raw text. P2 thấy ngay flag: VLM trả 320 nhưng OCR đọc "32 mg".

Verify ảnh nguồn → sửa

S-D04

Sửa Natri

[Ảnh nutrition cận]

32 mg

Natri (sửa)

✓ Lưu thay đổi

Click "👁 Xem ảnh nguồn" → bbox highlight chữ "32 mg". P2 confirm OCR đúng, sửa 320→32, chọn lý do.

Batch duyệt 23 cái

S-D06

Duyệt 23 submission

Bạn đang duyệt 23 submission. Sau khi duyệt:

✓ Chuyển sang "Đã duyệt"

✓ Audit log với tên bạn

☐ Email cho cán bộ chụp

Hủy

Xác nhận duyệt

P2 chọn 23 submission đã review xong → nút Bulk "Duyệt batch" → comment chung → Confirm. Audit log đầy đủ.

Ghi chú flow

Throughput target: ~5 phút/submission cho rule khó. Buổi sáng P2 xong queue trong ~2.5h
Audit: Mỗi sửa OCR/JSON ghi entry với before/after/reason — required cho ISO 27001 + BVDLCN
Bulk action: Section 03.5 UC-10 quy định 3 lựa chọn: Duyệt / Đẩy lên TP / Loại
Khi nào "đẩy lên TP": P2 không chắc về chuyên môn dinh dưỡng → escalate tới trưởng phòng (P3.5 hoặc Lãnh đạo Viện)

F-C01

P3 publish rule advisory mới — sau khi WHO ra khuyến nghị

Chuyên gia dinh dưỡng Lê Anh tạo rule advisory cảnh báo natri cao (>600mg/100g) theo khuyến nghị mới của WHO. Trưởng phòng Hùng Phan approve. Mobile app áp dụng trong 6h.

Người thực hiện: P3 Cán bộ rule pack (Lê Anh) + P3.5 Approver (Hùng Phan) · Web CMS

Tạo rule mới

S-C04

+ Tạo rule mới

PREDICATE

sodium_mg >

P3 fill form: ID, severity, scope (thực phẩm + đồ uống), predicate sodium_mg > 600, message.

Preview test set

S-C05

Preview · 50 submission

PASS

FLAG

8% submission flag — bình thường

🥤 Pepsi Max — 525 mg

🍜 Mì Hảo Hảo — 720 mg ⚠

Hệ thống chạy rule trên 50 submission gần. 8% flag — không quá cao, OK submit approval.

Submit for approval

S-C06

Submit approval

✉ Gửi yêu cầu

P3.5 sẽ nhận email + notification

P3 chọn approver = Hùng Phan, write changelog, click Submit. Hệ thống gửi notification + email tới P3.5.

P3.5 review diff

S-C07

Diff: 2026.05.10 → 2026.05.11

            + {
+  "id": "VDD-WHO-...",
+  "severity": "advisory",
+  "predicate": {
+    ">": [{"var":
+     "sodium_mg"}, 600]
+  }
+ }
          

Reject

✓ Approve

P3.5 mở approval queue, xem diff +1 rule. Auto test: schema OK, syntax OK, perf 42ms, không cảnh báo. Click Approve.

Sign + push CDN

Auto

✓ Đã publish 2026.05.11

✓ Bump semver 2026.05.10 → .11

✓ Canonicalize JSON

✓ KMS sign ECDSA P-256

✓ Upload S3 packs/2026.05.11.json

✓ Update manifest.json

✓ CloudFront invalidate

✓ EventBridge rulepack.published

✓ Audit log entry

📲 Mobile sẽ pull trong 6h hoặc qua silent push

Backend tự: bump version, sign ECDSA P-256, upload S3, invalidate CDN, audit. Mobile app pull mỗi 6h.

Ghi chú flow

4-eyes principle: P3 (soạn) ≠ P3.5 (approve). Tuân ISO 27001 + audit yêu cầu
Tổng thời gian: ~30 phút từ "Tạo rule" đến "Mobile cài rule mới" (5 phút soạn + 5 phút approver review + auto sign 5s + 6h propagation max)
Khẩn cấp: Nếu rule cần áp ngay (ví dụ pháp luật vừa sửa), P3.5 click "Force silent push" → APNs/FCM đẩy ngay tới mobile, latency ~10s
Rollback 1 click: Nếu rule mới gây cảnh báo nhầm hàng loạt, P3.5 vào Publish history → "Promote lại" 2026.05.10 → mobile pull lại version cũ
Audit: Mọi diff được lưu vĩnh viễn trên S3 (không có lifecycle delete) — tuân ISO 27001 + Luật AI 134/2025

🔀 User Flows — 3 luồng nghiệp vụ chính

Chụp 1 sản phẩm — Happy path

Ghi chú flow

P2 review queue — buổi sáng thứ Hai

Ghi chú flow

P3 publish rule advisory mới — sau khi WHO ra khuyến nghị

Ghi chú flow

Đã xem qua các flow chính của OmiScan