Перейти к основному содержимому

2026-09-29 — Склад в ИС

Статус: Реализовано (ядро склада, v1)

Источник / заказчик: Алексей

Эпик: ITR-3158

Связанные материалы:

Итог реализации (ядро)​

Ядро склада выпущено. Что получил пользователь:

  • Раздел «Склад» в меню: Остатки, Журнал движений, справочник складских учётных единиц.
  • Остатки по Рязани: количество, единица, категория, тип, минимум по площадке; строка подсвечивается, если остаток ниже минимума. Из строки можно открыть карточку складской единицы на просмотр (кроме изделий).
  • Минимум задаётся и сбрасывается в модалке по клику на значение в колонке «Минимум».
  • Складская операция (приход / расход / инвентаризация) из экрана остатков: складская единица, количество, по возможности заказ на производство (в списке — номер и наименование), поставщик, примечание. Расход больше остатка не проходит.
  • Журнал движений: дата, тип, складская единица, количество, остаток после операции, заказ на производство, контрагент, автор, примечание; фильтры и сортировка в таблице.
  • Зеркало в Google: после каждой операции обновляется строка листа остатков и дописывается строка в пр/расход. Ошибка Google не отменяет операцию в ИС.
  • Права: операции и минимум — снабженец; просмотр остатков и журнала — снабженец и админ (только чтение).
  • Попутно для работы снабженца: просмотр справочника складских единиц (без действий над изделиями), работа с основной карточкой контрагентов-поставщиков и «прочих отношений».

Глазов в селекторе площадки виден, но выключен — следующий этап. Комплектация, обрезки, ОТК — следующие эпики (см. нарезку ниже).

Цель​

Перенести рабочий учёт склада из Google Sheets (ProductBalanceForm) в ИС: остатки и движения живут в системе, операции атомарны, номенклатура — из справочника складских единиц. Дальше — опора для комплектации, обрезков, резервов и связи с заказами.

Контекст​

Как сейчас (ProductBalanceForm + Google Sheets)​

Отдельное SPA поверх двух таблиц Google (склад + ОТК). Ролей в приложении нет — доступ = права на саму таблицу.

ЭкранЧто делает пользователь
Форма складских операцийПриход / расход / инвентаризация по номенклатуре; опционально заказ, контрагент, примечание
ОбрезкиПри расходе в погонных метрах — указать длину обрезка; обрезки становятся отдельными позициями остатка
Списание по комплектацииВыбрать позиции «скомплектовано» по заказу → выдать получателю → списать со склада
КомплектацияСмотреть лист комплектации, править «собрано»
Таблица операцийЖурнал приход/расход + сверка с листом остатков (починка расхождений)

Модель в таблицах (упрощённо):

  • справочники: номенклатура, контрагенты, заказы, список материалов, получатели комплектации;
  • Остатки — снимок количества по имени (не формула из журнала);
  • пр/расход — журнал операций + «остаток после» в строке;
  • Комплектация / Скомплектовано — производственный контур на тех же таблицах;
  • при приходе материала из «Списка материалов» — строка во «Входной контроль» ОТК.

Листы Google (ProductBalanceForm)​

Две книги: склад (spreadsheetId) и ОТК (spreadsheetOtkId).

КнигаЛистНазначениеЭкраны
СкладНоменклатураСправочник позиций (имя, единица)Form A
СкладКонтрагентыВыбор контрагента при операцииForm A
СкладОстаткиТекущее количество по имениForm A, Form B, журнал, обрезки
СкладзаказыНомера заказов для выбораForm A
Складпр/расходЖурнал приход / расход / инвентаризацияForm A, Form B, журнал, обрезки
СкладСписок материаловПризнак: приход → ещё и во входной контроль ОТКForm A
СкладОбрезкиСправочник/учёт кусков L=…ммОбрезки
СкладКомплектацияСтатусы сборки по заказу («собрано» и др.)Form C
СкладСкомплектованоПозиции к выдаче со складаForm B
СкладПолучатели комплектацииКому выдалиForm B
ОТКВходной контрольСтрока при приходе материала из спискаForm A (приход)

Для ядра (v1) в зеркале ИС → Google участвуют листы Остатки и пр/расход той же складской книги. Остальные листы — у последующих эпиков (комплектация, обрезки, ОТК) или остаются справочниками Google на переходный период.

ИС уже читает остатки из книги «Склад Рязань», лист Остатки (массовый импорт); номенклатуру материалов — из отдельной книги «Список материала».

Листы в файле заказа на производство (шаблон Google)​

При создании заказа на производство ИС копирует шаблон и заполняет только листы заказ и передаточный. Вместе с копией в файл попадают (и живут дальше вручную) листы ведомостей — по ним склад понимает потребность и отмечает сборку.

Лист (по смыслу / примеру)Заголовок в примереКто заполняет сейчасЧто делает склад
Материалы«Ведомость материалов»Конструктор / технолог (вручную в Google)Видит потребность; колонки резерва / дефицита (зарезервирован, зарезервировано, дифицит)
Комплектация«Комплектовочная ведомость»Конструктор (вручную)Отмечает / смотрит скомплектовано, собрано, не хватает, выдано

Пример колонок материалы: материал, кол-во, ед., размер1, размер2, примечание, зарезервирован, зарезервировано, дефицит; шапка — № заказа, «зарезервировать до», «проверено».

Пример колонок комплектация: наименование, кол., ед., скомплектовано, собрано, не хватает, выдано; шапка — № заказа, «скомплектовать до», даты проверки/комплектовки.

Связь со складской книгой: в коде ИС и ProductBalanceForm нет прямой записи в эти листы файла заказа на производство. Складской SPA работает с агрегированными листами Комплектация / Скомплектовано в книге склада (связь по номеру заказа текстом). Как строки из файла заказа на производство попадают в складскую книгу (ручной перенос, IMPORTRANGE, скрипт) — уточнить у Алексея; в репозитории этого нет.

В доменной модели ИС уже намечен резерв материалов (MaterialInReserve: количество, размеры, статус резерва) — по смыслу близок к ведомости материалов, но сейчас только read-only API, без UI и без синка с Google.

Вывод для нарезки: ведомости заказа на производство — не scope ядра (Form A), но обязательный контекст эпика комплектации (и позже резервов). Ядро при проектировании связи операции с заказом ориентировать на заказ на производство, иначе комплектацию потом придётся ломать.

Проблемы текущего подхода: гонки при одновременной записи, неатомарность (журнал и остатки могут разъехаться), нет ролей ИС, дублирование номенклатуры с ИС по имени, обрезки как отдельные «имена» без нормальной модели; три разрозненных Google-контура (файл заказа на производство / складская книга / ProductBalanceForm) без единой точки истины.

Как было в ИС до эпика​

  • Справочник складских единиц (SKU) — CRUD + импорт материалов из Google.
  • Остатки по площадкам (Рязань / Глазов) — есть в БД, массовый импорт из Google «Склад Рязань»; экрана остатков и ручных операций нет.
  • История изменений количества — сущность задумана в модели, API/UI нет.
  • Резерв материалов — read-only API, UI нет.
  • Заявки на складскую единицу — в docs, реализации нет.

Источник правды по остаткам сейчас фактически Google; ИС подтягивает снимок.

Как должно быть​

  • Источник правды по остаткам и движениям — ИС.
  • Операции приход / расход / инвентаризация пишут историю и атомарно меняют остаток.
  • Номенклатура — складская единица ИС.
  • Площадка первого контура — только Рязань; Глазов — после отладки на Рязани.
  • Google Sheets на переходный период: запрет ручного редактирования остатков/журнала (как стратегия с изделиями); синхронизация ИС → Google остаётся, пока функционал в ИС не отлажен. Затем пользователи полностью работают в ИС.
  • Комплектация и обрезки — отдельные последующие эпики (порядок: сначала комплектация, затем обрезки), не в первом релизе.

Пользовательские сценарии (эпик ядра / v1)​

  1. Смотреть остатки по Рязани: количество, единица, минимум по площадке; при остатке ниже минимума — заметная подсветка.
  2. Задать минимум по площадке для SKU — с экрана остатков, модалка (не карточка SKU, не форма приход/расход); сброс = пустое значение.
  3. Приход — выбрать SKU, количество, по возможности заказ на производство, опционально контрагент / примечание → остаток растёт, в журнал пишется операция.
  4. Расход — то же; нельзя списать больше остатка. Операция без заказа на производство допустима.
  5. Инвентаризация — зафиксировать фактическое количество; разница отражается в истории.
  6. Журнал — фильтр по SKU / дате / типу / заказу; без ручной «починки» остатков.
  7. Зеркало в Google — после операции в ИС обновляются Остатки и в пр/расход дописывается строка операции; ручная правка таблицы закрыта.

Принятые решения​

ТемаРешение
Нарезка релизовПоследовательно: ядро (Form A) → прод и приёмка → комплектация → приёмка → обрезки → …; не смешивать контуры в одном релизе
Перевод пользователейПосле приёмки ядра и комплектации — кандидат на cutover ежедневной работы в ИС (уточнить с заказчиком); обрезки — следующим эпиком
Площадка v1Только Рязань; Глазов после отладки
Миграция данных на стартеТолько текущие остатки (см. оценку истории ниже); лист пр/расход остаётся архивом в Google на переходный период
Google после включения ИСКак с изделиями: закрыть ручное редактирование в таблице; оставить выгрузку ИС → Google, пока функционал не отлажен
Зеркало ИС → GoogleПосле каждой операции: обновить лист Остатки и дописать строку в пр/расход (не только снимок остатков)
НоменклатураСкладская единица ИС, не свободная строка листа
Связь операции с заказом (ядро)По возможности привязка к заказу на производство (id / выбор из существующих); поле опциональное — операция без заказа допустима
Минимальный остатокХранится и правится по площадке (SKU + местоположение), не на карточке SKU. UX: колонка на экране остатков + модалка редактирования; не журнал движений; в v1 без зеркала минимума в Google. API правки: skuId + locationId + requiredMinimum (пусто = сброс)
Жизненный цикл этого файлаСтатус → Реализовано и перенос в sidebar после приёмки ядра, не после всей программы склада. Таблица нарезки и ссылки на следующие эпики в файле остаются как карта

Оценка: перенос истории пр/расход​

Только остатки — уже почти есть (импорт по имени SKU в Рязань): разовый снимок + сверка. Для старта ядра этого достаточно: новый журнал в ИС начинается с cutover.

Полный перенос истории заметно тяжелее и почти не нужен для работы склада «с сегодня»:

ФакторВлияние
Объём и качество строкМного строк; имена с опечатками; обрезки L=…мм; запятые в числах
СопоставлениеКаждая строка → SKU по имени (как остатки, но ×N); заказ и контрагент — свободный текст, не надёжный FK
Семантика операцийИнвентаризация = «стало N», приход/расход = дельта; в модели ИС сейчас только «изменение + основание» — поля типа операции, заказа, контрагента нужно расширять до импорта
СогласованностьЦепочка по имени может не сходиться с текущим остатком; нужна политика «кому верить»
ЦенностьДля ежедневной работы после cutover достаточно текущего остатка; старый журнал смотрят редко → Google как read-only архив

Ориентир трудозатрат (порядок, не оценка карточки):

  • только остатки — малая добавка к ядру (дожать импорт/сверку, зафиксировать Рязань);
  • «мягкий» архив истории (дата, тип, имя→SKU если нашлось, qty, примечание текстом, без жёстких связей) — заметный отдельный кусок (импортёр + расширения полей + разбор мусора), сопоставим с частью ядра;
  • полная история с заказами/контрагентами — отдельный мини-эпик, высокий риск «грязных» данных, слабая отдача.

Решение разведки: в v1 не переносим историю; Google пр/расход — архив. Пересмотр только если заказчику критичен поиск старых операций уже внутри ИС в день cutover.

Предложение по нарезке эпиков​

№ЭпикСодержаниеКогда пользователи
1Ядро склада (ITR-3158)Остатки UI (Рязань), приход/расход/инвентаризация, журнал, права, импорт остатков, ИС → Google (Остатки + пр/расход), закрытие ручной правки GoogleПриёмка в проде
2Комплектация (ITR-3288)Ведомости заказа на производство (материалы + комплектация) + сбор / выдача / расход; без закупок и полного резерва. ТЗ: warehouse-kitting.md. Чат ЗнП — отдельно: manufacture-order-chat.md (ITR-3378)После приёмки ядра — кандидат на cutover
3ОбрезкиУчёт кусков при расходе погонных метровПосле комплектации
4+ОТК, Глазов, резервы/заявкиПо очереди—

Оптимизации относительно ProductBalanceForm​

  • Атомарная операция: журнал + остаток в одной транзакции.
  • Без экрана ручной «починки» остатков.
  • Права ролей ИС.
  • Поиск/фильтры по справочникам и id, не по выгрузке листа.
  • Не тащить в v1: Client ID в UI, запись браузером в Sheets, комплектацию, обрезки, ОТК, Глазов.

Критерии приёмки (ядро)​

  • Пользователь с нужной ролью видит остатки по Рязани в ИС (в т.ч. минимум по площадке).
  • Снабженец может задать / сбросить минимум с экрана остатков (модалка); ниже минимума — заметно.
  • Приход / расход / инвентаризация меняют остаток и появляются в журнале.
  • Расход больше остатка отклоняется.
  • Без роли — операции и правка минимума недоступны.
  • После операции в Google обновляются Остатки и появляется новая строка в пр/расход.
  • Ручная правка складских листов Google закрыта (или согласован эквивалент защиты) — организационный шаг владельца таблицы, вне кода ИС.
  • Стартовые остатки загружены/сверены с Google на момент включения.

Вне scope (ядро)​

  • Комплектация и списание по комплектации (отдельный эпик).
  • Обрезки (отдельный эпик).
  • ОТК / входной контроль.
  • Глазов.
  • Перенос истории пр/расход в ИС.
  • Ячейки / адресация / штрихкоды.
  • Выгрузка склада в 1С.
  • Замена справочника SKU.

Открытые вопросы (к cutover и следующим эпикам)​

  1. Cutover пользователей: сразу после приёмки ядра, после комплектации, или позже?
  2. Способ закрытия правки Google — согласовать с Алексеем (владелец таблицы): защита листов Остатки / пр/расход, отзыв прав редакторов, или комбинация; сервисный аккаунт ИС сохраняет право писать зеркало.
  3. Как сейчас строки из ведомостей материалов / комплектации файла заказа на производство попадают в складские листы Комплектация / Скомплектовано (руками, формула, скрипт)?
  4. В эпике комплектации: переносим в ИС работу прямо по заказу на производство (карточка заказа), или сначала зеркало агрегированных складских листов как в ProductBalanceForm?
  5. Резерв материалов (колонки «зарезервирован / дефицит») — внутри эпика комплектации или отдельный эпик после него?

Задачи эпика​

Все задачи ядра выполнены.

#ЗадачаСодержание
1Задача 1. Бек. Схема БД под операции складаРасширение истории остатков (и при необходимости FK); миграция; без бизнес-API
2Задача 2. Бек. Операции остатка: сервис и APIПриход / расход / инвентаризация, остатки Рязань, журнал, права; тесты через эндпоинты
3Задача 3. Бек. Импорт остатков и зеркало ИС → GoogleСтартовый снимок; после операции — Остатки + append пр/расход
4Задача 4. Фронт. Экран остатков (Рязань)Таблица остатков, права, навигация в группе «Склад»
5Задача 5. Фронт. Форма складской операцииПриход / расход / инвентаризация, выбор SKU и заказа на производство
6Задача 6. Фронт. Журнал операцийСписок с фильтрами, без ручной «починки» остатков
7Задача 7. Документация. User docs, права, картаUser guide, rights, cursor-architecture; чеклист закрытия правки Google с Алексеем
8Задача 8. Бек. API минимального остатка по площадкеEndpoint правки: skuId + locationId + requiredMinimum (пусто = сброс); без журнала; права; тесты
9Задача 9. Фронт. Минимум на экране остатковКолонка, модалка, подсветка ниже минимума