diff --git a/docs/investmoz/unification/traceability-and-manual.md b/docs/investmoz/unification/traceability-and-manual.md index 3d5bcd04..cab7f4e9 100644 --- a/docs/investmoz/unification/traceability-and-manual.md +++ b/docs/investmoz/unification/traceability-and-manual.md @@ -10511,3 +10511,15 @@ Implementação QA `9f7dd7df`, sem instalação. F16 passa a INTEGRADO E VALIDAD F16: **APROVADO E ENCERRADO EM QA**, por decisão do proprietário, com base nas provas de `9f7dd7df` e no registo `2f4ba962`. F31 conserva uma única linha na matriz de 88 requisitos, com dois critérios: **F31-A INTEGRADO E VALIDADO / APTO EM QA**, para o plano configurável pelo investidor; **F31-B reprodução parcial demonstrada, NÃO APTO para reprodução integral fiel e reconciliada**, por limitações documentais quantificadas. Serviços, departamentos, pessoal, remunerações e custos não dependem das linhas do exemplo; a estrutura varia com o empreendimento, conforme clarificação `f708b77f` e provas aceites dos Pacotes 1/2/4 e E8/E9. Evidências, âmbito e limitações discriminados na [matriz existente](../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md), secção «Decisão de 20/11/2026 — encerramento de F16 e aceitação separada de F31». Esta decisão substitui a leitura anterior de F31 como um único bloqueio: as divergências do exemplo não se transferem para planos reais. Não se introduziram rubricas de ajuste ou novos requisitos; não houve alteração funcional, repetição de testes, instalação ou publicação. As restantes linhas e pendências independentes mantêm-se. + +### 20/11/2026 — retoma pela continuidade e pesquisa financeira + +Revisão 1 dos dois documentos e matriz de 88 requisitos como referência. Delta local após `e299afda`: oportunidade conservada por separador nos menus e regresso à etapa; mudança explícita de dossier limpa o recorte anterior; contexto indisponível não mostra dossier antigo. C09/C10 continuam parciais até prova do percurso privado completo, incluindo B07. B02 demonstrado no critério de interface: Pesquisar exige localização e necessidade, incluindo submissão por Enter, com instrução acessível. Consulta pública e ligações existentes preservadas. + +E10 na [matriz única](../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md) discrimina causas, ficheiros e limites: 26 testes dirigidos, tipos/lint/build QA e prévia dos componentes reais em computador/390 px com transporte simulado; não é prova autenticada privada. F16/F31-A aprovados e F31-B documental permanecem intactos. Nenhuma outra linha encerrada; demografia e apresentação não recebem nova aceitação. Sem instalação, publicação ou dados activos alterados. + +### 20/11/2026 — prova integrada privada C09 C10 B07 concluída em QA + +E11 da matriz substitui a pendência de prova integrada de E10: aplicação real com login normal de investidor, dados sintéticos, dois dossiers, guarda e recuperação de oportunidade/contexto, referência financeira completa e pressupostos financeiros, preparação da empresa, comparação jurídica, mudança explícita e isolamento da segunda conta. Percurso demonstrado em computador e telemóvel emulado; entidade por definir preservada, sem constituição ou dados reais. Corrigidos apenas dois defeitos observados: ajuda que deslocava o botão antes do clique e resumo anterior durante recuperação de outro dossier. Oito testes afectados, tipos/lint/build QA e prova autenticada final aprovados. Não se repetiu a bateria financeira aceite nem se iniciou demografia. + +C09/C10/B07 passam a INTEGRADO E VALIDADO no âmbito demonstrado. B02 aceite em QA; F16/F31-A aprovados preservados; F31-B continua documental. Mantidas 88 linhas e restantes pendências. [Recibo, limites e hashes das provas](../v2/auditoria-portal/prova-integrada-c09-c10-b07-20261120.json); pormenores em E11 da matriz existente. Sem instalação, publicação, permissões alteradas ou migrações operacionais. diff --git a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md index e33a6c3f..a4eaf338 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -1208,8 +1208,8 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/` | C06 | PN P0010/P0023; ME P0123/P0125/P0155 | Portal — forma jurídica | Guardar e retomar comparação no mesmo dossier | INTEGRADO E VALIDADO | app/Services/CompanyPreparation.php; páginas da forma jurídica | 04d8db6c | E0: CompanyPreparationTest/CompanyComparisonTest, dez testes e 193 asserções; gravação, retoma, replay, conflito e isolamento. | | C07 | PN P0024–0027; ME P0126–0128/P0156 | Portal — forma jurídica | Questionário único por oito temas e frase expressamente pedida | IMPLEMENTADO MAS NÃO VALIDADO | resources/js/pages/investment/company-comparison.tsx | 04d8db6c | Código e testes de persistência documentados em E0; conferência visual específica do questionário permanece sem prova no saldo inicial. Não usar visual do relatório financeiro como substituto. | | C08 | PN P0005/P0029–0032; ME P0131/P0133/P0137 | Portal — simulador | Simplificação completa da calculadora e parâmetros fiscais, ajuda e sugestões | IMPLEMENTADO MAS NÃO VALIDADO | simulation-form.tsx; simulation-business-plan.tsx | 04d8db6c;722322f9 | Existem melhorias de edição, ajuda e tabelas; E7 regista divergência da preparação financeira assistida. Aprovação das tabelas não prova simplificação transversal. | -| C09 | PN P0031; ME P0017–0019/P0078–0081/P0135/P0157 | Portal — continuidade | Conservar intenção, empresa, sector, localização, necessidade e valores em todo o percurso Hotel/Agronegócio, ida/volta | IMPLEMENTADO MAS NÃO VALIDADO | app/Services/InvestorPath.php; preparation-intent.ts; simulation-form.tsx | base bae996e1;04d8db6c;28ff2408 | E0 valida planos e isolamento; E6 versões Hotel/arroz do relatório. Não há prova actual do percurso integral instituição → dossier → entidade → jurídica → simulador com todos os regressos. | -| C10 | ME P0079/P0081 | Portal — continuidade | Não escolher dossier antigo ou sector sem intervenção do investidor | IMPLEMENTADO MAS NÃO VALIDADO | InvestorPath.php; páginas investor-path; preparation-intent.ts | base bae996e1;04d8db6c | InvestorIntentContinuityTest e testes de intenção anteriores existem; saldo E7 mantém confirmação integral actual por demonstrar. Não foi demonstrada regressão nova nesta auditoria. | +| C09 | PN P0031; ME P0017–0019/P0078–0081/P0135/P0157 | Portal — continuidade | Conservar intenção, empresa, sector, localização, necessidade e valores em todo o percurso Hotel/Agronegócio, ida/volta | INTEGRADO E VALIDADO | dossier-navigation-context.tsx; investment-step-help.tsx; serviços e formulários existentes | e299afda + E10/E11 | E11: login normal, oportunidade associada pela pesquisa e confirmação, instituição → dossier → preparação da empresa → comparação jurídica → simulador → guarda/regresso, recarga e recuperação em 1440/390 px. Sector, localização, oportunidade, referência financeira e valores recuperados. Entidade por definir preservada; provas anteriores de associação de entidade existente reutilizadas. Não equivale a todos os cenários empresariais. | +| C10 | ME P0079/P0081 | Portal — continuidade | Não escolher dossier antigo ou sector sem intervenção do investidor | INTEGRADO E VALIDADO | dossier-navigation-context.tsx; navigation-focus.ts; provider e controlos existentes | e299afda + E10/E11 | E11: mudança explícita Hotel → Agricultura → Hotel pela interface, recarga e recuperação em 1440/390 px; Agricultura sem referências/resultados financeiros do Hotel. Corrigido cabeçalho transitório do dossier anterior, com regressão do estado pendente. Duas contas normais: dossiers/contexto 403 e rascunho 404 para o outro investidor; listagem sem dossiers alheios. | | C11 | ME P0080/P0170 | Portal — continuidade | Pesquisa/associação de oportunidades e orientação por conhecimento territorial e financeiro disponível | NÃO DETERMINADO | páginas investor-path; SectorContentAnalysis.php; OpportunitySearchFilters | 6e7dfdab (antepassado de c34670ef) | Módulos presentes, mas não há evidência suficiente de todos os resultados pedidos no mesmo contexto. Conteúdo disponível não prova adequação nem procura. | | D01 | ME P0031 | Portal — demografia | Turismo no selector de sectores da demografia | NÃO IMPLEMENTADO | app/Services/DemographicEvidence.php:33–35 | base c34670ef | Lista actual só commerce, industry, agriculture, education, health e general; Tourism não consta. Evidência directa de código, sem necessidade de teste repetido. | | D02 | ME P0024/P0032 | Portal — demografia | População inteira em todos os locais, incluindo tabela por idade/residência | NÃO IMPLEMENTADO | demographic-evidence.tsx:265; demographic-reading.ts:39 | fb076c17 (última alteração do componente na QA) | Síntese formata inteiros, mas tabela por dimensão imprime v.original_value. Correcção transversal incompleta; não considerar teste da síntese como cobertura de todos os valores. | @@ -1218,12 +1218,12 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/` | D05 | ME P0035 | Portal — demografia | Comparação legível por ano, números inteiros e advertência única | IMPLEMENTADO MAS NÃO VALIDADO | demographic-reading-summary.tsx; demographic-evidence.tsx; demographic-reading.ts | fb076c17 (incorporação selectiva) | Há resumo e tendências legíveis; divergências ainda imprimem valores originais. E7 contém prova de síntese; não prova todos os exemplos Bilene/Funhalouro 2026/2028 com advertência única. | | D06 | ME P0036 | Portal — demografia | Conservar Comércio e Serviços e apresentar ideias desse sector | IMPLEMENTADO MAS NÃO VALIDADO | DemographyController.php; sector-entry.tsx; SectorContentAnalysis.php | 6e7dfdab | Implementação sectorial é antepassada de c34670ef; não é código exclusivamente noutro ramo. Falta prova específica actual dos dois exemplos do documento. | | B01 | ME P0040–0047 | Portal — instituições financeiras | Coerência categoria/tipo/registo/necessidade; distinguir banco, seguradora, fundo e programa | INTEGRADO E VALIDADO | FundingCriteriaCoherenceTest.php; funding/index.tsx; serviços de pesquisa financeira | base bae996e1;04d8db6c | E0/E7: testes e provas V01–V03 anteriores para critérios, incompatibilidade e vazio válido; sem equivalências inventadas. | -| B02 | ME P0048 | Portal — instituições financeiras | Pesquisar apenas após localização e necessidade mínimas | NÃO IMPLEMENTADO | resources/js/pages/funding/index.tsx:409 | base c34670ef | Botão desactivado só por form.processing; não exige a conjunção localização e necessidade. Validação estrutural não satisfaz este critério. | +| B02 | ME P0048 | Portal — instituições financeiras | Pesquisar apenas após localização e necessidade mínimas | INTEGRADO E VALIDADO | resources/js/pages/funding/index.tsx; funding-journey-coherence.test.mjs | e299afda + delta local experience-20261120 | E10: botão desactivado enquanto faltar localização ou necessidade; submissão por Enter também impedida; instrução acessível junto do botão. Cinco testes da página real, incluindo combinações incompletas e critérios suficientes; prévia com transporte simulado em 1440/390 px. Consulta pública inicial e URLs directos preservados; não é nova validação de API nem prova de gravação privada B07. | | B03 | ME P0174–0177/P0196 | Portal — instituições financeiras | Pesquisa local por presença física; cobertura é consulta distinta | IMPLEMENTADO MAS NÃO VALIDADO | resources/js/pages/funding/index.tsx:71/321–338 | 04d8db6c;base bae996e1 | Modos physical/coverage existem, mas valor inicial é coverage. URL do anexo pede coverage/include_unknown; não comprova selecção local. Conversão da intenção para presença física em todas as entradas não validada. | | B04 | ME P0177/P0196 | Portal — instituições financeiras | Acção explícita noutra província sem alterar investimento nem categoria/tipo/finalidade | INTEGRADO E VALIDADO | funding/index.tsx:446–466; funding-journey-coherence.test.mjs | 04d8db6c | E0: draft-funding-tests.log e testes frontend da acção; limpa localização da consulta e mantém contexto, oportunidade e necessidade. | | B05 | ME P0178–0185 | Portal — instituições financeiras | Palavras-chave como refinamento opcional e critérios com rótulos úteis | INTEGRADO E VALIDADO | resources/js/pages/funding/index.tsx | 04d8db6c | E0: ajuda opcional implementada e testada; não transforma palavra-chave em requisito obrigatório. | | B06 | ME P0049 | Portal — instituições financeiras | Lista alternativa vazia útil por localização, ou omissão; selecção produz resultado | NÃO DETERMINADO | resources/js/pages/funding/index.tsx; funding/show.tsx | base bae996e1;04d8db6c | Acção noutra província provada; não localizada prova actual de todas as listas alternativas referidas nem selecção de cada instituição. | -| B07 | ME P0187–0202 | Portal — instituições financeiras | Guardar referência, versão, produto, local e necessidade e continuar no mesmo dossier | IMPLEMENTADO MAS NÃO VALIDADO | funding/show.tsx; serviços de referência financeira; InvestorPath.php | base bae996e1;04d8db6c | Código e protecções existentes; E7 mantém ligação completa instituição → dossier do exemplo por demonstrar. Provas de filtros/retorno não substituem a gravação desta referência. | +| B07 | ME P0187–0202 | Portal — instituições financeiras | Guardar referência, versão, produto, local e necessidade e continuar no mesmo dossier | INTEGRADO E VALIDADO | funding/show.tsx; funding-dossier-choice.tsx; FundingDossierPreparation.php; percurso existente | e299afda + E11 | E11: gravação normal pela interface e recuperação autenticada de referência, versão, produto, balcão, localidade, necessidade e oportunidade; regresso ao mesmo dossier, ida/volta por pesquisa, entidade, forma jurídica e simulador. Auditoria de leitura confirma relação proprietário/dossier/rascunho/resultado. Computador e telemóvel emulado, dados sintéticos; sem candidatura ou contacto externo. | | P01 | ME P0052 | Portal — carteira | Oportunidades incorporadas em corredores, clusters, âncoras e outras categorias | NÃO DETERMINADO | portfolio/index.tsx; opportunity-related-results.tsx; serviços de pesquisa | base bae996e1 | Módulos existentes. Não há correspondência documental completa entre oportunidades disponíveis e resultados dos exemplos na QA; falta de resultados não demonstra por si só inexistência ou perda. | | P02 | ME P0053 | Portal — carteira | Filtrar resultados exclusivamente pela província escolhida | IMPLEMENTADO MAS NÃO VALIDADO | portfolio/index.tsx; filtros territoriais partilhados | base bae996e1 | Filtros e URLs existem; E7 conserva teste do exemplo provincial como pendência. Não foi repetida pesquisa nem inventado resultado. | | P03 | ME P0054/P0062/P0066 | Portal — território | Deduplicar limites em carteira, zonas e negócios (Data/Edição) | IMPLEMENTADO MAS NÃO VALIDADO | territorial-source-evidence.tsx; portfolio/index.tsx; investment/zone.tsx | base bae996e1 | Existe apresentação partilhada; nenhuma prova suficiente dos três exemplos e da deduplicação por identidade/edição na QA actual. | @@ -1341,3 +1341,82 @@ Limites de F31-A: aceitação restrita às capacidades e percursos já demonstra **F31-B — REPRODUÇÃO PARCIAL DEMONSTRADA; NÃO APTO para reprodução integral fiel e reconciliada.** E9 conserva quatro serviços, cinco custos, sete departamentos e os localizadores do original; os totais anuais aprovados e a distribuição mensal ilustrativa continuam distintos das linhas documentais. Janeiro tem vendas discriminadas de 510,00 para total de 680,00 e custos conhecidos de 431,00 para subtotal de 586,00. As diferenças anuais de vendas/custos e os 1.600,00 de remunerações não repartidas em cada um de 2026/2027 estão quantificados em E9; falta também a repartição mensal do custo Marketing de 2025. Os dados disponíveis não demonstram uma repartição única dessas diferenças. O pessoal de 2025 já explicado não constitui pendência. Estas são **limitações da referência documental**, não dados obrigatórios dos planos reais nem motivo para bloquear F31-A. A reprodução integral exigiria uma correcção discriminada da referência ou uma decisão expressa sobre uma nova repartição ilustrativa, claramente identificada; nenhuma foi inventada ou aplicada. Não foram criadas rubricas artificiais, nem alterados totais, fórmulas ou dados. A presente execução apenas actualiza documentação, sem testes, instalação, publicação ou novos requisitos. Histórico perdido de QA e incidente de tradução HTTP 503 mantêm-se independentes. + +### Harmonização documental com a decisão de produto de 20/11/2026 + +Conferidos os dois originais na pasta já identificada em «Exemplares e cobertura»: PN e ME conservam exactamente os SHA256 ali registados, respectivamente `4f1e1dbc90c8a4888291201898f306c06e2e687843a754a04a9a8a56f459ab99` e `12d5efbea9fe2634208decd2261ca7bf8f332c4a5de41b89c549cc64150a909c`. Leitura directa do OOXML confirmou 347/202 parágrafos principais e 16/2 tabelas. Ambos permitem edição pelo atributo do ficheiro e não contêm protecção documental activa em `word/settings.xml`. Os originais não foram alterados. Esta é uma proposta textual de harmonização, sem revisão de paginação ou entrega de novos DOCX. + +Origem: decisão expressa do proprietário nesta conversa, registada no `AGENTS.md` da pasta principal `C:/laragon/www/portal-investidor/`. O plano deve adaptar-se à actividade económica, incluindo hotelaria, agricultura, indústria, comércio e prestação de serviços. A CAE contextualiza-o, sem impor departamentos, serviços ou estrutura de custos. Os exemplos são ilustrativos; as suas inconsistências não se transferem para planos reais. + +**Aditamentos mínimos propostos aos originais**, usando os localizadores da versão preservada, sem apagar ou substituir os pedidos funcionais: + +1. **PN após P0041; ME após P0152 — alcance do modelo:** «O plano financeiro adapta-se à actividade e à dimensão do empreendimento do investidor. Os produtos, serviços, departamentos, pessoal e rubricas de custos do exemplo são ilustrativos e não constituem uma estrutura obrigatória. Mantêm-se os campos, cálculos, validações, tabelas aplicáveis, persistência e exportações solicitados. As onze famílias de tabelas financeiras não dependem da adopção das linhas ou dos valores do exemplo.» +2. **PN após P0054; ME após P0148 — recolha de dados:** «As despesas, produtos, serviços e departamentos enumerados são exemplos de rubricas. O investidor configura as linhas adequadas ao seu empreendimento; a CAE não preenche nem impõe essa estrutura. Pedir os dados necessários aos cálculos aplicáveis, preservando as escolhas deliberadas e distinguindo dados desconhecidos de valores nulos e de situações não aplicáveis.» +3. **PN após P0018; ME após P0118, com remissão em P0154 — CAE:** «O recorte de hotelaria refere-se à consulta contextual do percurso Criar Hotel, com detalhe até ao nível 5. Não limita o plano financeiro a hotelaria nem determina a organização da empresa. A associação à intenção usa correspondências documentadas; quando existirem alternativas, exige escolha do investidor, conforme decisão já registada.» +4. **PN após P0100; ME após P0136 — cenário ilustrativo:** «O carregamento do exemplo é uma opção explícita e não é necessário para criar um plano com dados próprios. Preservar a identificação da origem e distinguir valores documentais de projecções ilustrativas e resultados calculados. As divergências e repartições ausentes do original são limitações da referência; não devem ser copiadas como pressupostos dos planos reais, preenchidas com ajustamentos artificiais ou usadas para bloquear esses planos. A reprodução integral do exemplo permanece uma pendência documental separada.» + +**Correspondência na matriz única de 88 linhas:** + +- Aditamentos 1 e 2: F01, F03–F05, F14–F16, F24–F25 e F31-A. Preservam os requisitos de despesas, activos, mercado, pessoal e relatório, com estrutura configurável; não tornam opcionais os dados necessários a um cálculo aplicável. +- Aditamento 3: C02, C03 e C05. Preserva o pedido contextual Hotel e as pendências respectivas; não o transforma numa restrição universal nem declara associação automática implementada. +- Aditamento 4: F27–F30, F31-B e F32. Preserva a consulta/edição/recuperação do exemplo e a rastreabilidade literal. F32 continua identificado e pendente quanto à correspondência documental; a sua formulação não cria novos rácios, textos obrigatórios ou estrutura fixa para os planos reais. V06 e V12 conservam a exigência de detectar inconsistências nos dados efectivamente usados pelo plano. + +F16 e F31-A permanecem **aprovados e encerrados em QA**, por aceitação expressa do proprietário. F31-B permanece **parcialmente demonstrado, com pendência documental**, sem bloquear planos com dados próprios. F31-A/B continuam critérios da única linha F31. Nenhuma linha foi acrescentada, eliminada ou encerrada por esta harmonização; os restantes estados e provas ficam preservados. A conclusão documental desta revisão não declara concluídos os dois documentos no seu conjunto. + +Conferência limitada à correspondência dos trechos, identidade dos exemplares, preservação das 88 linhas e revisão das diferenças documentais. Sem alterações funcionais, novos testes, instalação ou publicação. Não há caminhos de originais em falta. Pendência: incorporar os aditamentos numa futura revisão identificada dos DOCX, conservando estes exemplares e os localizadores históricos; não é necessário reconciliar valores ausentes para prosseguir nos restantes requisitos autorizados. + +### Revisão 1 dos dois documentos incorporada em 20/11/2026 + +Autorização expressa do proprietário: criar cópias identificadas como Revisão 1, incorporar exclusivamente os quatro aditamentos aprovados e a nota de revisão, preservando os originais. A pendência de incorporação do registo anterior fica encerrada nesta passagem; a harmonização documental não significa implementação integral dos 88 requisitos. + +Cópias em `docs/investmoz/v2/auditoria-portal/revisao-1-20261120/`: + +- `Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx`: nota datada no início; aditamentos após os parágrafos originais PN P0041, P0054, P0018 e P0100, respectivamente. SHA256 `919b01f42b441d8ed6b64050e558f19e0bd12596df021bc216aafceb3ff0a6ea`. +- `Mapa de erros 1 - Revisao 1.docx`: nota datada no início; aditamentos após ME P0152, P0148, P0118 e P0136, respectivamente; remissão aprovada após P0154 para a clarificação CAE. SHA256 `a001bdbc7f9daaa77f6e044ee6b5e5bcadbf8cb6a39c9c9c559b8fc7566e5597`. + +As notas registam data, âmbito, referência à decisão no `AGENTS.md` da pasta principal e à proposta acima. Explicam que os localizadores da matriz continuam a apontar para os originais, evitando confusão com a numeração deslocada pelas inserções. As quatro formulações foram transpostas literalmente da proposta aprovada, precedidas apenas da identificação do aditamento. + +Verificação documental: originais com os mesmos SHA256; todos os elementos anteriores do corpo mantidos exactamente e na mesma ordem, após leitura das cópias gravadas; todas as restantes partes dos pacotes DOCX, incluindo estilos, fórmulas, imagens, relações e objectos incorporados, idênticas por bytes. Preservadas 16 tabelas em PN e duas em ME, com valores e divergências intactos. Apenas `word/document.xml` recebeu as inserções. As 88 linhas da matriz permanecem exactamente inalteradas, conferidas por contagem e hash conjunto; a correspondência dos aditamentos é a registada acima. F16/F31-A continuam aprovados e encerrados em QA; F31-B continua parcialmente demonstrado, com pendência documental. Nenhuma outra linha foi encerrada. + +Legibilidade: documentos abertos em modo de leitura no Word; conferidas visualmente as 39 páginas de PN e as 15 de ME, incluindo nota, aditamentos e tabelas. PN renderizado por Word/PDF e Poppler do runtime; a exportação PDF de ME bloqueou, pelo que se usaram imagens nativas de cada página do Word, sem alterar o DOCX. O renderizador `render_docx.py` não dispunha de LibreOffice neste ambiente; não houve instalação. Não se entrega nem se declara validado um PDF de ME. Recibos e imagens internos: `outputs/harmonizacao-r1-20261120/{preservation.json,verification.json}` e `PN-page-*.png`/`ME-page-*.png`. + +Resultado: harmonização documental concluída, sem pendências deste âmbito. Permanecem as lacunas funcionais e a pendência documental F31-B já classificadas na matriz. Sem código funcional alterado, repetição de testes de software, instalação, publicação, migrações ou início de novos requisitos. + +### E10 — retoma da experiência do investidor em QA após Revisão 1 + +Autorização do proprietário para retomar os requisitos pendentes pela ordem continuidade/dossier, pesquisa financeira, demografia e apresentação. Base de implementação `e299afda`, na pasta isolada `portal-investidor-continuity-qa-20261120`; trabalho documental anterior preservado. Referências: os dois DOCX Revisão 1 acima, com hashes reconferidos e sem alteração, matriz única e `AGENTS.md` aplicável, incluindo a decisão de produto na pasta principal. Nenhuma estrutura organizacional ou valor do exemplo da TEMPO foi usado como obrigação de planos reais. + +Inventário de preservação deste recorte: F16 e F31-A mantêm aprovação/encerramento em QA; F31-B mantém pendência documental. As 88 identidades e fontes da matriz, as provas E0–E9 e todas as restantes classificações ficam preservadas. Não se identificou eliminação funcional no delta desta candidata. A pasta principal tem alterações e entregas demográficas distintas; a comparação com essas entregas deve preceder qualquer reposição ou nova implementação demográfica, sem presumir perda pela diferença entre ambientes. + +**Linhas desta entrega:** B02 passa a INTEGRADO E VALIDADO no critério público de interface; C09 e C10 recebem correcções delimitadas, conservando IMPLEMENTADO MAS NÃO VALIDADO. Não se encerrou C11 nem B07. Restantes linhas, incluindo D01–D06 e P01–P18, não recebem nova aceitação nesta passagem. São 88 linhas, agora 39 integradas/validadas, 29 implementadas mas não integralmente validadas (incluindo F31), 11 não determinadas e nove não implementadas. A contagem anterior é histórica. + +**C09/C10 — causa e correcção:** o foco guardado por separador conservava apenas dossier/etapa; perdia a oportunidade ao passar por um menu sem `context`/`opportunity`, e a mudança de etapa construía uma ligação sem oportunidade. O resumo dependia exclusivamente da query actual. Além disso, um contexto explícito ausente da lista autorizada podia deixar visível o dossier anterior. O foco local passa a conservar a oportunidade devolvida pelo servidor, sempre associado à identidade e ao dossier autorizado; os menus gerais, o resumo, o regresso à etapa e a ligação de edição conservam esse âmbito. Uma URL explícita do dossier sem oportunidade limpa o recorte anterior; a mudança deliberada de dossier não transporta a oportunidade; um contexto explícito indisponível deixa de mostrar o anterior. Não se alteraram permissões, contratos de API, preferência persistida no servidor, dados financeiros ou associações. + +Regressões executam o provider real, simulando transporte Inertia/API: ida/volta por menu geral, recarga, retoma de etapa, escolha de outro dossier, contexto indisponível, versão actual da preferência, actor/separador distintos e armazenamento inválido. Os testes existentes de herança, intenção própria, intervalo/origem do financiamento e pesquisa noutra província passaram. Isto demonstra o delta de navegação; não demonstra todo o percurso privado referido em C09/C10. A prova integrada autenticada e B07 continuam pendentes. + +**B02 — comportamento demonstrado:** botão Pesquisar habilitado apenas com necessidade e localização (referência territorial ou província); sem ambos, apresenta uma única instrução acessível e impede a submissão, incluindo por Enter. Critérios de dossier/oportunidade e restante pesquisa conservados. Não cria obrigatoriedade de palavras-chave nem altera consulta inicial, APIs ou compatibilidade de ligações antigas. A classificação corresponde ao pedido de ME P0048 sobre a disponibilidade do botão; não se estende à pertinência de resultados ou à continuidade privada. + +Verificação: 26 testes dirigidos em seis ficheiros; tipos, formatação/lint dos seis ficheiros alterados e build QA (2 893 módulos) aprovados. Avisos de build sobre dependência opcional `fontaine`, dimensão de chunks e tempos de plugins, sem falha. Prévia sintética dos componentes reais em navegador, 1440×1000 e 390×844, com transporte simulado: menus, oportunidade, retoma, mudança de dossier, bloqueio/desbloqueio da pesquisa e ausência de extravasamento; capturas inspeccionadas, zero erros JavaScript. O primeiro compilador da prévia tinha um export de estilo em falta e não incluía todas as classes CSS dos componentes; corrigidos apenas os auxiliares de QA, sem alteração do produto para adaptar o ensaio. Endpoints territoriais da prévia devolvem exclusivamente dados sintéticos. Não se apresenta esta prévia como sessão privada autenticada ou consulta de dados reais. + +Evidências internas: `outputs/experience-20261120/{tests.log,browser.json}` e capturas `1440-*`/`390-*`; scripts de prévia conservados no mesmo directório. Ficheiros de produto alterados: `resources/js/lib/navigation-focus.ts`, `resources/js/components/dossier-navigation-context.tsx` e `resources/js/pages/funding/index.tsx`; três testes dirigidos actualizados. Sem SQL, migrações, alteração de dados activos, instalação ou publicação. Continuação necessária: demonstrar o percurso privado completo C09/C10/B07, depois tratar o saldo financeiro e reconciliar as entregas demográficas existentes antes de corrigir D01–D06 e apresentação. + +### E11 — prova integrada privada C09 C10 B07 em QA + +Autorização específica do proprietário: concluir apenas a prova integrada, corrigindo defeitos concretamente demonstrados, sem iniciar demografia ou outras áreas. B02 aceite em QA pelo proprietário; F16/F31-A preservados como aprovados e F31-B mantém a pendência documental, sem reabertura. Referências: Revisão 1 dos dois DOCX, matriz única e `AGENTS.md`. As três linhas C09, C10 e B07 passam a INTEGRADO E VALIDADO na QA delimitada abaixo. Continuam **88 linhas**: 42 integradas/validadas, 26 implementadas mas não integralmente validadas, 11 não determinadas e nove não implementadas; F31 permanece na classificação parcial da linha-mãe. Nenhuma outra linha é encerrada nesta execução. + +Ambiente confirmado antes de escrever: servidor local `127.0.0.3:18720`, router com guarda para `continuity_20261120_test` em `127.0.0.1:55441`. Duas contas normais de investidor, sem `manage-portal`. Como o catálogo QA não tinha oportunidades nem instituições utilizáveis neste ensaio, foram preparados exclusivamente registos sintéticos de catálogo nessa base; não foram publicados conteúdos operacionais nem alteradas permissões. Dossiers, associações, escolha financeira e pressupostos foram criados/guardados pelo percurso normal da aplicação, com login pelo formulário, autenticação e CSRF existentes; sem injecção de sessão ou SQL para ligar dossiers/rascunhos/resultados. Não foram usados investidores reais ou cópias dos seus dados. + +Percurso demonstrado: formulário Os meus investimentos → dossiers Hotel e Agricultura → pesquisa e ficha de oportunidade → escolha explícita do dossier → editor, prévia e confirmação → pesquisa financeira com localização e necessidade → instituição/produto/balcão → guardar referência e continuar no mesmo dossier → preparar constituição da empresa → comparação jurídica → simulador → guardar pressupostos e devolver ao dossier (HTTP 200) → recarregar e recuperar → mudar explicitamente para Agricultura → regressar a Hotel. A conta do outro investidor foi autenticada separadamente e não conseguiu consultar o dossier ou o contexto (403), nem o rascunho (404); a sua listagem não incluiu os dossiers alheios. + +Validação repetida sobre a candidata corrigida, em **1440×1000 e 390×844 com emulação móvel**: oportunidade, sector, localidade e dossier correspondentes, referência financeira com a mesma versão/produto/balcão/necessidade, valores financeiros recuperados também nos controlos da interface, ausência dos dados financeiros de Hotel em Agricultura e regresso sem perda. Montantes exclusivamente sintéticos, introduzidos pelo ensaio: investimento `2500000.25`, receitas anuais `1200000` e custos anuais `600000`; não são valores do exemplo da TEMPO, resultados de viabilidade certificados ou pagamentos. Os dois dossiers usam a mesma localização sintética declarada e oportunidades/sectores distintos. A entidade por definir conserva-se e não impede a preparação; o suporte à associação de entidades existentes reutiliza as provas anteriores de `InvestorPromoterContinuityTest` e não significa constituição de uma empresa neste ensaio. + +**Dois defeitos concretos corrigidos durante a prova:** + +1. A ajuda automática, ao abrir no foco provocado pelo apontador, deslocava o botão de rever dados antes de terminar o clique. A causa foi isolada com a opção normal de ajuda desligada; após a correcção, as duas associações foram guardadas com ajuda automática activa. O componente passa a distinguir o foco do apontador e abre a orientação no clique completo, mantendo o foco por teclado e o comportamento dos disclosures. Regressão em `investment-step-help.test.mjs`. +2. Durante a mudança de dossier, o cabeçalho podia conservar o resumo anterior enquanto recuperava o novo contexto. Detectado nas capturas, apesar de os dados persistidos estarem correctos. O provider deixa imediatamente de apresentar o contexto carregado quando a URL explícita pede outro dossier/oportunidade. Regressão observa esse intervalo antes da conclusão da resposta; capturas finais conferidas com cabeçalho e corpo do mesmo dossier. + +Não foram alteradas fórmulas financeiras, fluxos de pagamento, permissões, dados reais ou contratos de integração. Os pressupostos guardados e a referência financeira foram ainda conferidos por auditoria somente de leitura, com actor equivalente ao ensaio; confirma proprietário, dossier, rascunho, resultado, oportunidade e ausência de referências/resultados de Hotel em Agricultura. O erro inicial de preparação de um registo sintético usava `geography_scope=local`, recusado pela constraint existente; a transacção foi revertida e corrigida para o valor documentado `specific`. A auditoria final verifica a coerência dessas fontes sintéticas. Não se atribuiu essa falha aos documentos ou ao utilizador. + +Verificações desta execução: **oito testes dirigidos aprovados**, incluindo as regressões de ajuda, foco por actor/separador e resumo pendente; tipos, lint/formatação e compilação QA aprovados (2 893 módulos). Reutilizados os 26 testes aceites de E10 e as provas financeiras anteriores cuja implementação não mudou. A prova de navegador final usa a aplicação real, sem transporte simulado, nos dois formatos; zero erros JavaScript. As sincronizações do ensaio aguardam a confirmação de guarda e verificam o valor efectivo das escolhas, incluindo os marcadores de opção já seleccionada; erros de selectores e capturas anteriores não são provas de defeitos funcionais. + +Recibo versionado e hashes: [prova integrada C09 C10 B07](prova-integrada-c09-c10-b07-20261120.json). Evidências internas em `outputs/integrated-c09-c10-b07-20261120/`: `navigation.json`, `navigation.log`, `audit.json`, `affected-tests.log`, `types.log`, `build.log` e capturas `1440-*`/`390-*`, inspeccionadas após a correcção do cabeçalho. Credenciais e estado de autenticação permanecem fora do controlo de versões. A aceitação refere-se ao percurso e aos limites demonstrados, não a todos os tamanhos de empresa, dispositivos físicos ou aos restantes requisitos da matriz. Instalação, publicação e migrações operacionais não executadas nem autorizadas. diff --git a/docs/investmoz/v2/auditoria-portal/prova-integrada-c09-c10-b07-20261120.json b/docs/investmoz/v2/auditoria-portal/prova-integrada-c09-c10-b07-20261120.json new file mode 100644 index 00000000..b37e552c --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/prova-integrada-c09-c10-b07-20261120.json @@ -0,0 +1,225 @@ +{ + "date": "2026-11-20", + "baseline": "e299afda", + "scope": [ + "C09", + "C10", + "B07" + ], + "environment": { + "base": "http://127.0.0.3:18720", + "database": "continuity_20261120_test", + "port": 55441, + "normal_investors": true, + "synthetic_data_only": true, + "mobile_emulated": true, + "operational_database_writes": false, + "operational_publication": false, + "installation": false + }, + "references": [ + { + "path": "docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx", + "sha256": "919b01f42b441d8ed6b64050e558f19e0bd12596df021bc216aafceb3ff0a6ea" + }, + { + "path": "docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Mapa de erros 1 - Revisao 1.docx", + "sha256": "a001bdbc7f9daaa77f6e044ee6b5e5bcadbf8cb6a39c9c9c559b8fc7566e5597" + } + ], + "acceptance": { + "C09": "Demonstrado em QA: oportunidade, sector, localização e valores conservados no percurso privado.", + "C10": "Demonstrado em QA: mudança explícita sem mistura; cabeçalho anterior ocultado durante recuperação; isolamento de utilizadores.", + "B07": "Demonstrado em QA: referência, versão, produto, balcão, território e necessidade guardados e recuperados no dossier correcto." + }, + "checks": { + "private_views": [ + { + "width": 1440, + "height": 1000, + "account_id": 32, + "steps": [ + "dossier", + "funding-search-detail-reload", + "company-preparation-reload", + "legal-comparison", + "financial-reload", + "explicit-dossier-switch", + "return-hotel" + ], + "contextPreserved": true, + "financialValuesRecovered": true, + "fundingReferenceRecovered": true, + "agricultureHasNoHotelFinancialData": true, + "mobileEmulated": false + }, + { + "width": 390, + "height": 844, + "account_id": 32, + "steps": [ + "dossier", + "funding-search-detail-reload", + "company-preparation-reload", + "legal-comparison", + "financial-reload", + "explicit-dossier-switch", + "return-hotel" + ], + "contextPreserved": true, + "financialValuesRecovered": true, + "fundingReferenceRecovered": true, + "agricultureHasNoHotelFinancialData": true, + "mobileEmulated": true + } + ], + "isolation": [ + { + "path": "/investimentos/84dd2bdd-c5df-4248-a9af-fb510089e96f?opportunity=opportunity%3A2", + "status": 403 + }, + { + "path": "/investimentos/84dd2bdd-c5df-4248-a9af-fb510089e96f/contexto", + "status": 403 + }, + { + "path": "/api/v1/simulation-drafts/69e05959-3992-4bb5-9e8c-aa051ba50503", + "status": 404 + } + ], + "financial_return": { + "result_id": "7b7101bc-e4aa-45da-83d9-2c91b76fc4dc", + "draft_id": "69e05959-3992-4bb5-9e8c-aa051ba50503", + "recorded_draft_version": 13 + }, + "regression_tests": 8, + "types": "passed", + "lint": "passed", + "qa_build": "passed" + }, + "limitations": [ + "Dados sintéticos e telemóvel emulado; não equivale a instalação, publicação ou ensaio em dispositivo físico.", + "Entidade por definir conservada no percurso. Associação de entidades existentes reutiliza a evidência anterior; não se criaram empresas reais.", + "Os dois dossiers de ensaio usam a mesma localização sintética declarada e sectores/oportunidades distintos." + ], + "code": [ + { + "path": "resources/js/components/dossier-navigation-context.tsx", + "sha256": "95b26437f5777471a1f6cce7f822881ac69800c8fca3542e8dd0d05f452673a1" + }, + { + "path": "resources/js/components/investment-step-help.tsx", + "sha256": "cbb05746db400c0bed56ad5c9c516068d56cf17a21ee94cc68cf28f3ad33ee67" + }, + { + "path": "resources/js/lib/navigation-focus.ts", + "sha256": "2754207e098c2b449de111e2ded910d3d9491410d701f143b53fd3e9f5e4d058" + }, + { + "path": "resources/js/pages/funding/index.tsx", + "sha256": "9e41a2b7b86fd86ea93bed3617961331cf2b061be5fe8850a49e349ccf6fb304" + }, + { + "path": "tests/frontend/navigation-context-integration.test.mjs", + "sha256": "0a6d13d0502eb7e23e2446716f10df183a4686184af63f2dfa74896d02a80501" + }, + { + "path": "tests/frontend/navigation-focus.test.mjs", + "sha256": "9cdca430230a22fadcf583f15c7862f8dbe404b2366352f4e9173099ba382643" + }, + { + "path": "tests/frontend/investment-step-help.test.mjs", + "sha256": "f4d9c97c7027d2e875ce525ccff28a887e7231113d41794c8628eb3e3d12d648" + }, + { + "path": "tests/frontend/funding-journey-coherence.test.mjs", + "sha256": "a122f00b2fe33165916f428e566b8f886cf167c5b345ae8ae6ad9dce539ba1a0" + } + ], + "evidence": [ + { + "path": "outputs/integrated-c09-c10-b07-20261120/navigation.json", + "sha256": "4460a443ad2cfe2c25d400adcc464791ab37b4f20e5b3b7702af402e2d54d9d6" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/navigation.log", + "sha256": "ec62ce1f76d33ea9da864eaf9e8d8864356ef992980bd1a2bb1118b929fb7fb9" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/audit.json", + "sha256": "49b68b60a2e7aa39e324ac843ca23bb5dabf2cd7a67ea31fa484b1ee7f701c50" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/affected-tests.log", + "sha256": "d2cfc513bce34819c39b25cee53c9f93d0dcfc55993997fc3ccc26637efb06cd" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/types.log", + "sha256": "82962651e47f564de653ad2883f8fd34e7dae4b4468e4ac459cb3331962a3879" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/build.log", + "sha256": "64ab5d30d47969be26b0301eadf230abdb15cd0f9433e4a1a05d1fb50c183675" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-company.png", + "sha256": "c407acc68d9a410dd54e63096e188ad56dc36e6ea293bc1c380cbdc716c133ad" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-dossier.png", + "sha256": "4abab65d9fe80d811b1362955d32dae309d46f8b165c6f6138741656fefc9087" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-financial-reload.png", + "sha256": "1c9e9d9aabf566039d5363a5ceaef0fe9ce0ff2a7146a27660f7439dfe4d6dc4" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-funding.png", + "sha256": "d88f3f60c0739fa726e372db0c477aa118e5c4bb39cf5f78e6a5d2ef64241417" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-legal.png", + "sha256": "e1fe51c2dbb16b07e68934a2b351debfae0e1c1d414b4d4bd84e8122115c7f01" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-other-investor-denied.png", + "sha256": "d0e03992646dd80e18bf18d379dfc8441735c1c59009c27a46b8fafacbbd041f" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-returned-hotel.png", + "sha256": "9bac10275cdace4646ea17dce5c9920a224668d5a846d3c0ed01128191d80fc5" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/1440-switched-agriculture.png", + "sha256": "1227c0bb18d43720ac72397defee6bad7827c17734046d02a3a99f5f1be74695" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-company.png", + "sha256": "97e3633e4a1ff314d681453c77f8e83d92352f6242457849179b51d1fffac29f" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-dossier.png", + "sha256": "2deb848800c7ee123f15de9dc2c51bce97a2362865e0497137ea5d14133e74fb" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-financial-reload.png", + "sha256": "e0d6866731adaf3900e59b32628933c5796e893b711ec51971fa4d38b2abce90" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-funding.png", + "sha256": "99511bee8bd2c23d7dc59134d29d8777d274c99c4dc24427ab6f562822a67b50" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-legal.png", + "sha256": "876604a0deaeee2a8e97b1a990d0754732f2e9ff3806f782cc54bac18083082e" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-returned-hotel.png", + "sha256": "a9c2543307f573a2e557737c013c4a5e07cc927adc6b5fefced723b7e9f181d3" + }, + { + "path": "outputs/integrated-c09-c10-b07-20261120/390-switched-agriculture.png", + "sha256": "61c21cdf1d00e136881b21daf7588499a564207a6559eefb306c1567544f1156" + } + ] +} diff --git a/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Mapa de erros 1 - Revisao 1.docx b/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Mapa de erros 1 - Revisao 1.docx new file mode 100644 index 00000000..10956015 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Mapa de erros 1 - Revisao 1.docx differ diff --git a/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx b/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx new file mode 100644 index 00000000..0efcfa9f Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx differ diff --git a/resources/js/components/dossier-navigation-context.tsx b/resources/js/components/dossier-navigation-context.tsx index 586cf8dd..4996c5bc 100644 --- a/resources/js/components/dossier-navigation-context.tsx +++ b/resources/js/components/dossier-navigation-context.tsx @@ -12,6 +12,7 @@ import { rememberNavigationFocus, } from '@/lib/navigation-focus'; export type NavigationView = { + context_opportunity?: string | null; case: { id: string; title: string; version: number }; phases: Record; steps: { @@ -105,7 +106,19 @@ export function NavigationContextProvider({ useEffect(() => { setHash(window.location.hash); }, [url]); - const current = loaded?.actor === actor ? loaded : null; + const pageLocation = new URL(url, 'https://context.invalid'); + const requestedCase = + url.match(/^\/investimentos\/([a-f0-9-]{36})(?:[/?#]|$)/i)?.[1] ?? + pageLocation.searchParams.get('context'); + const requestedOpportunity = pageLocation.searchParams.get('opportunity'); + // Never label the new page with the previous dossier while its request is pending. + const current = + loaded?.actor === actor && + (!requestedCase || loaded?.focus?.case_id === requestedCase) && + (!requestedOpportunity || + loaded?.view?.context_opportunity === requestedOpportunity) + ? loaded + : null; const active = current?.focus?.case_id ?? ''; useEffect(() => { if (!actor || !props.investorPathEnabled) return; @@ -163,13 +176,31 @@ export function NavigationContextProvider({ ) ).focus; } + // An explicit URL without an opportunity opens the whole dossier. + // A general menu preserves this tab's last server-confirmed scope. + const opportunity = direct + ? new URL(url, 'https://context.invalid').searchParams.get( + 'opportunity', + ) + : localFocus?.opportunity; + if (direct && !listing.contexts.some((c) => c.id === direct)) { + focus = null; + } const view = focus ? await contextApi( - `/investimentos/${focus.case_id}${direct === focus.case_id && new URL(url, 'https://context.invalid').searchParams.get('opportunity') ? '?opportunity=' + encodeURIComponent(new URL(url, 'https://context.invalid').searchParams.get('opportunity')!) : ''}`, + `/investimentos/${focus.case_id}${opportunity && (!direct || direct === focus.case_id) ? '?opportunity=' + encodeURIComponent(opportunity) : ''}`, ) : null; if (!stopped) { - rememberNavigationFocus(actor, focus); + rememberNavigationFocus( + actor, + focus + ? { + ...focus, + opportunity: view?.context_opportunity ?? null, + } + : null, + ); setLoaded({ actor, cases: listing.contexts, focus, view }); if (pref.message) setError(pref.message); } @@ -210,8 +241,13 @@ export function NavigationContextProvider({ ), ) .then(({ focus }) => { - rememberNavigationFocus(actor, focus); - const target = `/investimentos/${id}${step ? '#' + step : ''}`; + const opportunity = + id === active ? current.view?.context_opportunity : null; + rememberNavigationFocus(actor, { + ...focus, + opportunity: opportunity ?? null, + }); + const target = `/investimentos/${id}${opportunity ? '?opportunity=' + encodeURIComponent(opportunity) : ''}${step ? '#' + step : ''}`; if (url !== target) router.visit(target); else setReload((x) => x + 1); }) @@ -255,7 +291,9 @@ export function NavigationContextSummary() { const ref = saved?.selection; const params = new URLSearchParams(url.split('?')[1] ?? ''); const scopedChoice = saved?.opportunity_choices?.find( - (c) => c.opportunity.key === params.get('opportunity'), + (c) => + c.opportunity.key === + (params.get('opportunity') ?? view?.context_opportunity), ); const multiple = (saved?.opportunity_choices?.length ?? 0) > 1; const currentStep = view?.steps.find((s) => s.code === step); @@ -449,7 +487,7 @@ export function NavigationContextSummary() { {view.investment_context && ( Comparar e guardar oportunidade, sector ou localização diff --git a/resources/js/components/investment-step-help.tsx b/resources/js/components/investment-step-help.tsx index aeea6a3d..db82937e 100644 --- a/resources/js/components/investment-step-help.tsx +++ b/resources/js/components/investment-step-help.tsx @@ -41,6 +41,7 @@ export function InvestmentHelpGuide({ const [active, setActive] = useState(null); const [automatic, setAutomatic] = useState(true); const paused = useRef(false); + const pointerFocus = useRef(false); const key = helpPreferenceKey(user, flow); const firstCode = steps.some((step) => step.code === initialCode) ? initialCode @@ -151,8 +152,24 @@ export function InvestmentHelpGuide({
orient(event.target)} - onClickCapture={(event) => orient(event.target)} + onPointerDownCapture={() => { + pointerFocus.current = true; + }} + onPointerUpCapture={() => { + pointerFocus.current = false; + }} + onPointerCancelCapture={() => { + pointerFocus.current = false; + }} + onFocusCapture={(event) => { + // Opening inline help during pointer focus can move the + // target between pointerdown and click, losing the action. + if (!pointerFocus.current) orient(event.target); + }} + onClickCapture={(event) => { + pointerFocus.current = false; + orient(event.target); + }} onKeyDown={(event) => { if ( event.key === 'Escape' && diff --git a/resources/js/lib/navigation-focus.ts b/resources/js/lib/navigation-focus.ts index 29c7fcd2..c4ca5226 100644 --- a/resources/js/lib/navigation-focus.ts +++ b/resources/js/lib/navigation-focus.ts @@ -2,6 +2,7 @@ export type NavigationFocus = { case_id: string; step_code: string | null; version: number; + opportunity?: string | null; }; const key = (actor: number) => `investmoz-navigation-focus:${actor}`; /** A per-tab hint, never authority to access a dossier. Recheck the server listing. */ @@ -27,6 +28,12 @@ export function readNavigationFocus( case_id: value.case_id, step_code: value.step_code, version: value.version, + ...(value.opportunity === null || + (typeof value.opportunity === 'string' && + value.opportunity.length > 0 && + value.opportunity.length <= 100) + ? { opportunity: value.opportunity } + : {}), }; } catch { return null; diff --git a/resources/js/pages/funding/index.tsx b/resources/js/pages/funding/index.tsx index a9b0092d..ce0fd92e 100644 --- a/resources/js/pages/funding/index.tsx +++ b/resources/js/pages/funding/index.tsx @@ -90,6 +90,9 @@ function Index({ }); const applied = useRef(JSON.stringify(form.data)); const criteriaChanged = JSON.stringify(form.data) !== applied.current; + const searchReady = Boolean( + form.data.need && (form.data.territory || form.data.province_id), + ); const typeAllowed = (category: string, type: string) => !category || category === 'other' || @@ -115,6 +118,7 @@ function Index({ className={`${card} flex flex-wrap gap-4 [&_select]:w-full [&_select]:max-w-full [&_select]:min-w-0 [&>label]:w-full [&>label]:max-w-full [&>label]:min-w-0 sm:[&>label]:w-auto`} onSubmit={(e) => { e.preventDefault(); + if (!searchReady) return; form.get('/fundos'); }} > @@ -406,7 +410,19 @@ function Index({ ))} - diff --git a/tests/frontend/funding-journey-coherence.test.mjs b/tests/frontend/funding-journey-coherence.test.mjs index 95f9d2b0..591eff01 100644 --- a/tests/frontend/funding-journey-coherence.test.mjs +++ b/tests/frontend/funding-journey-coherence.test.mjs @@ -237,6 +237,7 @@ void test('contradictory record criteria remain explicit until the user chooses sector: '8', state: 'closed', certainty: 'documented', + need: 'investment', }, { kind: ['Combinação incompatível.'] }, ); @@ -269,6 +270,51 @@ void test('contradictory record criteria remain explicit until the user chooses ); }); +void test('search needs both location and purpose; Enter and missing criteria cannot submit', () => { + for (const filters of [ + {}, + { need: 'investment' }, + { province_id: 'province-qa' }, + ]) { + const h = harness(filters); + const submit = nodes(h.tree()).find( + (n) => n.type === 'button' && text(n) === 'Pesquisar', + ); + assert.equal(submit.props.disabled, true); + nodes(h.tree()) + .find((n) => n.type === 'form') + .props.onSubmit({ preventDefault() {} }); + assert.equal(h.submitted(), undefined); + assert.match( + text(h.tree()), + /Escolha a localização a pesquisar e a necessidade/, + ); + } + for (const location of [ + { province_id: 'province-qa' }, + { territory: 'district-qa' }, + ]) { + const h = harness({ + ...location, + need: 'investment', + context: 'dossier-qa', + opportunity: 'opportunity-qa', + }); + assert.equal( + nodes(h.tree()).find( + (n) => n.type === 'button' && text(n) === 'Pesquisar', + ).props.disabled, + false, + ); + nodes(h.tree()) + .find((n) => n.type === 'form') + .props.onSubmit({ preventDefault() {} }); + assert.equal(h.submitted().data.need, 'investment'); + assert.equal(h.submitted().data.context, 'dossier-qa'); + assert.equal(h.submitted().data.opportunity, 'opportunity-qa'); + } +}); + void test('local search defaults to documented presence and keeps the explicit unknown option and chosen territory', () => { const h = harness({ territory: 'district-qa', sector: '7' }); h.select('Localização a pesquisar').props.onChange({ diff --git a/tests/frontend/investment-step-help.test.mjs b/tests/frontend/investment-step-help.test.mjs index d9cb19c9..3734ad1a 100644 --- a/tests/frontend/investment-step-help.test.mjs +++ b/tests/frontend/investment-step-help.test.mjs @@ -188,6 +188,15 @@ test('summary focus and click wait for the native open toggle; closing a stage d }; try { let tree = render(); + const action = new Target(false); + tree.props.children.props.onPointerDownCapture(); + tree.props.children.props.onFocusCapture({ target: action }); + assert.equal( + render().props.value.active, + null, + 'pointer focus must not insert help before the action receives its click', + ); + tree.props.children.props.onPointerUpCapture(); const summary = new Target(true); tree.props.children.props.onFocusCapture({ target: summary }); tree.props.children.props.onClickCapture({ target: summary }); @@ -200,6 +209,12 @@ test('summary focus and click wait for the native open toggle; closing a stage d target: new Disclosure(false, false), }); assert.equal(render().props.value.active, null); + tree.props.children.props.onClickCapture({ target: action }); + assert.equal( + render().props.value.active, + 'S02', + 'the completed click may open automatic help', + ); listeners.toggle({ target: new Disclosure(false, true), }); diff --git a/tests/frontend/navigation-context-integration.test.mjs b/tests/frontend/navigation-context-integration.test.mjs index 187864dc..a2b8a844 100644 --- a/tests/frontend/navigation-context-integration.test.mjs +++ b/tests/frontend/navigation-context-integration.test.mjs @@ -112,7 +112,12 @@ test('dossier provider retains tab focus across navigation/reload, honours expli } return { installed: true, focus: serverFocus }; } - return { case: { id: url.split('/').pop() } }; + const request = new URL(url, 'https://qa.invalid'); + return { + case: { id: request.pathname.split('/').pop() }, + context_opportunity: + request.searchParams.get('opportunity'), + }; }, }; return require(id); @@ -128,11 +133,13 @@ test('dossier provider retains tab focus across navigation/reload, honours expli while (pending.length) pending.shift()(); return tree.props.value; }; - return async () => { + const settle = async () => { render(); await new Promise(setImmediate); return render(); }; + settle.immediate = render; + return settle; } try { let render = mount(), @@ -151,6 +158,11 @@ test('dossier provider retains tab focus across navigation/reload, honours expli 'reload must not adopt the other tab server preference', ); pageUrl = '/simulador?context=' + B; + assert.equal( + render.immediate().view, + null, + 'the pending explicit dossier cannot display the previous dossier', + ); view = await render(); assert.equal(view.active, B, 'explicit authorised dossier wins'); assert.equal(readNavigationFocus(7, [A, B]).case_id, B); @@ -162,6 +174,71 @@ test('dossier provider retains tab focus across navigation/reload, honours expli 15, ); assert.equal(visits.at(-1), '/investimentos/' + A + '#S02'); + + pageUrl = '/fundos?context=' + A + '&opportunity=opportunity%3Ahotel'; + assert.equal( + render.immediate().view, + null, + 'a pending opportunity cannot be labelled with the previous scope', + ); + view = await render(); + assert.equal(view.view.context_opportunity, 'opportunity:hotel'); + pageUrl = '/documentos'; + view = await render(); + assert.equal(view.active, A); + assert.equal( + view.view.context_opportunity, + 'opportunity:hotel', + 'general menus retain this tab opportunity', + ); + render = mount(); + view = await render(); + assert.equal( + view.view.context_opportunity, + 'opportunity:hotel', + 'reload retains the scope', + ); + view.choose(A, 'S08'); + await new Promise(setImmediate); + assert.equal( + visits.at(-1), + '/investimentos/' + A + '?opportunity=opportunity%3Ahotel#S08', + ); + + pageUrl = '/investimentos/' + A; + view = await render(); + assert.equal( + view.view.context_opportunity, + null, + 'explicit whole dossier clears the previous opportunity', + ); + pageUrl = '/fundos?context=' + A + '&opportunity=opportunity%3Ahotel'; + view = await render(); + view.choose(B); + await new Promise(setImmediate); + assert.equal( + visits.at(-1), + '/investimentos/' + B, + 'deliberate dossier switch does not carry the other opportunity', + ); + pageUrl = '/fundos?context=' + B; + view = await render(); + assert.equal(view.active, B); + assert.equal(view.view.context_opportunity, null); + + calls.length = 0; + pageUrl = '/fundos?context=15111500-0000-4000-8000-000000000099'; + view = await render(); + assert.equal( + view.active, + '', + 'unavailable explicit dossier must not show an old dossier', + ); + assert.equal(view.view, null); + assert.equal( + calls.some((c) => c.url.startsWith('/investimentos/15111500')), + false, + ); } finally { globalThis.sessionStorage = oldStorage; globalThis.window = oldWindow; diff --git a/tests/frontend/navigation-focus.test.mjs b/tests/frontend/navigation-focus.test.mjs index d748a3ef..f32b273c 100644 --- a/tests/frontend/navigation-focus.test.mjs +++ b/tests/frontend/navigation-focus.test.mjs @@ -17,6 +17,21 @@ test('tab focus survives reload but is isolated by actor and rechecked against a const focus = { case_id: 'synthetic-A', step_code: 'S08', version: 3 }; rememberNavigationFocus(1, focus); assert.deepEqual(readNavigationFocus(1, ['synthetic-A']), focus); + rememberNavigationFocus(1, { + ...focus, + opportunity: 'opportunity:hotel', + }); + assert.equal( + readNavigationFocus(1, ['synthetic-A']).opportunity, + 'opportunity:hotel', + ); + assert.equal(readNavigationFocus(1, ['synthetic-B']), null); + rememberNavigationFocus(1, { + ...focus, + opportunity: { invalid: true }, + }); + assert.deepEqual(readNavigationFocus(1, ['synthetic-A']), focus); + rememberNavigationFocus(1, focus); assert.equal(readNavigationFocus(2, ['synthetic-A']), null); assert.equal(readNavigationFocus(1, ['synthetic-B']), null); const firstTab = globalThis.sessionStorage;