Веб-UI: логи kind create, старт/стоп кластеров, документация README

- Потоковые логи в job_store и UI; kind create через Popen с построчным выводом
- POST /clusters/{name}/start|stop; create по сохранённому kind-config.yaml
- Страница /documentation: GET /api/v1/docs/readme, marked+DOMPurify из static/vendor
- Иконки действий, плавающие подсказки, модалка подтверждения вместо confirm
- Makefile: make docker|podman rebuild; compose: монтирование README.md
- Dockerfile: COPY README.md; readme_doc: несколько путей к README

Автор: Сергей Антропов — https://devops.org.ru

README.md

@@ -47,7 +47,7 @@
 
 **В образ не обязательно ставить на хост:** kind, Python приложения — они внутри контейнера.
 
-Смонтированы **сокет** Docker/Podman и каталог **`./clusters`** → в контейнере **`/work/clusters`**. Каталог **`./app`** монтируется в **`/opt/kind-k8s/app`** для разработки без пересборки образа.
+Смонтированы **сокет** Docker/Podman и каталог **`./clusters`** → в контейнере **`/work/clusters`**. Каталог **`./app`** монтируется в **`/opt/kind-k8s/app`** для разработки без пересборки образа. Файл **`./README.md`** монтируется в **`/opt/kind-k8s/README.md`** (страница **«Документация»** и **`GET /api/v1/docs/readme`** без пересборки образа).
 
 После создания кластера kubeconfig по умолчанию **патчится** на `https://127.0.0.1:<порт>` для доступа с хоста (`KIND_K8S_PATCH_KUBECONFIG`, см. `app/kubeconfig_patch.py`).
 
@@ -67,7 +67,7 @@ make docker up       # или: make podman up
 
 ### Разработка UI и API без пересборки образа
 
-В **`docker-compose.yml`** каталог **`./app`** смонтирован в контейнер как **`/opt/kind-k8s/app`**.
+В **`docker-compose.yml`** смонтированы **`./app`** → **`/opt/kind-k8s/app`** и **`./README.md`** → **`/opt/kind-k8s/README.md`** (только чтение).
 
 По умолчанию (**`KIND_K8S_UVICORN_RELOAD=1`**) uvicorn запускается с **`--reload`** (см. **`scripts/run_uvicorn.sh`**) и перезапускает процесс при изменении `*.py`, `*.html`, `*.css`, `*.js` в `app/`. Пересобирать образ нужно после изменений **Dockerfile**, **`requirements.txt`** или **`scripts/run_uvicorn.sh`**.
 
@@ -99,12 +99,13 @@ docker compose run --rm --entrypoint python3 kind-k8s-web \
 | `make docker logs` / `make podman logs` | Логи `kind-k8s-web` (stream, `-f`) |
 | `make docker ps` / `make podman ps` | Статус контейнеров текущего compose-проекта |
 | `make docker compose-build` / `make podman compose-build` | Собрать образ `kind-k8s-tools:local` |
+| `make docker rebuild` / `make podman rebuild` | Пересборка образа **без кэша** (`build --no-cache`) и пересоздание контейнера (`up -d --force-recreate`) |
 | `make docker check-docker` / `make podman check-docker` | Проверить выбранный CLI и `compose version` |
 | `make setup` | Интерактивно создать `.env` (список переменных в `scripts/setup_env_interactive.py`) |
 | `make clusters-dir` | Создать каталог `clusters/` |
-| `make docker …` / `make podman …` | Префикс **обязателен** для целей `up`, `down`, `logs`, `ps`, `compose-build`, `check-docker` |
+| `make docker …` / `make podman …` | Префикс **обязателен** для целей `up`, `down`, `logs`, `ps`, `compose-build`, `rebuild`, `check-docker` |
 
-Цели `up`, `down`, `logs`, `ps`, `compose-build` и `check-docker` **без** `docker`/`podman` в той же команде завершатся с подсказкой.
+Цели `up`, `down`, `logs`, `ps`, `compose-build`, `rebuild` и `check-docker` **без** `docker`/`podman` в той же команде завершатся с подсказкой.
 
 ## Переменные окружения
 
@@ -129,8 +130,10 @@ docker compose run --rm --entrypoint python3 kind-k8s-web \
 | **`KIND_K8S_VERSION_LIST_DISPLAY`** | контейнер | Сколько тегов отдавать в API/UI |
 | **`KIND_K8S_HUB_TAGS_MAX_PAGES`** | контейнер | Лимит страниц API Hub |
 | **`KIND_K8S_DEBUG`** | контейнер | `1`/`true`/`yes`/`да` — уровень DEBUG в логах |
+| **`KIND_K8S_JOB_LOG_MAX_LINES`** | приложение | Размер буфера строк журнала фонового задания (`kind create`) для поля `progress_log` в API/UI; по умолчанию **500** (задаётся в коде, при необходимости передайте в compose) |
+| **`KIND_K8S_README_PATH`** | контейнер / приложение | Абсолютный путь к **README.md** для страницы **`/documentation`**; если пусто — используется `README.md` рядом с каталогом `app/` (в образе: `/opt/kind-k8s/README.md`) |
 | **`KIND_K8S_WORKDIR`** | локальный запуск | Корень данных на машине разработчика без compose |
-| **`COMPOSE_BUILD_FLAGS`** | Makefile | Например `make docker compose-build COMPOSE_BUILD_FLAGS=--platform linux/arm64` |
+| **`COMPOSE_BUILD_FLAGS`** | Makefile | Например `make docker compose-build COMPOSE_BUILD_FLAGS=--platform linux/arm64` (то же для **`make docker rebuild`**) |
 
 ## Podman (пример rootless)
 
@@ -143,18 +146,18 @@ make podman up
 
 | Путь | Назначение |
 |------|------------|
-| `Makefile` | Запуск веб-UI; префикс `docker` или `podman` обязателен для compose-целей |
+| `Makefile` | Запуск веб-UI; префикс `docker` или `podman` обязателен; цели `up`, `rebuild`, `compose-build` и др. |
 | `scripts/setup_env_interactive.py` | Интерактивное создание `.env` (все ключи и дефолты внутри скрипта) |
 | `scripts/run_uvicorn.sh` | Точка входа контейнера: uvicorn с опциональным `--reload` |
 | `Dockerfile` | Образ: kind, kubectl, docker-cli, FastAPI |
 | `requirements.txt` | pip-зависимости веб-приложения |
-| `docker-compose.yml` | Сервис `kind-k8s-web`, тома `./clusters`, `./app`, сокет |
-| `app/main.py` | FastAPI: дашборд `/`, редирект `/ui`, монтирование `/static` |
-| `app/api/v1/` | REST API: `router.py`, `endpoints/` (`health`, `versions`, `clusters`) |
+| `docker-compose.yml` | Сервис `kind-k8s-web`, тома `./clusters`, `./app`, `./README.md`, сокет |
+| `app/main.py` | FastAPI: дашборд `/`, `/documentation`, редирект `/ui`, монтирование `/static` |
+| `app/api/v1/` | REST API: `router.py`, `endpoints/` (`health`, `versions`, `docs_readme`, `clusters`) |
 | `app/core/` | Жизненный цикл кластеров, задания, настройки, блокировки (`kind_guard`), пути |
 | `app/models/schemas.py` | Pydantic-схемы запросов/ответов API |
-| `app/templates/` | Jinja2: `base.html`, `dashboard.html` |
-| `app/static/` | `style.css`, `js/dashboard.js` |
+| `app/templates/` | Jinja2: `base.html`, `dashboard.html`, `documentation.html` |
+| `app/static/` | `style.css`, `js/dashboard.js`, `js/documentation.js`, `js/vendor/` (marked, DOMPurify для README в UI) |
 | `app/docs/` | `api_routes.md`, `README.md` |
 | `app/create_cluster.py`, `delete_cluster.py`, `cluster_status.py` | CLI и переиспользование из API / `compose run` |
 
@@ -178,4 +181,4 @@ make podman up
 - На **Windows** без WSL удобнее WSL2 + Docker Desktop.
 - Для проверки с хоста нужен отдельный **kubectl** (в образе kubectl только внутри контейнера).
 - История заданий создания в UI/API хранится в памяти (до **200** записей); после перезапуска контейнера очищается.
-- При **`exec format error`** у kind пересоберите образ: `make docker compose-build COMPOSE_BUILD_FLAGS=--platform linux/arm64` (или `make podman …`, или `linux/amd64`).
+- При **`exec format error`** у kind пересоберите образ: `make docker rebuild COMPOSE_BUILD_FLAGS=--platform linux/arm64` (или `make podman …`, или `compose-build` без `--no-cache`, или `linux/amd64`).