Note
    Updated Jun 1, 2026

    Maintain current-state journey audit

    Journey audit evidence covering the sign-in gate, onboarding, returning-user tab shell, HealthKit states, export states, and unverified hosted/live-route boundaries.

    Dates

    Created
    Jun 1, 2026
    Last updated
    Jun 1, 2026

    C U R R E N T- S TAT E P R O D U C T I O N A U D I T Maintain Current-State Journey Audit Current-state journey audit for the 1029 medication-context continuation on top of the reconciled Maintain iOS baseline. Primary evidence comes from simulator screenshot capture on the local app, with code and UI tests used as secondary coverage evidence.

    C U R R E N T- S TAT E P R O D U C T I O N A U D I T Maintain Current-State Journey Audit Current-state journey audit for the 1029 medication-context continuation on top of the reconciled Maintain iOS baseline. Primary evidence comes from simulator screenshot capture on the local app, with code and UI tests used as secondary coverage evidence. Scope lock: Current-state only. This report records what the app and supporting routes do now; it does not redesign the experience inside the audit itself. Color legend Signed-Out Configured User route entries and screen IDs New User Onboarding route entries and screen IDs Returning Maintenance User route entries and screen IDs Broken or untrusted live routes Generated at: 2026-04-06 10:44 ET (America/New_York) Audit root: /Users/maggielerman/Github/maintain-ios/DOCS/JOURNEY_AUDIT Cross-Role Current-State Tables Cross-Role Comparison USER TYPE ENTRY SURFACE PRIMARY GOAL OBSERVED CURRENT-STATE SHAPE Signed-Out Configured User Sign-in gate Authenticate or create account Single focused auth screen with no tab shell exposure Maintain Current-State Journey Audit 1 / 13

    -- 1 of 13 --

    USER TYPE ENTRY SURFACE PRIMARY GOAL OBSERVED CURRENT-STATE SHAPE New User Onboarding Maintenance profile setup Define target weight, range width, and journey context Short setup handoff into the main app shell Returning Maintenance User Main tab shell Review maintenance status, log context, inspect trends, manage profile and exports Broadest and most meaningful current-state branch Route Reuse With Color-Coded Entry Paths ROUTE PATTERN OBSERVED PURPOSE SIGNED-OUT CONFIGURED USER ENTRY PATHS NEW USER ONBOARDING ENTRY PATHS RETURNING MAINTENANCE USER ENTRY PATHS Main tab shell Primary in-app navigation across Home, Log, Trends, Activity, and Profile Signed-Out Configured User New User Onboarding Onboarding submit -> main tab shell Returning Maintenance User Direct post-onboarding or persisted-profile landing Profile operational hub Maintenance setup editing, HealthKit status, and export management Signed-Out Configured User New User Onboarding Returning Maintenance User Tab: Profile Redundancy Matrix USER TYPE OBSERVED TASK CURRENT SURFACES WHY IT FEELS REDUNDANT OR CONCENTRATED Returning Maintenance User Manage setup, HealthKit, and exports Profile Profile concentrates several support jobs into one tab. It is not broken, but it is the densest current-state surface. Terminology Matrix USER TYPE SURFACE OBSERVED LANGUAGE TRUST NOTE New User Onboarding Onboarding Maintenance range width, journey summary Aligned with the clarified maintenance framing. Returning Maintenance User Home and Trends 30-day fluctuation, month-over-month fluctuation More specific than the older stability-only framing. Maintain Current-State Journey Audit 2 / 13

    -- 2 of 13 --

    USER TYPE SURFACE OBSERVED LANGUAGE TRUST NOTE Returning Maintenance User Log and Profile Medication check-in and maintenance summary language Aligned with the descriptive maintenance framing now present on this branch. Broken Or Untrusted Live Routes ROUTE / STATE OBSERVED PROBLEM EVIDENCE TRUST CLASSIFICATION Hosted returning-user session Not directly observed in this audit Sign-in gate was captured, but successful hosted auth was not exercised untrusted Public share-token handoff Backend route exists but no valid live token was audited Code and docs only missing Runtime configuration issue screenshot State is test-verified but not present in the screenshot set make ios-runtime-smoke and UI tests partially covered Highest-Signal Production Findings The app now has a coherent three-branch structure: auth gate, onboarding setup, and a broad returning-user tab experience. The descriptive medication-context pass now makes onboarding, Log, and Profile read as one maintenance product instead of a mix of older labels. The returning-maintenance-user branch contains most of the current product value and should anchor the next tranche decisions. The strongest current-state evidence is still local-first and seeded. Hosted authenticated returning-user behavior remains less trusted because it was not directly observed here. Prioritized Untangle Next Merge 1031 first, then land this 1029 wording pass so the audited branch becomes the new baseline. Use the 1030 backlog for focused hardening slices instead of letting audit work replace product execution. Maintain Current-State Journey Audit 3 / 13

    -- 3 of 13 --

    Keep Apple/TestFlight work isolated in the blocked 1013 lane until machine access changes. Coverage Verification Last updated: 2026-04-06 10:44 ET (America/New_York) Verdict No. The audit covers the primary user-visible branches and key support states, but not every hidden or infrastructure-only path. What The Current Audit Already Covers Well FAMILY EVIDENCE STATUS Auth gate, onboarding, and main tab shell Direct screenshots plus UI tests covered HealthKit connected/disconnected and export queued/ready profile states Direct screenshots covered Missing Current-State Dashboard Variants MISSING FAMILY REASON Hosted returning-user session No live authenticated walkthrough was executed during the audit Missing Reachable Public, Token, And Auth Handoff Routes MISSING PUBLIC OR HANDOFF ROUTE REASON /v1/shares/:token No valid live token was available for direct observation TestFlight delivery path Tracked as blocker evidence rather than as a live journey Maintain Current-State Journey Audit 4 / 13

    -- 4 of 13 --

    What This Means For The Audit This audit is reliable for the primary current-state iOS route graph. It should not be treated as proof of a fully verified hosted returning-user experience. Maintain Current-State Journey Audit 5 / 13

    -- 5 of 13 --

    S I G N E D - O U T C O N F I G U R E D U S E R C U R R E N T- S TAT E WA L K T H R O U G H Signed-Out Configured User Journey No active session; configured hosted runtime Signed-Out Configured User Last updated: 2026-04-06 10:44 ET (America/New_York) Route Maps Configured Signed-Out Flow Configured App Launch Sign-in Gate Sign In Create Account Current-State Findings This branch is now stable and no longer incorrectly falls into onboarding when the build is configured but unsigned in to nothing. The auth gate is directly observed, but successful hosted auth was not exercised in this audit. Screen Inventory With Thumbnails Maintain Current-State Journey Audit 6 / 13

    -- 6 of 13 --

    SCREEN ID URL / STATE HOW YOU GET THERE NEXT AVAILABLE CLICKS SCREENSHOT CONFUSION NOTES A01 Configured sign-in gate Launch configured runtime with no session Sign In, Create Account 01_sign-in-gate.png Clean auth-first entry; no main shell leak. Maintain Current-State Journey Audit 7 / 13

    -- 7 of 13 --

    N E W U S E R O N B O A R D I N G C U R R E N T- S TAT E WA L K T H R O U G H New User Onboarding Journey Local-first first run without profile New User Onboarding Last updated: 2026-04-06 10:44 ET (America/New_York) Route Maps New User Setup Flow Launch Without Profile Onboarding Create My Maintenance Profile Main Tab Shell Current-State Findings Maintain Current-State Journey Audit 8 / 13

    -- 8 of 13 --

    Onboarding reflects the maintenance positioning more clearly than earlier generic setup flows. Journey context is captured at setup time, which aligns with the product direction. Screen Inventory With Thumbnails SCREEN ID URL / STATE HOW YOU GET THERE NEXT AVAILABLE CLICKS SCREENSHOT CONFUSION NOTES N01 Maintenance onboarding form Launch with no local profile Create my maintenance profile 02_onboarding.png Captures range width and journey context before the tab shell. Maintain Current-State Journey Audit 9 / 13

    -- 9 of 13 --

    R E T U R N I N G M A I N T E N A N C E U S E R C U R R E N T- S TAT E WA L K T H R O U G H Returning Maintenance User Journey Seeded local-first returning profile Returning Maintenance User Last updated: 2026-04-06 10:44 ET (America/New_York) Route Maps Returning User Main Shell Main Tab Shell Home Log Trends Activity Profile HealthKit States Export States Current-State Findings This branch contains the bulk of current value and should be the center of upcoming execution planning. Profile is the densest current-state support surface because it owns setup editing, HealthKit, and exports. Screen Inventory With Thumbnails Maintain Current-State Journey Audit 10 / 13

    -- 10 of 13 --

    SCREEN ID URL / STATE HOW YOU GET THERE NEXT AVAILABLE CLICKS SCREENSHOT CONFUSION NOTES R01 Home Complete onboarding into the main tab shell Log, Trends, Activity, Profile 03_home.png Carries maintenance status and fluctuation framing. R02 Log Tap Log tab Save schedule, return to other tabs 04_log.png Manual context surface. R03 Trends Tap Trends tab Return to other tabs 05_trends.png Fluctuation comparison surface. Maintain Current-State Journey Audit 11 / 13

    -- 11 of 13 --

    SCREEN ID URL / STATE HOW YOU GET THERE NEXT AVAILABLE CLICKS SCREENSHOT CONFUSION NOTES R04 Activity Tap Activity tab Return to other tabs 06_activity.png Imported workout activity context. R05 Profile connected Tap Profile with connected HealthKit preview Edit maintenance setup, import again, request export 07_profile-healthkit-connected.png Operational hub. R06 Profile disconnected Tap Profile with disconnected HealthKit preview Connect HealthKit, import 08_profile-healthkit-disconnected.png Distinct connection branch. Maintain Current-State Journey Audit 12 / 13

    -- 12 of 13 --

    SCREEN ID URL / STATE HOW YOU GET THERE NEXT AVAILABLE CLICKS SCREENSHOT CONFUSION NOTES R07 Profile export queued Tap Profile with queued export preview Refresh export status 09_profile-export-queued.png Honest waiting state. R08 Profile export ready Tap Profile with ready export preview Open share link, open download link 10_profile-export-ready.png Actionable export state. Maintain Current-State Journey Audit 13 / 13

    -- 13 of 13 --

    Provenance