017 add creating order router

spec/tasks/017_add_cdek_order_creation_endpoint.md

@@ -9,7 +9,7 @@ created: 2026-03-14
 Сейчас 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`.
+Добавить `POST /api/v1/delivery/order` в существующий controller и существующий service с request/response schemas и error mapping для регистрации заказа в CDEK через adapter contract из задачи `016`.
 
 ## Constraints
 - Controller отвечает только за DTO validation, routing и mapping service exceptions в HTTP responses.
@@ -18,15 +18,16 @@ created: 2026-03-14
 - Логика создания заказа должна быть добавлена в существующий service модуль `app/services/aggregator.py`; не создавать отдельный service модуль.
 - Service оркестрирует только вызов injected CDEK order adapter и не содержит business logic или provider HTTP-деталей.
 - Контракт входного запроса должен соответствовать разделу `Регистрация заказа (тип "доставка", до двери)` из `http-client.http`.
+- В scope задачи входят только значения `type=2` и `tariff_code=535`; не расширять поддержку на другие типы заказа и тарифы.
 - Scope задачи не включает кеширование, агрегацию тарифов, расчёт стоимости, новые провайдеры и расширение order flow за пределы CDEK.
 - Не изменять файлы в `spec/`.
 
 ## Acceptance criteria
-- Существует endpoint `POST /api/v1/order`, принимающий payload по контракту из `http-client.http`.
-- Реализованы request/response schemas для создания заказа и минимального успешного ответа API.
+- Существует endpoint `POST /api/v1/delivery/order`, принимающий payload по контракту из `http-client.http`.
+- Реализованы request/response schemas `OrderCreateRequest` и `OrderCreateResponse` для создания заказа.
 - Endpoint реализован в существующем controller `app/controllers/v1/delivery.py`.
 - Controller делегирует обработку только в `AggregatorService.create_order()`.
-- Service вызывает injected adapter для регистрации заказа и возвращает response model с `order_uuid`.
+- Service вызывает injected adapter для регистрации заказа и возвращает `OrderCreateResponse` с `provider` и `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.
@@ -34,7 +35,7 @@ created: 2026-03-14
 ## Definition of Done
 - [ ] Добавлены order request/response schemas.
 - [ ] Реализован метод `AggregatorService.create_order()` для оркестрации регистрации заказа.
-- [ ] Реализован endpoint `POST /api/v1/order` в существующем controller.
+- [ ] Реализован endpoint `POST /api/v1/delivery/order` в существующем controller.
 - [ ] Добавлены service и controller/API tests для order creation flow.
 
 ## Tests