Device QA runbook (walkthrough 2026-06-09)

Use this alongside DEVICE_QA_CHECKLIST.md. Check off items on a TestFlight / Play Internal build (1.0.0+10053 or newer).

Prerequisites

• Staff account with WhatsApp + mailbox permissions
• Hostinger passwords for the four mailbox accounts (not stored in repo)
• Dedicated nonproduction Supabase project and environment-supplied test OTP in env/mobile-e2e-staging.json (integration_test/README.md)

Patrol commands (local dev build)

cd C:\Users\aalde\aldilaijankhobara-app
dart pub global activate patrol_cli

# Tier 1 — smoke (not skipped)
dart run patrol_cli test --target integration_test/journey_01_smoke_test.dart `
  --release --device <device_id> `
  --dart-define-from-file=env/mobile-e2e-staging.json

# Tier 2 — auth (protected staging OTP; Tier 2.1–2.2 enabled)
dart run patrol_cli test --target integration_test/journey_02_auth_test.dart `
  --release --device <device_id> `
  --dart-define-from-file=env/mobile-e2e-staging.json

# Tier 3 — CRM (Tier 3.1–3.2 enabled; write flows still manual)
dart run patrol_cli test --target integration_test/journey_03_crm_test.dart `
  --release --device <device_id> `
  --dart-define-from-file=env/mobile-e2e-staging.json

# Tier 4 — cold boot after deep-link matrix (unit tests cover URLs)
dart run patrol_cli test --target integration_test/journey_04_deep_link_test.dart `
  --release --device <device_id> `
  --dart-define-from-file=env/mobile-e2e-staging.json

Deep-link spot checks (manual)

After receiving a push or opening a notification, confirm navigation succeeds (no GoException):

1. WhatsApp reliability: /comms/whatsapp?tab=reliability&incident=…&entity=aldilaijan
2. WhatsApp thread: /comms/whatsapp?conversation=<uuid>
3. Financial report alias: /brokerage/reports/financial → reports screen
4. Valuation detail: /valuation/valuations/<uuid>

Automated coverage: test/core/navigation/notification_link_normalization_test.dart.

Record results

Mark DEVICE_QA_CHECKLIST.md checkboxes or append defects to SHORTFALLS.md with repro steps.