16 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Эталоны нормализатора scan-gateway (golden v2)
`<name>.json` — результат `OcrNormalizer` для набора `ocr/<name>.json` + `ocr/<name>_*.json` в формате контракта 2.0
файла результата: `{schema_version, status, error, metrics, documents}`.
- `documents` — `statementDocument` контракта 2.0 (общий код `arm_statements`): колонки, строки со `line_status`,
`needs_review`, `parent_ref`, значения с `amount`/`string_value`/`is_recognized`, предупреждения и проверки документа.
- `metrics.warnings` — структуры предупреждений файла (`code`, `severity`, `message`, `locator`), например `JSON_FAILED`.
- `error` пишется только при `status = error` (тогда `documents = []`).
- Ключи `job_id`, `file_id`, `service`, `raw_s3_key` не пишутся: `service.statements_version` меняется при каждой
раскладке пакета, а идентификаторы в тестах фиктивные.
Обновление: `make golden-update` в scan-gateway; изменения смотреть через `git diff` и объяснять в PR.
Эталоны фиксируют поведение на реальных сканах, включая известные ограничения распознавания. Тест
`test_golden.py` дополнительно проверяет полный файл результата по JSON Schema `result`.