Как устроено демо

Демо у разработчика — обычно красивая картинка, по которой невозможно понять, что внутри. А разница между приложением, которое переживёт первую тысячу заказов, и тем, которое рассыплется на второй неделе, лежит именно внутри, и снаружи не видна вообще.

Поэтому здесь честный разбор: какие решения приняты, почему, и где я сама ошиблась. Заодно это готовый список вопросов, которые стоит задать любому разработчику, — не только мне.

Выбор в пользу простого стека здесь сознательный. Магазину на полсотни позиций фреймворк не даёт ничего, кроме мегабайтов, которые покупатель будет ждать на плохой связи, и зависимостей, которые через год потребуют обновления. Когда проект вырастет до тысяч товаров и складского учёта — стек будет другой, и я скажу об этом прямо.

1. Сумму считает сервер, а не приложение

Всё, что происходит в приложении, происходит на устройстве покупателя. Любое число там можно подменить — цену, скидку, стоимость доставки, — и для этого достаточно бесплатных инструментов, встроенных в браузер.

Поэтому приложение отправляет на сервер только номера товаров и количество. Ни цен, ни итога — их сервер берёт из своей базы и считает сам. Цифры на экране существуют исключительно для человека.

2. Покупателя опознаёт подпись Telegram

При запуске мессенджер передаёт приложению строку с данными пользователя и криптографической подписью, вычисленной с помощью токена бота. Сервер повторяет вычисление своим токеном и сравнивает результат. Совпало — перед нами действительно этот человек, и никакой регистрации не нужно.

Это важно там, где приложение показывает личные данные. В демо есть экран «Мои заказы»: кто его спрашивает — решает подпись, а не идентификатор из запроса. Разница принципиальная. Если доверять параметру, любой желающий подставит чужой номер и прочитает чужие заказы с адресами и телефонами — классическая утечка, которая стоит владельцу магазина куда дороже, чем разработка.

3. Оплата проходит внутри мессенджера

В демо работает настоящий приём оплаты. Покупатель нажимает «Оплатить картой», и окно оплаты рисует сам Telegram: карта у него уже привязана к аккаунту, реквизиты вводить не нужно. Провайдер подключён тестовый — окно настоящее, деньги не списываются.

Важное здесь — где считается сумма. Счёт выставляет сервер по номеру заказа, беря сумму из базы. Приложение не может попросить счёт на другую сумму, а чужой заказ не оплатит: сервер сверяет, тому ли человеку он принадлежит, по всё той же подписи Telegram.

И отдельный момент, на котором спотыкаются почти все, кто делает оплату впервые: перед списанием Telegram присылает боту запрос-предпроверку и ждёт ответа десять секунд. Не ответил — платёж отменяется, причём молча, и разработчик долго ищет причину. В этот момент правильно ещё раз сверить сумму счёта с базой: счёт мог быть создан полчаса назад, а заказ с тех пор изменился.

4. Обратная связь замкнута

Заказ не пропадает в базе. Владельцу приходит сообщение в Telegram, а когда он меняет статус в админке — покупателю прилетает уведомление от бота: «Оплачен», «Собираем», «Курьер выехал», «Доставлен». Тот же статус виден в приложении, в разделе «Мои заказы».

Круг замкнут: приложение → база → админка → покупатель. Именно этого чаще всего не хватает в самописных магазинах — заказы принимаются, а человек потом гадает, случилось ли что-нибудь.

Это главный аргумент в пользу формата, и в демо он показан на живых примерах, а не на словах.

Возможность	Что видит покупатель
Облачное хранилище	Набрал корзину на телефоне — открыл на компьютере, товары на месте. Избранное тоже переезжает: оно привязано к аккаунту, а не к браузеру
Номер телефона	Кнопка «Взять из Telegram» вместо ручного ввода. Мессенджер спрашивает согласие сам, отдельным окном
Родная кнопка	Кнопка оплаты рисуется самим Telegram внизу экрана, а не приложением. Выглядит и ведёт себя как в системных приложениях
Стрелка «назад»	Появляется в шапке мессенджера на вложенных экранах и закрывает именно тот, что открыт
Отдача в вибрацию	Короткий отклик на добавление товара, отдельный — на успешный заказ и на ошибку
Оплата	Окно оплаты рисует мессенджер, карта уже привязана к аккаунту. Никаких «введите номер карты» и переходов на сторонний сайт
Кто это	Приложение знает человека без регистрации, паролей и подтверждения почты

Отсюда простое правило выбора: если покупателю нужно завести аккаунт, запомнить пароль и подтвердить почту — половина уйдёт на первом же шаге. В Telegram этих шагов нет вообще.

Вне мессенджера всё это молча отключается, и демо продолжает работать как обычная страница — открытое в браузере, оно рисует вокруг себя рамку телефона. Так его можно показать человеку, у которого Telegram не установлен.

В демо действуют промокоды. И первая же версия вела себя дико: покупатель вводил код на скидку, а итог вырастал — с 1 630 до 1 717 ₽ вместо ожидаемых 1 467.

Причина оказалась не в арифметике скидки, а в порядке действий. Бесплатная доставка полагалась от 1 500 ₽, и порог проверялся после вычитания скидки. Скидка роняла сумму ниже полутора тысяч, доставка за 250 ₽ возвращалась, и она перекрывала выигрыш.

Лечится одной строкой: порог считается от стоимости товаров до скидки. Показательно тут другое — код был написан правильно, тесты на скидку проходили, и поймать это можно было только оформив настоящий заказ с промокодом на пограничную сумму. Поэтому в приёмке всегда есть проверка живым заказом, а не только осмотром экранов.

Подробный разбор с цифрами — в отдельной заметке.

Заказы из демо приходят мне в Telegram, так что оформленный вами тестовый заказ я увижу. Это, собственно, и есть демонстрация: так же он будет приходить владельцу магазина.