Начало работы
Чтоб бот начал отслеживать сданные отчеты необходимо в группу вашей десятки в Телеграмме добавить чат бота @Evo2bot
Сразу после добавления бот начинает вести историю всех сообщений с хештегами. А также сообщает создателю о том, что появилась новая группа с предложением добавить ее к себе. После подтверждения приходит приветственное сообщение в группу о начале работы и стоимости. В этот момент формируется отчетная таблица для вашей группы.
Структура и описание таблицы
Чтоб получить ссылку на таблицу необходимо в чате вашей группы отправить сообщение #таблица. И в течении 1 минуты придет ссылка на таблицу. По ссылке таблица открывается для Чтения. Чтоб получить доступ Редактора необходимо прислать в личку @Alimakhin почту GMail и название своей команды. По этой почте открою доступ для редактирования. Кому это нужно? - Как правило для Контролеров, которые будут отмечать/редактировать сдачу отчетов и для Финансистов для отметки принятых штрафов.
Сформированная таблица содержит 4 листа: "Ежедневные отчеты", "Недельные отчеты", "Штрафы", "Настройки".
Первоначально необходимо зайти на лист Настройки и указать следующие данные:
1. Отчет КСД обязателен? (Да-Нет)
2. Дата и время сдачи первого отчета ПЗ (формат: ДД.ММ.ГГГГ чч:мм)
3. Дата и время сдачи первого отчета ОПЗ
4. Дата и время сдачи первого отчета ОН
5. Штраф в первый день, руб
6. Штраф со второго дня, руб
7. Штраф за недельные отчеты первый день, руб
8. Штраф за недельные отчеты со второго дня, руб
ВНИМАНИЕ: При не правильном указании сроков сдачи недельных отчетов (ПЗ, ОПЗ, ОН) бот будет не корректно воспринимать номера отчетов и сообщать, что отчеты не сданы (касается недельных отчетов). Если требуется помочь напишите мне - @Alimakhin
!!! ВНИМАНИЕ: Во избежании неверного заполнения и отображения отчетов запрещается изменять структуру таблицы (добавлять новые столбцы/строки). Если возникла таковая потребность напишите в личку создателю @Alimakhin он подскажет как это лучше и правильнее сделать.
Воспринимаемые хештеги
Отчет утро. #оу1 #оу01 #оу25 #оу100. Отчет принимается ежедневно до 09:59:59 включительно. Если ошибся номером дня или сдал после 10:00, присланный отчет не принимается и не отображается в таблице.
Отчет ключевое событие дня. #ксд03 #ксд99. Отчет принимается ежедневно до 09:59:59 включительно. По умолчанию этот отчет отключен, а значит не будет приходить упоминания о нем в ежедневной сводке, и в таблице будет пустая колонка с ксд. Для включения отчета в работу необходимо в таблице лист настройки поставить "Да" напротив строки "Отчет КСД обязателен?".
Отчет спорт. #ос1 #ос01 #ос40 #ос100. Отчет принимается ежедневно до 23:59:59. Если отчет не сдан или ошибка в номере дня, то в таблице остается пропуск, который расценивается как штраф.
К отчетам по спорту допускается прикреплять метрику в формате:
(сделал сегодня)/(сделал всего)/(цель сколько сделаю). Пример сообщения: #ос12 4/31/400 - Означает что вы сдаете отчет по спорту за 12ый день марафона, в отчете вы пробежали/проплыли/присели 4 км/м/раз. Всего за 12 дней вы сделали 31км/м/раз. Ваша цель за 100 дней сделать 400км/м/раз. Допускается писать сокращенно #ос12 4. В данном случае хештег от метрики необходимо отделить как минимум одним пробелом. Цель редактируется новым сообщением с выставленным значением цели (с) в формате: a/b/c, либо напрямую указав "#цель пробежать 400км".
Отчет вечер. #ов1 #ов31 #ов100. Отчет принимается ежедневно с 17:00 до 23:59:59 включительно. Логика написания та же что и у предыдущих отчетов.
Главное событие дня. #гсд1 #гсд61 #гсд100. Отчет принимается ежедневно до 23:59:59 включительно. Логика та же что и у отчета спорт.
План задач. #пз1 #пз02 #пз14. Номер плана задач зависит от недели марафона и начала сдачи отчетов. В таблице на листе "Настройки", которая будет в группе можно будет корректировать дату и время сдачи первого отчета #пз1. Остальные отчеты #пз2, #пз3,... принимаются с интервалом в 7 дней. Необходимо вписать время и дату до которого следует принимать отчет.
(Пример: в Настройках указано, что Дата сдачи первого отчета ПЗ - 02.01.2023 0:00:00. Это время означает, что уже 2.01.23 отчет ПЗ01 не будет приниматься! Время приема - 01.01.2023 до 23:59:59 включительно).
Полученный отчет с нарушением срока, после его сдачи будет записан в таблицу и выделен красным цветом, если он не будет удалять данные ранее верно записанного отчета. Соответственно если отчет приходит вовремя, он перезаписывает данные неверных отчетов и снимает выделение цветом.
Отчет по плану задач. #опз01#опз2#опз14 Отчет сдается спустя минимум 1 день после сроков постановки предыдущего отчета ОПЗ. (Пример: Срок сдачи ОПЗ01 - 09.01.2023 12:00, значит отчет ОПЗ02 будет приниматься с 10.01.2023 12:00 до 16.01.2023 12:00). В остальном логика отметки отчета та же, что и в ПЗ.
Отчет недели. #он1#он2 #он14 Логика принятия и отметки отчета недели та же что и в других недельных отчетов (ПЗ и ОПЗ)
Дополнительные хештеги:
#штрафы Показать штрафы. Посчитать количество не сданных отчетов с начала марафона. Показывает на всех участников общую информацию. Отчет будет показан как только Эва "зайдет" прочитать сообщения. Сразу не отвечает! (Время ответа до 1 минуты).
Чтоб убрать штраф у пользователя необходимо в таблице найти соответствующую ячейку (она будет пустой) и заполнить ее: если отчет есть (в случае отсутствия интернета или по другой уважительной причине) то заполнить пустую ячейку датой/временем сдачи отчета; если человек оплатил штраф, то заполняем словом "опл". Каждая пустая ячейка до текущего дня - штраф. Чтоб пользователю отметить все отчеты оплаченными достаточно на сообщение со всеми штрафами ответить "оплачено" - Эва все отметит.
#таблица Прислать ссылку на таблицу. Ссылка на Гугл таблицу вашей десятки. Ссылка придет не сразу! (Время ответа до 1 минуты). Если необходим доступ Редактора к таблице пришлите свою Gmail почту сюда @Alimakhin с указанием названия десятки.
Ежедневная сводка (рассылка)
Каждый день приходит сообщение от Эвы с отметкой всех тех кто за прошлый день не сдал отчет. Сводка за недельные отчеты (ПЗ, ОПЗ и ОН) добавляется в случае если на момент выписки прошло до 1 суток спустя срок сдачи соответствующего отчета недели.
В случае если задолженностей нет присылается "похвальное" сообщение.
Отметка штрафов. Если пользователь ответит на сообщение бота (сообщение с рассылкой) словами "оплатил" или "оплачено", то бот автоматически отметит оплату в таблице (пропишет слово "опл" в соответствующей ячейке и выделит желтым цветом). А также пропишет сумму штрафа в зависимости от сроков оплаты и количества отчетов. Сроков оплаты 2 - в первый день и последующие дни. Если в вашей десятке сумма не меняется, то на листе "Настройки" укажите одинаковую сумму. Логика следующая: бот сообщает что, вчера, предположим 7-ой день, была задолженность по отчету утро и спорт. Если в течении дня пользователь отвечает на сообщение, что он оплатил, то бот прописывает сумму штрафа "В первый день" умноженную на 2 (два отчета). Если же пользователь отвечает на сообщение на следующий день или далее, то бот прописывает сумму штрафа "Со второго дня" умноженную на 2 (два отчета).
Отчет есть, но Эва пишет что его нет. В ответ на ежедневное сообщение бота о штрафах можно ответить "есть" или "отчет был". Тогда бот проверит в своей истории и распишет по какой причине отчет не принят, либо если нарушения не выявлено извинится и все исправит.
Наиболее частые вопросы и ответы.
1. Эва следит за нами? - Эва сохраняет и ведет историю всех сообщений которые содержат хештеги. Если в вашем сообщении нет хештега, Эва его все равно прочитывает, и в сообщении ищет упоминания о себе (ключевые слова: "алимахин", "эва", "бот"). Если упоминания есть, то это сообщение (текстовая часть) пересылается автору. На это сообщение он может ответить прямиком в группу от лица Эвы.
Все остальные сообщения, в которых нет упоминания Эвы или нет хештега алгоритмами не рассматриваются и пропускаются мимо. Так что ответ таков: не следит за всеми сообщениями, но может включиться в разговор если о ней заговорят.
2. Почему мой отчет Эва не видит? - вот же он?!
Наиболее распространенные ошибки:
- 1) хештег написан не правильно. Ипользуются латинские буквы: оу ≠ oy. Или стоит пробел между хештегом и номером дня;
- 2) сообщение отредактировано после времени принятия отчета. Например: человек написал сообщение с хештегом #оу15 в 8:20, до 10:00 как положено. А уже днем вспомнил, что уже 16-ый день. Нашел свое сообщение и отредактировал хештег на #оу16. На следующий день в сводке Эва пишет утреннего отчета нет! И человек не понимает как так? - вот же отчет, время правильное (8:20), хештег правильный! - значит Эва глючит. А на самом деле в телеграмме внизу сообщения стоит надпись "изменено" и время отправления сообщения (а не время изменения сообщения). Поэтому отчет не принимается.
- 3) сообщение не отредактировано, но Эва все равно его не видит. Возможная причина во времени сдачи отчета - например вечерние отчеты принимаются после 17:00, это означает, если отчет сдали в 16:50 Эва его не запишет в таблицу и на следующий день скажет, что отчета не было. Или утренние отчеты сданные после прошествия времени сдачи. Такие отчеты в таблицу не вносятся.
- 4) сообщение отправлено с отложенной отправкой. Такие сообщения помечаются реакцией 😡 и не принимаются.
- 5) Можно указать несколько хештегов. Все они обработаются и примутся (если соблюдены все временные рамки и даты). Другие дополнительные хештеги, которых нет в списке выше на работу логики не влияют.
История обновлений, а также задачи на развитие можно увидеть в канале Эвы: https://t.me/evolution2bot