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

2026-11-09 — Автоматическая выдача прав к Google-ресурсам

Статус: Реализовано (этап 1 + этап 2: поле Google-email, share папки/таблицы по email сопровождающего и ответственного, докидывание при смене ролей, служебный бэкофилл через Swagger)

Источник: переписка по контролю заказов на производство; Олег

Эпик: ITR-3474 (этап 1 также ITR-3477)

Связанные материалы: googleTable.md, ITR-2667.md (системная Google-авторизация), roles-and-access.md, orders.md.

Цель​

Автоматически выдавать чтение нужным сотрудникам к Google-ресурсам заказа, чтобы:

  1. менеджер производства сразу видел папку заказа покупателя (документы продаж) без ручной выдачи прав и без возврата заказа на корректировку ради шаринга;
  2. ответственный менеджер по продажам сразу видел таблицу заказа на производство и мог контролировать состояние запущенных заказов.

Контекст​

Как сейчас​

  • При создании заказа на производство система выдаёт чтение папки заказа покупателя сопровождающему по его Google-email (если поле заполнено). Ошибка share — только warning в лог, создание заказа не откатывается.
  • При создании таблицы заказа на производство — чтение таблицы ответственному менеджеру продаж по его Google-email.
  • При смене сопровождающего / ответственного доступ докидывается новому; у прежних не снимается.
  • В карточке сотрудника есть поле Google-email: правит администратор пользователей; в профиле сотрудник видит только просмотр (если поле задано).
  • Логин в ИС не обязан совпадать с Google-аккаунтом.
  • Служебный разовый бэкофилл доступов по старым заказам — через Swagger.

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

  • При создании заказа на производство система выдаёт сопровождающему (менеджеру производства) чтение к папке заказа покупателя.
  • При создании файла (таблицы) заказа на производство система выдаёт ответственному менеджеру по продажам чтение к этой таблице.
  • Google-email сотрудника хранится в карточке сотрудника; по нему система понимает, кому шарить в Drive.
  • При смене ответственного или сопровождающего система докидывает доступ новому человеку; у прежних доступ не снимает.
  • Ошибка выдачи прав в Google не блокирует создание заказа на производство / таблицы — только предупреждение в лог.
Заказ покупателя                         Заказ на производство
───────────────── ─────────────────────
Папка документов Google-таблица
← создаёт продажи ← создаёт система при запуске
← reader → сопровождающий ← reader → ответственный
(менеджер производства) (менеджер продаж)

Пользовательские сценарии​

  1. Запуск в производство. В задаче «Запуск» создаются заказы на производство и их таблицы. Сопровождающий получает чтение папки заказа покупателя; ответственный менеджер продаж — чтение таблицы заказа на производство. Ручной шаринг не нужен.
  2. Несколько заказов на производство по одному заказу покупателя. Папка заказа уже могла быть расшарена при первом заказе на производство. Повторная выдача тому же Google-аккаунту не ошибка: система не падает, в лог — предупреждение при «уже есть». Отдельный учёт «уже шарили» в БД не ведём.
  3. Смена сопровождающего. На заказе покупателя сменили менеджера производства — ему выдаётся чтение папки заказа (если папка есть). У прежнего доступ остаётся.
  4. Смена ответственного. Сменили менеджера продаж — новому выдаётся чтение уже существующих таблиц заказов на производство по этому заказу (и далее при создании новых). У прежнего доступ остаётся. Папку заказа при смене ответственного этот эпик не пересоздаёт и не перепривязывает (как сейчас).
  5. Нет Google-email у сотрудника. Выдача прав для него пропускается; в лог — предупреждение. Создание заказа на производство / таблицы не падает.
  6. Админ заводит Google-email. Администратор пользователей указывает Google-email на карточке сотрудника. Сотрудник в личном кабинете видит свой Google-email только для просмотра.
  7. Разовый прогон по старым заказам. Администратор / разработчик через служебный эндпоинт (Swagger) один раз доназначает доступы по уже существующим заказам по тем же правилам.

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

ТемаРешение
Роль доступа в GoogleТолько чтение (reader)
Кому папка заказа покупателяСопровождающий (менеджер производства)
Кому таблица заказа на производствоТолько ответственный менеджер по продажам
Помощник ответственногоНе выдаём доступ к таблице
Google-emailОтдельное поле у сотрудника
Кто редактирует Google-emailАдминистратор пользователей (карточка сотрудника)
Кто видит Google-emailСотрудник — просмотр в личном кабинете
Смена Responsible / MaintainerСразу докидывать доступ новому; старых не снимать
Ошибка Google ShareТолько warning в лог; создание ЗнП / таблицы не откатывается
Повторный share тому же emailИдемпотентно: «уже есть» → лог, без падения; флаг в БД не нужен
Уведомления Google о шарингеПо возможности не слать письмо пользователю (служебная выдача)
Часть 1 (быстрый шаг)Хардкод Google-email Мягкова для выдачи на папку при создании ЗнП (email известен)
Часть 2Поле Google-email + выдача таблицы продажам + часть 1 без хардкода (по email сопровождающего)
Бэкофилл старых заказовОтдельная задача: разовый эндпоинт через Swagger
Объём бэкофиллаПо правилам эпика: папка → сопровождающий; таблица ЗнП → ответственный; без снятия старых ACL

Этапы поставки​

Этап 1 (сделано ранее)
Создание ЗнП → reader папки заказа → хардкод-email (временный шаг)

Этап 2 (сделано)
Поле Google-email (админ правит, сотрудник смотрит)
Создание таблицы ЗнП → reader → ответственный (по Google-email)
Папка заказа → reader → сопровождающий (по Google-email, хардкод убран)
Смена ответственного / сопровождающего → докинуть доступ
Разовый бэкофилл (Swagger)

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

  • При создании заказа на производство сопровождающий получает чтение папки заказа покупателя по Google-email сопровождающего.
  • При создании таблицы заказа на производство ответственный менеджер продаж получает чтение этой таблицы.
  • Помощник ответственного доступ к таблице этим эпиком не получает.
  • При смене сопровождающего / ответственного новый сотрудник получает нужный доступ; у прежних доступ не снимается.
  • Ошибка выдачи прав не блокирует создание заказа на производство; есть запись в лог.
  • Повторная выдача тому же аккаунту не ломает процесс.
  • Администратор пользователей может задать и изменить Google-email сотрудника; сотрудник видит его в личном кабинете только для просмотра.
  • Есть служебный эндпоинт разового бэкофилла по старым заказам (запуск через Swagger).
  • Обновлены user docs / карта по Google и карточке сотрудника.

Вне scope​

  • Выдача прав помощникам, начальнику продаж, снабжению и прочим ролям на эти ресурсы.
  • Снятие доступа при смене ответственного / сопровождающего.
  • Перенос или пересоздание папки заказа при смене ответственного.
  • Расширение системных OAuth-scope / смена модели авторизации Google (ITR-2667) — только использование уже доступного клиентского доступа для share.
  • Массовый UI «перешарить все заказы» для пользователей (только служебный разовый эндпоинт).
  • Изменение логики назначения сопровождающего (хардкод Мягкова как исполнителя) — отдельно; здесь только email для Drive на этапе 1.

Открытые вопросы​

Нет. Решения по переписке и разбору зафиксированы выше.

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

#ЗадачаСодержание
1Задача 1. Бек. Выдача чтения папки заказа при создании ЗнП (хардкод)При создании заказа на производство — reader на папку заказа покупателя Google-email Мягкова; ошибка → только лог; идемпотентность
2Задача 2. Бек. Поле Google-email у сотрудникаХранение; чтение/запись API для администратора пользователей; отдача для просмотра в профиле
3Задача 3. Фронт. Google-email в карточке сотрудника и в ЛКРедактирование — администратор пользователей; в личном кабинете — только просмотр
4Задача 4. Бек. Таблица ЗнП продажам + папка без хардкода + смена ролейReader таблицы → ответственный; папка → сопровождающий по Google-email; докидывание при смене Responsible / Maintainer
5Задача 5. Бек. Разовый бэкофилл через SwaggerСлужебный эндпоинт: по существующим заказам выдать доступы по правилам эпика
6Задача 6. Документация. User docs и картаПрофиль / сотрудник, Google-ресурсы заказа, cursor-architecture — сделано

Порядок: 1–6 закрыты по выкладке этапа 2.