47 lines
7.1 KiB
Markdown
47 lines
7.1 KiB
Markdown
# 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.
|