Files
Investidor-V2/docs/investmoz/public-portal-sections.md
T
2026-10-23 10:36:34 +02:00

87 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Portal público — estrutura e serviços
Implementação local de 27/09/2026, seguindo as sete áreas pedidas pelo proprietário.
## Páginas e percursos
| Área | Caminho e comportamento |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Página inicial | `/`: cabeçalho, banner, sectores activos, Como Investir, oportunidades em destaque, documentos essenciais publicados, apoio e rodapé. |
| Oportunidades | `/oportunidades`: pesquisa, sector, província, estado de preparação/maturidade e dimensão por montante mínimo/máximo e moeda. Valores em moedas diferentes nunca são somados ou comparados automaticamente. Só aparecem oportunidades publicadas. |
| Ficha de oportunidade | `/oportunidades/{slug}`: ficha e manifestação de interesse existentes. |
| Sectores prioritários | `/sectores` e `/sectores/{slug}`: descrição do cadastro, oportunidades publicadas e acesso ao percurso de preparação e apoio. |
| Como Investir | `/como-investir`: seis etapas de preparação, documentação, enquadramento, parceiros e acompanhamento; roteiro de orientação, sem inventar prazos ou requisitos legais obrigatórios. |
| Legislação e Incentivos | `/legislacao`: documentos públicos catalogados como legislação, pesquisáveis por título, categoria e tema, com referência e download. |
| Documentos e Formulários | `/documentos`: catálogo público, pesquisa, categorias, temas e acesso aos formulários digitais. |
| Apoio ao Investidor | `/apoio`: formulário, protocolo, contactos configuráveis e FAQ sobre utilização do portal. |
| Bolsa de Parcerias | `/parcerias`: propostas publicadas, filtros e pedido de contacto intermediado. Conta com email verificado pode propor; gestor autorizado publica ou retira. Contactos e identidade da conta não são expostos na listagem pública. |
| Simulador Fiscal | `/simulador-fiscal`: cálculo aritmético de cenários com base, taxa e redução introduzidas pelo utilizador. Não incorpora taxas legais, elegibilidade ou concessão automática de incentivos. |
| Formulários | `/formularios/investidor` e `/formularios/empresa`: recolha de dados de contacto, sector/assunto, empresa quando aplicável, mensagem e consentimento; gera protocolo. Não equivale a constituição ou registo legal de empresa. |
| Balcão Virtual | `/balcao-virtual`: autenticação e email verificado; mostra pedidos enviados com a conta e estado das suas propostas. Liga ao painel existente da carteira. |
O layout partilhado acrescenta breadcrumbs e o botão fixo **Contactar Apoio ao Investidor** às páginas Inertia, incluindo autenticação e gestão. Páginas de erro produzidas directamente pelo servidor não passam por este layout.
## Gestão e dados
`/management/portal-services` permite carregar PDF/TXT autorizado (até 10 MiB), catalogar, publicar e retirar documentos, e rever/publicar/retirar propostas de parceria. Usa o privilégio existente `manage-portal`, sem criar novos gestores e sem exigir uma segunda pessoa para publicar.
Os ficheiros ficam no storage privado e os metadados no cadastro `documents`. Downloads só funcionam para documentos activos, classificados como públicos e catalogados como publicados; verificam caminho real e SHA-256. Reclassificar, eliminar, retirar ou alterar o ficheiro bloqueia o download. Não foi instalado um motor antivírus.
A migration aditiva `2026_09_27_120000_public_portal_services` cria `portal_resources` e `portal_partnerships`; rollback com dados é recusado. Nenhum documento legal, contacto institucional ou anúncio fictício foi inserido. Sem conteúdo publicado, as páginas apresentam estado vazio e caminho para pedir apoio.
Os pedidos reutilizam `interest_requests`, o serviço transaccional `InterestSubmission` e a gestão `/management/interests`, com tipo e contexto em `metadata`. Repetir a mesma chave e payload não duplica pedido ou evento de integração; reutilizar a chave com dados/conta diferentes devolve 409. Consentimento é obrigatório. O Balcão filtra pelo ID da conta gravado no envio, nunca por coincidência de email. Pedidos anónimos geram protocolo, mas não são associados retroactivamente a contas.
Os eventos da outbox permanecem pendentes conforme a integração existente. Não foram enviados emails nem activado SuiteCRM. Os estados dos pedidos são actualizados na gestão existente; o Balcão não oferece chat nem submissão automática a entidades públicas.
## Contactos e conteúdo
Configurar `PORTAL_SUPPORT_EMAIL`, `PORTAL_SUPPORT_PHONE`, `PORTAL_SUPPORT_ADDRESS` e `PORTAL_SUPPORT_HOURS` no ambiente e limpar cache de configuração quando necessário. Campos vazios não geram contactos fictícios. Publicar os documentos reais no catálogo para preencher Legislação, Documentos e os destaques essenciais da página inicial.
## Validação
Execução final: **124 testes / 1.284 verificações aprovadas**. PHPStan nos controllers alterados, Pint, TypeScript e build aprovados.
Testes funcionais cobrem páginas públicas, acesso autenticado, privacidade dos pedidos, consentimento, idempotência, moderação de parcerias, ausência de identidade pública, classificação/checksum dos downloads, documentos essenciais e filtros monetários. Os testes HTTP desactivam SSR para não dependerem do servidor Vite de desenvolvimento; a protecção contra chamadas HTTP inesperadas da IA permanece activa.
Edge headless: 11 páginas públicas/autenticação verificadas a 390×844, com breadcrumbs, botão de apoio visível e sem transbordo horizontal ou excepções JavaScript. Capturas de início e apoio inspeccionadas. Fluxos privados, submissões e downloads foram verificados nos testes PHP com dados sintéticos em base isolada, não em contas reais no navegador.
Página inicial também verificada a 1440×1000. Cenário fiscal exercitado no navegador: base 1.000 × taxa 10% × (1 − redução 50%) = 50. Resultados em `public-portal-browser-validation.json`.
Antes da migration local foi criado e restaurado o backup de 74 tabelas em `storage/app/private/portal-services-backup-20260927-090641/`. O backup completo anterior permanece em `C:/laragon/backups/portal-investidor-20260927-101224/` e representa o estado anterior a esta entrega.
## Adequação do hero — 23/10/2026
Origem: pedido expresso da Tempo nesta sessão para aproveitar o hero, as imagens e a barra de pesquisa de `D:/Projects/Tempo_Investidor/investidor`, usando a informação existente no V2. Aplicam-se as orientações permanentes do `AGENTS.md`, incluindo a distinção entre decisão da Tempo e escolha técnica, a preservação de dados e a separação de QA e activo.
Análise prévia: a página de entrada real do V2 é `PortalInvestidor.tsx`, servida por `PortalServicesController::home`. A referência é `domains/investor-portal/components/homepage/homepage-hero.tsx`, montada em `InstitutionalHomepage`. A referência usa Inertia 2, Framer Motion, tradução e navegação diferentes; o V2 usa Inertia 3 e pesquisa de oportunidades. Copiar essas dependências e `/pesquisa` ou `/aviso-legal` directamente criaria incompatibilidades e destinos inexistentes.
Plano executado:
1. Registar a apresentação anterior em computador e telemóvel, com os componentes reais e dados sintéticos.
2. Copiar os dois originais efectivamente usados pela referência (`hero-1.png` e `hero-3.jpg`), conferir SHA-256 e gerar derivados WebP para computador e telemóvel. `hero-2.png` não faz parte da rotação da referência.
3. Extrair `components/portal-hero.tsx` e aplicar fotografias em rotação, texto centrado e pesquisa branca com botão vermelho. Preservar os textos do V2, contagens da API, sectores, documentos, apoio, cabeçalho e rodapé.
4. Manter a pesquisa de oportunidades em `/oportunidades?q=`, incluindo pesquisa vazia e caracteres acentuados. Conservar “Consultar oportunidades” e “Planear finanças”. A primeira iteração acrescentou o acesso jurídico `/termos-de-uso` ao hero; foi removido na revisão expressamente pedida pela Tempo abaixo.
5. Verificar apresentação, teclado, imagens, rotação, pausa, movimento reduzido, falha da API, contagens zero, TypeScript, lint e compilação. Compilar primeiro o pacote QA e depois os assets locais em `public/build`.
Escolhas técnicas desta adaptação: React e transições CSS existentes, sem novas dependências; rotação de oito segundos, pausa por controlo explícito, foco, ponteiro ou separador oculto; apresentação estática quando o utilizador pede movimento reduzido. A primeira iteração apresentou o texto estático; a revisão abaixo introduz a escrita dinâmica pedida pela Tempo. O campo indica pesquisa de oportunidades e conserva exemplos que o catálogo suporta; esta alteração não implementa uma pesquisa global de legislação/licenciamento.
Evidência reproduzível: `tools/portal-hero-qa.mjs`, com Vite local e Playwright configurável por `HERO_QA_PLAYWRIGHT`/`HERO_QA_CHROMIUM`. Fixtures e capturas em `outputs/portal-hero-20261023/`; síntese persistente em `public-portal-hero-validation.json`. Os testes de interface interceptam a API e a navegação Inertia, sem acesso a Laravel, base de dados ou serviços externos. A compilação local aplica os assets desta pasta; não representa publicação noutro servidor.
Referências na matriz existente: `MASTER-efd550fd-0104` (composição da página), `MASTER-9dee08d0-0016` (contexto da pesquisa) e `MASTER-55050f60-0001` (entrada documental preservada). Esta prova cobre a adaptação visual e os percursos exercitados; não encerra os critérios funcionais mais amplos dessas linhas.
### Revisão: escrita dinâmica e remoção do acesso jurídico no hero
Decisão expressa da Tempo na continuação da sessão de 23/10/2026: animar “INVISTA EM MOÇAMBIQUE” e “Transforme informação em decisões e ideias em negócios reais.” como na página de referência, e remover “Termos de uso” do hero. A anterior apresentação estática e a inclusão desse link eram escolhas de implementação, agora substituídas pelo pedido do proprietário.
Análise e plano executado: reproduzir a sequência da referência (espera inicial de 250 ms, título a 50 ms por carácter, intervalo de 150 ms e frase a 28 ms por carácter); reiniciar ao trocar de imagem; acrescentar o cursor intermitente; reservar a dimensão final de ambas as linhas para manter a pesquisa imóvel; remover o link e o ícone jurídico do hero; verificar em computador e telemóvel e compilar o pacote local.
Implementação em `portal-hero.tsx`, com React existente e CSS do cursor em `app.css`, sem dependências novas. A pausa explícita suspende também a escrita, retomando do mesmo ponto. Quando o separador fica oculto a escrita pára; a preferência de movimento reduzido apresenta os dois textos completos. Leitores de ecrã recebem o texto completo uma única vez, independentemente do número de caracteres visíveis. Os temporizadores são limpos ao mudar de imagem ou desmontar o componente.
O script `tools/portal-hero-qa.mjs` demonstra a escrita progressiva, a ordem título→frase, o reinício manual/automático, a pausa/retoma, a posição estável da pesquisa, o modo sem movimento e a ausência de “Termos de uso” no hero. As capturas e resultados desta revisão ficam em `outputs/portal-hero-typing-20261023/`, preservando a evidência anterior. Síntese e compilação final registadas na revisão de `public-portal-hero-validation.json`; referência acrescentada à linha existente `MASTER-efd550fd-0104`, sem encerrar o seu critério mais amplo.
### Revisão: remoção dos controlos visíveis das imagens
Pedido expresso da Tempo na continuação de 23/10/2026: remover do hero o grupo com o botão de pausa e as duas bolinhas de selecção de imagem. Removidos o grupo, os ícones e o estado de pausa manual. A troca automática de imagens e a escrita dinâmica permanecem; conservam-se a pausa da rotação por foco/ponteiro, a suspensão em separador oculto e a preferência de movimento reduzido. Esta decisão substitui os controlos visíveis introduzidos como escolha de implementação nas revisões anteriores.
O script existente de interface foi adaptado para demonstrar a ausência dos controlos e a continuação da rotação automática, escrita e pesquisa, com capturas em `outputs/portal-hero-no-controls-20261023/`. Evidência e pacote local registados em `public-portal-hero-validation.json`, mantendo o histórico das revisões e os estados dos requisitos da matriz.