Files
Investidor-V2/docs/investmoz/v2/revisao-funcional-transversal.md
T
nala 6ddafc95ba
tests / ci (push) Canceled after 0s
oportunidades 4
2026-10-10 07:03:59 +02:00

56 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Revisão funcional transversal — integração de 9d6176f
9 de outubro de 2026. Incremento de correções, com cobertura por percurso; não é certificação de todos os módulos. Preserva a gestão básica instalada, classificações, relações e fontes oficiais aceites. A revisão não reabre a proveniência oficial.
## Resultados demonstrados e lacunas
| Módulo / rota | Ação e resultado demonstrado nesta revisão | Correção / persistência | Lacuna restante |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Perfil `/investidor/profile` | Guardar residência, mensagem visível, HTTP 303, recarregar; nova sessão móvel sem localStorage recupera PT; pesquisar Portugal | ISO comum, país de residência explícito, payload privado cifrado e versão existentes | País no cadastro inicial e restantes perfis ainda por reconciliar |
| Entidades `/investidor/companies` | QA de servidor: guardar constituição MZ; recuperar no contexto da conta; negar acesso de outra conta | País de constituição distinto; valor histórico conservado; sem concessão de representação | Novo percurso completo de criação/edição de entidade no navegador ainda por demonstrar |
| Manifestações `/investidor/manifestacoes/{id}` | QA HTTP: guardar/recuperar três países diferentes; rejeitar ZZ com 422 sem alterar versão/payload; submissão só em QA conserva origem no pedido | A constituição da entidade deixa de substituir o país do perfil; origem explícita no payload, revisão e metadata do mesmo pedido | Teste de todos os passos da manifestação com os novos dropdowns no navegador; os endpoints públicos/legados ainda não recolhem ISO específico |
| Balcão `/balcao-virtual/painel` e `/pedidos/{id}` | QA HTTP: origem de rascunho recuperada pelo proprietário; outra conta negada; 422 preserva rascunho; nenhum pedido ativo submetido | Seletores mostram nomes dos investimentos/percursos da conta; título reutilizado quando disponível, sem substituir título corrigido; origem não inferida do perfil | Comprovar no navegador o percurso de reutilização de projeto, pedido e responsável; primeiro pedido real continua pendente |
| CRM `/management/crm/leads` | QA: estatísticas e filtro de origem autorizados, acesso não autorizado rejeitado; pedido antigo com país Moçambique e sem origem continua «não informado» | Contagens separadas de manifestações e pedidos em acompanhamento; filtro por país/não informado; sem somar como investidores únicos ou exportar contactos | Verificação das contagens e do filtro no navegador; cobertura dos endpoints legados |
| Catálogo `/oportunidades` | Navegador móvel: dimensão Cluster oculta filtros incompatíveis; pesquisa Maputo devolve opção do cadastro | Troca de dimensão limpa filtros incompatíveis; pesquisa no seletor reutilizado | Guião de preferências integrado e percurso completo oportunidade → localização → acompanhamento ainda por demonstrar |
| Mapa `/oportunidades?view=map` | Navegador: fichas de estruturas territoriais acessíveis dentro do percurso do mapa | API inclui contexto territorial independente das seis oportunidades, com links de ficheiro; não cria coordenadas nem associações | Desenhar corredores/âncoras/ZEE/ZFI/parques exige geometrias existentes; a base ativa tem zero. Lista consultável não equivale a cartografia completa |
| Recursos `/management/opportunities/{id}/resources` | Navegador desktop/móvel: múltiplos locais, PDF/imagem, recuperação, exclusão lógica/restauro; falta de GD visível, preparação desativada | Integra 9d6176f; metadados e rascunhos continuam guardáveis; originais conservados; scan por ficheiro independente | Instalação ativa pendente, ClamD real, GD no PHP web e revisão/publicação final |
| Educação `/educacao`, `/management/education` | Testes HTTP existentes executados com a revisão; regras de lacuna preservadas | `/educacao` é catálogo de investimentos educativos; a gestão de procura/capacidade é outra rota | Fluxo educativo integral solicitado, recuperação dos seus rascunhos, painéis por ator e aceitação funcional permanecem abertos; testes existentes não certificam a especificação inteira |
| Simulador | Correções do incremento anterior preservadas | Nenhum cálculo fiscal alterado ou ativado pela introdução de países | Nova revisão transversal do simulador ainda não demonstrada nesta frente; não conclui ClamD, fontes institucionais ou pedido real |
| Bolsa, serviços, carteira, negócios, fundiário e mapas de zonas | Inventário de consumidores territoriais abaixo | Componentes e entidades existentes preservados | Ações de criar/editar/recuperar por rota e cobertura completa dos países permanecem abertas |
## Continuação — filtro das estatísticas de origem
Em 9 de outubro de 2026, acrescentado o filtro de país e «Não informado» em `/management/crm/leads`. O filtro aplica-se apenas às estatísticas de solicitações; a lista de leads conserva os seus filtros próprios. Manifestações e pedidos do Balcão continuam separados. Seleção sem ocorrências mostra conjunto vazio; país histórico, residência e constituição não substituem origem declarada. GET validado pelo catálogo comum, protegido pela permissão existente, sem migration ou atualização de dados.
QA isolada definida em `phpunit.xml` (`investmoz_test`, porta 55441), com guarda antes da limpeza/migração: **25 testes, 430 asserções passaram** nas suites `InvestmentWorkspaceTest` e `InvestorGuidanceTest`. Cobrem país explícito, não informado, ausência de ocorrências, reposição de todas as origens, país inválido, acesso negado e igualdade dos registos antes/depois. TypeScript e PHPStan passaram. Percurso específico deste novo filtro no navegador ainda não demonstrado; não altera a aceitação funcional dos restantes percursos. Nenhuma escrita na base ativa.
## Países e dados históricos
Catálogo comum local de **249 códigos ISO alpha-2**, sem seed de substituição de cadastros. Fonte técnica: [tabela IANA](https://data.iana.org/time-zones/tzdb/iso3166.tab), consultada em 09/10/2026; declara códigos referentes a ISO/TC 46 N1127 de 29/02/2024. SHA-256 local `837c80785080c8433fd9d4ea87e78f161ac7a40389301c5153d4f90198baeb2a`. Nomes portugueses pelo ICU/Intl, nomes ingleses preservados e usados como alternativa. Consulta e pesquisa não dependem de serviço externo.
Três significados distintos: `residence_country_code`, `incorporation_country_code`, `declared_origin_country_code`. Os dois primeiros não preenchem o terceiro. O campo antigo `country` conserva o valor original sem conversão automática; dados ausentes continuam não informados. O IP técnico mantém-se separado. O uso do JSON/payload e metadata existentes evita nova tabela de perfil, novo pedido e migration de países nesta parcela. Estatísticas de origem usam apenas a declaração explícita, sem reclassificar históricos pelo campo antigo.
## Inventário territorial inicial — cobertura ainda parcial
O inventário de código identificou consumidores em `portal/services`, `portal/manage`, `education/index`, `education/analysis`, `portfolio/index`, `structures/editor`, `management/relationship-repair`, `management/editor`, `management/opportunity-draft`, `management/opportunity-resources`, `partnerships/catalogue`, `partnerships/editor`, `investment/business-marketplace`, `investment/business-wizard`, `investment/catalogue`, `investment/detail`, `investment/zone`, `investment/zones` e `land-assistance/form`. Acrescenta-se o campo territorial do pedido do Balcão e os mapas do catálogo e das zonas.
Os consumidores de `ProvinceSelect` e `TerritoryFields` públicos passam a usar `/api/v1/investment/territory-options`, que consulta o cadastro aceite, em vez de depender da publicação/validade de uma versão intermediária em `/api/v1/catalogs/jurisdictions`. Os seletores de gestão conservam `/management/territory-options` e a permissão existente. `TerritoryLevel` passa a pesquisar nome/código, preservando o pai, paginação e valor guardado.
**Não está concluído «todos os campos e mapas».** O Balcão ainda apresenta o seletor territorial plano; a Bolsa e serviços têm consumidores próprios; os seletores de gestão genéricos, campos livres de localização, filtros e cada mapa precisam de demonstração individual. Não substituir localidades ausentes nem inferir pontos pelo centro de província. A recuperação de referências mantém as validações existentes. Na leitura ativa de 11:42:46 UTC: 1.921 territórios, zero geometrias, 28 locais de projeto e 13 ligações cluster–projeto preservados.
## GD e ClamD — impacto mostrado antes da operação
GD/WebP é verificado no processo PHP que atende a página, não pelo resultado de outro CLI. Quando indisponível, o formulário conserva original/metadados, mostra a limitação e desativa apenas a preparação de WebP/miniaturas. O endpoint mantém HTTP 423 como guarda. Não foi alterado o PHP ativo.
ClamD real continua indisponível (`malware:health`: `scanner_unavailable`, versão/assinaturas desconhecidas). Scan pendente bloqueia acesso ao binário/preview/processamento que o exige; não impede preparar metadados, localizações ou rascunhos. A página de instalação também explica estas limitações. Scanner simulado verifica apenas fixtures identificadas de QA, nunca ficheiros reais. Direitos e publicação continuam independentes do scan.
## QA, preservação e plano consolidado
QA exclusivamente em `*_test:55441`, incluindo cópia restaurada e navegador restrito a `127.0.0.1:18096`. Provas privadas: `functional-country-browser.json`, `opportunity-resources-browser.json`, `opportunity-resources-preservation.json`, `opportunity-resources-compatibility.json` e `opportunity-resources-backup-proof.json`. Tests/TypeScript/PHPStan/build são verificações técnicas; a matriz acima delimita a aceitação funcional.
Plano autenticado único para o esquema ainda pendente: [recursos e revisão funcional](http://127.0.0.1:8000/management/opportunity-resources-install). Inclui apenas `2026_10_09_030000_extend_opportunity_resources`, versão atual do código, backup/restauro, reversão e limitações. Não repete `2026_10_09_020000_extend_opportunity_management`. Países desta parcela reutilizam armazenamento existente; não convertem históricos. Nenhuma localização, relação ou oportunidade ativa é criada pelo plano.
Reversão da migration apenas antes de novos recursos/documentos cifrados, preservando a guarda de dados. Depois de uso, exige reconciliação dos dados posteriores e ação autorizada; não restaurar automaticamente o backup por cima de novas escritas. Reversão de código deve preservar os novos campos no payload antes de voltar a formulários antigos que não os conheçam.
**Base ativa:** apenas leitura e backup nesta revisão; seis IDs reais e 124 eventos anteriores confirmados, zero eventos de recursos. Nenhuma instalação repetida, seed ativo, submissão ou alteração de configuração. Cobertura documental, questões jurídicas específicas, fontes institucionais, ClamD real e primeiro pedido real permanecem separados.