chore(plan): admin-redesign 6-phase plan

PLAN.md + 6 subplans + CONTEXT.md

Strategy: Incremental | Mode: Automated | Execution: Orchestrator

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

plans/admin-redesign/phase-6-deep-pages.md

@@ -0,0 +1,117 @@
+# Phase 6: Deep entity pages
+
+**Status:** ⬜ Not Started
+**Parent plan:** [PLAN.md](./PLAN.md)
+**Domain:** frontend
+
+## Objective
+
+Заменить выезжающую `.user-panel` overlay на полноценную страницу с URL `#users/123`. Аналогично для session: `#sessions/456` = full detail page. Это самая комплексная фаза — она ломает совместимость с старым overlay UI (удаляет код), потому идёт ПОСЛЕ всех остальных.
+
+## Tasks
+
+- [ ] **User detail page** (`frontend/js/admin/sections/user-detail.js`):
+  - Реагирует на route `#users/:id`
+  - Layout:
+    - **Header**: avatar, name, role badge, email, action buttons (ban/edit/perms/delete), back-link to `#users`
+    - **Tabs** (sub-nav в странице):
+      - Overview — статистика (тестов, средний %, регистрация, посл вход)
+      - Sessions — таблица последних 20 сессий с pagination
+      - Classes — список классов где он состоит
+      - Audit — журнал действий (если есть audit log с user_id)
+    - **Graphs** (опционально, можно отдельным таб'ом):
+      - Простой SVG-чарт: успеваемость по неделям
+      - Mini-bar chart: avg % по предметам
+- [ ] **Session detail page** (`frontend/js/admin/sections/session-detail.js`):
+  - Реагирует на route `#sessions/:id`
+  - Layout: header (user, subject, score, дата) + список вопросов/ответов (правильно/нет, текст), back-link
+- [ ] **Router updates** (`frontend/js/admin/router.js` если ещё не поддерживает):
+  - `#users/123` → emit { route: 'users', params: ['123'] }
+  - `#sessions/456` → emit { route: 'sessions', params: ['456'] }
+- [ ] **Admin.js dispatch**:
+  - При route с params → init detail-section вместо list-section
+  - При route без params → init list-section (как раньше)
+- [ ] **Удалить overlay-код:**
+  - В `frontend/admin.html` удалить `<div class="user-panel" id="user-panel">` блок
+  - В `sections/users.js` удалить `openUserPanel`, `closeUserPanel`, `reloadUserPanel`
+  - В `sections/users.js` поменять onclick: `onclick="openUserPanel(event,${u.id},'${u.role}')"` → `onclick="AdminRouter.navigate('#users/${u.id}')"`
+- [ ] **Replace** в Phase 5 quick action "Sessions" — теперь `AdminRouter.navigate('#users/${uid}/sessions')`:
+  - Парсить sub-tab из route
+  - Открывать user-detail page с активным Sessions tab
+- [ ] **Глоссарий routes после фазы:**
+  - `#overview` — dashboard (Phase 3)
+  - `#users` — list
+  - `#users/123` — user detail (overview tab default)
+  - `#users/123/sessions` — user detail with sessions sub-tab
+  - `#sessions` — list
+  - `#sessions/456` — session detail
+  - … остальные без params — как было
+
+## Files to Modify/Create
+
+- `frontend/js/admin/sections/user-detail.js` — новый, ~400-600L
+- `frontend/js/admin/sections/session-detail.js` — новый, ~200-300L
+- `frontend/admin.html` — удалить `.user-panel` overlay, добавить `<div id="tab-user-detail">` и `<div id="tab-session-detail">`, добавить `<script>` теги
+- `frontend/js/admin/sections/users.js` — удалить overlay-функции (~100-150L удаления)
+- `frontend/js/admin/router.js` — улучшения parsing для sub-routes (если нужно)
+- `frontend/js/admin/admin.js` — dispatch logic для routes с params
+
+## Acceptance Criteria
+
+- Click на user row → URL становится `#users/123`, открывается deep page
+- F5 на `#users/123` восстанавливает страницу
+- Back navigation → возврат на `#users` list
+- Header содержит все action-кнопки (ban, edit, perms, delete)
+- Sub-tabs (overview, sessions, classes, audit) переключаются, URL обновляется
+- Старая `.user-panel` overlay полностью удалена из HTML и JS
+- Click на session id (в любом контексте) → `#sessions/456` → detail page
+- Нет console errors
+- Графики (если делаются) рендерятся корректно
+
+## Notes
+
+### Backward compat
+
+После Phase 6 старые ссылки/onclick типа `openUserPanel(...)` УЖЕ НЕ работают. Это intentional — мы их удалили. Но `onclick="AdminRouter.navigate('#users/N')"` работает везде.
+
+Если есть external links на админку user-panel — они продолжат работать как `#users/N` через router.
+
+### Графики
+
+Можно использовать chart.js (CDN ~50KB), но проще — inline SVG bar/line chart на нескольких десятках строк. У нас уже есть `.perf-bar` для процентов — можно расширить.
+
+Не обязательно делать графики в этой фазе — можно сделать MVP без них и добавить чартами позже. В acceptance criteria графики помечены опционально.
+
+### Audit log
+
+Если в БД есть таблица `audit_log` с `user_id` — sub-tab Audit показывает её. Если нет — sub-tab скрывается или показывает empty state "Audit logging не активирован".
+
+### Session detail
+
+Сейчас session detail открывается через `adminGetSessionDetail` → возвращает массив answers. Используем тот же endpoint, рендерим в полноценную страницу вместо modal.
+
+### Удаление overlay-кода (опасный шаг)
+
+Делать в КОНЦЕ фазы, после того как deep page работает. Сначала добавить deep page, протестировать, потом удалить overlay. Можно даже сделать отдельным коммитом ("remove overlay").
+
+### Что НЕ делать
+
+- Не делать realtime updates (Phase 7+)
+- Не делать collaborative cursors
+- Не оптимизировать графики до production-grade (chart.js or similar OK)
+
+## Review Checklist
+
+- [ ] Deep pages работают: F5, back/forward
+- [ ] Sub-tabs URL-обновляемы
+- [ ] Old overlay code fully removed
+- [ ] No regressions: ban/edit/delete user работают из deep page
+- [ ] Mobile-friendly: tabs scrollable, layout не ломается
+- [ ] Build passes
+- [ ] **Final smoke test:** пройти полный сценарий — открыть админку, найти пользователя через Cmd+K, перейти на deep page, выдать монеты, посмотреть сессии, забанить, разбанить, вернуться в overview
+
+## Handoff to Next Phase
+
+<!-- Это финальная фаза. Implementer записывает: что ещё не сделано,
+     какие follow-up задачи стоит зафиксировать (графики, realtime, мобильная версия).
+     Эти заметки помогут final-reviewer и при подготовке merge-summary. -->