evidence · 3.9 KiB

flow-matrix.md

Committed at docs/research/handheld-ux/flow-matrix.md. This is what grounds the requirements that cite it.

Open raw source

Handheld journey and flow matrix

FlowUser goalStart / visible stateActionExpected visible resultEscape / recoveryAccessibility checkOwnerDependencyEvidence classCitationOpen gate
First useKnow the device is progressing to a usable shellBoot splash then shellWait for handoffPersistent controls and a usable first app route appearSerial capture/recovery image if boot failsCamera must distinguish panel visibility from timestamped boot durationsplash/initial sceneboot-splash changecamera, nativedocs/evidence/splash-initial-scene-ready/video-audit.mdCold USB-powered first boot and optical continuity are UNVERIFIED.
DiscoveryOpen or resume an appPersistent Apps controlTap Apps, then a catalog/built-in cardNamed card and page count are visible; app launches or existing app focusesBack returns to work; failed optional launch keeps controlsLarge labels; page actions remain visiblelauncher/catalogshell runtimenative, injecteddocs/evidence/offline-wifi-image/README.mdNew catalog entries need real-finger/readability review.
Repeat useReturn to a running appAny eligible appApps then Terminal, or Windows then cardApp is focused and launcher yieldsHome opens/focuses Terminal; Back closes launcherEvery gesture has a visible bar/button routegesture overview; card lifecycletouch-launcher-gestures-overview; app-card planreal-finger, injecteddocs/evidence/shell-real-touch-apps/README.mdOrdering and stale-card guard need their named physical gate.
Keyboard-visibleEnter text without losing orientationFocused app, keyboard hiddenKeyboard then typeKeyboard occupies lower area; remaining launcher routes stay reachableKeyboard control hides it; Back/Home remain availableAsymmetric sequence and camera visibility are separate checksshell keyboardshell runtimereal-finger, nativedocs/evidence/shell-real-touch-keyboard/README.mdFull directional-drag and uniform sharpness are UNVERIFIED.
Window overviewSwitch windowsApps or Windows controlOpen overview, select cardCurrent windows are named as cards; selection returns to chosen appBack/down return to Apps; empty/stale/loading shows recoverable statusCard and fallback targets remain reachablegesture overviewwindow catalog helperinjected, real-fingerdocs/evidence/launcher-gestures/real-finger/README.mdEmpty/stale physical acceptance remains UNVERIFIED.
VideoStop media or return homePlaying videoStop, Home, or let EOF occurController/player cleanup then shell recoveryPersistent Apps/Home path remainsStatus must state ending/failure rather than silently strand the usernetwork-videovideo session controllerinjecteddocs/evidence/network-video/installed-controls/README.mdNetwork error and physical playback review remain UNVERIFIED.
SystemAvoid accidental shutdown and recover after rebootSystem menuPick action; cancel or confirmAction-specific confirmation; cancel returns; confirmed reboot returns to shellCancel, serial recovery, known-good imageConfirmation wording and targets must be readableshell system controlsNixOS service policycamera, real-finger, serialdocs/evidence/shell-real-touch-system/README.mdCold USB-powered power-on timing is UNVERIFIED.
Card shellManage live applications directlyArbitrary eligible running appGlobal entry, shrink/drag/deck/tap/throwLive card content follows finger and returns/focuses or refuses close visiblyButton entry, Back/Home, refusal recoveryDirect manipulation and reduced motion preserve core sequencecard-composition; app-card planarchitecture decisionUNVERIFIEDUNVERIFIEDImplementation and all physical proof remain UNVERIFIED.