Разработка мини-приложения (Mini App) для магазина в Telegram

1. Общее описание проекта
Цель: Разработка минималистичного приложения-каталога товаров с корзиной и заказом, встроенного в Telegram. Приложение должно позволять пользователям просматривать товары, добавлять их в корзину и оформлять заказы без выхода из мессенджера.

Основная концепция: "Мини-магазин в мессенджере". Интерфейс простой, интуитивно понятный, работает быстро даже на слабых соединениях.

Аналоги: множественные Mini Apps в Telegram (например, от магазинов одежды)
2. Функциональные требования (Features)

2.1. Для Telegram :

· Главный экран:
  · Логотип/Название магазина.
  · Список категорий товаров (навигационное меню).
  · Баннер/приветственное сообщение.
· Каталог товаров:
  · Отображение товаров в виде карточек (сетка или список).
  · На карточке: фото, название, краткое описание, цена.
  · Фильтрация/сортировка по категориям.
  · Поиск по названию товара.
· Страница товара:
  · Галерея изображений (1-3 фото).
  · Полное название, развернутое описание, цена.
  · Кнопка "Добавить в корзину" с выбором количества.
· Корзина:
  · Список выбранных товаров с возможностью изменения количества или удаления.
  · Автоматический пересчет итоговой суммы.
  · Кнопка "Оформить заказ".
· Оформление заказа:
  · Форма для ввода данных:
    · Имя (может подтягиваться из профиля мессенджера).
    · Номер телефона (может подтягиваться).
    · Способ доставки (самовывоз, курьер) и адрес (при выборе курьера).
    · Комментарий к заказу (необязательно).
  · Подтверждение заказа с итоговой суммой и списком товаров.
· Система уведомлений для пользователя:
  · После оформления заказа — уведомление в чат ("Ваш заказ №123 принят!").
  · Уведомления о смене статуса заказа (например, "Передан курьеру") — по возможности (зависит от API).
· Административная часть (Backoffice):
  · Веб-панель для администратора магазина.
  · CRUD для товаров: Добавление, редактирование, удаление, загрузка фото.
  · CRUD для категорий.
  · Управление заказами: Просмотр списка заказов, изменение статуса (Новый, В обработке, Выполнен, Отменен), просмотр деталей заказа.
  · Просмотр простой статистики: кол-во заказов за день/неделю, популярные товары.

2.2. Специфичные требования для Telegram:

· Приложение должно быть реализовано как Telegram Mini App.
· Использование Telegram WebApp для получения данных пользователя (имя, username).
· Кнопка для запуска приложения должна открываться из меню бота или через команду /start в чате.
· Интеграция с Telegram Payments (опционально, но желательно для будущего).
 
3. Технические требования

· Frontend (клиентская часть приложения):
  · Технологии: React.js / Vue.js / Next.js (предпочтительно из-за простоты и быстрой разработки UI) или чистый JavaScript.
  · Стили: Адаптивный дизайн (Mobile First), можно использовать UI-кит (например, Telegram Mini Apps UI Kit для Telegram-версии).
  · Связь с бэкендом: REST API или GraphQL.
· Backend (серверная часть + админка):
  · Язык/Фреймворк: Node.js (Express/Nest), Python (Django/FastAPI), PHP (Laravel) — на выбор исполнителя.
  · База данных: PostgreSQL или MySQL.
  · Хранение изображений: Облачное хранилище (AWS S3, Яндекс.Облако, или загрузка на сервер с ресайзом).
  · Админ-панель: Можно реализовать на базе фреймворка (например, Django Admin) или сделать простой отдельный интерфейс.
· API: Необходимо предоставить документацию к разработанному API.
 
4. Требования к дизайну (UI/UX)

· Стиль: Минимализм, чистота, удобство.
· Адаптивность: Корректное отображение на экранах смартфонов разных диагоналей.
· Брендинг: Возможность легко поменять основные цвета (акцентный, фоновый) и логотип.
· Готовность: Предоставить готовый дизайн в Figma или ожидание, что фрилансер предложит лаконичный, готовый к реализации макет.

5. Этапы и сроки реализации

1. Анализ и прототипирование (3-5 дней): Согласование финального списка функций, структуры и вайрфреймов (схемы экранов).
2. Дизайн UI (5-7 дней): Разработка и согласование визуального дизайна всех экранов.
3. Разработка Backend + Админки (10-14 дней): Создание API, базы данных, логики и панели управления.
4. Разработка Frontend (10-14 дней): Верстка клиентской части для обеих платформ (Telegram Mini App + Веб-версия).
5. Интеграция и тестирование (7-10 дней): Связка фронтенда и бэкенда, тестирование всех сценариев, исправление ошибок.
6. Запуск и документирование (3-5 дней): Развертывание на хостинге заказчика, финальные правки, передача документации.

6. Критерии приемки (что должно быть сделано)

· Работоспособное приложение развернуто на предоставленном хостинге/VPS.
· Реализованы все функции из раздела 2.
· Админ-панель позволяет управлять товарами и заказами.
· Приложение корректно работает в Telegram (как Mini App)
· Отсутствуют критические ошибки (баги), мешающие оформлению заказа.
· Предоставлена краткая техническая документация по администрированию и API.
· Переданы все исходные коды (доступ к репозиторию Git).