Задание: Telegram Mini Apps. Mini App в Телеграм (Дистанционная работа)
Техническое задание: Telegram Mini App для приёма и доставки заказов
1. Суть проекта
Telegram Mini App + веб-витрина для приёма заказов и управления доставкой. Приложение работает внутри Telegram (без установки из App Store / Google Play), а также в обычном браузере и как иконка на домашнем экране (PWA). Всё управление бизнесом — с телефона, через интерфейс приложения. Интерфейс — двуязычный (русский + английский), переключение одной кнопкой.
2. Платформы
Telegram Mini App — iPhone, Android, Desktop; запуск из бота одной кнопкой меню.
Браузер — телефон и компьютер; вход по номеру телефона или почте.
PWA — добавление на домашний экран со своей иконкой.
3. Роли пользователей
Клиент — просмотр витрины и оформление заказов.
Менеджер — обработка заказов и общение с клиентами.
Владелец — полный доступ ко всем настройкам (админ-панель встроена в приложение).
Партнёр — участник реферальной программы.
Доступ менеджера и владельца — по списку разрешённых Telegram-аккаунтов (allowlist).
4. Функционал — Клиент
Витрина с фото: категории и товары с крупными фотографиями (до 3 на товар), описанием, ценой, весом/объёмом. Разделы «Популярное» и «Избранное».
Корзина: количество, комментарий к заказу; еда и услуги оформляются отдельными заказами.
Адрес и доставка: определение местоположения, карта с меткой, автоматический расчёт стоимости доставки по расстоянию (по дороге), бесплатная доставка от заданной суммы.
Оформление: заказ сейчас или на конкретное время / на завтра.
Оплата: QR-код (генерируется на сервере), оплата по ссылке, бонусные баллы за покупки (накапливаются и автоматически идут в счёт следующего заказа).
После заказа: статусы обновляются сами, «Повторить заказ», отмена, отслеживание курьера, оценка еды и сервиса.
Связь: кнопка «Написать менеджеру», встроенный чат, раздел отзывов.
Уведомления: приходят в Telegram и как push на телефон — даже когда приложение закрыто.
5. Функционал — Менеджер
Сигнал о новом заказе (звук и пометка) — не пропустить.
Ведение заказа по шагам: оплата получена → готовится → курьер в пути → доставлен (для услуг — свой цикл).
Отложенные заказы показываются заранее и «оживают» к нужному времени.
Чат с клиентом, все обращения с сайта — в одном разделе.
Быстрые действия: копирование координат для курьера, ссылка на курьера/такси.
6. Функционал — Владелец (админ-панель внутри приложения)
Меню: добавление/изменение категорий и товаров — название (2 языка), цена, фото, описание, наличие, видимость. Изменения видны клиентам сразу.
Настройки магазина: логотип/значок, баннер, реквизиты оплаты (QR и ссылка), контакт менеджера, часы работы, кнопка «Временно закрыто», порог бесплатной доставки, процент бонусных баллов.
Команда: добавление менеджеров и администраторов в пару кликов.
Партнёрская программа: реферальные ссылки и QR, комиссии партнёрам, учёт начислений и выплат, личный кабинет партнёра.
Рассылки: сообщения клиентам, согласившимся получать новости (без спама).
Контент: блоки «Акции и скидки» и «О компании» с фото и текстом.
Архив заказов: вся история сохраняется.
8. Платежи
Статичный QR для оплаты (под выбранную платёжную систему).
Оплата по внешней ссылке (для альтернативной валюты).
Бонусные баллы как способ частичной/полной оплаты.
9. Доставка
Расчёт расстояния по дороге через картографический сервис.
Формула стоимости настраивается (тариф за км, минимальная сумма, округление).
Точка отправления — фиксированная (адрес кухни/магазина).
10. Уведомления
В Telegram и через web push (на телефон при закрытом приложении).
Автонапоминания: подтвердить оплату, запрос отзыва после доставки, напоминание о брошенной корзине.
11. Что предоставляет заказчик
Бот в Telegram (токен из BotFather).
Домен и доступ к VPS (или фрилансер разворачивает «под ключ»).
Аккаунт картографического/переводческого сервиса (ключи API).
Платёжные реквизиты (QR / ссылка).
12. Ожидаемый результат (приёмка)
Рабочее Mini App + бот + админ-панель, развёрнутые на сервере и открывающиеся по домену внутри Telegram и в браузере.
Исходный код с инструкцией по сборке и деплою.
Проверка на реальном телефоне (iOS и Android): оформление заказа, оплата, смена статусов, уведомления, работа админ-панели.
