Техническое задание на доработку системы управления сборкой заказов

Контекст проекта

Существует рабочая система для управления товарами и поставками на маркетплейсы. Технологический стек: фронтенд на React (Vite + Ant Design), бэкенд на NestJS с использованием Sequelize ORM и PostgreSQL в качестве БД. Сервер развернут с использованием nginx. Уже реализованы базовые интеграции с маркетплейсами (товары и поставки), справочники, модуль пользователей и раздел "Склад" (требует доработки).

Основные задачи для реализации

1. Модуль "Сборочные задания"

Отображение списка поставок с маркетплейсов. Реализация фильтрации по ролям - каждый сотрудник видит только свои задания.
Детальная карточка поставки с отображением по каждой позиции: фотография, цвет, размер, артикул, идентификаторы товара (nmId/sku), номер задания.
Внедрение постадийного контроля через чекбоксы: "Напечатал" (Печать), "Прижал" (Пресс), "Упаковал" (Упаковка).
Обработка статусов "Отмена" / "Отсутствует" - такие позиции автоматически перемещаются в раздел "Неподбор".
Реализация массовых операций над заданиями и ведение журнала изменений.
Функционал пересборки (рекомплектации) поставок на основе заданных фильтров.

2. Модуль "Неподбор" (Буферная зона)

Создание буфера для позиций, которые не подошли под фильтры автоматической сборки или отмечены как отсутствующие.
Таблица с указанием причины попадания в буфер.
Действия над позициями: "Перераспределить" (запуск пересборки), "Назначить вручную", мастер создания нового правила фильтрации на основе конкретной позиции.
Система гибких фильтров для формирования поставок: маркетплейс, категория/группа товара, цвет/размер, бренд, префиксы артикула, теги, привязка к отделу, приоритет, лимит на размер партии.

3. Система ролевого доступа (RBAC)

Определение ролей: Печать, Пресс, Упаковка, Склад, Оператор, Администратор.
Реализация авторизации на бэкенде с использованием JWT и защитой маршрутов (Guards).
Адаптация фронтенда: скрытие разделов интерфейса и действий, не доступных текущей роли пользователя.

4. Доработка модуля "Склад"

Исправление логики списаний.
Автоматическое резервирование товара при создании сборочного задания.
Фактическое списание при подтверждении этапа "Упаковал". Возврат резерва при отмене задания.
Внедрение защиты от образования отрицательных остатков на складе.
Проектирование и доработка структуры таблиц: stock_items (остатки), stock_reservations (резервы), stock_movements (движения).
Обеспечение идемпотентности складских операций для предотвращения дублирования.

5. Интеграция с системой маркировки "Честный ЗНАК" (КИЗ)

Создание системы шаблонов для печати этикеток в зависимости от категории товара.
Функционал печати этикеток в формате PDF или напрямую на принтер.
Механизм привязки уникальных кодов маркировки (КИЗ) к позициям в заказах.
Организация списания кодов из оборота при печати или упаковке (требует уточнения логики).
Ведение полного аудита всех операций с кодами маркировки.

Технические требования

Фронтенд: React + Vite + Ant Design (используется алиас @ для путей).
Бэкенд: NestJS + Sequelize (ORM) + PostgreSQL.
Инфраструктура: nginx в качестве веб-сервера.
Код должен быть чистым, документированным и соответствовать принципам выбранных фреймворков.

проектирование