По всем вопросам писать в телеграм @alantsoff

Техническое задания для @Pushist_bot
Содержание
О боте
Создание бота
Рассылка в чаты
Ответы боту
Реакции бота на ответы
Статистика
Стоимость
Оплата
Языки
Реферальная система
Промокоды
Справка


О боте
	@pushist_bot - бот для контроля сотрудников через мессенджеры. Бот позволяет рассылать сообщения в нужный чат и конкретное время по фиксировать ответы на них.
	Бота можно использовать для трекинга личных привычек и задач.
Создание личного бота
	В основном боте требуется создать личного бота через BotFather.
	Через созданного бота и идет настройка уведомлений.
	Все оплаты, статистика, реферальная система и рассылка происходит через основного бота.
К одному аккаунту пользователя можно привязать несколько ботов для разных целей.
При создании личного бота, код не должен “тупо” копироваться в новый репозиторий. Надо учитывать возможные проблемы с отсутствием памяти в будущем.
Рассылка в чаты
	При добавлении бота в чат и в администраторы чата бот получает возможность отправлять сообщения в чат.
	В главном меню личного бота требуется:
Выбрать чат, в который надо отправить сообщения
Ввести содержание сообщения
Ввести время и дату отправки сообщения (мск для РФ и гринвич для Европы)
Выбрать период и дни отправки сообщений

	Пример календаря можете посмотреть на видео:


https://drive.google.com/open?id=1hkDAcK8Bjr8hv2hIuKs6x3z0QDsY1HPT


Ответы боту
	При ответе на конкретное сообщение бота, бот фиксирует в гугл таблице:

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

Пример зависимости:

Бот: Сколько сегодня выручка?
Пользователь: 19 230
Бот: Отлично!

Бот: Сколько сегодня выручка?
Пользователь: 9 230
Бот: Это ниже среднего, завтра надо поднажать!


Алгоритм взаимодействия бота с пользователем в чате
1. Создаёшь через Телегу.
2. Запросы все висят в бд (не в гугле).
3. В Гугле есть какой то диапазон ячеек, откуда бот пытается вытащить зависимости.
4. Бот отправляет уведомление в чат.
5. В гугле появилась строка с датой и временем, названием чата, фразой запроса,
6. При ответе формируется такая же строка + дата и время ответа, фраза ответа, ник пользователя который ответил.
7. Бот соотносит вариант ответа с тем, что есть в таблице и если он есть, то отправляет реакцию, если нет то отправляет стандартную реакцию.

Доп 17.08.2019: В конце дня бот одним сообщением присылает статистику в личные сообщения владельца бота. Статистика подтягивается из сводной таблицы по дню в Гуглта лице.
Статистика бота
	Статистика выгружается в гугл док администратора.
	Данные, которые выгружаются:
суммарное количество запросов каждый час отправленных всеми пользователями
суммарное количество пользователей
список всех пользователей
суммарное количество оплат
количество оплат по каждому типу подписок
количество использования промокодов

Сейчас Статистика выгружается так:


Оплата
	Финансовая модель бота построена на ежемесячной подписке пользователя.
Для оплаты подписки требуется интегрировать
Яндекс. Кассе (для оплаты различными способами)

	Оплатить подписку на бота можно на следующие периоды:
месяц
3 месяца
6 месяцев
12 месяцев
безлимит
В бесплатном режиме пользователю доступно только 1 уведомление в день.
В платном режиме 100 уведомлений в день и выгрузка данных в Гугл док с реакциями бота.
За 1 неделю, 3 дня и 1 день до окончания платной версии бот в ЛС отправляет сообщение со ссылкой на оплату следующих периодов. Интеграция с таблицей и уведомления для каждого чата не удаляются, а только прекращают работу до момента оплаты следующего периода. Об этом надо предупредить при оплате бота.


Стоимость
	Стоимость подписки в зависимости от периода оплаты:


Языки
	Бот должен быть на 3 языках. Скорее всего, придется сделать клоны основного бота, которые будут каждый на разных языках.
	Языки:
русский
английский
немецкий
Реферальная система
	Реферальная система предусматривает вознаграждение привлекающему и привлекающемуся.
	При регистрации в основном боте пользователю предлагается ввести логин реферала, который ему порекомендовал этого бота.
После любой оплаты (минимум месяц) привлеченный и привлекающий пользователь получают по 1 месяцу бесплатного безлимитного пользования ботом.

Требуется предусмотреть возможность заработка денег на своих реферелах. От каждого привлекаемого пользователя привлекающий может получать деньги на свой кошелек в течение всего срока пользования ботом.
Промокоды
	Возможность создавать промокоды на скидки и на бесплатные месяцы.
	Пользователь вводит промокод в меню “Промокоды” в основном боте.
Справка
	Для обратной связи и решения вопросов в этом пункте мы оставляем контакты. Этот пункт иногда будет изменяться.

Рассылка сообщении

Рассылка сообщения через основного бота всем, кто установил бота себе.

Уточнения

Правильно ли я понял, что предполагаются:

Типы ботов:
• Основной бот
• Персональный бот

Роли, взаимодействующие с ботами:
• Администратор основного бота
• Клиент основного бота (может создает свои персональные боты)
• Пользователи персонального бота
• Участники группового чата с персональным ботом

Если роли и типы правильные, то хотелось бы соотнести какие действия может делать каждая роль, примерно в таком формате:

Основной бот - Администратор:
• Смотреть статистику
• Отправлять сообщения клиентам

Основной бот - Клиент:
• Выбрать язык основого бота
• Создать персонального бота
• Оплатить подписку
• Указать реферала
• Отправить сообщение в групповой чат
• Отправить сообщение пользователю (это не понял)
	•	Ввести промокод
	•	Получать статистику со всех ботов
	•	Получение рассылок от бота пользователю.

Персональный бот - Клиент:

	•	(Тут Клиент = пользователь)

Персональный бот - Пользователь:
• Создание уведомлений в каждый чат
	•	Удаление уведомлений из чата
	•

Персональный бот - Участник группового чата:
• получение уведомлений от бота участником чата
	•	ответы участника чата на уведомления от бота
	•	Реакция бота на ответ участника чата

Вопросы по пунктам ТЗ:

Создание личного бота
1. Какие бывают уведомления?
	⁃	Уведомления по сути одни и те же для всех - просто сообщение, которое отправляет бот в чат.
2. К одному аккаунту пользователя можно привязать несколько ботов для разных целей - Имеется в виду несколько Персональных ботов? Каким образом предполагается привязать бота к аккаунту пользователя?

Да, несколько персональных ботов к одному аккаунту. Привязка осуществляется через отправку основному боту токена созданного персонального бота в БотФазере. Таких ботом может быть несколько.

Рассылка в чаты
3. Правильно ли я понял, что речь в этом пункте идет про персонального бота?
Да, рассылка осуществляется персональным ботом в чаты, в котором он присутствует. Для каждого Чата свои рассылки.
4. Каким образом предполагается ввод даты и времени, а также периода и дней отправки? Можно пример диалога?

Да, так и вводился раньше в виде диалога.
Вводится в персональном боте.

5. Каким образом бот должен узнать откуда пользователь - РФ или Европа?
Можно просто привязаться к языку интерфейса телеграмма. Можно дать выбор языка и потом выбор системы оплаты.

Реакции бота на ответы
6. Речь идет о Персональном боте?
Да
7. Пришлите пожалуйста таблицу со всеми типами сценариев.

Типы сценарием задаёт пользователь.
Бот должен подтягивать эти зависимости из таблицы к которой привязана выгрузка из персонального бота.

Статистика бота
8. Как определяется администратор?
Это будут только я.

9. Администратор может быть в каждом Персональном боте или только в основном?
Только в основном. Доступа к персональным ботам у администратора нет.

10. Что такое "тип подписки"*?

Вариант оплаты:
	⁃	месяц
	⁃	Год и тд

Языки
12. Можно сделать чтобы при старте бота, он предлагал выбрать язык, после все диалоги будут на выбраном языке, в меню будет пункт смены языка. Такой вариант устраивает?
Да, устраивает.


Реферальная система
13. Каким образом предполагается обеспечить возможность заработка? Бот должен уметь перечислять суммы с одного кошеьлка на другой?

Пока заработок можно отложить. Сейчас будет достаточно получение бонусных месяцев работы за оплату.

Промокоды
14. Кто может создавать промокоды?
Только администратор, то есть я.

15. Промокод разовый? Да.

16. У него должен быть срок жизни? Задается админом.