FirstCommit

README.md

@@ -0,0 +1,152 @@
+# Stundenerfassungs-System
+
+Eine webbasierte Anwendung zur Erfassung von Arbeitszeiten mit Admin-Bereich und PDF-Export.
+
+## Features
+
+### Für Mitarbeiter
+- ✅ Login mit Benutzername und Passwort
+- ✅ Wöchentliche Stundenerfassung (Montag - Sonntag)
+- ✅ Automatisches Speichern der Einträge
+- ✅ Eingabe von Start-/Endzeit, Pausen und Notizen
+- ✅ Automatische Berechnung der Gesamtstunden
+- ✅ Wöchentliches Abschicken des Stundenzettels
+
+### Für Administratoren
+- ✅ Benutzerverwaltung (Anlegen, Löschen)
+- ✅ Rollenvergabe (Mitarbeiter, Verwaltung, Admin)
+- ✅ Übersicht aller Benutzer
+
+### Für Verwaltung
+- ✅ Postfach mit eingereichten Stundenzetteln
+- ✅ PDF-Generierung und Download
+- ✅ Übersichtliche Darstellung aller Einreichungen
+
+## Installation
+
+### Voraussetzungen
+- Node.js (Version 14 oder höher)
+- npm (wird mit Node.js installiert)
+
+### Schritt 1: Dependencies installieren
+
+```bash
+npm install
+```
+
+### Schritt 2: Server starten
+
+```bash
+npm start
+```
+
+Der Server läuft nun auf `http://localhost:3000`
+
+Für Entwicklung mit automatischem Neustart:
+```bash
+npm run dev
+```
+
+## Standard-Zugangsdaten
+
+Nach der Installation sind folgende Benutzer verfügbar:
+
+### Administrator
+- **Benutzername:** admin
+- **Passwort:** admin123
+- **Funktion:** Kann Benutzer anlegen und verwalten
+
+### Verwaltung
+- **Benutzername:** verwaltung
+- **Passwort:** verwaltung123
+- **Funktion:** Kann eingereichte Stundenzettel einsehen und PDFs erstellen
+
+**WICHTIG:** Bitte ändern Sie diese Passwörter nach der ersten Anmeldung!
+
+## Verwendung
+
+### Für Mitarbeiter
+
+1. Melden Sie sich mit Ihren Zugangsdaten an
+2. Wählen Sie die gewünschte Woche aus (Pfeiltasten)
+3. Tragen Sie Ihre Arbeitszeiten ein:
+   - **Start:** Arbeitsbeginn
+   - **Ende:** Arbeitsende
+   - **Pause:** Pausenzeit in Minuten
+   - **Notizen:** Optional, z.B. Projekt oder Tätigkeit
+4. Die Einträge werden automatisch gespeichert
+5. Am Ende der Woche: Klicken Sie auf **"Woche abschicken"**
+6. Nach dem Abschicken können keine Änderungen mehr vorgenommen werden
+
+### Für Administratoren
+
+1. Melden Sie sich als Admin an
+2. Sie gelangen automatisch zur Benutzerverwaltung
+3. **Neuen Benutzer anlegen:**
+   - Füllen Sie das Formular aus
+   - Wählen Sie die passende Rolle
+   - Klicken Sie auf "Benutzer anlegen"
+4. **Benutzer löschen:**
+   - Klicken Sie auf "Löschen" neben dem gewünschten Benutzer
+   - System-Benutzer (Admin, Verwaltung) können nicht gelöscht werden
+
+### Für Verwaltung
+
+1. Melden Sie sich als Verwaltungs-Benutzer an
+2. Sie sehen alle eingereichten Stundenzettel im Postfach
+3. **PDF erstellen:**
+   - Klicken Sie auf "PDF herunterladen" neben dem gewünschten Stundenzettel
+   - Die PDF wird automatisch generiert und heruntergeladen
+4. Die PDF enthält:
+   - Mitarbeitername
+   - Zeitraum
+   - Alle Tageseinträge mit Start, Ende, Pause, Stunden und Notizen
+   - Gesamtstundensumme
+
+## Technologie-Stack
+
+- **Backend:** Node.js + Express
+- **Datenbank:** SQLite3
+- **Template Engine:** EJS
+- **PDF-Generierung:** PDFKit
+- **Authentifizierung:** bcryptjs + express-session
+
+## Datenbankstruktur
+
+### Tabelle: users
+- Speichert Benutzerinformationen und Zugangsdaten
+- Passwörter werden verschlüsselt gespeichert
+
+### Tabelle: timesheet_entries
+- Speichert einzelne Tageseinträge
+- Automatische Berechnung der Gesamtstunden
+
+### Tabelle: weekly_timesheets
+- Speichert eingereichte Wochenstundenzettel
+- Verknüpfung mit Benutzer und Status
+
+## Sicherheit
+
+- ✅ Passwörter werden mit bcrypt verschlüsselt
+- ✅ Session-basierte Authentifizierung
+- ✅ Rollenbasierte Zugriffskontrolle
+- ✅ CSRF-Schutz durch Sessions
+
+## Anpassungen
+
+### Port ändern
+Bearbeiten Sie in `server.js` die Zeile:
+```javascript
+const PORT = 3000; // Ändern Sie hier den Port
+```
+
+### Datenbank-Speicherort
+Die Datenbank wird standardmäßig als `stundenerfassung.db` im Projektverzeichnis gespeichert.
+
+## Lizenz
+
+Proprietär - Für interne Firmennutzung
+
+## Support
+
+Bei Fragen oder Problemen wenden Sie sich bitte an Ihre IT-Abteilung.