Раздел предназначен для просмотра всех ролей (системных и кастомных), существующих в системе, а также для создания, редактирования и удаления кастомных ролей. Кастомные роли позволяют гибко настраивать права доступа сотрудников в соответствии с потребностями ресторана.

Чтобы перейти к управлению ролями, найдите в боковой панели навигации раздел «Управление пользователями» и выберите подраздел «Роли» (рис. 1).

Раздел состоит из таблицы со списком всех ролей — системных и кастомных (если вы ранее создавали кастомные роли) (рис 2).

Под каждой ролью в таблице отображаются доступные разделы и страницы с соответствующей цветовой индикацией:

• Зелёный — все действия (создание, редактирование, удаление)
• Оранжевый — только просмотр (пользователь имеет доступ только к просмотру раздела без возможности редактирования)

Над ролями и разделами отображается текст с пояснением цветовой гаммы.

Важно: Для системных ролей все разделы обозначены зелёным цветом, так как по умолчанию у них определён доступ ко всем действиям. Системные роли нельзя редактировать и удалять — у них отсутствуют иконки редактирования.

Все роли (как системные, так и кастомные) имеют доступ к просмотру личного кабинета (профиля пользователя) — эта страница доступна по умолчанию.

Для создания новой кастомной роли нажмите кнопку «Добавить» (рис. 3). Откроется форма создания на отдельной веб-странице.

Название — обязательное поле. Значение должно содержать от 2 до 50 символов. Допустимы буквы кириллицы и латиницы, цифры, пробелы и дефисы. Запрещено использование специальных символов: @ # $ %.

В форме отображается таблица со всеми разделами и страницами системы. Для каждого раздела или страницы можно настроить доступ с помощью чекбоксов:

• «Создание, редактирование, удаление» — предоставляет полные права на выполнение всех активных действий
• «Просмотр» — предоставляет только право на просмотр раздела или страницы без возможности редактирования

Особенности работы с таблицей:

• При выборе чекбокса раздела система автоматически проставляет доступ к созданию, редактированию и удалению на все страницы этого раздела.
• При выборе конкретной страницы чекбокс на весь раздел не проставляется.
• При отключении чекбокса раздела система автоматически отключает все доступы на всех страницах выбранного раздела.
• Если вы выбираете «Создание, редактирование, удаление», столбец «Просмотр» автоматически выбирается и становится заблокированным (так как активные действия уже включают возможность просмотра).
• Нельзя одновременно выбрать оба чекбокса для одной страницы — это противоречит бизнес-логике.
• Разделы и страницы не обязательны для выбора — вы можете пропустить раздел, не обозначив никакого действия. Однако система не даст создать кастомную роль вообще без доступных пермишенов.

После заполнения названия и настройки доступов нажмите кнопку «Сохранить». Созданная роль будет сохранена в системе и станет доступна для назначения пользователям.

Важные проверки при сохранении:

• Уникальность набора доступов. Если набор полностью совпадает с любой системной ролью, система блокирует сохранение и отображает сообщение: «С выбранным набором доступов уже существует роль: "[Название существующей роли]". Пожалуйста, измените набор доступов для новой роли или отредактируйте существующую».
• Запрет дублирования. Нельзя создавать кастомные роли с одинаковым названием или с разными названиями, но одинаковыми наборами прав доступа.
• Блокировка кнопки «Сохранить». Кнопка «Сохранить» остаётся неактивной до тех пор, пока не заполнено обязательное поле «Название» и не устранены конфликтующие совпадения доступов.

Если вы заполнили часть полей, но не сохранили роль и пытаетесь закрыть страницу, система отобразит модальное окно с текстом: «Вы уверены, что хотите покинуть страницу? Внесённые изменения не сохранятся». В этом окне вы можете нажать «Отмена», чтобы остаться на странице и продолжить заполнение, или «Покинуть без сохранения», чтобы закрыть страницу — тогда все введённые данные будут потеряны. Модальное окно не появляется, если вы не вносили никаких изменений в форму.

При успешном сохранении появится уведомление об успешном создании роли, и новая запись отобразится в таблице ролей.

Для редактирования кастомной роли в таблице в строке необходимой роли нажмите на иконку карандаша (рис. 5). Откроется форма с предзаполненными настройками, доступными для редактирования.

Вы можете полностью изменить существующую роль:

• Изменить название роли
• Изменить доступные разрешения в таблице пермишенов

После внесения изменений нажмите кнопку «Сохранить» (рис.6) .

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

Если вы внесли изменения в доступные для редактирования поля, но не сохранили их и пытаетесь закрыть страницу, система отобразит модальное окно с текстом: «Вы уверены, что хотите покинуть страницу? Внесённые изменения не сохранятся.» В этом окне вы можете нажать «Отмена», чтобы остаться на странице и продолжить редактирование, или «Покинуть без сохранения», чтобы закрыть страницу без сохранения изменений. Модальное окно не появляется, если изменения не вносились (рис.6)

После внесения необходимых изменений нажмите кнопку «Сохранить». При успешном сохранении система покажет уведомление об успешном сохранении, а обновлённые данные отобразятся в реестре.

Удалить кастомную роль можно только в режиме редактирования. Откройте карточку роли и нажмите кнопку «Удалить» (рис. 8).

Перед удалением система проверяет, назначена ли эта роль хотя бы одному пользователю:

• Если роль не назначена никому. Система отображает модальное окно с текстом: «Вы уверены, что хотите удалить роль "[Название роли]"» (рис. 8). Нажмите «Удалить» для подтверждения или «Отменить» для отмены.
• Если роль назначена одному или нескольким пользователям. Система блокирует операцию удаления и отображает модальное окно с информационным сообщением : «Удаление невозможно. Эта роль назначена [X] пользователю(ям). Чтобы удалить роль, сначала назначьте этим пользователям другие роли».

Блокировка удаления — роль назначена пользователям

В этом окне доступны кнопки:

• «Отмена» — модальное окно закрывается, удаление не происходит.
• «Перейти» — система переводит пользователя на страницу создания пользователя (со списком пользователей, сразу отфильтрованных по удаляемой роли).

После подтверждения удаления (если роль не назначена пользователям) учётная запись роли будет удалена, а таблица ролей автоматически обновится.