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

91 lines
12 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.
# 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](pilot/investmoz-catalogue-guide-browser-2026-10-04.json) e [captura móvel](pilot/investmoz-guide-mobile-2026-10-04.png).
- `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](pilot/private-dossier-association-browser-2026-10-04.json) e [captura](pilot/private-dossier-association-browser-2026-10-04.png). 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](pilot/authorized-opportunity-filter-browser-2026-10-04.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](catalogue-review-2026-10-04.md).
## 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.