# Задание A24: маршрутизация как главный экран управления

## Дата поступления
2026-08-24

## База
Проверочный HEAD на момент выдачи: **`6b8a4aa`**.

## Ветка
`antigravity/routing-control-center`

## Порядок исполнения

Два прохода, как прежде: **Flash** реализует, **Pro** проводит аудит. Пункт **P0-6** написан для аудитора.

---

## Порядок работы с git

```
cd <каталог репозитория>; git fetch origin --prune; git status
git checkout main; git pull --ff-only origin main
git checkout -b antigravity/routing-control-center
git commit -m "..."          <- сначала коммит
git push -u origin antigravity/routing-control-center
```

В `main` напрямую не пушить. В конце — push и проверка `git log --oneline -1 origin/antigravity/routing-control-center`, `git status` чистый.

---

## Что случилось перед этим заданием

Владелец установил Hub на две машины и прошёл сценарий вживую. Разобрано и **уже исправлено ревьюером**, переделывать не нужно:

- веб-сервер не запускался на Windows — установщик не ставил `fastapi` и `uvicorn`;
- окно приложения показывало «отказано в подключении» — лаунчер убивал сервер, потому что `WaitForExit` у Edge возвращался мгновенно при уже запущенном браузере;
- установщик по галочке «Запустить» открывал десктоп вместо веба;
- «Ролей в строю: 0/6» при пяти работающих — готовность не засчитывала роли на резерве;
- диаграмма перерисовывалась на каждое событие `<Configure>`, окно ползло после отпускания мыши.

**И главное, из чего надо сделать вывод.** В веб-мастере подключения стояли **выдуманные коды устройства** `GRK-7842` и `CDX-9104` и жёстко вписанный адрес `x.ai/device`, отдающий 404. Мастер не был подключён к серверу вовсе — владелец вводил бы несуществующий код бесконечно.

Хуже: тест `test_headless_server_auth_matrix` **требовал** наличия этого адреса в коде, то есть закреплял выдумку как требование и защищал её от исправления.

Это тот класс дефекта, ради борьбы с которым проект и затевался: первый аудит нашёл выдуманные проценты квот, и вот выдумка вернулась в новом коде. **Ни одного значения, которого не дал провайдер или измерение.** Не готово — так и напишите в интерфейсе.

---

## Решение владельца: перестройка навигации

Дословно: «в маршрутизации надо сделать возможность просто переставлять блоки, ну и менять модель, кнопка настроить не нужна»; «команда агентов лишняя вкладка, выбор моделей должен быть в обзоре и в маршрутизации»; «модели и провайдеры вообще не надо оставлять, перераспредели между маршрутизацией и обзором»; «аналитику оставь».

Итог — **семь разделов вместо девяти**:

```
Обзор  Аккаунты  Маршрутизация  Аналитика  Состояние  Журнал событий  Настройки
```

Убираются: **«Команда агентов»** и **«Модели и провайдеры»**.

## P0-1. Маршрутизация — главный экран управления

Сейчас цепочка меняется через кнопку «Изменить цепочку», открывающую отдельное окно. Кнопка не нужна.

**Что требуется:**

1. **Перестановка блоков перетаскиванием.** Основной и резервы меняются местами мышью, прямо в цепочке. Порядок сохраняется через существующий `AutoAssigner` и переживает перезапуск.
2. **Смена модели на месте.** У каждого блока — выбор модели, без перехода в другое окно. Действие `set_model` уже существует, второй реализации не заводить.
3. **Кнопку «Изменить цепочку» убрать.**
4. Добавление и удаление профиля из цепочки остаётся доступным — решите, как, но не отдельным окном настроек.

Осторожно с двумя вещами:

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

**Тест:** перестановка сохраняется в конфигурацию и видна после перезапуска; смена модели с экрана маршрутизации доходит до `router_profiles.yaml`.

## P0-2. Убрать «Команду агентов», перенести содержимое

Раздел показывает роли с назначенными профилями и квотами — то же, что маршрутизация, но без управления.

Перенести в маршрутизацию то, чего там нет: описание роли («Основная разработка кода», «Read-only поиск в кодовой базе») и оперативную квоту активного профиля.

Пункт навигации и `renderTeam` удалить.

Отдельно про подачу, владелец на это обращал внимание: на карточке роли «Кодер 1» было написано «Назначенный аккаунт: **Кодер 2**». Формально верно — это имя профиля `ag-w2`, — но читается как путаница ролей. **Показывайте почту аккаунта**, а имя профиля оставьте второстепенным.

## P0-3. Убрать «Модели и провайдеры», перераспределить

Сейчас там: имя провайдера, «Всего слотов / Подключено / Онлайн», кнопка «Запросить модели» и список обнаруженных моделей.

Куда переезжает:

- **счётчики слотов и подключений** — в «Обзор», к блокам провайдеров на схеме маршрутизации. Числа там уже есть частично, сведите в одно место;
- **список обнаруженных моделей** — в выбор модели: он и нужен именно там, а отдельным списком бесполезен;
- **кнопка «Запросить модели»** — рядом с выбором модели. Это ручное обновление из A23, действие `refresh_models` существует;
- **доступность runtime и версия CLI**, если показываются, — в «Состояние», к остальной диагностике.

Пункт навигации и `renderProviders` удалить.

## P0-4. Выбор модели на «Обзоре»

Владелец просит выбор моделей и там. На «Обзоре» роли уже показаны на схеме — добавить выбор модели прямо в узле роли.

То же действие `set_model`, тот же список из кэша обнаружения. При пустом кэше — «список моделей ещё не получен» и кнопка обновления, **никаких литеральных списков**.

## P0-5. Аналитика остаётся, но должна объяснять себя

Владелец: «аналитика тоже непонятно что показывает пока». Раздел остаётся, данные в нём настоящие — их нужно объяснить.

Сейчас видно: всего вызовов 33, доля отказов 63.6%, латентность P50/P95/MAX, разрезы по провайдерам и ролям, токены `Н/Д (не отдаются)`.

Требуется:

- **подпись у каждой метрики**, что она означает и за какое окно. «Всего вызовов (24ч)» есть, у остальных нет;
- **P50 = 0.0 ms при MAX = 7.8 s** выглядит как поломка. Разберитесь и объясните на экране: если медиана близка к нулю потому, что большинство вызовов падают мгновенно, так и напишите. Если это дефект подсчёта — почините;
- **пустые строки таблицы** (`claude`, `grok` с нулями и `Н/Д`) — либо скрывать неподключённых провайдеров, либо помечать, что аккаунт не добавлен, а не показывать как «ноль вызовов»;
- зачем экран нужен, одной строкой сверху.

## P0-6. Аудит вторым проходом

Для проверяющего. Список составлен из дефектов, которые уже проходили мимо первого прохода.

1. **Выдуманные значения.** Только что найдены захардкоженные коды устройства в мастере. Пройдите весь новый код и убедитесь: ни одного значения, которого не дал провайдер или измерение. Особое внимание — заглушкам, которые «пока поставим, потом заменим».
2. **Тесты, закрепляющие дефект.** Тест требовал наличия неверного адреса. Проверьте, что новые тесты проверяют желаемое поведение, а не текущее.
3. **Запустить изменённое.** В A15 вынесли действия и уничтожили класс приложения — модуль импортировался, тесты проходили, приложение не запускалось.
4. **Пути и команды в текстах интерфейса.** Инструкция вела на несуществующий `launcher/main.py`. Каждый путь должен существовать.
5. **Побочные изменения.** Дважды ревьюер находил в диффах правки, к заданию не относящиеся: блокировку файла перевели на бесконечное ожидание, действие не занесли в контракт. Просмотрите диффы файлов, которых задание не касалось, и объясните каждое изменение.
6. **Пропущенный пункт назвать пропущенным.**

---

## Ограничения

- Десктоп (`router/ui/**`) в этом задании **не трогать**: перестройка только в вебе. Паритет нарушится осознанно, десктоп остаётся как есть.
- Правило честности без исключений. Нет данных — «Н/Д» и причина; не реализовано — так и написать.
- Действия только через существующий `action_handler`; второй реализации `set_model` и `refresh_models` быть не должно.
- Меняете контракт — правьте `docs/web-api/CONTRACT.md` и скажите в отчёте.
- Тег `v0.1.1` не создавать.

## Критерии приёмки

1. Ветка в `origin`, `git status` чист.
2. Разделов семь; `renderTeam` и `renderProviders` удалены вместе с пунктами навигации.
3. В маршрутизации блоки переставляются мышью; порядок сохраняется и переживает перезапуск; проверено тестом.
4. Модель меняется с экрана маршрутизации и с «Обзора»; изменение доходит до конфигурации; проверено тестом.
5. Кнопки «Изменить цепочку» нет; отменённое перетаскивание не теряет блок.
6. Содержимое удалённых разделов перенесено полностью; в отчёте таблица «что куда переехало».
7. На карточке роли виден аккаунт, а не имя профиля, похожее на другую роль.
8. У каждой метрики аналитики есть подпись; расхождение P50 и MAX объяснено или исправлено; неподключённые провайдеры не показаны как «ноль вызовов».
9. Ни одного выдуманного значения; проверено отдельно и описано в отчёте.
10. `ruff check .` чисто; релизный гейт не ухудшен.
11. **Скриншоты: маршрутизация с перетаскиванием, выбор модели, «Обзор», аналитика.** Открыть и посмотреть перед отправкой.
12. Отчёт: `START_HEAD`, `FINAL_HEAD`, `origin/main`, `git status`, `X passed / Y skipped / Z failed`. На `main` сейчас 375 passed, 2 skipped.

## Главное

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

## Порядок сдачи
Передать точный `FINAL_COMMIT_SHA`. Сдано только после появления коммита в `origin`.
