[2026-06-17] eagle-dashboard: add management policy doc — Hermes only via dashboard/API

2026-06-17 13:56:24 +06:00
parent 7fa1665ed3
commit 33cf5f842d
2 changed files with 22 additions and 0 deletions
@@ -8,6 +8,20 @@ Process supervisor and control panel for all Eagle local services.

 ---

+## Management Policy
+
+**Hermes gateway (Eagle и Whale) стартуются, стопаются и перезапускаются ТОЛЬКО через Eagle Dashboard или его API (`POST /api/services/<id>/start|stop|restart`).**
+
+Нельзя:
+- `kill` процесс Hermes вручную
+- `launchctl` stop/start Hermes
+- supervisorctl
+- любой другой прямой способ
+
+Dashboard supervisor управляет процессами через PID-файлы, отслеживает состояние, не рестартует после ручного стопа (`stop` выставляет флаг, autorestart игнорируется до явного `start`). Health check верится по supervisor PID (точное совпадение), а не по подстроке в cmdline.
+
+Для дашборда самого (`com.eagle.dashboard`, type: self) — кнопки управления скрыты, так как supervisor не может restart/stop/start свой процесс.
+
 ## Architecture

 FastAPI + HTMX + Tailwind CDN + Alpine.js. No build step, CDN-only frontend.