Tenant Operational Defaults — Developer Guide
Converts the old, one-time, SeedsHistory-gated tenant seed data into a modern, gate-free, entitlement-aware
provisioning mechanism for the operational records (default warehouse, cash box, bank account, sales
invoice template) a tenant needs so first-login onboarding can reference real IDs — closing the
WarehouseId/CashAccountId/SalesInvoiceTemplateId onboarding warnings for entitled tenants.
Who it's for: Backend Developers · SaaS Platform Engineers · QA · Future Maintainers
| Field | Value |
|---|---|
| Status | Production Ready (backend) |
| Version | Shumoul.Framework.MultiTenancy.Api 1.0.123 |
| Last Updated | 2026-07-20 |
| 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 | Root Cause & Architecture Decision | 03-architecture-and-decisions.md |
| 4 | Defaults Catalog | 04-defaults-catalog.md |
| 5 | Cash / Bank / Account Logic | 05-cash-bank-account-logic.md |
| 6 | API Reference — Preview / Apply / Internal Endpoint | 06-api-reference.md |
| 7 | Onboarding Integration & Warning Behavior | 07-onboarding-integration-and-warnings.md |
| 8 | Reference Data De-gating | 08-reference-data-degating.md |
| 9 | Testing & Live Verification | 09-testing-and-verification.md |
| 10 | Production Deployment & Troubleshooting | 10-production-deployment.md |
| 11 | Cash/Bank GL-Currency Linking | 11-cash-bank-gl-currency-linking.md |
Related guides
- Business Onboarding & Smart Configuration — the onboarding survey/recommendation/apply flow this phase feeds into, and Chapter 21 for the sibling Onboarding Apply Bridge this phase's own bridge mirrors.
- Tenant Signup and First Login Journey
- Tenant Starter Kit & Product Catalog — this
service is now ALSO composed directly into
TenantStarterKitServiceas its ownTenantOperationalDefaultsstep (see that guide's Chapter 9), in addition to its original automatic in-process call from onboarding apply — two call sites, same service, same entitlement/idempotency behavior either way. The Starter Kit itself remains root-admin-only. - Subscription Packages & Entitlements — the
SubscriptionFeatureentitlement mechanism this phase's per-kind filtering uses directly.