diff --git a/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md b/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md new file mode 100644 index 0000000..af2b237 --- /dev/null +++ b/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md @@ -0,0 +1,27 @@ +# 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