EhrenSache
Moderne Zeit- und Anwesenheitserfassung für ehrenamtliche Organisationen
Entwickelt für gemeinnützige Organisationen, wie z.B. Musikvereine, Sportvereine, ...
Kostenlos unter AGPL-3.0 nutzbar.
💼 Kommerziell nutzen? Siehe Lizenzierung
Features
Einsatz ist EhrenSache!
Und jetzt einfach und überall erfassbar ohne Zettel und Stift. Egal ob jeder sich eigenverantwortlich anmeldet oder der Schriftführer die Anwesenheit prüft. EhrenSache ermöglicht Terminplanung, erfasst Anwesenheit und Entschuldigungen inklusive nachträglicher Korrekturmöglichkeit und kann auch Arbeitszeiten messen.
Jeder kann seine Statistik einsehen und prüfen, ob alles erfasst wurde. Inklusive Ankunftszeit, für alle die Pünktlichkeit belohnen wollen.
Kernfunktionen
- Mehrstufiges Rollensystem: Admin, Manager, Benutzer und Gerät mit differenzierten Berechtigungen
- Mehrere Erfassungswege: Web-Dashboard, Mobile PWA mit QR-Code, virtuelle
Station am Tablet (Kiosk) mit PIN und IoT-Geräte
- Terminverwaltung: Planung von Terminen mit Terminarten, Gruppenzuordnung und Teilnehmerverwaltung inklusive Zu- und Absage-Abfrage im Voraus
- Ausnahmenverwaltung: Entschuldigungen und Zeitkorrekturen, beantragt vom Mitglied,
genehmigt von Admin oder Manager
- Gruppenverwaltung: Organisation von Mitgliedern in Gruppen, inklusive Aktiv- und Inaktiv-Zeiträumen
- Arbeitszeiterfassung (seit 1.2.0, abschaltbar): Beginn, Ende und Pause je Tätigkeitsart,
mit Änderungshistorie — für Vereine, die geleistete Stunden nachweisen müssen
- Kalender-Abo (abschaltbar, standardmäßig aus): persönlicher ICS-Link für Google, Apple und Outlook
- Statistik und Export: Auswertung nach Termin, Gruppe und Jahr; CSV-Import und -Export
für Mitglieder, Termine, Anwesenheiten und Arbeitszeit
Technische Highlights
- Sichere Authentifizierung: Session-basiert für Web, Token-basiert für Geräte
- TOTP-Standortverifikation: Zeitbasierte Einmalpasswörter für sichere Check-ins
- Sparsame API-Nutzung: jahresweiser Zwischenspeicher im Browser, der wiederholte
Abfragen desselben Jahres einspart
- Progressive Web App: Installation auf Mobilgeräten möglich
- Responsive Design: Optimiert für Desktop, Tablet und Smartphone
Sicherheit
- SQL-Injection-Prävention mit Prepared Statements
- CSRF-Schutz für alle verändernden Anfragen aus dem Browser
- Sichere Session-Verwaltung mit HttpOnly- und SameSite-Cookies, Timeout nach 30 Minuten
- Rate Limiting: 100 Anfragen pro Minute je IP und Konto
- Sicherheits-Header:
X-Content-Type-Options, X-Frame-Options, Referrer-Policy
- HTTPS-Umleitung ab Werk
- Input-Validierung auf Client- und Server-Seite
- Datei-Uploads werden über den tatsächlichen MIME-Typ geprüft, nicht über die Endung
[!NOTE]
Alle Oberflächen außer den Assistenten für Installation und Update liefern eine
Content-Security-Policy aus (script-src 'self', die öffentlichen Seiten ohne jedes
Skript). Eingeschleustes Skript wird dadurch auch dann nicht ausgeführt, wenn es an der
Maskierung vorbei ins Markup gelangt. Hintergrund: OI-17 in
docs/OPEN-ITEMS.md.
⚠️ Wichtige Hinweise für Betreiber
Datenschutz (DSGVO)
EhrenSache verarbeitet personenbezogene Daten. Als Betreiber sind Sie
Verantwortlicher im Sinne der DSGVO und müssen eigenständig für
datenschutzkonforme Nutzung sorgen.
Betreiber-Pflichten:
- ✓ Datenschutzerklärung erstellen
- ✓ Rechtsgrundlage definieren (z.B. berechtigtes Interesse)
- ✓ Mitglieder informieren
- ✓ Betroffenenrechte gewährleisten
- ✓ Technische Schutzmaßnahmen (HTTPS, Backups, etc.)
Der Entwickler:
- ❌ Ist NICHT verantwortlich für Ihre Datenverarbeitung
- ❌ Haftet NICHT für DSGVO-Verstöße in Ihrer Installation
- ❌ Gibt KEINE Rechtsberatung
📄 Ausführliche Informationen: DATENSCHUTZ.md
⚖️ Haftungsausschluss: DISCLAIMER.md
Empfehlung
Konsultieren Sie vor Inbetriebnahme einen Datenschutzbeauftragten oder
Fachanwalt für IT-Recht, um die DSGVO-Konformität sicherzustellen.
Technologie-Stack
Backend:
- PHP 8+ (Vanilla, kein Framework)
- MySQL 5.7+ oder MariaDB 10.4+
- REST-API, ein einziger Einstiegspunkt (
public/api/api.php)
Frontend:
- Vanilla HTML + JavaScript (ES6-Module, kein Build-Schritt)
- CSS3 (Grid, Flexbox)
- Zwei Progressive Web Apps: Check-in (
/checkin/) und virtuelle Station (/station/)
IoT-Integration (WIP):
- TOTP-Gerät für QR-Check-in via App (ESP32)
- Virtuelle Station als PWA — ein Tablet ersetzt das Gerät
- (geplant) Fingerprint-Scanner für Biometrie-Check-in
Installation
Voraussetzungen
- Webserver mit PHP 8+ und MySQL 5.7+ oder MariaDB 10.4+ — die genaue PHP-Version und die
nötigen PHP-Erweiterungen stehen unter
requires in version.json; Installer und
Update-Assistent prüfen sie
- Apache ab 2.4.7 (
Header … setifempty) mit mod_headers; AllowOverride muss
die Header-Direktiven zulassen (FileInfo). Ohne mod_headers fehlen die Sicherheits-Header samt
Content-Security-Policy aus den .htaccess-Dateien still
- Empfohlen:
mod_deflate und mod_filter. Damit kommen CSS, JS und HTML komprimiert an
(beim ersten Aufruf des Dashboards rund 210 statt 870 KB). Ohne die Module läuft alles,
nur langsamer im Mobilfunk
- SSL-Zertifikat (für PWA und sichere Authentifizierung)
- Schreibrechte für Upload-Verzeichnisse
Setup
-
Paket besorgen — für den Betrieb die veröffentlichte Version:
⬇ Aktuelle Version herunterladen
This is the beginning of the README. Read the rest at the original. Read the full README ↗
