Новая задача на правки

2026-04-04 23:13:09 +03:00
parent db1c74f1ce
commit c95b6210a7
5 changed files with 57 additions and 5 deletions
@@ -1,7 +1,7 @@
 ---
 id: 019
 title: Add CDEK order creation endpoint
-status: TODO
+status: DONE
 created: 2026-03-14
 ---

@@ -0,0 +1,51 @@
+---
+id: 025
+title: Remove company from Create Delivery Order parties
+status: TODO
+created: 2026-04-03
+---
+
+## Context
+Текущий контракт `POST /api/v1/delivery/order` допускает поле `company` в `sender`, потому что order party schema используется и для `sender`, и для `recipient`. Новый сценарий требует упростить Create Delivery Order payload: поля `sender.company` и `recipient.company` больше не должны приниматься и не должны отправляться в CDEK.
+
+## Goal
+Удалить `company` из request contract Create Delivery Order на уровне schema validation, controller/API contract и CDEK order registration payload без изменения endpoint path, service orchestration и response model.
+
+## Constraints
+- Изменения ограничены существующими модулями order flow: `app/schemas/order.py`, `app/controllers/v1/delivery.py`, `app/services/aggregator.py`, `app/adapters/delivery_providers/cdek/` и связанными тестами; не создавать новые controller/service модули.
+- `POST /api/v1/delivery/order` должен оставаться в существующем controller и по-прежнему вызывать ровно один метод Service: `AggregatorService.create_order()`.
+- Service не должен получать новую business logic; orchestration order flow должна остаться прежней.
+- Поля `sender.company` и `recipient.company` должны отсутствовать в публичном request contract и не должны сериализоваться в payload, отправляемый в CDEK.
+- Payload, содержащий `sender.company` или `recipient.company`, должен считаться невалидным и отклоняться schema validation с HTTP 422.
+- `from_location.address` и `to_location.address` остаются opaque input strings; не добавлять address suggestion lookup, нормализацию адреса или иные изменения order flow.
+- Scope задачи не включает изменение response contract, price flow, address suggestion flow, provider routing, кеширование, новые провайдеры и расширение поддерживаемых `type`/`tariff_code`.
+- Обновить пример контракта Create Delivery Order в `http-client.http`, чтобы он не содержал `company`.
+- Не изменять файлы в `spec/`.
+
+## Acceptance criteria
+- `OrderCreateRequest` больше не содержит поле `company` ни для `sender`, ни для `recipient`.
+- `POST /api/v1/delivery/order` успешно принимает прежний payload без `company` и не требует никаких новых полей.
+- Если request payload содержит `sender.company` или `recipient.company`, endpoint возвращает 422 на уровне schema validation.
+- `AggregatorService.create_order()` продолжает только оркестрировать вызов injected order adapter без новой business logic.
+- CDEK adapter отправляет JSON payload для регистрации заказа без поля `company`.
+- `http-client.http` содержит актуальный пример регистрации заказа без `company`.
+- Service, controller/API и adapter tests покрывают success case после удаления поля и rejection scenario для `company`.
+
+## Definition of Done
+- [ ] Обновлён order request contract без поля `company` для `sender` и `recipient`.
+- [ ] Schema validation отклоняет `sender.company` и `recipient.company`.
+- [ ] CDEK order registration payload больше не содержит `company`.
+- [ ] Обновлены order flow tests для service, controller/API и adapter layers.
+- [ ] Обновлён пример Create Delivery Order в `http-client.http`.
+
+## Tests
+- Обновить `tests/services/test_order.py`, убрав `company` из валидных fixture payloads и сохранив проверку service orchestration.
+- Обновить `tests/controllers/v1/test_order.py` для success case без `company` и добавить сценарий 422 при передаче `sender.company` и `recipient.company`.
+- Обновить `tests/adapters/delivery_providers/cdek/test_order_client.py`, чтобы проверить отсутствие `company` в отправляемом CDEK payload.
+- При необходимости обновить другие order-related tests, завязанные на старый request contract.
+
+## Commands
+- `poetry run pytest tests/services/test_order.py -q`
+- `poetry run pytest tests/controllers/v1/test_order.py -q`
+- `poetry run pytest tests/adapters/delivery_providers/cdek/test_order_client.py -q`
+- `python3 spec/gen_spec_index.py --check`