> ## 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 ролей, которые выдаются одобренным сотрудникам (например `В Отпуске`).

***

## Как это работает для пользователей

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

* `/отпуск подать` — срок (от 1 до 90 дней; понимает форматы «14 дней», «2 недели», «1 месяц») + причина.
* Нельзя подать вторую заявку, пока текущая активна или ждёт рассмотрения.
* После одобрения приходит ЛС, выдаётся роль. По окончании срока роль снимется сама, придёт уведомление об окончании.

### Для руководства

Карточка заявки в канале отпусков показывает информацию о сотруднике: высшую роль, число прошлых отпусков и общее отработанное время — всё для взвешенного решения.

* **«Одобрить»** — выдать отпуск.
* **«Отклонить»** — обязательно указывается причина отказа (до 500 символов), она уходит сотруднику в ЛС.

Админ-команды:

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

<Callout icon="lightbulb" color="#22C55E">
  Бот проверяет истёкшие отпуска каждые 5 минут — даже если сервер перезагружался, ни один отпуск не «зависнет».
</Callout>