{"v":{"area":"admin","slug":"comunicacao","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/comunicacao.md","relative_path":"docs/readme/admin/comunicacao.md","title":"Comunicacao","html":"<h1>Comunicacao</h1><h2>Rota</h2><ul><li><code>/adm/comunicacao</code></li></ul><h2>O que e</h2><p>Centro operacional para acompanhar conversas, notas, tickets, solicitacoes internas e e-mails em uma unica leitura. A tela nao substitui os modulos especialistas; ela funciona como painel de orientacao e entrada rapida para o trabalho de comunicacao.</p><h2>Para que serve</h2><ul><li>enxergar pendencias de comunicacao em uma visao unica;</li><li>abrir rapidamente chat, notas, tickets, solicitacoes, mailbox, diretorio e notificacoes;</li><li>acompanhar atividade recente entre canais;</li><li>priorizar nao lidas, tickets em andamento, e-mails nao lidos, notas fixadas e solicitacoes urgentes;</li><li>reduzir a perda de contexto entre conversa e execucao.</li></ul><h2>Blocos principais</h2><ul><li>hero com contadores por canal;</li><li>botao <code>Filtros</code> no topo da pagina abrindo offcanvas lateral com periodo, canal e busca;</li><li>KPIs de conversas, pendencias, notas, tickets e solicitacoes;</li><li>painel &quot;Sua atencao agora&quot; em carousel, com ate quatro cards por slide no desktop;</li><li>area operacional em 25/50/25 no desktop: acoes rapidas, guias por canal e timeline;</li><li>acoes rapidas em cards compactos;</li><li>guias por canal com tabelas DataTable para conversas, mailbox, notas, tickets e solicitacoes;</li><li>timeline consolidada com SimpleBar e altura controlada.</li></ul><h2>Canais consolidados</h2><ul><li><code>DevChat</code>: usa <code>threads_list</code> com o contrato atual para trazer conversas recentes e nao lidas;</li><li><code>InternalNotes</code>: usa <code>stats</code> e <code>list</code> para notas visiveis ao usuario;</li><li><code>Tickets</code>: usa <code>Tickets/list</code> com contrato atual para chamados recentes;</li><li><code>Mailbox</code>: lista contas acessiveis e busca threads de INBOX via <code>Accounts.list</code> e <code>Threads.list</code>;</li><li><code>InternalRequests</code>: usa <code>InternalRequests/list</code> para pedidos internos do colaborador.</li></ul><h2>Regras atuais</h2><ul><li>o periodo padrao e 30 dias;</li><li>os filtros ficam no offcanvas para reduzir ruido visual na central;</li><li>os filtros sao aplicados no frontend sobre os itens carregados;</li><li>o filtro de canal foca a timeline e abre a guia correspondente, sem esvaziar as outras guias;</li><li>o painel de atencao agrupa alertas em slides de quatro cards, cada um ocupando 25% da largura no desktop;</li><li>cada linha de tabela tenta manter link direto para o modulo de origem;</li><li>as guias usam DataTable quando a biblioteca esta disponivel e mantem tabela HTML normal como fallback;</li><li>no desktop, a area principal divide a leitura em atalhos a esquerda, dados no centro e timeline a direita;</li><li>falhas isoladas em um canal nao derrubam a central inteira;</li><li>a contagem de pendencias soma conversas nao lidas, e-mails nao lidos, tickets abertos e solicitacoes abertas.</li></ul><h2>Roadmap</h2><p>O plano de evolucao esta documentado em <code>docs/roadmaps/comunicacao-unificada.md</code>.</p><h2>Observacoes</h2><ul><li>a central atual e uma primeira camada de agregacao operacional;</li><li>a proxima evolucao recomendada e criar um endpoint backend dedicado para normalizar os canais em uma unica resposta;</li><li>chat continua sendo a experiencia principal para conversa interna;</li><li>tickets, tarefas, mailbox, solicitacoes e documentos continuam sendo os donos do seu proprio fluxo especialista.</li></ul><h2>Padrao visual</h2><ul><li>hero, KPIs e paineis usam <code>tiix-data-card</code>;</li><li>tabelas por canal usam <code>tiix-table-shell</code> com DataTable quando disponivel;</li><li>filtros permanecem no botao superior e abrem em offcanvas.</li></ul>"},"exp":1780849751}