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

2026-09-16 — Одно изделие ↔ Google «Список изделий» (смена точки истины, шаг 1)

Статус: Реализовано

Источник: Максим

Эпик: ITR-3049

Связанные задачи: ITR-3051 / ITR-3052 (бек), ITR-3053 (фронт).

Стратегия (за рамками этого эпика): постепенно сделать информационную систему точкой истины по изделиям; Google-таблицу «Список изделий» — зеркалом. Позже запись в Google закроем, останется автоматическая выгрузка из системы.

Цель​

Дать возможность по одному изделию:

  1. записать данные из системы в Google («Список изделий») — чтобы строка в таблице соответствовала карточке в ИС;
  2. подтянуть данные из Google в систему — чтобы обновить карточку изделия по строке таблицы, не запуская полную синхронизацию всего списка.

Контекст (как было)​

  • Справочник изделий и Google «Список изделий» были связаны только массовой синхронизацией (чтение из таблицы в ИС).
  • Точечных действий «одно изделие в Google / из Google» не было.
  • Точка истины по факту — Google.

Поведение (как сейчас)​

  • На карточке изделия и в модалке просмотра — действия «В Google» и «Из Google» (только для уже сохранённого изделия, не на создании).
  • В Google: обновить строку по номенклатуре или создать, если строки нет; при дублях номенклатуры в таблице — ошибка. Если в ИС Описание пустое — в колонку «Описание» Google пишется текст из пользовательских параметров; иначе — поле Описание.
  • Из Google: обновить выбранную карточку по строке таблицы; нет строки / дубли / невалидные параметры — ошибка, без частичной записи.
  • Сопоставление — по номенклатуре (= имя). Набор полей — как у массовой синхронизации.
  • Вызов только ручной. Полная синхронизация списка сохранена (начальник менеджеров).
  • Права API / кнопки: конструктор, главный конструктор, начальник менеджеров. Доступ конструкторов к справочнику изделий в UI (/products) — отдельный анализ, в этом эпике не меняли; на практике кнопками с карточки/модалки сейчас пользуется в первую очередь начальник менеджеров.
Было                     Этот эпик (сделано)        Дальше (следующие эпики)
─────────────── ───────────────── ────────────────────────
Google → ИС (массово) ИС ↔ Google (по 1 шт.) ИС → Google (авто)
точка истины: Google ещё обе стороны точка истины: ИС
запись в Google закрыта

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

ТемаРешение
Объём обменаОдно изделие за действие, не весь список
НаправленияОба: ИС → Google и Google → ИС
ТаблицаТа же «Список изделий», что и для массовой синхронизации
Ключ сопоставленияНоменклатура (= имя изделия)
Дубли в таблицеНесколько строк с одной номенклатурой → ошибка
ИС → Google, нет строкиСоздать строку
Google → ИС, нет строкиОшибка, карточку не обновляем
Невалидные параметрыОшибка, без частичной записи
Описание при «в Google»Пустое в ИС → из пользовательских параметров; иначе — Описание как есть
UIКарточка изделия + модалка просмотра
Роли (API / кнопки)Конструктор, главный конструктор, начальник менеджеров
Доступ конструкторов к /productsВне этого эпика — отдельный анализ прав на справочник
Полная синхронизацияОставлена
Авто / закрытие записи в GoogleСледующие эпики

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

#ЗадачаСодержание
1Задача 1. Бек. Запись одного изделия в «Список изделий»ITR-3051/3052: export, создание/обновление строки, Описание из параметров
2Задача 2. Бек. Чтение одного изделия из «Список изделий»ITR-3051/3052: import по номенклатуре, ошибки дублей / отсутствия / валидации
3Задача 3. Фронт. Действия на карточке изделияITR-3053: «В Google» / «Из Google», права, модалка
4Задача 4. Документация. User docs и картаЭта страница, product.md, googleTable.md, cursor-architecture

Критерии приёмки​

  • По одному изделию можно записать данные из ИС в Google: обновить или создать строку; при дублях — ошибка.
  • По одному изделию можно подтянуть данные из Google в карточку; нет строки — ошибка.
  • Сопоставление по номенклатуре; дубли — ошибка.
  • Невалидные параметры — ошибка без частичной записи.
  • Пустое Описание при «в Google» → из пользовательских параметров.
  • Действия на карточке и в модалке просмотра; только ручной вызов.
  • Роли API: конструктор, главный конструктор, начальник менеджеров (вход конструкторов в справочник — отдельно).
  • Полная синхронизация списка сохранена.
  • User docs и карта обновлены; автовыгрузка / закрытие Google — следующие шаги.

Вне scope​

  • Закрытие ручного редактирования «Списка изделий» в Google.
  • Автоматическая синхронизация без ручного действия.
  • Расширение доступа конструкторов / главного конструктора к справочнику изделий в UI.
  • Импорт/экспорт складских единиц, остатков, контрагентов.
  • Изменение процесса создания изделия / согласования КД.

Связанные документы​