> For the complete documentation index, see [llms.txt](https://wiki.umo-gta5rp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.umo-gta5rp.com/premium/audit.md).

# Кадровый аудит

Хотите вести отчетность о кадровых действиях как в настоящем фракционном дискорде? Этот модуль, который выполнен в двух стилях специально для вас!

## Подготовка

Для начала нам необходимо создать три канала:

1. В первом канале будут отписываться действия кадрового аудита.
2. Во второй канал будут попадать люди, занесенные в черный список.
3. В третий канал будут отписываться общие логи.

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F2X24eYmYcuP0a8zQePpo%2Fimage.png?alt=media&amp;token=4c9ec6aa-5c4e-4f9c-956c-d80d8fa113a2" alt=""><figcaption></figcaption></figure>

Для начала добавим первый канал. Нам необходимо создать канал с любым названием для кадрового аудита. Для этого используем `/опции канал_выбрать` с типом "Изменение канала с кадровым аудитом":

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FoHQUK20fmjkvjT7XnkAL%2Fimage.png?alt=media&amp;token=a43987fb-419c-4d8b-842b-e99b8186e7e1" alt=""><figcaption></figcaption></figure>

Далее добавим второй канал для черного списка. Для этого используем `/опции канал_выбрать` с типом "Изменение канала с черным списком":

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FmVhNZ83O1VuIhfosLE4s%2Fimage.png?alt=media&amp;token=1512f899-61b3-4ae0-a296-e3ffeb0eba50" alt=""><figcaption></figcaption></figure>

Для добавления третьего канала, в который будут отписываться общие логи используем `/опции канал_выбрать` с типом "Изменение канала с общими логами":

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FFzRRrsTdtY0oc8Zq1Fyx%2Fimage.png?alt=media&amp;token=cb664206-1db9-4cb1-8e91-4d4947ae118d" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Теперь все готово для начала использования!
{% endhint %}

## Защита

Модуль обладает защитой и пользователи не могут взаимодействовать в кадровом аудите с другими пользователями, максимальная роль которых равна или выше их:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FY03o47ve2Rb5nQmef4nc%2Fimage.png?alt=media&amp;token=b00b6e76-373b-4a21-9b91-397bef162303" alt=""><figcaption></figcaption></figure>

## Использование

### Настройка модуля

Для настройки модуля "Кадровый аудит" используется команда `/модули аудит`:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2Fdn33eW6och6oUZwwIwRl%2Fimage.png?alt=media&amp;token=f105287c-4454-432a-a92f-42d379204a11" alt=""><figcaption></figcaption></figure>

Открывается меню настроек:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FiaOxGi4cHW8yPTIF96uO%2Fimage.png?alt=media&amp;token=3a138688-e4b5-4573-b5f6-a8abbcbcff4d" alt=""><figcaption></figcaption></figure>

Подробное описание каждой из кнопок:

<table><thead><tr><th width="211">Кнопка</th><th width="388">Действие</th><th>По умолчанию</th></tr></thead><tbody><tr><td>Стиль кадрового аудита</td><td>Позволяет изменить стиль кадрового аудита. Есть два стиля: Компактный и цветной.</td><td>Компактный</td></tr><tr><td>Включить/Выключить выдачу роли</td><td>Позволяет включить/выключить выдачу роли при действиях в кадровом аудите. Например при повышении на должность "Рекрутер" через кадровый аудит, человеку бот сразу выдаст роль "Рекрутер".</td><td>Включено</td></tr><tr><td>Включить/Выключить кик с дискорда при увольнении</td><td>Позволяет включить/выключить кик с дискорда при увольнении. При использовании команды <code>/аудит уволить</code> бот может автоматически исключать человека из дискорда, если его роль находится выше, чем роли увольняемого. В журнал аудита подробно напишется кто уволил человека и по какой причине.</td><td>Выключено</td></tr><tr><td>Включить/Выключить уведомления в ЛС о действиях</td><td>Позволяет включить/выключить уведомления о действиях в личных сообщениях. Например при использовании <code>/аудит повысить</code>, человеку в личные сообщении бот напишет на какую должность он был назначен и по какой причине.</td><td>Включено</td></tr><tr><td>Включить/Выключить уведомления в ЛС об увольнении</td><td>Позволяет включить/выключить уведомления об увольнении в личных сообщениях. При использовании команды <code>/аудит уволить</code> в личные сообщения человеку напишет что он исключен.</td><td>Включено</td></tr></tbody></table>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FPJ6XRiYLFtnVaRr9yoMe%2Fimage.png?alt=media&amp;token=dd8b5e12-ad7d-4016-b563-30d52f6e8aed" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Новый стиль применяется в следующих после выбора действиях в кадровом аудите.
{% endhint %}

{% hint style="warning" %}
Цветной стиль может приводить к лагам дискорда из-за объема сообщений.
{% endhint %}

### Принятие человека

Для принятия человека используется команда `/аудит принять`:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FqRpisPFZXEdUmkj8Kcrl%2Fimage.png?alt=media&amp;token=877bffa9-da85-4f30-8b58-c9ed1a9416bb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Вы можете дополнительно указать паспорт человека в параметре "паспорт". Тогда вы сможете искать его еще и по паспорту. А в случае занесения в черный список он будет заблокирован еще и по номеру игрового паспорта!
{% endhint %}

После отправки команды в зависимости от выбранного стиля появится одно из сообщений:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F4K6aUw1LvYCwVCSAi4xk%2Fimage.png?alt=media&amp;token=e56c927b-8296-4037-9480-8e4504eb4cbd" alt=""><figcaption><p>Компактный стиль</p></figcaption></figure>

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FVMkI1kMO0xxs7rznHg7U%2Fimage.png?alt=media&amp;token=9961582e-2be4-41c8-bbcd-c74cbe5ada23" alt=""><figcaption><p>Цветной стиль</p></figcaption></figure>

При принятии автоматически выдаются роли новичков в семье, которые можно указать с помощью команды: `/опции роли_новичков_семьи`:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2Fa8WVp6Ej2bFV6HUSGf8R%2Fimage.png?alt=media&amp;token=6a73ac7f-e96d-4731-936a-5eafee559bc4" alt=""><figcaption></figcaption></figure>

### Повышение человека

С помощью команды `/аудит повысить` вы можете повысить человека:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F4gBbwLQmWFgGO78Sgk3D%2Fimage.png?alt=media&amp;token=58818099-4041-4f01-8a9f-02e12a1e2c39" alt=""><figcaption></figcaption></figure>

После отправки команды получаем результат:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FjiQsclQVZuFo160cPVjR%2Fimage.png?alt=media&amp;token=48982edf-67bf-405c-964e-6f201b49d78d" alt=""><figcaption></figcaption></figure>

Если роль, на которую вы повышаете человека ниже роли бота GTA5RP Assistant, то роль будет выдана автоматически при включении опции автовыдача ролей:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FRqX7Glh3OWvDxE23Vta3%2Fimage.png?alt=media&amp;token=d8add9bc-8ad7-4bad-b601-d95b5c84cb72" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Если человек не принимался через команду `/аудит принять`, но в дальнейшем его повышают или совершают иные действия через кадровый аудит, то его ник будет отображаться как "Ник не указан".
{% endhint %}

### Понижение человека

С помощью команды `/аудит понизить` вы можете понизить человека:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F2z8iPfPM8Ny0nyaEdIcK%2Fimage.png?alt=media&amp;token=e79a6d6e-60e3-478e-80ac-d93775a5a317" alt=""><figcaption></figcaption></figure>

После отправки команды получаем результат:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F861ymcxxmsgLuMTQmldV%2Fimage.png?alt=media&amp;token=0dd49fac-13d7-4f78-abbb-1b6974d4717c" alt=""><figcaption></figcaption></figure>

Если роль, на которую вы повышаете человека ниже роли бота GTA5RP Assistant, то роль будет выдана автоматически при включении опции выдачи ролей.

### Увольнение человека и черный список

Для увольнения человека из организации используйте команду `/аудит увольнение`:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FnstLI5H9tYaYvfPKR5GD%2Fimage.png?alt=media&amp;token=84b3408c-9b48-4a56-9ff3-ff51bde5da68" alt=""><figcaption></figcaption></figure>

Получаем результат:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F1JJv4ybkUJ39Uvbzt6Dm%2Fimage.png?alt=media&amp;token=6e934e97-61fc-40bf-b37c-50f5c53d1e99" alt=""><figcaption></figcaption></figure>

Параметр "причина\_чс" используется для указания причины занесения в черный список. Для того, чтобы пользователи не забывали указывать эту причину, поле обязательное.

При увольнении без занесения в черный список вы можете написать в "причина\_чс" все что угодно. Бот не будет это учитывать.

При увольнении с занесением в черный список человек попадает в канал черного списка:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FXd9be6BUNjEp6bOjq27Y%2Fimage.png?alt=media&amp;token=529c47cc-3338-4ecf-8525-911853e77125" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Черный список - внутренняя система модуля Кадровый аудит. В черный список человек может быть занесения при увольнении.

Человек, который находится в черный список, не может быть принят через кадровый аудит.
{% endhint %}

Если у вас включена опция "Кик с дискорда при увольнении", то человек будет выгнан из сервера при увольнении. Важно, чтобы роль GTA5RP Assistant была выше ролей увольняемого пользователя:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FhRX1D8LvzHphHaU6f29Z%2Fimage.png?alt=media&amp;token=48fd69bf-37e2-407b-a3ae-fb7963e0fba2" alt=""><figcaption></figcaption></figure>

### Что будет, если принять человека с черным списком?

При попытке принять человека, который занесен в черный список, вылезет такое предупреждение:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F2P5FPFLVNWlFBO5BlnaY%2Fimage.png?alt=media&amp;token=f3bcf504-4589-4dc9-9c7f-9bdc68135a41" alt=""><figcaption></figcaption></figure>

В канал общих логов поступит уведомление о том, что такой-то человек пытался принять такого-то, который в черном списке:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F327fCTF6txDFACVBvxyV%2Fimage.png?alt=media&amp;token=f9e3baf4-027d-4fb4-85bc-6fc885fc0d0b" alt=""><figcaption></figcaption></figure>

### Удаление из черного списка

Если вы хотите вынести человека из черного списка, используйте команду `/чс_удалить`:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FvpTL4zK49G5RZ0xHGdfw%2Fimage.png?alt=media&amp;token=067fbee0-0aa7-4670-8176-618e6c20e0e1" alt=""><figcaption></figcaption></figure>

Вам необходимо выбрать одну из настроек, по которой будет найден и вынесен человек с черным списком:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FSDtxDyq5qdNfOEpPc6Rt%2Fimage.png?alt=media&amp;token=5327395a-82c6-4dbc-9a37-e5069a194242" alt=""><figcaption></figcaption></figure>

В канал черного списка поступит уведомление об удалении человека из черного списка:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FAh6Ncsx4YGGpPezUfx5W%2Fimage.png?alt=media&amp;token=a652bd91-b749-4ad3-8a87-70b50afe44cb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Удалять людей из черного списка могут люди с правами Администратора, лидер, заместители лидера и старший состав.
{% endhint %}

## Логирование

### Информация о человеке

С помощью команды `/аудит логи информация` вы можете посмотреть информацию о любом человеке, которого принимали через кадровый аудит:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F2BsvVn1E2O0bGu8q4OgV%2Fimage.png?alt=media&amp;token=9eb50cf4-30f4-433b-a7d9-76c141df6985" alt=""><figcaption></figcaption></figure>

Получаем результат:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FVk8UBTooT0lqS0WGtWfy%2Fimage.png?alt=media&amp;token=9b4e86b2-a499-4b2f-a1fc-db3938fdcdde" alt=""><figcaption></figcaption></figure>

Если вы принимали человека несколько раз, то выводится информация из самого нового принятия.

### Полные логи о человеке

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FQtYl6VAwrMxUsS11HjaB%2Fimage.png?alt=media&amp;token=e6dc2045-0650-4fed-863a-2700a0e5d55e" alt=""><figcaption></figcaption></figure>

Получаем результат:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FuSoBa0fRa58bTgzVI293%2Fimage.png?alt=media&amp;token=c584448d-f2bb-4cf4-839b-85c9e44b7da6" alt=""><figcaption></figcaption></figure>

При использовании данной команды в канал общих логов отправляется такое сообщение:

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F1oG3cYtMjCPwHR6osYdF%2Fimage.png?alt=media&amp;token=02dcf52d-787d-48c7-9931-3479cc28977f" alt=""><figcaption></figcaption></figure>
