From 65c3809efe04561f6cc42e248401fa0edd2490fd Mon Sep 17 00:00:00 2001
From: Andrey Epifancev <andrey.epifancev@ssi-solutions.ru>
Date: Sat, 3 Oct 2026 17:58:47 +0400
Subject: [PATCH] =?UTF-8?q?=D0=9A=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA?=
 =?UTF-8?q?=D1=82=20v1.0:=20=D1=81=D1=85=D0=B5=D0=BC=D0=B0=20=D1=80=D0=B5?=
 =?UTF-8?q?=D0=B7=D1=83=D0=BB=D1=8C=D1=82=D0=B0=D1=82=D0=B0=20=D1=80=D0=B0?=
 =?UTF-8?q?=D1=81=D0=BF=D0=BE=D0=B7=D0=BD=D0=B0=D0=B2=D0=B0=D0=BD=D0=B8?=
 =?UTF-8?q?=D1=8F=20=D0=B1=D0=B5=D0=B7=20=D0=BF=D0=BE=D0=BC=D0=B5=D1=82?=
 =?UTF-8?q?=D0=BA=D0=B8=20=C2=AB=D1=87=D0=B5=D1=80=D0=BD=D0=BE=D0=B2=D0=B8?=
 =?UTF-8?q?=D0=BA=C2=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- title без «ЧЕРНОВИК v1, уточнить в Срезе 2»
- $comment о правилах версионирования (MAJOR.MINOR)
- NOT_IMPLEMENTED в перечне error.code
- пустой documents допустим только при status = error (if/then, minItems: 1 для done и needs_check)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 contracts/recognition-result.schema.json | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/contracts/recognition-result.schema.json b/contracts/recognition-result.schema.json
index 010429d..0ef9333 100644
--- a/contracts/recognition-result.schema.json
+++ b/contracts/recognition-result.schema.json
@@ -1,8 +1,9 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "arm-ka/recognition-result/v1",
-  "title": "Результат распознавания файла (tabular-parser / scan-gateway) — ЧЕРНОВИК v1, уточнить в Срезе 2",
+  "title": "Результат распознавания файла (tabular-parser / scan-gateway), контракт v1.0",
   "description": "Один файл (stored_file) → один job → N документов. Сервисы не знают БД: только структура файла. Нормализация счетов, резолв контрагентов, проверки — в arm-core.",
+  "$comment": "Версионирование: schema_version = MAJOR.MINOR. MINOR (1.1) — необязательные поля и новые значения enum; MAJOR (2.0) — удаление/переименование полей, смена типов или семантики. Потребитель принимает тот же MAJOR и любой MINOR.",
   "type": "object",
   "required": ["schema_version", "job_id", "file_id", "service", "status", "documents"],
   "properties": {
@@ -21,7 +22,7 @@
     "error": {
       "type": ["object", "null"],
       "properties": {
-        "code": { "enum": ["UNSUPPORTED_FORMAT", "UNREADABLE", "TIMEOUT", "SCHEMA_MISMATCH", "FILE_READ_ERROR", "INVALID_FORMAT", "INVALID_DOCUMENT", "RECOGNITION_FAILED", "UNKNOWN_ERROR"] },
+        "code": { "enum": ["UNSUPPORTED_FORMAT", "UNREADABLE", "TIMEOUT", "SCHEMA_MISMATCH", "NOT_IMPLEMENTED", "FILE_READ_ERROR", "INVALID_FORMAT", "INVALID_DOCUMENT", "RECOGNITION_FAILED", "UNKNOWN_ERROR"] },
         "message": { "type": "string" }
       }
     },
@@ -43,6 +44,13 @@
       "items": { "oneOf": [ { "$ref": "#/$defs/osvDocument" }, { "$ref": "#/$defs/statementDocument" } ] }
     }
   },
+  "if": {
+    "properties": { "status": { "enum": ["done", "needs_check"] } },
+    "required": ["status"]
+  },
+  "then": {
+    "properties": { "documents": { "minItems": 1 } }
+  },
   "$defs": {
     "money": { "type": ["string", "null"], "pattern": "^-?\\d+(\\.\\d{1,2})?$", "description": "Decimal как строка, чтобы не терять копейки в JSON" },
     "osvDocument": {