coulomb-social/docs/usecases/catalog.md

Use-case catalogue — Bubble off-ramp

This is the working product backlog for finding, describing, rebuilding and transferring use cases. A capability name or exported type does not prove an actual current user workflow. Candidate journeys below derive from the dated Bubble inventory/capability map; no fresh authenticated Bubble observation has been performed in this session. ReichelAg weekly founder calls and personal account recovery are accepted; other transfers remain pending user review. See reichelag-weekly-call.md.

Executable regression protection for established cases: registry.json and the test infrastructure. make check includes required browser journeys; candidate entries below are not all established or protected yet.

Platform communication UC-009–012 and their owner regression gaps are recorded in platform communication. Personal password-reset receipt and sign-in are accepted; shared notification and reply operations remain WP-0015 work. This does not change UC-008's manual email distribution.

Transfer workflow

For every journey: capture a real example and original steps → describe actor, goal, inputs/results and privacy → implement equivalent behavior → rehearse representative data → compare old/new from the user's perspective → record the user's acceptance or gaps → move that use case and monitor it. Record follow-up gaps in live work records before claiming completion. Bubble remains available for journeys not yet accepted; full off-ramp follows their disposition.

Evidence labels: inferred (inventory/package signals), observed (dated actual workflow), confirmed (user validates goal/steps). Implementation and acceptance are separate: tests can prove new behavior, not the original workflow or user acceptance. Do not mark transfer accepted on the strength of tests alone.

First review cohort — candidate journeys

ID	Actor and user goal	Bubble evidence / confidence	Rebuild and remaining gaps	Owner / transfer
CSOC-UC-001	Returning/new member signs in and reaches their work	Login/signup strings and historical identity evidence; original transfer journey inferred	OIDC + registration entry implemented; current cohort onboarding and live Case B need review	WP-0014-T01/T02; pending
CSOC-UC-002	Writer finds an existing space and opens a page to continue work	vw_spaces, vw_pages, space/page fields; inferred; one historical import rehearsal	Space/page navigation and markdown implemented; nominated real content, visuals, missing hierarchy and recognizability need review	WP-0014-T01/T02; WP-0013-T02; pending
CSOC-UC-003	Writer creates and maintains a space/page with Title, Abstractor, Visual and body	Space/page create/edit symbols and captured card UI; inferred	Visuals are live; revisions and stale-edit protection deployed as revision16; revision/retention acceptance pending	WP-0013-T01/T02/T03; pending
CSOC-UC-004	Writer makes an independent copy, or moves a page to another workspace	Copy icons captured; exact Bubble transfer action unresolved	Linked-attachment copy and guarded incoming-address preservation deployed as revision16; actual corpus/custom conventions and original semantics need comparison	WP-0013-T02/T03; pending
CSOC-UC-005	Reader sees shared work; outsider cannot access it; writer remains able to edit	Members/Guests/IsPrivate fields; original privacy rules inferred	Owner-managed same-tenant sharing/revocation, viewer denial and ambiguous-storage guards deployed as revision16; tenancy and original privacy review remain	WP-0013-T01/T03; pending
CSOC-UC-006	Member can take their app-local information with them or leave with a clear content outcome	Platform-contract portability need; Bubble equivalent unknown	Personal JSON export and reviewed exit screen deployed as revision16; shared content retained, successor owner required; productive user acceptance pending	WP-0013-T03; pending
CSOC-UC-007	Member returns after a restart/incident and their work is still there	Continuity requirement, not a captured Bubble action	Persistent storage and actual paired restore are evidenced; offsite custody/retention, monitoring and operational rollback remain	WP-0012-T01/T02/T03; pending
CSOC-UC-008	Prepare the next ReichelAg founder call from the full previous protocol, write the new notes, copy them for manual email distribution	User-confirmed 2026-10-06; exact Bubble UI not freshly observed	Duplication/naming, editing, usual mail-client paste and page/list visuals accepted on revision16; broader custody/cohort gates remain	WP-0008 (closed receipt); accepted 2026-10-08

Concrete scenario specification for the first review

First nomination is ReichelAg weekly calls (UC-008): copy the full previous protocol and edit it by hand. Use its nominated real latest entry. Broader checks below remain additional cohort acceptance criteria.

Use a user-nominated existing space, a representative page with actual Visual and body-linked assets, a second destination space, a writer, a reader and an ungranted same-tenant member. Keep all private names/content/account mappings outside git. Confirm the original paths and whether “page” means a page, chunk or article before import. Until nominated, synthetic examples prove mechanics only and cannot be labelled the real transfer cohort.

For UC-002/003: open the original page, note navigation and what is visible; open its migrated equivalent, compare Title/Abstractor/Visual/body and essential links; edit it, reopen it, and verify the change survives restart. For UC-004: confirm original copy/move semantics; copy into the second space, edit the copy and confirm the source is independent; move another page and verify source removal, destination content and access. For UC-005: reader can open the shared page, sees read-only access and cannot change it by direct requests; outsider gets no content; destination write permission is checked before copy/move. Review the deployed Share space UI on app.coulomb.social; original privacy equivalence remains T04. For UC-006: compare the app-local export and proposed leaving behavior before confirming deletion; platform account handling is explicitly separate. For UC-007: compare the pre-incident content and access with an isolated restore.

Later candidates to discover, not silently discard

Candidate	Evidence and unresolved user question
Research hierarchy / chunks / cards	vw_pages, vw_chunks, parent/chunk/card signals. Which actual workflows require these rather than page bodies?
Find work by search / featured spaces / feed	vw_search, vw_feed, featured labels. Which discovery tasks are actively used?
Invite people and manage membership	Invite/member/guest signals. Who shares with whom, with which permissions and confirmation?
Follow/favorite/interact	Likes/follow/social type signals. Which workflows are used rather than abandoned UI?
Work tracking / ventures / challenges	Tasklet/venture/challenge types. Capture a real complete journey before choosing its rebuild form.
Marketplace and payments	Marketing and checkout symbols. Confirm whether there is any active end-to-end use before prioritizing.

Historical source: docs/capability/existing-bubble-capability-map.md, docs/bubble-inventory/2026-08-12-surface-inventory.md, migration rehearsal and accepted stage-1 cut. Unknowns remain open; this catalogue does not change that cut or claim full parity.

Current ownership after original-workplan closure

CSOC-WP-0008 and CSOC-WP-0010 are finished. Historical task references above identify implementation provenance. Remaining acceptance is owned by:

• WP-0012: durable recovery and service evidence (UC-007).
• WP-0013: content/storage hardening and sharing/portability review (UC-003–006).
• WP-0014: further cohort/original-journey reconciliation and explicit cutover (UC-001–007 and later candidates).
• WP-0015: communication runtime, operations and further flow acceptance (UC-009–012).

UC-008 weekly calls and UC-009 personal recovery retain their dated acceptance.