08 - Events, Jobs, Listeners, Notifications, Observers

Dokumen ini memetakan asynchronous/event-driven parts yang aktif sekarang.

Event Discovery

Event listener didaftarkan via auto-discovery:

bootstrap/app.php -> withEvents(discover: [app/Listeners])

Tidak perlu Event::listen(...) manual di service provider untuk listener yang sudah ada di folder listeners.

Event Lifecycle Overview

Events

app/Events/TenantCreated.php

app/Events/TenantOnboardingCompleted.php

app/Events/PasswordResetRequested.php

app/Events/TokenCreated.php

app/Events/TokenUsed.php

app/Events/TokenRevoked.php

Listeners (Central)

app/Listeners/Central/Auth/RegisterGoogleSocialiteProvider.php

app/Listeners/Central/Auth/AuthActivitySubscriber.php

app/Listeners/Central/Tenancy/ProvisionDefaultSubscriptionForTenant.php

app/Listeners/Central/Tenancy/ProvisionDefaultTaxonomiesForTenant.php

Jobs (Central)

app/Jobs/Central/Auth/ProcessUserRegistration.php

app/Jobs/Central/Auth/LogAuthActivity.php

Provisioning Sequence (Tenant Created)

Tenant Provisioning Extension Point

Registrasi provisioner di config/tenancy.php key provisioning.provisioners.

Orchestrator memvalidasi:

implementasi TenantProvisioner

code() unik

class valid/resolvable

Re-run manual per tenant:

php artisan tenant:provision {tenant_uuid}

php artisan tenant:provision {tenant_uuid} --only=taxonomy

Notifications (Central)

app/Notifications/Central/Auth/SuspiciousAuthActivityDetected.php

app/Notifications/Central/Billing/BillingOperationalAlertNotification.php

app/Notifications/Central/Billing/SubscriptionDunningStatusNotification.php

app/Notifications/Central/Security/SecurityOperationalAlertNotification.php

app/Notifications/Central/Tenancy/ClusterCapacityWarningNotification.php

Mail

app/Mail/Central/Auth/WelcomeMail.php

app/Mail/Shared/TestMail.php

Observers

Tenant master data observer:

app/Observers/Tenant/MasterData/TaxonomyObserver.php

Gunakan observer untuk constraint domain lokal model (slug normalize, parent validation, dsb), bukan untuk orchestration lintas domain besar.

Observer Role Boundary

Observer cocok untuk:

normalize value (slug, name)

validasi parent-child lokal model

default value lokal model

Observer tidak cocok untuk:

provisioning lintas DB besar

orchestration multi domain/event chain

08 - Events, Jobs, Listeners, Notifications, Observers

Event Discovery#

Event Lifecycle Overview#

Events#

Listeners (Central)#

Jobs (Central)#

Provisioning Sequence (Tenant Created)#

Tenant Provisioning Extension Point#

Notifications (Central)#

Mail#

Observers#

Observer Role Boundary#