74 lines
11 KiB
Markdown
74 lines
11 KiB
Markdown
# 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.
|