35 lines
4.2 KiB
Markdown
35 lines
4.2 KiB
Markdown
 
|
# Итог: сравнение двух запусков в разделе «Аналитика»
|
|||
|
|
|
|||
|
|
План: [2026-10-04_10-08_analytics-run-compare-plan.md](2026-10-04_10-08_analytics-run-compare-plan.md).
|
|||
|
|
Статус: код написан и проверен (gofmt, build, vet, test, синтаксис JS); стенд **не пересобирался**.
|
|||
|
|
|
|||
|
|
## Что изменено
|
|||
|
|
|
|||
|
|
- **control-api** (`internal/analytics/compare.go`): таблица семи индикаторов (ключи совпадают с видами списков), `Compare(base, target)` — группы `new`, `left`, `common`, `changed`, `same`, разложение каждого индикатора (`delta = new − left + entered − exited`), матрица переходов вердикта, число отменённых. `List(group, filter)` с фильтрами `indicator`, `from`/`to` и столбцом «Что изменилось».
|
|||
|
|
- **API**: `GET /admin/analytics/compare` и `GET /admin/analytics/compare/lists/{group}` (JSON и CSV); `400` — неверные или одинаковые id, `404` — нет запуска, группы, индикатора или фильтра, `409` — запуск идёт. Загрузка отчёта запуска вынесена в общую функцию, кэш общий.
|
|||
|
|
- **Дашборд**: страница `/analytics/compare` (выбор A и B, «Поменять местами», карточки групп, «Динамика по индикаторам», «Переходы вердикта», диалог со списком и CSV); прокси списков и CSV; кнопка «Сравнить с другим запуском» на `/analytics`.
|
|||
|
|
- **Общий диалог**: код списков вынесен в `static/analytics-dialog.js`, разметка — в шаблон `analytics_dialog.html`; страница одного запуска перешла на него.
|
|||
|
|
- **Документы**: `API.md`, `USAGE.md`, `DASHBOARD.md`, `README.md`.
|
|||
|
|
|
|||
|
|
## Отклонения от плана
|
|||
|
|
|
|||
|
|
1. Добавлена группа `common` (карточка «Общие» и ячейки матрицы открывают список через неё).
|
|||
|
|
2. Фильтр `indicator` для `changed`/`same`/`common` — «хотя бы в одном из запусков».
|
|||
|
|
3. Неверные `from`/`to` дают `404`, как другие неверные виды списков; к имени CSV добавляется суффикс `_<from>-<to>`.
|
|||
|
|
4. Разметка диалога вынесена в отдельный шаблон.
|
|||
|
|
|
|||
|
|
## Особенности
|
|||
|
|
|
|||
|
|
- Адрес, оставшийся в тех же индикаторах, но с другим набором проваленных целей или площадок, считается неизменившимся (`same`).
|
|||
|
|
- Дубли IP внутри запуска не обрабатываются (в реестре IP уникален).
|
|||
|
|
|
|||
|
|
## Проверки
|
|||
|
|
|
|||
|
|
- `gofmt -l` пусто; `go build ./...`, `go vet ./...`, `go test ./...` — все пакеты `ok`; `node --check` для трёх JS-файлов.
|
|||
|
|
- Исправлено при ревью: в тесте дашборда число с неразрывным пробелом (`6 440`); в `TestRouteTableIsClassified` число admin-маршрутов 39 → 41.
|
|||
|
|
- Новые тесты: инварианты сравнения (числа индикаторов равны `summary`, разложение `delta`, сумма групп и матрицы), все группы и фильтры, тексты «Что изменилось», API (отчёт, списки, CSV, коды ошибок), дашборд (пара по умолчанию, предупреждения, прокси, страница одного запуска после выноса диалога).
|
|||
|
|
- Не проверено: страницы в браузере (диалог на `/analytics`, «Поменять местами», клики по матрице) и сравнение на данных стенда.
|
|||
|
|
|
|||
|
|
## Выкладка
|
|||
|
|
|
|||
|
|
Не выполнена. Нужны пересборка и перезапуск `control-api` и `admin-dashboard`; миграций нет.
|