# Changelog контракта lk-gateway

## v1.0.0 (2026-05-14)

Первая опубликованная версия контракта. Соответствует ESIA Finance
API V1 (`DOC/API ЛК ЕСИА.pdf`).

Поддерживаемые операции:

- `POST /api/v1/back_office/claims/` — создание заявки.
- `GET /api/v1/back_office/claims` — список с фильтрами.
- `GET /api/v1/back_office/claims/{id}` — деталь.
- `PATCH /api/v1/back_office/claims/{id}` — callback статуса.

Модели:

- `Claim` — заявка с массивом `securities[]` (1..N ЦБ).
- `CreateClaimRequest` — входное тело создания.
- `StatusCallback` — обновление статуса с `nsd_response` для аудита.
- `ErrorResponse` — формат идентичен ESIA Finance V1.

Совместимость:

- HTTP Basic-auth.
- UTF-8, JSON.
- Поля enum — буквально как в XSD M2M (T12/T03, BOND/SHAR/MFUN,
  ORDN/PREF/UKWN, INFO/ERROR).

## Принципы версионирования

- Несовместимые изменения — `v2/`, `v3/` (новая папка, отдельный
  changelog).
- Совместимые добавления — minor-версия в этом файле.
- Документация исправлений — patch-версия в этом файле.