Story: Write the trade journeys

Table of Contents

This page documents a story in Sprint 27. It captures the goal, current status, acceptance criteria, and the tasks that compose it.

1. Goal

The trade journeys exist as use cases under doc/knowledge/journeys/trades/. Each names the actor, the goal, the operations it reaches and what is missing. A later story builds prototypes that serve them as entity pages under the UX standards.

2. Status

Field Value
State DONE
Parent sprint Sprint 27
Now Nothing.
Waiting on Nothing.
Next Nothing.
Last touched 2026-10-11

3. Acceptance

  • The inventory table lists every trade operation with its actor and NATS subject.
  • Every legacy Qt trade action has a disposition: kept, changed or dropped.
  • Seven journey documents exist under doc/knowledge/journeys/trades/ with coverage tables. They draw no wireframes: a journey is a use case, and the prototype story draws the screens from the UX standards.
  • The trade group is on the journeys index and its subjects are checked against the protocol headers.

4. Tasks

Task State Start End Description
Scaffold story: Write the trade journeys DONE 2026-10-11 2026-10-11 Story scaffolding rides this task: documents, sprint wiring, and the scaffold PR. Close it before merging that PR.
Inventory the trade operations and the legacy Qt trade screens DONE 2026-10-11 2026-10-11 Initial task for: Write the trade journeys

5. Decisions

  • A journey is a use case and names no screen. The screens come from the UX standards, and a trade is an entity, so one trade page serves most journeys.
  • The journeys draw no wireframes. The prototype story draws the screens.
  • The Qt lifecycle event window maintained a lookup. A per-trade event is a trade activity, so the lifecycle journey records an activity.
  • An amendment is a booked activity, not a bare write to the trade.
  • The reading found gaps that block every screen. They are listed on the hub page and for the owner to plan: no web trading route, a trade list that filters only by id, child tables with no by-trade read, no write of an activity with its versions, and the two digest gaps.

6. Out of scope

  • The prototypes. They are the next story and follow the UX standards, including the older trade-entry prototype under the books group.
  • Fixing any gap the journeys list.

Emacs 29.3 (Org mode 9.6.15)