# Administração interna

Diagnóstico e correções auditadas para operadores da Pulsant.

## Habilitar operadores

Acesso interno é diferente do papel administrador de workspace. Configure INTERNAL_ADMIN_USER_IDS no servidor com IDs de contas verificadas, separados por vírgula. Os IDs são obtidos por GET /v1/me com a própria sessão autorizada. Não use e-mails, chaves privadas ou tokens como IDs. A lista vazia desabilita a área para todos. Reinicie a API após alterar a configuração; nunca atribua acesso por parâmetro de URL ou edição no navegador.


## Investigar um problema

Entre com a conta autorizada e abra Administração interna. Busque pessoa, workspace, hostname, provedor ou ID. E-mails completos, credenciais de integração, payloads e assinaturas não são apresentados. O diagnóstico mostra sites, consumo, créditos, pedidos da Pulsant, pagamentos dos clientes e atribuição registrada. Quando uma venda fica Sem atribuição, a categoria do diagnóstico explica se faltou um ID determinístico, um contato na janela de 90 dias, houve somente acesso direto, o vínculo veio de uma assinatura ou a identidade foi removida. Registros legados sem motivo preservado aparecem como diagnóstico histórico indisponível. Essas duas receitas permanecem separadas; nunca deduza origem por IP ou coincidência de horário.


## Reprocessar com segurança

Localize o recebimento no workspace e pesquise seu ID em Filas e tarefas. A outbox PostgreSQL é durável; a indisponibilidade Redis aparece como estado parcial. Confirme o ID da tarefa e informe o motivo. A tarefa retorna ao mesmo worker com o mesmo identificador lógico: não é um novo pagamento, uma nova unidade faturável ou uma confirmação manual de Pix. Falhas continuam visíveis e podem exigir corrigir a integração ou regularizar saldo antes de uma nova tentativa.


## Suspensão e acesso

Suspender workspace interrompe acesso/coleta daquele workspace. Restaurar recupera o estado anterior elegível; período pago vencido permanece expirado. Suspender uma conta revoga suas sessões e chaves em todos os workspaces e impede emissão de novas sessões, inclusive no banco. Restaurar conta não reativa sessões ou chaves antigas. Operadores internos não podem suspender uns aos outros por esta interface. Ações exigem confirmação do recurso e motivo auditado; não há impersonação.


## Correções de crédito

Concessões de suporte são ajustes operacionais, não pagamentos. Só planos pagos elegíveis recebem créditos; comportamento exige Pro. A concessão expira em 90 dias e não altera sites, pessoas, recursos, plano, ciclo ou consumo anterior. Estornos removem apenas saldo ainda disponível e não expirado. Cada movimento possui uma operação e um ledger duráveis. Repetir o mesmo requestKey e corpo não duplica a correção; reutilizar a chave com dados diferentes é recusado.


## Limites e cobertura

O diretório retorna até 20 resultados por categoria; o diagnóstico lista até 100 sites/membros/conexões, 50 recebimentos/lotes, 30 pagamentos/pedidos/e-mails e 100 ações de auditoria. A fila tem paginação e busca por ID, incluindo tarefas de importação/exportação. Na aba Plano e créditos, Conferir saldos compara contadores com o ledger de consumo e cada lote com movimentos imutáveis; na aba Receita, Conferir ledger financeiro compara projeções de reembolsos/chargebacks e unidades com os ledgers internos. As leituras não corrigem divergências nem consultam saldo/payout do gateway. Bytes comportamentais representam registros conhecidos, não um inventário completo do bucket. E-mails anteriores à migração de vínculo explícito não são atribuídos por aproximação. Correções manuais de atribuição têm módulo próprio no site. Reconciliação com extrato/payout do provedor, gestão operacional detalhada de arquivos/importações e gestão financeira avançada ainda exigem ampliação.