EP-MEL-01 — Tenant Onboarding & Configuration
Companion: Backlog README ·
EPICS.md· canonical:07-epics-and-user-stories.md§3
Summary
| Wave | R1 |
| Priority | P0 |
| Primary owner | tenant-service |
| Participating services | iam-service, property-service, theme-config-service, staff-service, file-storage-service, notification-service |
| Journeys realised | J-13 (Onboard New Tenant — Single Hotel Operator), J-14 (Onboard Chain — Multi-Property Tenant) |
| Workflows | WF-11, WF-12 |
| Frontend surfaces | Owner Portal (Tenant Booking Web subdomain) · Electron Desktop (post-onboarding) · Email + SMS deep links |
| Story count | 12 |
Outcome
A hotel owner self-signs up, creates a tenant, configures a property and rooms, invites staff, customises the brand theme, configures the booking flow, previews the public site, and publishes it. From signup to a guest-bookable site in under 90 minutes with marketing-review gating only the publish step.
Cross-cutting AC for this epic
- All onboarding writes are idempotent; tenant context is established before any property/room write.
- Tenant deletion in trial is reversible for 30 days.
- Theme assets uploaded via
file-storage-servicecarrytenant_idprefix.
Stories
| ID | Title |
|---|---|
| US-MEL-0001 | Owner self-signup with verified email & SMS |
| US-MEL-0002 | Create primary tenant, pin home region, accept ToS |
| US-MEL-0003 | Add the first property with geo, address, amenities |
| US-MEL-0004 | Define room types and individual rooms |
| US-MEL-0005 | Invite staff and assign roles |
| US-MEL-0006 | Customise theme tokens (logo, colours, typography) |
| US-MEL-0007 | Choose layout preset and content blocks |
| US-MEL-0008 | Configure booking-flow rules per tenant |
| US-MEL-0009 | Preview the public booking site as a guest |
| US-MEL-0010 | Submit theme + config for marketing review |
| US-MEL-0011 | Publish to make the site live |
| US-MEL-0012 | Onboarding progress checklist with resume |
Full AC, services, frontend surfaces, DoD refs, test types, and complexity for every story live in
../07-epics-and-user-stories.md§3.
Implementation status (monorepo)
See IMPLEMENTATION_STATUS.md — US-MEL-0001 (owner self-signup) is In progress as of 2026-04-23 (register API + outbox; OTP/tenant/KYC not done).
Cross-references
- Sprint planning:
../roadmap/jira-epic-based-sprint-ruleset.md - Traceability:
../13-traceability-matrix.md - Definition of Done:
../standards/DEFINITION_OF_DONE.md - Journey J-13:
../journeys/01-core-user-journeys.md