BOTTEC — Telegram e-commerce платформа

Форма системы

BOTTEC превращает Telegram-чат в полноценную commerce-surface: каталог, корзина, checkout с несколькими payment провайдерами (Stripe + локальные карты), статус заказа, warehouse pick lists, courier handoff. Покупатели не выходят из Telegram; у операторов — настоящий бэкофис.

Сложные части были не в bot UI — Telegram bot framework нормальный. Сложные были вокруг:

Интеграция payment провайдеров. Stripe — прямолинейный; у локального провайдера была 200-страничная PDF-спека, test-окружение никакое и саппорт, отвечающий в рабочих днях. Слой интеграции явно defensive: типизированные контракты, idempotency keys, dead-letter queue для reconciliation. Когда что-то идёт не так с платежами — узнаёшь через секунды, а не на month-end close.

Warehouse и логистика. Inventory sync с третьесторонним warehouse'ом по 5-минутному pull. Дислокация курьеров через отдельный API. Оба ненадёжны по-разному, поэтому order state machine — источник истины; внешние системы догоняют её, а не наоборот.

Owner moderation surface. Владельцу нужно видеть live orders, приостановить товар, рефанднуть оплату, написать клиенту — всё без SQL. Маленький, но хорошо типизированный admin API + тонкий web UI закрывают это.

Уроки, которые перенеслись

Каждый следующий проект (Contento, торговая система, биотех-AI) унаследовал два паттерна из BOTTEC: state machines как источник истины, и типизированные integration contracts даже для "одноразовых" провайдеров. Оба оказались важнее конкретных stack-выборов.