# Тайный Санта

Модуль «Тайный Санта» позволяет провести праздничный обмен подарками между сотрудниками. Участники получают подопечных в результате анонимной жеребьевки, узнают, что те хотели бы получить, и готовят подарки. Распределение подопечных происходит по офисам, чтобы сотрудники могли вручить подарок лично, например, на корпоративе.

***

## 📄 Главная страница

На главной странице модуля отображаются:

* Название мероприятия (*«Тайный Санта»*)
* Описание
  * Текст описания задаёт администратор в [настройках](#id-10.-nastroiki-administratora), сюда можно добавить важную информацию: напоминание о предстоящем корпоративе, инструкции по вручению подарков и т.д.
* Статус (например, *«Приём заявок не запущен»*)
* Верхняя панель управления (доступна только администратору)

<figure><img src="/files/aBLFvueE5LtFn9GJwgOo" alt=""><figcaption><p>Главная страница</p></figcaption></figure>

***

## 🟢 Запуск приема заявок

Только администратор может запустить прием заявок.

1. Нажмите кнопку **Запустить** на верхней панели.

<figure><img src="/files/sjUiPLpeC6mr7o3v3686" alt=""><figcaption></figcaption></figure>

2. Нажмите **Выбрать файл** — загрузите Excel-файл со списком офисов:
   * CSV (UTF-8),
   * не более 1 MB.

<figure><img src="/files/BPQrlBKBNrEeGLmxsfLs" alt="" width="231"><figcaption></figcaption></figure>

Пример таблицы со списком офисов:

| Центральный офис в Москве           |
| ----------------------------------- |
| Филиал в Одинцово                   |
| Северный региональный офис          |
| Представительство в Колпино         |
| Южный офис в Ростове-на-Дону        |
| Филиал в Краснодаре                 |
| Представительство в Сочи            |
| Приволжский офис в Нижнем Новгороде |
| Филиал в Казани                     |
| Представительство в Самаре          |

3. Нажмите **Запустить**.

**После запуска:**

* Пользователи смогут [подавать заявки](#id-4.-podacha-zayavki-dlya-polzovatelei).
* Откроется форма подачи заявки для администратора, он также может принять участие.
* На верхней панели администратор увидит:
  * Кол-во участников, подавших заявку.
  * Возможность [Завершить прием заявок](#zavershenie-priyoma-zayavok).

***

## 📝 Подача заявки

Доступно всем пользователям.

1. Перейдите на страницу **Тайный Санта**.
2. Укажите, что вы хотите получить в подарок.
3. Выберите свой офис из выпадающего списка.
4. Нажмите **Хочу участвовать**.

<figure><img src="/files/m3X3Z0EdfJ27TuViM66Z" alt=""><figcaption><p>Подача заявки</p></figcaption></figure>

***

## 🔚 Завершение приёма заявок

Только администратор может завершить приём заявок.

1. Нажмите **Завершить приём заявок** и подтвердите действие в модальном окне.

<figure><img src="/files/woOjfMYJvPYr9oYFw2l6" alt=""><figcaption></figcaption></figure>

2. Отобразится сводка:
   * Всего участников
   * Успешно распределились
   * Остались без Санты (например, единственный участник в офисе)

<figure><img src="/files/WADDwmJdD1hOttF53HDT" alt="" width="290"><figcaption><p>Сводка</p></figcaption></figure>

3. Нажмите **Скачать результаты**, чтобы получить таблицу с результатами распределения — в ней указано:
   * Кто кому был назначен в качестве подопечного
   * Какие подарки указали участники
   * Офисы, которые выбрали участники
   * Кто остался без Санты и подопечного (например, был единственным зарегистрированным в офисе)
4. Также доступна кнопка **Сбросить результаты**, если нужно начать заново.

<figure><img src="/files/DIjwTxBh2VUdZSIxN4Fe" alt="" width="563"><figcaption><p>Скачать/Сбросить результаты</p></figcaption></figure>

***

## 🎁 Просмотр подопечного

Если пользователь подал заявку и ему был назначен подопечный:

* Отобразится имя подопечного, его пожелание и офис.
* Администратор может [настроить](#nastroiki-administratora) текст с инструкциями: как дарить подарок, куда его положить и т.д.
* По клику на имя — переход в профиль подопечного в DaOffice.
* Также доступна кнопка **Скачать результаты**.

<figure><img src="/files/Cz6iYNdgkFYVC1TGIzYz" alt=""><figcaption></figcaption></figure>

***

## 🙁 Пользователь без подопечного

Если пользователь подал заявку, но в его офисе никто больше не зарегистрировался:

* Он увидит сообщение о том, что подопечный не найден (например, «В вашем офисе не нашлось подопечного. Возможно, в следующем году!» — текст данного сообщения [настраивает](#nastroiki-administratora) администратор).
* Такой пользователь останется без Санты и подопечного.

<figure><img src="/files/k0JYSqyqhNooRlzcDKxr" alt=""><figcaption></figcaption></figure>

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

***

## ❌ Пользователь не подал заявку

Если пользователь зашёл на страницу уже после завершения приема заявок, но сам не регистрировался:

* Отображается сообщение: **«Тайный Санта завершён. Приходите через год!»**

<figure><img src="/files/IcYOYHvL07LmU0wDFuGN" alt=""><figcaption></figcaption></figure>

***

## ✏️ Настройки администратора

Для настройки текстов:

1. Нажмите кнопку **Настройки** на верхней панели.
2. Введите необходимые тексты.&#x20;
3. Нажмите **Сохранить**.

<figure><img src="/files/kIVWWztwu47MoAS5sJ54" alt=""><figcaption><p>Настройки</p></figcaption></figure>

Администратор может изменить тексты:

* На главной странице (Правила)
* На странице с результатами жеребьевки:
  * Когда подопечный найден
  * Когда подопечный не найден

Это позволяет адаптировать мероприятие под стиль и формат вашей компании.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://daoffice.gitbook.io/funkcional-daoffice/tainyi-santa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
