Files
Investidor-V2/docs/investmoz/v2/primeiro-percurso-ativo.md
T

114 lines
17 KiB
Markdown

# Primeiro percurso ativo — acompanhamento pendente
8 de outubro de 2026. Não foi criado dossier ou pedido nesta execução.
## Constatações por leitura
A base ativa `investemoz:5432` mantém as duas migrations instaladas, num total de 78. Às 10:02 UTC existiam zero dossiers e zero pedidos do novo Balcão. A leitura foi realizada em transação `READ ONLY`, sem alterações de dados.
A consulta detalhada corrigiu a interpretação do contador anterior: existem **dois registos publicados do mesmo serviço**, não dois serviços distintos:
| Código | Versão publicada | Título |
| --------------------- | ---------------- | ------------------------------------------- |
| `project-preparation` | 1 | Preparar e submeter dossier de investimento |
| `project-preparation` | 2 | Preparar e submeter dossier de investimento |
Não se apagou nem alterou qualquer versão. A escolha/reutilização da versão pela interface ainda precisa de observação na sessão autorizada. Evidência privada: `first-active-services.json` e `active-confirmation.json`, em `storage/app/private/investmoz-v2`.
## Limitação da interface
A ferramenta de navegação não apresentou browsers disponíveis. As tentativas de abrir Chrome e o navegador integrado devolveram `Browser is not available`. Assim, não foi possível abrir o painel, verificar a conta/sessão do utilizador ou observar serviços/dossiers pela interface. Não foram utilizados browsers QA, contas sintéticas, impersonação ou escritas SQL como alternativa.
Painel a abrir na sessão do utilizador: `http://127.0.0.1:8000/balcao-virtual/painel`. É necessário disponibilizar essa sessão à capacidade de navegação, ou continuar os passos manualmente com o utilizador. Não solicitar nem registar senha, OTP ou cookies de sessão.
## Dados e etapas pendentes
O utilizador ainda não forneceu dados reais para o primeiro dossier/pedido. Para o serviço publicado, a definição exige na submissão nome do projeto, descrição/objetivo, moeda e valor do investimento. Localização/fonte, cronograma, empregos e financiamento são opcionais; fundamento é obrigatório apenas quando o investidor declarar regime especial. Pressupostos desconhecidos não serão inventados.
| Etapa | Resultado |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Abrir painel e verificar conta | Pendente: navegador indisponível |
| Apresentar serviços na interface | Pendente; dois registos/versões confirmados apenas por leitura da base |
| Reutilizar/criar dossier adequado | Pendente: dados reais e interface; zero dossiers constatados nesta leitura |
| Preencher e guardar rascunho | Não executado |
| Sair/regressar e verificar recuperação | Não executado |
| Pré-visualização e confirmação do utilizador | Pendente; nenhuma submissão autorizada sobre conteúdo concreto |
| Submissão, protocolo, recibo, linha temporal e notificação | Não executado; nenhum resultado inventado |
| Encaminhamento ao responsável | Pendente: verificar responsável existente e autorizado no fluxo; nenhuma atribuição ou resposta criada |
Os anexos continuam sujeitos ao scan real. ClamD permanecia indisponível na verificação anterior; não houve novo scan nem mudança de estado de ficheiros. Não se deve inferir segurança a partir de fixtures QA ou da instalação do módulo. A preparação sem anexos pode prosseguir quando houver sessão e dados reais.
Guardar rascunho será executado apenas pela interface com os dados fornecidos. A submissão só será executada depois de apresentar o conteúdo concreto e receber a confirmação pedida pelo utilizador.
## Investigação da ação do painel — 8 de outubro
Página indicada pelo utilizador: `/balcao-virtual/painel`. O botão no código atual é **Preparar dossier**, não «Validar». Envia `POST /balcao-virtual/dossiers`; criar dossier não submete um pedido. Às **10:09:32 UTC**, a leitura ativa ainda encontrou **zero dossiers e zero pedidos**. Não há alteração de criação persistida para repetir. Essa ausência não demonstra, por si só, se a tentativa chegou ao servidor; não foi capturada uma resposta HTTP da sessão real, nem inferido um motivo específico para a tentativa do utilizador.
A ação foi corrigida para apresentar progresso, impedir novo envio durante a operação com bloqueio imediato e manter a chave idempotente. Sucesso apresenta uma mensagem visível no dossier: foi guardado, a próxima ação é escolher serviço e preparar rascunho, nenhum pedido foi submetido. Falhas de validação mantêm os campos e mostram erros; conflito, falta de autorização, sessão expirada e indisponibilidade mostram motivo em alerta. Falha de ligação informa que o resultado não pôde ser confirmado e orienta consultar dossiers antes de repetir, preservando os dados.
Testes exclusivamente em `investmoz_v2_20261008_test:55441`: **19 testes PHP, 287 asserções**, PHPStan, TypeScript, lint e build aprovados. O teste HTTP confirma persistência, redirecionamento, mensagem de sessão, recuperação e idempotência, com zero pedidos submetidos. Evidência privada: `panel-tests.txt`, `panel-phpstan.txt`, `panel-types.txt`, `panel-lint.txt`, `panel-build.txt`. Cópias anteriores dos dois ficheiros de produção: `panel-before`.
Não foi repetida nenhuma escrita na base ativa. O novo feedback está no código local; a confirmação do percurso com dados reais continua pendente de execução do utilizador pela interface. ClamD e as restrições documentais mantêm-se.
A validação automatizada no navegador QA passou, sem erros JavaScript: validação, HTTP 409 e falha de ligação preservaram o título; duplo clique durante o envio originou **um único POST de criação bem-sucedida**; confirmação e próxima ação ficaram visíveis; sair para o painel e reabrir recuperou o mesmo dossier persistido; zero pedidos submetidos. Evidência: `panel-browser-evidence.json`. O contador de POST dessa evidência refere-se à fase de sucesso, não às tentativas de erro do teste.
Leitura ativa final às **10:13:50 UTC**: continuam zero dossiers e zero pedidos. O motivo concreto da tentativa real anterior permanece indeterminado sem captura da respetiva resposta na sessão do utilizador; não foi declarado como falha de consentimento ou de rede por inferência.
# Correção da revisão final do simulador — 8 de outubro de 2026
A indicação «só aparece Limpar este rascunho» identifica o rodapé de `SimulationForm`, distinto da criação de dossier no painel. Antes desta correção, a revisão final apenas permitia limpar; «Validar e calcular no servidor» aparecia apenas na etapa fiscal de cenários personalizados. A correção anterior do painel mantém-se.
Foi acrescentado «Validar este rascunho» na revisão final. Reutiliza as verificações existentes, conserva os campos e regressa à etapa com erros. A verificação local identifica explicitamente o seu âmbito e a próxima ação, sem afirmar gravação, elegibilidade ou aprovação. Em cenários personalizados encaminha para o cálculo determinístico existente, com bloqueio de execução duplicada; o resultado concluído indica a próxima ação. Nenhum botão desta correção submete um pedido ao Balcão.
QA isolada: 23 testes das regras do formulário passaram; verificação TypeScript passou. O ensaio de navegador em `investmoz_v2_20261008_test:55441` demonstrou o botão na revisão, mensagem de verificação local e próxima ação, com zero submissões ao Balcão. Evidências privadas: `review-rules.txt`, `review-browser-evidence.json` e `review-final-qa.png`. O ensaio final não certifica um cálculo fiscal legal nem o percurso autenticado real do utilizador.
Leitura ativa em **2026-10-08, 15:00:18 UTC**, em transação `READ ONLY`: um dossier, zero pedidos, 78 migrations; instalação anterior preservada. Não foi repetida qualquer escrita ativa e não é possível concluir, pelos totais, quem criou o dossier ou se a tentativa de validação chegou ao servidor. Continua pendente a preparação e confirmação explícita do primeiro pedido real. Restrições dos anexos/ClamD mantidas.
# Resumo visível e separação entre validação e cálculo — 8 de outubro
A implementação anterior podia deixar a mensagem fora do campo visível e, no modo personalizado, mudar para a etapa fiscal sem resumo. `SimulationForm` passa a apresentar um resumo focável, com deslocação até à mensagem, campos verificados, pendências/inconsistências com ligações para correção e próxima ação. Preserva os dados e mantém a revisão aberta. A validação é local: **não calcula valores e não envia HTTP de validação**; gravação automática, cálculo determinístico no servidor e submissão são operações distintas. O cálculo personalizado exige o botão próprio da etapa fiscal.
QA em navegador, larguras 1440 e 390: campo pendente, correção, nova validação, foco no resumo dentro do viewport e recuperação após guardar e recarregar demonstrados. O teste captura métodos, rotas e estados HTTP em prova privada `review-summary-browser.json`; nenhuma submissão ao Balcão. Regras do formulário: 23 testes passaram; TypeScript e verificação de código passaram. Evidências adicionais: `review-summary-*.txt` e capturas `review-summary-1440.png`/`review-summary-390.png`.
Inspeção ativa em **15:14:26 UTC**, exclusivamente `READ ONLY`: um dossier existente, com versão e referências preservadas, zero pedidos associados. Metadados privados em `active-dossier-inspection.json`; não foram repetidas escritas nem submetidos pedidos. Não houve acesso à sessão do navegador real do utilizador; as capturas HTTP correspondem a QA, não à tentativa ativa.
# Limite da prova de recuperação em QA
O registo HTTP do ensaio mostra `422` na criação automática do rascunho de teste: a recuperação demonstrada foi a dos dados locais da sessão, não uma gravação confirmada no servidor. Este resultado permanece explícito e não certifica recuperação numa nova sessão/dispositivo. O cálculo separado devolveu `202` e a consulta subsequente `200`, com resultado concluído. Nenhuma destas respostas corresponde a submissão ao Balcão.
# Diagnóstico e correção do HTTP 422 — 8 de outubro de 2026
Resposta real capturada em QA: `economic_snapshot.preferred_language` rejeitado com «The selected economic_snapshot.preferred_language is invalid.» O cenário de teste enviava `pt`; `StoreSimulationFormDraftRequest` e as opções do formulário aceitam `pt-MZ` ou `en`. Não se tratava de recusa da classificação aduaneira nem de falha do cálculo. O fixture anterior foi corrigido para `pt-MZ`, mantendo as regras do servidor.
Os erros de snapshots devolvidos pela API são agora associados aos campos de origem. A gravação recusada mostra um aviso, ligações para os campos e o erro junto ao respetivo controlo; não limpa os dados. Uma correção elimina o erro do campo editado e a confirmação de gravação elimina os erros anteriores. Há teste da extração de erros pessoais/económicos, índices de listas e respostas inválidas.
QA em navegador: reproduzido o 422 com `pt`, demonstrado `aria-invalid` no idioma, selecionado Português (Moçambique), confirmado POST `201`. Guardado também o snapshot numa conta QA existente com `If-Match`; uma nova sessão autenticada, sem armazenamento local do rascunho, recuperou do servidor a base introduzida. Validação local e cálculo continuam separados, sem submissão ao Balcão. Provas privadas: `draft-422-response.json`, `draft-422-browser.json`, `draft-422-rules.txt`, `draft-422-types.txt`, `draft-422-build.txt`. As provas anteriores de recuperação apenas local não foram convertidas retroativamente em sucesso no servidor.
Nenhuma escrita, submissão ou novo ensaio foi executado na base ativa neste diagnóstico.
# Próxima ação ajustada à finalidade
A revisão final já não encaminha uma simulação para preparar um pedido no Balcão. `simulate_only` orienta para ferramentas de cálculo e distingue consulta de parâmetros de cálculo; `request_facilitation` exige confirmação de gravação no servidor antes de continuar no Balcão. As restantes finalidades orientam para parceiros, financiamento, preparação da oportunidade ou dossier/plano, conforme a escolha. Pendências continuam a ter prioridade. Alteração de apresentação verificada por TypeScript e lint; nenhuma escrita ativa ou submissão.
# Resumo com nomes/valores e ação direta de cálculo
Os campos verificados são apresentados em pares de nome/valor, com texto legível, sem listas vazias. Valores pessoais não são repetidos: o resumo identifica que o conteúdo permanece disponível no campo original. Não envia nem publica esses valores. O resumo tem foco e deslocação própria, incluindo em ecrã móvel.
Para simulação, uma ação direta abre as ferramentas e a consulta fiscal sem alterar o modo escolhido. Se o utilizador já escolheu o modo personalizado, a ação calcula explicitamente a operação percentual com a base/taxa/redução declaradas; não calcula imposto legal. A consulta sem parâmetros aprovados identifica componente, período e âmbito ausentes e conserva o resultado indeterminado. Não inventa um catálogo de parâmetros obrigatórios nem preenche lacunas com zero.
QA de navegador: nomes e valores não vazios, correção e recuperação do rascunho, ação direta até ao resultado personalizado e consulta fiscal indeterminada sem mudança de modo. Evidências privadas: `review-summary-browser.json`, `summary-values-approved.json` e capturas `review-summary-*.png`. Nenhum pedido submetido nem alteração na base ativa. TypeScript e lint verificados.
# Ações exatas do formulário e compilação servida
Página do formulário: `/simulador-fiscal`; `portal/services.tsx` monta `SimulationForm`. «Validar este rascunho» chama `validateFinalReview`, uma verificação local; não é a ação de abertura/cálculo. A ação anterior estava condicionada a um resumo sem pendências e podia regressar silenciosamente quando não encontrava a etapa fiscal. Agora «Abrir cálculo» e «Consultar parâmetros fiscais» estão acessíveis independentemente das pendências da revisão, com eventos separados, destino focável e erro visível se a etapa não existir. Não mudam finalidade nem pressupostos; a consulta de parâmetros não converte o modo do rascunho. O cálculo continua a exigir execução explícita na ferramenta aberta.
GET ativo em **16:00:34 UTC** devolveu HTTP 200 e os assets atuais, incluindo `services-r6EkfdY-.js`, sem `public/hot`; evidência privada `exact-actions-active-assets.json`. Não foi possível observar o cache ou o clique do separador real do utilizador. Esta constatação valida o conteúdo servido, não certifica o estado da sessão do utilizador.
QA desde o ecrã de revisão: validação, clique em «Abrir cálculo», foco em `draft-tool-calculation`, execução explícita, resposta HTTP e resultado concluído; testado em 1440 e 390. Consulta fiscal desde a revisão também aberta, sem alteração de modo e com parâmetros ausentes/resultado indeterminado. Provas `review-summary-browser.json` e `summary-values-approved.json`; TypeScript/lint passaram. Nenhum dossier criado nem pedido submetido na base ativa durante este diagnóstico.
# Confirmação e consolidação das correções
Em 8 de outubro, o utilizador pediu o registo da confirmação e a consolidação das correções num commit. Fica confirmado o ensaio QA desde a revisão até à abertura da ferramenta e ao resultado, em computador e móvel, e a disponibilização da compilação atual pelo servidor. A consulta fiscal preserva o modo escolhido e mantém lacunas indeterminadas. A sessão/cache do navegador real do utilizador continua sem observação direta; não se declara por isso um percurso ativo concluído. Não foram criados dossiers ou submetidos pedidos ativos durante estas correções.
O commit reúne o formulário, a consulta fiscal, o tratamento de erros API, os testes e estes registos. As evidências privadas não entram no commit. A retoma do backlog V2 mantém separadas as pendências de ClamD real, identidade do operador, fontes/contactos institucionais e primeiro pedido real com confirmação do investidor; nenhum sucesso QA resolve automaticamente essas pendências.