# 2026-04-17 - Confirmacao de leitura dos avisos internos

## O que mudou
- Criada a migration `sql/2026-04-17-create-app-notification-ack-logs.sql` para persistir confirmacoes explicitas de leitura dos avisos internos por notificacao, broadcast, usuario e origem da acao.
- Adicionado o repositorio `src/Modules/Notifications/AnnouncementAcknowledgementRepository.php` para gravar e consolidar logs de `acknowledged`.
- Expandido `src/Modules/Notifications/Http/NotificationsController.php` para:
  - registrar confirmacao quando um aviso manual for marcado como lido;
  - capturar a origem da confirmacao via `ack_source`;
  - registrar confirmacoes tambem em `markAllRead` e `bulkAction` quando a acao for leitura;
  - enriquecer o historico de broadcasts com `ack_count`.
- Estendido `src/Modules/Notifications/NotificationRepository.php` com consulta dedicada aos avisos manuais ainda nao lidos, permitindo registrar somente os itens realmente confirmados na acao atual.
- Atualizado `scripts/notifications-announcements.js` para enviar a origem da confirmacao quando o usuario clica em `Entendi` no banner ou confirma leitura pelo modal.
- Atualizado `scripts/notifications-center.js` para enviar `ack_source` ao marcar leitura individual, em lote ou em `Marcar todas`.

## Resultado
- o clique em `Entendi` agora deixa uma trilha auditavel de que o usuario confirmou o aviso
- o historico dos avisos passa a mostrar nao apenas quantos destinatarios existiam, mas tambem quantos realmente confirmaram leitura
- a confirmacao fica distinguida por origem, o que ajuda a entender se o aviso foi reconhecido via banner, modal ou inbox

## Observacoes
- a confirmacao explicita e separada do `is_read/read_at`, porque leitura tecnica e aceite consciente do aviso nao sao exatamente a mesma coisa
- o log usa chave unica por notificacao + usuario + acao, evitando duplicidade quando a mesma pessoa repetir a confirmacao

## Validacao
- `php -l src/Modules/Notifications/AnnouncementAcknowledgementRepository.php`
- `php -l src/Modules/Notifications/NotificationRepository.php`
- `php -l src/Modules/Notifications/Http/NotificationsController.php`
- `node --check scripts/notifications-center.js`
- `node --check scripts/notifications-announcements.js`