91 lines
12 KiB
Markdown
91 lines
12 KiB
Markdown
# 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.
|