План дашборда

Версия 3.2 от 18 августа 2026 (версия 3.1 — 17 августа, версия 2 — 12 августа, версия 1 — 10 августа) Статус: волна 1 в проде, волна 2 начата.

Что сделано к 18 августа. Волна 1 закрыта и смёржена: сводка «Мой день», статусы сигналов, напоминания о проверке по нормативу 16 часов. Из волны 2 готов срез по наставникам — и данные, и экран в консоли. Бадди-пары теперь назначает только старший наставник. Появилась страница состояния программы: app.ju365.org/pulse.html, открывается без входа и обновляется сама.

Главное в этой версии

Волна 1 почти закрыта делом, а не планом. За пять дней вышло то, что мы собирались делать: кабинет наставника стал одним экраном, у каждого участника появилась недельная динамика и список заданий со статусами, наставник может написать слово к работе ребёнка. Отчёты родителям — волна 4 — тоже сделаны и уже работают в проде.

Поэтому приоритет сдвигается. Первым по значимости остаётся то, чего нет совсем: срез по наставникам для Рустама. Плюс появились три новые сущности, которых в плане не было вовсе, — долги по заданиям, бадди-пары и кабинет родителя, — и они дают дашборду новые показатели.

Журнал изменений: 12–17 августа

Снято с плана как сделанное: полоса активности и разрез по направлениям в карточке ребёнка (3.4), единый экран наставника (ядро 3.1), недельный отчёт родителям (волна 4).

Добавлено в версию 3: долги в зоне риска (4.2), архив отчётов для Рустама (4.6), жизнь бадди-пар (4.7), вовлечённость родителя (5.9), доля сдач с комментарием наставника (6).

0. О чём этот документ

В «Платформа подробное ТЗ» пять блоков. Часть — про контент и инфраструктуру: Google Sheets, Диск, Sites, распределение по психотипам. Они важны, но не влияют на ежедневную работу команды прямо сейчас.

Дашборд — единый рабочий экран, где видно состояние программы и каждого ребёнка. Пока его нет, решения «кто выпадает», «какой наставник тянет», «какое задание не работает» принимаются на ощупь и через переписку.

Что решаем:

1. Наставник за 5 минут в день понимает, к кому идти.
2. Рустам видит не только детей, но и работу наставников — и вмешивается до того, как ребёнок потерян.
3. Наталья видит, какие задания и направления работают, и правит контент по цифрам.

Что не входит в этот этап: синхронизация контента с Google Sheets (блок 1), склад магазина (блок 2), распределение по психотипам (блок 5), Google Drive и Sites (ТЗ №2).

1. Три уровня дашборда

Принцип общий — управление по исключениям: наверху то, что требует действия.

Готовность на 18 августа: L1 — сделан; L2 — сделан срез по наставникам, остальное впереди; L3 — есть страница состояния программы, экранов пока нет.

2. Что уже работает

У наставника, в Telegram — четыре вкладки:

• Команда — десятка по принципу исключений со счётчиком «нужно внимание: N»; по каждому участнику недельная динамика, разрез по направлениям, сравнение с прошлой неделей, список заданий со статусами (засчитано · ждёт вас · не сдано · долг), текстовые ответы из «Пульса», приватные заметки.
• Проверка — очередь работ: фото, текст, число, видео; видно описание задания и саму работу; можно написать слово к работе; подсказка про рабочее окно и про то, что до подтверждения награда не начислена.
• Отчёт — недельный отчёт родителю из трёх полей, с переключением недель.
• Заявки — выдача офлайн-наград и заявки на заморозку стрика.

Плюс автосигналы от бота при пропаже ребёнка на 2–3 дня и подтверждение видео кнопкой прямо в чате Telegram.

У Рустама: в консоли «Надзор» — все дети всех команд с фильтрами, смена наставника, начисление жукоинов, учётки и роли, вкладка «Бадди» для связывания пар. В боте — сводка по анкетам приёма, поиск участника, карточка с точкой А, колесо баланса, выгрузка, журнал доступа.

У Натальи: редакторы заданий, книг, магазина и «Слова наставника» со счётчиком сдач по заданию; команды и распределение детей; привязка родителей; «Мой ребёнок».

У родителя: прогресс ребёнка, направления, календарь занятий, книги, отчёты наставника.

Чего нет — ради чего этот план: сводной картины по наставникам; аналитики по заданиям и направлениям; воронки и удержания; ни одной цифры уровня программы.

3. L1 — кабинет наставника: волна 1 закрыта

Все три пункта сделаны и ждут апрува; ниже — что именно и почему так.

3.1. Сводка «Мой день» в шапке — сделано

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

mentor_day_summary() отдаёт все шесть чисел одним вызовом, шапка их показывает, каждое ведёт на свою вкладку. Правила внутри повторяют существующие один в один — иначе в шапке было бы «3 работы», а во вкладке две, и доверие к цифрам закончилось бы сразу. Когда очередь пуста, вместо чисел «На сегодня всё».

3.2. Видео из бота — в общий счётчик — снято, проблемы не было

Проблемы не было. Бот создаёт обычную сдачу со статусом «ждёт проверки», она попадает в ту же очередь приложения, а просмотр уже понимает приставку tg: и отправляет смотреть ролик в Telegram. Проверено на проде: очередь на уровне данных никогда не была раздельной.

3.3. Работа с сигналом доводится до конца — сделано

Три состояния: новый → взял в работу → закрыт с коротким комментарием («позвонил, болел», «поговорили, вернулся»). Наставник не теряет, с кем уже говорил, а у Рустама появляется объективная картина: кто реагирует, а кто листает список.

Попутно закрыта ловушка, которой в плане не было: генератор сигналов везде смотрел только на «новый». Без правки взятый в работу сигнал не закрылся бы автоматически, когда ребёнок вернулся, а ночью рядом появился бы дубль — наставник отметил «поговорили» и наутро получил тот же сигнал заново.

3.4. Напоминания о непроверенных работах — согласовано

Норматив 16 часов и напоминания каждые 4 часа. Полный регламент — в разделе 6. Наставнику приходит сама работа с кнопками, так что проверка делается из чата, не открывая приложение.

4. L2 — дашборд старшего наставника

Главный пробел. Рустам видит 100+ детей списком, но не видит наставников — а наставник и есть управляемое звено.

4.1. Срез по наставникам — сделано

Вкладка «Наставники» в консоли: карточка на человека, сверху те, кому нужна помощь. Колонки «сигналов без реакции дольше норматива» нет — срок реакции не назван (вопрос 1), и об этом сказано прямо на экране. Всё остальное из таблицы ниже показывается.

Сортировка по проблемности, светофор по десяткам. Одним взглядом: у кого забрать детей, кого обучить, кого поставить в пример.

4.2. Дети в зоне риска

Молчат 5 дней и дольше, потеряли стрик дважды за месяц, выполнение ниже порога две недели подряд — и новое: накопили больше N долгов. Долги оказались самым ранним признаком: ребёнок ещё заходит, но набирает несделанное.

4.3. Лента событий за сутки

Кто пропал, кто вернулся, кто вышел на уровень, кто потерял стрик, кому сменили наставника, какие послания ушли в чаты десяток. Читается за минуту.

4.4. Разрыв «родитель ↔ подросток»

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

4.5. Журнал доступа к анкетам

Журнал «кто и когда открывал анкеты» уже пишется — не хватает экрана.

4.6. Архив отчётов родителям — новое

Отчёты уже пишутся, и права на чтение у Рустама и методолога уже есть — нет экрана. Нужен список по неделям: кто написал, кто нет, и возможность выборочно прочитать. Ровно для того, ради чего в ТЗ заводилась слепая копия: увидеть наставника, который вместо поддержки пишет жалобы на ребёнка.

4.7. Жизнь бадди-пар — частично

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

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

5. L3 — дашборд методолога и руководителя

Не начат. Самая большая отдача на вложенный день — здесь.

5.1. Воронка запуска

Зарегистрировались → прошли анкету → сделали день 1 → дошли до дня 7 → до дня 30.

5.2. Удержание по когортам

Группируем по неделе старта, смотрим активность через 7, 14 и 30 дней.

5.3. Аналитика заданий

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

5.4. Баланс и покрытие направлений

Как выполняются четыре направления — и чем они наполнены на ближайшие 30 дней. Пустое «Цифровое» показало, что дыры в контенте обнаруживаются постфактум.

5.5. Экономика жукоинов

Начислено против потрачено, топ товаров, заявки в ожидании выдачи. Часть лотов закрыта до прохождения направления — это учитываем.

5.6. Книги

Сколько начали, средний процент прочтения, какие книги не идут.

5.7. Колесо баланса — динамика

Точка А строится по восьми осям. Достроить: групповой срез по программе и десяткам, повторные замеры со сравнением, разрыв «родитель ↔ подросток» как метрика. Нужен ответ на вопрос 5.

5.8. Потери на сдаче видео

Ребёнок нажал «Отправить видео», но до бота не дошёл или заявка истекла. Бот теперь здоровается сам, и часть потерь ушла, но измерять их всё равно нечем. Метрика: создано заявок → дошло роликов → подтверждено.

5.9. Вовлечённость родителей — новое

У родителя теперь полный кабинет, и это можно измерить: сколько родителей привязано к детям вообще, сколько заходило за неделю, сколько открывало отчёты. Родитель, который ни разу не зашёл, — риск для продления, и виден он только здесь.

6. Метрики — что согласовать

Регламент проверки работ — согласовано 17 августа

Норматив: 16 часов с момента, когда ребёнок отправил работу, до решения наставника.

Напоминания наставнику в Telegram — каждые 4 часа, пока работа не проверена. Первое приходит через 4 часа после сдачи, дальше в 8, 12, 16 часов и так далее. Счёт не останавливается на трёх сообщениях: наставник не должен иметь возможности «пересидеть» напоминания.

В напоминании — сама работа, а не абстрактное уведомление. Имя ребёнка, задание и содержимое сдачи: фото, текст, число или видео. Под ним две кнопки — «Подтвердить» и «Вернуть». Нажатие закрывает сдачу по-настоящему: напоминания прекращаются, ребёнок сразу получает опыт, а у Рустама фиксируется время реакции.

Отдельной кнопки «Проверено», которая только гасит напоминание, не будет намеренно. Она позволила бы отметить работу проверенной не открывая её — наставник бы отчитался, а ребёнок остался без опыта, потому что награда начисляется только при подтверждении.

Тихие часы: с 22:00 до 08:00 бот молчит. Напоминание, попавшее на ночь, переносится на 08:00. При этом счёт 16 часов идёт непрерывно — ночь просрочку не отменяет, иначе работа, сданная вечером, законно висела бы до следующего вечера.

После 16 часов напоминания продолжаются каждые 4 часа, и одновременно просрочка попадает в срез по наставникам у Рустама. Наставник видит давление, старший наставник — тех, кто его игнорирует.

7. Порядок работ

Оценки в рабочих днях. Волна 1 сократилась: большая часть уже в проде.

Волна «отчёты родителям» из версии 2 исчезла — сделана. Итого 3–4 недели вместо 4–6.

Волна 0 блокирующая: без согласованных порогов дашборд покажет цифры, о значении которых мы не договорились.

Страница состояния программы

app.ju365.org/pulse.html — открывается без входа, пересылается ссылкой, обновляется сама. Считает те же правила, что и рабочие экраны: разойтись числам нельзя. Список «Требует решения» на ней собирается сам и пустеет, когда вопросы закрывают.

8. Вопросы, на которые нужны ответы

1. Реакция на сигнал. За сколько часов наставник обязан отреагировать на красный сигнал — ребёнок пропал на 3 дня и больше? Срок проверки работы уже согласован: 16 часов, регламент в разделе 6.
2. Рабочее окно. 18:00–22:00 как в приложении или 18:00–20:00 как в ТЗ? От этого зависит, считается ли просрочкой работа, присланная ночью.
3. Пороги. Ниже скольких процентов выполнения поднимаем флаг и со скольких долгов ребёнок попадает в зону риска?
4. Отчёты родителям: где они живут. Сейчас отчёт остаётся в приложении, родитель видит его в своём кабинете — это «Вариант А» из ТЗ. Методолог рекомендовала «Вариант Б»: готовый текст, который наставник копирует и отправляет маме в WhatsApp. Оставляем как есть, добавляем кнопку «скопировать для WhatsApp» или переходим на второй вариант целиком? И считается ли ненаписанный отчёт нарушением, которое видит Рустам?
5. Повторный замер колеса. На каком месяце делаем второй срез — и опрашиваем только подростка или снова обоих, чтобы увидеть, как меняется разрыв?
6. Анкета в карточке ребёнка. Наставник видит ответы своего подопечного — да или нет? Наш вариант: цели и сильные стороны видит, «страхи» и «тень» — только Рустам и методолог.
7. Слово наставника: требование или добрая воля? Комментарий к работе сейчас необязателен. Если это часть работы наставника — ставим норматив и показываем долю в срезе. Если добрая воля — не измеряем вовсе.
8. Бадди-пары. Кто назначает — решено: только старший наставник. Осталось: по какому принципу собираем пару и что делаем, когда пара не работает — расформировать или менять состав?
9. Видимость между наставниками. Наставник видит только свою десятку или общий рейтинг десяток? Соревнование мотивирует, но может демотивировать отстающих.
10. Процедура при плохих показателях наставника. Дашборд должен поддерживать конкретные шаги — предупреждение, обучение, передача детей, — а не просто подсвечивать красным.
11. Кто ещё смотрит L3? Только Наталья и руководители — или Асхату отдельный упрощённый экран «главное за неделю»?

Приложение. Техническая база (для IT)

Готово и переиспользуется: v_mentor_exceptions, coach_overview(), mentor_alerts с генератором, daily_activity, task_completions с работами, комментарием наставника и статусом, child_stats() (направления и OVR), mentor_child_week(), mentor_child_tasks(), mentor_day_progress(), mentor_reports + mentor_week_reports() (читает наставник и is_admin), parent_child_reports(), buddy_pairs + admin_list_buddies / admin_set_buddy, admin_task_usage(), долги из overdue_tasks, streak_recalc (стрик считается пересчётом, а не на ходу), xp_ledger, reading_progress, redemptions, mentor_notes, intake_* + intake_access_log, proof_requests с notified_at.

Что нужно для регламента проверки (волна 1a):

• reviewed_at / reviewed_by в task_completions, запись в обоих путях — и при решении в приложении, и по кнопке в Telegram. Без этого 16 часов не измерить;
• очередь напоминаний: у сдачи next_remind_at и счётчик отправленных, чтобы после перезапуска бота ничего не терялось и не дублировалось;
• задание в планировщике бота (APScheduler уже есть) — проход раз в 15–30 минут: кому пора напомнить, с переносом попавших на 22:00–08:00 на утро, Asia/Almaty;
• отправка работы в чат: фото, текст и число — прямо в сообщение, видео — пересылкой по tg:<file_id>, механика уже написана для сдачи видео;
• обработчик кнопок «Подтвердить» / «Вернуть» в боте уже есть — расширить на все типы работ, а не только на видео;
• сужение прав на бадди: admin_set_buddy / admin_clear_buddy / admin_list_buddies перевести с is_admin() на is_head_coach() (миграция) и убрать вкладку у методолога.

Чего не хватает помимо этого:

• сигналы читаются из производной вьюхи, а не из mentor_alerts; для времени реакции нужен переход на таблицу и запись момента взятия в работу;
• очередь проверки не сведена: приложение и бот показывают её раздельно;
• нет агрегатов по заданиям и когортам — считать на лету по 100+ детям × 365 дней дорого, нужны материализованные представления с ночным пересчётом;
• нет счётчика заходов родителя (есть users.last_active_at, этого хватит для начала);
• повторные замеры колеса требуют второй анкеты в боте.

Где живёт: кабинет наставника и ребёнка — в Telegram, консоли Рустама и Натальи — веб по логину и паролю, анкеты — в боте. Ничего нового разворачивать не нужно.