2026-09-16 — Одно изделие ↔ Google «Список изделий» (смена точки истины, шаг 1)
Статус: Реализовано
Источник: Максим
Эпик: ITR-3049
Связанные задачи: ITR-3051 / ITR-3052 (бек), ITR-3053 (фронт).
Стратегия (за рамками этого эпика): постепенно сделать информационную систему точкой истины по изделиям; Google-таблицу «Список изделий» — зеркалом. Позже запись в Google закроем, останется автоматическая выгрузка из системы.
Цель
Дать возможность по одному изделию:
- записать данные из системы в Google («Список изделий») — чтобы строка в таблице соответствовала карточке в ИС;
- подтянуть данные из 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.
- Импорт/экспорт складских единиц, остатков, контрагентов.
- Изменение процесса создания изделия / согласования КД.