Tenant Status Lifecycle

public enum TenantStatus {
    PENDING,            // Created but not provisioned
    PROVISIONING,       // Provisioning in progress
    ACTIVE,             // Fully provisioned and active
    UPGRADING,          // Tier upgrade in progress
    SUSPENDED,          // Temporarily suspended
    PENDING_DELETION,   // Marked for deletion, in grace period
    FAILED,             // Provisioning failed
    DELETED             // Soft deleted
}

PENDING --> PROVISIONING --> ACTIVE --> SUSPENDED --> ACTIVE
                |                |                      |
                v                v                      v
              FAILED       UPGRADING --> ACTIVE      DELETED
                |                |
                v                v
           (retry) -->     FAILED
           PROVISIONING

curl -X POST http://localhost:8082/api/v1/tenants/{id}/suspend?reason=non-payment \
  -H "Authorization: Bearer $TOKEN"

public TenantResponse suspendTenant(UUID id, String reason) {
    Tenant tenant = findTenantById(id);
    if (tenant.getStatus() != TenantStatus.ACTIVE) {
        throw new TenantProvisioningException("Can only suspend active tenants");
    }
    tenant.setStatus(TenantStatus.SUSPENDED);
    tenant = tenantRepository.save(tenant);
    return tenantMapper.toResponse(tenant);
}

curl -X POST http://localhost:8082/api/v1/tenants/{id}/activate \
  -H "Authorization: Bearer $TOKEN"

curl -X DELETE http://localhost:8082/api/v1/tenants/{id} \
  -H "Authorization: Bearer $TOKEN"

public void markAsDeleted() {
    this.deleted = true;
    this.deletedAt = Instant.now();
    this.status = TenantStatus.DELETED;
}

// Trial management
public boolean isTrialActive() {
    return Boolean.TRUE.equals(isTrial)
        && trialExpiresAt != null
        && Instant.now().isBefore(trialExpiresAt)
        && status == TenantStatus.ACTIVE;
}
 
// Playground management
public boolean isPlaygroundActive() {
    return Boolean.TRUE.equals(isPlayground)
        && playgroundExpiresAt != null
        && Instant.now().isBefore(playgroundExpiresAt)
        && status == TenantStatus.ACTIVE;
}