14 KiB
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:
- Registar a apresentação anterior em computador e telemóvel, com os componentes reais e dados sintéticos.
- Copiar os dois originais efectivamente usados pela referência (
hero-1.pngehero-3.jpg), conferir SHA-256 e gerar derivados WebP para computador e telemóvel.hero-2.pngnão faz parte da rotação da referência. - Extrair
components/portal-hero.tsxe 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é. - 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-usoao hero; foi removido na revisão expressamente pedida pela Tempo abaixo. - 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.