{"v":{"area":"admin","slug":"notificacoes","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/notificacoes.md","relative_path":"docs/readme/admin/notificacoes.md","title":"Central de Notificacoes","html":"<h1>Central de Notificacoes</h1><h2>Rota</h2><ul><li><code>/adm/notificacoes</code></li></ul><h2>O que e</h2><p>Central administrativa para operar inbox, preferencias, entregas por canal, analytics e avisos internos do painel.</p><h2>Para que serve</h2><ul><li>acompanhar notificacoes recebidas pelo usuario atual;</li><li>marcar itens como lidos, nao lidos ou remover registros da inbox;</li><li>revisar payload e canais usados em cada notificacao;</li><li>configurar preferencias por tipo e por canal;</li><li>acompanhar saude de entrega de <code>inapp</code>, <code>email</code>, <code>whatsapp</code>, <code>sms</code> e <code>push</code>;</li><li>disparar avisos internos para admins, devs ou ambos, com controle de banner, modal, toast e push;</li><li>auditar quem confirmou leitura e quem ainda esta pendente em cada aviso interno.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com contexto da central operacional;</li><li>KPIs gerais do inbox, volume, falhas e tipos ativos;</li><li>card de <code>Push Web</code> para habilitar e testar FCM no navegador atual;</li><li>card de <code>Aviso manual</code> com composicao do comunicado interno;</li><li>KPIs dos avisos internos com ativos, urgentes, pendencias e taxa de leitura;</li><li>historico recente de avisos com filtros, reaproveitamento e auditoria de confirmacoes;</li><li>aba <code>Inbox</code> com filtros, lista, selecao em lote e detalhe da notificacao;</li><li>aba <code>Preferencias</code> com switches por tipo e canal em DataTable;</li><li>aba <code>Canais / Entregas</code> com saude operacional, falhas recentes e grade de envios;</li><li>aba <code>Visao Geral</code> com resumos por tipo, canal e agregado geral.</li></ul><h2>Botoes do topo</h2><ul><li><code>Atualizar</code>: recarrega KPIs, inbox, preferencias, canais e historico de avisos;</li><li><code>Marcar todas lidas</code>: confirma leitura em massa das notificacoes do escopo atual.</li></ul><h2>Acoes importantes da tela</h2><ul><li><code>Enviar aviso</code>: cria o broadcast interno para o publico selecionado;</li><li><code>Atualizar historico</code>: recarrega os avisos manuais enviados;</li><li><code>Filtrar</code> e <code>Limpar</code>: refinam o historico de avisos por busca, publico, tom, periodo e pendencias;</li><li><code>Ver confirmacoes</code>: mostra quem confirmou leitura do aviso;</li><li><code>Ver publico</code>: separa destinatarios confirmados e pendentes;</li><li><code>Reutilizar</code>: traz um aviso anterior de volta para o formulario;</li><li>acoes de <code>Ler</code>, <code>Nao lida</code>, <code>Excluir</code> e operacoes em lote no inbox;</li><li>acoes de <code>Ativar neste navegador</code>, <code>Enviar push de teste</code>, <code>Atualizar status</code> e <code>Desativar neste navegador</code> no bloco de push.</li></ul><h2>Topbar</h2><ul><li>o icone de notificacoes da topbar mostra o total de nao lidas;</li><li>a topbar usa escopo pessoal, enquanto a central admin pode abrir visao global quando o perfil permite;</li><li>a lista curta carrega ao passar o mouse, ao focar ou ao abrir o dropdown;</li><li>a acao <code>Ver</code> abre um offcanvas de detalhe sem sair da tela atual;</li><li><code>Marcar lida</code>, <code>Marcar nao lida</code>, <code>Abrir</code> e <code>Excluir</code> atualizam o badge e a lista curta;</li><li>o offcanvas de detalhe marca a notificacao como lida e preserva o link de origem quando existir.</li></ul><h2>Observacoes</h2><ul><li>a area de avisos internos e a visao global dependem de perfil administrativo com escopo ampliado;</li><li>os avisos usam o tipo <code>manual_team_announcement</code> e podem aparecer como banner global, modal, toast e push;</li><li>a confirmacao de <code>Entendi</code> gera trilha de auditoria com origem da leitura;</li><li>as tabelas de preferencias e canais usam DataTable e sao recriadas apos cada renderizacao AJAX;</li><li>para historico e auditoria completos no banco, a instalacao precisa ter as migrations de broadcasts e acknowledgement aplicadas.</li></ul>"},"exp":1780849743}