Kanban dashboard: technologie a důvod nasazení

Aktualizováno: 2026-05-28T19:50:55+00:00

Jak to běží

• backend: hermes dashboard jako Python proces / user systemd service
• service: hermes-dashboard.service
• startuje: .../venv/bin/hermes dashboard --host 0.0.0.0 --insecure --no-open
• poslouchá na 0.0.0.0:9119
• reverse proxy / TLS: Caddy
• route: /kanban*
• proxy na http://127.0.0.1:9119
• posílá X-Forwarded-Prefix: /kanban
• navíc tam je IP allowlist pro 46.23.142.104
• frontend technologie: React + TypeScript + Vite
• potvrzeno z web/package.json
• samotný Kanban: je dashboard plugin
• manifest: plugins/kanban/dashboard/manifest.json
• frontend bundle: plugins/kanban/dashboard/dist/index.js
• styly: dist/style.css
• backend API pluginu: plugin_api.py

Proč takhle

1. Sdílí to stejnou doménu s Hermes WWW, ale dashboard je oddělený pod /kanban/.
2. Caddy řeší HTTPS, routing a omezení přístupu.
3. X-Forwarded-Prefix je potřeba, protože dashboard/plugin běží pod subpath, ne na rootu.
4. Pluginový model je praktický: Kanban je jen jedna část dashboardu, ne separátní standalone web.
5. systemd service drží dashboard trvale běžící i po odhlášení.

Zkráceně

Caddy → Hermes dashboard server → React/Vite frontend + Kanban plugin

Ověřený stav

• hermes-dashboard.service je running
• port 9119 poslouchá
• Caddy opravdu proxyuje /kanban* s X-Forwarded-Prefix /kanban