Browserbasierte Planungssoftware für Marschverbände, Konvois und Einsatzfahrten von BOS-Organisationen.
Kartenbasierte Routenplanung · Live-Tracking · Marschbefehl-PDF · Self-hosted · Docker
Marschplanung Berlin → München: Route über GraphHopper berechnet, Distanz und Dauer (583 km · 8 h 58 min), Reichweiten-Check und automatisch empfohlene technische Halte.
ConvoyPlan ist eine selbst gehostete Web-Anwendung, die Einsatzorganisationen (BOS) bei der strukturierten Planung und Durchführung von Marschverbänden und Konvoifahrten unterstützt. Die Software läuft vollständig on-premise und erfordert keine Cloud-Dienste.
- 🗺️ Kartenbasierte Marschplanung mit OpenStreetMap, MapLibre GL und selbst gehostetem GraphHopper-Routing.
- 🚒 Fahrzeug- und Verbandsverwaltung mit Wegpunkten, Kontrollpunkten, technischen Halten und automatischer Zeitplanung.
- 📄 Marschbefehl-PDF sowie GPX- und JSON-Export für Weitergabe und Nachbearbeitung.
- 📡 Live-Tracking per WebSocket mit Fahrzeugstatus, Projektion auf die Route und Wegpunkt-/Kanalwechsel-Meldungen.
- 🌤️ Wetter- und Verkehrsdaten über Open-Meteo, Overpass, Autobahn-API, offene Feeds und optional HERE/TomTom.
- 🏢 Multi-Tenancy mit Org-Code-Slug, org-spezifischem Branding, Rollenmodell und vollständiger Datenisolation.
- 🔒 Sicherheit & Datenschutz – MFA/TOTP, Security-Härtung, Audit-Log, DSGVO-Werkzeuge, Backup/Restore.
- 🔄 Auto-Updater mit Kanälen (Stable/Beta/Nightly), Demo-Modus und Lizenzaktivierung über die Admin-UI.
- 📱 PWA & Capacitor für installierbare Web-App und native App-Wrapper.
📖 Vollständige Feature-Übersicht mit Status und Roadmap: Funktionsumfang im Wiki.
Linux:
curl -sSL https://convoyplan.de/install.sh | bashWindows (PowerShell als Administrator):
irm https://convoyplan.de/install.ps1 | iexDer Installer prüft Voraussetzungen (Docker, Docker Compose), fragt interaktiv nach Domain, E-Mail, Datenbankpasswort und OSM-Region, generiert einen JWT_SECRET automatisch und startet den Stack. Nach Abschluss öffnet sich der Setup-Wizard unter https://<DOMAIN>/setup.
📖 Manuelle Installation, Konfiguration und Deployment (Docker Compose, Portainer, alle Umgebungsvariablen): Installation und Setup im Wiki.
Caddy terminiert TLS und leitet /api/* und /ws/* ans FastAPI-Backend, alles andere ans SvelteKit-Frontend. Dahinter speichert PostgreSQL + PostGIS alle Daten, GraphHopper berechnet Routen, und ein Updater- sowie ein Retention-Container übernehmen Auto-Deploy und Datenaufbewahrung.
📖 Architektur und Tech-Stack im Detail: Home im Wiki.
🗺️ Marschplanung – Wegpunkte, GraphHopper-Route, Reichweiten-Check, empfohlene Halte. |
 📡 Live-Tracking – Position, Status und Verbandsfortschritt in Echtzeit. |
 📞 Leitstellen – Anrufgruppen, Zusatzkanäle und automatische Kanalwechselpunkte. |
 🎨 Branding – App-Name, Logos und Farbschema pro Organisation. |
Die Screenshots stammen aus dem Demo-Modus. Logo- und Design-Assets liegen unter
logo/.
Die vollständige Anwender- und Betriebsdokumentation liegt im GitHub Wiki.
Die Markdown-Quellen dazu liegen im Ordner wiki/. Bei jedem Push auf main werden sie über den Workflow .github/workflows/sync-wiki.yml automatisch ins GitHub Wiki gespiegelt — Bearbeitungen also bitte immer in wiki/ vornehmen, nicht direkt im Wiki.
| Seite | Inhalt |
|---|---|
| Home | Projektübersicht, Architektur, Tech-Stack |
| Funktionsumfang | Vollständige Feature-Übersicht mit Status und Roadmap |
| Installation und Setup | Docker-Quickstart, Konfiguration, Deployment |
| API-Dokumentation | REST- und WebSocket-Endpunkte, Datenmodell |
| Entwicklung | Projektstruktur, lokaler Workflow, CI/Releases |
| Benutzerhandbuch | Anleitung für Planer, Fahrer und Admins |
| Erste Schritte | Registrierung, Login und erster Überblick |
| Konvoi-Planung | Konvois anlegen, Wegpunkte und Route berechnen |
| Fahrzeuge | Fahrzeuge anlegen und verwalten |
| Live-Tracking | Echtzeit-Verfolgung der Fahrzeuge |
| Marschbefehl & Export | PDF-Marschbefehl sowie GPX-/JSON-Export |
| Rollen & Berechtigungen | Rollenmodell und Zugriffsrechte |
| Teilen | Öffentliche Freigabelinks ohne Login |
| Verkehrsdaten | Baustellen/Sperrungen und Live-Verkehrslage einrichten |
| Multi-Tenancy | Organisationen, Org-Code-Slug, Datenisolation |
| Auto-Updater | Update-Kanäle, Update-Modi und manueller Trigger |
| Lizenz und Demo-Modus | Lizenzaktivierung, Demo-Modus, Instanz-UUID |
| Sicherheit und Datenschutz | Härtung, Audit-Log, DSGVO, Backup/Restore, Retention |
| FAQ | Häufige Fragen |
ConvoyPlan wird unter einem Dual-Lizenz-Modell veröffentlicht:
- Open Source — AGPL-3.0: Der Quelltext steht unter der GNU Affero General Public License v3.0. Wer ConvoyPlan nutzt, modifiziert oder als Dienst betreibt, muss eigene Änderungen ebenfalls unter AGPL-3.0 veröffentlichen. Diese Lizenz gilt für interne, nicht-kommerzielle oder vollständig quelloffene Nutzung.
- Kommerzielle Lizenz: Für Organisationen, die ConvoyPlan in proprietäre Produkte einbetten, als SaaS betreiben oder Änderungen nicht veröffentlichen möchten — ohne Copyleft-Pflichten. Details in COMMERCIAL_LICENSE.md, Anfragen an anfrage@convoyplan.de.
Pull Requests sind willkommen. Bitte öffne zuerst ein Issue für größere Änderungen.
Alle Beiträge unterliegen dem Contributor License Agreement (CLA), das durch das Einreichen eines Pull Requests automatisch akzeptiert wird. Die CLA stellt sicher, dass Beiträge sowohl unter AGPL-3.0 als auch im Rahmen kommerzieller Lizenzen genutzt werden können.
ConvoyPlan – strukturierte Marschverbandsplanung für moderne Einsatzorganisationen.