.agent/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md

Registro de Otimizações da Sessão — Aprimoramento da IA

Data: 18/08/2026
Sessão / Contexto: Padronização e documentação operacional do recálculo global de colunas info e controle do arquivo hash_INFOS.json.

---

📌 Principais Aprendizados e Regras Consolidadas

1. Recálculo Global e Cache de Hashes (hash_INFOS.json)

• O controle de integridade e versão das funções geradoras de info (qualifica-back/src/INFO) é persistido no arquivo DADOS-LOCAIS/controle/hash_INFOS.json (resolvido por caminhoLocal(["controle"], "hash_INFOS.json")).
• Para forçar a reconstrução total de todos os dados de info em todos os inquilinos e tabelas do sistema:
  • Ação Direta: Deletar o arquivo DADOS-LOCAIS/controle/hash_INFOS.json (ou /hash_INFOS.json).
  • Ação via Fila (BullMQ): Disparar o job passando o parâmetro { ignoreHash: true }.
• O worker recalcular_todos_infos gera novamente o arquivo de hashes ao término de uma varredura completa.

2. Documentação Co-localizada de Regras de Negócio

• Criado o arquivo qualifica-back/src/_FILAS/_recalcular_todos_infos.regras-negocio.md e vinculada a referência no topo de qualifica-back/src/_FILAS/_recalcular_todos_infos.ts, em conformidade com a regra regras-negocio-md.md.

---

🔍 Checklist de Verificação de Artefatos

• Artefatos dependentes revisados
• Nenhuma regra ficou implícita
• Referências cruzadas e linters validados
• Memória do projeto e da IA atualizadas