1. Para que serve

O módulo Admin Clientes administra as empresas do tenant. Cada cliente representa uma filial (subtenant) da matriz, com usuários e fontes próprios. O usuário autorizado pode criar e editar clientes, configurar o gestor da filial, consultar o modo e o status, associar fontes e executar as ações administrativas disponíveis.

Os nomes, CNPJs, endereços e demais valores visíveis nas imagens são exemplos. Não os utilize como dados reais.

Lista atual de clientes com busca, gestor, modo, status e ações administrativas
Figura 1 — Lista atual de clientes.

2. Cadastrar um cliente

Clique em Novo cliente para abrir o modal. O nome do cliente, o slug, a razão social e o CNPJ são necessários para salvar a empresa. O gestor da filial é opcional nesta etapa e pode ser cadastrado depois em Editar.

Campo Uso indicado na tela
Nome do cliente Nome usado para identificar o cliente na administração.
Slug Identificador textual do cliente.
Razão social Nome empresarial oficial.
Nome fantasia Nome comercial, quando houver.
CNPJ Identificação cadastral da empresa.
Telefone e e-mail institucional Canais oficiais de contato.
Site HTTPS Endereço eletrônico institucional.
Endereço, número, complemento e bairro Localização da sede ou unidade cadastrada.
Cidade, Estado/UF, CEP e País Complemento da localização institucional.
Limite de bancos no Chat Limite relacionado aos bancos disponíveis no Chat; a tela informa que, em branco, seriam considerados todos os bancos autorizados.
Gestor da filial Nome, e-mail de login e senha inicial opcional do usuário que administrará a filial.

Campos marcados com * são obrigatórios. Telefone, site e CEP são validados quando preenchidos; o CNPJ também é validado quando informado ou alterado.

Modal atual Novo cliente com gestor opcional e dados institucionais obrigatórios e opcionais
Figura 2 — Modal atual de criação de cliente.

3. Editar os dados do cliente

  1. Localize o cliente na tabela.
  2. Selecione Editar.
  3. Revise ou altere os dados do cliente e os dados institucionais.
  4. Cadastre, atualize ou remova o gestor da filial, quando necessário.
  5. Selecione Salvar alterações para concluir ou Cancelar para abandonar a edição.
Modal atual Editar cliente com gestor, dados institucionais e ações de salvar e cancelar
Figura 3 — Modal atual de edição de cliente.

4. Associar fontes da empresa

A ação Fontes, exibida na listagem, abre um drawer para selecionar as fontes que ficarão associadas ao cliente. As fontes são separadas em Bancos de dados estruturados e Dados não estruturados, com ações Selecionar tudo e Desselecionar tudo em cada grupo.

Marque ou desmarque uma fonte para atualizar o vínculo. A mesma fonte pode ser vinculada a vários clientes; a operação compartilha metadados e resultados. A matriz é quem concede ou revoga fontes para as unidades.

Drawer atual de fontes do cliente com grupos estruturados e não estruturados e checkboxes
Figura 4 — Drawer de associação de fontes ao cliente.

5. Consultar clientes e ações

A tabela atual permite buscar por nome, slug, CNPJ ou e-mail do gestor. Ela contém as colunas Nome, Slug, CNPJ, Gestor, Modo e Status. As ações visíveis são:

  • Editar: abre os dados do cliente para alteração.
  • Fontes: abre a associação de fontes de empresa.
  • Centralizar ou Descentralizar: alterna o modo de gestão da filial.
  • Suspender ou Reativar: altera o status da filial.
  • Excluir: abre a confirmação para excluir os dados criados no contexto da filial.

No modo Centralizado, a filial usa os recursos compartilhados da matriz em tempo real. No modo Descentralizado, mantém configuração própria baseada em um snapshot da matriz. Uma filial suspensa pode ser reativada pela ação correspondente.

6. Excluir um cliente

  1. Localize o cliente na tabela.
  2. Clique no ícone de exclusão.
  3. Leia a confirmação e revise o escopo da remoção.
  4. Selecione Excluir cliente ou Cancelar.

A exclusão remove somente dados criados no contexto da filial, como usuários, fontes não compartilhadas, scans, documentos, conversas, histórico de buscas e perfil institucional. Recursos da matriz ou compartilhados com outras filiais não são excluídos. A operação não pode ser desfeita.

Diálogo atual de confirmação para excluir uma cliente e os dados criados no contexto da filial
Figura 5 — Confirmação da exclusão de cliente.

7. Principais fluxos

  • Criar: Novo cliente → preencher dados → revisar → Criar cliente.
  • Editar: localizar cliente → Editar → ajustar dados ou gestor → Salvar alterações.
  • Associar fontes: localizar cliente → Fontes → selecionar bancos autorizados → marcar ou desmarcar as fontes no drawer.
  • Gestão: localizar cliente → Centralizar/Descentralizar ou Suspender/Reativar.
  • Excluir: localizar cliente → ícone de exclusão → revisar o escopo → Excluir cliente.