DOCUMENTAÇÃO

Manual de uso por módulo

Dashboard

Mostra o resumo operacional da empresa atual. Para administrador geral, exibe a visão consolidada de todas as empresas.

  • Use para acompanhar rapidamente a quantidade de usuários cadastrados.
  • Ao entrar em uma empresa pelo Controlador Geral, a dashboard passa a mostrar apenas os dados daquela empresa.
  • Se os números não atualizarem, recarregue a página ou faça logout/login novamente.

Controlador Geral

Área exclusiva do administrador geral para visualizar empresas e assumir o acesso administrativo de uma empresa específica.

  • Use a busca para localizar empresa por nome ou CNPJ.
  • Clique em um card para entrar naquela empresa como administrador.
  • Se a empresa não tiver administrador, o sistema cria um administrador automaticamente.

Empresas

Cadastro de empresas/clientes da plataforma. Disponível apenas para administrador geral.

  • Use Novo para cadastrar uma empresa.
  • Na grade, a visualização principal prioriza descrição/nome e CNPJ.
  • Empresas com usuários vinculados não devem ser excluídas sem análise.

Clientes

Cadastro de clientes da empresa ativa, com dados de contato, documento, nascimento, endereço e preferências de comunicação.

  • Campos principais: nome, telefone, tipo de pessoa e data de cadastro.
  • O campo CPF/CNPJ é preenchido manualmente; não há busca externa por CPF.
  • Os campos de API de pagamento e formas de pagamento não aparecem no formulário.
  • O campo empresa é definido automaticamente pela sessão.

Usuários

Cadastro dos usuários que acessam o sistema dentro da empresa ativa.

  • Usuários comuns enxergam apenas dados permitidos pelo próprio nível.
  • O campo empresa é definido automaticamente pela sessão, exceto para administrador geral.
  • Ao criar usuário sem senha, o sistema usa a senha padrão inicial configurada no cadastro.
  • Não é permitido excluir o usuário atualmente logado.

Colaboradores

Cadastro de colaboradores da empresa ativa, usando a base da tabela de usuários com dados complementares trabalhistas e financeiros.

  • Campos principais: nome, CPF, telefone, ativo, salário, valor hora e área de atuação.
  • Dados adicionais: endereço, nascimento, Pix, comissão, jornada e horários.
  • O campo empresa é definido automaticamente pela sessão.
  • Colaboradores são gravados com nível Colaborador e sem acesso ao painel por padrão.

Cargos

Cadastro de funções e equipes da empresa ativa.

  • Campos principais: ID, descrição e tipo de cargo.
  • Tipos disponíveis: Escritório e Vendas.
  • Não é permitido cadastrar cargo duplicado com a mesma descrição dentro da mesma empresa.

Plano de Contas

Cadastro de classificações financeiras da empresa ativa.

  • Campos principais: ID, descrição e tipo.
  • Tipos disponíveis: Custo fixo, Variável, Faturamento e Investimento.
  • O campo empresa é definido automaticamente pela sessão.
  • Não é permitido cadastrar descrição duplicada dentro da mesma empresa.

Formas de Pagamento

Cadastro dos meios usados para baixa de contas, com taxa opcional para operações como cartão.

  • Campos principais: descrição e taxa.
  • O campo empresa é definido automaticamente pela sessão.
  • As formas cadastradas aparecem na baixa do Contas a Pagar.

Contas a Pagar

Cadastro de despesas da empresa ativa, com plano de contas obrigatório, vínculo opcional com fornecedor ou colaborador, parcelamento e baixa.

  • Plano de contas aceita apenas Custo fixo, Variável ou Investimento.
  • Fornecedor e colaborador são exclusivos: selecione apenas um deles por lançamento.
  • Parcelas podem ser geradas dividindo o valor total ou repetindo o valor informado em cada parcela.
  • Parcelas pagas não podem ser alteradas pelo cadastro normal.
  • Use o botão de baixa na coluna Ações para informar forma de pagamento, data, multa, juros e desconto.

Fornecedores

Cadastro de fornecedores da empresa ativa, com dados fiscais, contato, endereço e chave Pix.

  • Campos principais: nome/razão social, telefone, CNPJ, estado e dados de pagamento.
  • Use o botão de lupa ao lado do CPF/CNPJ para buscar dados públicos do CNPJ pela ReceitaWS.
  • O campo empresa é definido automaticamente pela sessão.
  • Não é permitido cadastrar o mesmo CNPJ mais de uma vez dentro da mesma empresa.

Tabelas do sistema

As telas de cadastro usam a base visual do OrionTable.

  • Use a busca para filtrar registros rapidamente.
  • Use a engrenagem para ocultar ou exibir botões e filtros quando disponível.
  • A coluna Ações concentra editar e excluir.
  • PDF e Excel exportam a visão atual da tabela.
  • Resize de colunas altera a largura da coluna selecionada, respeitando os limites da tabela.

Perfil, tema e acesso

O cabeçalho mostra a empresa ativa, o usuário logado e opções de tema/logout.

  • Clique no usuário no canto superior direito para editar dados básicos do perfil.
  • Use o botão de tema para trocar a aparência do sistema.
  • Use o botão de sair para encerrar a sessão com segurança.

Exemplos e módulos futuros

A seção Exemplos guarda telas de referência e módulos ainda em evolução.

  • Cadastro Base: modelo de configuração para novas tabelas.
  • Financeiro: referência para receitas, despesas e vencimentos.
  • IA, Documentos, Relatórios e Configurações: áreas reservadas para evolução do sistema.