Notification

​

Campos

​

Relacionamentos

• Relaciona-se com Organization, quando a notificação está em escopo organizacional.
• Relaciona-se com User por createdByUserId, quando existe ator de origem.
• Relaciona-se com múltiplos NotificationRecipient.
• Pode referenciar qualquer recurso por resourceDomain, resource e resourceId, sem FK direta.

​

Regras de negócio

• Notification guarda o conteúdo compartilhado entre todos os destinatários.
• O estado por usuário fica em NotificationRecipient.
• O front resolve a rota de abertura pelo type e pelo recurso relacionado; não existe actionUrl.
• companyId, cooperativeId e transportOperatorId não ficam na notificação. O escopo é resolvido por organizationId, audience, memberships e recurso relacionado.
• audience = OPS representa o ambiente operacional usado pela Cooperative.
• Se o mesmo evento precisar aparecer em superfícies diferentes, deve criar uma Notification por audience.
• payload deve conter apenas dados não sensíveis e necessários para renderização.
• status = CANCELED impede novas entregas para destinatários.
• status = EXPIRED indica que a notificação não deve mais aparecer como ativa.
• Remoção lógica não deve apagar recipients já criados.
• Criação, cancelamento e expiração emitem eventos notification.* e solicitam audit_log.requested com resource = NOTIFICATION.

​

Enums

​

NotificationAudience

​

NotificationType

​

NotificationPriority

​

NotificationStatus

​

Example

{
  "notificationId": "0197fa00-3e63-7f58-a878-7ef7ecfa9bc1",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "createdByUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "audience": "OPS",
  "type": "SUPPORT_CASE_MESSAGE_CREATED",
  "priority": "NORMAL",
  "title": "Nova mensagem no chamado SUP-20260704-0001",
  "body": "O passageiro respondeu ao chamado de suporte.",
  "resourceDomain": "SUPPORT",
  "resource": "SUPPORT_CASE",
  "resourceId": "0197f150-40d6-7c1a-bdf2-c5884e07d401",
  "payload": {
    "supportCaseCode": "SUP-20260704-0001"
  },
  "expiresAt": null,
  "status": "ACTIVE",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T16:00:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T16:00:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}