The page view

1 · Page header

Name
The page view
Route
/pages/{page_id}
Build status
not answered
Version
not answered
Updated
not answered
Owner
not answered

2 · Represents

Process
Specifying an app with the Mockument method
Step
Walk through one page of the app being specified
Step id
not answered
Device types
not answered

3 · Available to

not answered

4 · Purpose

Shows one page of the app being specified as a mockument: the twenty-two blocks of the specification beside a mock frame the reader can walk. A person opens it to see what a page will do and to find out what is not yet decided about it. They leave knowing which questions are open and who owes each answer.

5 · The mock frame

No mock yet. The frame is rendered from the blocks around it.

6 · Fidelity note

Structure only, example data, nothing here is proof.

7 · Elements

IDElementShowsComes fromStatusTraces to
EL-01Page headerName, route, build status, version, date, owner, the three readiness gates, and the share of elements that are actually requiredthe page recordrequired§15 block 1
EL-02RepresentsThe process and step this page belongs to, and the device types it covers, as links into the app mapthe page recordrequired§15 block 2
EL-03Available toEvery role that may reach the page, what differs between them, and what each must not seethe page recordrequired§15 block 3
EL-04PurposeThree or four sentences: what work this supports, why somebody opens it, what they leave withthe page recordrequired§15 block 4
EL-05The mock frameThe navigable representation, with four controls above it and an inspector that opens when any element is clickedrendered from the blocks around itrequired§15 block 5, §16
EL-06Fidelity noteOne standing line: structure only, example data, nothing here is prooffixed textrequired§15 block 6
EL-07ElementsID, element, what it shows or accepts, where it comes from, status, and what it traces tothe page recordrequired§15 block 7
EL-08Controls and actionsID, control, business effect, whether it needs information only the server holds, where it leads, what confirmation or undo exists, statusthe page recordrequired§15 block 8
EL-09Data and fieldsField, meaning, one value or a list, unit, what it is as of, when a user can see it, where it comes from, how it is calculated and from what, and the sample value used in the mockthe page recordrequired§15 block 9, Part 5
EL-10ListsPer list: order, filtering and grouping, whether items can be selected and what then happens, nesting depth, and per device what appears when the list holds nothing, one item, or more than fitsthe step this page representsrequired§15 block 10
EL-11StatesDefault, empty, one item, more than fits, loading, error, restricted: when each happens, what the person sees, and what they can do nextthe page recordrequired§15 block 11
EL-12What can go wrongDescribed as the person notices it, never as a cause; what should happen; who is toldthe page recordrequired§15 block 12
EL-13Remembered between visitsWhat the app remembers about this person, for how long, and whether they can clear itthe page recordrequired§15 block 13
EL-14Changes while being looked atWhat may update under the person's eyes, how they are told, and what happens if they are mid-actionthe page recordrequired§15 block 14
EL-15ConnectionsWhere a person arrives from, where they can go, and which shared components this page uses, rendered as linksnot answeredunanswered§15 block 15
EL-16WorkflowsThe named pieces of work this page takes part in, and where in each it sitsnot answeredunanswered§15 block 16
EL-17Copy registerEvery user-visible string, each marked required wording or placeholderthe page recordrequired§15 block 17
EL-18DecisionsWhat was decided, by whom, on what datethe page recordrequired§15 block 18
EL-19ObservationsWhat walking through revealed, explicitly not decisions and not requirementsthe page recordrequired§15 block 19
EL-20Open questionsQuestion, why it matters, what it blocks, who must answer, needed bythe page recordrequired§15 block 20
EL-21Out of scopeWhat this page deliberately does not answer, plus the standing list from §13the page recordrequired§15 block 21
EL-22Build contract and machine-readable recordWhat to build, what not to invent, what to ask about first, what done means, and the structured record the checker validatesthe page recordrequired§15 block 22

8 · Controls and actions

IDControlEffectServer onlyLeads toConfirm or undoStatus
CTL-01Device typealters the screenFalsethe same page rendered for the chosen deviceswitch backrequired
CTL-02Rolealters the screenFalsethe same page with elements hidden or revealed per the permissions blockswitch backrequired
CTL-03Statealters the screenFalsethe chosen state's sketch, or a quote of what the specification says should happenswitch backrequired
CTL-04Honesty overlayalters the screenFalseevery element tinted by its statusswitch offrequired
CTL-05Inspectoralters the screenFalsethe clicked element's full record, or a plain statement that it has nonecloserequired

9 · Data and fields

not answered

10 · Lists

Held on the step, not on the page: how a list is ordered, filtered and grouped is business meaning that does not change between devices. Look at the step named in block 2.

11 · States

not answered

12 · What can go wrong

not answered

13 · Remembered between visits

not answered · owed by Vincent

14 · Changes while being looked at

not answered · owed by Vincent

15 · Connections

§15 requires where a person arrives from, where they can go, and which shared components this page uses. §30's schema cannot hold it: page_spec has no property for connections, so no record can carry it and no gate can compute it.

16 · Workflows

§15 requires the named pieces of work this page takes part in, and where in each it sits. §30's schema cannot hold it: page_spec has no property for workflows, so no record can carry it and no gate can compute it.

17 · Copy register

KeyStringStatus
fidelityStructure only, example data, nothing here is proof.required

18 · Decisions

not answered

19 · Observations

Observations are not decisions and not requirements.

not answered

20 · Open questions

IDQuestionWhy it mattersBlocksWho must answerNeeded by
Q-01Who may reach this page, and what differs between them?Gate 2 will not pass without it, and the role control has nothing to switch betweenCTL-02 and gate 2Vincentnot answeredblocks the build
Q-02What does this page show when the app has no pages yet, when a page record fails to load, and when the reader may not see it?Gate 2 requires the empty, error and restricted states, and the state control has nothing to switch betweenCTL-03 and gate 2Vincentnot answeredblocks the build
Q-03What can go wrong here as a reader would notice it, and what should happen?Gate 2 requires it, and it is the block users forget because it does not feel like workgate 2Vincentnot answeredblocks the build
Q-04Which step of the method does this page represent, and what is its id?Gate 1 turns on the page naming the step it representsgate 1Vincentnot answeredblocks the build
Q-05Which device types must this page work on?Section 14 warns that a step becoming twenty-six voice prompts means either the step is too big or voice is the wrong device for itCTL-01Vincentnot answerednot answered
Q-06What does the app remember about a reader between visits, and what may change while they are looking?Gate 3 requires both settled, and section 15 says these are asked directly because they are never volunteeredgate 3Vincentnot answerednot answered
Q-07Where should connections and workflows live, given section 30's schema has no property for either?Two of the twenty-two blocks cannot be recorded, and gate 1's clause that the menu and the workflows navigate cannot be computed without themEL-15, EL-16 and gate 1Vincentnot answeredblocks the build

21 · Out of scope

What this page does not answerWhy
How page records are stored, fetched or cachedSection 22: architecture, storage and integration are untouched by the gates
Final visual design, typography, colour and densitySection 12 puts these out of scope unless the wording is itself a requirement

22 · Build contract

What to build
not answered
What not to invent
not answered
Ask about first
not answered
Done means
not answered