Add scoped private business verification evidence and expiry

This commit is contained in:
2026-09-29 08:40:43 +02:00
parent a2692704d9
commit b77714b156
12 changed files with 568 additions and 5 deletions
@@ -1,5 +1,5 @@
{
"date": "2026-09-28T18:25:03.759Z",
"date": "2026-09-29T06:39:38.960Z",
"scope": "Synthetic private create/save and responsive layout in isolated QA; institutional review covered by integration tests",
"observations": [
{
@@ -1,5 +1,7 @@
# Estado actual — Mercado de Negócios Existentes
Actualização 29/09/2026: [revisão granular com evidência, validade e invalidação por alteração](verification-evidence.md) implementada na ficha privada. Suite: 173 testes / 1785 verificações aprovadas. Os limites e contagens abaixo descrevem a entrega anterior; o módulo integral continua incompleto.
28/09/2026. A instrução mais recente autoriza executar todas as fases e avançar automaticamente. Substitui a paragem entre fases do prompt inicial. Não presume evidências jurídicas, nomeação de revisores, publicação ou integração externa efectiva.
## Entrega utilizável localmente
+209 -1
View File
@@ -2,7 +2,7 @@
"openapi": "3.1.0",
"info": {
"title": "InvestMoz — private existing-business intake",
"version": "1.0.0",
"version": "1.1.0",
"description": "Internal preparation and review only. No publication, certification, legal transfer, NDA, payment or external CRM operation."
},
"servers": [
@@ -320,6 +320,90 @@
}
}
}
},
"verifications": {
"type": "array",
"items": {
"type": "object",
"required": [
"version_no",
"check",
"outcome",
"evidence_reference",
"note"
],
"properties": {
"version_no": {
"type": "integer",
"minimum": 1
},
"object_id": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"check": {
"enum": [
"identity",
"representation",
"declared_ownership",
"documentary_ownership",
"document_received",
"document_validated",
"independent_valuation",
"land_right_documented",
"license_confirmed",
"validity",
"legal_transfer",
"prior_authorization"
]
},
"outcome": {
"enum": [
"confirmed",
"rejected",
"inconclusive",
"revoked"
]
},
"evidence_reference": {
"type": "string",
"minLength": 10,
"maxLength": 2000
},
"note": {
"type": "string",
"minLength": 10,
"maxLength": 2000
},
"valid_until": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Required for confirmed findings; must be today or later."
},
"effective_outcome": {
"enum": [
"confirmed",
"rejected",
"inconclusive",
"revoked",
"stale",
"expired"
]
},
"content_version": {
"type": "integer"
},
"created_at": {
"type": "string"
}
}
}
}
}
}
@@ -1088,6 +1172,130 @@
},
"description": "Session authentication and Laravel CSRF/origin protection apply. Use X-XSRF-TOKEN for browser clients."
}
},
"/listings/{id}/verifications": {
"post": {
"summary": "Record independent finding while in_review; immutable encrypted evidence, optimistic version and scoped object. Does not publish or certify the business.",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"security": [
{
"session": []
}
],
"responses": {
"200": {
"description": "Private response; Cache-Control private, no-store",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Business"
}
}
}
},
"401": {
"description": "Authentication required"
},
"403": {
"description": "Account, ownership or current reviewer/MFA policy rejected"
},
"404": {
"description": "Module disabled or resource unavailable"
},
"409": {
"description": "Stale version or invalid transition"
},
"422": {
"description": "Validation error"
},
"429": {
"description": "Rate limited"
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"version_no",
"check",
"outcome",
"evidence_reference",
"note"
],
"properties": {
"version_no": {
"type": "integer",
"minimum": 1
},
"object_id": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"check": {
"enum": [
"identity",
"representation",
"declared_ownership",
"documentary_ownership",
"document_received",
"document_validated",
"independent_valuation",
"land_right_documented",
"license_confirmed",
"validity",
"legal_transfer",
"prior_authorization"
]
},
"outcome": {
"enum": [
"confirmed",
"rejected",
"inconclusive",
"revoked"
]
},
"evidence_reference": {
"type": "string",
"minLength": 10,
"maxLength": 2000
},
"note": {
"type": "string",
"minLength": 10,
"maxLength": 2000
},
"valid_until": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Required for confirmed findings; must be today or later."
}
}
}
}
}
},
"description": "Session authentication and Laravel CSRF/origin protection apply. Use X-XSRF-TOKEN for browser clients."
}
}
},
"components": {
@@ -0,0 +1,32 @@
# 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.