@@ -0,0 +1,66 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,165 @@
|
||||
{
|
||||
"date": "2026-09-27",
|
||||
"environment": "APP_ENV=qa; isolated QA database; synthetic fixtures",
|
||||
"reports": [
|
||||
{
|
||||
"name": "education-mobile",
|
||||
"title": "Oportunidades na Educação",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "opportunity-mobile",
|
||||
"title": "Laboratório sintético de formação",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "workspace-mobile",
|
||||
"title": "Área do investidor",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "profile-companies-mobile",
|
||||
"title": "Perfil de investimento e empresas",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "identity-mobile",
|
||||
"title": "Preparar manifestação de interesse",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "investment-mobile",
|
||||
"title": "Preparar manifestação de interesse",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "needs-mobile",
|
||||
"title": "Preparar manifestação de interesse",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "attachments-mobile",
|
||||
"title": "Preparar manifestação de interesse",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "review-mobile",
|
||||
"title": "Preparar manifestação de interesse",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "receipt-mobile",
|
||||
"title": "Manifestação IR-2026-01M3J34C62CKWV6WPG0H3B9SCE",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "conversation-revision-mobile",
|
||||
"title": "Manifestação IR-2026-01M3J34C62CKWV6WPG0H3B9SCE",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "notifications-mobile",
|
||||
"title": "Notificações e acompanhamento",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "workspace-desktop",
|
||||
"title": "Área do investidor",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "catalogue-desktop",
|
||||
"title": "Catálogo de investimento",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "references-desktop",
|
||||
"title": "Opções dos formulários e filtros",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "context-desktop",
|
||||
"title": "Contexto: Laboratório sintético de formação",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "management-receipt-desktop",
|
||||
"title": "Manifestação IR-2026-01M3J34C62CKWV6WPG0H3B9SCE",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
},
|
||||
{
|
||||
"name": "references-mobile",
|
||||
"title": "Opções dos formulários e filtros",
|
||||
"overflow": false,
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"unlabelled": 0
|
||||
}
|
||||
],
|
||||
"errors": [],
|
||||
"workflow": {
|
||||
"csrfEnforced": true,
|
||||
"draftSaved": true,
|
||||
"stepPreserved": true,
|
||||
"privateAttachment": true,
|
||||
"receipt": true,
|
||||
"idempotentReplay": true,
|
||||
"managerContext": true,
|
||||
"ownerIsolation": true,
|
||||
"profileCompanyPrefill": true,
|
||||
"conversation": true,
|
||||
"revisions": true,
|
||||
"notifications": true
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
# Dados, migração e operação da unificação
|
||||
|
||||
## Modelo e dicionário da extensão
|
||||
|
||||
O esquema executável está em `database/migrations/2026_09_27_140000_investment_unification.php` e `2026_09_27_150000_investor_workspace.php`. Todas as relações têm chaves externas com eliminação restringida. Identificadores territoriais são UUID; oportunidades e utilizadores conservam os seus identificadores numéricos.
|
||||
|
||||
| Tabela | Chave / relação | Conteúdo e regra |
|
||||
| --- | --- | --- |
|
||||
| `investment_reference_options` | `id`; único `(group,code)` | Rótulo, actividade, ordem, obrigatoriedade de especificação. Códigos estáveis; desactivar não elimina referências históricas. |
|
||||
| `opportunity_profiles` | PK/FK `opportunity_id` | Educação, modelo de negócio, requisitos, riscos, data-alvo, fonte, versão. Texto destinado à ficha pública após publicação. Não colocar aqui notas privadas. |
|
||||
| `opportunity_clusters` | PK `(opportunity_id,cluster_id)` | Uma oportunidade pode pertencer a vários clusters. |
|
||||
| `opportunity_corridors` | PK `(opportunity_id,corridor_id)` | Vários corredores por oportunidade. |
|
||||
| `opportunity_projects` | PK `(opportunity_id,project_id)` | Vários projectos âncora por oportunidade. |
|
||||
| `opportunity_locations` | PK `(opportunity_id,geo_location_id)` | Ligações às localizações existentes. Geometrias continuam em `geo_geometries`, PostGIS SRID 4326. |
|
||||
| `opportunity_facets` | PK `(opportunity_id,option_id)` | Subsector, parceria, impacto, educação, infraestrutura, competências e necessidades configuráveis. |
|
||||
| `investment_submissions` | UUID; dono `user_id`; recibo único `interest_request_id` | `payload` encriptado, versão, estado draft/submitted. No máximo um destino: oportunidade ou dossier; interesse geral admite nenhum. Submissão exige recibo e rascunho não o admite. |
|
||||
| `investment_specific_needs` | `submission_id`; opções FK | Categoria, tipo, quantidade decimal não negativa, unidade, prioridade, prazo. Descrição, localização e demais detalhes são encriptados. |
|
||||
| `investment_submission_attachments` | UUID; submissão/documento FK | Ficheiro privado em `documents`; nome, tipo, tamanho e checksum canónicos. |
|
||||
| `investment_submission_events` | `submission_id`, actor, versão | Criação, gravação, anexo e submissão. Guarda actos e versões; não é um arquivo de cópias integrais dos rascunhos. |
|
||||
| `opportunity_favourites` | PK `(user_id,opportunity_id)` | Favoritos privados, sem duplicações. Retirada de publicação oculta-os. |
|
||||
| `investment_accounts` | PK/FK `user_id` | Perfil de investimento encriptado e versionado; complementa nome/email da conta. |
|
||||
| `investment_company_declarations` | UUID; dono `user_id` | Dados empresariais declarados, encriptados e versionados; até vinte por utilizador. Não altera `organizations` ou `memberships`, nem comprova representação. |
|
||||
| `investment_messages` | UUID; submissão/actor; chave única `(submission_id,actor_id,client_key)` | Conversa encriptada depois da submissão. Repetição com mesmo texto devolve ID; reutilização da chave com outro texto é conflito. |
|
||||
| `investment_notifications` | UUID; utilizador/submissão; evento único por destinatário | Confirmação, estado e mensagem, conteúdo encriptado, data de leitura. Notificações internas, sem envio de email nesta extensão. |
|
||||
| `investment_submission_revisions` | único `(submission_id,version)` | Snapshot encriptado do formulário, necessidades e IDs dos anexos em cada nova versão. Consulta por titular/gestor, sem restauro automático. |
|
||||
|
||||
Relações principais: `users → investment_submissions → investment_specific_needs`; `investment_submissions → investment_submission_attachments → documents`; `investment_submissions → interest_requests → outbox_events → CRM`; `opportunities ↔ clusters/corridors/projects/locations` através dos quatro pivots. Dossiers continuam ligados às entidades territoriais originais, sem serem copiados para `opportunities`.
|
||||
|
||||
O `payload` admite nome, email, telefone, país, organização, função, experiência, capacidade declarada, perfil, sector, objectivo, participação, parceria, montante/moeda, horizonte, localização, referências territoriais, especificação de Outro e consentimento. Campos desconhecidos são recusados. As necessidades admitem descrição, localização, observações, qualificação, especialidade, experiência, certificações, disponibilidade, instituição, modalidade/duração de formação e estado declarado. Os dados quantitativos não são indicadores territoriais verificados.
|
||||
|
||||
## Regras de visibilidade e segurança
|
||||
|
||||
- A pesquisa exige oportunidade publicada, data de publicação atingida e ausência de eliminação lógica. Relações territoriais públicas exigem dossier publicado; localizações e geometrias exigem classificação pública.
|
||||
- O mapa devolve apenas pontos publicados; não estima coordenadas nem consulta serviços externos. A lista textual contém os mesmos locais.
|
||||
- Editar contexto devolve a oportunidade a rascunho. A versão recebida tem de coincidir sob bloqueio transaccional; conflito devolve 409.
|
||||
- Só o titular altera a sua manifestação. Gestores autorizados podem lê-la para atendimento. Outro investidor recebe 404. Após submissão, alterações são recusadas e repetir o envio devolve o mesmo protocolo.
|
||||
- A submissão, o recibo e o evento de integração são gravados atomicamente pelo serviço existente `InterestSubmission`. Nenhum envio externo SuiteCRM é activado por esta extensão.
|
||||
- Anexos PDF/TXT: até 10 MiB cada, dez por manifestação. Armazenamento privado; acesso revalida dono/gestor, estado, directório e SHA-256. Os anexos não integram o catálogo público.
|
||||
- `payload` e detalhes usam encriptação Laravel. Preservar `APP_KEY` com o backup e restringir o acesso; trocar a chave sem plano torna estes campos ilegíveis.
|
||||
- Auditoria guarda actor, identificador, acto e versão, sem copiar perguntas, contactos ou texto privado. A retenção e eliminação de dados pessoais ainda exigem uma política operacional implementada.
|
||||
- As revisões integrais privadas ficam separadas da auditoria. Quem deixa de ser gestor perde acesso a pedidos e notificações de terceiros. Mensagens só são permitidas em manifestações submetidas e não alteram a versão do formulário.
|
||||
- APIs privadas usam sessão web, email verificado, CSRF e limites de pedidos. Registo público não atribui gestão. Papéis técnico/validador/promotor separados ainda não foram introduzidos nesta extensão.
|
||||
|
||||
## Migração local executada em 27/09/2026
|
||||
|
||||
1. Backup privado `storage/app/private/unification-backup-20260927-134405/database.dump` e manifesto SHA-256.
|
||||
2. Restauro numa base isolada `unification_restore_20260927134405_test`, PostgreSQL de QA na porta 55441; comparação de contagens das 76 tabelas existentes antes de migrar.
|
||||
3. Aplicação exclusiva da migration `2026_09_27_140000_investment_unification` e de `InvestmentReferenceSeeder`. São doze tabelas adicionais. O seed usa `insertOrIgnore`: não substitui opções editadas.
|
||||
4. Não se executou `DatabaseSeeder`, não se importaram exemplos remotos e não se criaram oportunidades, empresas ou coordenadas fictícias na base local.
|
||||
|
||||
Segunda extensão: migration `2026_09_27_150000_investor_workspace`, após backup/restauro verificado de 88 tabelas em `storage/app/private/workspace-backup-20260927-184429/`. Resultado: **93 tabelas**; as cinco novas ficaram vazias. Reconciliação após a segunda migration: apenas `migrations` mudou (33 → 34); contagens das restantes 87 tabelas preservadas. O seed de instalação local passou também a incluir as opções de investimento; não foi reexecutado globalmente na base operacional.
|
||||
|
||||
O backup integral anterior, `C:\laragon\backups\portal-investidor-20260927-101224`, tem instruções em `RESTAURO.md`. Representa uma versão anterior à extensão das sete áreas públicas; não misturar silenciosamente esse código com a base nova.
|
||||
|
||||
## Aplicação noutro ambiente
|
||||
|
||||
Reconciliar primeiro código, migrations aplicadas e conteúdo da outra máquina. Gerar backup integral de código, base, ficheiros privados e chave, e ensaiar restauro isolado. Preservar IDs/origens remotos numa tabela de correspondência antes de qualquer importação; comparar contagens, unicidade, FKs, checksums e conteúdo por categoria. Exemplos demonstrativos ficam excluídos do catálogo real. A comparação pública não prova equivalência das bases.
|
||||
|
||||
Com o código compatível e o backup conferido:
|
||||
|
||||
```sh
|
||||
php artisan migrate --path=database/migrations/2026_09_27_140000_investment_unification.php --force
|
||||
php artisan db:seed --class=InvestmentReferenceSeeder --force
|
||||
php artisan migrate --path=database/migrations/2026_09_27_150000_investor_workspace.php --force
|
||||
npm run build
|
||||
php artisan optimize:clear
|
||||
```
|
||||
|
||||
Executar os testes apenas com `APP_ENV=testing` e base isolada terminada em `_test`. Nunca usar `migrate:fresh` na base operacional.
|
||||
|
||||
## Reversão e monitorização
|
||||
|
||||
O `down()` recusa remover tabelas com dados, incluindo as opções semeadas. Para reverter código, conservar as tabelas aditivas e retirar os novos acessos. Para restaurar a base integral, suspender escritas e trabalhadores, guardar primeiro os dados recebidos depois do backup, restaurar numa base nova e reconciliar antes de mudar a ligação. Não substituir a base activa durante a verificação. O ensaio desta entrega prova restauro do dump anterior; não prova reversão de produção com tráfego concorrente.
|
||||
|
||||
Monitorizar erros HTTP 5xx, conflitos 409, recusas 403/404, limites 429, fila/outbox pendente e falhas de entrega, integridade dos anexos, espaço em disco, backups e latência de pesquisa/submissão. Não colocar nomes, emails, conteúdo de anexos ou formulários em métricas. Medir p50/p95/p99 no destino antes de definir SLA; medições locais de poucos registos não são ensaio de carga.
|
||||
|
||||
## Go / No-Go
|
||||
|
||||
| Item | Situação |
|
||||
| --- | --- |
|
||||
| Autorização dos requisitos | Expressamente concedida pelo proprietário; não requer nova aprovação genérica. |
|
||||
| Extensão local e opções | Aplicadas após backup/restauro. |
|
||||
| QA automatizado e navegador | Evidências em `validation.md`; conferir limitações de cada ensaio. |
|
||||
| Conteúdo e geografia | Publica-se apenas o existente autorizado; completar dados com fontes reais. |
|
||||
| Consolidação da outra máquina | Adiada pelo proprietário para fase futura; fora do âmbito da execução local actual. |
|
||||
| WCAG 2.2 AA | Verificações parciais; falta auditoria completa com tecnologia assistiva. |
|
||||
| Área pessoal, empresas declaradas, mensagens e notificações | Implementadas e testadas localmente; sem atribuição automática de representação empresarial. |
|
||||
| Perfis especializados e cadastro territorial completo | Cobertura parcial; ver matriz de rastreabilidade. |
|
||||
| SuiteCRM real, carga, recuperação no destino | Não ensaiados nesta entrega. |
|
||||
| Formação e produção | Plano preparado; sessões e entrada em produção não executadas. |
|
||||
|
||||
Resultado: disponível para utilização e avaliação local. A conclusão integral do prompt e a prontidão de produção não estão demonstradas pelos testes desta extensão.
|
||||
@@ -0,0 +1,48 @@
|
||||
{
|
||||
"date": "2026-09-27",
|
||||
"environment": "local PHP development server, sequential loopback HTTP requests; no load or production SLA claim",
|
||||
"measurements": [
|
||||
{
|
||||
"path": "/api/v1/investment/search",
|
||||
"repetitions": 5,
|
||||
"median_ms": 170.67,
|
||||
"min_ms": 154.9,
|
||||
"max_ms": 207.66,
|
||||
"samples_ms": [
|
||||
207.66,
|
||||
154.9,
|
||||
168.66,
|
||||
198.91,
|
||||
170.67
|
||||
]
|
||||
},
|
||||
{
|
||||
"path": "/api/v1/investment/references",
|
||||
"repetitions": 5,
|
||||
"median_ms": 173.39,
|
||||
"min_ms": 151.81,
|
||||
"max_ms": 210.99,
|
||||
"samples_ms": [
|
||||
210.99,
|
||||
184.29,
|
||||
162.7,
|
||||
173.39,
|
||||
151.81
|
||||
]
|
||||
},
|
||||
{
|
||||
"path": "/api/v1/investment/map",
|
||||
"repetitions": 5,
|
||||
"median_ms": 160.86,
|
||||
"min_ms": 148.68,
|
||||
"max_ms": 198.9,
|
||||
"samples_ms": [
|
||||
172.47,
|
||||
160.11,
|
||||
198.9,
|
||||
160.86,
|
||||
148.68
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,87 @@
|
||||
{
|
||||
"reports": [
|
||||
{
|
||||
"path": "/",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Oportunidades reais de investimento em Moçambique, organizadas por sector."
|
||||
},
|
||||
{
|
||||
"path": "/oportunidades",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Catálogo de investimento"
|
||||
},
|
||||
{
|
||||
"path": "/sectores",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Sectores Prioritários"
|
||||
},
|
||||
{
|
||||
"path": "/como-investir",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Como Investir / Procedimentos"
|
||||
},
|
||||
{
|
||||
"path": "/legislacao",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Legislação e Incentivos"
|
||||
},
|
||||
{
|
||||
"path": "/documentos",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Documentos e Formulários"
|
||||
},
|
||||
{
|
||||
"path": "/apoio",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Apoio ao Investidor"
|
||||
},
|
||||
{
|
||||
"path": "/parcerias",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Bolsa de Parcerias"
|
||||
},
|
||||
{
|
||||
"path": "/simulador-fiscal",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Simulador Fiscal"
|
||||
},
|
||||
{
|
||||
"path": "/formularios/empresa",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Formulário de empresa"
|
||||
},
|
||||
{
|
||||
"path": "/login",
|
||||
"breadcrumb": true,
|
||||
"supportVisible": true,
|
||||
"overflow": false,
|
||||
"title": "Log in to your account"
|
||||
}
|
||||
],
|
||||
"simulation": "Sem redução: 100,00 MTnRedução simulada: 50,00 MTnTotal do cenário: 50,00 MTnBase × taxa ÷ 100 × (1 − redução ÷ 100). Não inclui outros impostos, deduções, escalões ou regras sectoriais.",
|
||||
"desktop": {
|
||||
"overflow": false,
|
||||
"breadcrumb": true
|
||||
},
|
||||
"errors": []
|
||||
}
|
||||
@@ -0,0 +1,73 @@
|
||||
# Rastreabilidade, utilização e formação
|
||||
|
||||
## Matriz executável
|
||||
|
||||
| Menu / ecrã | Componente React | Campos / entidade / tabela | Rota ou API | Perfil / regra | Evidência |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| Início | `PortalInvestidor` | Sectores, oportunidades, recursos publicados | `/`, APIs existentes de homepage | Visitante; contagens do cadastro | `PublicPortalNavigationTest`, navegador |
|
||||
| Catálogo / Educação | `investment/catalogue` | Filtros, educação, pivots, facetas | `/oportunidades`, `/educacao`; `/api/v1/investment/search` | Visitante; filtros em intersecção, montantes com moeda | `InvestmentUnificationTest` |
|
||||
| Cluster / Corredor / Âncora | `portfolio/index`, `portfolio/show` | Dossiers, relações, cadeias e oportunidades | `/clusters`, `/corredores`, `/projectos-ancora`, `/carteira/{id}` | Visitante; dossier publicado; cadeia pública | `InvestmentPortfolioTest`, testes territoriais |
|
||||
| Ficha | `investment/detail` | Oportunidade, contexto, relações, fonte | `/oportunidades/{slug}`; `/api/v1/investment/opportunities/{slug}` | Visitante; rascunhos não acessíveis | `PublicPortalNavigationTest`, `InvestmentUnificationTest` |
|
||||
| Mapa | Componente `Map` em catálogo | `geo_locations`, `geo_geometries`, `opportunity_locations` | `/api/v1/investment/map` | Visitante; dois níveis de classificação pública | Teste PostGIS e estados vazios |
|
||||
| Comparar / exportar / sugerir | `investment/catalogue` | IDs publicados, dados de catálogo | `/compare`, `/export`, `/suggest` sob prefixo da API | Visitante; 4 comparações, 1.000 linhas/pontos; CSV protegido | Teste de publicação e fórmula CSV |
|
||||
| Área do investidor | `investment/workspace` | Manifestações, recibos, favoritos | `/investidor/manifestacoes`; `/api/v1/investment/submissions` | Titular autenticado e verificado | Isolamento por dono |
|
||||
| Perfil / empresas | `investment/profile` | `investment_accounts`, `investment_company_declarations` | `/investidor/profile`; API `/profile`, `/companies/{id?}` | Titular; versão, encriptação, sem concessão de memberships | `InvestmentWorkspaceTest` e navegador |
|
||||
| Conversa / versões | `investment/conversation` | `investment_messages`, `investment_submission_revisions` | API `/submissions/{id}/messages`, `/submissions/{id}/revisions/{version}` | Titular/gestor; mensagem idempotente; histórico privado | Testes de isolamento, encriptação e reenvio; navegador |
|
||||
| Notificações | `investment/notifications` | `investment_notifications` | `/investidor/notifications`; API `/notifications`, `/{id}/read` | Destinatário; revogação de acesso a terceiros respeitada | Testes de mudança de estado e leitura; navegador |
|
||||
| Manifestação | `investment/submission` | `investment_submissions.payload`, necessidades | `PUT /submissions/{id}`, `POST /submissions/{id}/submit` | Titular; versão, opções activas, consentimento, idempotência | Testes de conflito, validação e reenvio |
|
||||
| Anexos | Etapa 4 da manifestação | `documents`, `investment_submission_attachments` | `/submissions/{id}/attachments` | Titular/gestor lê; titular altera rascunho; checksum | Teste de anexo privado e adulteração |
|
||||
| Contexto da oportunidade | `investment/context` | Perfil, relações muitos-para-muitos, facetas | `/management/opportunities/{id}/context` | Gestor; versão e retorno a rascunho | Teste de gestão, conflito e educação |
|
||||
| Referências e formulários | `investment/references` | Opções, rótulos, ordem, actividade | `/management/investment/references` | Gestor; códigos estáveis, Outro preservado | Teste de referências e reexecução do seed |
|
||||
| Atendimento / CRM | `management/interest`, gestão CRM existente | `interest_requests`, `outbox_events`, leads | `/management/interests/{id}` | Gestor; consulta manifestação completa pelo vínculo | Testes de intake e CRM existentes |
|
||||
| Apoio / documentos / parcerias | `portal/services`, `portal/manage` | Recursos, parcerias, pedidos existentes | `/apoio`, `/documentos`, `/parcerias`, `/balcao-virtual` | Regras existentes de publicação e dono | `PublicPortalServicesTest` |
|
||||
|
||||
Os nomes curtos `/compare`, `/submissions`, etc. nesta matriz pertencem a `/api/v1/investment`. O contrato detalhado está em `openapi.json` (OpenAPI 3.0.3).
|
||||
|
||||
## Cobertura ainda parcial do prompt
|
||||
|
||||
As fichas territoriais apresentam conteúdo autorizado do documento v4, relações e cadeias cadastradas. Não existe ainda um editor unificado de todos os actores, fornecedores, contactos, infraestruturas físicas e indicadores para cada ficha. O mapa actual é de pontos de oportunidades, sem cartografia de linhas de corredores. As facetas representam classificações; não substituem inventário físico ou cálculo de lacunas.
|
||||
|
||||
A educação pública encontra oportunidades publicadas classificadas como educativas ou ligadas a propostas. As propostas geradas pelo módulo interno conservam a regra de publicação desse módulo; a extensão não torna públicas automaticamente necessidades internas ou alegações institucionais.
|
||||
|
||||
A área pessoal reúne rascunhos, manifestações, estados, favoritos, perfil de investimento, empresas declaradas, conversa bidireccional e notificações internas. As declarações empresariais são privadas e não substituem o cadastro canónico validado de organizações. Não existem candidaturas com um procedimento distinto das manifestações. Confirmação e notificações são apresentadas no portal; não se presume envio de email. O CRM local recebe o pedido pela outbox existente, mas a entrega a SuiteCRM remoto continua dependente da configuração e teste do conector.
|
||||
|
||||
O histórico de manifestações enumera actos e versões e permite consultar snapshots privados gravados a partir desta extensão; não restaura automaticamente versões anteriores. A gestão utiliza o gate `manage-portal`; separação de técnico, validador e administrador continua pendente. Os achados anteriores de concorrência/publicação em dossiers e revisão de resultados de IA permanecem registados em `../architecture-data-security-qa-product-review.md`.
|
||||
|
||||
## Manual do investidor
|
||||
|
||||
1. No catálogo, combine sector, território, maturidade, educação e características. Para comparar montantes, seleccione a mesma moeda. Os filtros não convertem câmbio.
|
||||
2. Alterne entre grelha, lista e mapa. Quando não há coordenadas autorizadas, o portal informa a ausência. Marque até quatro oportunidades para comparação; use Exportar para obter as primeiras mil linhas filtradas.
|
||||
3. Abra uma ficha e seleccione Preparar manifestação. Entre com conta de email verificado. Nome e email são preenchidos a partir da conta; os restantes dados são declarações do investidor.
|
||||
4. Preencha identificação e investimento, acrescente necessidades, quantidades e prazos. Escolha Outro e descreva quando nenhuma opção servir. Mão de obra e educação apresentam campos específicos.
|
||||
5. Guarde o rascunho antes de sair ou carregar anexos. Na etapa Anexos, associe PDF/TXT e identifique o ficheiro nas observações da necessidade correspondente.
|
||||
6. Reveja, conceda consentimento de contacto e envie. O protocolo identifica um único pedido; repetir o envio não o duplica. Consulte o estado na área pessoal. O envio não constitui aprovação de investimento nem consentimento para IA.
|
||||
7. Se aparecer conflito de versão, recarregue para ver a versão actual antes de repetir a alteração. Nunca sobrescrever automaticamente uma sessão concorrente.
|
||||
8. Em Perfil e empresas, guarde dados reutilizáveis e declare as empresas que representa. Preparar manifestação desta empresa preenche os dados declarados, sem atribuir permissões sobre organizações de terceiros.
|
||||
9. Depois de submeter, use Conversa com o apoio para esclarecimentos. Consulte Notificações para respostas e mudanças de estado; marque-as como lidas. Em Versões guardadas, consulte o conteúdo anterior sem alterar o pedido actual.
|
||||
|
||||
## Manual de gestão
|
||||
|
||||
1. Em Oportunidades, crie ou edite a ficha principal e abra Contexto. Associe clusters, corredores, âncoras e localizações existentes; seleccione educação/facetas quando aplicável e registe a fonte.
|
||||
2. Guardar contexto retira a publicação até revisão explícita na ficha principal. Confira texto, referências, moeda e ausência de informação privada antes de publicar.
|
||||
3. Em Referências e formulários, acrescente opções dentro dos grupos existentes. Edite rótulos e ordem; desactive opções obsoletas. Não altere códigos já usados. Outro mantém-se activo e exige especificação.
|
||||
4. Em Pedidos de interesse, consulte a manifestação completa e os anexos privados. Actualize o estado pelo fluxo existente e encaminhe para o CRM com responsável e próxima acção.
|
||||
5. Dossiers e oportunidades são registos diferentes. A associação é explícita; não copie as quinze âncoras para o catálogo só para produzir resultados.
|
||||
|
||||
## Design e protótipos executáveis
|
||||
|
||||
Os ecrãs React são os protótipos funcionais entregues: catálogo, detalhe, área pessoal, formulário de cinco etapas, contexto e referências. Não foi produzido um ficheiro Figma nem se alega validação prévia por participantes. A biblioteca local usa fundo slate-50, texto slate-900, acções emerald-800, cartões com borda, campos rotulados, foco visível, grelhas responsivas e estados vazios explícitos. Elementos partilhados: `investment/shared.tsx` e `layouts/portal-navigation.tsx`.
|
||||
|
||||
Verificar teclado, ordem/foco, erros, contraste, zoom 200–400%, leitura assistiva, upload e suporte fixo em cada alteração. A lista textual do mapa é alternativa ao SVG. Verificações automáticas e ausência de transbordo não equivalem a certificação WCAG 2.2 AA.
|
||||
|
||||
## Formação e próximos critérios
|
||||
|
||||
Plano preparado, sessões ainda não realizadas:
|
||||
|
||||
| Sessão | Exercício verificável | Resultado esperado |
|
||||
| --- | --- | --- |
|
||||
| Investidor — 30 min | Filtrar, comparar, guardar necessidade, anexar e enviar em ambiente de formação | Um protocolo; nenhum dado visível por outro participante |
|
||||
| Gestor — 45 min | Criar opção, associar contexto, rever publicação, consultar pedido e encaminhar | Fonte registada, rascunho antes de publicar, encaminhamento com responsável |
|
||||
| Operação — 45 min | Restaurar backup isolado, verificar chave/anexos, simular falha de fila | Reconciliação documentada; nenhum envio duplicado |
|
||||
| Acessibilidade — 30 min | Percurso por teclado e leitor de ecrã em móvel/computador | Registo de obstáculos e correcções antes de homologação |
|
||||
|
||||
Backlog restante: editores territoriais completos e cartografia; ligação validada de empresas declaradas ao cadastro canónico; papéis especializados; retenção; homologação assistiva e carga; SuiteCRM no destino; sessões de formação e deploy monitorizado. A reconciliação remota foi adiada pelo proprietário para fase futura. Cada item exige implementação/evidência concreta, não nova aprovação genérica dos requisitos já autorizados.
|
||||
@@ -0,0 +1,56 @@
|
||||
# Validação da extensão — 28/09/2026
|
||||
|
||||
## Verificações executadas
|
||||
|
||||
- Em 28/09, protecção de versões das fichas territoriais aplicada localmente. Backup `storage/app/private/portfolio-version-backup-20260928-011346/` restaurado e conferido em 93 tabelas; após migration, apenas `migrations` mudou de 34 para 35. As 29 fichas publicadas foram preservadas com `version_no=1`. A suite inclui recusa de gravação/publicação obsoletas com HTTP 409. O teste de navegador anteriormente registado não foi repetido para este novo controlo; cobertura desta alteração por testes HTTP, TypeScript, lint e build.
|
||||
|
||||
- Suite PHP completa: **138 testes, 1.463 verificações aprovadas**, em PostgreSQL/PostGIS isolado na porta 55441, base `portal_services_test`.
|
||||
- PHPStan completo e verificação TypeScript aprovados; análise focada repetida após as alterações finais. Pint aplicado aos novos ficheiros PHP. Lint dos componentes alterados executado; corrigido tratamento de falha da cópia de ligação.
|
||||
- Build Vite aprovado. As verificações de PHP não correram durante a substituição do manifesto do build.
|
||||
- O contrato OpenAPI descreve 27 operações, correspondentes às 25 rotas registadas (referências e empresas com ID opcional correspondem a criar e editar). JSON, referências internas e cobertura de métodos/rotas conferidos; isto não substitui validação completa por uma ferramenta OpenAPI externa.
|
||||
- Backup anterior à migration restaurado e conferido em 76 tabelas. Depois da migration: 88 tabelas; 114 opções semeadas, restantes tabelas novas vazias. Contagens de negócio anteriores preservadas; `migrations` passou de 32 a 33 e `sessions` de 1 a 2. Manifesto e reconciliação permanecem no directório privado do backup.
|
||||
- Segundo backup restaurado e conferido nas 88 tabelas antes da extensão de perfil/conversa; após a segunda migration, 93 tabelas e apenas alteração da contagem de `migrations` (33 → 34).
|
||||
- [Latência local](local-latency.json): cinco pedidos HTTP sequenciais por endpoint, medianas de 170,67 ms na pesquisa, 173,39 ms nas referências e 160,86 ms no mapa. Servidor PHP de desenvolvimento, pequeno cadastro local, sem concorrência; não é SLA nem teste de carga.
|
||||
|
||||
## Navegador
|
||||
|
||||
Microsoft Edge headless via DevTools Protocol, 390×844 e 1440×1000. [Evidência pública](public-browser-validation.json): onze páginas, breadcrumbs, apoio fixo, ausência de transbordo horizontal; cenário aritmético do simulador confirmado. Nenhum erro JavaScript observado.
|
||||
|
||||
[Evidência autenticada](browser-validation.json): dezoito observações de ecrãs/etapas, com contas e oportunidade exclusivamente sintéticas na base isolada. Foram exercitados:
|
||||
|
||||
1. Educação e ficha pública.
|
||||
2. Login, área pessoal e criação de rascunho.
|
||||
3. Identificação, participação, objectivo e necessidade educativa com quantidade/unidade.
|
||||
4. Gravação preservando a etapa actual.
|
||||
5. Upload privado pela API multipart, com versão incrementada.
|
||||
6. Revisão, consentimento, submissão e protocolo visível na área pessoal.
|
||||
7. Reenvio idempotente com o mesmo protocolo.
|
||||
8. Login de gestor, referências, edição de contexto e retirada da publicação.
|
||||
9. Leitura do pedido pelo gestor e recusa 404 a outro investidor.
|
||||
10. Perfil e empresa declarada, pré-preenchimento da manifestação, conversa investidor/apoio, consulta de versão histórica e marcação de notificação como lida.
|
||||
11. Recusa 419 de pedido cross-site com sessão mas sem token. O Laravel 13 aceita pedidos same-origin pelo cabeçalho de origem validado; esse comportamento foi conferido no middleware instalado, não confundido com desactivação da protecção.
|
||||
|
||||
Não foram detectados campos visíveis sem rótulo, transbordo horizontal ou erros JavaScript nesses ecrãs. A primeira tentativa usou uma porta ocupada por outro servidor PHP sem driver PostgreSQL; o teste foi repetido com servidor dedicado na porta 18027. A fixture de QA foi corrigida para marcar explicitamente o email verificado, sem alterar utilizadores operacionais.
|
||||
|
||||
O upload foi exercitado pela API a partir da sessão real do navegador; o selector nativo de ficheiros não foi automatizado. As verificações de autorizações complementam os testes HTTP, que cobrem adulteração de checksum, opções de grupo errado, ausência de consentimento, retirada de publicação, conflito de versão, relações territoriais cumulativas, CSV e isolamento.
|
||||
|
||||
## Repetição automatizada
|
||||
|
||||
Com uma base descartável terminada em `_test`, PostgreSQL/PostGIS e variáveis `DB_*` explícitas:
|
||||
|
||||
```sh
|
||||
php vendor/bin/phpunit --filter 'InvestmentUnification|InvestmentPortfolio|PublicPortalNavigation' --do-not-cache-result
|
||||
php vendor/bin/phpunit --filter InvestmentWorkspace --do-not-cache-result
|
||||
php vendor/bin/phpunit --do-not-cache-result
|
||||
php vendor/bin/phpstan analyse --no-progress --memory-limit=512M
|
||||
npm run types:check
|
||||
npm run build
|
||||
```
|
||||
|
||||
`RefreshDatabase` recria tabelas no ambiente de teste. Não executar esses comandos de teste contra a base operacional. Em PowerShell com restrições a scripts, usar `npm.cmd`.
|
||||
|
||||
## Limites
|
||||
|
||||
Os ensaios não demonstram WCAG 2.2 AA integral, experiência com leitor de ecrã, carga concorrente, desempenho de produção, entrega de notificações ou SuiteCRM externo, nem integridade da base remota ainda inacessível. O mapa foi validado com pontos sintéticos nos testes PostGIS e estado vazio quando não há coordenadas públicas. Não foi desenhada cartografia fictícia para preencher a interface.
|
||||
|
||||
A aprovação de requisitos pelo proprietário foi respeitada. Homologação com participantes, formação, deploy remoto e monitorização no destino continuam por executar; não são etapas que se possam declarar aprovadas apenas com esta evidência local.
|
||||
Reference in New Issue
Block a user