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..e2c961f --- /dev/null +++ b/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md @@ -0,0 +1,44 @@ +# Registro de Otimizações da Sessão — Aprimoramento da IA + +**Data:** 18/08/2026 +**Sessão / Contexto:** Padronização do Parecer do Avaliador, Validação Pré-Envio de Avaliações, Modularização (<250 linhas) e Recálculo Global de Hashes `info`. + +--- + +## 📌 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. +- Documentação co-localizada: `qualifica-back/src/_FILAS/_recalcular_todos_infos.regras-negocio.md`. + +### 2. Exibição e Formatação do Parecer do Avaliador no Painel da Empresa +- Estrutura visual em 3 linhas: + 1. Identificação: `@:` (onde `` são os 8 primeiros caracteres do UUID do avaliador). + 2. Status/Ação: `Solicitado Correção`, `Reprovado` ou `Aprovado`. + 3. Texto do Parecer: mensagem preenchida pelo avaliador no evento de avaliação. +- Bloqueio estrito de logs de sistema e transições automáticas (`PADROES_SISTEMA_BLOQUEADOS` e `STATUS_SEM_PARECER`). + +### 3. Validação Pré-Envio vs. Progresso da Avaliação +- `validarPayloadEExibirAlertaInvalido` não deve exigir preenchimento estrito de anexos para perguntas: + - Já marcadas como `conforme`, `aprovado`, `nao_aplicavel` ou `isento`. + - Opcionais (`obrigatorio: false`) com preenchimento parcial ou rascunho. +- Permite que avaliações com 100% de progresso sejam transmitidas sem bloqueio falso de pendência. + +### 4. Limite de Linhas e Modularização (Workflow `otimizar-codigos`) +- Respeitado o limite de 250 linhas por arquivo em todo o módulo `qualifica`: + - `PainelNivel3Campos.vue` (219 linhas) modularizado com `PainelNivel3Header.vue` (133 linhas). + - `parecer-avaliador.ts` (182 linhas) modularizado com `parecer-avaliador-filtros.ts` (187 linhas). + +--- + +## 🔍 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 +- [x] Build de produção verificado com sucesso (`exit code 0`)