Задачи чат-бота: автоматическое бронирование. Продукт: Посуточной аренды. Техзадание есть. Пожелания и особенности: Ниже — текстовое техническое задание для разработчика на создание Telegram-бота с Telegram Mini App для бронирования посуточных квартир с полной интеграцией с системой RealtyCalendar. Техническое задание Telegram Bot + Telegram Mini App Бронирование посуточных квартир с интеграцией RealtyCalendar 1. Общая суть задания Требуется разработать Telegram-бот с Telegram Mini App (Web App), основная функция которого — бронирование посуточных квартир напрямую внутри Telegram. Бот должен полностью интегрироваться с системой https://realtycalendar.ru и использовать её как основной источник данных: * объекты недвижимости * календарь занятости * свободные и занятые даты * бронирования * цены Создание, проверка и подтверждение бронирований должны происходить через RealtyCalendar, без дублирования логики. 2. Цели проекта * Предоставить пользователям удобный интерфейс бронирования квартир в Telegram * Исключить двойные бронирования за счёт синхронизации с RealtyCalendar * Использовать RealtyCalendar как единую систему учёта объектов и дат * Автоматизировать процесс бронирования и оплаты 3. Общая архитектура * Telegram Bot — входная точка * Telegram Mini App (Web App) — пользовательский интерфейс * Backend-сервер — прокси-слой между Mini App и RealtyCalendar * API RealtyCalendar — основной источник данных * Платежная система — онлайн-оплата бронирований 4. Функциональные требования 4.1 Telegram-бот * Команда /start * Кнопка «Открыть приложение» (Telegram Mini App) * Отправка уведомлений пользователю: * подтверждение бронирования * успешная оплата * напоминание о заезде 4.2 Telegram Mini App (пользовательская часть) 4.2.1 Авторизация * Авторизация через Telegram WebApp (initData) * Передача в backend: * Telegram ID * Имя пользователя * Username 4.2.2 Каталог квартир Данные загружаются напрямую из RealtyCalendar: * список объектов * название объекта * адрес * фотографии * описание * цена за сутки * вместимость Функции: * список всех объектов * фильтрация по дате * фильтрация по количеству гостей * поиск по названию / адресу 4.2.3 Карточка объекта Отображение данных из RealtyCalendar: * галерея фотографий * подробное описание * цена * правила проживания * календарь занятости: * свободные даты * занятые даты (недоступны для выбора) 4.2.4 Календарь бронирования * Получение актуального календаря из RealtyCalendar * Блокировка недоступных дат * Проверка доступности дат в реальном времени * Запрет бронирования занятых периодов 4.2.5 Процесс бронирования 1. Выбор дат заезда и выезда 2. Проверка доступности через API RealtyCalendar 3. Расчёт стоимости (на основе данных RealtyCalendar) 4. Создание бронирования в системе RealtyCalendar 5. Получение ID бронирования 4.2.6 Оплата * Онлайн-оплата (конкретный провайдер уточняется) * После успешной оплаты: * подтверждение бронирования в RealtyCalendar * обновление статуса бронирования * блокировка дат * Обработка неуспешных платежей 4.2.7 Мои бронирования * Получение списка бронирований пользователя из RealtyCalendar * Отображение: * объект * даты * стоимость * статус (ожидает оплаты / подтверждено / отменено) 5. Интеграция с RealtyCalendar Интеграция должна включать: * Получение списка объектов * Получение календаря занятости * Проверку доступности дат * Создание бронирований * Обновление статусов бронирований * Получение цен и условий ? RealtyCalendar является основной системой учёта.?Все бронирования должны создаваться и храниться именно там. 6. Административная логика (минимально) * Администрирование осуществляется через RealtyCalendar * В Telegram: * уведомления администратору о новых бронированиях * уведомления об оплатах Отдельная админ-панель внутри Telegram не обязательна, если весь контроль ведётся в RealtyCalendar. 7. Нефункциональные требования * Адаптация под мобильные устройства * Быстрая загрузка Mini App * Корректная работа в iOS и Android Telegram * Безопасная работа с API и платежами * Логирование ошибок интеграции 8. Технологические требования (рекомендации) * Frontend Mini App: * React / Vue / Vanilla JS * Backend: * Node.js / Python * Telegram Bot API + Telegram Web Apps * Интеграция с API RealtyCalendar 9. Результат работ Разработчик должен предоставить: * Рабочий Telegram-бот * Telegram Mini App * Интеграцию с RealtyCalendar * Возможность бронирования и оплаты * Инструкцию по запуску и настройке.