vault backup: 2025-05-14 11:29:50

Telegram-бот - Сценарий работы с сервисом.md

@@ -0,0 +1,205 @@
+# Сценарий работы с сервисом через Telegram
+
+## 1. Начало работы
+1. Пользователь находит бота в Telegram по его имени или ссылке.
+2. Нажимает кнопку «Запустить» или отправляет команду `/start`.
+
+   Привет! Я бот сервиса "НаСвязи". Помогу вам создать QR-код (для автомобиля, питомца, входной двери и т.д.).
+
+## 2. Создание QR-кода
+1. Бот предлагает выбрать объект для QR-кода:
+
+   Выберите объект, для которого вы хотите создать QR-код:
+   2. Автомобиль
+   3. Питомец
+   4. Дверь квартиры
+   5. Стол в ресторане
+   6. Другое
+
+7. Пользователь выбирает вариант (например, отправляет «1» для автомобиля).
+8. Бот запрашивает название QR-кода:
+
+   Укажите название для вашего QR-кода. Например, "Моя машина" или "Ошейник Бобика".
+
+9. Пользователь вводит название, например: "Моя машина".
+10. Бот подтверждает:
+
+   Отлично! Ваш QR-код будет называться "Моя машина". Теперь настройте действия, доступные при его сканировании.
+
+## 3. Настройка действий
+1. Бот предлагает выбрать действия:
+
+   Какие действия вы хотите включить для использования QR-кода?
+   2. Отправить сообщение
+   3. Показать номер телефона
+   4. Прикрепить геопозицию
+   (Выберите номера действий через запятую, например: 1, 3)
+
+5. Пользователь выбирает, например, «1, 2».
+
+## 4. Получение QR-кода
+1. Бот генерирует QR-код и отправляет его в виде изображения:
+
+   Ваш QR-код "Моя машина" готов! Вот он:
+   [изображение QR-кода]
+   Вы можете скачать изображение и разместить его на объекте.
+
+2. Бот предоставляет инструкции по размещению, соответствующие типу объекта:
+
+   Рекомендации по размещению QR-кода для автомобиля:
+   - Разместите наклейку на заднем стекле или в углу бокового стекла.
+
+   Сделайте "НаСвязи" удобнее. Будем рады вашей поддержке: [https://hereconnect.condev.ru/donate](https://hereconnect.condev.ru/donate)
+
+3. Пользователь завершает процесс, используя QR-код.
+
+## 5. Получение уведомлений
+1. Когда QR-код используется для отправки сообщения, пользователь получает уведомление через бота:
+
+   Новое сообщение для QR-кода "Моя машина":
+   "Ваша машина мешает проезду."
+
+2. Если QR-код настроен для отображения номера телефона, пользователь видит текст:
+
+   QR-код "Моя машина": номер телефона владельца показан.
+
+## 6. Управление QR-кодами
+1. Пользователь может управлять своими QR-кодами, отправляя команду `/manage`.
+2. Бот выводит список созданных QR-кодов и предлагает изменить их:
+
+   Вот ваши QR-коды:
+   1. Моя машина
+   2. Ошейник собаки
+   Выберите номер для управления или создайте новый QR-код командой `/new`.
+
+## 7. Получение статистики
+1. Пользователь отправляет команду `/stats`, чтобы получить данные по взаимодействиям:
+
+   Статистика для "Моя машина":
+   - Сканирований: 12
+   - Сообщений: 5
+
+## 8. Поддержка
+1. Если у пользователя возникают вопросы, он отправляет команду `/help`.
+2. Бот предоставляет базовую информацию о сервисе:
+
+   Это сервис "НаСвязи" для создания QR-кодов для удобной связи. Вы можете создавать и настраивать QR-коды, а также управлять своими объектами.
+
+
+# Сценарии ОШИБОК:
+
+## 1. Начало работы
+1. Пользователь находит бота в Telegram по его имени или ссылке.
+2. Нажимает кнопку «Запустить» или отправляет команду `/start`.
+
+   Привет! Я бот сервиса "НаСвязи". Помогу вам создать QR-код (для автомобиля, питомца, входной двери и т.д.).
+
+---
+
+# Сценарий: Неверный ответ при выборе объекта
+
+## Описание
+Пользователь вводит неверное значение (например, текст вместо числа) или значение, не входящее в предложенный диапазон (например, "10" вместо "1-5").
+
+### Шаги:
+1. Бот предлагает выбрать объект:
+
+   Выберите объект, для которого вы хотите создать QR-код:
+   2. Автомобиль
+   3. Питомец
+   4. Дверь квартиры
+   5. Стол в ресторане
+   6. Другое
+
+7. Пользователь вводит некорректный ответ, например: "шесть" или "10".
+8. Бот отвечает:
+
+   Пожалуйста, выберите вариант из списка, отправив число от 1 до 5.
+
+9. Пользователь исправляет ввод, например: "3".
+
+---
+
+# Сценарий: Неверный ответ при вводе названия QR-кода
+
+## Описание
+Пользователь не вводит название или отправляет слишком короткое название.
+
+### Шаги:
+1. Бот запрашивает название для QR-кода:
+
+   Укажите название для вашего QR-кода. Например, "Моя машина" или "Ошейник Бобика".
+
+2. Пользователь оставляет сообщение пустым или вводит слишком короткое название, например: "а".
+3. Бот отвечает:
+
+   Название должно содержать хотя бы 2 символа. Попробуйте ещё раз.
+
+4. Пользователь исправляет ввод, например: "Моя машина".
+
+---
+
+# Сценарий: Неверный ответ при выборе действий
+
+## Описание
+Пользователь вводит текст вместо номеров действий или указывает некорректные номера (например, "7" вместо "1-3").
+
+### Шаги:
+1. Бот предлагает выбрать действия:
+
+   Какие действия вы хотите включить для использования QR-кода?
+   2. Отправить сообщение
+   3. Показать номер телефона
+   4. Прикрепить геопозицию
+   (Выберите номера действий через запятую, например: 1, 3)
+
+5. Пользователь вводит некорректный ответ, например: "все" или "7".
+6. Бот отвечает:
+
+   Пожалуйста, выберите номера действий из списка (1, 2 или 3), разделяя их запятой.
+
+7. Пользователь исправляет ввод, например: "1, 2".
+
+---
+
+# Сценарий: Неверный ответ при управлении QR-кодами
+
+## Описание
+Пользователь вводит номер, которого нет в списке, или текст вместо номера.
+
+### Шаги:
+1. Бот выводит список созданных QR-кодов:
+
+   Вот ваши QR-коды:
+   2. Моя машина
+   3. Ошейник собаки
+   Выберите номер для управления или создайте новый QR-код командой `/new`.
+
+4. Пользователь вводит некорректный ответ, например: "5" или "два".
+5. Бот отвечает:
+
+   Пожалуйста, выберите существующий номер QR-кода из списка (1 или 2).
+
+6. Пользователь исправляет ввод, например: "1".
+
+---
+
+# Сценарий: Неверный ответ при запросе статистики
+
+## Описание
+Пользователь отправляет неверную команду вместо `/stats`.
+
+### Шаги:
+1. Пользователь вводит некорректную команду, например: `/статистика`.
+2. Бот отвечает:
+
+   Команда не распознана. Попробуйте использовать команду `/stats` для получения статистики.
+
+3. Пользователь исправляет ввод, например: `/stats`.
+
+---
+
+# Дополнительное уведомление
+В каждом случае некорректного ввода бот может добавить общее дружелюбное напоминание:
+
+   Если у вас возникли вопросы, воспользуйтесь командой `/help` для получения информации.