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

Содержание разбора
клиенту фулфилмента нужно понимать, что происходит с поставкой. Складу нужны состав заявки, фактическое количество, брак и инструкции по упаковке. Если эти сведения разошлись по перепискам, статус приходится собирать вручную
я разработал кабинет в Телеграме, где клиент и склад работают с одной заявкой. Клиент оформляет поставку и смотрит ее этап, склад фиксирует приемку, упаковку и подготовку отгрузки. Администратор управляет доступом, документами и настройками
заявка связывает действия разных людей. Количество при приемке, фотографии брака, упаковка и файлы относятся к конкретной поставке
Клиент создает заявку и видит ее этап
путь начинается с раздела Компании. Клиент добавляет компанию, затем открывает Товары и заводит позиции вручную или импортирует их из 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