2026-09-29 — Склад в ИС
Статус: Реализовано (ядро склада, v1)
Источник / заказчик: Алексей
Эпик: ITR-3158
Связанные материалы:
- текущий рабочий инструмент: standalone
ProductBalanceForm(Google Sheets); - склад и продукция (user guide);
- права: склад;
- доменная модель (черновик): SKU, остатки, история изменений, заявка, резерв материалов;
- аналог стратегии точки истины: изделия ↔ Google;
- приоритет относительно выгрузки в 1С: см. export-1c.md;
- заказ на производство / Google-шаблон: googleTable.md, резерв материалов.
Итог реализации (ядро)
Ядро склада выпущено. Что получил пользователь:
- Раздел «Склад» в меню: Остатки, Журнал движений, справочник складских учётных единиц.
- Остатки по Рязани: количество, единица, категория, тип, минимум по площадке; строка подсвечивается, если остаток ниже минимума. Из строки можно открыть карточку складской единицы на просмотр (кроме изделий).
- Минимум задаётся и сбрасывается в модалке по клику на значение в колонке «Минимум».
- Складская операция (приход / расход / инвентаризация) из экрана остатков: складская единица, количество, по возможности заказ на производство (в списке — номер и наименование), поставщик, примечание. Расход больше остатка не проходит.
- Журнал движений: дата, тип, складская единица, количество, остаток после операции, заказ на производство, контрагент, автор, примечание; фильтры и сортировка в таблице.
- Зеркало в 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)
- Смотреть остатки по Рязани: количество, единица, минимум по площадке; при остатке ниже минимума — заметная подсветка.
- Задать минимум по площадке для SKU — с экрана остатков, модалка (не карточка SKU, не форма приход/расход); сброс = пустое значение.
- Приход — выбрать SKU, количество, по возможности заказ на производство, опционально контрагент / примечание → остаток растёт, в журнал пишется операция.
- Расход — то же; нельзя списать больше остатка. Операция без заказа на производство допустима.
- Инвентаризация — зафиксировать фактическое количество; разница отражается в истории.
- Журнал — фильтр по SKU / дате / типу / заказу; без ручной «починки» остатков.
- Зеркало в 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 и следующим эпикам)
- Cutover пользователей: сразу после приёмки ядра, после комплектации, или позже?
- Способ закрытия правки Google — согласовать с Алексеем (владелец таблицы): защита листов
Остатки/пр/расход, отзыв прав редакторов, или комбинация; сервисный аккаунт ИС сохраняет право писать зеркало. - Как сейчас строки из ведомостей материалов / комплектации файла заказа на производство попадают в складские листы
Комплектация/Скомплектовано(руками, формула, скрипт)? - В эпике комплектации: переносим в ИС работу прямо по заказу на производство (карточка заказа), или сначала зеркало агрегированных складских листов как в ProductBalanceForm?
- Резерв материалов (колонки «зарезервирован / дефицит») — внутри эпика комплектации или отдельный эпик после него?
Задачи эпика
Все задачи ядра выполнены.
| # | Задача | Содержание |
|---|---|---|
| 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. Фронт. Минимум на экране остатков | Колонка, модалка, подсветка ниже минимума |