feat(runtime-logs): enhance auto-cleanup features and documentation

Added new endpoints for estimating and executing runtime log auto-cleanup based on tenant settings. Introduced configuration options for auto-cleanup policies, including scheduling and file size limits. Updated the API documentation and UI components to reflect these changes, improving user interaction with runtime log management. Enhanced error handling and added new UI elements for better visibility of audit logs and cleanup actions.

docs/access.md

@@ -110,7 +110,11 @@ EVOBGP_SERVICE=evobgp-all
 EVOBGP_RUNTIME_LOGS_DIR=/opt/evobgp/runtime-logs
 ```
 
-В dev-профиле compose каталог на хосте обычно `./runtime-logs`, в контейнере — mount на `/opt/evobgp/runtime-logs`. Если каталог не задан или роль процесса не `evobgp-all`, эндпоинты `/v1/runtime-logs/*` отвечают **503** (`runtime_logs_unavailable`). Очистка файлов — роль **operator+**; операции пишутся в таблицу `runtime_log_cleanup_audit`.
+В dev-профиле compose каталог на хосте обычно `./runtime-logs`, в контейнере — mount на `/opt/evobgp/runtime-logs`. Если каталог не задан или роль процесса не `evobgp-all`, FS-эндпоинты (`/files`, `/auto-*`) отвечают **503** (`runtime_logs_unavailable`). `GET /v1/runtime-logs/cleanup-audit` доступен без volume.
+
+Очистка файлов — роль **operator+**; операции пишутся в `runtime_log_cleanup_audit`. Автоочистка настраивается в tenant settings (`runtime_logs_auto_enabled`, `runtime_logs_max_file_mb`, `runtime_logs_auto_schedule`, `runtime_logs_auto_mode`); scheduler — только в `evobgp-all`. Опционально: `EVOBGP_RUNTIME_LOGS_POLICY_TENANT` — tenant, чьи settings читает scheduler (иначе первый tenant с включённой автоочисткой).
+
+Retention строк audit: пресет maintenance policy `runtime_log_cleanup_audit` (90d) в Monitoring → PostgreSQL → Политики.
 
 ## CORS для веб-интерфейса
 

docs/api.md

@@ -90,7 +90,7 @@
 
 ### Settings
 
-- `GET /v1/settings`, `PATCH /v1/settings` — tenant KV (`global_settings`): BIRD, `revision_retention_minutes`, произвольные ключи. Чтение — viewer+; `PATCH` — operator+.
+- `GET /v1/settings`, `PATCH /v1/settings` — tenant KV (`global_settings`): BIRD, `revision_retention_minutes`, `runtime_logs_*` (автоочистка FS), произвольные ключи. Чтение — viewer+; `PATCH` — operator+.
 
 ### RuntimeLogs
 
@@ -101,7 +101,9 @@
 | `GET` | `/v1/runtime-logs/files` | viewer+ | Список `*.log` (имя, размер, mtime) |
 | `GET` | `/v1/runtime-logs/files/{filename}` | viewer+ | Хвост файла (`?lines=`, `?bytes=`, `?grep=`) |
 | `DELETE` | `/v1/runtime-logs/files/{filename}` | operator+ | Синхронная очистка (`?mode=truncate\|delete`, default truncate); max 512 MiB |
-| `GET` | `/v1/runtime-logs/cleanup-audit` | viewer+ | Пагинированный audit очистки (`cursor`, `limit`) |
+| `GET` | `/v1/runtime-logs/cleanup-audit` | viewer+ | Пагинированный audit очистки (`cursor`, `limit`); **без FS volume** |
+| `GET` | `/v1/runtime-logs/auto-estimate` | operator+ | Файлы выше порога из tenant settings |
+| `POST` | `/v1/runtime-logs/auto-run` | operator+ | Немедленный прогон (`?dry_run=true`); audit с `actor_prefix=auto:scheduler` |
 
 `{filename}` — только basename, паттерн `^[a-z0-9][a-z0-9_.-]*\.log$`. Очистка пишет строку в таблицу `runtime_log_cleanup_audit` (миграция `000026`).
 

docs/manual.md

@@ -112,15 +112,16 @@ EvoBGP управляет генерацией и применением BGP-к
 | Маршрут | Назначение |
 |---------|------------|
 | `/settings` | Только браузер: API-токен, тема (localStorage). Tenant KV здесь **не** редактируются. |
-| `/tenant-settings` | Все tenant-параметры из `/v1/settings`: вкладки **BIRD**, **Ревизии** (`revision_retention_minutes`), **Дополнительно** (custom KV). Пункт nav **«Параметры»**. |
+| `/tenant-settings` | Все tenant-параметры из `/v1/settings`: вкладки **BIRD**, **Ревизии**, **Файловые логи** (автоочистка FS), **Дополнительно** (custom KV). Пункт nav **«Параметры»**. |
 | `/network` → Control plane | Краткая сводка BIRD + ссылка на `/tenant-settings?tab=bird`. |
 | `/operations` | Ревизии, diff, jobs; вкладка «Система» перенесена в `/tenant-settings`. |
 
 ### Web UI: файловые runtime-логи
 
 - **Мониторинг** → вкладка **«Файловые логи»** (`/monitoring?tab=runtime-logs`).
-- Подвкладки: **Файлы** (список, preview хвоста, очистка operator) и **Audit очистки**.
-- При **503** на списке файлов: FS API недоступен (не `evobgp-all` или нет volume); audit из БД может отображаться отдельно.
+- Подвкладки: **Файлы** (список, preview хвоста, очистка operator) и **Audit очистки** (история из БД, в т.ч. `auto:scheduler`).
+- Автоочистка: **Параметры** → **Файловые логи** — порог MiB, UTC cron, режим truncate/delete; scheduler в `evobgp-all`.
+- При **503** на списке файлов: FS API недоступен (не `evobgp-all` или нет volume); `GET /v1/runtime-logs/cleanup-audit` работает без volume.
 - Deploy: `EVOBGP_RUNTIME_LOGS_DIR`, bind-mount на `evobgp-all`, sidecar `stack-runtime-logs` — [quickstart.md](quickstart.md#файловые-runtime-логи-api-v1runtime-logs), [access.md](access.md).
 
 ## 7. Эксплуатация и runbook

docs/openapi.yaml

@@ -1168,6 +1168,54 @@ components:
         has_more:
           type: boolean
 
+    RuntimeLogAutoPolicy:
+      type: object
+      properties:
+        enabled:
+          type: boolean
+        max_file_bytes:
+          type: integer
+          format: int64
+        schedule:
+          type: string
+          description: UTC cron (minute hour dom month dow).
+        mode:
+          $ref: "#/components/schemas/RuntimeLogCleanupMode"
+
+    RuntimeLogAutoEstimateItem:
+      type: object
+      required: [filename, size_bytes, would_cleanup]
+      properties:
+        filename:
+          type: string
+        size_bytes:
+          type: integer
+          format: int64
+        would_cleanup:
+          type: boolean
+        skip_reason:
+          type: string
+          description: under_threshold, too_large, или текст ошибки.
+
+    RuntimeLogAutoEstimate:
+      type: object
+      properties:
+        policy:
+          $ref: "#/components/schemas/RuntimeLogAutoPolicy"
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/RuntimeLogAutoEstimateItem"
+        would_count:
+          type: integer
+          minimum: 0
+
+    RuntimeLogAutoRunResult:
+      type: object
+      additionalProperties: true
+      description: |
+        dry_run, trigger, policy, cleaned[], skipped[], cleaned_count, skipped_count.
+
     BirdLocalStatus:
       type: object
       description: Статус локального BIRD на хосте API (GET /v1/bird/status).
@@ -1388,6 +1436,23 @@ components:
         bird_bgp_source_ipv6:
           type: string
           description: Зарезервировано; в текущей генерации BGP не используется.
+        revision_retention_minutes:
+          type: integer
+          minimum: 15
+          maximum: 43200
+        runtime_logs_auto_enabled:
+          type: boolean
+          description: Автоочистка *.log на evobgp-all по расписанию (только при FS volume).
+        runtime_logs_max_file_mb:
+          type: integer
+          minimum: 1
+          maximum: 512
+          description: Truncate/delete файлов строго больше порога (MiB).
+        runtime_logs_auto_schedule:
+          type: string
+          description: UTC cron для автоочистки (по умолчанию `0 */6 * * *`).
+        runtime_logs_auto_mode:
+          $ref: "#/components/schemas/RuntimeLogCleanupMode"
       additionalProperties: true
 
     RevisionDiff:
@@ -4116,6 +4181,63 @@ paths:
         default:
           $ref: "#/components/responses/DefaultProblem"
 
+  /v1/runtime-logs/auto-estimate:
+    get:
+      tags: [RuntimeLogs]
+      summary: Оценка автоочистки runtime log-файлов
+      description: |
+        Список файлов, которые будут затронуты текущей политикой tenant settings.
+        Требует evobgp-all с примонтированным каталогом runtime-logs.
+      operationId: estimateRuntimeLogAutoCleanup
+      parameters:
+        - $ref: "#/components/parameters/TenantId"
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RuntimeLogAutoEstimate"
+        "503":
+          description: FS API недоступен (не evobgp-all или нет volume).
+          content:
+            application/problem+json:
+              schema:
+                $ref: "#/components/schemas/Problem"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
+  /v1/runtime-logs/auto-run:
+    post:
+      tags: [RuntimeLogs]
+      summary: Запустить автоочистку runtime log-файлов
+      description: |
+        Немедленный прогон политики из tenant settings. `dry_run=true` — только оценка без FS-изменений.
+        Записи audit с `actor_prefix=auto:scheduler`.
+      operationId: runRuntimeLogAutoCleanup
+      parameters:
+        - $ref: "#/components/parameters/TenantId"
+        - name: dry_run
+          in: query
+          schema:
+            type: boolean
+            default: false
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RuntimeLogAutoRunResult"
+        "503":
+          description: FS API недоступен.
+          content:
+            application/problem+json:
+              schema:
+                $ref: "#/components/schemas/Problem"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
   /v1/runtime-logs/cleanup-audit:
     get:
       tags: [RuntimeLogs]