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

# Управление участниками в структуре Наставника

> Узнайте, как просматривать, редактировать, переводить и общаться с участниками своей структуры — от рассмотрения Запросов до управления записями для довнесения данных.

Ваша структура — это группа участников, за которых вы отвечаете. Хорошо управлять ею — значит держать в поле зрения ожидающие Интенты и Запросы, поддерживать точность данных участников и быть на связи, когда кому-то из группы нужна помощь. На этой странице — команды, которыми вы пользуетесь чаще всего в ежедневной работе.

## Просмотр участников

Начните с понимания того, кто входит в структуру и в каком они состоянии.

| Команда          | Что возвращает                       |
| ---------------- | ------------------------------------ |
| `/users`         | Активные участники структуры         |
| `/users_all`     | Все участники, включая неактивных    |
| `/users_blocked` | Участники со статусом «заблокирован» |

Используйте `/users_all`, чтобы найти того, кто пропал, или оценить полный размер группы.

## Рассмотрение Интентов

Когда участник группы отправляет Интент — заявку на передачу определённой суммы — он попадает в вашу очередь на одобрение.

```text theme={null}
/intents @username
/intents TGID
```

Работают обе формы: можно использовать Telegram-имя пользователя или числовой Telegram ID. Команда возвращает все Интенты участника с их текущими статусами (Новый, Активный, Частично подтверждён, Полностью подтверждён, Отклонён, Отменён).

<Note>
  Вы можете встретить четыре типа Интентов: стандартный (`intent`), бонусный (`bonus`), передающий (`passon`) и системный (`system`). Стандартные Интенты приходят от участников. Бонусные и передающие создают Наставники. Системные Интенты создают только Тысячники и администраторы.
</Note>

## Рассмотрение Запросов на помощь

Запросы (Asks) от членов группы требуют вашего одобрения, прежде чем система начнёт их обрабатывать. Используйте `/asks`, чтобы увидеть очередь.

<Tabs>
  <Tab title="Ваша первая линия">
    ```text theme={null}
    /asks
    ```

    Показывает ожидающие Запросы от участников непосредственно в вашей (первой) линии. Это ваша основная очередь на рассмотрение.
  </Tab>

  <Tab title="Конкретный участник">
    ```text theme={null}
    /asks @username
    ```

    Показывает все Запросы одного участника — полезно при наблюдении за конкретной ситуацией.
  </Tab>

  <Tab title="Вся структура">
    ```text theme={null}
    /asks structure
    ```

    Показывает ожидающие Запросы по всей вашей структуре, включая участников под суб-Наставниками в иерархии.
  </Tab>

  <Tab title="Личные запросы">
    ```text theme={null}
    /asks_my @username
    ```

    Показывает Запросы, которые лично принадлежат участнику (в отличие от запросов, видимых по структурной ответственности). Используйте при просмотре собственной финансовой активности участника.
  </Tab>
</Tabs>

### Установка приоритета Запроса

Для системных Запросов можно настроить приоритет обработки (0–9, выше — раньше):

```text theme={null}
/ask_1234567_priority_5
```

Можно вызвать `/ask_1234567_priority` без числа — бот сам предложит его ввести.

## Просмотр Поручений

Поручения связывают Интенты с Запросами и представляют фактический перевод между участниками.

```text theme={null}
/orders @username   — Поручения с участием конкретного человека
/orders my          — Поручения, по которым отвечаете вы как Наставник
```

Подробное описание каждого статуса Поручения и доступных действий см. на странице [Жизненный цикл Поручения](/guiders/order-lifecycle).

## Перевод участников между структурами

Если участника нужно перевести в другую структуру — потому что он переехал, его Наставник недоступен или по другим причинам — используйте команду `/move`. Она запускает интерактивный процесс, в котором указываются участник и целевая структура.

```text theme={null}
/move
```

<Warning>
  Перевод участника передаёт все его ожидающие Интенты и Запросы в очередь рассмотрения нового Наставника. Перед переводом согласуйте действие с принимающим Наставником.
</Warning>

## Редактирование данных участника

Иногда нужно обновить или поправить данные от имени участника.

| Команда  | Что редактирует                                                                                    |
| -------- | -------------------------------------------------------------------------------------------------- |
| `/set`   | Универсальный редактор полей — открывает интерактивное меню для правки любого поддерживаемого поля |
| `/name`  | Отображаемое имя                                                                                   |
| `/email` | Email-адрес                                                                                        |
| `/phone` | Номер телефона                                                                                     |
| `/about` | Краткое описание профиля                                                                           |
| `/card`  | Добавить или обновить платёжную карту от имени участника                                           |
| `/stage` | Сменить текущую стадию сценария онбординга участника                                               |

Используйте `/set`, если не уверены, какая команда нужна — он покрывает все редактируемые поля в одном месте.

## Управление статусами

Чтобы изменить статус участника (например, повысить или заблокировать проблемный аккаунт), используйте:

```text theme={null}
/status
```

Команда открывает интерактивный процесс. Изменения статуса вступают в силу немедленно и влияют на то, что участник может делать в системе.

## Общение с участниками

```text theme={null}
/send
```

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

```text theme={null}
/admin
```

Отправляет сообщение администратору. Используйте, если вопрос выходит за пределы вашей компетенции как Наставника.

```text theme={null}
/report
```

Отправляет отчёт-обратную связь. См. также `/tickets_add_report` ниже — для вознаграждения участников, приславших видеоотзыв.

## Связь с участниками в Telegram

Чтобы подтвердить или управлять связью между вашим Наставническим аккаунтом и аккаунтом участника в боте:

```text theme={null}
/connected_userid    — Подтвердить связь Наставник↔Участник в Telegram
/disconnect_userid   — Разорвать связь между вашим аккаунтом и участником
```

Эти команды полезны, когда участник сменил устройство или Telegram-аккаунт.

## Управление инвайт-кодами

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

```text theme={null}
/invite
```

## Работа с потерянной связью

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

```text theme={null}
/losts          — Список заявок `/lost`, поданных вами или связанных с вашими участниками
/losts_all      — Все нерешённые заявки `/lost` по всей структуре
```

## Приветственное сообщение для новичков

Сообщение, которое получают новые участники в вашей структуре, можно настроить:

```text theme={null}
/intro           — Установить текст приветствия
/intro_delay     — Установить задержку (в секундах) перед отправкой приветствия
```

<Tip>
  Хорошее приветствие задаёт ожидания: что участнику делать в первую очередь, как с вами связаться и что делает система. Держите его кратким и ориентированным на действие.
</Tip>

## Чат-журнал

```text theme={null}
/set_chatlog
```

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

## Проверка финансового итога участника

```text theme={null}
/outcome
```

Показывает, находится ли участник в положительной финансовой позиции (отдал больше, чем получил), отрицательной или вообще ничего не передавал. Используйте при оценке обоснованности Запроса с учётом истории.

## Поощрение видеоотзывов

Если участник присылает видеоотзыв о своём опыте, можно выдать ему 2 Билетика в качестве награды:

```text theme={null}
/tickets_add_report
```

## Довнесение данных (backfill)

Если Интенты или Запросы создавались/исполнялись вне бота (например, в более ранний период или вручную), их можно внести в систему задним числом:

```text theme={null}
/ia
```

Команда `/ia` открывает интерактивный процесс довнесения записей Интентов и Запросов. Используйте её только тогда, когда у вас есть подтверждённая информация — а не как обходной путь для текущих операций.

## Способы оплаты

Чтобы просматривать или добавлять способы оплаты (банки или криптосервисы), связанные со структурой:

```text theme={null}
/banks       — Просмотр доступных способов оплаты
/bank_add    — Добавить новый способ оплаты
```