.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 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

• Artefatos dependentes revisados
• Nenhuma regra ficou implícita
• Referências cruzadas e linters validados
• Memória do projeto e da IA atualizadas
• Build de produção verificado com sucesso (exit code 0)