ModernERP EAM / Рабочая инструкция

Пользователи, роли и доступ к площадкам EAM

Выдайте доступ по ролям, организациям и площадкам и проверьте его в интерфейсе, API и отчётах.

Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.

Перед началом

Кому нужен доступ

Доверенный администратор CLI управляет пользователями и членством. Веб-интерфейс управления пользователями не подтверждён; используйте штатную команду. Администратор tenant не получает чужой tenant без отдельного membership.

Что подготовить

Tenant UUID, пользователя, роли и UUID разрешённых организаций и площадок. Для пользователя с входом по форме подготовьте пароль минимум 12 символов через переменную EAM_USER_PASSWORD.

1. Выберите существующий контур

При первом запуске допустим --new-tenant; для выдачи доступа используйте --tenant существующего контура. Одна установка ERP соответствует одному tenant EAM, внутри которого может быть несколько организаций.

Проверьте результат: UUID принадлежит нужному контуру; пользователь не оказался в пустом новом tenant по ошибке.

2. Назначьте роль по операции

Выбирайте admin, chief_mechanic, dispatcher, mechanic, production или viewer. Оператору чтения не выдавайте admin ради одного отсутствующего пункта меню. Закрытие наряда и исключения обязательных операций требуют управленческих прав.

Проверьте результат: Пользователь может выполнить нужную операцию и не получил лишние полномочия на настройки или закрытие чужих работ.

3. Ограничьте организации и площадки

Передайте оба списка grants. Для не-admin пустые списки означают отсутствие доступа, а не все площадки. Площадка должна принадлежать разрешённой организации. Фильтры списка не расширяют scope.

Проверьте результат: Тестовый пользователь читает разрешённую площадку, но не получает чужую карточку через прямой ID или CSV.

4. Учитывайте назначение механика

Механик видит назначенные наряды в своём scope и выполняет свои работы. Добавление viewer/production расширяет чтение по модели ACL, но не разрешает исполнение чужого наряда.

Проверьте результат: Чтение и исполнение проверены отдельно. Недоступная кнопка не обойдена API-запросом.

5. Сохраняйте полное членство при обновлении

app:eam:user заменяет роли и grants конкретного membership, а не добавляет к ним один флаг. Передавайте весь нужный набор при изменении доступа и ротации токена. Существующий пароль сохраняется, если новая переменная не задана.

Проверьте результат: После команды прежние нужные площадки не исчезли. Обновление API-токена не превратило пользователя в viewer без grants.

6. Разведите вход по форме и API

Браузер использует сессию, выбор /tenants и CSRF. API-only пользователь может получить токен без пароля; токен показывается один раз, хранится его хеш. Ротация заменяет предыдущий токен, revoke отзывает его.

Проверьте результат: Старый токен после ротации не работает. При нескольких memberships API явно передаёт X-Tenant-ID.

7. Разделите права обеспечения и исполнения

Планировочные роли создают потребности, резервируют и выдают материалы до начала работ. Исполнитель фиксирует расход в in_progress. Главный механик или администратор задаёт ставку и валюту, выполняет повтор неуспешной доставки и закрытие. ERP дополнительно проверяет явное складское разрешение.

Проверьте результат: Чтение каталога не разрешает складские движения. Механик видит только разрешённые назначенные работы; действия записываются в аудит.

Ограничения и ошибки

Автоматический срок истечения API-токенов не реализован: нужен принятый порядок ротации. Полный токен нельзя помещать в скриншоты, историю заявок или документацию. Команда CLI предполагает доверенный административный доступ.

Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.

Примеры и команды

Обновление scoped membership

Замените UUID и email. Команда заменяет полные списки ролей и grants. Для нового пользователя с входом по форме предварительно задайте EAM_USER_PASSWORD безопасным способом; пароль не передаётся аргументом.

php bin/console app:eam:user \
  --email=dispatcher@example.test --tenant=TENANT_UUID \
  --roles=dispatcher --organizations=ORG_UUID --sites=SITE_UUID

Кто выполняет операции

РольОсновные операцииДополнительная граница
adminНастройки, справочники, доступ, закрытиеТолько текущий tenant при наличии membership
chief_mechanicРегламенты, планы, закрытие, исключенияРазрешённые организации и площадки
dispatcherТриаж, назначение, генерация, простоиНе заменяет управленческое закрытие
mechanicПоказания, чек-лист, труд и материалыСобственные назначенные наряды
production / viewerЧтение в выданном scopeБез подтверждения простоев и настроек