← Все кейсы

Личный кабинет для клиентов и склада фулфилмента

Кабинет фулфилмента в Телеграме: клиент оформляет заявку, склад фиксирует приемку и упаковку, а статусы, товары и документы связаны с одной компанией.

Перейти к разбору

Личный кабинет для клиентов и склада фулфилмента

1 / 6
Mini App для фулфилмента: клиент, склад и заявки в одном маршруте
Первый экран показывает главный смысл кейса: клиент, склад и админ работают вокруг одной заявки.
Содержание разбора

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

я разработал кабинет в Телеграме, где клиент и склад работают с одной заявкой. Клиент оформляет поставку и смотрит ее этап, склад фиксирует приемку, упаковку и подготовку отгрузки. Администратор управляет доступом, документами и настройками

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

Клиент создает заявку и видит ее этап

путь начинается с раздела Компании. Клиент добавляет компанию, затем открывает Товары и заводит позиции вручную или импортирует их из Excel. У товара есть название, артикул, штрихкод, остаток и данные для упаковки

в разделе Заявки клиент выбирает компанию и нажимает Создать заявку. Товары становятся позициями поставки. В списке можно отфильтровать заявки по статусу и открыть нужную

Обезличенный экран клиентского кабинета: выбранная компания, фильтр статусов, Создать заявку и заявка На приемке
Контрольный пример, данные обезличены

для заявки предусмотрены этапы На приемке, Принято, Упаковка, Готово к отгрузке, Завершено. Вместе с позицией хранятся связанные файлы и фотографии, клиенту не нужно искать их в другой переписке

Склад продолжает ту же заявку

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

после приемки обновляются остатки товара. Состояние сохраняется в базе до отправки уведомления клиенту. Клиентский статус опирается на запись операции

в разделе Упаковка сотрудник выбирает компанию и заявку, затем берет ее в работу. Для упаковки предусмотрены коробки, паллеты, штрихкоды, материалы и время работы. Из этого же раздела доступна выгрузка FBO в Excel

Обезличенный складской экран: Упаковка, выбранная компания, заявка, Взять в работу и Скачать FBO Excel

дальше используются разделы Печать, Сканер, Отгрузка. В проекте есть печать штрихкодов, проверка товара сканером, работа с коробками и подготовка поставок FBO для ВБ и Ozon

Действия разделены по ролям

клиент работает со своей компанией, товарами, заявками и файлами. Склад фиксирует операции приемки, упаковки и завершения. Администратор управляет пользователями, услугами, направлениями, шаблонами документов и ИИ

складское действие проверяется на сервере. Например, обработчик приемки требует роль склада или администратора

компания также задает область данных. Она связывает товары, заявки и документы, а при запросе к ИИ доступ проверяется от имени текущего пользователя

ИИ отвечает по данным выбранной компании

помощник встроен в кабинет. Ему можно задать вопрос о заявках, остатках, браке, отгрузках, прайсе или документах

для ответа модель получает инструменты чтения данных. Если вопрос касается заявки, инструмент ищет ее в выбранной компании. Перед выполнением проверяется доступ пользователя к этой компании. Для документов используется поиск по базе знаний

провайдер, модель и инструкции управляются настройками. Реализованы подключения OpenAI и OpenRouter.

Документы остаются рядом с операцией

в системе предусмотрены шаблоны документов, загрузка файлов, импорт и экспорт Excel. Файлы хранятся в S3, обработка и конвертация документов вынесены в фоновые задачи Redis/Celery

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

Что я разработал

Клиентский кабинет

React и TypeScript, компании, товары, импорт, заявки, статусы и файлы в приложении Телеграма

Складские операции

Приемка с фактом и фотографиями брака, упаковка, коробки, паллеты, печать, сканирование и подготовка FBO

Данные и доступ

FastAPI и PostgreSQL, серверные проверки ролей, связь позиций с заявкой и данные выбранной компании

Документы и ИИ

S3, фоновые задачи, поиск по документам и инструменты получения данных для ответа помощника

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

подобные задачи относятся к приложениям в Телеграме, автоматизации процессов и интеграциям

На чем собрано

Telegram Mini App · React · TypeScript · FastAPI · PostgreSQL · Redis · Celery · S3 · OpenAI/OpenRouter · Docker · Nginx