Skip to main content

Use Case Proposals (sidecar)

This folder holds [SME-PROPOSED] changes to the use-case registry at ../../../platform-registry/_data/use-cases/. Each file mirrors a target UC name + -SME-PROPOSED suffix.

Workflow:

  1. Pilot/reconciliation work proposes changes here (does not modify the live _data/use-cases/ files).
  2. Operator reviews the proposal, accepts or rejects.
  3. On accept, operator merges the proposed YAML into the live file and deletes the sidecar.
  4. On reject, operator deletes the sidecar.

The pilot (2026-05-24, BF-001 Tenant + Property Onboarding) lands a starter set covering the Tenant + Property Onboarding flow.

File classes​

There are two classes of sidecar in this folder:

ClassNamingMeans
Existing-UC sidecaruc-<name>-SME-PROPOSED.yaml where _data/use-cases/uc-<name>.yaml existsOperator should merge the proposed delta into the existing file.
NEW UC proposaluc-<name>-SME-PROPOSED.yaml where _data/use-cases/uc-<name>.yaml does NOT existOperator should create a new file _data/use-cases/uc-<name>.yaml (sans the -SME-PROPOSED suffix) populated from the sidecar.

Every file's header comments state which class it is and which drift ID (BF-001 D-NNN / EP-NNN-rtm.md D-NNN) it closes.

Pilot 2026-05-24 contents​

Pilot lands 2 existing-UC sidecars + 5 NEW UC proposals, plus this README. NEW proposals close the 5 BF-001 catalog gaps surfaced in §Drift summary of ../business-flows/BF-001-tenant-property-onboarding.md.

FileClassCloses
uc-onboarding-admin-role-SME-PROPOSED.yamlexistingEP-001 D-008, BF-001 D-002 (catalog 9-roles vs code 11-roles)
uc-tenant-onboarding-saga-SME-PROPOSED.yamlexistingBF-001 D-003 (saga still treats seedPropertyDefaults as stub)
uc-tenant-signup-SME-PROPOSED.yamlNEWBF-001 Step 1 / Step 2 catalog gap (no US-001-NEW-SIGNUP)
uc-email-verification-landing-SME-PROPOSED.yamlNEWBF-001 Step 2 catalog gap (AP-T01-003 / W3.E.7)
uc-gst-tax-configuration-SME-PROPOSED.yamlNEWBF-001 D-005 (AP-T02-005 shipped but no US-002-NNN row)
uc-booking-engine-branding-SME-PROPOSED.yamlNEWBF-001 D-005 (PATCH /properties/:id/theme shipped but no US-002-NNN row)
uc-onboarding-wizard-state-SME-PROPOSED.yamlNEWBF-001 Step 14 catalog gap (US-002-009 partial; wizard saga has no UC)