Shumoul Tenant Signup and First Login Journey — Developer Guide
The authoritative developer guide for the full tenant self-service signup flow: the public reference-data
lookups a signup form calls before submission, registration, account activation, first login, the
first-login onboarding survey, settings recommendation/apply, and the conditions that make the tenant's
dashboard reachable. Written to close a production defect where self-registration failed with
"Shared location reference-data validation is not implemented in this codebase."
Who it's for: Backend Developers · Frontend/Angular Developers (Shumoul.Portal) · QA · DevOps · Future Maintainers
| Field | Value |
|---|---|
| Status | Production Ready (backend) — documents the self-service signup contract for the frontend team |
| Version | Shumoul.Framework.MultiTenancy.Api 1.0.116 |
| Last Updated | 2026-07-19 |
| Maintained By | Shumoul Engineering |
| Documentation | Official Developer Guide |
| Source of Truth | Shumoul Platform Source Code (Shumoul.Saas.MultiTenancyApi, Shumoul.Saas.Api) |
Chapters
| # | Section | File |
|---|---|---|
| 1 | Cover | 01-cover.md |
| 2 | Table of Contents | 02-table-of-contents.md |
| 3 | Overview | 03-overview.md |
| 4 | Frontend Prerequisite APIs | 04-frontend-prerequisite-apis.md |
| 5 | Registration API | 05-registration-api.md |
| 6 | Location Validation — Root Cause and Fix | 06-location-validation.md |
| 7 | Account Activation | 07-account-activation.md |
| 8 | Login | 08-login.md |
| 9 | First-Login Onboarding | 09-first-login-onboarding.md |
| 10 | Settings Recommendation and Apply | 10-settings-recommendation-and-apply.md |
| 11 | Starter Kit Preview/Apply — Boundary | 11-starter-kit-boundary.md |
| 12 | End-to-End Sequence Diagram and Internal Call Map | 12-sequence-diagram-and-call-map.md |
| 13 | Troubleshooting | 13-troubleshooting.md |
| 14 | Operational Boundaries | 14-operational-boundaries.md |