d3ro-voice/docs/map/06-mobile-app.md

15 KiB

06 — Mobile App (React Native) Map

Surface: apps/mobile-rn (ACTIVE product mobile app) Stack: React Native 0.85 + React 19 (CLI) + Supabase + Google Play Billing + AdMob The Expo legacy skeleton (apps/mobile) was removed 2026-09-13; apps/mobile-rn is the only mobile runtime. Authoritative checklist: docs/v3/MOBILE_APP_COMPLETION_SSOT.md


1. Navigation structure

Root stack (App.tsx RootNavigator) branches on auth/onboarding:

  • recovery → UpdatePassword
  • onboarding → Onboarding + InviteAccept + Login
  • unauthenticated → Login, SignUp, ForgotPassword, InviteAccept
  • authenticated → Main (TabNavigator) + 23 stack screens (secondary stack screens use React Navigation getComponent lazy resolution with Metro inlineRequires: true, and @d3ro/i18n resolves index.native.tsx supporting all 12 locales with Metro inlineRequires lazy evaluation)

Bottom tabs (TabNavigator.tsx): Home / Records / Meetings / More. Record remains a hidden tab route so an active recording stays mounted; it never occupies a visible tab slot. A floating RecordFab appears on Home/Records/Meetings (not More/Record) and routes dictation → Record, meeting recording → Meetings + createRequest, audio import → Record + importRequest. Android back, scrim press, and action selection close its menu; tab back behavior is history-based. Home opens UnifiedSearch on the root stack. New and converted v4 flows use the app-level ScreenHeader with a 48dp back action; tab roots such as Records and Meetings show a title without a back action. Historical stack screens that were not part of this conversion may still use their own header. Deep links: d3ro-voice:// and https://d3ro.chanpaca.net (accept-invite).

Provider stack: GestureHandlerRootView → SafeAreaProvider → AuthProvider → EntitlementProvider → BillingProvider → MobileAdsProvider → MobilePreferencesProvider → DeviceProvider → LocalizedApplication (I18n + StatusBar).


2. Screens (src/screens/: 31 active source files)

Screen Feature
HomeScreen Today summary, recent 5 records / 3 meetings, unified-search entry, Free plan entry
MoreScreen Tools and account routes; Admin entry is role-gated
UnifiedSearchScreen Authenticated record+meeting search, newest-first merged results, source-aware detail navigation
RecordScreen Recording + local-whisper/cloud transcription, import audio, share; entered from the hidden Record route/FAB
TalkScreen Voice/text AI chat: STT, LLM streaming, TTS; opened from More on the root stack
HistoryScreen / HistoryDetailScreen History list/detail: sync, search, filters, audio playback, edit/share/favorite/delete
MeetingsScreen / MeetingDetailScreen Meeting workspaces: create/rename/delete, existing-audio import through the durable meeting queue, transcript (with color-coded speaker badges & multi-speaker filter chips, 2026-11-13 GAP-MTG-02), memos (immutable revision CAS conflict detection, GAP-SYNC-08), documents/minutes, export, content report
MemosScreen Memos: list, tags, search, share
TemplatesScreen Dictation/meeting document templates CRUD
KnowledgeScreen Knowledge docs: create/import/index/merge/delete/search
CommandsScreen Custom instruction CRUD/reorder/activate/execute
ActionsScreen Voice-action parse/confirm/execute + history
DictionaryScreen Dictionary CRUD/search/filters
TeamsScreen / TeamDetailScreen Teams: create, members, invites, rename, leave, meetings, activity feed/comments
DevicesScreen Registered devices (phones, web, desktop apps), platform label, revoke/remove — revoking a desktop signs it out
NotificationsScreen Notification list, permission, deep-link nav
AccountScreen Profile (incl. 12-locale selector), identities, data export/delete, logout
DataPortabilityScreen Export/import archive, dictionary, history, meeting docs
AdminScreen / AdminUserDetailScreen Role-gated admin: users, subscriptions, audit, role/tier edits
ProPaywallScreen Pro/Pro+ paywall: Play IAP, restore, rewarded ads
OnboardingScreen First-run audience/theme/12-locale selector
SettingsScreen Preferences, 12-locale/theme selector, privacy links, logout; opened from More on the root stack
LoginScreen / SignUpScreen / ForgotPasswordScreen / UpdatePasswordScreen / InviteAcceptScreen Auth flows

3. Features (src/features/, 23 modules)

Module Purpose
recording/ Durable offline recording queue, retry processing, language handling
audio/ Linked recording/audio cleanup
import/ Audio pick/decode/validate, local Whisper fallback, resumable multipart upload, Android share-intent intake
history/ History service + local cache + sync hook
meetings/ Meeting workspace CRUD, realtime channels, processing jobs, transcripts/memos/docs
memos/ Memo CRUD, tags, search, realtime, share
talk/ Streaming LLM, transcription, TTS playback
teams/ Team CRUD/members/invites/realtime, pending invite, listTeamActivities/createTeamActivity (activity feed)
knowledge/ Knowledge docs CRUD/index/merge/search + file picker
commands/ Custom command client
actions/ Voice-action parse/execute + side effects
dictionary/ Dictionary CRUD/pagination/search
devices/ Device registration/list/revoke
dashboard/ Dashboard stats + recent entries
templates/ Templates + generation idempotency
auth/ OAuth sign-in (in-app browser, PKCE) + identity linking
account/ Account deletion service and server-confirmed exit boundary
admin/ Admin user/subscription/audit APIs + session/role
data-portability/ Canonical JSON export/import, schema validation, legacy import, meeting export, file sharing
chat/ Chat LLM normalization/streaming, reportable generation IDs
notifications/ Notification contract/native registration/service/runtime hook
reporting/ AI content reporting (reason codes, Edge calls, idempotency)
search/ User-scoped record title/original/polished/summary + meeting title/raw/edited transcript search; sanitization, parallel queries, newest-first merge

Core libs (src/lib/): auth-context, auth-redirect, auth-capabilities, secure-auth-storage (Keychain + legacy migration), logout, account-exit, account-local-data (central purge), supabase, billing-context (Play/App Store IAP), entitlement-context, device-context, preferences-context, mobile-ads-context (UMP consent + rewarded), native-config, pkce-s256, random-id, audio-recorder, e2e-runtime-bootstrap.


4. Mobile status summary

Source of truth for status is docs/v3/MOBILE_APP_COMPLETION_SSOT.md sections 0.1, 2.1, 4. Current condensed state:

Area Status
Auth / account [~] Implemented + Jest GREEN; external OAuth consent→callback and logout/delete/provider device E2E pending
Onboarding [~] unit coverage and the current .3 isolated API 34 AVD fresh auth/signup journeys are GREEN; the historical .2 Fold6 fresh journeys passed, but current .3 Fold6 first-run failed twice at onboarding visibility. The 2026-11-04 1.16.1 Fold6 result is a state-preserving upgrade/cold launch, not current physical-device first-run proof
v4 shell / theme / accessibility [x] shell journey at 320dp dark and 411dp light; [~] broader design-system/a11y proof. 2026-11-04 Android automation added current-source physical/AVD install+launch, inspected-route labels/48dp, and AVD font-scale 2.0 + rotation/scroll evidence; manual TalkBack/focus order, the SDK ad WebView, app-wide coverage, and iOS remain
Large screen (tablet / unfolded foldable) [~] 2026-11-13 (GAP-UX-08) implemented + Jest GREEN: @d3ro/ui-native/responsive (resolveResponsiveLayout, useResponsiveLayout, useContentWidth, <ContentColumn>) applies maxWidth: 880 (formMaxWidth: 520 on auth/onboarding/record), >=600dp 2-column grids on More/Meetings/Commands/Templates, compact inline Edit/Delete/Select action buttons on Dictionary/Templates, and 90dp adaptive-banner slot reservation (FreeTierBanner) across 10 screens (responsive-layout.test.tsx 4/4 PASS). Physical Fold6 open/closed Maestro visual confirmation remains
Recording / transcription / Talk [x] core path GREEN on API 34 (FGS, recovery, local Whisper, cloud fail-closed, TTS)
Data portability [x] export/restore + share E2E GREEN
History / meetings [x] real data + meeting creation contract GREEN; audio timestamp/speaker + cross-app E2E pending
Record+meeting unified search [~] service/row tests and both canonical runtime journeys (both source results → details) GREEN; mobile raw-text overfetch/no cancellation and FTS/index/large-data performance remain unproved
Teams / push [~] teams GREEN; real FCM delivery needs Firebase/FCM credentials
Billing / ads [~] test ads + Google Play verification code GREEN; live store purchase/restore/settlement and production AdMob serving RED (external)
Admin [x] mobile admin role E2E GREEN (ordinary/manager/admin/super_admin, stale JWT)
Quality / distribution [~] lint/typecheck/Jest GREEN; production signed AAB + Play submission RED (external gates)

External blockers (do not treat as code gaps): production Firebase project, AdMob live serving, Play Billing license tester, CI secret injection, signed production AAB, Play closed test (0/12, 14 days), production access approval. See SSOT §0, §6.


5. Legacy removal

The Expo skeleton (apps/mobile) was deleted on 2026-09-13: it duplicated auth/data logic, shipped a dev-bypass login, and was outside the workspace and CI. scripts/ci/sync-version.mjs and package-lock.json no longer reference it. apps/mobile-rn is the sole mobile runtime; git history retains the old app.

The v4 shell also removed DashScreen and WorksHubScreen. Home replaces the dashboard entry; first-class tabs and More preserve the former WorksHub destinations. The WorksHub-only local tool filter and pinning were intentionally retired to avoid a second navigation taxonomy and local ordering state. This removed navigation UI, not record/meeting/tool content; an unused works-hub-pins.v1 AsyncStorage key may remain on upgraded installs.


6. Tests & evidence

  • Jest: npm --prefix apps/mobile-rn test — current full tree 98 suites / 625 tests PASS (2026-11-14 Wave 6; 2026-11-13 baseline was 89 suites / 605 tests). Coverage includes onboarding-fresh-route.test.tsx, responsive-layout.test.tsx (4/4), meeting-detail-speakers.test.tsx (1/1), meetings.test.ts (18/18 incl. revision CAS), meeting-import creation routing and record-screen-redteam-r2-27.test.tsx, plus 9 Wave 6 regression suites (durable-queue-early-discard, free-tier-banner-resize, history-detail-unmount-regression, meeting-detail-unmount-regression, onboarding-locale-regression, record-permission-session-regression, service-guards, settings-locale-sync-regression, talk-locale-recorder-regression). Wave 6 also consolidated shared guards/cleanup/locale-speech into features/shared/{service-guards,owned-cache-files}.ts, features/import/abort-guard.ts, lib/locale-speech.ts, and features/meetings/meeting-error-message.ts, and fixed FreeTierBanner slot-change height stickiness (90dp->50dp), durable queue early-discard AbortController registration before FileSystem.exists, RecordScreen session lease leak, TalkScreen 12-locale TTS tags + live greeting sync, and unmount/audio/timer/locale races on HistoryDetail/Settings/Onboarding/Account/MeetingDetail. The current .3 Fold6 APK renders the MTG-13 entry/editor; device file selection→transcription→minutes E2E remains NOT_RUN.
  • Maestro E2E: apps/mobile-rn/.maestro/ + evidence in .maestro-output/.
  • Current .3 isolated API 34 AVD: canonical fresh auth 37 s PASS, signup 50 s PASS, including persistence after restart. Initial emulator failure was observed with a System UI ANR dialog; it passed after the dialog was dismissed. Both failure and retry are retained under test-results/recovery-2026-11-01/emulator-*. The new empty test AVD alone used clearState; personal Fold6 data was preserved. This does not resolve the separate Fold6 first-run failures.
  • Historical .2 Fold6 physical-device gate (Android 16, SM-F956N): fresh auth 60 s PASS, fresh signup 67 s PASS, warm/cold invite 31 s PASS, and small-screen signup 61 s PASS on 2026-11-01. Fatal/Metro matches 0; evidence is apps/mobile-rn/.maestro-output/fold6-20261101-fix1/. Authenticated parity was not run because test credentials are absent.
  • v4 local runtime: apps/mobile-rn/.maestro/navigation-shell-search-local.yaml; 320dp dark 1/1 PASS, 88 s at scratch/design-audit/wave45/navigation-shell-search-320-dark-verified.xml, and 411dp light 1/1 PASS, 100 s at scratch/design-audit/wave45/navigation-shell-search-411-light-verified.xml.
  • Current runtime APK: com.d3ro.voice, 1.15.4-e2e.20261101.3 / 2026110103, 147158575 bytes, SHA-256 937d2a0b3fb6b810516f07e91dd97ffe99d34c5885a72f21805a51e8a408027f. Build Tools 37 verifier PASS; installed identity matches. Import entry and metadata editor rendered on Fold6 without saving new data. Earlier .3 fresh-auth + retry both FAILED at onboarding visibility (black screenshots); those failures are retained. No data reset was performed, so .2 historical passes are not current first-run proof. Production configuration fails with firebase_expected_project_id_missing, including with root .env. Evidence.
  • 2026-11-04 current-source E2E runtime: 1.16.1-e2e.20261104.1 / 2026110401, SHA-256 3d2875c74b555dbcd854468e57b9b4b3a8e6c9657f210760cbe24a77ee92cf7c, verifier PASS, then state-preserving adb install -r and cold launch PASS on Fold6 Android 16 and API 34 AVD. Physical Notifications status/privacy/recent cards passed a clearState:false Maestro flow without a permission action. UIAutomator and AVD font-scale 2.0/rotation are automated evidence only; manual TalkBack, notification permission transitions/FCM receipt, app-wide a11y, and iOS remain. Evidence.
  • Committed evidence summary: docs/evidence/wave45-mobile-shell-search-2026-09-28.md.
  • Android instrumentation: apps/mobile-rn/android/app/src/androidTest (CSPRNG + incoming share).
  • Build verifiers: scripts/ci/verify-android-artifact.mjs (legacy + Build Tools 37 signer output), verify-android-app-links.mjs, verify-mobile-build-config.mjs (incl. R8 enableProguardInReleaseBuilds=true, shrinkResources, and 12-locale localeFilters release contract), verify-mobile-release-boundary.mjs. Circular root dependency "d3ro-voice-monorepo": "file:../.." and its NTFS junction were removed on 2026-11-13.