20 - Billing and Provisioning Business Flows

Dokumen ini merangkum flow bisnis billing lifecycle dan tenant provisioning.

A. Billing Lifecycle

Semua provisioning tenant melewati satu pintu: TenantProvisioningOrchestrator.

Daftar provisioner diregister di config/tenancy.php pada key provisioning.provisioners.

Setiap provisioner wajib implement TenantProvisioner dan return ProvisioningResult.

Guardrail orchestrator:

class harus implement kontrak TenantProvisioner

code() tidak boleh kosong

code() tidak boleh duplikat

Untuk recovery/backfill tenant tertentu:

Jika menggunakan Sail:

Renewal generation: GenerateSubscriptionRenewalInvoicesCommand

Dunning enforcement: EnforceBillingDunningPolicyCommand

Reconciliation report: GenerateBillingReconciliationReportCommand

Provisioning re-run: ProvisionTenantCommand

state transition tested

webhook idempotency validated

provisioning listener error path logged

retry policy documented and observable

queue worker untuk listener provisioning aktif (bukan sync)