12 KiB
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 iterarresults.linkscomo array, mas a Resource Collection do Laravel fornece os links de paginação emresults.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,/corredorese/projectos-ancoraredireccionam 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 opcionalfontaineausente e chunkservicesacima 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 completaphp artisan testpassou: 261 testes, 2.687 asserções, 0 falhas. O filtroInvestmentPortfolioTest|InvestmentStructureTest|InvestmentZoneTestpassou: 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-aclna base temporáriainvestmoz_restore_verify_20261004: 134 tabelas e 20 relaçõescorridor_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 semlast_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 buildenode --test tests/frontend/*.test.mjs: passaram (139/139). Avisos de build: dependência opcionalfontaineausente e chunkservicesacima 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
- 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.
- 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.
- 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.
- 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.
- ZFE: a sigla não tem definição/fonte encontrada; pedir a referência original antes de criar categoria.
- 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.phpetests/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. Odown()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 executarmigrate: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.