7.1 KiB
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:
InvestmentTerritoryTest10/171,InvestmentPortfolioTest8/170,ExistingBusinessWizardTest4/55,EducationTest8/207,InvestmentZoneTest6/104 eInvestmentUnificationTest8/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/InvestmentZoneTestdeixam a suite seguinte sem a tabelausers). 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 opcionalfontainee 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 preservouprovince_ide 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. /negociostambé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, desktop, móvel emulado.
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
- Auditar e uniformizar as pesquisas territoriais dos percursos listados como pendentes.
- Criar testes dedicados de várias localizações para negócios, zonas e relações de projectos/corredores, incluindo entidades económicas combinadas.
- 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.
- Executar ensaio num telemóvel físico. A verificação realizada foi Playwright com viewport móvel.
- 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.