11 KiB
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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
- 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.
- 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.