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-ресурсам заказа, чтобы:
- менеджер производства сразу видел папку заказа покупателя (документы продаж) без ручной выдачи прав и без возврата заказа на корректировку ради шаринга;
- ответственный менеджер по продажам сразу видел таблицу заказа на производство и мог контролировать состояние запущенных заказов.
Контекст
Как сейчас
- При создании заказа на производство система выдаёт чтение папки заказа покупателя сопровождающему по его Google-email (если поле заполнено). Ошибка share — только warning в лог, создание заказа не откатывается.
- При создании таблицы заказа на производство — чтение таблицы ответственному менеджеру продаж по его Google-email.
- При смене сопровождающего / ответственного доступ докидывается новому; у прежних не снимается.
- В карточке сотрудника есть поле Google-email: правит администратор пользователей; в профиле сотрудник видит только просмотр (если поле задано).
- Логин в ИС не обязан совпадать с Google-аккаунтом.
- Служебный разовый бэкофилл доступов по старым заказам — через Swagger.
Как должно быть
- При создании заказа на производство система выдаёт сопровождающему (менеджеру производства) чтение к папке заказа покупателя.
- При создании файла (таблицы) заказа на производство система выдаёт ответственному менеджеру по продажам чтение к этой таблице.
- Google-email сотрудника хранится в карточке сотрудника; по нему система понимает, кому шарить в Drive.
- При смене ответственного или сопровождающего система докидывает доступ новому человеку; у прежних доступ не снимает.
- Ошибка выдачи прав в Google не блокирует создание заказа на производство / таблицы — только предупреждение в лог.
Заказ покупателя Заказ на производство
───────────────── ─────────────────────
Папка документов Google-таблица
← создаёт продажи ← создаёт система при запуске
← reader → сопровождающий ← reader → ответственный
(менеджер производства) (менеджер продаж)
Пользовательские сценарии
- Запуск в производство. В задаче «Запуск» создаются заказы на производство и их таблицы. Сопровождающий получает чтение папки заказа покупателя; ответственный менеджер продаж — чтение таблицы заказа на производство. Ручной шаринг не нужен.
- Несколько заказов на производство по одному заказу покупателя. Папка заказа уже могла быть расшарена при первом заказе на производство. Повторная выдача тому же Google-аккаунту не ошибка: система не падает, в лог — предупреждение при «уже есть». Отдельный учёт «уже шарили» в БД не ведём.
- Смена сопровождающего. На заказе покупателя сменили менеджера производства — ему выдаётся чтение папки заказа (если папка есть). У прежнего доступ остаётся.
- Смена ответственного. Сменили менеджера продаж — новому выдаётся чтение уже существующих таблиц заказов на производство по этому заказу (и далее при создании новых). У прежнего доступ остаётся. Папку заказа при смене ответственного этот эпик не пересоздаёт и не перепривязывает (как сейчас).
- Нет Google-email у сотрудника. Выдача прав для него пропускается; в лог — предупреждение. Создание заказа на производство / таблицы не падает.
- Админ заводит Google-email. Администратор пользователей указывает Google-email на карточке сотрудника. Сотрудник в личном кабинете видит свой Google-email только для просмотра.
- Разовый прогон по старым заказам. Администратор / разработчик через служебный эндпоинт (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.