> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.erlcrussia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Смены

<div id="no-header-here" />

# Настройка Системы Смен

## Что это такое?

Модуль учёта рабочего времени. Сотрудники выходят на смену кнопкой, а бот:

* выдаёт роль «на смене» и префикс в нике;
* считает отработанное время (время перерывов не засчитывается);
* проверяет выполнение **нормы часов** — своей для каждой роли или общей для всех;
* ограничивает число одновременно находящихся на смене (**лимит персонала**);
* строит рейтинги и отчёты по активности.

Команды сотрудников после настройки: `/смена управлять` — панель старта/перерыва/завершения смены, `/смена время` — личная статистика.

## Как включить

1. Откройте `/настроить` → страница **«Настройки Смен»**.
2. В меню **«Выбрать статус модуля смен...»** выберите **«Включен»**.

***

## Базовые настройки

На этой же странице задаются общие параметры:

* **Канал логов смен** — сюда бот пишет о каждом старте и завершении смены.
* **Роль на смене** — до 25 ролей, которые выдаются сотруднику при выходе на смену (например `На Дежурстве`).

### Дополнительные опции

Кнопка **«Дополнительные Опции»** открывает общие настройки смен:

* **Роль на перерыве** — выдаётся вместо роли «на смене», пока сотрудник на перерыве.
* **Префикс Ника** — добавка к никнейму на время смены, например `[НА СМЕНЕ]`. Оставьте пустым, чтобы не менять никнеймы.
* **Норма Смены** — общая норма отработанного времени для всех, формат: `60m`, `2h`, `1d`, `1mo`. Значение `0` отменяет норму. Число без единицы измерения (просто «120») не принимается.
* **Лимит Персонала** — максимальное число людей на смене одновременно, например `5`. Значение `0` — без ограничений.

***

## Типы смен

Если вашим отделам нужен разный учёт (свой канал логов, своя роль дежурства, свой доступ) — создайте несколько типов смен.

1. Нажмите кнопку **«Типы Смен»** → **«Добавить»** → введите название, например `Патруль`.
2. Выберите созданный тип → нажмите **«Редактировать»** и настройте:
   * **Канал логов типа** — свой канал событий для этого типа;
   * **Роль на дежурстве** — роль On-Duty именно этого типа смены;
   * **Роль на перерыве** — своя роль перерыва;
   * **Роли доступа** — до 25 ролей, которым разрешено выходить на этот тип смены. Пусто = доступно всем;
   * **Префикс Смены** — свой префикс никнейма для этого типа, например `[ПАТРУЛЬ]`.

Редактирование и удаление типов выполняется по их ID — он показан в списке типов.

***

## Квоты Ролей

Если разным должностям положена разная норма часов (у рядового 2 часа, у командования 5 часов):

1. Нажмите **«Квоты Ролей»** → **«Создать Квоту Роли»**.
2. Выберите Discord-роль и укажите норму времени (`12m`, `2h`, `1d`, `1mo`).

Индивидуальная норма роли перекрывает общую норму для всех её обладателей. В статистике и отчётах бот сам подставит нужную норму каждому сотруднику.

***

## Очистка данных

Внизу страницы доступны кнопки очистки: удалить все / прошлые / активные смены, удалить нерассмотренные заявки отпусков и ПА, удалить смены конкретного типа.

<Callout icon="triangle-exclamation" color="#EF4444">
  Кнопки очистки на этой странице срабатывают сразу, без подтверждения. Для безопасной массовой чистки используйте [`/сервер управление`](/ru/guides/bots/department-oversight/server-manage) — там требуется ввод фразы подтверждения, а активные смены завершаются корректно.
</Callout>

## Что видят сотрудники

* **Начало смены:** выбор типа (если их несколько), получение роли и префикса, запись в лог.
* **Перерыв:** смена роли на «перерыв», время не засчитывается; кнопкой «Продолжить» сотрудник возвращается на смену.
* **Завершение:** ЛС с итоговым временем смены.
* `/смена рейтинг [тип]` — топ сотрудников с медалями, страницами и выгрузкой текстовым файлом.
* `/смена история @участник` — подробная история смен любого сотрудника (для руководства).
* `/смена активность [период]` — отчёт за период: кто сколько отработал против нормы, пометки 🌴 (отпуск) и 📉 (ПА).