Lizenz und Demo Modus

Lizenz und Demo-Modus

ConvoyPlan läuft ohne gültigen Lizenzschlüssel im Demo-Modus. Lesezugriffe sind uneingeschränkt möglich; alle schreibenden Operationen sind gesperrt.

---

Demo-Modus

Aspekt	Verhalten
Lesezugriffe (GET)	uneingeschränkt
Schreibzugriffe (POST/PUT/PATCH/DELETE)	mit HTTP 402 gesperrt
Eignung	Tests und Evaluierung — nicht für den Einsatzbetrieb

---

Offene Demo-Sitzungen verwalten (Admin)

Jede Demo-Nutzung läuft als eigene, befristete Organisation. Der Admin-Bereich (Admin → Demo-Sitzungen) listet alle offenen Sitzungen mit Name, Ablaufzeit, Anzahl angelegter Konvois und Herkunft.

Die Herkunft (Stadt/Region/Land) wird beim Start der Sitzung aus der Client-IP ermittelt und per Hintergrund-Geolokation (ipapi.co) angereichert — ein langsamer oder nicht erreichbarer Geo-Dienst verzögert den Demo-Start nie, die Anfrage läuft als Background-Task nach der Antwort. Private oder ungültige IPs (z. B. lokale Entwicklung) werden nicht abgefragt und bleiben ohne Herkunftsangabe. Die Daten helfen, Demo-Sitzungen Interessenten zuzuordnen.

Sitzungen lassen sich hier verlängern oder sofort beenden. Herkunftsdaten (created_ip, created_location) werden zusammen mit der Demo-Organisation vom bestehenden Retention-Job gelöscht — es gibt keine gesonderte Aufbewahrungsfrist dafür.

📖 Endpunkte: siehe API-Dokumentation → Demo-Sitzungen.

---

Lizenz beantragen und aktivieren

1. Instanz-UUID abrufen — im Admin-Bereich unter System oder per API:

   GET /api/license/instance-id

   Die UUID wird während der Installation erzeugt und identifiziert die Instanz.

2. Lizenzschlüssel anfordern — mit der UUID beim Anbieter (ConvoyPlan-Lizenzmanager) einen Schlüssel erstellen lassen.

3. Aktivieren — Schlüssel im Admin-Bereich System eintragen oder per API:

   POST /api/license/activate
   { "key": "<lizenzschlüssel>" }

   Der Schlüssel wird validiert, gespeichert und der Lizenz-Cache ohne Neustart zurückgesetzt.

---

Schlüsselquelle: Env vs. Datenbank

Der Lizenzschlüssel kann auf zwei Wegen gesetzt werden:

Quelle	Setzen über	Persistenz
LICENSE_KEY	Umgebungsvariable	im Container-Env
Admin-UI	Admin → System → Lizenz	in der Datenbank

GET /api/license/status liefert demo_mode, den aktuellen Status und key_source (woher der aktive Schlüssel stammt).

---

Lizenzmodell des Quellcodes

Der Quellcode selbst steht unter einem Dual-Lizenz-Modell (AGPL-3.0 bzw. kommerzielle Lizenz) — das betrifft die Nutzung/Weitergabe des Codes und ist unabhängig vom obigen Laufzeit-Lizenzschlüssel. Siehe LICENSE, COMMERCIAL_LICENSE.md und CLA.md im Repository.