Веб-UI FastAPI, REST API v1, интерактивный setup без env.example

- Дашборд (Jinja2 + static), управление кластерами kind, задания и kubeconfig.
- API: health, stats, clusters CRUD, versions, jobs; документация app/docs/api_routes.md.
- Docker Compose: том app, uvicorn reload, KIND_K8S_PATCH_KUBECONFIG по умолчанию 1.
- setup_env_interactive.py: список переменных в скрипте, удалён env.example.
- Makefile: явный префикс docker/podman; прочие правки CLI и ядра кластеров.

app/core/config.py

@@ -1,4 +1,7 @@
-"""Настройки веб-приложения из переменных окружения (и опционально ``.env`` в рабочем каталоге).
+"""Настройки веб-приложения из переменных окружения.
+
+Переменные задаются в ``docker-compose`` и/или в ``.env`` в корне репозитория
+(Compose подставляет их в ``environment`` процесса — отдельный ``env_file`` в коде не требуется).
 
 Автор: Сергей Антропов
 Сайт: https://devops.org.ru
@@ -6,34 +9,34 @@
 
 from __future__ import annotations
 
-from pathlib import Path
-
-from pydantic import Field
+from pydantic import Field, field_validator
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
-# Каталог пакета app/ — для поиска .env рядом с кодом (в образе: /opt/kind-k8s/app).
-_APP_DIR = Path(__file__).resolve().parents[1]
-_REPO_ROOT = _APP_DIR.parent
+_DEFAULT_TITLE = "kind-k8s-develop"
 
 
 class Settings(BaseSettings):
     """Параметры HTTP-сервера и поведения UI."""
 
     model_config = SettingsConfigDict(
-        env_file=(
-            str(_REPO_ROOT / ".env"),
-            str(_APP_DIR / ".env"),
-        ),
-        env_file_encoding="utf-8",
         extra="ignore",
         case_sensitive=False,
+        # Пустая строка из docker-compose (${VAR:-}) не должна затирать заголовок OpenAPI.
+        env_ignore_empty=True,
     )
 
     kind_k8s_web_host: str = Field(default="0.0.0.0", validation_alias="KIND_K8S_WEB_HOST")
     kind_k8s_web_port: int = Field(default=6000, validation_alias="KIND_K8S_WEB_PORT")
 
-    # Заголовок в OpenAPI / HTML (без хардкода в шаблонах).
-    app_title: str = Field(default="kind-k8s-develop", validation_alias="KIND_K8S_APP_TITLE")
+    # Заголовок в OpenAPI / HTML; пустая строка из compose не должна ломать FastAPI.
+    app_title: str = Field(default=_DEFAULT_TITLE, validation_alias="KIND_K8S_APP_TITLE")
+
+    @field_validator("app_title", mode="before")
+    @classmethod
+    def _non_empty_title(cls, v: object) -> object:
+        if v is None or (isinstance(v, str) and not v.strip()):
+            return _DEFAULT_TITLE
+        return v
 
 
 def get_settings() -> Settings: