Overview - Documentação DEVMOB

Eventos internos representam fatos já commitados. Handlers usam esses eventos para executar efeitos assíncronos fora do fluxo síncrono.

Envelope

Campo	Descrição
`type`	Nome do evento
`data`	Entidade completa na raiz do payload

Padrão das páginas

Seção	Regra
Detalhes do Evento	Tipo, origem, publicação e quando emite
Handlers	Lista de execuções disparadas pelo evento
Payload	Sempre `data` como entidade raiz
Regras dos handlers	Regras curtas de execução assíncrona
Exemplo	Sempre por último

Regras

Evento é publicado após commit.
Handler não roda na transação do fluxo síncrono.
Falha em handler não desfaz a entidade.
Handler deve ser idempotente.
Um evento pode ter vários handlers.

Eventos

Identity

Evento	Payload
`user.created`	`User`
`user.activated`	`User`
`otp.created`	`OTP`

Observability

Evento	Payload
`audit_log.requested`	Dados completos para criar `AuditLog`

Tenant

Evento	Payload
`invite.created`	`Invite`
`invite.resent`	`Invite`
`invite.accepted`	`Invite`
`invite.rejected`	`Invite`
`invite.revoked`	`Invite`
`membership.created`	`Membership`
`membership.updated`	`Membership`
`membership.revoked`	`Membership`

Operations

Evento	Payload
`route.approval_requested`	`Route`
`route.approved`	`Route`
`route.rejected`	`Route`
`trip.created`	`Trip`
`trip.status_changed`	`Trip`
`trip.event_recorded`	`TripEvent`
`trip.tracking_updated`	`TripTracking`
`trip.tracking_stale_detected`	`Trip`

Fleet

Evento	Payload
`driver.license_expiring`	`Driver`
`driver.license_expired`	`Driver`

Sales

Evento	Payload
`order.confirmed`	`Order`
`order.cancelled`	`Order`
`ticket.issued`	`Ticket`
`ticket.cancelled`	`Ticket`
`ticket.boarded`	`Ticket`

Billing

Evento	Payload
`payment.created`	`Payment`
`payment.updated`	`Payment`
`payment_method.created`	`PaymentMethod`
`order.updated`	`Order`
`receivables.synced`	`Receivable`
`transfer.updated`	`Transfer`
`payment.paid`	`Payment`
`payment.failed`	`Payment`
`payment.overdue`	`Payment`
`payment.refunded`	`Payment`
`payment.chargebacked`	`Payment`
`payment.cash_settlement_linked`	`Payment`
`transfer.paid`	`Transfer`
`transfer.failed`	`Transfer`

Credit Grant

Evento	Payload
`company_credit_account.updated`	`CompanyCreditAccount`
`company_credit_purchase.created`	`CompanyCreditPurchase`
`company_credit_purchase.updated`	`CompanyCreditPurchase`
`credit_grant.created`	`CreditGrant`
`credit_grant.expired`	`CreditGrant`
`credit_grant.used`	`CreditGrant`
`credit_ledger_entry.created`	`CreditLedgerEntry`

Benefits

Evento	Payload
`benefit_request.approved`	`PassengerBenefitRequest`
`benefit_request.rejected`	`PassengerBenefitRequest`
`benefit_request.expired`	`PassengerBenefitRequest`

Communication

Evento	Payload
`notification.created`	`Notification`
`notification.cancelled`	`Notification`
`notification.expired`	`Notification`
`notification_recipient.created`	`NotificationRecipient`
`notification_recipient.marked_as_read`	`NotificationRecipient`
`notification_recipient.archived`	`NotificationRecipient`
`notification_recipient.deleted`	`NotificationRecipient`
`notification_recipient.all_marked_as_read`	Escopo de leitura em massa

Export

Evento	Payload
`export.completed`	`ExportJob`
`export.failed`	`ExportJob`

Support

Evento	Payload
`support_case.created`	`SupportCase`
`support_case.message_created`	`SupportCaseMessage`
`support_case.assigned`	`SupportCase`
`support_case.status_changed`	`SupportCase`