F5 · для коллег-разработчиков

Клуб Анны изнутри

Платный клуб по мебели из Китая в Telegram. Сделан F5 с октября 2026: первый коммит 11 октября, открытие клуба 19 ноября.

Что за продукт

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

Telegram-бот

Меню, согласия, оплата, «Моя подписка», связь. Три языка: RU, EN, AR.

Mini App-витрина

Каталоги фабрик по рубрикам: поиск, карточки, «Избранное».

Подписка

Ежемесячная, с автоплатежом. Отменить автосписание можно прямо в боте.

Группа с темами

Одна супергруппа, темы по рубрикам. Вход только оплатившим.

Заявки на подбор

«Хочу» под позицией или пакет из «Избранного» уходят менеджеру клуба.

Видеообзоры

Ролики фабрик и выставок публикуются в темы группы и в витрину.

Туры в Китай

Расписание, анкета индивидуального тура, заявка без подписки.

Сайт

Главная, вопросы, контакты, страница оплаты и юридические документы.

Путь участника

Сценарий проходит без участия людей: ни владелец клуба, ни F5 руками ничего не делают.

  1. /start

    Бот отвечает на языке пользователя, показывает видео-приветствие и меню.

    grammY · вебхук · i18n RU/EN/AR
  2. Экран согласия

    Кнопка «Принять». Пока её не нажали, витрина и разделы закрыты.

    профиль создаётся только после «Принять» · в базе версия и хэш текста
  3. Оплата

    Оферта, согласие на ПДн и согласие на автосписание отдельными шагами. Затем страница оплаты на сайте клуба: Т-Касса для РФ, Stripe для зарубежных карт готовится

    одноразовый токен страницы · в базе только его sha256
  4. Вход в группу с темами

    Бот выдаёт персональную ссылку с заявкой на вступление и одобряет её только оплатившему. Пересланную ссылку отклоняет.

    createChatInviteLink · approveChatJoinRequest
  5. Витрина Mini App

    Все каталоги с контактами фабрик. В демо-режиме без подписки часть карточек открыта, остальные размыты и под замком.

    авторизация по initData Telegram
  6. Заявка

    «Хочу» под позицией или запрос пакетом из «Избранного». Менеджер получает карточку с кодом каталога.

    доставка через outbox, с повторами
  7. Продление

    Автосписание раз в месяц, напоминание за 3 дня. Не прошло и не продлили: бот сам снимает доступ и пишет, как вернуться.

    рекуррент по RebillId · планировщик · сверка

Источник правды о подписке — база. Её меняют только уведомления банка и сверка с ним. Сообщению «я оплатил» бот не верит.

Как устроено

Один монолит на Node 24 и TypeScript (Node исполняет .ts напрямую), Postgres рядом. Бот, вебхуки, сайт и API витрины — один процесс. Тот же образ крутится в двух контурах: PROD и DEMO.

Схема шире экрана: листайте её вбок.

bot
диалоги, меню, согласия, языки
web
Fastify: вебхуки, страница оплаты, сайт, юр.страницы
miniapp
API и статика витрины, вход по initData
access
ссылки-заявки в группу, одобрение, исключение, сверка, замок до старта
billing
подписки, автосписания, напоминания, промокоды, возвраты
payments
клиент Т-Кассы: подпись запросов и уведомлений, чеки
leads
заявки «Хочу» и пакеты из «Избранного» менеджерам
catalog
коды каталогов, фабрики, направления, публикация
obzory
видеообзоры: приём, подписи, публикация в темы и витрину
reports
ежедневные и недельные отчёты
support
«оплатил, а доступа нет», тикеты, удаление данных по запросу
tours
расписание туров
partners
промокоды партнёров и начисления по ним
dash
панель владельца клуба: воронка, люди, сверка
ops
флаги, outbox, алерты, CLI для сервера
db
миграции, схема Kysely, репозитории

Объём работы в цифрах

Посчитано по ветке main репозитория.

810коммитовпервый 11.10.2026, за 37 дней
59 тыс.строк TypeScript309 файлов в app/src, без тестов
341тест-файлиз них 171 интеграционный, на живом Postgres; 81 тыс. строк тестов
54миграции базы51 таблица, применённые не меняются
16модулейпапок в app/src
72планакод пишется только по одобренному плану с фазами
503PDF-каталога фабрикпрошли конвейер каталогов: 19 тыс. строк Python
3языка интерфейсаRU, EN, AR, около 1 400 строк на каждом

Данные на 16.11.2026.

Инженерные решения

Продукт берёт деньги и раздаёт доступ. Поэтому главные правила зашиты в саму базу, а не только в код.

Деньгам верим только банку

Подписку меняет лишь уведомление Т-Кассы с проверенной подписью или сверка с банком. Журнал события, переход платежа и продление идут одной транзакцией. Повтор того же события ничего не меняет, сумму сверяет триггер.

payments/tkassa/notify.ts · charges_amount_guard

Telegram только после коммита

Ключ доступа и уведомления после оплаты ставятся в outbox в той же транзакции. Воркер берёт задание на lease: отправлено, повтор с паузой, отложено или отказ с алертом. Сбой Telegram не откатывает оплату.

ops/outbox.ts

Ручной доступ, fail-closed в базе

Доступ по переводу мимо кассы — обычная подписка с provider = manual. CHECK запрещает ей карту и автосписание, триггер не даст создать по ней платёж. Журнал выдач неизменяем, статусы только draft → granted → revoked.

migrations/0040_manual_access.sql

Флаги-предохранители с журналом

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

ops/flags.ts · settings_log

Замок до старта продаж

Оплатившие до дня открытия не получают ссылку в группу и полную витрину. Задание ключа ждёт в outbox до момента открытия, экраны сверяют часы на каждое обращение. В момент старта всё открывается само.

access/prelaunch.ts · migrations/0052

Право на забвение

Одна транзакция обезличивает участника: контакты стёрты, автопродление отменено, ссылки отозваны, id вычищен даже из журнала настроек. Учёт денег и согласия остаются. Контакты для чеков шифруются в приложении, ключ в базу не попадает.

ops/forget.ts · ops/pii-crypto.ts

Ещё два правила в конфиге: боевой бот не стартует с тестовым терминалом и наоборот; без ключей Т-Кассы платёжный контур целиком выключен.

Как зайти

Для показа есть DEMO: тот же продукт, свои группы, тестовый терминал и ни одного настоящего участника. Нажимайте всё подряд.

  1. Откройте @klub_anny_demo_bot в Telegram и нажмите Start.
  2. Вход по приглашению. Если бот ответил, что вход закрыт, напишите Дмитрию свой Telegram.
  3. Дальше по пути участника: «Принять», оплата тестовой картой, группа, витрина, заявка.
Открыть DEMO-бота
Тестовая карта Т-Банка
4300 0000 0000 0777
Срок
12/30
CVC
111
Код подтверждения
любой

Стандартная тестовая карта банка. Деньги не настоящие.

Это рабочий стенд. Иногда там версия новее боевой или что-то временно сломано.

Ссылку на эту страницу и данные карты дальше не пересылайте.