# Unificação do Portal do Investidor ## Entrega local Implementados catálogo multidimensional, página de educação, fichas relacionadas, grelha/lista/mapa de pontos, comparação, favoritos, exportação, pesquisa predictiva, manifestações privadas em cinco etapas, necessidades configuráveis, anexos, protocolo e integração com o intake/CRM existente. A área pessoal inclui perfil, empresas declaradas, conversa privada, notificações internas e consulta de versões encriptadas. Backoffice acrescenta contexto de oportunidade e administração de referências. Extensões aplicadas à base local: **93 tabelas**, incluindo dezassete novas e **114 opções configuráveis**. As contagens dos dados de negócio anteriores mantiveram-se; apenas `migrations` e `sessions` mudaram durante a verificação. Não foram semeadas oportunidades, empresas ou coordenadas fictícias na base operacional. - [Dados, segurança, migração, reversão e Go/No-Go](data-and-operations.md) - [Rastreabilidade, cobertura, manuais e formação](traceability-and-manual.md) - [Contrato OpenAPI 3.0.3](openapi.json) - [Validação e limites dos ensaios](validation.md) Pontos de entrada: `/oportunidades`, `/educacao`, `/carteira`, `/investidor/manifestacoes` e `/management/investment/references`. Em gestão de uma oportunidade, usar o acesso ao contexto para associar clusters, corredores, âncoras e necessidades. Esta entrega não representa a conclusão integral do prompt: a matriz identifica os módulos ainda parciais e os ensaios externos por executar. **Âmbito confirmado pelo proprietário:** a consolidação da outra máquina será feita futuramente; não faz parte da execução local actual. ## Levantamento e decisão — 27/09/2026 Fonte remota observada: https://teste-info.tempo.co.mz/portal-do-investidor, HTTP 200, HTML público com Inertia `investor-portal/welcome`. Código e base remotos estão noutra máquina, conforme confirmação do proprietário. Não foram inspeccionados nem alterados. A aplicação Laravel/React local é a base de consolidação autorizada. | Domínio | Página remota observada | Aplicação local antes do upgrade | Decisão e regra | | ----------------------- | ------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | Entrada | `/portal-do-investidor`, menus e pesquisa | `/`, sete áreas e serviços | Consolidar: uma navegação; conservar URLs antigas com redireccionamento local. | | Sectores | Mineração, Energia, Agronegócio, Turismo, Infraestruturas | Cadastro `sectors`, detalhe e pesquisa | Manter cadastro local; não substituir descrições por scraping. | | Oportunidades | Dois projectos identificados como exemplos fictícios em USD | `opportunities`, publicação, detalhe, interesse | Manter; exemplos remotos não migram como factos. Preservar inventário e natureza demonstrativa. | | Território | Atalho de províncias, sem mapa comprovado no HTML | 6 corredores, 8 clusters, 15 âncoras publicados em dossiers | Adaptar: ligações tipadas a oportunidades, pesquisa e navegação conjuntas; não duplicar dossiers como oportunidades. | | Educação | Não observada na página inicial | Procura, capacidade, lacunas e propostas internas | Criar descoberta pública das oportunidades educativas publicadas; preservar dados internos. | | Procedimentos | Cinco passos de orientação | Seis etapas e links de preparação | Consolidar no roteiro local, sem transformar orientação em exigência legal. | | Legislação e documentos | Menus e âncoras | Catálogo, ficheiros privados e download autorizado | Manter; não inferir diplomas ou taxas a partir de links. | | Parcerias | Âncora `#parcerias` | Propostas, moderação e contacto intermediado | Manter fluxo local. | | Contactos | Morada e telefones públicos da Tempo; email protegido no HTML | Contactos configuráveis e formulário | Preservar referência no inventário; não substituir contactos de atendimento nem atribuir mandato institucional automaticamente. | | Interesse | CTA nas fichas | API idempotente, formulário simples, CRM e jornadas | Adaptar com rascunho, etapas, necessidades e anexos privados; conservar API e pedidos existentes. | | Área pessoal | Não comprovada na página consultada | Painel, balcão e autenticação | Consolidar entradas e relacionar pedidos, favoritos e manifestações. | | Administração | Não acessível publicamente | Gestão, auditoria, educação, IA | Adaptar com relações, referências e versões; não conceder privilégios ao registo público. | | URLs/duplicação | Prefixo `/portal-do-investidor` | Rotas sem prefixo | Descontinuar entradas duplicadas através de aliases; conservar registos e origem. | ## Arquitectura da informação - Início: pesquisa, contagens do catálogo, destaques, quatro dimensões de investimento e serviços. - Investir: catálogo → oportunidade; clusters → ficha; corredores → ficha; projectos âncora → ficha; educação → catálogo filtrado. - Preparar: sectores, procedimentos, legislação, documentos, parcerias e simulador de cenários. - Acompanhar: área do investidor, manifestações/rascunhos, favoritos, balcão e apoio. - Gerir: catálogo e contexto, tabelas de referência, atendimento/CRM, conteúdo, auditoria e acessos. As tabelas públicas de oportunidades, dossiers, projectos, educação e CRM mantêm identidades e finalidades distintas. As novas relações complementam-nas; não copiam factos entre catálogos para simular consolidação. ## Backlog e critérios de aceitação | Prioridade | Épico | Dependência | Aceitação | | ---------- | -------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------- | | P0 | Inventário e consolidação | HTML público + código local | Divergências e origem documentadas; sem importação de exemplos como reais. | | P0 | Modelo de contexto e referências | Esquema existente | FKs, pivots, filtros combináveis, gestão e rollback que preserva dados. | | P0 | Manifestação progressiva | Autenticação + serviço de intake | Rascunho privado, versão, opções de BD, necessidades, consentimento, anexos e protocolo idempotente. | | P1 | Descoberta unificada | Relações e publicação | Cluster/corredor/âncora/educação pesquisáveis e relacionados nas fichas. | | P1 | Exploração | Catálogo | Lista/grelha, comparação, favoritos, exportação e mapa de dados geográficos autorizados. | | P1 | Backoffice e rastreabilidade | Modelo + gates | Relações editáveis, opções desactiváveis sem perda histórica, decisões auditadas. | | P1 | QA e migração | Implementação | Testes isolados, backup/restauro, migração aditiva, verificação móvel/desktop. | | P2 | Homologação e operação remota | Acesso à outra máquina | Código/base reconciliados, ensaio de deploy/reversão e monitorização no destino. | | P2 | Formação | Fluxos validados | Manual, exercícios e sessão com participantes reais; não declarar formação executada sem evidência. | ## Limites de verificação A aprovação dos requisitos está registada. Aprovação não substitui acesso técnico à outra máquina, dados geográficos ausentes, conteúdos institucionais ou evidência de testes. Produção remota, certificação WCAG e formação real só podem ser declaradas concluídas com execução comprovada.