arm-ka-docs/repo-templates/scan-gateway.CLAUDE.md
2026-10-02 23:02:44 +04:00

1.4 KiB
Raw Blame History

CLAUDE.md — scan-gateway

Общий контекст системы — ../CLAUDE.md и ../docs/. Этот файл — только про этот сервис.

Что это

Адаптер внешней ИС Сканирование (Content AI) для PDF/PNG/JPG: переименовать файл UUID_имя, положить в «Входящие», забрать Исходящие/UUID/UUID.json, сохранить сырой ответ в S3 raw/{job_id}.json (в БД не регистрируется), нормализовать в ../docs/contracts/recognition-result.schema.json (statementDocument), опубликовать recognition.result. Таймаут 5 мин → timeout. Нет доступа к БД.

Правила

  • Нормализация по фактическим ответам ../fixtures/ocr/aep_*.json, а не по ТЗ (OQ-13, OQ-14): confidence → 0–100, поля организации/даты — по тому, что реально приходит.
  • Один PDF может содержать ББ и ОФР → два документа в результате.
  • Dev-режим: эмулятор ИС Сканирование, возвращающий aep_N.json по имени файла (SCAN_EMULATOR=1).

Соглашения шаблона