Files
Investidor-V2/docs/investmoz/v2/auditoria-portal/proposta-consolidacao-percurso.md
T
nala 6ddafc95ba
tests / ci (push) Canceled after 0s
oportunidades 4
2026-10-10 07:03:59 +02:00

54 KiB
Raw Blame History

Proposta de consolidação do InvestMoz em torno do percurso do investidor

Estado de execução aprovado em QA: I1–I3 autorizados pela mensagem posterior do responsável. Implementação/evidência e limites em execucao-percurso-i1-i3.md. Texto abaixo preserva a proposta e as condições originais; não autoriza ativação ativa.

09/10/2026. Proposta para aprovação, ligada à matriz existente. Não altera navegação, modelo ou motor do percurso. A correção pontual C24 do encaminhamento para um simulador existente fica separada desta proposta. Nenhuma escrita na base ativa; nenhuma funcionalidade eliminada; nenhuma nova jornada educativa.

Recomendação e âmbito

Aprovar com condições a consolidação incremental. Usar o dossier de trabalho existente como contexto privado do investidor, reutilizar as entidades e ferramentas e criar uma apresentação única das 19 etapas. Preservar o projeto estruturado, a ficha publicada, o pedido e a decisão como recursos distintos, ligados por identificadores. A primeira entrega estrutural, depois de aprovada, deve permitir demonstrar os cenários A e B completos na interface QA antes de qualquer ativação.

O investidor começa por uma ideia, conhece a posição no percurso, guarda sem preencher tudo e escolhe uma ação que pode executar agora. A preparação pode ocorrer em paralelo. A consulta de ferramentas e a preparação de documentos continuam disponíveis mesmo quando uma submissão, decisão ou execução depende de informação ainda ausente. O portal não garante viabilidade, licenças, financiamento, incentivos ou sucesso do negócio.

Fonte integral e divergências preservadas

Foi lido integralmente o exemplar O InvestMoz deve funcionar como um assistente de investimento orientado por etapas e regras de aplicabilidade.docx, no acervo Servicos Tempo/Relatorios: SHA256 aa13c53138ec15cd808de43d9dc2fc6808da86943d09d3352c9dd0944bdae364, 1.327.814 bytes, 459 parágrafos com texto em word/document.xml, sem notas/comentários ou alterações controladas identificadas, mais o fluxograma original word/media/image1.png, inspecionado. A numeração de parágrafos abaixo identifica o XML extraído, não páginas presumidas. Extração completa em assistant-source-full.json, privada.

O texto da secção 2.1, parágrafos 22–40, define 19 etapas, incluindo decisões. O fluxograma embebido numera 17 blocos, agrupa terra em três blocos e deixa decisões em losangos sem número. A imagem inclui operação no bloco de licenciamento; o texto determina que a licença de operação aguarde inspeções/testes. Esta proposta segue o texto para dependências e preserva a correspondência com a imagem. Os códigos S01–S19 são identificadores de rastreabilidade propostos, não uma renumeração dos valores gravados.

Há outros roteiros em uso: config/virtual-desk.php contém E0–E11 de constituição/preparação; InvestorGuidanceRules contém sete grupos de orientação; investment-roadmap-source.ts transcreve outro DOCX, com cinco fases e 14 atividades. Não equivalem às 19 etapas nem são fontes legais por si mesmos. Manter versão, significado, exemplares e histórico; introduzir adaptadores explícitos. A aceitação já dada às fontes oficiais mantém-se. Conferir âmbito, período e regra aplicável é aplicação da fonte, não recertificação.

O documento exige aprovação antes de implementar na secção 16, parágrafo 326, e aprovação explícita após diagnóstico na secção 19.1, parágrafo 497. O pedido atual autoriza apresentar o desenho e continuar as correções já autorizadas. Não autoriza executar este desenho estrutural antes da aprovação.

Arquitetura efetivamente encontrada

Leitura complementar ativa em transação PostgreSQL REPEATABLE READ READ ONLY, sem conteúdos pessoais exportados, regista schema, constraints, índices e volumes em investor-consolidation-runtime.json. Continua o inventário anterior; não é outro diagnóstico do zero.

Tema Encontrado e evidência Consequência para a proposta
Aplicação Laravel 13.30.1, PHP CLI 8.5.11; React 19.2.8, TypeScript 5.9.3, Inertia React 3.7.0, Leaflet 1.9.4; Node 24.20.0, npm 11.19.0, Composer 2.8.12 Evoluir a aplicação existente; versões de CLI/lock não certificam o processo web ativo
Base ativa PostgreSQL 17.11, PostGIS 3.6.2, investemoz:5432; 288 tabelas na auditoria anterior MySQL é descrição histórica do documento; nenhuma migração MySQL→PostgreSQL é necessária por pressuposto
Contextos 16 projects, 29 investment_dossiers, 1 investor_journeys, 1 desk_cases, 3 investment_submissions Dossier de preparação, ficha editorial, projeto e manifestação não são sinónimos; conservar IDs
Balcão 3 versões de serviço publicadas; 0 pedidos, documentos ligados e tarefas no ativo; código tem criação, rascunho, submissão, devolução, parecer e apreciação interna Não confundir capacidades testadas em QA com pedidos reais ativos ou decisão institucional
Simuladores 22 drafts, 16 simulações/resultados; snapshots cifrados, versionamento, ETag/If-Match, histórico e vínculo explícito a negócio Reutilizar; associação a dossier não partilha automaticamente um draft privado com gestor/representante
Acompanhamento tasks, leads, contacts, consents, desk_events, audit_events, aftercare existentes; 0 leads/tarefas/aftercare ativos Acompanhamento interno funciona sem CRM externo; não preencher cadastros vazios artificialmente
Integrações suitecrm.enabled=false, notificações externas desativadas; filas, cache e sessões configurados em database; AI habilitada não prova modelo externo operacional Não depender de SuiteCRM, IA, correio, SMS ou endpoints institucionais para guardar/acompanhar internamente
Acesso Fortify/sessão, conta verificada, gate manage-portal, memberships e analista atribuído ao pedido Não afirmar que os 11 perfis conceptuais, OAuth/OIDC/PKCE ou contas de entidades externas já estão implementados
Licenças e terra Assistência fundiária existente; mne.licences e mne.land_rights são estruturas de ativos sem dados na leitura anterior, com consumidores próprios Não reutilizar um registo de ativo negociável como licença do projeto sem contrato; sem módulo completo de licenciamento demonstrado
Território 1.990 registos ativos, incluindo 1.920 administrativos públicos; 0 geometrias ativas. QA conserva 361 limites internos de 2019 Separar cadastro, geometria disponível, acesso autorizado, perímetro do projeto e mapa funcional

O adaptador de negócios atual devolve ExistingBusiness por CompatibleBusinessRepository→LegacyBusinessRepository; schema mne preparado não significa transferência de escrita. A API v1 usa contratos e middleware diferentes por domínio. Sessão web, MFA quando exigida e autenticação de integrações devem conservar os contratos em vigor; não substituir tudo por OAuth nem anunciar webhooks como ativos.

Mapa de navegação proposto

flowchart TD
  Publico[Explorar InvestMoz] --> Ferramentas[Oportunidades · mapas · parceiros · biblioteca · simuladores]
  Publico --> Entrada[Preparar o meu investimento]
  Entrada --> Conta[Entrar ou guardar preparação anónima sem dados pessoais]
  Conta --> Painel[Meus investimentos · projeto atual]
  Painel --> Contexto[Dossier de trabalho e percurso]
  Contexto --> Fases[Ideia · dossier · licenças e terra · recursos · execução]
  Contexto --> Pendencias[Pendências · documentos · resultados · próxima ação]
  Contexto --> Ferramentas
  Ferramentas --> Retorno[Guardar ou associar resultado ao contexto autorizado]
  Retorno --> Contexto
  Contexto --> Balcao[Preparar apoio · rever · submeter separadamente]
  Balcao --> Seguimento[Mensagens · tarefas · protocolo · acompanhamento interno]
  Seguimento --> Contexto
  Gestao[Área da gestão] --> Fila[Pedidos e tarefas atribuídos]
  Gestao --> Cadastros[Oportunidades · estruturas · território · biblioteca · parceiros]
  Gestao --> Governo[Revisões · fontes · regras versionadas · auditoria · ativação]
  Fila --> Analise[Analisar · pedir correção · parecer interno · registo assistido externo]
  Analise --> Seguimento

Investidor: Meus investimentos, Percurso, Documentos e resultados, Apoio e acompanhamento, Ferramentas. Projeto atual sempre identificado; lista de dossiers permite alternar sem substituir os dados de outro. Dentro do contexto: resumo, fases e S01–S19, pendências com motivo, documentos/validades, resultados/versões, licenças/terra/financiamento, mensagens, cronograma, riscos e próxima ação com alternativas executáveis. Em móvel conserva a mesma informação em cartões e foco acessível após ação.

Gestão: Fila de trabalho, Investidores e dossiers, Cadastros e conteúdos, Regras e referências, Auditoria e operação. As funções administrativas não entram na sequência de etapas do investidor. Estado administrativo ou publicação editorial não aumenta a maturidade do investimento. Auditoria e consultas só apresentam dados dentro do âmbito autorizado.

Evoluir /dashboard, /investidor e /balcao-virtual/painel por composição, depois da aprovação. Manter cada URL acessível e compatível; preservar /carteira, /oportunidades, /negocios, /terra-duat, /parcerias, /simulador-fiscal, /documentos, /legislacao, manifestações e rotas da gestão. Não transformar links diretos em redirecionamentos que criem um dossier ou efetuem submissão. Utilizador com perfil de gestão escolhe explicitamente a área; não muda implicitamente de papel.

Cinco fases com as 19 etapas rastreáveis

O mapa abaixo é de capacidades, ligado à matriz única por ID; não cria outra matriz de requisitos. Todas as 19 etapas continuam sem demonstração integrada da interface desta proposta. “Reutilizar” não significa etapa concluída. Preparação indicada pode avançar sem os pré-requisitos do ato final.

Fase / etapa textual Fonte XML / imagem Reutilizar ou melhorar Aplicabilidade, dependência do ato e resultado esperado IDs da matriz
1. Ideia e análise — S01 Sistematizar ideia P22 / bloco 1 Draft do simulador, dossier Balcão, perfil, planejamento Sempre; título/objetivo mínimos para guardar, proposta/promotores/localização preliminar quando conhecidos AUD-DESK-01/02, AUD-SIM-01, AUD-GUIDE-01
S02 Análise preliminar P23 / bloco 2 Plano empresarial, riscos, cenários financeiros, biblioteca Sempre; evidências e pressupostos separados, valores ausentes indeterminados AUD-SIM-02, AUD-LIB-01, AUD-GUIDE-01
S03 Decidir viabilidade P24 / losango ideia viável Readiness e orientação explicável Decisão do promotor com fundamentos; prosseguir/reformular/arquivar. Sem score automático, aprovação pública ou bloqueio da preparação AUD-GUIDE-01, AUD-DASH-01
S04 Estruturar investimento P25 / bloco 3 Plano, equipa, marcos e snapshots Sempre; consolidar estratégia, finanças, calendário e forma jurídica, sem reintroduzir dados conhecidos AUD-DESK-02, AUD-SIM-01/02
2. Entidade e dossier — S05 Constituir/registar entidade P26 / bloco 4 Declarações empresariais e Balcão E1–E9 Conforme entidade/tipo de investimento; registo/NUIT são atos externos, dados declarados não os provam; entidade existente reutilizada AUD-DESK-01/02, AUD-LIB-01
S06 Preparar processo P27 / bloco 5 desk_cases, documentos e revisões, investment submission Preparação paralela à constituição; atos de envio exigem somente os campos/documentos do serviço aplicável AUD-DESK-01/02, AUD-LIB-01/02
S07 Submeter projeto/autorização/incentivo P28 / bloco 6 Serviço project-preparation, protocolo, recibo, revisão Apenas quando aplicável e após revisão/consentimento; pedido interno não equivale a envio ou aprovação APIEX/incentivo AUD-DESK-01, AUD-GUIDE-01
3. Licenças e terra — S08 Licenciamento prévio/integrado P29 / bloco 7 Etapas documentais Balcão, fontes, documentos e validade Regras por atividade/localização; preparar em paralelo; cada submissão depende do seu contrato. Operação fica em S17 AUD-DESK-01/02, AUD-LIB-01, AUD-GUIDE-01
S09 Decidir necessidade de terra P30 / losango terra Perguntas de localização e assistência fundiária Sim/não/por determinar com fundamento e histórico. Não depende de licença já aprovada para responder AUD-LAND-01, AUD-GEO-02, AUD-GUIDE-01
S10 Regularizar terra P31 / blocos 8–10 LandAssistance, seletores, mapas, anexos Só se S09=sim; área, compatibilidade, consulta/levantamento/título/registo conforme regra oficial. Geometria não é DUAT nem prova de disponibilidade AUD-LAND-01, AUD-GEO-01/02/03, AUD-LIB-01
S11 Confirmar regularização P32 / losango licenças e terra Evidência e revisão documental separadas Verificar requisitos efetivamente aplicáveis; devolver pendências a S08/S10. Ato condiciona execução, não bloqueia S02/S04 ou preparação financeira AUD-DESK-01/02, AUD-GUIDE-01
4. Recursos e financiamento — S12 Decidir/estruturar financiamento P33 / bloco 11 e condição do texto Fontes de fundos, plano, simulador, parceiros Sim/não/por determinar. Sem financiamento externo: guardar fonte/capital próprio; não afirmar disponibilidade sem evidência AUD-SIM-01/02, AUD-PART-01, AUD-GUIDE-01
S13 Due diligence/negociação financeira P34 / bloco 12 Sala de parceria, documentos, tarefas, cenários Ramo de financiamento externo; preparação paralela a terra. Não dispensa outras diligências aplicáveis fora desse ramo AUD-PART-01, AUD-LIB-01, AUD-GUIDE-01
S14 Decidir financiamento P35 / losango aprovado Marcos/parcerias e registo assistido Resultado do financiador, com referência/documento/data; recusa regressa à estrutura sem apagar propostas anteriores AUD-PART-01, AUD-DESK-02
S15 Fecho/desembolso P36 / bloco 13 Marcos, documentos e obrigações declaradas Se financiamento externo; aprovação não comprova contrato, condições cumpridas ou desembolso AUD-PART-01, AUD-GUIDE-01
5. Execução e operação — S16 Implementar P37 / bloco 14 ProjectPlanning, tarefas, marcos, aftercare Planejar sempre; executar apenas requisitos prévios aplicáveis cumpridos, com motivo específico e evidência AUD-GUIDE-01, AUD-CRM-01, AUD-DASH-01
S17 Inspeções/testes/licença de operação P38 / bloco 15 Documentos, resultados e tarefas Conforme atividade; inspeção e emissão são externas, checklist concluída não é licença AUD-DESK-02, AUD-LIB-01, AUD-GUIDE-01
S18 Iniciar operação P39 / bloco 16 Marcos de execução e acompanhamento Cumprir exigências aplicáveis de S17 e anteriores; guardar data/decisão declarada/evidências, sem assumir legalidade por clique AUD-GUIDE-01, AUD-CRM-01
S19 Monitoria contínua P40 / bloco 17 Aftercare, tarefas, validade documental, audit_events Operação ativa; conformidade, renovações, indicadores e medidas corretivas. É recorrente, não fica definitivamente concluída por preencher AUD-CRM-01, AUD-DASH-01, AUD-LIB-01

Relações e fontes mestres

flowchart LR
  U[Conta users] --> I[Identidade investors e investor_accounts]
  I --> D[Dossier de trabalho desk_cases]
  D --> J[Percurso investor_journeys e journey_steps]
  D --> P[projects quando já existir projeto estruturado]
  P --> F[investment_dossiers ficha editorial]
  D --> S[simulation_form_drafts e resultados existentes]
  D --> R[desk_requests e service_versions]
  D --> L[land_assistance_cases]
  D --> Docs[documents e ligações autorizadas]
  R --> T[tasks e desk_events]
  R --> Ext[Registo assistido de decisão externa]
  D --> Ref[Oportunidades · parceiros · biblioteca · território]
  IR[interest_requests e consents] --> CRM[leads · contacts · tasks internos]
  D --> IR

As setas mostram vínculos existentes ou propostos; não todas FKs já instaladas. Referências físicas confirmadas estão em investor-consolidation-runtime.json. A ligação dossier→terra e o retorno completo de resultados ainda são lacunas a implementar após aprovação. Um lead deve ser criado apenas para captação/acompanhamento que o exija; uma tarefa interna do dossier não depende dessa conversão.

Dado mestre Fonte a reutilizar Reutilização e conflito
Conta/identidade users; investors; investor_accounts; contacts Separar autenticação, investidor e contacto. Reutilizar associação por ID; email coincidente não autoriza fusão
Dados pessoais/declarados investment_accounts.payload cifrado Prefill consentido; identificar fonte/versão. Alteração no pedido é snapshot da declaração, não atualização silenciosa do perfil
Empresa/mandato organizations/memberships; investment_company_declarations; ExistingBusiness quando pertinente Representação efetiva e direitos verificados; declaração não é registo comercial. Não trocar automaticamente adaptador por tabelas mne
Ideia/projeto de trabalho desk_cases.id, title, payload; project_id nullable Começar aqui sem obrigar oportunidade publicada, empresa constituída ou projeto de carteira. Reutilizar projects quando já houver vínculo; eventual criação explícita usa a mesma tabela e autorização
Percurso investor_journeys e journey_steps Agregar etapas existentes em versão explícita; não criar investment_projects ou project_stage_instances paralelos
Dados financeiros Draft e snapshots versionados; simulation_results quando execução de servidor existir Fórmulas financeiras atuais reutilizadas. Snapshot financeiro guarda entradas, não necessariamente resultado imutável: distinguir recuperação/recalculo de resultado guardado
Pedidos desk_requests + service_version_id; investment_submissions/interest_requests mantidos Campos mestre mapeados com origem/versão e edição consciente. Pedido submetido permanece snapshot, nunca sincronização retroativa
Documentos documents, desk_documents, project_documents e vínculos específicos existentes Um original, checksum/versão, múltiplos vínculos quando autorizados; mesma obrigação pode apontar ao mesmo documento. Dedup de bytes não concede novos direitos de acesso
Território geo_locations; geo_geometries; relações existentes País do requerente, origem da solicitação e território do investimento são independentes; manter ISO e árvore territorial sem inferências
Biblioteca/regras portal_resources, investment_legal_sources e acervo oficial identificado Consulta, situação jurídica/documental e uso em cálculo independentes; ligação a uma etapa nunca condiciona consulta autorizada
Acompanhamento/consentimento tasks, desk_events, audit_events, consents Tarefa, parecer interno, decisão externa e concessão de contacto separados; evitar duplicar transições entre módulos

Em cada reutilização, apresentar origem, versão, data e opção de revisão. Copiar só os campos necessários e autorizados; não transportar dados pessoais em URLs. Resolver conflito entre declaração atual e versão submetida sem reescrever a versão anterior. Projeto atual é seleção recuperável e autorizada; sessionStorage pode acelerar a interface, mas não pode ser a única forma de recuperar o contexto noutra sessão.

Consolidações e duplicações a resolver

Situação atual Consolidação proposta Compatibilidade
/dashboard devolve summary=null ao investidor; /investidor lista jornadas de carteira; Balcão agrega dossiers/pedidos Um painel do investidor composto sobre fontes existentes, sem mover gestão para esse painel URLs existentes permanecem; ativação de apresentação por configuração, sem criar recursos no GET
E0–E11, sete grupos de orientação e roteiro de 14 atividades Uma definição versionada das 19 etapas, com adaptadores e correspondências explícitas Não converter códigos/estados antigos por posição; não aplicar regras novas retroativamente
Título/objetivo/orçamento/país/localização em draft, dossier, manifestação e pedido Dicionário de campos e read model de contexto; prefill com seleção consciente e versão Snapshots transacionais permanecem; nenhuma dupla escrita automática
createRequest preenche título/descrição limitada mas não orçamento completo do simulador Prefill de campos compatíveis e unidades/moeda explícitas, sem repetir preenchimento Atualizar preparação de novo pedido; submissões anteriores imutáveis
SimulationFormDrafts::create admite um draft corrente por conta; recuperação tem caminho por ID Primeiro preservar associação por ID; depois adaptar criação/seleção por contexto e idempotência Não remover proteção de sobrescrita nem isolamento anónimo; não prometer vários projetos só porque o índice permite linhas
Estados pedido, etapa Balcão, journey_steps, prontidão e decisão externa diferentes Dimensões separadas e projeção de apresentação coerente accepted continua aceitação interna; não vira aprovação APIEX/bancária/licença
Cartografia cadastrada/importada não prova uso em cada mapa Contexto territorial compartilhado, acessos por consumidor, legendas e ausência explícita Limite administrativo não vira localização de investimento/DUAT/zona; preservar classificação
Leads/contactos e contas de investidor Serviços existentes de identidade e conversão consentida Sem CRM externo obrigatório ou fusões por email; tratar ambiguidades antes de converter

Estados, aplicabilidade e permissões

Cada etapa tem quatro dimensões: aplicabilidade (aplicável, dispensada com fundamento, por determinar), preparação (vazio/incompleto/verificado internamente/pronto), tramitação (não enviado/enviado/em análise/devolvido/aguarda externo/encerrado) e decisão externa (não requerida/não conhecida/ato registado favorável/desfavorável/expirado). A apresentação usa os 12 estados pedidos, com âmbito visível. Bloqueio é atributo da ação com dependência e motivo, não encerramento de toda a fase.

Estado apresentado Origem possível atual Quem e condição para mudar O que não significa
Não iniciada Balcão not_started; journey pending Sistema em nova versão; sem apagar etapas existentes Falta de aplicabilidade já determinada
Em preparação preparing; draft; tarefa open/in_progress Dono/representante autorizado pode guardar incompleto Submissão ou aprovação
Pronta para submissão ready e validação do contrato do serviço Regra determinística com versão e faltas visíveis Envio automático ou elegibilidade
Submetida desk submitted; submission próprio Dono/representante confirma serviço, conteúdo, consentimento e destino Envio para órgão externo sem referência real
Em análise reviewing; analista atribuído Analista/gestor no âmbito do pedido Aprovação institucional
Requer correção returned; pending Analista indica motivo/campos permitidos; dono corrige em nova versão Perda de documentos ou reescrita da submissão
A aguardar entidade externa referred/waiting com referência/canal Registo assistido por autorizado, com data e próxima revisão Integração ativa ou resposta recebida
Aprovada Novo registo de ato externo fundamentado Autoridade identificada; captura assistida/conferência por pessoa competente distinta quando exigido accepted/opinion interno ou decisão automática do portal
Rejeitada Rejeição interna ou ato externo, rotulados separadamente Responsável autorizado, motivo e evidência; opção de reformular Apagar a proposta/reutilização proibida para sempre
Dispensada not_applicable, decisão condicional do promotor e/ou regra aplicável Negativa declarada ativa adaptação de preparação; dispensa legal exige fundamento e revisão no seu âmbito Regra jurídica criada pelo investidor ou null interpretado como não
Concluída completed documental ou tarefa done, âmbito indicado Critérios/evidências do marco e independência de revisão quando exigida Aprovação externa; S19 definitivamente terminado
Expirada expired e validade documental Data válida explícita; reabrir dependentes afetados e conservar histórico Documento oficial sem rastreabilidade rejeitado como falso

S03, S09 e S12 têm decisão do investidor auditada. S14 não aceita resposta do investidor como aprovação do banco sem evidência e âmbito. Uma resposta “por determinar” mantém visíveis as opções de preparação e a pergunta exata. S10 pode ser dispensada por ausência declarada de necessidade de terra; isso não resolve uma exigência de uso de espaço que se venha a verificar. No ramo sem financiamento externo, S13–S15 financeiros são dispensados com motivo e fonte própria em S12; as demais diligências continuam quando aplicáveis.

Dependências serão por ação, com prepare, submit, execute, operate distintos. Exemplos: orçamento e pesquisa de parceiros não dependem de DUAT aprovado; preparar dossier não exige todas as licenças; emitir/iniciar operação depende das inspeções e condições aplicáveis; importar documento não ativa regra fiscal. A interface mostra dependência, estado e evidência em falta e oferece ações independentes. Reabrir uma evidência invalida apenas conclusões dependentes, mantendo versões e tarefas já realizadas.

Próxima ação: primeiro correção solicitada ou obrigação aplicável com prazo, depois tarefa executável necessária; havendo bloqueio, apresentar o motivo e uma preparação independente. Nunca recomendar ato indisponível por autorização ou integração. Mostrar contagem de tarefas/marcos aplicáveis concluídos; se houver percentagem, informar denominador e itens indeterminados, nunca “probabilidade de sucesso”, aprovação ou progresso jurídico inferido.

Perfil Reutilização atual / ação permitida Limite da primeira demonstração
Visitante Ferramentas públicas e preparação anónima limitada Sem dados pessoais, pedidos privados ou decisões institucionais
Investidor Dono do dossier/draft, prepara, associa resultados, confirma pedido Não se autoaprova internamente nem lê dossier de terceiro
Representante Membership ativa e papel admin/manager/officer para escrita Acesso ao dossier não concede acesso automático ao draft pessoal de outro membro
Atendimento/analista Atribuição ao pedido; consulta e acompanhamento dentro do âmbito Não consultar todos os documentos/pedidos da organização por associação indireta
Supervisor/gestor manage-portal, revisões/atribuição/administração existentes Separar editor/revisor; não apresentar gate amplo como RBAC completo de todos os perfis
Entidades externas/financiador/inspetor Registo assistido interno, com autoridade/canal/evidência Sem login ou integração externa inventados; concessão futura exige âmbito e autenticação aprovados
Administrador de regras Publicação de versão com revisão e auditoria propostas Não alterar a versão de percursos em curso silenciosamente
Auditor Projeção de leitura restrita proposta Não existe ainda papel granular demonstrado; implementar permissão específica, sem editar decisões

Modelo e contratos incrementais propostos

Primeiro read model: composição de VirtualDesk, InvestorGuidance, InvestmentWorkspace, simuladores, documentos e tarefas, respeitando em cada leitura a policy de origem. Os nomes de novos serviços abaixo são propostos, não capacidades instaladas.

  1. InvestorProjectContext agrega dossier, jornada, referências, pendências e links autorizados. Não cria novo cadastro de projeto. desk_cases.project_id permanece nullable para ideia; projeto estruturado usa projects quando houver vínculo explícito, nunca uma cópia pública automática. Campos mestres são lidos ou materializados em snapshot do pedido por confirmação; sem sincronização bidirecional.
  2. Reutilizar QuestionnaireVersion/questionnaire_versions.schema_snapshot para uma definição versionada com código reservado investor-path-19, locale, steps, applicability e dependências por ação. Acrescentar validação específica e aprovação/auditoria de publicação; não usar esse código como regra fiscal ou ficheiro pessoal. Versão de definição presa ao percurso por FK. A API pública de questionários só pode expor configuração não sensível; administração e rascunhos ficam protegidos. Não criar novas tabelas de etapas/requisitos por analogia com a lista conceptual do DOCX.
  3. Usar investor_journeys para a instância: novo percurso privado pode não ter ficha editorial; associá-lo por desk_cases.journey_id existente. Usar journey_steps para S01–S19 com versão e dados de aplicabilidade/estado detalhado. Estados legacy pending/active/completed/blocked mantêm tradução explícita por versão; não converter dados antigos em massa. desk_cases.workflow histórico E0–E11 permanece preservado, como percurso documental ligado, sem segunda cópia atualizável das mesmas decisões.
  4. tasks continua a fonte de tarefas de orientação/CRM. Propor vínculo nullable à etapa e chaves de idempotência por tarefa; conservar lead_id, desk_case_id, aceitação, classificação e regras atuais. Eventos usam desk_events/audit_events, com etapa, definição, motivo, anterior/novo, documentos e correlação.
  5. Propor vínculo nullable a land_assistance_cases em desk_cases, e vínculos/resultados por IDs existentes no contexto. Conferir owner/representação/versão na associação. Acrescentar FKs/indexes apenas depois de análise de órfãos/conflitos; sem converter estruturas mne nem criar financing_requests paralelo à sala de parceiros e documentos existentes.

Migrations potencialmente necessárias: FK de versão da definição em investor_journeys; campos detalhados de aplicabilidade/evidência em journey_steps, unicidade por jornada/código para novas instâncias; vínculo de terra no dossier; vínculo de etapa em tasks. A criação de múltiplos drafts autenticados por contexto exige ajustar o serviço e contratos idempotentes, não simplesmente um índice. Antes de qualquer migration, produzir preview de contagens, nulabilidade, órfãos, referências repetidas e consumidores; não aplicar por esta análise.

Contratos atuais mantidos: criação/GET do Balcão, PUT do pedido e POST de estado; drafts /api/v1/simulation-drafts/{id} com ETag/If-Match; simulações/resultados/report; APIs v1 de interesse e referências; tarefas de orientação. Endpoints novos candidatos, ainda inexistentes: GET /api/v1/investment/contexts/{caseId}/journey, POST de decisão condicional e POST de associação de resultado no mesmo contexto. Pedido deve incluir versão esperada/chave idempotente; resposta contém motivo, âmbito, source IDs/versões, ações executáveis e dependências. Não substituir endpoints atuais ou remover os erros/autorizações já testados.

Viabilidade: consultar e comparar cenários com hipóteses identificadas, lacunas e limites; decisão de prosseguir é do promotor. O resultado financeiro local é recalculado pelas funções existentes a partir do snapshot guardado; resultado imutável só é afirmado quando tiver ID, entradas/hash e versão de motor persistidos. Se a análise fiscal estiver indeterminada, recuperar e apresentar essa indeterminação. Não inventar parâmetros legais para tornar a demonstração positiva.

As condições da definição serão declarativas, com campos e operadores permitidos, sem execução de código introduzido na administração. Publicação valida códigos únicos, referências de dependência, ausência de ciclos, versões de fontes e permissões por ação. Uma condição indeterminada devolve a pergunta/dado em falta; não assume false nem fixa taxa/prazo legal. Mudança de versão requer comparação das etapas/decisões afetadas e opção explícita de manter o percurso anterior; não há migração automática de instâncias.

Primeira demonstração integrada em QA

Estado: cenários de aceitação preparados; não executados como percursos integrados novos. As provas anteriores de APIs/componentes são reutilizadas como pré-condições, não como aprovação da consolidação. Escritas somente em base loopback *_test:55441, com guarda de identidade e execução sequencial. A cópia cartográfica e a cópia de compatibilidade de recursos são bases distintas; não misturar fixtures ou anunciar 361 geometrias na base que não as contém.

Dados de ensaio identificados como sintéticos: A = prestação remota de serviços, sem nova terra/financiamento externo; B = pequena unidade produtiva, com necessidade de terra e capital externo. Em ambos, situação jurídica aplicável permanece por determinar até evidência, sem dispensa legal inventada.

Passo de aceitação A B Prova exigida
Criar e guardar Criar ideia/dossier e reutilizar identidade Idem, dossier distinto UI, POST/201, ID/version/evento; duplo envio cria um; nenhuma submissão implícita
Recuperar noutra sessão Sair/entrar e selecionar A Sair/entrar e selecionar B; alternar para A GET/persistência/hash; sem depender só de storage local; terceiro 403/404
Adaptar percurso Terra=não, financiamento externo=não; motivo e fonte própria Terra=sim e externo=sim; perguntas/documentos/ações apropriados Decisões auditadas por versão, S10 e S13–S15 dispensados no ramo A; B mantém etapas abertas; unknown não é não
Usar ferramenta Ponto de equilíbrio: custos fixos 1.000, preço 100, variável 50 → 20 unidades Necessidade total 100.000, capital confirmado declarado 30.000 → diferença 70.000, sem promessa de financiamento Link com contexto autorizado; entradas/unidade/período/moeda visíveis; cálculo financeiro existente, sem taxa fiscal inventada
Devolver/recuperar resultado Guardar snapshot e voltar ao dossier A; outra sessão recupera entradas e recalcula 20 Idem B, recupera diferença 70.000; reabrir A não apresenta B Dossier/draft IDs, versão/hash/motor e resultado exibido; distinguir recalculado de resultado imutável persistido
Preparar Balcão Reutilizar título/objetivo/moeda/valor; criar rascunho project-preparation Idem B com necessidades próprias Prefill com origem/versão, edição, gravação/GET; snapshot distinto, sem duplicar investidor
Acompanhar internamente Aceitar tarefa concreta de preparação e registá-la no dossier Tarefa de terra aguarda documento; tarefa de orçamento avança Task ID/status/assignee/evento recuperados; CRM externo e notificações desativados durante o ensaio
Preparação paralela Fonte de mercado em falta; plano de equipa avança Consulta/levantamento de terra em falta; orçamento/parceiros avança Interface mostra motivo e ação independente, gravação e recuperação, sem fechar o impedimento artificialmente
Revisão/negativos Inválido 422, versão antiga 409, perfil sem direito negado Idem; voltar sim→unknown não apaga documentos, invalida só dependentes Dados/version/hash conservados; erros visíveis com foco e ação de recuperação

Para observar análise/atribuição do gestor, o ensaio QA pode rever o rascunho e submeter explicitamente um pedido sintético interno, capturando o conteúdo, protocolo e versão; nunca auto-submeter por usar ferramenta. Gestor distinto atribui tarefa/pede correção; investidor recupera a mensagem e corrige somente campos permitidos. O resultado permanece interno; nenhuma chamada ou aprovação de entidade real. O apoio pode ser preparado sem anexos, enquanto scan/derivadas são testados separadamente nas operações afetadas.

Cartografia em B: selecionar e recuperar cada nível; mostrar cadastro, geometria autorizada ou ausência e fonte/edição. Se forem usados limites reais em mapa do investidor, a sua disponibilização deve ser explicitamente configurada só na QA, com classificação/escopo registados; importar limites privados não os torna automaticamente públicos. Nenhum polígono é tomado por título de terra.

Capturar interface em computador, tablet e telemóvel (1440, 768 e 390 px), teclado/foco, erros, screenshots, respostas HTTP e persistência consultada. Relacionar cada screenshot ao dossier/etapa/versão, sem expor dados pessoais. Sem browser disponível, deixar “UI pendente” e executar só API/persistência. Go exige A e B completos e repetíveis; testes unitários ou links de documentos não substituem essa prova.

Plano incremental e reversão

Lote Componentes afetados Critério de aceitação Compatibilidade e reversão
I0 — já autorizado Falhas existentes, CountryCatalogue/CountrySelect, VirtualDesk, seleção territorial/mapas; C24 InvestorGuidance Guardar/recuperar/filtros por formulário e perfil; contexto correto; geometrias por consumidor; UI pendente identificada Sem navegação/modelo novo; reverter código pontual conservando payloads e provas
I1 — após aprovação DashboardController, InvestorWorkspaceController, VirtualDeskController; dashboard, portfolio/workspace, desk/panel, JourneyCompanion Painel mostra contexto, posição, documentos/resultados, pendências e próxima ação; acesso direto e ausência visível Read model composto, sem migração ou criação em GET; opção de apresentação nova para QA; desligar opção restaura apresentação anterior
I2 — dados e retorno VirtualDesk, InvestmentWorkspace, SimulationFormDrafts/Controller, SimulationForm, field mapping Prefill consentido, vínculo por ID, conflito/versionamento, A/B sem contaminação, nova sessão Aditivo; preservar snapshots; retornar aos módulos diretos sem apagar vínculos/resultados; adaptar um draft por contexto antes de multi-projetos
I3 — 19 etapas QuestionnaireVersion, investor_journeys/journey_steps, InvestorGuidanceRules como adaptador, tasks, audit S01–S19 identificáveis; aplicabilidade triestado; dependência por ação; fundamentos e permissões; A/B completos na UI Versões presas às instâncias; migrations só QA, preview/reconciliação; reverter apresentação/motor, nunca down destrutivo após novas decisões
I4 — aprofundar execução Licenças, terra, contratos/parceiros, aftercare, calendário e obrigações Cada ato tem fonte aplicável, evidência, papel competente e decisão externa distinta Primeiro usar documentos/tarefas atuais; novas capacidades apenas quando demonstradamente ausentes; sem integração externa obrigatória
Ativação separada Extensão de recursos, cartografia privada, divulgação por consumidor Backup/restauro fresco, schema/evento/autor/versão/contagens e QA visual; instalação única Não repetir Balcão/Bolsa/gestão básica. Recursos ready=true é preparação. Cartografia ativa depende do mecanismo autenticado ainda pendente; reversão por lote sem apagar uso/histórico

O plano de ativação anterior permanece válido apenas no seu âmbito e prazo, com provas identificadas. Não inclui automaticamente o futuro modelo do percurso. Depois de alterações estruturais, renovar backup/restauro e provas de compatibilidade/rollback antes do ato autenticado. Antes de escrita ativa, reconciliação por IDs, contagens e hashes; o estado anterior das 288 tabelas e ficheiros privados não autoriza apagar novas decisões.

Riscos prioritários: mistura entre projetos por draft corrente; prefill que sobrescreva snapshot; gestor com acesso indevido a módulo privado; regra legal ausente tratada como dispensa; aprovação interna apresentada como externa; duplicação de tarefas/identidade; versão nova reinterpretando E0–E11; publicação involuntária de geometrias/documentos. Cada risco tem ensaio negativo nos lotes I0–I3. ClamD/scan condicionam somente binários/libertação; GD/derivadas e manutenção mantêm critérios próprios.

Workflow de publicação de oportunidades, contratos especializados e campos ainda incompletos continuam no backlog ligado ao objetivo, sem encerramento por esta proposta. Educação continua depois das falhas prioritárias; não se inicia nova jornada educativa.

Evidências e decisão pedida

Mesma matriz: 3.354 requisitos, 3.354 linhas de dados mais cabeçalho, 5.830 linhas de origem preservadas. Este documento complementa fontes e evidências de requisitos existentes; não certifica 3.354 percursos. A contagem de estados continua independente da proposta aprovada. Ligações: relatório executivo, backlog, ativação, casos.

C24: teste de regressão reproduziu o link genérico em vez do draft ligado; correção encaminha plano/simulador/recomendação financeira por ?draft=ID apenas quando a leitura da origem está autorizada. QA de InvestorGuidance: 16 testes, 285 asserções; vínculo/dados recuperados por API, outro draft não substitui o esperado, gestor não ganha acesso. Clique e visual continuam pendentes.

Decisão concreta: aprovar a composição do painel sobre o dossier de trabalho existente, as cinco fases com rastreabilidade S01–S19, fonte mestre com snapshots explícitos, estados por âmbito e preparação paralela; autorizar I1–I3 exclusivamente em QA, com A/B completos na interface como condição de fecho. Não inclui instalação ativa, divulgação automática, RBAC de entidades externas ou nova jornada educativa. Se houver alteração pretendida, identificar o princípio/etapa/lote concreto; manter I0 independente dessa decisão.