User Stories

Per-flow stories with persona, preconditions, happy path, alternates, edge cases, acceptance criteria, drawbacks, and open questions. Each story cites the implementing surfaces and links back to ../03-Domains for status.

Stories

#	Story	Persona	Status
01	01-Invoicing	Merchant	🟢 shipped
02	02-QR-Receive	Any user	🟢 shipped
03	03-Send-Payment	Any user	🟢 shipped
04	04-Admin-Fees	Admin / ops	🟢 shipped
05	05-Mercuryo-Buy-Sell-Convert	Any user	🟡 mocked, Mercuryo cutover Beta
06	06-Merchant-API-QR-Payments	Merchant + customer	🟡 partial — webhook + per-currency toggle gaps

Story template

Each story follows the same shape:

• Persona — who is acting
• Goal — what they want, in their words
• Preconditions — what must be true before the flow starts
• Happy path — numbered steps (UI + system side)
• Alternate flows — supported deviations that still succeed
• Edge cases & failure modes — what can go wrong and how the system reacts
• Acceptance criteria — testable bullets
• Out of scope — explicit non-goals
• Drawbacks — pointer into ../08-Risks and Drawbacks
• Open questions — pointer into ../09-Open Questions
• Implementing surfaces — files (app/..., lib/...) that realize the flow

Related

• Vault index: ../README
• Domain catalogue: ../03-Domains
• Provider matrix: ../05-External Providers