Files
Investidor-V2/docs/investmoz/integration-repair-2026-10-04.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

12 KiB
Raw Blame History

Correcção e integração funcional — InvestMoz

Data: 04/10/2026
Ambiente: portal local em http://127.0.0.1:8000, PostgreSQL activo do Laravel.

Resultado

Estado proposto: parcial — pesquisa territorial corrigida e percursos públicos ajustados; não declarar a etapa integral concluída.

Pesquisa por cluster

A consulta não usava nomes de campos inventados. InvestmentPortfolioController::currentRelation() filtra relações documentais pelos campos validation_status, valid_from e valid_until, que são necessários para excluir relações não validadas ou fora de vigência. O esquema real não tinha esses campos porque a migration aditiva 2026_10_03_180000_govern_investment_structure_relations estava pendente.

Antes da alteração estrutural foi criado um arquivo PostgreSQL custom fora do repositório: %LOCALAPPDATA%\InvestMoz\backups\investmoz-before-structure-relations-20261004.dump. O catálogo foi lido por pg_restore --list: 2.155 entradas, 1.421.544 bytes, SHA-256 70a30878d3875c844995993f7c66276e0956024566e6c3ca69282c22f2af8044. A verificação do catálogo confirma que o arquivo é reconhecível pelo pg_restore; não foi feito ensaio de restauro numa base descartável.

Foi aplicada apenas essa migration. As três tabelas cobertas são cluster_projects, corridor_projects e corridor_clusters. Os campos de associação foram acrescentados com estado inicial pending. A inspecção após a migration encontrou 20 relações corridor_clusters, todas pending; nenhuma foi aprovada ou alterada em massa. Assim, localização territorial, associação económica, validação documental e vigência continuam conceitos separados. Dossiers públicos de cluster continuam visíveis pelo seu próprio cadastro; relações não validadas não passam a relações oficiais.

Catálogos e navegação

  • O menu público agrupa clusters, corredores, ZEE/ZFI/parques, projectos âncora e oportunidades/negócios sob um único grupo, mantendo os URLs existentes e os respectivos redireccionamentos.
  • O catálogo de investimento ganhou ligações directas para os catálogos de zonas, parques, dossiers âncora e negócios publicados; mantém os resultados publicados e uma mensagem de vazio com alternativas.
  • A lista de dossiers territoriais agora pesquisa por província, distrito, posto administrativo e localidade, além de texto e categoria; a opção territorial filtra os registos ligados a entidades nessa área.
  • Foi corrigido um erro descoberto pelo browser em /negocios: a página tentava iterar results.links como array, mas a Resource Collection do Laravel fornece os links de paginação em results.meta.links. O componente agora lê a estrutura real e mantém compatibilidade com uma lista directa.
  • A ficha pública de projecto âncora mostra estado, orçamento e calendário apenas se existirem num registo elegível para publicação; quando o registo vinculado permanece em rascunho, informa que o estado não está confirmado. Em ambos os casos, identifica a fonte do dossier e não sugere concurso aberto ou disponibilidade imediata.
  • A acção de uma ficha territorial pede login a visitantes anónimos. Para o titular autenticado, explica e confirma a criação de uma manifestação privada ligada ao dossier; rascunhos anteriores do próprio utilizador são listados para continuar ou criar outra manifestação sem os fundir. O dossier-fonte não é copiado nem publicado pelo investidor.

“Como investir”

A página agora oferece os percursos “Tenho um projecto definido” e “Tenho uma ideia”. Actividade, maturidade e localização em vista são opcionais e adaptam o texto nesta sessão; o componente não envia nem guarda esses campos. Cada etapa mostra objectivo, informação, documentos quando aplicáveis, fonte, resultado esperado e acção seguinte. O percurso da ideia cobre ideia, mercado, projecto/localização, recursos/financiamento, formalização, implementação e acompanhamento. O percurso do investidor separa simulação fiscal de análise financeira, não presume incentivos e não bloqueia a exploração por falta de documentos ou empresa constituída.

Evidência

  • Browser Chromium (Playwright), desktop e viewport móvel de 390 × 844:
    • /oportunidades: HTTP 200, 6 oportunidades publicadas no ambiente;
    • /carteira?kind=cluster: HTTP 200, 8 dossiers, abertura de ficha sem erro SQL;
    • filtros legados /clusters, /corredores e /projectos-ancora redireccionam correctamente; a selecção de uma província aplicou o filtro. A província escolhida não tinha dossiers de cluster publicados e mostrou o estado vazio;
    • pesquisa deliberadamente sem correspondências: estado vazio útil;
    • /carteira?kind=project: HTTP 200, 15 dossiers; a ficha informa quando o estado não está confirmado e não sugere concurso;
    • /zonas?category=zee: HTTP 200, 0 registos publicados, sem dados demonstrativos;
    • /negocios: HTTP 200, 0 anúncios, sem erro React após corrigir a paginação;
    • /como-investir: ambos os percursos, selecção da ideia e contexto de actividade renderizam;
    • menu móvel expande, foco por teclado avança e não foram observados erros JavaScript.
  • Evidência automatizada: JSON do browser e captura móvel.
  • npm.cmd run types:check: passou.
  • npm.cmd run build: passou. Avisos: dependência opcional fontaine ausente e chunk services acima de 500 kB.
  • node --test tests/frontend/*.test.mjs: 139 passaram, 0 falharam.
  • php -l app/Http/Controllers/InvestmentPortfolioController.php: passou.
  • php artisan migrate --path=database/migrations/2026_10_03_180000_govern_investment_structure_relations.php --force --no-interaction: migration aplicada.

Resultados do seguimento (04/10/2026)

  • Base de teste criada em PostgreSQL isolado; a base preexistente investmoz_test (53 MB) foi preservada. A suite completa php artisan test passou: 261 testes, 2.687 asserções, 0 falhas. O filtro InvestmentPortfolioTest|InvestmentStructureTest|InvestmentZoneTest passou: 20 testes, 353 asserções.
  • Dois testes de rollback manual foram ajustados para reverter e reaplicar a migration de continuidade antes da fundação de negócio. Um novo teste verifica autenticação, propriedade, isolamento do rascunho e que a criação não altera/publica o dossier.
  • O backup custom foi restaurado com pg_restore --exit-on-error --no-owner --no-acl na base temporária investmoz_restore_verify_20261004: 134 tabelas e 20 relações corridor_clusters. O backup é anterior à migration aditiva; a ausência dos campos novos foi confirmada e era esperada. Bases temporárias de teste/restauro foram removidas depois; o backup externo de rollback foi preservado.
  • Browser autenticado em servidor local na porta 8011 e base sintética isolada: login, dossier existente e rascunho aparecem; “Continuar rascunho” abre o mesmo ID. Cancelar a confirmação de uma nova manifestação mantém a ficha, não envia POST e não duplica o rascunho (contagem permaneceu 1). Evidência: JSON e captura. O teste PHP confirma que outra conta recebe 404 ao abrir o rascunho.
  • Fluxo de zona foi testado na suite com fixtures: criar rascunho, anexar fonte, revisão independente, publicar e pesquisar. Na base activa há 0 zonas publicadas e 0 fontes legais validadas/vigentes; o ensaio não representa uma zona real.
  • No catálogo real carregado, há seis oportunidades provenientes do OpportunitySeeder, todas sem last_validated_at, e zero anúncios de negócio. Filtros por Nampula e agronegócio devolveram um cartão cada; o CTA anónimo encaminha para login. A origem seed não prova autorização comercial. O catálogo e detalhe agora avisam quando a data de validação documental não está registada. Evidência: JSON.
  • npm.cmd run types:check, npm.cmd run build e node --test tests/frontend/*.test.mjs: passaram (139/139). Avisos de build: dependência opcional fontaine ausente e chunk services acima de 500 kB.
  • Os resultados e decisões de fonte para as 50 relações, 15 projectos âncora e catálogos constam em revisão documental.

Pendências e limites

  1. 50 relações candidatas: falta atribuir revisor interno e registar fonte/evidência individual com vigência. A decisão pendente é a natureza de cada ligação (oficial, influência, proximidade, potencial, histórica) ou remoção. Não se exige certificador externo; relações sem prova ficam fora de pesquisas oficiais. Os catálogos e fichas continuam acessíveis.
  2. Projectos âncora: falta fonte primária/estado actual por projecto e decisão de publicação após confronto documental. Não inferir concurso, execução, calendário ou orçamento.
  3. Zonas: o percurso técnico foi demonstrado com fixtures isoladas; falta fonte oficial validada e registo real autorizado para ensaio browser. Há 0 zonas publicadas e 0 fontes válidas na base activa.
  4. Negócios e oportunidades: os seis cartões disponíveis são seeds sem data de validação; o catálogo de negócios tem 0 anúncios. Falta ao menos um registo autorizado com fonte e data para verificar anúncio e pretensão real. O catálogo continua consultável com aviso; não há confirmação de oferta.
  5. ZFE: a sigla não tem definição/fonte encontrada; pedir a referência original antes de criar categoria.
  6. Dispositivo físico: falta ensaio num telemóvel físico; viewport Chromium não substitui compatibilidade real.

Diff lógico nesta entrega

  • database/migrations/2026_10_03_180000_govern_investment_structure_relations.php: migration aditiva pendente executada nas três tabelas; não foi editada.
  • resources/js/layouts/portal-navigation.tsx: agrupamento dos catálogos e link para negócios publicados.
  • resources/js/pages/investment/catalogue.tsx: atalhos territoriais/económicos e limites dos anúncios privados.
  • resources/js/pages/investment/business-marketplace.tsx: leitura correcta da paginação da Resource Collection e mensagem de contagem.
  • app/Http/Controllers/InvestmentPortfolioController.php, resources/js/pages/portfolio/show.tsx: dados registados de projecto âncora, aviso sobre concursos e ligação confirmada, privada e sem fusão ao dossier-fonte.
  • resources/js/pages/portfolio/index.tsx: vazio com alternativas e distinção de catálogo.
  • resources/js/pages/portal/services.tsx: guia com dois percursos e contexto opcional.
  • resources/js/pages/investment/shared.tsx, resources/js/pages/investment/catalogue.tsx, resources/js/pages/investment/detail.tsx: aviso quando não há data de validação documental registada.
  • tests/Feature/InvestmentPortfolioTest.php: autenticação, rascunho privado, ownership e preservação do dossier; o browser isolado cobre o cancelamento. tests/Feature/InvestmentZoneTest.php e tests/Feature/ExistingBusinessFoundationTest.php: ordem de rollback alinhada com a migration de continuidade.
  • tools/investmoz-authorized-catalogue-review-browser.mjs, tools/investmoz-private-association-browser.mjs, docs/investmoz/pilot/*: filtros, privacidade e cancelamento autenticado com fixtures temporárias; scripts não criaram conteúdo na base activa.

Rollback

  • Código: reverter apenas as alterações listadas nesta entrega, preservando os outros ficheiros modificados preexistentes.
  • Migration: após rever se algum registo adquiriu metadados de validação, executar php artisan migrate:rollback --path=database/migrations/2026_10_03_180000_govern_investment_structure_relations.php. O down() bloqueia se houver relações com metadados governados. Se a migration não puder ser revertida, restaurar o backup verificado para uma instância aprovada após ensaio; não executar migrate:fresh, reset ou reconstrução da base.

Gate

Proposta: pendente com decisões delimitadas, sem bloquear o portal globalmente. A associação privada passou no teste browser autenticado e no teste PHP. As decisões humanas em falta são: rever os 50 vínculos com fonte/evidência; confirmar documentalmente os 15 projectos; fornecer fonte legal e registo real de zona; fornecer anúncios autorizados para ensaiar uma pretensão real; esclarecer ZFE; realizar ensaio num telemóvel físico. Os percursos públicos já verificados continuam disponíveis com os avisos registados.