# 2026-04-17 - Avisos internos via painel com banner, modal e histórico

## O que mudou
- Expandida a central em `pages/admin/notificacoes.php` com um compositor de avisos manuais para `admins`, `devs` ou ambos, incluindo tom visual, link opcional, validade e escolha de exibição por `toast`, `banner`, `modal` e `push`.
- Criada a migration `sql/2026-04-17-create-app-notification-broadcasts.sql` para registrar os disparos de aviso com metadados de público, canais, validade, contagem de destinatários e auditoria do emissor.
- Adicionado o repositório `src/Modules/Notifications/AnnouncementBroadcastRepository.php` para persistir e listar o histórico operacional dos avisos enviados pelo painel.
- Evoluído `src/Modules/Notifications/Http/NotificationsController.php` com:
  - novo tipo `manual_team_announcement` persistido no catálogo;
  - endpoint `announcementBroadcast` com gravação do broadcast, resolução de destinatários e disparo das notificações;
  - endpoint `announcementList` para alimentar histórico e auditoria no admin.
- Atualizado `scripts/notifications-center.js` para enviar avisos com mais opções, recarregar histórico recente e permitir reaproveitar um aviso anterior como base para um novo disparo.
- Atualizado `scripts/notifications-announcements.js` para:
  - renderizar banner logo abaixo do header compartilhado;
  - respeitar validade do aviso;
  - abrir modal de aviso quando configurado;
  - permitir marcar o aviso como lido a partir da experiência global.
- Ligado o host global de avisos nos templates compartilhados:
  - `includes/template/body-start.php`
  - `pages/cliente/includes/template/body-start.php`
  - `pages/parceiro/includes/template/body-start.php`
- Refinada a topbar em `includes/template/matdash/topbar-notifications.php` para tratar avisos manuais com ícone próprio e posicionamento coerente dos toasts.

## Resultado
- o time passa a conseguir disparar avisos internos direto do painel sem depender apenas de WhatsApp
- os avisos agora podem aparecer como balão, banner fixado abaixo do breadcrumb/header e modal de atenção
- o admin ganha trilha de auditoria dos avisos enviados, com público, emissor e volume realmente entregue

## Observações
- a exibição global continua usando a leitura individual da notificação, então `Entendi` remove o banner/modal apenas para quem marcou como lido
- o histórico do broadcast fica separado das notificações individuais, o que facilita evoluir para relatórios, reenvio e filtros futuros
- nesta etapa o fluxo prioriza o ambiente `adm`, que é onde estão os colaboradores e devs mencionados na demanda

## Validação
- `php -l src/Modules/Notifications/AnnouncementBroadcastRepository.php`
- `php -l src/Modules/Notifications/Http/NotificationsController.php`
- `php -l src/Modules/Notifications/NotificationTypes.php`
- `php -l pages/admin/notificacoes.php`
- `php -l includes/template/body-start.php`
- `php -l pages/cliente/includes/template/body-start.php`
- `php -l pages/parceiro/includes/template/body-start.php`
- `node --check scripts/notifications-center.js`
- `node --check scripts/notifications-announcements.js`