Files
Investidor-V2/docs/investmoz/unification/README.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

67 lines
9.5 KiB
Markdown

# 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.