> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Notificações persistidas para inbox e realtime dentro do produto.

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

<CardGroup cols={2}>
  <Card title="Notifications" icon="bell" href="/domain/communication/notifications">
    Criação da notificação, recipients, entrega, leitura e arquivamento.
  </Card>

  <Card title="Data Modelling" icon="database" href="/data-modelling/communication/notification">
    Entidades Notification e NotificationRecipient.
  </Card>
</CardGroup>

## Audiências

| Audiência  | Superfície                                            |
| ---------- | ----------------------------------------------------- |
| `CUSTOMER` | App ou superfície do passageiro.                      |
| `DRIVER`   | App ou superfície do motorista.                       |
| `OPS`      | Ambiente operacional usado por Company e Cooperative. |
| `BKO`      | BackOffice interno da plataforma.                     |

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` ou `cooperativeId` direto na notificação. O escopo vem de organização, audiência, memberships e recurso relacionado.

## Exemplos de notificações

| Tipo                           | Quem recebe                                    |
| ------------------------------ | ---------------------------------------------- |
| Chamado criado                 | Atendentes OPS ou BackOffice, conforme escopo. |
| Nova mensagem em chamado       | Participantes do chamado.                      |
| Rota aguardando aprovação      | Usuários OPS com permissão de aprovar.         |
| Pagamento confirmado ou falhou | Passageiro ou operador envolvido no Order.     |
| Exportação concluída ou falhou | Usuário que solicitou a exportação.            |

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