{"v":{"area":"admin","slug":"usuarios-categorias","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/usuarios-categorias.md","relative_path":"docs/readme/admin/usuarios-categorias.md","title":"Categorias de usuarios","html":"<h1>Categorias de usuarios</h1><h2>Rota</h2><ul><li><code>/adm/usuarios-categorias</code></li></ul><h2>O que e</h2><p>Tela administrativa para manter categorias reutilizaveis de usuarios, com suporte a escopo global ou por contrato.</p><h2>Para que serve</h2><ul><li>organizar a taxonomia de usuarios usada em filtros, segmentacoes e operacoes internas;</li><li>criar, editar, ativar, inativar e excluir categorias;</li><li>importar e exportar categorias em lote;</li><li>revisar rapidamente cor, icone, ordem e escopo de cada registro.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com resumo da taxonomia e indicadores de escopo;</li><li>filtros em offcanvas acionados pelo topo;</li><li>tabela principal em <code>tiix-table-shell</code> com DataTable;</li><li>modal de formulario com dados, visual e status da categoria;</li><li>modal de importacao por arquivo;</li><li>modal de confirmacao para exclusoes.</li></ul><h2>Botoes do topo</h2><ul><li><code>Filtros</code>: abre o offcanvas com escopo, contrato, status e busca textual;</li><li><code>Excluir selecionados</code>: remove em lote os registros marcados, respeitando permissao;</li><li><code>Importar</code>: abre o modal para importar categorias por planilha;</li><li><code>Exportar XLS</code>: gera uma planilha com o recorte atual;</li><li><code>Nova categoria</code>: abre o formulario de criacao.</li></ul><h2>Filtros</h2><ul><li><code>Escopo</code>: alterna entre categorias globais, de contrato ou todas;</li><li><code>Contrato</code>: restringe a listagem ao contrato selecionado;</li><li><code>Ativo</code>: filtra categorias ativas ou inativas;</li><li><code>Busca</code>: pesquisa por nome, slug ou descricao.</li></ul><h2>Tabela</h2><ul><li>usa DataTable do Matdash quando disponivel;</li><li>evita linhas vazias com <code>colspan</code>, usando a mensagem nativa de tabela vazia;</li><li>exibe selecao, nome, slug, escopo, contrato, ativo, cor, icone, ordem e acoes.</li></ul><h2>Observacoes</h2><ul><li>filtros ficam fora do miolo para preservar largura da grade;</li><li>a tela mantem JS embedado porque o comportamento e exclusivo desta pagina;</li><li>importacao/exportacao continuam usando o fluxo ja existente da API.</li></ul>"},"exp":1780849848}