New tasks

spec/tasks/017_return_all_cdek_tariffs.md

@@ -0,0 +1,49 @@
+---
+id: 017
+title: Return all tariffs from CDEK price calculation
+status: TODO
+created: 2026-03-14
+---
+
+## Context
+Сейчас `POST /api/v1/delivery/price` для CDEK возвращает только один тариф, хотя продуктовый контракт требует возвращать унифицированный список тарифов. Текущая реализация adapter/service использует однокотировочный provider contract и CDEK mapper берёт только первый элемент `tariff_codes[0]`.
+
+## Goal
+Изменить price flow так, чтобы CDEK adapter возвращал все тарифы из успешного ответа CDEK, а service агрегировал и сортировал объединённый список тарифов без изменения архитектурных границ слоёв.
+
+## Constraints
+- Scope задачи ограничен расчётом стоимости доставки и CDEK tariff list response; не изменять order creation flow.
+- Controller должен сохранить текущий публичный endpoint `POST /api/v1/delivery/price` и по-прежнему вызывать ровно один метод Service.
+- Service остаётся orchestration layer: собирает тарифы от провайдеров, работает с cache и делегирует фильтрацию/сортировку в Business Logic.
+- Pure business rules не переносить в Service или Adapter.
+- Изменение должно затронуть provider contract так, чтобы один provider мог вернуть несколько тарифов в одном запросе.
+- Scope задачи не включает добавление новых провайдеров, новых endpoint'ов и расширение response schema beyond текущего `DeliveryPrice`, если это не требуется для возврата всех тарифов.
+- Не изменять файлы в `spec/`.
+
+## Acceptance criteria
+- Интерфейс `DeliveryProvider` поддерживает возврат списка тарифов для одного provider request.
+- CDEK mapper преобразует все элементы `tariff_codes` из валидного ответа CDEK в список `DeliveryPrice`, а не только первый тариф.
+- CDEK provider adapter возвращает service полный список тарифов, полученный из ответа CDEK.
+- `AggregatorService.get_all_prices()` корректно обрабатывает список тарифов от каждого provider, объединяет их в единый список и передаёт его в domain filtering/sorting.
+- Cache coordination в service поддерживает сохранение и чтение списка тарифов для provider request.
+- `POST /api/v1/delivery/price` возвращает все тарифы CDEK в унифицированном формате, отсортированные по цене по возрастанию.
+- Existing graceful degradation сохраняется: failure одного provider исключает только его тарифы и не ломает успешные результаты других providers.
+
+## Definition of Done
+- [ ] Обновлён provider contract для возврата списка тарифов.
+- [ ] Обновлены CDEK mapper и adapter/client для многотарифного ответа.
+- [ ] Обновлён `AggregatorService.get_all_prices()` для объединения и кеширования списков тарифов.
+- [ ] Добавлены или обновлены tests для adapter, service и controller/API сценариев многотарифного ответа.
+
+## Tests
+- Обновить `tests/adapters/delivery_providers/cdek/test_mapper.py` для проверки mapping всех тарифов из `tariff_codes`.
+- Обновить `tests/adapters/delivery_providers/cdek/test_client.py` для проверки, что provider возвращает список тарифов, а не один объект.
+- Обновить `tests/services/test_aggregator.py` для flattening provider results, cache hit/miss со списком тарифов и partial failure сценариев.
+- Обновить `tests/controllers/v1/test_delivery.py` для проверки, что API возвращает несколько тарифов CDEK в одном ответе.
+
+## Commands
+- `poetry run pytest tests/adapters/delivery_providers/cdek/test_mapper.py -q`
+- `poetry run pytest tests/adapters/delivery_providers/cdek/test_client.py -q`
+- `poetry run pytest tests/services/test_aggregator.py -q`
+- `poetry run pytest tests/controllers/v1/test_delivery.py -q`
+- `python3 spec/gen_spec_index.py --check`

spec/tasks/018_add_cdek_order_creation_endpoint.md

@@ -1,5 +1,5 @@
 ---
-id: 017
+id: 018
 title: Add CDEK order creation endpoint
 status: TODO
 created: 2026-03-14