Add contextual filling help across forms and fiscal simulator steps
tests / ci (push) Waiting to run

This commit is contained in:
2026-11-17 10:01:43 +02:00
parent c0d62d4e89
commit ded66878af
8 changed files with 990 additions and 2 deletions
@@ -10338,3 +10338,14 @@ Regressão final do candidato: 1 977 testes frontend aprovados após compilaçã
## 17/11/2026 — GUIA-PASSO-20261117: correcção da abertura automática
Verificação autenticada online no dossier sintético db85f087-0737-4164-892a-4fa4fe1313df: os 19 botões de ajuda abriram/fecharam e o percurso Seguinte mostrou as 19 explicações completas. Identificado conflito entre focus/click do summary e o toggle nativo: uma etapa podia fechar-se depois da selecção automática da ajuda. Correcção limitada ao componente: ignorar summary em focus/click e observar o toggle nativo em captura depois da abertura. Fecho deliberado continua possível; o guia fechado permanece pausado. Regressão executa os handlers reais e confirma a sequência; ensaio do componente real no navegador confirmou fecho, reabertura e selecção de outra etapa. Tipos/lint focado aprovados. Sem alterações nos dados, estados, formulários ou permissões. Instalação pelo mesmo executor, com backup/restauro fresco; conferir recibo posterior e repetir as 19 etapas online antes da aceitação.
## 17/11/2026 — AJUDA-FORMULARIOS-20261117: ajuda ao preenchimento transversal
Pedido expresso do proprietário: estender a ajuda ao simulador fiscal e aos restantes formulários. Implementação sobre c0d62d4e, mantendo o guia das 19 etapas e os formulários existentes. Componente comum montado uma vez em app.tsx, sem alterar/embrulhar os formulários nem os seus eventos de gravação. Detecta controlos nativos e ARIA editáveis dentro de main/dialog, acompanha o foco e apresenta Ajuda neste passo, instrução por campo, obrigatoriedade declarada pelo formulário, exemplos quando adequados e indicações já associadas via aria-describedby. Permite fechar, reabrir, consultar o campo anterior/seguinte do mesmo grupo e desligar a abertura automática neste navegador. Guarda apenas a preferência on/off; não lê valores, cria FormData, guarda dados nem faz pedidos de rede. Campos ocultos, desactivados, só de leitura e em details fechado ficam fora da sequência. Alterações de rótulo, indicação, estado e conteúdo são acompanhadas sem remontar os campos.
Simulador: metadados do passo adaptativo e botão junto ao título actual; instruções para intenção, identidade, mercado, localização, recursos, investimento/financiamento, operação fiscal, documentos, revisão e os restantes passos existentes. O catálogo de campos orienta NUIT, residência, moeda, períodos, volumes, receitas, custos, montantes, percentagens, documentos, fontes e contactos. Não cria taxas, regras, dispensas ou pagamentos; os cálculos, fontes e validações permanecem nos componentes existentes. Campos sem orientação específica usam o tipo/rótulo e as instruções já presentes; não se declara curadoria jurídica individual de todos os campos.
Inventário estático: 112 ficheiros com 160 declarações de formulário, incluindo componentes e páginas; não equivale a 160 demonstrações funcionais individuais. Cobertura comum por tipos/estrutura e botão contextual; origem em main/dialog permite também formulários dinâmicos e modais. Os formulários que não tenham controlos editáveis visíveis não apresentam navegação por campos. Recibo de cobertura: C:/Users/macbook/Documents/Codex/2026-11-17/no/outputs/ajuda-formularios-cobertura.json.
QA: seis testes novos (instruções fiscais/financeiras, tipos, percursos adaptativos, ausência de leitura de valores/transporte, preferência e posição móvel); regressão de 1 984 testes frontend aprovada. Lint focado, tipos e compilação QA aprovados; alterações posteriores de indicação/data revistas e testes focados repetidos. Navegador com componente real e dados sintéticos: passos, campo seguinte limitado ao grupo, campos ocultos/desactivados, e-mail, palavra-passe sem exposição do valor, checkbox ARIA com label for, ficheiro dinâmico, fecho/reabertura, preferência após recarregar, zero submissões e ecrã390px sem sobrepor o campo. Testes em StrictMode. A publicação segue o executor normal e terá recibo posterior. Backup/restauro fresco de 195 tabelas/417 ficheiros preparado em /var/backups/investmoz-form-help-20261117/backup; sem alterações de dados, schema, permissões, parâmetros fiscais ou executor. Mantidas as aprovações, limitações anteriores e os restantes critérios da matriz.
File diff suppressed because one or more lines are too long