016 add creating order to adapter

2026-03-14 03:54:55 +03:00
parent 66beab4682
commit 15a17be4ed
12 changed files with 607 additions and 12 deletions
@@ -1,7 +1,7 @@
 ---
 id: 015
 title: Add minimal OpenTelemetry tracing
-status: TODO
+status: DONE
 created: 2026-03-13
 ---

@@ -0,0 +1,43 @@
+---
+id: 016
+title: Add CDEK order registration adapter
+status: DONE
+created: 2026-03-14
+---
+
+## Context
+Сейчас CDEK adapter поддерживает только расчёт тарифа. Новый сценарий требует регистрацию заказа в CDEK по контракту из `http-client.http` в разделе `Регистрация заказа (тип "доставка", до двери)`.
+
+## Goal
+Расширить существующий CDEK adapter регистрацией заказа: добавить в текущий adapter/provider сбор payload по контракту, вызов `POST /v2/orders`, детерминированную обработку provider errors и маппинг успешного ответа во внутреннюю response model.
+
+## Constraints
+- Изменения ограничены существующим Adapter layer и schema/mapper моделями, необходимыми для стабильного adapter contract.
+- Использовать существующий OAuth2 flow CDEK; не дублировать auth logic.
+- Контракт запроса должен соответствовать разделу `Регистрация заказа (тип "доставка", до двери)` из `http-client.http`.
+- В scope этой задачи входят только значения `type=2` и `tariff_code=535`; не расширять поддержку на другие типы заказа и тарифы.
+- Не добавлять новые controller/service модули, controller routing, service orchestration, cache behavior и business logic.
+- Не изменять файлы в `spec/`.
+
+## Acceptance criteria
+- Существующий CDEK adapter/provider предоставляет стабильный метод регистрации заказа, принимающий валидированную internal model вместо raw dict.
+- Adapter отправляет `POST /v2/orders` с bearer token и JSON payload, соответствующим контракту из `http-client.http`.
+- Успешный ответ CDEK маппится во внутреннюю response model с `order_uuid`, полученным из `entity.uuid`.
+- Provider validation errors класса 4xx маппятся в детерминированную provider request error, а transport/5xx ошибки — в adapter client error.
+- Adapter tests покрывают success case, payload mapping, response mapping и error handling для order registration.
+
+## Definition of Done
+- [ ] Расширен существующий adapter method set для регистрации заказа CDEK.
+- [ ] Реализованы request/response mapper(s) для order registration.
+- [ ] Переиспользуется существующий OAuth2 auth client.
+- [ ] Добавлены adapter tests для order registration сценария.
+
+## Tests
+- Добавить `tests/adapters/delivery_providers/cdek/test_order_client.py` для success/error сценариев регистрации заказа.
+- Проверить, что payload содержит поля из контракта `http-client.http`.
+- Проверить маппинг `entity.uuid` в внутреннюю response model.
+- Для внешних HTTP взаимодействий использовать stubs/mocks.
+
+## Commands
+- `poetry run pytest tests/adapters/delivery_providers/cdek/test_order_client.py -q`
+- `python3 spec/gen_spec_index.py --check`
@@ -0,0 +1,50 @@
+---
+id: 017
+title: Add CDEK order creation endpoint
+status: TODO
+created: 2026-03-14
+---
+
+## Context
+Сейчас API поддерживает только `POST /api/v1/delivery/price`. Для нового пользовательского сценария нужен отдельный endpoint `/order`, который создаёт заказ в CDEK по контракту из `http-client.http`.
+
+## Goal
+Добавить `POST /api/v1/order` в существующий controller и существующий service с request/response schema и error mapping для регистрации заказа в CDEK через adapter contract из задачи `016`.
+
+## Constraints
+- Controller отвечает только за DTO validation, routing и mapping service exceptions в HTTP responses.
+- Endpoint должен вызывать ровно один метод Service: `AggregatorService.create_order()`.
+- Новый endpoint должен быть добавлен в существующий controller модуль `app/controllers/v1/delivery.py`; не создавать отдельный controller модуль.
+- Логика создания заказа должна быть добавлена в существующий service модуль `app/services/aggregator.py`; не создавать отдельный service модуль.
+- Service оркестрирует только вызов injected CDEK order adapter и не содержит business logic или provider HTTP-деталей.
+- Контракт входного запроса должен соответствовать разделу `Регистрация заказа (тип "доставка", до двери)` из `http-client.http`.
+- Scope задачи не включает кеширование, агрегацию тарифов, расчёт стоимости, новые провайдеры и расширение order flow за пределы CDEK.
+- Не изменять файлы в `spec/`.
+
+## Acceptance criteria
+- Существует endpoint `POST /api/v1/order`, принимающий payload по контракту из `http-client.http`.
+- Реализованы request/response schemas для создания заказа и минимального успешного ответа API.
+- Endpoint реализован в существующем controller `app/controllers/v1/delivery.py`.
+- Controller делегирует обработку только в `AggregatorService.create_order()`.
+- Service вызывает injected adapter для регистрации заказа и возвращает response model с `order_uuid`.
+- Логика orchestration размещена в существующем service `app/services/aggregator.py`.
+- Ошибки валидации входного payload возвращают 422, provider request errors маппятся в 400, недоступность CDEK и transport failures — в 503.
+- API и service tests покрывают success case и основные failure scenarios.
+
+## Definition of Done
+- [ ] Добавлены order request/response schemas.
+- [ ] Реализован метод `AggregatorService.create_order()` для оркестрации регистрации заказа.
+- [ ] Реализован endpoint `POST /api/v1/order` в существующем controller.
+- [ ] Добавлены service и controller/API tests для order creation flow.
+
+## Tests
+- Добавить `tests/services/test_order.py` для проверки вызова adapter и маппинга ошибок сервиса.
+- Добавить `tests/controllers/v1/test_order.py` для success case, schema validation и HTTP mapping ошибок.
+- При необходимости обновить `tests/smoke/test_app_import.py` для проверки подключения нового endpoint и service wiring без новых модулей.
+- Использовать test doubles для adapter dependency.
+
+## Commands
+- `poetry run pytest tests/services/test_order.py -q`
+- `poetry run pytest tests/controllers/v1/test_order.py -q`
+- `poetry run pytest tests/smoke/test_app_import.py -q`
+- `python3 spec/gen_spec_index.py --check`