# Хмели Летели

> Кавказская кухня с доставкой готовой еды и самовывозом. Меню, цены, рестораны, акции и оформление заказа по регионам.

## Ключевые страницы

- [Хмели Летели — главная](https://hmelileteli.com/): меню, акции, контакты по регионам
- [Каталог](https://hmelileteli.com/catalogue): полный каталог блюд с категориями
- [Контакты](https://hmelileteli.com/kontakty): адреса, телефоны, режим работы
- [Доставка](https://hmelileteli.com/dostavka): зоны, минимальная сумма, время
- [Оплата](https://hmelileteli.com/oplata): наличные, картой курьеру, онлайн
- [Самовывоз](https://hmelileteli.com/samovyvoz): список ресторанов
- [Акции](https://hmelileteli.com/aktsii): актуальные предложения

## Регионы
- [Донецк](https://hmelileteli.com/donetsk/): главная регионального сайта (регион по умолчанию)
- [Макеевка](https://hmelileteli.com/makeevka/): главная регионального сайта
- [Мариуполь](https://hmelileteli.com/mariupol/): главная регионального сайта
- [Харцызск](https://hmelileteli.com/khartsyzsk/): главная регионального сайта
- [Ханженково](https://hmelileteli.com/khanzhenkovo/): главная регионального сайта


## API для AI-агентов (JSON, открытый CORS)

- [Манифест](https://hmelileteli.com/api/agent/manifest): возможности, эндпоинты, регионы
- [Регионы](https://hmelileteli.com/api/agent/regions): список активных регионов с slug + предложным падежом
- [Категории](https://hmelileteli.com/api/agent/categories?region=donetsk): топ-уровневые категории каталога
- [Меню](https://hmelileteli.com/api/agent/menu?region=donetsk): полное меню с ценами и весом
- [Товар](https://hmelileteli.com/api/agent/product/khachapuri-po-adzharski?region=donetsk): детали блюда
- [Рестораны](https://hmelileteli.com/api/agent/restaurants?region=donetsk): пункты самовывоза с координатами
- [Контакты](https://hmelileteli.com/api/agent/contacts?region=donetsk): телефоны + текущий статус «открыто / закрыто»
- [Поиск](https://hmelileteli.com/api/agent/search?q=хачапури&region=donetsk): полнотекстовый поиск по меню
- [Условия оформления](https://hmelileteli.com/api/agent/checkout-info?region=donetsk): доставка / оплата / минимальная сумма
- [POST Подготовить корзину](https://hmelileteli.com/api/agent/cart/build): принимает `{items:[{slug,qty}]}`, возвращает URL для подтверждения клиентом

## Подробная документация для агентов

- [Полная карта сайта для LLM](https://hmelileteli.com/llms-full.txt)
- [OpenAPI 3.1](https://hmelileteli.com/.well-known/openapi.yaml)
- [Манифест агента](https://hmelileteli.com/.well-known/agent.json)
- [Манифест ChatGPT-плагина (legacy)](https://hmelileteli.com/.well-known/ai-plugin.json)
- [Model Context Protocol (MCP) хинт](https://hmelileteli.com/.well-known/mcp.json)
- [Sitemap.xml](https://hmelileteli.com/sitemap.xml)
- [robots.txt — политика крауля](https://hmelileteli.com/robots.txt)
- [security.txt](https://hmelileteli.com/.well-known/security.txt)

## Голосовые ассистенты (webhook)

- [Яндекс Алиса](https://hmelileteli.com/api/voice/yandex-alice) — Yandex Dialogs SDK
- [Маруся (VK)](https://hmelileteli.com/api/voice/marusia)
- [Сбер Салют](https://hmelileteli.com/api/voice/sber-salute) — Salute SmartApp Framework

## Оформление заказа агентом

Заказ всегда подтверждает клиент в собственном браузере — агент только готовит корзину:

1. Агент вызывает `POST https://hmelileteli.com/api/agent/cart/build` с телом `{"items":[{"slug":"khachapuri-po-adzharski","qty":2}],"region":"donetsk"}`
2. Ответ содержит `prep_url` (с разовым токеном на 30 минут)
3. Агент показывает `prep_url` клиенту
4. Клиент открывает URL — сайт сам подтягивает товары в корзину
5. Клиент проверяет состав и оформляет заказ

Оплата: наличными, картой курьеру или картой онлайн.

## Регионы и цены

- Цены и наличие указаны в рублях и различаются по регионам
- Регион передаётся параметром `?region=<slug>`; без него используется регион по умолчанию