HereConnect-obsidian/Telegram-бот - Список задач для реализации функционала.md

## 1. **Основной функционал**
1. **Запуск бота**
   - Реализовать команду `/start` с приветственным сообщением:
     ```
     Привет! Я бот сервиса "НаСвязи". Помогу вам создать QR-код (для автомобиля, питомца, входной двери и т.д.).
     ```

2. **Выбор объекта**
   - Использовать **replyKeyboardMarkup** для отображения кнопок:
     - Автомобиль
     - Питомец
     - Дверь квартиры
     - Стол в ресторане
     - Другое
   - Обработать выбор пользователя и переход к следующему шагу.

3. **Ввод названия QR-кода**
   - Запросить название QR-кода с валидацией (минимум 2 символа).
   - Реализовать повторный запрос при неверном вводе.

4. **Настройка действий**
   - Использовать **replyKeyboardMarkup** для выбора действий:
     - Отправить сообщение
     - Показать номер телефона
     - Прикрепить геопозицию
   - Обработать выбор пользователя и сохранить выбранные действия.

5. **Генерация QR-кода**
   - Создать функционал генерации QR-кода с указанным названием и действиями.
   - Отправить изображение QR-кода пользователю.

6. **Инструкции по размещению**
   - Отправить рекомендации по размещению в зависимости от выбранного объекта.
   - Добавить кнопку с **keyboardButtonUrl** для перехода на страницу доната:
     ```
     Сделайте НаСвязи удобнее. Будем рады вашей поддержке: [https://hereconnect.condev.ru/donate](https://hereconnect.condev.ru/donate)
     ```

---

## 2. **Уведомления**
1. **Обработка сообщений через QR-код**
   - Получать данные о сообщении, отправленном через QR-код.
   - Отправлять уведомление пользователю:
     ```
     Новое сообщение для QR-кода "Моя машина": "Ваш автомобиль мешает проезду."
     ```

2. **Отображение действий через QR-код**
   - Обрабатывать действие "Показать номер телефона" и фиксировать запрос:
     ```
     QR-код "Моя машина": номер телефона владельца показан.
     ```

---

## 3. **Управление QR-кодами**
1. **Просмотр списка QR-кодов**
   - Отправить список QR-кодов пользователя в виде кнопок:
     ```
     Вот ваши QR-коды:
     [Моя машина] [Ошейник собаки]
     ```
   - Реализовать выбор QR-кода для управления.

2. **Редактирование QR-кода**
   - Добавить возможность изменить название QR-кода.
   - Реализовать выбор доступных действий для редактирования.

3. **Удаление QR-кода**
   - Подтвердить удаление перед выполнением.
   - Удалить QR-код и уведомить пользователя:
     ```
     QR-код "Моя машина" успешно удалён.
     ```

---

## 4. **Получение статистики**
1. **Просмотр статистики**
   - Реализовать команду `/stats` для получения статистики:
     ```
     Статистика для "Моя машина":
     - Сканирований: 12
     - Сообщений: 5
     ```
   - Отправить данные в текстовом формате.

---

## 5. **Дополнительные возможности**
1. **Запрос номера телефона**
   - Использовать **keyboardButtonRequestPhone** для запроса номера телефона владельца.

2. **Запрос геопозиции**
   - Использовать **keyboardButtonRequestGeoLocation** для получения геопозиции.

3. **Поддержка инлайн-кнопок**
   - Добавить инлайн-кнопки к уведомлениям:
     - Ответить на сообщение.
     - Удалить сообщение.

---

## 6. **Обработка ошибок**
1. **Неверный ввод на каждом этапе**
   - Реализовать обработку ошибок:
     - Некорректный выбор объекта.
     - Неверное название QR-кода.
     - Неправильный выбор действий.
   - Отправлять соответствующие сообщения и запрашивать повторный ввод.

---

## 7. **Административный функционал**
1. **Управление пользователями**
   - Добавить функционал для администратора:
     - Просмотр статистики всех пользователей.
     - Удаление неактивных QR-кодов.

2. **Журнал ошибок**
   - Логировать ошибки пользователей для анализа и улучшения UX.

---

# Приоритеты
1. Основной функционал.
2. Уведомления.
3. Управление QR-кодами.
4. Получение статистики.
5. Дополнительные возможности.
6. Обработка ошибок.
7. Административный функционал.