247 lines
12 KiB
Markdown
247 lines
12 KiB
Markdown
|
# Руководство пользователя
|
|||
|
|
|
|||
|
|
> AI Assistant — Telegram-бот для управления задачами с ИИ-анализом сообщений в групповых чатах.
|
|||
|
|
|
|||
|
|
Это руководство для обычных пользователей — тех, кому назначаются задачи. Вам не нужно настраивать бота или управлять проектами — достаточно знать, как просматривать свои задачи, менять их статус и получать уведомления.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Оглавление
|
|||
|
|
|
|||
|
|
1. [Начало работы](#1-начало-работы)
|
|||
|
|
2. [Главное меню](#2-главное-меню)
|
|||
|
|
3. [Как вам назначают задачи](#3-как-вам-назначают-задачи)
|
|||
|
|
4. [Просмотр своих задач](#4-просмотр-своих-задач)
|
|||
|
|
5. [Работа с задачей](#5-работа-с-задачей)
|
|||
|
|
6. [Фильтрация задач](#6-фильтрация-задач)
|
|||
|
|
7. [Быстрый доступ к задачам из любого чата](#7-быстрый-доступ-к-задачам-из-любого-чата)
|
|||
|
|
8. [Уведомления о дедлайнах](#8-уведомления-о-дедлайнах)
|
|||
|
|
9. [Частые вопросы](#9-частые-вопросы)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. Начало работы
|
|||
|
|
|
|||
|
|
### 1.1. Регистрация
|
|||
|
|
|
|||
|
|
Чтобы начать работу с ботом:
|
|||
|
|
|
|||
|
|
1. Найдите бота в Telegram по его username.
|
|||
|
|
2. Нажмите **Start** или отправьте команду `/start`.
|
|||
|
|
3. Бот автоматически зарегистрирует вас в системе.
|
|||
|
|
|
|||
|
|
**Важно:** вы должны написать боту хотя бы раз, иначе система не сможет назначать вам задачи.
|
|||
|
|
|
|||
|
|
### 1.2. Приветственное сообщение
|
|||
|
|
|
|||
|
|
После `/start` бот отправит приветствие с информацией о доступных функциях и покажет клавиатуру с кнопками.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. Главное меню
|
|||
|
|
|
|||
|
|
После регистрации вам доступна кнопка:
|
|||
|
|
|
|||
|
|
| Кнопка | Описание |
|
|||
|
|
|---|---|
|
|||
|
|
| **📋 Задачи** | Открыть меню задач |
|
|||
|
|
|
|||
|
|
При нажатии на **📋 Задачи** откроется подменю:
|
|||
|
|
|
|||
|
|
| Кнопка | Описание |
|
|||
|
|
|---|---|
|
|||
|
|
| **📗 Мои задачи** | Список задач, назначенных на вас |
|
|||
|
|
|
|||
|
|
Если вам не назначено ни одной задачи, список будет пустым.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. Как вам назначают задачи
|
|||
|
|
|
|||
|
|
Задачи могут быть назначены вам несколькими способами:
|
|||
|
|
|
|||
|
|
### 3.1. Автоматически из группового чата
|
|||
|
|
|
|||
|
|
Если бот мониторит групповой чат и кто-то напишет сообщение с упоминанием вашего `@username`:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
@ваш_username подготовь отчёт до пятницы
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Бот распознает это как задачу и назначит её на вас (автоматически или после подтверждения администратором, в зависимости от режима работы).
|
|||
|
|
|
|||
|
|
Также задача может быть создана, если кто-то ответит (reply) на ваше сообщение с указанием действия.
|
|||
|
|
|
|||
|
|
### 3.2. Вручную администратором
|
|||
|
|
|
|||
|
|
Администратор может создать задачу через бота и указать вас как исполнителя с помощью `@username`.
|
|||
|
|
|
|||
|
|
### 3.3. Уведомление о назначении
|
|||
|
|
|
|||
|
|
Когда на вас назначена новая задача, бот может прислать уведомление в личные сообщения.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. Просмотр своих задач
|
|||
|
|
|
|||
|
|
### 4.1. Через меню
|
|||
|
|
|
|||
|
|
1. Нажмите **📋 Задачи** → **📗 Мои задачи**.
|
|||
|
|
2. Бот покажет список задач со статусом «CREATED» (новые задачи).
|
|||
|
|
|
|||
|
|
### 4.2. Через команду
|
|||
|
|
|
|||
|
|
Отправьте боту в личные сообщения:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
/my_tasks
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.3. Информация в карточке задачи
|
|||
|
|
|
|||
|
|
Для каждой задачи отображается:
|
|||
|
|
- **ID** и **название**
|
|||
|
|
- **Статус** (CREATED, IN_WORK, BLOCKED, FINISHED, CANCELLED)
|
|||
|
|
- **Описание** (если есть)
|
|||
|
|
- **Дедлайн** (если установлен)
|
|||
|
|
- **Исполнители** (список `@username`)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5. Работа с задачей
|
|||
|
|
|
|||
|
|
### 5.1. Открытие задачи
|
|||
|
|
|
|||
|
|
Нажмите на задачу в списке. Откроется карточка с полной информацией и кнопками управления.
|
|||
|
|
|
|||
|
|
### 5.2. Изменение статуса
|
|||
|
|
|
|||
|
|
Это основное действие, доступное вам. Вы можете менять статус задачи:
|
|||
|
|
|
|||
|
|
| Статус | Когда ставить |
|
|||
|
|
|---|---|
|
|||
|
|
| **CREATED** | Задача только создана (начальный статус) |
|
|||
|
|
| **IN_WORK** | Вы начали работать над задачей |
|
|||
|
|
| **BLOCKED** | Работа заблокирована (ожидание, внешние зависимости) |
|
|||
|
|
| **FINISHED** | Задача выполнена |
|
|||
|
|
| **CANCELLED** | Задача отменена |
|
|||
|
|
|
|||
|
|
Нажмите **Изменить статус** и выберите нужный.
|
|||
|
|
|
|||
|
|
### 5.3. Что происходит при завершении задачи
|
|||
|
|
|
|||
|
|
Когда вы ставите статус **FINISHED**:
|
|||
|
|
- Ответственному лицу (тому, кто создал задачу) автоматически создаётся задача на проверку.
|
|||
|
|
- Он получит уведомление: «Исполнитель отметил задачу #N как выполненную».
|
|||
|
|
- Уведомления о дедлайне этой задачи отключаются.
|
|||
|
|
|
|||
|
|
### 5.4. Другие доступные действия
|
|||
|
|
|
|||
|
|
В зависимости от задачи вам также могут быть доступны:
|
|||
|
|
|
|||
|
|
| Действие | Описание |
|
|||
|
|
|---|---|
|
|||
|
|
| Изменить название | Ввести новое название задачи |
|
|||
|
|
| Изменить описание | Ввести новое описание |
|
|||
|
|
| Изменить дедлайн | Формат: `ДД.ММ.ГГГГ` или `+3` / `-1` (сдвиг в днях) |
|
|||
|
|
| Изменить людей | Добавить `@username` или убрать исполнителя |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 6. Фильтрация задач
|
|||
|
|
|
|||
|
|
При просмотре своих задач вы можете фильтровать их двумя способами:
|
|||
|
|
|
|||
|
|
### 6.1. По статусу
|
|||
|
|
|
|||
|
|
Нажмите кнопку нужного статуса под списком задач:
|
|||
|
|
- CREATED
|
|||
|
|
- IN_WORK
|
|||
|
|
- BLOCKED
|
|||
|
|
- FINISHED
|
|||
|
|
- CANCELLED
|
|||
|
|
|
|||
|
|
### 6.2. По дате дедлайна
|
|||
|
|
|
|||
|
|
Отправьте дату в формате `ДД.ММ.ГГГГ`:
|
|||
|
|
```
|
|||
|
|
15.04.2025
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Бот покажет только задачи с дедлайном в указанный день.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 7. Быстрый доступ к задачам из любого чата
|
|||
|
|
|
|||
|
|
Вы можете получить список своих задач прямо из любого чата Telegram с помощью инлайн-запроса.
|
|||
|
|
|
|||
|
|
### Как это работает:
|
|||
|
|
|
|||
|
|
1. В **любом** чате (даже в другом диалоге) начните вводить:
|
|||
|
|
```
|
|||
|
|
@имя_бота Задачи
|
|||
|
|
```
|
|||
|
|
2. Появится выпадающий список ваших задач.
|
|||
|
|
3. Нажмите на задачу — и информация о ней будет отправлена в текущий чат.
|
|||
|
|
|
|||
|
|
Это удобно, когда нужно быстро поделиться информацией о задаче с коллегой.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 8. Уведомления о дедлайнах
|
|||
|
|
|
|||
|
|
Бот автоматически уведомляет о приближающихся дедлайнах:
|
|||
|
|
|
|||
|
|
- **За день до дедлайна** — напоминание о том, что срок подходит к концу.
|
|||
|
|
- **В день дедлайна** — уведомление о наступлении срока.
|
|||
|
|
|
|||
|
|
Уведомление содержит:
|
|||
|
|
- ID и название задачи
|
|||
|
|
- Дату дедлайна
|
|||
|
|
- Текущий статус задачи
|
|||
|
|
|
|||
|
|
При получении уведомления вы можете нажать **Подробнее о задаче**, чтобы открыть карточку задачи.
|
|||
|
|
|
|||
|
|
**Примечание:** если задача завершена (статус FINISHED), уведомления о дедлайне отключаются автоматически.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 9. Частые вопросы
|
|||
|
|
|
|||
|
|
### Я не вижу никаких задач
|
|||
|
|
- Убедитесь, что вы написали боту `/start` хотя бы раз.
|
|||
|
|
- Возможно, вам ещё не назначены задачи. Уточните у администратора.
|
|||
|
|
- Проверьте фильтр по статусу — возможно, выбран статус, по которому нет задач.
|
|||
|
|
|
|||
|
|
### Мне не приходят уведомления
|
|||
|
|
- Убедитесь, что вы не заблокировали бота в Telegram.
|
|||
|
|
- Уведомления настраивает администратор. Возможно, они отключены.
|
|||
|
|
|
|||
|
|
### Бот не распознаёт мой @username в чате
|
|||
|
|
- Проверьте, что вы написали боту `/start` — это необходимо для регистрации.
|
|||
|
|
- Убедитесь, что у вас установлен username в настройках Telegram.
|
|||
|
|
|
|||
|
|
### Как узнать, кто создал задачу?
|
|||
|
|
- В карточке задачи может быть указан создатель. Если нет — уточните у администратора.
|
|||
|
|
|
|||
|
|
### Я случайно поставил статус FINISHED
|
|||
|
|
- Откройте задачу и измените статус обратно на нужный (например, IN_WORK).
|
|||
|
|
- Учтите, что при переводе в FINISHED уже создана задача на проверку — администратор получил уведомление.
|
|||
|
|
|
|||
|
|
### Как мне связаться с администратором бота?
|
|||
|
|
- Обратитесь к тому, кто добавил бота в ваш рабочий чат — это администратор или суперадминистратор системы.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Краткий справочник
|
|||
|
|
|
|||
|
|
| Действие | Как сделать |
|
|||
|
|
|---|---|
|
|||
|
|
| Открыть меню | `/start` в ЛС с ботом |
|
|||
|
|
| Мои задачи | `/my_tasks` или **📋 Задачи** → **📗 Мои задачи** |
|
|||
|
|
| Инлайн-запрос задач | `@имя_бота Задачи` в любом чате |
|
|||
|
|
| Фильтр по статусу | Кнопки под списком задач |
|
|||
|
|
| Фильтр по дате | Отправить дату в формате `ДД.ММ.ГГГГ` |
|
|||
|
|
| Изменить статус задачи | Открыть задачу → Изменить статус |
|