Files
Investidor-V2/docs/investmoz/unification/traceability-and-manual.md
T
nala 250ac35fd1
tests / ci (push) Canceled after 0s
first commit
2026-09-28 10:01:09 +02:00

11 KiB
Raw Blame History

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.