# 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`)