1.9 KiB
CLAUDE.md — tabular-parser
Общий контекст системы — ../CLAUDE.md и ../docs/. Этот файл — только про этот сервис.
Что это
Stateless-сервис разбора XLS/XLSX/XLSB: ОСВ по счетам (§1 правил) и ББ/ОФР из Excel (§12). Вход — NATS
recognition.tabular.request + файл в S3 uploads/; выход — JSON по ../docs/contracts/recognition-result.schema.json
в S3 results/ + NATS recognition.result. Нет доступа к БД. Не знает про организации, периметры, план счетов —
возвращает структуру файла; нормализация и резолв — в arm-core.
Главное правило
Структура определяется динамически по содержимому (§1.0 правил): никаких координат ячеек, имён листов, букв колонок
в коде. Словари синонимов — rules/*.yaml. Фикстуры ../fixtures/osv/** — регрессия, не спецификация формата:
новый формат = новая фикстура + синоним, не новый if.
Тесты
- property-тесты инвариантов (§1.4) на всех файлах
../fixtures/osv/**и../fixtures/statements-xlsx/**; - снимки
../fixtures/golden/expected_osv_parse/*.json— после ручной сверки «Итого»; - синтетика только для вариантов, которых нет в фикстурах (шапка вариант 2, Вал./Кол., xlsb, без outline level).