Добавлен yandex geosuggest

spec/overview.md

@@ -20,7 +20,9 @@
 - Предоставлять отдельный endpoint подсказок адреса, чтобы frontend мог получить точное значение для `from_location.address` и `to_location.address` перед созданием заказа
 - Принимать запрос на создание заказа CDEK по контракту из `http-client.http` для сценария "доставка, до двери"
 - Выбирать сервис подсказок адреса по `country_code` через маппинг стран в конфиге
-- Для стран, сопоставленных с provider id `dadata`, использовать `dadata.ru`; конфигурация и wiring должны допускать отдельный address suggestion provider для европейских стран
+- Для `RU`, `BY` и `KZ`, сопоставленных с provider id `dadata`, использовать `dadata.ru`
+- Для `AM`, `AZ`, `KG`, `MD`, `TJ`, `TM` и `UZ`, сопоставленных с provider id `yandex_geosuggest`, использовать Yandex Geosuggest
+- Конфигурация и wiring должны допускать отдельные address suggestion providers для других регионов
 - Опрашивать всех зарегистрированных провайдеров параллельно
 - Возвращать унифицированный список тарифов, отсортированных по цене
 - Если провайдер вернул ошибку или не ответил вовремя — исключить его из результата, не падая целиком
@@ -103,9 +105,11 @@
       async def suggest(self, request: AddressSuggestRequest) -> list[AddressSuggestion]: ...
   ```
 - `dadata/client.py` — HTTP-клиент `dadata.ru` для address suggestions
+- `yandex_geosuggest/client.py` — HTTP-клиент Yandex Geosuggest `GET https://suggest-maps.yandex.ru/v1/suggest`
 - provider-specific модули address suggestion adapters инкапсулируют внешние API-контракты, auth, serialization и error handling
 - В конфиге adapter layer хранится маппинг `country_code -> provider_id` для выбора address suggestion provider
 - Address suggestion adapters возвращают только унифицированные internal models без утечки provider-specific payload в Service
+- Для Yandex Geosuggest adapter возвращает `postal_code=None`, так как контракт Geosuggest не используется как источник почтового индекса
 
 ---
 
@@ -222,7 +226,9 @@ app/
 ├── adapters/
 │   ├── address_suggestions/
 │   │   ├── base.py               # Интерфейс Adapter
-│   │   └── dadata/
+│   │   ├── dadata/
+│   │       └── client.py
+│   │   └── yandex_geosuggest/
 │   │       └── client.py
 │   └── delivery_providers/
 │       ├── base.py                    # Интерфейс Adapter