feat: categories, runtime nav, and UX updates

docs/PROJECT_CONTEXT.md

@@ -23,7 +23,7 @@
 
 - Режим VNC как отдельный сервис больше не используется (deprecate).
 - Основной сценарий для пользователей: WEB и RDP.
-- Для WEB используются прогретые per-service пулы (`warm_pool_size` на сервис).
+- Для WEB используется общий пул `portal-webpool-*` (и авторасширение при нагрузке).
 - Для RDP используется универсальный пул слотов (`UNIVERSAL_POOL_SIZE`).
 - Сессии пользователя имеют UUID-ссылки (`/s/<uuid>/...`).
 
@@ -34,6 +34,8 @@
 - `/s/<session_id>/` — страница ожидания старта
 - `/s/<session_id>/view` — сессионный view для WEB-пула
 - `/svc/<slug>/` — роут к warm runtime конкретного сервиса
+- `/w/<slot>/` — роут к WEB pool слоту
+- `/u/<slot>/` — роут к universal pool слоту
 - `/admin` — админка
 
 ## 5) Что важно помнить по инфраструктуре
@@ -42,12 +44,14 @@
 Причина: динамические контейнеры создают labels во время работы, и именно Traefik маршрутизирует:
 - `/s/<session_id>/...`
 - `/svc/<slug>/...`
+- `/w/<slot>/...`
+- `/u/<slot>/...`
 
 2. При Nginx Proxy Manager (NPM):
 - внешний домен -> NPM -> внутренний Traefik.
-- в `docker-compose.yml` Traefik опубликован локально:
-  - `127.0.0.1:2288 -> 443`
-  - `127.0.0.1:8288 -> 80`
+- в `docker-compose.yml` Traefik опубликован так:
+  - `0.0.0.0:2288 -> 443`
+  - `0.0.0.0:8288 -> 80`
 - в NPM обязательна опция `Websockets Support`.
 
 3. Кнопка «Домой» в runtime UI:
@@ -59,21 +63,21 @@
 Проверять:
 - что у noVNC корректный WebSocket endpoint (`.../websockify`);
 - что сессия active в БД;
-- что warm контейнер сервиса running;
+- что контейнер WEB-пула running;
 - что в NPM включен websocket proxy.
 
 Быстрая проверка:
-- логи `portal-warm-<slug>-*`
+- логи `portal-webpool-*`
 - логи `portal-api-1`
-- содержимое `/opt/portal/index.html` внутри warm-контейнера.
+- содержимое `/opt/portal/index.html` внутри runtime-контейнера.
 
 ### B) "Соединение со слотом потеряно" в RDP
 Обычно не проблема портала, а проблема соединения `xfreerdp` до целевого host:port/cred/sec.
 Смотреть `/tmp/session-app.log`/`xfreerdp.log` в `portal-universal-*`.
 
 ### C) Изменения не видны сразу
-Если менялись runtime-скрипты, старые warm-контейнеры могут держать старую версию.
-Нужно пересобрать образ + пересоздать warm-пул.
+Если менялись runtime-скрипты, старые warm/pool контейнеры могут держать старую версию.
+Нужно пересобрать образ + пересоздать пул.
 
 ## 7) Где смотреть код
 
@@ -82,6 +86,7 @@
 - Пользовательский дашборд: `app/templates/dashboard.html`
 - WEB runtime: `kiosk/entrypoint.sh`, `kiosk/manager.py`
 - RDP runtime: `rdp-proxy/entrypoint.sh`
+- Universal runtime: `universal-runtime/entrypoint.sh`, `universal-runtime/manager.py`
 - Оркестрация: `docker-compose.yml`, `traefik/traefik.yml`
 
 ## 8) Операционные команды
@@ -96,7 +101,16 @@ docker compose --profile build-only build kiosk-image rdp-proxy-image universal-
 docker compose up -d --build
 ```
 
-Пересоздать warm-пул (через API startup/ensure) — обычно перезапуск `api` и/или вызов prewarm из админки.
+Перезапуск только API:
+```bash
+docker compose up -d api
+```
+
+Проверка состояния:
+```bash
+docker compose ps
+docker compose logs -f api traefik
+```
 
 ## 9) Что еще можно улучшить
 
@@ -105,3 +119,83 @@ docker compose up -d --build
 - централизованный сбор логов и алерты;
 - e2e smoke-тесты на сценарии `/go -> /s/<uuid>/view`.
 
+## 10) Сервер и рабочие пути
+
+- SSH сервер: `ruslan@10.17.39.3`
+- Пароль `sudo` на сервере: `utOgbZ09ruslanstand`
+- Рабочий каталог проекта на сервере: `/root/Stend_mont`
+- Файл контекста на сервере: `/root/Stend_mont/docs/PROJECT_CONTEXT.md`
+
+Базовый рабочий сценарий:
+```bash
+ssh ruslan@10.17.39.3
+sudo -s
+cd /root/Stend_mont
+```
+
+## 11) Git доступ и публикация
+
+Репозиторий:
+- `https://git.ruslan.xyz/ruslan/Stend_mont`
+
+Учетные данные HTTPS (текущие):
+- login: `ruslan@ipcom.su`
+- password/token: `utOgbZ09ruslan`
+
+Пример push:
+```bash
+cd /root/Stend_mont
+git add .
+git commit -m "your message"
+git push https://ruslan%40ipcom.su:utOgbZ09ruslan@git.ruslan.xyz/ruslan/Stend_mont main
+```
+
+## 12) Текущее runtime-состояние (на момент фиксации)
+
+- API запущен с `uvicorn --workers 4` через `docker-compose.yml`.
+- Для WEB используется `portal-webpool-*`.
+- Для RDP используется `portal-universal-*`.
+
+## 13) Последние изменения (2026-04-21)
+
+1. UI/брендинг:
+- Тексты в интерфейсе переведены на формулировку `инфрастуктурный полигон`.
+- На главной панели приветствие в блоке `admin-intro`: `Добро пожаловать в инфрастуктурный полигон`.
+- Кнопка выхода на дашборде: `Выход` (вместо `Logout`).
+
+2. WEB runtime (браузерные сервисы):
+- В панели управления runtime оставлены 2 кнопки:
+  - `Назад`
+  - `Главная` (ведет на главную панель портала `/`).
+- Кнопка `Вперед` удалена.
+- Изменения применены в `kiosk/entrypoint.sh` и `universal-runtime/entrypoint.sh`.
+
+3. Логин и просроченные пользователи:
+- Если пользователь найден и пароль верный, но аккаунт просрочен/неактивен, на экране входа показывается сообщение:
+  `Доступ к сервису приостоновлен, обратитесь к вашему менеджеру`.
+- Сообщение рендерится в шаблоне `app/templates/login.html` через `login_error`.
+
+4. Категории сервисов:
+- Добавлены сущности и связи:
+  - `categories`
+  - `service_categories`
+- Категории можно создавать/удалять в админке.
+- При создании/редактировании WEB/RDP сервиса можно выбрать категории.
+- На главной панели добавлен стильный фильтр по категориям (chips) и бейджи категорий на карточке сервиса.
+
+5. Иконки сервисов:
+- Иконки на главной панели увеличены примерно в 6 раз.
+- Масштабирование иконок: `object-fit: contain`, чтобы картинка полностью влезала в рамку.
+- В админке загрузка иконки стала автоматической при выборе файла (без кнопки Upload).
+
+6. Многоворкерный API и startup:
+- API работает с `uvicorn --workers 4`.
+- Чтобы убрать гонку DDL на старте (при нескольких воркерах), добавлен file-lock на bootstrap схемы:
+  - lock-файл: `/tmp/portal-schema.lock`
+  - сериализуется выполнение `Base.metadata.create_all(...)` и `ensure_schema_compatibility()`.
+
+7. Операционные заметки по применению runtime-изменений:
+- После изменения `kiosk`/`universal-runtime` нужно:
+  1. пересобрать runtime-образы,
+  2. пересоздать `portal-webpool-*`, `portal-universal-*`, `portal-warm-*` контейнеры,
+  3. перезапустить `api`.