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

7.1 KiB
Raw Blame History

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, 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

  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.