← The board

N28 Finding your way

Area
N — Companion
Audience
operator
Kind
feature
Status
accepted
Maturity
built
Labels
mobile, ux
Requires
N1N2N27
Relates to
N3N4N25N29G2G3

The feature in the specification · Read at

Requirements

  1. N28-R1acceptedMUST

    Every operator screen about a stack MUST have a top bar holding a control that opens the menu and the stack's name.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/household/src/Internal/Screens/FindsItsWayAroundTheHouse.phpapp-modules/operator/src/Internal/Screens/FindsItsWayAround.phptests/Arch/EveryScreenAboutAStackHasTheMenuTest.php
  2. N28-R2acceptedMUST

    The stack's name in the top bar MUST open the list of stacks, each with its glyph and a short word for how it stands and the current one marked, and the list MUST offer adding a stack.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/wayfinding/src/Api/Screens/ChoosesAStack.php
  3. N28-R3acceptedMUST

    Choosing a stack from that list MUST open it on the tab the operator last used for it (N27-R16).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/kernel/src/Api/WhereTheOperatorWas.phptests/Feature/OpeningWhereTheOperatorLeftOffTest.php
  4. N28-R4acceptedMUST

    The bottom bar MUST hold exactly four tabs — Health, Services, Updates and Repairs — and MUST mark as current only the tab whose screen is on view, or the tab the screen on view belongs to; what one service is doing and its log belong to Services.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companiontests/Feature/OpeningTheMenuTest.phptests/Feature/MarkingTheTabsTest.php
  5. N28-R5acceptedMUST

    Every operator screen about a stack that is not one of the four tabs, a screen belonging to one of them (N28-R4), one step of something begun on another screen, or a screen detailing one thing another screen shows MUST be reachable from the menu in the groups this page names, and MUST NOT be reached only from another screen's body. The menu's Household group MUST also hold View as member, which opens the member's application as N2-R25 describes.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companiontests/Arch/EveryScreenOfAStackIsInTheMenuTest.php
  6. N28-R6acceptedMUST

    The menu MUST begin with the current stack and What's new with its count, and MUST end with the stack's settings and App settings. Where the phone holds no session for the current stack, What's new MUST NOT be offered: there is nothing on the stack it can read.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/operator/src/Internal/HoldsItsStacksStream.phpapp-modules/news/src/Api/HowMuchIsNew.phpapp-modules/news/tests/Api/NoticingTest.phpapp-modules/news/tests/Internal/WhatEachStackLastNamedTest.php
  7. N28-R7acceptedMUST

    Every menu item MUST carry an icon and a label, and the icon MUST NOT stand in for the label (N4-R21).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/wayfinding/tests/Internal/TheMenuTest.php
  8. N28-R8acceptedMUST

    The health screen MUST show how the stack stands and what is wrong, MUST offer What's new first where anything is new, and MUST NOT list the menu's items.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/operator/src/Internal/Screens/HowThisStackIs.phpapp-modules/operator/resources/views/how-this-stack-is.blade.phptests/Feature/HearingHowAStackIsTest.phptests/Feature/CountingWhatIsNewTest.php
  9. N28-R9acceptedMUST

    A tab, a menu item, a button and a section heading MUST name what it opens or does in at most three words, and MUST NOT be a sentence; a sentence MAY explain beside it (G2-R15).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companiontests/Arch/EveryWayAroundIsAFewWordsTest.php
  10. N28-R10acceptedMUST

    A screen the connected stack does not offer MUST keep its menu item, and opening it MUST say what would provide it (N1-R30); a screen this version of the app does not have yet MUST keep its menu item too, and opening it MUST say so.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/wayfinding/src/Internal/TheRowsOfTheMenu.phptests/Feature/OpeningTheMenuTest.phptests/Feature/AskingAStackWhatItOffersTest.php
  11. N28-R11acceptedMUST

    With no stack paired there MUST be no menu, top-bar switcher or bottom bar (N1-R35), and while the app is locked none of them MUST be drawn (N4-R24). Signing in to a stack MUST show the switcher and the menu, and MUST NOT show the bottom bar; once the session is known to be a member's, the member MUST be taken straight to Home, and no menu MUST be drawn for them (N3-R19).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companiontests/Feature/GoingBackFromAScreenWithoutAStackTest.phptests/Feature/NothingIsDrawnBehindTheLockTest.phptests/Feature/SigningIntoAStackTest.phptests/Arch/EveryScreenAboutAStackHasTheMenuTest.php
  12. N28-R12acceptedMUST

    Labels MUST wrap rather than be cut off at the phone's text size, and a shortened stack name MUST be read whole to a screen reader (N4-R14).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/wayfinding/resources/views/components/stack-opens.blade.phpapp-modules/kernel/src/Api/StackName.phptests/Templates/ThePlatformOwnsAccessibilityTest.php
  13. N28-R13acceptedMUST

    A screen opened over another MUST offer the platform's own way back: its back control and, on iOS, the edge swipe. A screen with nothing beneath it MUST NOT offer one.

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/operator/src/Internal/HasAWayBack.phpapp-modules/wayfinding/src/Api/Screens/FindsItsWayAroundAStack.phptests/Feature/GoingBackFromAScreenAboutAStackTest.phptests/Feature/GoingBackFromAScreenWithoutAStackTest.php
  14. N28-R14acceptedMUST

    Every screen of the member's application opened as a preview (N2-R25) MUST carry, in the mark that says it is a preview, a control that returns to the operator's screen it was opened from, as well as the platform's own way back (N28-R13).

    locked by
    no version locks it yet
    recorded done
    lemonfiber-companionapp-modules/household/src/Internal/Screens/WhatAMemberWouldSee.phpapp-modules/household/src/View/Components/ThePreviewMark.phptests/Feature/PreviewingTheMembersSideTest.php