Skip to main content
O domínio de Communication cobre notificações persistidas dentro do produto. Ele permite mostrar avisos em inbox e realtime, controlar leitura por destinatário e manter contexto suficiente para o front abrir a tela correta. Ele não substitui email, WhatsApp ou mensagens transacionais externas. Esses canais continuam no adapter de notificação externa.

Conceitos

Notifications

Criação da notificação, recipients, entrega, leitura e arquivamento.

Data Modelling

Entidades Notification e NotificationRecipient.

Audiências

Se o mesmo evento precisar aparecer em mais de uma superfície, o sistema cria uma notificação por audiência.

Fronteiras

  • Notification guarda conteúdo, contexto, audiência, prioridade e recurso relacionado.
  • NotificationRecipient guarda estado por usuário: entrega, leitura, arquivamento e remoção lógica.
  • Não existe actionUrl persistido. O front resolve a rota pelo tipo e pelo recurso relacionado.
  • Não há companyId, cooperativeId ou transportOperatorId direto na notificação. O escopo vem de organização, audiência, memberships e recurso relacionado.

Exemplos de notificações

Communication registra a notificação in-app. O envio externo por email ou WhatsApp pode acontecer em paralelo, mas não é controlado por NotificationRecipient.