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

47 lines
7.1 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.
# Pesquisa territorial — implementação e evidências
Data: 04/10/2026
## Resultado
A pesquisa territorial de oportunidades passou a filtrar no servidor por IDs da hierarquia territorial e por relações de localização. Uma oportunidade com vários locais conta uma só vez (`EXISTS`); sem correspondência a área escolhida, não há expansão automática. Foi acrescentado `geography_scope` para distinguir registos explicitamente nacionais de registos sem localização. Os existentes recebem `unspecified`; a ausência de localização não os transforma em nacionais.
`include_national=1` acrescenta apenas registos marcados como `national`. Sem essa opção, os nacionais são excluídos mesmo numa pesquisa sem área. O cadastro de oportunidades permite gerir o âmbito. Uma oportunidade marcada nacional não pode guardar simultaneamente localização administrativa.
## Módulos
| Módulo/percurso | Estado | Evidência ou limite |
| ------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/oportunidades` — página, `/api/v1/investment/search`, mapa e CSV | Corrigido | Usam `InvestmentCatalogue::query()`; hierarquia por UUID, locais primários e múltiplos, filtros combinados, sem duplicação. Testes sintéticos em duas províncias. |
| `/educacao` — procura de necessidades e capacidades | Corrigido | `geo_location_id` e cascata administrativa incluem descendentes por ID antes da paginação; 36 testes dirigidos passaram. |
| `/negocios` — catálogo público de negócios existentes | Corrigido | Filtro territorial usa `EXISTS` sobre localizações públicas; mais de uma localização não duplica anúncios. Suite do assistente/catálogo passou, mas falta um caso dedicado multi-localização neste módulo. |
| `/carteira` — projectos âncora, clusters e corredores | Corrigido parcialmente | Mantém filtros de publicação e considera territórios primários, locais públicos de projectos e locais públicos de corredores. Clusters não têm relação de localizações múltiplas identificada; ficam limitados ao território primário. |
| `/zonas` — ZEE, ZFI e parques | Corrigido parcialmente | Território primário ou geometria associada, validada e autorizada para publicação. Sem âmbito nacional explícito neste modelo; registos sem território não correspondem à seleção. Testes existentes passaram, sem fixture multi-geometria por províncias. |
| Rotas territoriais fora destes catálogos | Pendente de auditoria | Percursos de assistência fundiária, gestão e edição, relações de clusters/corredores, prestadores/cursos e demais pesquisas GIS ainda não foram uniformizados nem validados contra os critérios completos. Não declarar cobertura transversal concluída. |
## Testes e browser
- Base isolada `investmoz_browser_e2e_test`; não foram usados nem alterados registos reais para criar cenários de teste.
- Suites PHPUnit executadas separadamente em base isolada: `InvestmentTerritoryTest` **10/171**, `InvestmentPortfolioTest` **8/170**, `ExistingBusinessWizardTest` **4/55**, `EducationTest` **8/207**, `InvestmentZoneTest` **6/104** e `InvestmentUnificationTest` **8/87**. Total: **44 testes, 794 afirmações, todas as suites passaram**.
- A fixture territorial cobre duas províncias, distrito, posto administrativo, localidade, oportunidade com locais em províncias diferentes, nacional explícita e registo sem localização. Verifica selecção por província/distrito/localidade, sector incompatível, ausência de correspondências, ausência de duplicados, inclusão nacional explícita, pesquisa, contagem, mapa e CSV.
- Uma execução conjunta de todas as suites apresentou interferência entre migrations próprias de teste (as rotinas de `InvestmentUnificationTest`/`InvestmentZoneTest` deixam a suite seguinte sem a tabela `users`). Cada suite foi então executada num processo PHPUnit separado contra a base isolada; todas passaram. Não é evidência de falha no portal, mas convém corrigir o isolamento do conjunto de testes.
- `npm.cmd run build`: passou. Permanecem avisos existentes de pacote opcional `fontaine` e chunks acima de 500 kB.
- Browser em `http://127.0.0.1:8000/oportunidades`: HTTP 200; filtro real “Cabo Delgado (02)” resultou em **0** na lista, mapa e API de pesquisa; CSV HTTP 200 com BOM UTF-8 e **0 linhas de dados**. O estado vazio e “Alargar pesquisa (remover localização)” apareceram; nenhum resultado nacional foi inserido implicitamente. Abrir uma ficha e regressar preservou `province_id` e a lista continuou com 0 resultados.
- Em 390×844 px, `documentWidth=390`, sem overflow horizontal. Sem erros de consola. Isto confirma a vista responsiva no browser emulado, não num telemóvel físico.
- `/negocios` também foi aberto em viewport 390 px; a selecção de província foi enviada ao servidor e manteve a contagem zero, sem overflow ou erros de consola.
- Evidência: [dados do ensaio](pilot/territorial-search-browser-2026-10-04.json), [desktop](pilot/territorial-search-filtered-2026-10-04.png), [móvel emulado](pilot/territorial-search-filtered-mobile-2026-10-04.png).
## Migration
Aplicada na base de desenvolvimento activa: `2026_10_04_120000_add_opportunity_geography_scope`. É aditiva, define `unspecified` por omissão e valida valores permitidos. O rollback recusa remover a coluna se já existirem classificações explícitas diferentes de `unspecified`.
## Pendências
1. Auditar e uniformizar as pesquisas territoriais dos percursos listados como pendentes.
2. Criar testes dedicados de várias localizações para negócios, zonas e relações de projectos/corredores, incluindo entidades económicas combinadas.
3. Adicionar remoção individual para todos os filtros activos; a UI actual expõe os principais (localização, sector, cluster, corredor, projecto e âmbito nacional), mas ainda não todos os facets e campos.
4. Executar ensaio num telemóvel físico. A verificação realizada foi Playwright com viewport móvel.
5. Testar paginação com dataset acima do limite de 12 e confirmar a navegação de ida/volta na ficha em browser.
Não promover este resultado a “correcção transversal concluída” até fechar estes pontos.