{"v":{"area":"admin","slug":"comm-assignments","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/comm-assignments.md","relative_path":"docs/readme/admin/comm-assignments.md","title":"Comissoes - Atribuicoes","html":"<h1>Comissoes - Atribuicoes</h1><h2>Rota</h2><ul><li><code>/adm/comm-assignments</code></li></ul><h2>O que e</h2><p>Tela administrativa para manter as atribuicoes de esquemas de comissao por contrato, usuario e papel.</p><h2>Para que serve</h2><ul><li>listar atribuicoes comerciais e financeiras ja cadastradas;</li><li>criar uma nova regra de atribuicao;</li><li>editar esquema, papel, usuario, prioridade e vigencia;</li><li>remover atribuicoes que nao devem mais participar do calculo;</li><li>carregar sugestoes de hierarquia comercial quando disponivel.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com total de atribuicoes, papeis, usuarios e alvo do recorte;</li><li>leitura consolidada do estado atual;</li><li>alerta contextual sobre prioridade e vigencia;</li><li>tabela principal em <code>DataTable</code>;</li><li>offcanvas de filtros;</li><li>modal de criacao e edicao.</li></ul><h2>Botoes do topo</h2><ul><li><code>Nova</code>: abre o modal para cadastrar uma atribuicao.</li><li><code>Carregar hierarquia</code>: busca sugestoes automaticas de hierarquia comercial.</li><li><code>Filtrar</code>: abre o offcanvas com contrato, usuario e papel.</li><li><code>Atualizar</code>: recarrega a listagem com os filtros atuais.</li></ul><h2>Filtros</h2><ul><li><code>Contrato</code>: restringe a listagem ao contrato informado.</li><li><code>Usuario</code>: filtra atribuicoes ligadas a um usuario especifico.</li><li><code>Papel</code>: restringe por papel comercial ou operacional.</li><li><code>Aplicar filtros</code>: atualiza a tabela e fecha o offcanvas.</li><li><code>Limpar filtros</code>: remove os filtros, limpa o alvo ativo e recarrega a tela.</li></ul><h2>Tabela</h2><p>A tabela usa DataTable para busca local, ordenacao, paginacao e leitura responsiva.</p><p>As acoes por linha permitem editar ou remover uma atribuicao.</p><h2>Modal</h2><p>O modal concentra os campos de cadastro e edicao:</p><ul><li>contrato;</li><li>esquema;</li><li>papel;</li><li>usuario;</li><li>prioridade;</li><li>data inicial;</li><li>data final;</li><li>estado ativo ou inativo.</li></ul><h2>Observacoes</h2><ul><li>A busca rapida de usuarios usa Select2 quando o plugin esta disponivel.</li><li>Regras com maior prioridade devem ser usadas para resolver conflitos entre atribuicoes equivalentes.</li><li>O resumo considera apenas os registros retornados pela API no recorte atual.</li></ul>"},"exp":1780849785}