Приложение руководителя большой команды в Telegram, MAX и на сайте

Когда в команде несколько сотен человек, руководитель узнаёт о проблеме последним: поручение потерялось где-то на третьем уровне, а сводку собирают голосовыми. Заказчик хотел потрогать руками рабочую версию. Сначала я показал ему концепт интерфейса на 9 слайдов и два варианта фирменного стиля, в тот же день пошёл код.

Задача

Структура у заказчика строится по десяткам, сотням и тысячам: у каждого есть свой старший, у старшего свой. Руководителю нужно видеть всё дерево, ставить поручение вниз по цепочке и получать сводку, кто что сделал, без звонков по каждому.

Люди сидят в разных мессенджерах, часть в Telegram, часть в MAX, кто-то хочет открывать всё с компьютера. Поэтому три входа на одну базу: мини-приложение в обоих мессенджерах и сайт. Бот нужен только для входа, приглашений и уведомлений с кнопкой, которая открывает нужный экран. Вся работа идёт в самом приложении.

Отдельное условие: персональные данные людей из команды должны храниться по 152-ФЗ, а ИИ не должен видеть, кто есть кто.

Что я сделал

Структура. Новый человек приходит по ссылке-приглашению и встаёт к тому, кто его позвал. Пригласить может каждый. Без приглашения человек заводит свою структуру и становится её корнем. Подписи «десяток», «сотня», «тысяча» ставятся сами по числу людей. В карточке человека руководитель меняет роль (только ниже своей), переводит его в другую ветку или убирает: профиль при этом обезличивается. Ветку можно сделать отдельной структурой.

Поручения. Срок ставится с датой и временем. У каждого свой часовой пояс, он подхватывается из браузера и меняется в профиле. Срок хранит пояс автора и показывается по часам того, кто смотрит. Напоминания приходят за сутки и за 2 часа, утренний план в 9:00, а с 22 до 8 по местному времени человека бот молчит. Вкладки «Мне поручили», «Я поставил», «Вся структура», выполненное уходит в архив свайпом.

Главный экран. Сводка по команде, кольцо выполнения, достижения и таблица по подразделениям. Её руководитель видит первой.

База знаний. Материалы с правкой автором и файлы до 20 МБ. Аватарки браузер сам ужимает до 256 пикселей перед загрузкой.

ИИ. Три функции: секретарь руководителя собирает сводку по структуре, ответы по материалам приходят со ссылкой на урок, помощник подсказывает с текстами. Без ключа ИИ сводка собирается по правилам, так что приложение не ломается, если модель недоступна. Лимит 40 запросов в день на человека.

Вход. Мини-приложение проверяет подпись данных запуска, одна схема на Telegram и MAX. На сайт вход идёт через бота: ссылка с кодом, кнопка «Поделиться номером», сайт ловит вход сам. Номер телефона склеивает профили одного человека из двух мессенджеров и сайта.

Ещё сделал английский язык (интерфейс, бот, уведомления, документы, ИИ отвечает на языке человека), установку на главный экран телефона и две темы оформления с переключателем в профиле. Про разницу двух мессенджеров под капотом писал в статье про бота в Telegram и MAX на одном ядре.

Что было сложно

Telegram с сервера заказчика. Сервер стоит в Москве, и API Telegram с него отвечает таймаутами, а MAX открывается нормально. Запросы к Telegram я пустил через ретранслятор на своём сервере, у которого есть запасной адрес. Уведомление повторяется до трёх раз. Журнал HTTP-клиента пришлось заглушить: токен бота стоит прямо в адресе запроса и попадал бы в логи.

ИИ без персональных данных. До модели доходят цифры и метки вида «Группа 1», имена я подставляю обратно уже у себя. Перед отправкой отдельная функция вырезает телефоны, почты, ники, имена и фамилии людей из базы, в том числе одиночные имена в разных падежах. Ответ секретаря кэшируется на 20 минут, чтобы не гонять модель на каждое открытие экрана.

152-ФЗ и Telegram. Данные лежат в России, но Telegram для закона это трансграничная передача. Я объяснил это заказчику и предложил сделать MAX основным каналом, а Telegram оставить по желанию. Оператор данных сам заказчик. На сайте политика, согласие, условия и правила cookie. Без согласия сервер отвечает отказом с кодом 451, кнопка «Удалить мои данные» обезличивает профиль, раз в сутки данные чистятся по срокам. Плашка cookie говорит только о технических cookie, других там нет. Уведомление в Роскомнадзор подаёт заказчик. Подробнее про эту часть в статье про 152-ФЗ для ботов и мессенджеров.

iPhone. Первые замечания заказчик прислал с телефона. Экран уезжал вбок: iOS увеличивает страницу, если шрифт в поле меньше 16 пикселей. С иконки на рабочем столе шапка уходила под часы, а мини-приложение закрывалось случайным свайпом вниз. Поставил поля 16 пикселей на сенсорных экранах, отступ под вырез экрана, отключил вертикальные свайпы и подключил кнопку «Назад» самого мессенджера.

Права. Кто что видит и кто кого может переводить, пришлось продумать отдельно: роль можно дать только ниже своей, править материал может автор в своей ветке. Дерево собирается одним снимком, без запроса на каждого человека. Как такую матрицу доступа готовить заранее, разбирал в статье про роли и права.

Что получилось

Файлы из базы знаний в удалённую копию пока не входят, только база. Тестовая структура для показа убирается отдельным скриптом: без флага он только показывает, что удалит, с флагом делает копию и чистит. Реальных цифр по командам и поручениям у меня нет, приложение в стадии проверки заказчиком.

Что дальше

Заказчик попросил два следующих блока. Первый: курсы из уроков в базе знаний. Второй: чат команды, свободный или по делу, со звуком, который можно выключить, и возможностью написать старшим по цепочке. Испанский и французский добавлю тем же способом, что и английский. Видеохостинг для команды решили отложить. Когда в приложение придут настоящие люди, выключу демо-режим и уберу тестовую структуру. Про то, чем мини-приложение в MAX интересно бизнесу, писал в статье про Mini Apps в MAX.

Частые вопросы

Нужно ли что-то устанавливать?

Нет. Приложение открывается из бота в Telegram или MAX или в браузере. Если удобнее, его можно добавить иконкой на главный экран телефона.

Можно ли части команды сидеть в MAX, а части в Telegram?

Да. База одна, поручения и сводка общие. Если человек заходит из обоих мессенджеров и с сайта, номер телефона склеивает это в один профиль.

Что видит ИИ?

Цифры и обезличенные метки. Телефоны, почты, ники и имена вырезаются до отправки, имена в готовую сводку подставляются уже на нашем сервере.

Коротко о главном

Дольше всего в этом проекте заняли вещи вокруг самих функций: часовые пояса, доступность Telegram с российского сервера, поведение iPhone и закон о персональных данных. Поручения и дерево людей заняли меньше времени, чем права и напоминания с тихими часами. На следующий день после запуска заказчик уже работал в приложении сам и присылал замечания с телефона.

Если вам нужно мини-приложение для команды или клиентов со своей структурой, ролями и уведомлениями, я соберу его для Telegram и MAX. Напишите в Telegram, MAX или VK.