feat: expose Checko section APIs and completion counters

This commit is contained in:
Aleksandr Meshchryakov
2026-10-05 16:45:13 +02:00
parent a517950425
commit 4637b02ddd
26 changed files with 1974 additions and 36 deletions

View File

@@ -20,6 +20,19 @@ HTTPS GET https://api.checko.ru/v2/company или /fedresurs через суще
## Fixtures и готовность
Fixtures синтетические, структура из официальной документации; реальные ответы аккаунта не снимались. Success/renewed/empty/denied/rate-limit/two pages доступны локально. Никаких вымышленных /leasing,/messages. Readiness: schema documented; implementation и фактическая dev-приёмка впереди. Месячные claims/полная популяция требуют отдельной проверки. Schedules disabled.
Fixtures синтетические, структура из официальной документации; реальные ответы аккаунта не снимались. Success/renewed/empty/denied/rate-limit/two pages доступны локально. Никаких вымышленных /leasing,/messages. Readiness: три адаптера, scoped snapshots, monthly claims, карточки/API/экспорт и типизированные OpenAPI variants реализованы. Фактическая приёмка выбранного аккаунта и полной dev-популяции остаётся отдельно. Schedules disabled.
Публичный тариф: первые 100 запросов за день бесплатны, далее Standard 0.15 RUB / Maximum 0.10 RUB за HTTP 200. Конкретный тариф/остаток аккаунта не установлен; это не разрешение расходовать квоту. Для фактической пробы подготовить canonical scope и максимальное число страниц/calls, получить отдельное разрешение.
## Реализованная публикация и контракт
Три источника `checko_leasing`, `checko_messages`, `checko_licenses` имеют независимые карточки `checko-leasing`, `checko-messages`, `checko-licenses`, группы `leasing`, `company_messages`, `company_licenses` и типы `leasing_contract`, `company_message`, `company_license`. Refresh/run доступны администраторам, пользовательские file URLs запрещены. Display copy сохраняет существующую нейтральную конвенцию; machine IDs и проверенный provenance в новом API/экспорте не заменяются.
Eligibility совпадает с существующими платными сборщиками: ОПК / Росатом / Роскосмос и обязательный импорт в канонический справочник. Перед запросом проверяются ИНН (10 цифр/checksum), ОГРН (13), ОКПО (8), наличие имени и однозначная организация; записи филиалов/неоднозначные или неполные реквизиты сохраняются без запроса. Это не сбор полного каталога всех юрлиц страны.
Claim берётся атомарно до первого запроса и сохраняется после ошибки. Каждый раздел обходит максимум 100 страниц / 10 000 сообщений на организацию; staging batches по 500. Ошибка пагинации удаляет staging этой организации, старые опубликованные записи сохраняются. Успешный пустой ответ удаляет прежние записи только своей организации. Нет завершённых организаций — rejected artifact и failure job, без fake snapshot.
Artifact — приватный NDJSON с нормализованными наблюдениями и upstream-полями, SHA-256/size; credentials/meta balance не сохраняются. `completeness=full|partial`; непересекающиеся категории: `organizations_updated + organizations_empty + organizations_failed + quota_skipped = organizations_total`. `organizations_preserved = organizations_failed + quota_skipped`, это пересекающийся диагностический счётчик, его не суммируют второй раз. `updated_records_count` — записи завершённого scope, `retained_records_count` — сохранённые записи, published/snapshot counts — весь текущий опубликованный набор. Partial success не двигает `latest_success_load` полного прохода; последний job/load показывает partial metadata. API и экспорт читают все текущие записи, включая сохранённые из прежних batches.
Локальная проверка 05.10.2026: adapters/старый клиент/local HTTP — 126 passed; PostgreSQL с настоящими миграциями/гонкой monthly claim и admission/export — 42 passed; generated OpenAPI/Orval/type-check и Zod round-trip — 19 фактических JSON-ответов без изменения/потери полей. Платные реальные вызовы не выполнялись. Ограниченная dev-проба и полный обход — отдельные критерии готовности.