# Платформа: решения и открытые вопросы

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

## Что строим

Внутренняя аналитическая платформа для отделов компании. На старте три отдела: аналитика, работа с трейдерами, саппорт. Остальные подключаются позже.

Подход: сначала объединить уже работающие решения как есть, менять постепенно.

## Решения

### Продукт

- UX существующих отчётов не меняем.
- Цвета существующих отчётов приводим к единому виду.
- Исправляем то, что сильно замедляет работу или делает код плохим.
- Экраны интерактивные.
- Мобильную версию не делаем.
- Языки: EN, RU, UA - все три, все реально используются.
- Тема одна.
- Экспорт делаем везде. Экспорт обязан уважать права.

### Доступы

- Ролевая модель: отдел → роль → набор отчётов.
- Права только на уровне отчёта целиком. Прав на уровне строк и колонок на этой итерации нет.
- Источник данных о сотрудниках для блокировки доступов - CRM, её подключает CTO.
- Пользователей 106 зарегистрированных, 96 активных за неделю. Все внутренние сотрудники, внешних нет.

### Метрики

- Реестр метрик строим с нуля, после демки.
- Легенда у каждого отчёта плюс подсказка у каждой метрики.
- Определения метрик верифицирует аналитик.
- Существующий глоссарий `metrics-legend` найден, копия получена.

### Статистика использования

- Логирование посещений и дашборд использования реализуем на платформе.

### Инфраструктура

- Платформа живёт на своём сервере, не на halleg.
- Отчёты переезжают на платформу целиком, вместе с кодом и бэкендом. halleg выводится из эксплуатации. Решено 21.09.2026, было пунктом 20 в `questions-cto.md`.
- Внутренний домен.

### Разделение работ

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

## Состав демки

Проговорено четырьмя пунктами:

1. Оболочка с логином и переключателем роли.
2. Каталог отчётов с поиском.
3. Существующие отчёты: поправить по цветам, не меняя UX. При необходимости исправить критичное для скорости.
4. Страница глоссария метрик и экран админки с матрицей доступа.

Срок: кликабельная демка через неделю от 17.09.2026. Первый зритель - CTO, затем остальные.

## Что в демку не входит

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

## Открытые вопросы

- Стек демки не подтверждён.
- Судьба переключателя темы в существующем сайдбаре не обсуждалась.
- Нет копий семи страниц: `trader-capacity`, `traders-active`, `trader-affiliate-native`, `trader-teamlead`, `merchant-out-in`, `threshold-analysis`, Trader Shifts.
- Нет выгрузки «пользователь → роль → отчёты», без неё состав ролей неизвестен.
- Нет примеров ответов API, структура данных неизвестна.

## Предложено мной, не подтверждено

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

## Материалы

- `questions-analytics.md` - чеклист созвона с отделом аналитики.
- `questions-traders-support.md` - чеклист для отделов трейдеров и саппорта, созвоны раздельные.
- `questions-cto.md` - вопросы и решения для CTO.
- `metrics-conflicts.md` - разбор метрик: расхождения между отчётами, сверка с `metrics-legend`, проверка его актуальности, что дают эндпоинты.
- `report-weight.md` - измерения тяжести отчётов: вес страниц, трафик, вызовы API, пик нагрузки.
- `../platform/schema.md` - схема данных платформы: отделы, роли, пользователи, отчёты, метрики, версии определений.
- `../platform/data/` - реестр отчётов (19), стартовый реестр метрик (74, из них 15 канонических), заглушки отделов, ролей и пользователей.
- `../platform/api/contract.md` - черновик нашего API и примеры ответов в `examples/`.
- `../platform/app/index.html` - кликабельная демка: вход и переключение роли, каталог, отчёты с легендой, глоссарий метрик, админка. Открывается двойным кликом. Скриншоты в `app/snapshots/`, прогон `tools/shoot_demo.js`.
- `../tools/` - скрипты, которыми всё это собрано из копий halleg; пересборка в порядке extract → parse_canon → build_reports → build_metrics.