Melhoria sequencial do catálogo de oportunidades da InvestMoz
Actua como arquitecto de software, analista funcional e especialista em UX/UI. Inspecciona e melhora o catálogo da InvestMoz, actualmente indicado em /oportunidades, preservando a arquitectura, os dados e os módulos existentes.
O objectivo é facilitar a descoberta, comparação e consulta de oportunidades e negócios existentes, relacionando-os com o território e com entidades de enquadramento económico.
Este pedido inclui implementação, não apenas uma proposta. Executa as fases seguintes sequencialmente. Não declares compatibilidade, sucesso ou ausência de regressões sem evidência.
1. Diagnóstico obrigatório antes de alterar
Lê as instruções do repositório e identifica:
Versões efectivamente instaladas de Laravel, frontend e base de dados.
Rotas, páginas, componentes, modelos, relações e permissões existentes.
Módulos de oportunidades, negócios existentes, cartografia, corredores, clusters, parques, ZEE, ZFI e projectos âncora.
Pesquisa, filtros, mapas, formulários e mecanismos de publicação já implementados.
Testes, ferramentas de qualidade e procedimentos de execução disponíveis.
Inspecciona /oportunidades no navegador quando o ambiente estiver acessível. Verifica a experiência pública, autenticada e administrativa.
Executa os testes e verificações existentes para estabelecer uma referência inicial. Separa falhas anteriores das introduzidas pelo trabalho.
Se o repositório, a base de dados ou um requisito essencial estiver indisponível, identifica o bloqueio. Não inventes um diagnóstico do ecrã nem substituas a aplicação por uma nova estrutura.
2. Arquitectura da informação
Distingue três dimensões:
Tipos de oportunidade: projecto de investimento, negócio existente com proposta concreta, activo disponível, parceria, concessão, procura de financiamento e oportunidade de fornecimento.
Enquadramento económico: clusters, parques industriais, corredores, ZEE, ZFI e projectos âncora.
Território: província, distrito, posto administrativo e localidade, conforme os dados mestres existentes.
Reutiliza os registos e classificações existentes. Não cries uma segunda base de empresas, territórios ou oportunidades.
Disponibiliza páginas de consulta para as entidades de enquadramento, interligadas ao catálogo. Uma entidade pode existir como informação contextual mesmo quando não tem oportunidades disponíveis.
Mantém o directório de negócios existentes distinto dos anúncios de venda, parceria e financiamento.
3. Modelo de dados e relações
Antes de criar migrações, apresenta um resumo das alterações e dependências.
Uma oportunidade pode estar relacionada com várias localizações e entidades de enquadramento. Implementa relações múltiplas apenas onde fizerem sentido, preservando o significado das relações actuais.
Corredores não são subdivisões obrigatórias de províncias. A pertença geográfica a uma zona não comprova certificação, elegibilidade fiscal ou acesso a benefícios.
Distingue:
Estado editorial: rascunho, em validação, publicado, suspenso e arquivado.
Maturidade do projecto.
Disponibilidade da oportunidade.
Situação documental e de licenciamento.
Adapta estes conceitos aos estados existentes, sem renomear ou converter dados silenciosamente.
Mantém identificadores estáveis, origem, autor, aprovador, datas e histórico de alterações.
4. Cadastro simples e progressivo
Melhora o formulário disponível no portal, organizado em etapas:
Proponente e representação autorizada.
Tipo de oportunidade, descrição, sector e actividades.
Localização e relações económicas aplicáveis.
Valores, activos e recursos.
Documentos e fontes.
Resumo, declaração e submissão para revisão.
Distingue país de origem do proponente, nacionalidade e localização do investimento.
Não uses um único campo monetário para significados diferentes. Separa, conforme aplicável, investimento total estimado, preço pedido, financiamento assegurado e montante procurado. Regista moeda e data de referência.
Permite guardar rascunhos incompletos segundo as permissões existentes. Valida os requisitos de publicação separadamente.
Não inventes coordenadas, licenças, valores ou fontes. Separa informação pública de documentos confidenciais.
5. Pesquisa e navegação
Implementa pesquisa textual e filtros combináveis por:
Tipo de oportunidade.
Sector e subsector.
Localização.
Entidade de enquadramento.
Faixa de valor e moeda.
Maturidade e disponibilidade.
Na área pública, não exponhas rascunhos ou registos internos através de filtros, contagens, pesquisa ou mapa.
Usa parâmetros de URL para preservar filtros, ordenação e paginação. Permite limpar filtros e voltar aos resultados sem perder a selecção.
Mostra contagens coerentes e evita duplicações causadas pelas relações múltiplas.
Disponibiliza cartões com título, tipo, sector, localização, significado do valor apresentado, moeda, maturidade, disponibilidade e data de actualização.
Se a comparação for implementada, limita-a a um pequeno conjunto de oportunidades e mostra campos comparáveis. Não compares montantes em moedas diferentes sem conversão explícita e documentada.
6. Mapa e georreferenciação
Reutiliza a solução cartográfica existente antes de adoptar outra.
Lista e mapa devem usar os mesmos critérios de pesquisa. Define claramente se o mapa representa todos os resultados filtrados ou apenas a página actual.
Mantém oportunidades sem coordenadas na lista, com indicação de localização aproximada ou não georreferenciada. Não coloques marcadores fictícios no centro da província.
Valida coordenadas e pertença territorial. Protege localizações sensíveis.
Distingue filtros administrativos de pesquisa pela área visível do mapa.
Assegura alternativa acessível em lista e funcionamento da pesquisa quando o fornecedor cartográfico estiver indisponível.
7. Resultados relacionados
Apresenta separadamente:
Empreendimentos existentes.
Oportunidades efectivamente disponíveis.
Potencial sectorial.
Recursos e 
infra-estruturas
 documentados.
Sugere oportunidades relacionadas apenas entre registos públicos e disponíveis. Explica a relação por sector, localização, cadeia de valor ou enquadramento económico.
Não apresente garantias de retorno nem transforme população, escolas ou recursos regionais em disponibilidade comprovada de trabalhadores ou insumos.
Não partilhes automaticamente dados pessoais com proponentes. Mantém os contactos e pedidos de informação dentro das permissões existentes.
8. Fontes e publicação pública
Aplica a política acordada: activar publicamente apenas componentes e conteúdos com fontes oficiais identificadas e revisão aprovada.
Para cada conteúdo, regista entidade emissora, documento ou página específica, referência, versão, período dos dados, data de consulta e responsável pela revisão.
Não consideres a simples menção “Fonte: INE” ou “APIEX” num documento de trabalho como confirmação suficiente.
Declarações de proponentes devem estar identificadas como tal e não equivalem a validação oficial.
Mantém conteúdos pendentes em acesso interno ou pré-visualização autorizada. Não alargues a política de publicação sem aprovação.
Não importes automaticamente todos os documentos fornecidos nem publiques a base empresarial em massa.
9. Segurança e compatibilidade
Reutiliza autenticação, permissões, componentes e padrões existentes. Verifica autorização no servidor em todas as operações, incluindo anexos, contactos, exportações e consultas geográficas.
Mantém compatibilidade com a arquitectura real do frontend. Não cries uma API REST paralela se as rotas e mecanismos existentes forem suficientes.
Valida uploads, limita abuso de pesquisa e submissão e evita exposição de dados pessoais nos resultados, registos técnicos ou mensagens de erro.
Preserva URLs, favoritos e relações existentes. Quando uma alteração de URL for necessária, mantém compatibilidade ou redireccionamento.
10. Implementação e controlo de regressões
Executa em pequenos incrementos:
Diagnóstico e testes de referência.
Dados e relações necessárias.
Consulta pública em ambiente de desenvolvimento.
Filtros, lista e mapa.
Formulário e revisão editorial.
Relações e sugestões.
Segurança, acessibilidade e desempenho.
Preparação da activação.
Usa migrações aditivas sempre que possível. Não apagues tabelas, colunas ou dados para simplificar o modelo.
Não executes migrações destrutivas nem publiques em produção sem aprovação específica. Documenta cópia de segurança, recuperação e limites de reversão.
Quando existir um mecanismo de activação gradual, reutiliza-o. Uma dependência indisponível não deve tornar o catálogo inteiro inutilizável.
11. Testes e critérios de aceitação
Verifica:
Pesquisa, filtros combinados, ordenação e paginação.
Ausência de duplicações e coerência entre lista, mapa e contagens.
Formulários, validações e transições de estado.
Permissões entre proponentes, revisores, administradores e público.
Impossibilidade de aceder a documentos ou oportunidades privados por endereço directo.
Localizações incompletas e oportunidades sem coordenadas.
Relações múltiplas com corredores, zonas e clusters.
Utilização por teclado, foco, rótulos e mensagens de erro.
Funcionamento em computador, tablet e telemóvel.
Falha do mapa, ausência de resultados e fontes pendentes.
Desempenho com volume representativo, sem consultas repetidas desnecessárias.
Regressões nos módulos existentes.
Executa os testes, a compilação e as verificações de qualidade disponíveis. Não declares como testado o que apenas foi inspeccionado.
Só recomenda activação pública quando os testes relevantes passarem e as fontes dos conteúdos estiverem aprovadas.
12. Entrega
Apresenta um resumo com:
Diagnóstico confirmado.
Alterações implementadas.
Ecrãs, rotas e relações afectados.
Testes executados e resultados.
Pendências de fontes, dados ou aprovação.
Riscos restantes e procedimento de activação e recuperação.
Distingue claramente trabalho concluído, trabalho não verificado e funcionalidades mantidas desactivadas.