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
+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": {