Веб-UI: темы, навигация API, статистика и доработки API

- Шапка: логотип Kubernetes, ссылка на главную, выпадающее меню API (Swagger/ReDoc/Health), переключатель светлой/тёмной темы (localStorage).
- Светлая тема в синей гамме; выравнивание кнопки темы в ряду с пилюлями.
- Дашборд: единая карточка ошибки health/stats, подсказка Docker/Podman, поле container_cli в GET /stats, total_workers_from_meta всегда число (0 без meta).
- Правки кластеров, job_store, compose, документация и частичные шаблоны.

app/docs/api_routes.md

@@ -56,11 +56,12 @@
 
 - Хранятся **только в памяти** процесса uvicorn; после перезапуска контейнера история обнуляется.
 - В памяти держится не более **200** записей; при превышении старые задания вытесняются (`app/core/job_store.py`).
+- Снимок заданий сохраняется в JSON в каталоге **`clusters/`** (файл **`kind_k8s_jobs.json`** на томе с хоста) — после перезапуска контейнера список восстанавливается. Записи в статусе **queued**/**running** при старте помечаются как **failed** (процесс уже не выполняется). Путь переопределяется переменной **`KIND_K8S_JOBS_JSON`**.
 - Создание кластера: `POST /api/v1/clusters` → опрос `GET /api/v1/jobs/{job_id}` (как в веб-UI).
 - В ответе задания поля **`progress_stage`** (текст этапа) и **`progress_percent`** (0–100) обновляются во время создания.
 - В **GET /api/v1/jobs** (список) поле **`progress_log`** всегда **пустой массив** — меньше трафика; полный хвост — в **GET /api/v1/jobs/{job_id}** (лимит строк: `KIND_K8S_JOB_API_LOG_MAX_LINES`, по умолчанию **5000**).
 - Буфер строк в памяти на задание: `KIND_K8S_JOB_LOG_MAX_LINES` (по умолчанию **2500**); при переполнении старые строки вытесняются.
-- Для **`docker pull`** по умолчанию: **`--progress=plain`** и вывод **без PTY** (`KIND_K8S_DOCKER_PULL_PLAIN=1`) — в журнале идут строки с процентами/слоями. Для **podman** и **kind** — псевдо-TTY по `KIND_K8S_STREAM_PTY`, из строк убираются ANSI-коды.
+- Для **`docker pull`**: если в справке **`docker pull --help`** объявлен флаг **`--progress`**, при **`KIND_K8S_DOCKER_PULL_PLAIN=1`** вызывается **`--progress=plain`** без PTY; на старых CLI флаг не передаётся (нет строки «unknown flag» в журнале). Для **podman** и **kind** — псевдо-TTY по `KIND_K8S_STREAM_PTY`, из строк убираются ANSI-коды.
 - Тип задания **`kind`**: `create_cluster`, `start_cluster` (подъём по сохранённому конфигу), `start_containers` (запуск уже созданных узлов), `stop_containers` (остановка узлов).
 - Статус **`cancelled`** — запрошена отмена (`POST .../cancel`); дочерний процесс текущей команды получает принудительное завершение.
 
@@ -163,12 +164,13 @@ Accept: text/markdown
 
 ## GET /api/v1/stats
 
-Сводная статистика для дашборда и **метрики запущенных узлов kind** (один вызов `docker stats` / `podman stats` на набор имён контейнеров `имя-control-plane`, `имя-worker`…).
+Сводная статистика для дашборда и **метрики запущенных узлов kind** (один вызов `docker stats` / `podman stats` на набор имён контейнеров `имя-control-plane`, `имя-worker`…). Поле **`container_cli`** совпадает с **`CONTAINER_CLI`** в среде приложения (`docker` или `podman`) — по нему UI показывает, что **все** узлы kind и сбор метрик идут через выбранный CLI.
 
 **Пример ответа 200:**
 
 ```json
 {
+  "container_cli": "docker",
   "kind_clusters_count": 1,
   "local_cluster_dirs_count": 1,
   "total_workers_from_meta": 2,
@@ -200,15 +202,30 @@ Accept: text/markdown
       "note": null
     }
   ],
-  "cluster_resources_error": null
+  "cluster_resources_error": null,
+  "aggregate_cluster_resources": {
+    "nodes_count": 2,
+    "cpu_ring": 1.8,
+    "cpu_label": "ср. 1.8%",
+    "memory_percent_ring": 5.7,
+    "memory_percent_label": "ср. 5.7%",
+    "memory_used_ratio_ring": 5.8,
+    "memory_used_ratio_label": "ср. 5.8%",
+    "network_ring": 12.5,
+    "network_label": "Σ 1.71 MiB",
+    "disk_ring": 45.0,
+    "disk_label": "Σ 2.5 GiB"
+  }
 }
 ```
 
-- `total_workers_from_meta` может быть `null`, если ни в одном `meta.json` нет `worker_nodes`.
+- `container_cli` — активный движок для kind и `docker stats` / `podman stats` (как в GET /health).
+- `total_workers_from_meta` — целое **≥ 0**; **0**, если ни в одном `meta.json` нет поля `worker_nodes` или оно не число.
 - `jobs_total` — число заданий в текущей памяти процесса (не более 200).
 - `jobs_recent_failed` — сколько заданий в этом хранилище сейчас в статусе `failed` (не «последние N», а счётчик по всему снимку).
 - `cluster_resources` — по каждому имени из `kind get clusters`; если узлы остановлены, `nodes` пустой, в `note` пояснение.
-- `cluster_resources_error` — если CLI (`CONTAINER_CLI`) не найден в PATH и т.п.; тогда `cluster_resources` может быть пустым.
+- `cluster_resources_error` — если CLI (`CONTAINER_CLI`) не найден в PATH и т.п.; тогда `cluster_resources` может быть пустым, а `aggregate_cluster_resources` — нулевая сводка.
+- `aggregate_cluster_resources` — агрегаты по **запущенным** узлам для донат-диаграмм на главной: средние проценты CPU/RAM, средняя доля RAM из строки `memory_usage`, кольца сети/диска по суммарному I/O (шкала 0–100 относительно порога 8 GiB на полное кольцо).
 
 ---
 
@@ -223,6 +240,7 @@ Accept: text/markdown
   {
     "name": "dev",
     "registered_in_kind": true,
+    "kind_nodes_running": true,
     "has_local_kubeconfig": true,
     "meta": {
       "cluster_name": "dev",
@@ -235,6 +253,8 @@ Accept: text/markdown
 ]
 ```
 
+- `kind_nodes_running` — в списке процессов контейнерного движка есть узлы kind с префиксом имени (`имя-control-plane`, `имя-worker`…); для UI: при `true` показывается действие «Стоп», иначе при необходимости подъёма — «Старт».
+
 ---
 
 ## GET /api/v1/jobs