merge

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: `@<codigo>:` (onde `<codigo>` 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`)