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 | Без подтверждения простоев и настроек |