Mini App для фулфилмента и склада

Задача

Нужен был не просто бот с кнопками, а рабочий контур для фулфилмента маркетплейсов. Клиент должен создать компанию, загрузить товары, оформить заявку, следить за статусом и получить файлы. Склад должен принять товар, зафиксировать фактическое количество, брак, упаковку, отгрузку и штрихкоды. Администратор должен управлять пользователями, документами, прайсом, адресами и настройками AI.

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

Кейс показан без имени клиента, логотипов, домена, живой ссылки и реальных данных. Суть можно раскрыть безопасно: я собрал Mini App, где клиент, склад и админ работают с одним маршрутом заявки.

Что я собрал

Клиентский контур закрывает базовую работу с фулфилментом: компании, товары, заявки, отгрузки, прайс и AI-помощник. Пользователь открывает Mini App в Телеграме и видит не цепочку сообщений, а интерфейс с понятными разделами.

Товары можно вести внутри системы и импортировать из Excel. Это важно для маркетплейсов: SKU, штрихкод, остаток, брак, размер, цвет, артикул и инструкции по упаковке не должны жить только в переписке. Когда товар попадает в систему, его можно использовать в заявках, складских операциях и выгрузках.

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

Складской контур сделан отдельно от клиентского, но связан с теми же заявками. В нём есть приёмка, упаковка, печать штрихкодов, сканер, готовые к отгрузке позиции и FBO-сценарии для WB/Ozon. Склад может фиксировать факт, брак, паллеты, коробки, материалы и время работы.

AI-помощник встроен как рабочий слой, а не как отдельный чат ради красоты. Он отвечает по заявкам, товарам, остаткам, браку, отгрузкам, прайсу и документам. На backend-уровне проверяется доступ к компании, поэтому AI не должен отвечать человеку данными чужого клиента.

Почему это не витрина

У такого Mini App есть несколько контуров, которые не видны с первого клика, но определяют качество всей системы.

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

Во-вторых, данные. Остатки, брак, упаковка, отгрузка и фото должны сходиться между собой. Если склад принял меньше товара или отметил брак, дальнейшие действия должны опираться на факт, а не на план.

В-третьих, документы и файлы. В проекте есть загрузки, шаблоны, Excel-импорт, экспорт, S3-хранилище и конвертация документов. Для фулфилмента это не украшение, а часть ежедневной работы.

В-четвёртых, устойчивость. В проект заложены Redis/Celery для фоновых задач, Sentry для ошибок, проверки доступа, изоляция компаний, шифрование ключей маркетплейсов и проверки файлов. Это превращает Mini App из демо-экрана в технический контур, который можно проверять и запускать поэтапно.

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

клиент создаёт компанию и товары
  -> оформляет заявку или импортирует Excel
  -> склад принимает товар и фиксирует факт
  -> упаковка, штрихкоды, FBO и отгрузка
  -> клиент видит статус и файлы
  -> AI отвечает по данным активной компании
  -> админ управляет ролями, прайсом и документами

Главная ценность в том, что система держит один маршрут для нескольких ролей. Клиент не ждёт ручного ответа по каждому статусу, склад не ведёт процесс по памяти, а админ видит, где управлять доступами, документами и настройками.

Основа кейса

В проектной документации отдельно разобраны backend, frontend, AI-слой, безопасность, складские сценарии и готовность к тестированию. По коду есть маршруты для компаний, товаров, заявок, отгрузок, склада, FBO, админки и AI. На уровне тестовой поверхности есть backend- и frontend-проверки для авторизации, ролей, заявок, товаров, RAG, документов, упаковки и складских сценариев.

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

Результат

Получился full-stack Mini App для фулфилмента: клиентский кабинет, складской маршрут, админка, импорт и экспорт файлов, FBO-сценарии, документы, роли и AI-помощник по данным системы.

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

Ближе всего по типу задачи: Mini Apps, автоматизация процессов, боты в мессенджерах, AI-агенты и интеграции API.

Проблема