# Серверы и кластеры

Статус: `approved`

## Назначение
Экран управления серверным и Kubernetes-контуром платформы: реестром серверов, кластерами, размещением workload, здоровьем, ёмкостью и историей инфраструктурных событий.

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

## Главные сущности
- сервер
- Kubernetes cluster
- namespace
- slot pool
- placement rule
- cleanup job
- capacity metric
- infrastructure alert
- fleet audit event

## Основные блоки
- верхняя лента summary-card по серверам, кластерам, свободным слотам и предупреждениям
- вкладочная поверхность серверов, кластеров, размещения, здоровья/ёмкости и истории
- таблица серверов или кластеров
- инспектор выбранного сервера, кластера или события
- блоки cleanup policy, capacity trend и предупреждений

## Семантика вкладок
- `Серверы` — серверы, владельцы, зоны, использование CPU/RAM/disk, связанные кластеры и состояние cleanup job;
- `Кластеры` — Kubernetes-кластеры, версии, namespace, slot pool, registry mirror и reconciliation jobs;
- `Размещение` — правила выбора целевого сервера, кластера и namespace для организации, проекта, репозитория или workload;
- `Здоровье и ёмкость` — агрегированные метрики, прогноз заполнения, предупреждения и короткие выдержки последних ошибок;
- `История` — инфраструктурные события, связанные job/alert, retry и экспорт аудита.

## Ключевые действия
- добавить сервер
- подключить кластер
- открыть или изменить cleanup policy
- проверить размещение workload
- открыть предупреждение
- перезапустить failed job
- открыть связанные job или alert
- экспортировать историю

## Источники данных
- платформа: fleet registry, placement policy, slot state, cleanup job records, alert projection, audit log
- Kubernetes: статус cluster, namespace, deployment/job, node capacity и readiness
- внешние системы мониторинга: alert events и краткая сводка ошибки

## Что намеренно не показывается
- Docker Swarm или некластерные runtime как целевой путь
- raw kubeconfig и секреты доступа
- raw `kubectl` команды
- длинные логи; допускается только короткая выдержка последней ошибки
- отдельная доменная сущность образа, если за хранение отвечает registry

## Макеты
- [Основной макет](screen.png) — полноэкранный fleet-экран с активной вкладкой `Серверы`.
- [Вкладка `Серверы`](tab-servers.png) — серверы, ресурсы, cleanup job, предупреждения и следующий запуск очистки.
- [Вкладка `Кластеры`](tab-clusters.png) — Kubernetes-кластеры, namespace, slot pool, registry mirror и reconciliation jobs.
- [Вкладка `Размещение`](tab-placement.png) — правила размещения, проверка конкретного workload и объяснение выбранного контура.
- [Вкладка `Здоровье и ёмкость`](tab-health-capacity.png) — метрики, тренды, предупреждения и прогноз заполнения.
- [Вкладка `История`](tab-history.png) — события серверов и кластеров, связанные job/alert и retry.

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