Einleitung

Einleitung

Was ist OpenSchichtplaner5?

OpenSchichtplaner5 ist eine webbasierte Open-Source-Anwendung zur Dienstplanung, die als vollwertiger Ersatz für die proprietäre Windows-Software Schichtplaner5 entwickelt wurde. Die Anwendung besteht aus einem Python/FastAPI-Backend und einem React/TypeScript-Frontend und läuft im Browser — auf Windows, Linux und macOS.

Das besondere Merkmal von OpenSchichtplaner5 ist die direkte Kompatibilität mit den originalen Schichtplaner5-Datenbankdateien im FoxPro-DBF-Format. Es ist keine Datenmigration oder Konvertierung erforderlich — beide Programme können gleichzeitig auf denselben Daten arbeiten.

Hauptmerkmale

• ✅ Liest und schreibt originale Schichtplaner5-DBF-Dateien direkt
• ✅ Läuft im Browser (kein Windows erforderlich)
• ✅ Vollständige Dienstplanfunktionalität
• ✅ Alle Stammdaten verwaltbar (Mitarbeiter, Schichten, Gruppen, ...)
• ✅ Statistiken, Urlaubsverwaltung, Zeitkonto
• ✅ Export (CSV), Import, Backup/Restore
• ✅ Mobile-freundlich (Responsive Design)
• ✅ Open Source (MIT-Lizenz)

Unterschied zum Original Schichtplaner5

Eigenschaft	Original SP5	OpenSchichtplaner5
Betriebssystem	Windows only	Plattformunabhängig
Oberfläche	Windows-Desktop	Moderner Browser
Lizenz	Proprietär	Open Source (MIT)
Datenbankformat	DBF/FoxPro	DBF/FoxPro (kompatibel)
Kosten	Kostenpflichtig	Kostenlos

Systemvoraussetzungen

Server / Rechner mit den Daten:

• Python 3.8 oder höher
• Node.js 18 oder höher (für Entwicklung)
• Zugriff auf den SP5-Datenbankordner (DBF-Dateien)

Client (Browser):

• Jeder moderne Browser (Chrome, Firefox, Edge, Safari)
• Keine Installation notwendig

Installation

1. Projekt herunterladen

git clone https://github.com/mschabhuettl/openschichtplaner5.git
cd openschichtplaner5

2. Backend starten

cd backend
pip install -r requirements.txt
SP5_DB_PATH=/pfad/zu/sp5-daten uvicorn sp5api.main:app --host 0.0.0.0 --port 8000

3. Frontend starten

cd frontend
npm install
npm run dev

Das Frontend ist dann unter http://localhost:5173 erreichbar, das Backend-API unter http://localhost:8000.

Erststart

Nach dem Start öffne deinen Browser und navigiere zu http://localhost:5173. Die Anwendung lädt automatisch die Daten aus dem konfigurierten SP5-Datenbankordner.

---

➡️ Weiter: Erste Schritte