54 KiB
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.
InvestorProjectContextagrega dossier, jornada, referências, pendências e links autorizados. Não cria novo cadastro de projeto.desk_cases.project_idpermanece nullable para ideia; projeto estruturado usaprojectsquando 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.- Reutilizar
QuestionnaireVersion/questionnaire_versions.schema_snapshotpara uma definição versionada com código reservadoinvestor-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. - Usar
investor_journeyspara a instância: novo percurso privado pode não ter ficha editorial; associá-lo pordesk_cases.journey_idexistente. Usarjourney_stepspara 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.workflowhistórico E0–E11 permanece preservado, como percurso documental ligado, sem segunda cópia atualizável das mesmas decisões. taskscontinua 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 usamdesk_events/audit_events, com etapa, definição, motivo, anterior/novo, documentos e correlação.- Propor vínculo nullable a
land_assistance_casesemdesk_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.