AutoflowTrilha 06 · Área administrativa
Console da plataforma
O Console Super é a sua ferramenta como implantador e suporte. Ele existe para diagnosticar e corrigir sem abrir banco de dados, Keycloak ou Camunda — e para que tudo o que você faz fique registrado e visível ao cliente.
O que é e por que é separado
O Console Super (app apps/super) é um console interno, separado do produto, num endereço próprio (ex.: admflow.<domínio>), acessível apenas de IPs liberados (VPN/allowlist). O cabeçalho mostra “Autoflow Suporte”, uma etiqueta de ambiente sempre visível (PRODUÇÃO em vermelho, HOMOLOGAÇÃO, DEV) e “Somente leitura” quando for o caso.
A pergunta que toda tela responde: onde está, por que está ali, o que posso fazer, e quem fez o quê.
Acesso direto não deixa rastro de negócio, ignora o isolamento entre clientes e permite “consertos” que corrompem dados (mover token, editar tabela). O Console oferece um catálogo fechado de operações seguras, cada uma com motivo, confirmação e auditoria visível ao cliente. É isso que permite vender o Autoflow para órgãos públicos e empresas reguladas: o fornecedor não tem “porta dos fundos” invisível.
Quem entra
O acesso é com contas dedicadas de plataforma, no grupo /Plataforma do Keycloak, sem vínculo com nenhum cliente (o sistema recusa conta que tenha tenant). Dois papéis:
| Papel | Pode |
|---|---|
platform-reader |
Buscar, abrir atendimento, ler dados mascarados |
platform-operator |
Tudo do reader + operações de escrita do catálogo, revelar dados, provisionar organização |
Em produção, MFA (código OTP) é obrigatório e a sessão é curta: 30 minutos ociosa, 10 horas no máximo. A mesma pessoa usa contas diferentes para suporte e para ser usuária de um cliente.
O primeiro operador de cada ambiente é criado manualmente no Keycloak (grupo /Plataforma + papel). É o único passo manual da implantação da plataforma. Veja a lição “Infraestrutura e implantação”.
Mapa das telas
Console de suporte
Atendimentos abertos, botão Nova organização e a tabela Saúde das organizações: incidentes, suspensos, jobs com falha (24h), entregas mortas de webhook (7d), integrações em erro.
Encontrar qualquer coisa
ID, e-mail de usuário ou de participante externo, nome da organização, ext:referência. Número de processo pede a organização (é único só dentro dela). Devolve só identificadores.
Painel do tenant
Abas Resumo, Estrutura, Usuários, Cargos e departamentos, Processos, Instâncias, Incidentes, Integrações, Consistência. Exige atendimento aberto.
Investigação
Diagrama com atividade ativa e incidente, causa provável, linha do tempo unificada, tarefas, jobs, integrações, documentos, variáveis mascaradas.
Acesso do usuário
Conta, sessões, vínculos e divergências (“cargo sem role no Keycloak”). Ações: reenviar convite, encerrar sessões, reaplicar cargos, desativar/reativar.
Rastro e trabalho em fundo
Tudo o que o suporte fez; e o estado das filas de trabalho assíncrono (na fila, em execução, falhos, retenção).
A tabela de saúde: sua rotina diária
| Coluna | O que significa | O que fazer |
|---|---|---|
| Incidentes | Processos parados por falha técnica | Investigar e retentar (lição seguinte) |
| Suspensos | Instâncias suspensas | Confirmar com o cliente se é intencional |
| Jobs com falha | Trabalho em fundo que falhou nas últimas 24h | Ver em Filas; reexecutar se permitido |
| Entregas mortas | Webhooks que esgotaram tentativas (7 dias) | Ver integração do cliente; reenviar |
| Integrações em erro | Integração pausada por falhas | Avisar o cliente; corrigir endpoint |
Se o Camunda ou as filas estiverem fora do ar, a tabela avisa (ex.: “Camunda indisponível: incidentes e suspensos sem dados.”) em vez de mostrar zero.
Na operação assistida após um go-live, abra o Console toda manhã e olhe a linha do cliente. Resolver um incidente antes de o cliente ligar é a melhor propaganda que existe.
O painel da organização (Resumo)
- Indicadores: Admins ativos (vermelho se 0), Usuários, Matrizes / filiais, Incidentes, Suspensas, Jobs com falha, Entregas mortas, Integrações em erro.
- Segmento: “Sem segmento” + Definir segmento, ou o segmento + Reinstalar pacote, com o estado da instalação (“Pacote vN · instalado · X criados, Y já existiam, Z falhas”).
- Verificações: checagens como “sem admin ativo” (com Convidar primeiro admin), divergência de usuário, integração em erro, assinatura pausada, troca parada.
- Consistência (aba): Verificar agora roda 7 checagens Camunda × banco, só leitura (ex.: “Troca aberta em processo encerrado”, “Incidente sem job de origem”), cada achado com “Investigar” e “Copiar para o ticket”.
Modo somente leitura
A variável PLATFORM_READ_ONLY=true faz toda escrita responder “somente leitura” e a interface desabilita os botões com o aviso “Plataforma em modo somente leitura”. Use em janelas de manutenção ou quando houver suspeita de incidente de segurança.
Resumo
- O Console Super é o suporte sem porta dos fundos: catálogo fechado, motivo, auditoria visível ao cliente.
- Contas dedicadas, sem tenant, com MFA; papéis reader e operator.
- A tabela de saúde é a rotina diária; o painel da organização mostra segmento, verificações e consistência.
- Rede restrita por allowlist e modo somente leitura como trava geral.