22 · Operações administrativas e ciclos

Para que a infraestrutura decisória funcione, alguém precisa operar a infraestrutura. Este capítulo descreve papéis, login, ciclos e leitura de logs — o "manual do operador" propriamente dito. Sem disciplina administrativa, qualquer metodologia boa vira ruído operacional em três meses.

22.0 · Por que este capítulo existe (abertura conceitual)

A literatura de information security governance e a tradição de Identity & Access Management (IAM) estabelecem três princípios cardinais para sistemas de decisão sensível: least privilege(cada usuário recebe o mínimo de permissões necessárias para sua função), separation of duties (ninguém pode executar sozinho um ciclo completo crítico) e auditability (toda ação relevante gera trilha imutável). Esses princípios estão codificados no NIST SP 800-53 (Rev. 5, 2020), no padrão ISO/IEC 27001:2022 e, no Brasil, na LGPD (Lei 13.709/2018) — esta última especialmente relevante porque o agente trata dados que, ainda que agregados, podem ser cruzados com bases pessoais. O capítulo traduz esses princípios para a realidade operacional do agente.

Para o operador novo, três ideias antes de seguir: (i) papel não é cargo — a mesma pessoa pode ter o papel de Operador em um projeto e Auditor em outro, e o sistema impõe a separação por contexto; (ii) log não é ferramenta de fiscalização punitiva, é infraestrutura de aprendizado institucional — o operador deve consultar logs como hábito, não como defesa; (iii) cadência fixa de pipelines (M/T/A) protege contra improvisação — pipeline rodado fora de janela exige justificativa formal e fica marcado como execução excepcional no histórico, o que cria o atrito necessário para evitar uso casuístico.

22.1 · Papéis

• Leitor — vê telas, exporta PDFs, sem alterar nada.
• Operador — roda execuções, edita racionais, gerencia exportações.
• Calibrador — modifica pesos, gates e DAG. Cria novos hashes.
• Conselheiro — aprova premissas estratégicas. Assina PDFs executivos.
• Auditor — acesso somente-leitura a todo o histórico, incluindo snapshots.

22.2 · Login e autenticação

Acesso por SSO institucional (SAML 2.0). Sessão expira em 4 horas; reautenticação requer second factor para papéis Calibrador, Conselheiro e Auditor. Tentativas falhas registradas em log; 5 falhas consecutivas bloqueiam conta por 30 minutos. Recomendação OWASP ASVS Level 2 implementada integralmente; rotação de credenciais SAML a cada 90 dias.

22.3 · Pipelines oficiais

O agente roda três pipelines em cadência fixa:

• Pipeline mensal (M) — todo dia 5, 03h00 BRT. Atualiza dados primários, recalcula Score sem mudar pesos.
• Pipeline trimestral (T) — dias 5/jan, abr, jul, out. Inclui revisão de DAG, comitê acadêmico assina antes de liberar.
• Pipeline anual (A) — dia 15/jan. Calibração estratégica de pesos pelo Conselho. Bloqueia outros pipelines até liberação.
• Pipeline excepcional (E) — apenas por evento (choque exógeno, mudança constitucional, novo Censo). Exige autorização do presidente do Conselho e fica marcado como execução excepcional no histórico.

22.4 · Lendo os logs

Logs disponíveis em /admin/logs (somente Auditor e Calibrador):

• execução — duração, hash gerado, alertas, falhas.
• acesso — quem logou, papel, telas visitadas, tempo de sessão.
• auditoria — todas as alterações de pesos, gates, DAG e premissas, com diff completo.
• exportação — todo PDF gerado, com hash, autor, destinatário declarado.