# Вопросы отделу аналитики

Цель созвона: понять, из чего состоит текущий скоуп отчётов, где именно расходятся метрики и как устроены доступы.

## A. Инвентаризация: что вообще есть

1. Сколько всего отчётов сейчас?

2. Эти пять слагов живые или мёртвые: `trader-capacity`, `trader-affiliate-native`, `merchant-out-in`, `traders-active`, `trader-teamlead`?

3. Есть ли отчёты вне halleg - на других серверах, в Google Sheets, в Metabase, в личных файлах?

4. Статистика за неделю у нас есть (см. ниже, блок «Что уже известно»). Уточнить по ней: почему `Affiliate Tier Board`, `Merchant SLU`, `traders-active` и `trader-capacity` за неделю не открыл никто? Они мёртвые, сезонные или просто про них забыли?

4a. В статистике есть отчёт Trader Shifts (8 415 посещений, 54 пользователя, второй по популярности), которого нет ни в реестре сайдбара, ни у нас в копиях. Что это и где живёт?

4b. `Trader Affiliate` открывали 1 334 раза всего 5 человек - 267 сессий на пользователя. Это живая работа или автообновление вкладки?

4d. Что такое `threshold-analysis`? Известно только, что он для админов. В навигации его нет, в статистике нет, копии у нас нет. Чем он занимается, кто им пользуется, надо ли тащить его в платформу? Связан ли он с метрикой `Capacity / Threshold` из `metrics-legend` - там формула порога через депозит, FX и `max_fill_pct`?

4e. Почему `metrics-legend` нет в навигации? Страница, по которой должны считаться все отчёты, доступна только по прямой ссылке, оформлен вне общей дизайн-системы и не подключает общий сайдбар. Это осознанно или про него просто забыли?

4f. Итого известных страниц 19, копий у нас 12. Остаются нужны: `trader-capacity`, `traders-active`, `trader-affiliate-native`, `trader-teamlead`, `merchant-out-in`, `threshold-analysis`, Trader Shifts.

5. Кто автор отчётов - один человек или несколько? Кто поддерживает их сейчас?

## B. Метрики: главный блок

6. `metrics-legend` - изначальный глоссарий, но содержит несоответствия с текущими данными.

6a. `metrics-legend` датирован 27.07.2026. Обновлялся ли он с тех пор где-то ещё - на Confluence, в другом файле, в другой версии страницы? Он сам ссылается на Confluence-страницу «Глосарій метрик», и непонятно, тот же это документ или другой.

6b. Если не обновлялся - почему? Что мешает: нет времени, непонятно кто должен, нет привычки, или просто не считается нужным?

7. Почему так получается: разные источники, разные фильтры, разные периоды, разное определение?

8. Кроме `metrics-legend` - есть ли описания метрик где-то ещё: Notion, таблицы, комментарии в коде, README?

10. Сколько примерно уникальных метрик по всем отчётам? (можно очень примерно, чтобы понять порядок)

11. Есть примеры, где одна и та же метрика в разных отчётах называется по-разному?

12. `metrics-legend` говорит, что источник - ClickHouse-реплика `hermes`, но описания внутри отчётов ссылаются на сущности Postgres. Откуда на самом деле считаются метрики? Один источник на всё или у каждого отчёта свой?

## C. Легенды и методология

13. У каких отчётов уже есть легенда/методология, а у каких нет?

14. Решено: легенда у каждого отчёта + подсказка у каждой метрики. Плюс общий справочник, которым станет импортированный `metrics-legend`. Все три - представления одного реестра метрик, так что дублирования работы нет.

14a. Следствие: подсказка нужна у каждой метрики, а описаний сейчас нет вообще у `Merchant SLU` и `Retention & Churn`, и мало у Detailed, THC, Affiliate-отчётов. Как будем дописывать недостающие? Есть рекомендации?

14b. Что ещё должно быть в легенде отчёта, кроме списка метрик: источник данных, период, известные оговорки, дата последнего обновления?

## D. Пользователи и доступы

16. Расскажите, как сейчас устроены доступы. 

- какие есть роли и как они называются;
- какие доступы у каждой роли - к каким отчётам, к чему ещё;
- где это прописано - таблица в базе, конфиг, код, файл, ничего из перечисленного;
- как роли назначаются - кто, каким способом, по какому поводу;
- сколько примерно людей в каждой роли.

17. Закрыто: 106 зарегистрированных, 96 активных за неделю (из статистики), все - внутренние сотрудники, внешних пользователей нет. «Внешние», о которых шла речь раньше, - это сотрудники других отделов, а не сторонние люди.

18. Можно получить выгрузку «пользователь → роль → доступные отчёты»? Обезличенную, имена не нужны. Из неё видно, какие наборы доступов реально повторяются, - это и есть будущие роли платформы.

21. Есть ли отчёты, где сейчас данные уже фильтруются по пользователю - человек видит только своих трейдеров или свой сегмент? Если да, при переносе это поведение нельзя потерять.

## F. Публикация и изменения отчётов

29. Сколько обычно у аналитика занимает сделать новый дашборд? А отчёт? Какие он шаги при этом проходит?

31. У `Weekly` есть `/api/weekly/health` с полем `last_refresh_ist`, у `Scoreboard` - ручной `/api/scoreboard/refresh`. У каких отчётов данные предрассчитаны, а у каких считаются при открытии? Как часто обновляется предрасчёт? Платформе нужно показывать у каждого отчёта, на какое время в нём данные.

### Поток запросов на изменения

32. Как часто просят внести изменения в существующие отчёты - сколько запросов в неделю или в месяц?

33. От кого запросы поступают чаще всего: какой отдел, какие конкретные люди? Есть ли один-два человека, генерирующих большую часть потока?

34. Поток запросов по одному отчёту уменьшается со временем или держится ровным? 

35. Какие изменения типичны: новая метрика, новый фильтр или разрез, исправление неверной цифры, косметика? Что из этого встречается чаще всего?

36. Сколько времени занимает типичная правка? Сколько запросов висит в очереди прямо сейчас?

37. Где аналитики получают запросы на изменения: трекер, таблица, чат, телеграм? Есть ли какая-то внутренняя доска задач на эти запросы?

## Материалы которые нужны

1. Выгрузка «пользователь → роль → доступные отчёты». Из неё видно, какие наборы доступов реально повторяются - это и есть будущие роли платформы.
2. Список всех существующих маршрутов приложения - чтобы понять, сколько отчётов существует на самом деле.
3. Копии недостающих страниц: `trader-capacity`, `traders-active`, `trader-affiliate-native`, `trader-teamlead`, `merchant-out-in`, `threshold-analysis` и Trader Shifts (если они активны).
4. Примеры JSON-ответов. Мы вытащили из копий 67 эндпоинтов, но только их адреса - что они возвращают, из кода не видно. Нужен один сохранённый ответ от каждого: скрипт проходит по списку, дёргает, складывает в файлы.