Skip to main content

Tenant Lifecycle

Summary​

Source confirms creation, validation, provisioning, activation, configuration, deactivation, suspension, restoration, and soft deletion controls. It does not establish a physical purge or archival workflow.

Audience​

  • Platform and customer administrators
  • Implementation and support teams
  • Developers and solution architects

Purpose​

This lifecycle separates the tenant’s administrative status from its provisioning request status, subscription status, and license status.

Architecture​

The state diagram combines confirmed administrative and provisioning transitions conceptually; source does not enforce this exact single state machine.

Business concepts​

  • Creation and validation — Implemented: identifiers and selected onboarding inputs can be checked for validity and conflicts.
  • Provisioning — Implemented: a request records stage, progress, completed work, failure state, and retry information.
  • Activation and operational state — Implemented: tenant records can be active and updated with company, branding, settings, module, feature, and configuration metadata.
  • Deactivation, suspension, and restoration — Implemented: dedicated administrative actions change tenant status and produce audit/timeline records.
  • Soft deletion — Implemented: deletion changes the record to a soft-deleted status; it is not confirmed as physical data removal.
  • Archival or purge — Requires confirmation: no approved archival or irreversible deletion workflow was confirmed in reviewed source.

Technical implementation​

Administrative transitions update tenant status. Provisioning has its own Pending, Running, Completed, and Failed request states. Subscription and license evaluators maintain separate commercial/access states; consumers must not infer one state solely from another.

Source References​

  • microservices/src/platform-service/Api/PlatformAdminEndpoints.cs
  • microservices/src/platform-service/Api/PlatformTenantOnboardingEndpoints.cs
  • microservices/src/platform-service/Application/TenantProvisioningOrchestrator.cs
  • microservices/src/platform-service/Domain/Entities/ProvisioningRequest.cs
  • microservices/src/platform-service/Domain/Entities/ProvisioningStatus.cs

See Also​

Keywords​

  • Tenant lifecycle
  • Provisioning status
  • Suspension
  • Soft deletion

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-14
  • Review cycle: Quarterly