Ajuste chaves operacionais, setores/cargos, usuários cadastrados e documentos do RAG.
Configurações Gerais
Carregando configurações...
Setores
ID
Nome do Setor
Descrição
Nível Hierárquico
Cor Indicadora
Status
Ações
Usuários
ID
Nome
Login (Usuário)
Setores Vinculados
Status
Ações
Auditoria
Data/Hora
Ação
Categoria
Executor
Alvo
IP Origem
Detalhes
Exibindo 0 de 0 logs
Abertura
Pessoa
Documento
Tempo com o documento aberto
Última atividade
IP Origem
Exibindo 0 de 0
leituras
Última mensagem
Pessoa
Primeira pergunta
Mensagens
Ações
Exibindo 0 de 0
conversas
Sem resultado para quem buscou: o documento pode existir fora do acesso dessa pessoa.
Consulta
Sem resultado
Resultado fraco
Última
Por onde
Quem buscou
Apps Autorizados
Custo de I.A. deaté
ID
Nome do App
Descrição
Tipo
Tokens (por cargo)
Setores
Custo no período
Status
Ações
Nenhum app autorizado carregado.
Telemetria de APIs (Uso de Versões)
Aplicativo
Versão da API Utilizada
Último Acesso
Status
Nenhum dado de acesso
registrado.
Vendedores
Vendedor entra no Portal de Vendas (/api/vendas) com um login próprio,
separado dos usuários do SD Docs, e cadastra, libera e bloqueia clientes só dos apps marcados aqui.
Tudo o que ele faz aparece em "Atividade dos Vendedores", e cada mudança de cliente pode ser desfeita.
Nome
Login
Apps
Status
Último Acesso
Ações
Atividade dos Vendedores
Quando
Quem
App
Cliente
O que aconteceu
IP
Ações
Bloqueios de IP (Força Bruta)
IP de Origem
Bloqueado Até
Tempo Restante
Ações
Uso das APIs
A avaliação do chatbot e as sugestões não têm rota,
situação nem cargo: nesses cartões valem só período, tipo, aplicativo e cliente.
Requisições dos apps autorizados (token de app) em todas as rotas: contexto,
avaliação, sugestão, MCP e I.A. O custo é o informado pelo provedor da I.A., em dólar.
Consultando o servidor...
Requisições por dia
Por aplicativo
Aplicativo
Tipo
Requisições
Erros
Tempo médio
Chamadas de I.A.
Tokens
Custo (US$)
Clientes
Último uso
Por rota
Rota
Requisições
Erros
Tempo médio
Tempo p95
Clientes que mais usam
Cliente
Aplicativos
Requisições
Chamadas de I.A.
Tokens
Custo (US$)
Último uso
Últimos erros
Quando
Aplicativo
Rota
Status
Cliente
Tempo
Versão do Servidor
Commit em execução
Consultando o servidor...
Publicar nova versão
Baixa os commits novos do repositório
(git pull --ff-only) e reinicia o processo no pm2. Pede a sua senha a cada execução.
Saúde do Servidor
Manutenção
Gerar RAG dos documentos pendentes
Indexa de uma vez todos os documentos que ainda não
estão no RAG. A fila roda em segundo plano, um documento por vez.
Reindexar todos os documentos
Refaz o RAG do acervo inteiro, inclusive o que já está indexado. Use depois de
mudar a forma de indexar. Consome a cota do serviço de embeddings.
Backups
Cada backup guarda o banco de dados e os arquivos dos documentos num pacote
.tar.gz. Numa restauração, os dois voltam juntos.
Backup em andamento
Consultando o servidor...
Backup automático
Armazenamento
Agendamento
Backups realizados
Data
Origem
Situação
Duração
Tamanho
Documentos
Ações
Tipos de Vínculo
ID
Código
Sigla
Nome do Vínculo
Descrição
Status
Ações
🚀 Lançamentos
Histórico de versão público, exibido na aba "Histórico de Versões" de /informacoes para
todo mundo ver (rota sem login). É uma fonte diferente do CHANGELOG.md: escreva pensando em quem usa a
plataforma, sem detalhe técnico ou sensível.
Versão
Título
Data
Itens
Ações
🔐 Permissões
⚠️ Alterações não salvas
Gerencie a matriz de permissões por setor, vínculo e cargo. Alterne abaixo entre a documentação Web e o
acesso API. O botão Salvar grava os dois blocos desta aba.
Uso comum
Quem lê e quem edita. Resolve a maior parte das perguntas.
📚 Documentação
Configure quais setores e cargos possuem acesso
ao
conteúdo principal e a cada vínculo dependente
⚡
Copiar Permissões:
Setor
Recurso / Vínculo Dependente
🌐 Documentação Site (WEB)
👥 Usuários do Setor
Delegue a um cargo o cadastro dos usuários do
próprio setor, sem precisar do Administrador principal
Quem tiver Leitura enxerga a aba Usuários com os colegas do setor. A conta do Administrador principal
continua exclusiva dele, e o que cada cargo consegue conceder a outra pessoa é definido na tabela
abaixo.
⚡
Copiar Permissões:
Setor
Ação sobre os usuários
⚙️ Avançado - quem pode conceder poder a quem
Mexer aqui muda a cadeia de escalada de privilégio. Raramente é o que você procura.
🤝 O que cada cargo pode conceder
Defina o que um cargo pode repassar a outra
pessoa ao atribuir um cargo a ela
Esta lista é independente do que o cargo faz: um gestor pode alterar documento e ainda assim ficar
proibido de conceder alteração a alguém. Atribuir um cargo exige poder conceder tudo o que aquele cargo
tem no setor, então sem marcação nenhuma o cargo não atribui ninguém. Só o Administrador principal edita
esta tabela.
⚡
Copiar Permissões:
Setor
Pode conceder
🤝 Cargo que concede
🧪 Testes de Permissão
Escolha uma identidade e veja o que ela pode fazer. A resposta sai das mesmas funções que
autorizam as requisições de verdade, então o que aparece aqui é o que aconteceria na tela
daquela pessoa. Nada é alterado e nenhuma conta é acessada: é consulta, não login.
Conferir tambem as validacoes de formulario (opcional)
Preencha como se estivesse na tela de usuarios. Os campos passam pelas mesmas funcoes
que os handlers chamam. A senha nao e gravada, nao entra no log e nao volta na
resposta — so o veredito volta.
Vínculos da identidade de teste
Salva esta simulação como arquivo em test/casos/. O
dart test lê a pasta e cobra estas mesmas respostas do motor
de permissões, sem precisar de banco.
Escolha uma identidade e clique em Simular para ver o que ela pode fazer.
Novo Tipo de Vínculo
É por ele que o sistema reconhece o tipo. O nome abaixo é só rótulo
de tela e pode ser trocado quando quiser.
Novo Lançamento
👔 Gerenciar Cargos
Nome do Cargo
Código
Descrição
Ações
➕ Cadastrar Novo Cargo
Conversa
Novo Setor
Novo Usuário
Novo App Autorizado
Identificação
Acesso
O app só enxerga os documentos destes setores.
Tipos de documento vinculado que este app não vê, mesmo que a matriz
do setor libere (ex.: Especificação SQL). Não muda a matriz nem os outros apps.
Libera /api/v1/ia/chat/completions para este app. Cada chamada consome a
cota do provedor de I.A. do SD Docs.
Quantas perguntas à I.A. cada cliente (x-client-id) pode fazer por dia.
Protege o custo contra exagero ou um app em laço; ao atingir, o cliente recebe um aviso até o dia seguinte.
Uma pergunta que já começou não é cortada no meio, e o uso do suporte não conta. 0 = sem
limite.
Credenciais
Tokens de Acesso sk-sdapp-...
Para que serve: identifica o app e o cargo em toda requisição
(Authorization: Bearer). Um por cargo: o cargo define o que o token alcança.
Como entregar: gere o link do cargo e mande a quem vai usar. Quem abre vê o token
uma vez só; nem este painel o mostra depois. O link vale 24 horas e só pode ser usado uma vez.
Salve o app para ver a Chave de Assinatura, gerar a Chave do Desenvolvedor e configurar Prompts e Clientes.
Chave de Assinatura sdsig_...
Para que serve: prova que a requisição saiu do app de verdade e que ninguém trocou o
cliente (x-client-id) nem a pergunta no caminho. O app calcula uma assinatura com ela em
cada requisição; a chave em si nunca viaja. Sem assinatura válida, o SD Docs recusa. Onde fica: no .env do app instalado, ofuscada no build. Trocar a chave
derruba na hora as versões do app que usam a anterior.
Chave do Desenvolvedor sddev_...
Para que serve: deixa a equipe ou o sistema que mantém o app alterar os
Prompts de I.A., a lista de Clientes e o catálogo de
Permissões pela API (/api/v1/prompts, /api/v1/clientes e
/api/v1.1/permissoes), sem depender deste painel. Não serve para mais nada. Onde fica: com quem desenvolve o app ou no sistema que decide quem pagou.
Nunca dentro do app. Aparece uma vez só, ao gerar.
Copie agora: ela não aparece de novo.
Configuração do App Instalado
Prompts de I.A.: os textos que o app usa para falar com a I.A. Clientes: quem pode usar o app, pelo x-client-id. Só os
Permitidos usam; quem não está na lista fica bloqueado. Aceites de Termos: quais usuários de cada cliente aceitaram os termos do app (termo de
uso, por exemplo), em qual versão e quando. É a prova do aceite. Permissões: as permissões internas do app (no SDApp, as do SDSuper) e quais setores cada
uma libera. Vale para o app que usa a API v1.1.
Aceites de Termos
Registro de quem aceitou os termos do app. O texto do termo fica no próprio app; aqui fica a prova:
cliente (x-client-id), usuário, termo, versão, data e IP. O primeiro aceite de cada versão é
o que vale. Mostra os 2000 mais recentes.
Aceito em
Cliente
Usuário
Termo
IP
Novo Vendedor
Letras sem acento, números, ponto, traço ou
sublinhado.
Só aparecem apps instalados: são os únicos com
lista de clientes.
A senha provisória aparece uma vez, ao salvar. No primeiro acesso ele troca por uma dele.
Clientes
Cada cliente aqui é identificado pelo mesmo valor que o app manda no cabeçalho
x-client-id. No SDApp, é o CNPJ da empresa só com números. Só os clientes
Permitidos desta lista usam o app; quem não está nela fica bloqueado. Inclua também a
sua própria empresa, se ela usa o app.
x-client-id
Nome
Situação
Atualizado
Ações
Exatamente o valor que o app manda em x-client-id. No SDApp: o CNPJ só com números, sem
pontos, barra ou traço. Não muda depois de cadastrado.
Último dia em que o cliente usa o app. Passado esse dia, ele volta a ficar
bloqueado sozinho (teste grátis, plano com prazo). Vazio = sem prazo.
Permissões
Na API v1.1 o app manda, em cada pergunta, as permissões do usuário logado (no SDApp, os
números das permissões do SDSuper). O SD Docs só procura nos setores ligados a essas permissões. Todos os usuários do app (*): os setores ligados a ela valem para qualquer
usuário, mesmo sem permissão nenhuma. Ligue aqui a documentação geral. Setor sem nenhuma permissão ligada só é visto por quem o app manda com
acesso_total (o administrador do sistema). Só aparecem os setores marcados no cadastro do app.
O sistema do app também pode gravar estas ligações com a Chave do Desenvolvedor
(PUT /api/v1.1/permissoes). Tabelas: as tabelas do banco do app que cada permissão libera. Chegam só pela API, e é o
app que confere o SQL com elas antes de executar. Aqui é só consulta.
Código
Nome
Setores liberados
Tabelas
Ações
O mesmo valor que o app manda em permissoes. No SDApp, o número da permissão do SDSuper.
Não muda depois de cadastrado.
Prompts de I.A.
O app busca estes textos em GET /api/v1/prompts e preenche os marcadores
{nome}. A alteração vale na hora, sem versão nova do app. A edição precisa manter
os mesmos marcadores; para mudar o formato, crie uma chave nova (ex.: plano_v2).