Files
Investidor-V2/docs/investmoz/existing-business/verification-evidence.md
T

3.8 KiB

Revisão granular — 29/09/2026

Entrega e diagnóstico

A ficha privada passa a mostrar verificações separadas de identidade, representação, titularidade declarada e documental, recepção e validação documental, avaliação independente, direito fundiário, licença, validade, transmissibilidade e autorização prévia. A ausência anterior deste registo era uma lacuna funcional, não falta de autorização genérica do proprietário do projecto.

Implementação e rastreabilidade

ExistingBusinessVerification aplica a política de revisor designado com MFA, impede auto-revisão, exige estado in_review, versão actual, referência da evidência e fundamentação. Uma conclusão confirmada exige validade. Elementos de outro negócio são recusados. ExistingBusinessController, routes/existing-business.php e business-verifications.tsx disponibilizam o formulário e a leitura na ficha existente.

O endpoint POST /api/v1/existing-business/listings/{id}/verifications tem contrato em openapi.json. A leitura inclui a última conclusão por aspecto/elemento. O histórico completo permanece nas revisões imutáveis; evidência, conclusão e contexto são encriptados. Cada registo incrementa a versão do agregado e identifica a versão dos dados analisados. Alterações aos dados invalidam conservadoramente todas as conclusões anteriores; expiração é calculada em cada leitura. É possível registar conclusão revogada sem apagar a anterior.

Não há migration, importação ou alteração dos dados de negócio locais. Reutiliza-se a tabela de revisões e o seu bloqueio de UPDATE/DELETE. A evolução acrescenta context aos novos snapshots; snapshots antigos continuam legíveis. Os estados declarativos dos objectos não são convertidos em certificação global.

Validação executada

  • Testes focados MNE: 10 testes, 86 verificações.
  • Suite completa em PostgreSQL isolado: 173 testes, 1785 verificações aprovadas.
  • PHPStan, Pint, TypeScript e lint dos componentes aprovados.
  • npm run build: 2371 módulos, 9,16 s.
  • Navegador QA: criação, gravação, submissão e layout a 390/1440 px; quatro observações, zero erros JavaScript. O formulário do revisor ainda não tem teste de navegador específico; a autorização e a gravação são verificadas por integração.
  • Casos novos: auto-revisão, estado inválido, versão desactualizada, objecto fora do negócio, validade obrigatória, cifragem, expiração, invalidação após edição e acesso de terceiro.

Operação, riscos e decisão

Go condicionado para revisão privada; No-Go para o módulo completo. O formulário está na ficha /investidor/negocios/{id} para revisores já designados, depois de iniciarem a revisão pela fila /management/negocios. Não foram atribuídos papéis a contas reais. O proprietário vê as conclusões mas não pode emitir verificações sobre o seu negócio.

Referências são texto reservado, não anexos carregados nem prova de autenticação externa. Ainda faltam upload/scanner, mandatos verificáveis, duas aprovações de publicação, catálogo anonimizado, compradores/interesses, CRM MNE, sala documental/diligência, negociação e validação operacional das fases seguintes. Esta entrega não satisfaz, por si só, o prompt integral.

Para suspensão, usar a flag existente INVESTMOZ_MNE_ENABLED=false e limpar a cache de configuração, preservando revisões. Não reverter a base nem apagar evidências. Uma reversão de código deve conservar a leitura dos novos contextos para não ocultar o histórico.

Próxima dependência funcional: recepção privada de documentos, quarentena e análise de ficheiros, vinculadas ao negócio e à revisão. A autorização geral para continuar mantém-se; informação institucional ausente deve permanecer pendente e não ser inventada.