Files
mostovik-backend/docs/sources/fssp.md
2026-10-05 15:17:11 +02:00

35 lines
5.4 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.
# ФССП: два открытых набора
Проверено 5 октября 2026 напрямую на официальном сайте и по meta.csv.
| Набор | Паспорт | Последний файл | Структура | Размер |
| --- | --- | --- | --- | --- |
| Общедоступные ИП юрлиц | https://opendata.fssp.gov.ru/7709576929-iplegallist | data-20261005T0655-structure-20260820T2100.csv | 17 колонок, 20260820T2100 | 1 971 503 738 байт |
| Оконченные ИП юрлиц | https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete | data-20261005T0704-structure-20220620T2006.csv | 16 колонок, 20220620T2006 | 2 724 199 089 байт |
HTTP 206/Content-Range подтверждает размеры и чтение первых 4096 байт обоих inputs. Полное скачивание и checksums ещё требуют завершения dev-приёмки. UTF-8, CSV comma/quoted multiline. Разрешённый HTTPS host: opendata.fssp.gov.ru. Паспорта скачиваются по <dataset>/meta.csv; актуальный файл выбирается по verified data timestamp, не порядку links. Максимальный размер каждого файла 4 GiB (4 294 967 296 байт), паспорт/структура 1 MiB; при превышении явный отказ.
## Mapping
Официальные structure CSV и обезличенные meta CSV сохранены в tests/fixtures/fssp. Обе версии используют общие названия полей должника, адресов, номера/даты ИП, сводного ИП, типа/даты/номера/предмета документа, предмета исполнения, отдела/адреса отдела, Debtor TIN и TIN of the organization collector.
- The name of the debtor → debtor_name; Address of the debtor organization → debtor_legal_address (исходный смысл «Адрес организации-должника» сохраняется в raw); Actual address → debtor_actual_address.
- The number of enforcement proceeding → proceeding_number; Date of the institution of proceeding → initiated_on/record_date; The number of the consolidated enforcement proceedings → consolidated_proceeding_number.
- The executive document type/date/number → document_type/document_date/document_number; The object of executive documents → document_subject_raw (не issuer); The object of the execution → subject.
- Amount due → claim_amount; Debt remaining balance → debt_amount/amount (signed Decimal); только общий набор.
- Date, complete IP reason → termination_raw и при распознавании terminated_on/article/part/point; только набор оконченных ИП. Суммы в нём отсутствуют и равны null, не нулю.
- Departments of bailiffs → department_name; Address of departments of bailiff → department_address.
- Debtor TIN → debtor_inn/exact canonical organization; TIN of the organization collector → creditor_inn. Ведущие нули сохраняются; контрольная цифра юридического ИНН проверяется.
General status unknown. Completed status ended обоснован областью паспорта: пункты 3/4 части 1 статьи 46 и пункты 6/7 части 1 статьи 47. Конкретное основание не заполняется из общей области — только из raw поля.
## Пересечение и идентичность
Identity: Debtor TIN + номер ИП, UUID5 существующего publisher. Одинаковое наблюдение дедуплицируется. Для одного ИП в обоих наборах оконченный набор имеет приоритет только если дата его публикации >= общей; сохранить оба наблюдения/provenance. Это более конкретная подтверждённая область, а не вывод из имени файла. Конфликт внутри одного набора или более новая общая запись против окончания блокирует общий publish. Ничего не выбирать по порядку обхода.
## Режим работы
Server download → raw artifacts → canonical staging batches <=500 → aggregate manifest → один атомарный publish. Строки вне реестра считаются без staging. Некорректный ИНН/неоднозначность — quarantine. Две выгрузки обязательны, отказ одной сохраняет прошлый snapshot. CSV payload: origin_kind=open_data_csv, queried_inn=null, amount=debt_amount, record_date=initiated_on. Unknown/missing поля nullable; warnings сохраняются.
Frontend/read-only соответствует контракту Глеба; item code fssp_inn_search, источник последний. Новое расписание disabled. Отсутствует пользовательский upload/file URL. Реальные dev counts/checksums/time/peak RSS и API/export acceptance будут добавлены после выполнения.