add core and per-plugin documentation set

This commit is contained in:
2026-03-18 00:15:04 +01:00
parent aa9390ce5e
commit 6389ce6567
21 changed files with 172 additions and 0 deletions

29
docs/core-overview.md Normal file
View File

@@ -0,0 +1,29 @@
# Core Overview
Diese Datei beschreibt den Core von `ARCG-Remote-Station-Software` auf hoher Ebene.
## Zweck
- Generische Remote-Station-Software (station-unabhaengig)
- API (`server/`), Web-UI (`public/`), Plugin-Runtime (`plugins/`)
- Keine station-spezifischen Deploy-Details im Core
## Schichten
1. Core-Defaults im Software-Repo
2. Overlay/Deploy-Repo (stationsspezifisch)
3. Runtime-ENV auf dem Zielsystem (hoechste Prioritaet)
## Wichtige Core-Funktionen
- Passwortlose Auth (SMTP-Link, OTP, optional OAuth)
- Rollen/Policies, Owner-Locks, Reservierungen
- OpenWebRX-Integration (Session/Guard/Bandmap)
- Hardwaresteuerung ueber Plugins (TX/PTT/Router/Rotor/VSWR)
- Audit/Event-Stream fuer Live-UI
## Security Boundary
- Repo ist oeffentlich.
- Keine Live-Konfigurationen, Secrets, Tokens, private Hostnamen oder Betriebsinterna committen.
- Sensible Werte ausschliesslich in Runtime-ENV/Deploy-Ebene halten.