From f4a86f10798b8b5b0bf23726e7e64057082f4d56 Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Tue, 18 Aug 2026 10:39:18 -0300 Subject: [PATCH 1/2] melhorias nas regras doa agent --- ...mizacoes-sessao-2026-08-18-aprimorar-ia.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md 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 From f107814aa711f7bff5459413e24c8ae686c3082f Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Tue, 18 Aug 2026 10:41:22 -0300 Subject: [PATCH 2/2] agent --- ...mizacoes-sessao-2026-08-18-aprimorar-ia.md | 23 ++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md b/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md index af2b237..e2c961f 100644 --- a/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md +++ b/memory/registro-otimizacoes-sessao-2026-08-18-aprimorar-ia.md @@ -1,7 +1,7 @@ # 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`. +**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`. --- @@ -13,9 +13,25 @@ - **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. 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`. +### 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). --- @@ -25,3 +41,4 @@ - [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`)