Add scoped private business verification evidence and expiry
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user