Manual — Painel Admin

Por que existe

Enquanto os outros módulos deste manual são usados no dia a dia por cada empresa-cliente, o Painel Admin é onde o dono da plataforma administra o negócio como um todo: quem são as empresas-cliente cadastradas, quais contadores da equipe atendem cada uma, e a situação de cadastro de cada cliente.

Visão geral

Total de clientes: Quantidade total de empresas-cliente cadastradas na plataforma — este número é real.
Clientes ativos, Em onboarding, Contadores: Indicadores planejados para mostrar essas contagens.
Últimos clientes cadastrados / Tarefas pendentes: Listas planejadas de acompanhamento rápido.

Parcialmente implementado

Só o indicador “Total de clientes” reflete um número real hoje. “Clientes ativos”, “Em onboarding” e “Contadores” aparecem sempre como 0, e as duas listas da parte de baixo da tela aparecem sempre vazias — a estrutura visual já existe, mas ainda não busca os dados reais da plataforma.

Contadores

É a gestão da equipe interna de contabilidade — os profissionais que atendem as empresas-cliente. Não confundir com usuários/funcionários dentro de uma empresa-cliente (isso é gerido pelo próprio dono daquela empresa no sistema principal); aqui é a equipe da própria operadora da plataforma.

Nome / E-mail: Identificação do contador na listagem.

+ Novo contador

Abre um formulário: Nome*, Email* (vira o login do contador — não pode repetir um já cadastrado), Telefone e CRC (registro profissional no Conselho Regional de Contabilidade, opcional). Ao criar, o sistema gera uma senha provisória e a exibe na tela para cópia — nenhum e-mail é enviado automaticamente, é preciso repassar a senha manualmente ao contador.

Gerar nova senha

Cria uma nova senha provisória para o contador e desconecta qualquer sessão ativa dele em qualquer lugar. Mostra a senha na tela para o admin repassar.

Excluir

Remove o acesso do contador (exclusão lógica: ele para de conseguir logar, mas o histórico de ações dele é preservado para rastreabilidade).

Não disponível hoje

Não há, na tela, como editar nome/telefone/CRC de um contador já criado — só criar, resetar senha, ver detalhes ou excluir.

Detalhe do contador

Ficha individual, somente leitura, mostrando dados de contato e a carga de trabalho de cada contador.

Telefone / CRC / Cadastrado em: Dados de contato e data de criação do cadastro.
Empresas atendidas: Lista das empresas-cliente vinculadas a esse contador, com o status de cada uma e um selo “Principal” quando ele é o contador principal daquela empresa.

Clientes (empresas-cliente / “tenants”)

O catálogo de todas as empresas cadastradas na plataforma — a visão de carteira de clientes do dono do sistema.

Empresa: Razão social (ou, se ainda não preenchida, um identificador provisório) e o CNPJ, ou “CNPJ não informado” para quem ainda não passou por essa etapa do onboarding.
Status: Situação da empresa perante a plataforma (ver tabela abaixo).
Usuários: Quantidade de pessoas (donos/funcionários) com acesso àquela empresa no sistema principal.

A busca (“Buscar por nome ou CNPJ...”) é automática, comparando razão social, nome fantasia e CNPJ.

Status de uma empresa-cliente
Status	Significado
Onboarding	Cadastro ainda em andamento — a empresa está completando o assistente de primeiros passos.
Ativo	Cadastro concluído, empresa operando normalmente na plataforma.
Em atraso	Indica inadimplência/atraso no pagamento da assinatura.
Bloqueado	Empresa impedida de usar o sistema (por exemplo, inadimplência prolongada).
Cancelado	Contrato/assinatura encerrado — a empresa não é mais cliente ativo.

Hoje os selos de “Em atraso”, “Bloqueado” e “Cancelado” aparecem todos na mesma cor neutra — não há, ainda, um destaque visual diferente (como vermelho) para chamar atenção a esses casos.

Detalhe do cliente e atribuição de contador

A ficha completa de uma empresa-cliente específica — e onde acontece a atribuição de contadores da equipe a cada empresa.

Dados da empresa

Razão social, Nome fantasia, CNPJ, Regime: Dados cadastrais coletados no onboarding da empresa-cliente.
Onboarding: Exibido como “Passo X/5” — indica em qual etapa do cadastro guiado a empresa está, útil para identificar quem travou no meio do processo.

Contador responsável

Lista os contadores atualmente atribuídos, com selo “Principal” para o(s) que forem marcados como responsável principal.

+ Atribuir contador

Escolhe um contador da lista de contadores cadastrados e marca (ou não) a caixinha “Contador principal”, então confirma em “Atribuir”.

Regras importantes

É possível atribuir mais de um contador à mesma empresa — um principal e outros colaboradores/secundários, por exemplo.
Atribuir novamente um contador que já estava vinculado à empresa só atualiza a marcação de “principal”, não duplica a atribuição.
O sistema não impede que mais de um contador da mesma empresa fique marcado como “principal” ao mesmo tempo.

Não disponível hoje

Não existe, nesta tela, um botão para remover/desatribuir um contador de uma empresa — só é possível adicionar. Também não é possível, pela tela, bloquear, cancelar ou reativar manualmente uma empresa-cliente, mesmo esses status existindo no sistema.

Usuários

Lista, somente leitura, de quem acessa essa empresa no sistema principal, com o papel de cada um: Admin da plataforma, Contador, Dono da empresa ou Funcionário.

Tarefas

A intenção desta tela é dar ao dono da plataforma uma fila consolidada de tarefas pendentes de todos os contadores, geradas conforme obrigações fiscais dos clientes se aproximam do vencimento.

Ainda não implementado

Esta tela hoje é apenas uma prévia visual: sempre mostra “Nenhuma tarefa pendente”, sem nenhum dado real, filtro ou ação disponível. É uma funcionalidade planejada para o futuro, ainda não construída.