feat: expose Checko section APIs and completion counters
This commit is contained in:
@@ -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-проба и полный обход — отдельные критерии готовности.
|
||||
|
||||
Reference in New Issue
Block a user