Story: Document the operations journeys
Table of Contents
This page documents a story in Sprint 26. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
1. Goal
Five journeys document the operator's view of a running installation: See the running services, Watch the compute grid, Watch the message bus, Read the telemetry logs, and Check the versions and the database. Four are for a system administrator; the last is for any signed-in user. Each follows the User Journey Extraction Standard, and a clickable prototype on a throwaway branch proves the screens.
2. Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 26 |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-10-04 |
3. Acceptance
- The five journeys are
user_journeydocuments in the operations group, each following the User Journey Extraction Standard and passingcompass lint. - Every operation each journey names is checked against the generated protocol and marked exists, partial or missing; every gap is recorded.
- Every telemetry and super-admin screen of the legacy
ores.qtclient has a disposition: kept, changed or dropped. - A clickable prototype runs on a throwaway branch and is linked from each journey it proves.
4. Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Scaffold story: Document the operations journeys | DONE | 2026-10-04 | 2026-10-04 | Story scaffolding rides this task: documents, sprint wiring, and the scaffold PR. Close it before merging that PR. |
| Write the operations journeys | DONE | 2026-10-04 | 2026-10-04 | Initial task for: Document the operations journeys |
| Prototype the operations journeys | DONE | 2026-10-04 | 2026-10-04 | A clickable prototype of the operations journeys on a throwaway branch: one hand-written route per step, built from the operations the journeys name. |
5. Decisions
- The catalogue of five journeys was agreed with the product owner before any journey document was written, as the standard requires: See the running services, Watch the compute grid, Watch the message bus, Read the telemetry logs, and Check the versions and the database.
- The journeys form a new
operationsgroup. Services and the message bus stay as separate journeys: they answer different questions from different operations. - The versions journey is for any signed-in user; the other four are for a system administrator.
- The legacy
ores.qttelemetry and super-admin inventory lives on theoperationsgroup hub. Every screen read has a disposition: covered by a journey, changed, deferred or dropped. - The database fingerprint has no read operation today; under the accepted design the login answer carries it. The versions journey records the gap, and the prototype settled that the row rides the login answer rather than a read of its own.
- The services screen is a roster: one row per expected instance under its service, and a row never disappears. An instance is running, stopped or missing, in the installation's own words with the shell's existing tones; the instance count warns when a service is short; an older build is prominent, never buried.
- The compute wrappers are the grid screen's. A wrapper runs on a node, so the grid shows it beside the nodes; the services roster shows the installation's services.
- The grid is the installation's, not the tenant's: every tenant's work runs on the same hosts. The tenant filter under the read is a defect, filed as a capture.
- Operations is an area, not tabs: one screen per journey with "Back to operations" navigation, sharing the shell and the footer.
6. Out of scope
- Host, workunit and app management — the pages behind the grid's read-only view. They belong to Extract the ores.compute user journeys.
- The rest of the per-component extraction, which keeps its tasks under Extract the user journeys that replace the ores.qt screens.
- Implementing the journeys in
ores.webfor real. The prototype is a throwaway design record, and the story does not merge it.