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

27 lines
1.5 KiB
Markdown

# 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
- [x] Artefatos dependentes revisados
- [x] Nenhuma regra ficou implícita
- [x] Referências cruzadas e linters validados
- [x] Memória do projeto e da IA atualizadas