Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qu4xuNCkFLDByYWUrjanny
3.4 KiB
3.4 KiB
Zeiterfassung (timetracker-next) – Plan
Ein Zeiterfassungs-Tool nach deutschen Standards.
- Backend: Go, Gin, Gin-Logrus, swaggo, GORM, godotenv (autoload)
- Frontend: React (Vite, TypeScript)
- Datenbanken: SQLite, MariaDB, PostgreSQL (über
DB_DRIVERgewählt)
Leitentscheidungen
| Thema | Entscheidung |
|---|---|
| Registrierung | Öffentlich, nur Benutzername + Passwort |
| Auth | JWT (Bearer), Passwort-Hash mit bcrypt |
| Sollzeit | Konfigurierbare Stunden pro Arbeitstag (Standard 8 h), Wochenziel = 5 × Tagesziel (Standard 40 h). Gilt Mo–Fr. |
| Überstunden | Saldo = Summe (Ist − Soll) über alle Arbeitstage bis heute, plus optionaler Startsaldo. Urlaubstage zählen mit Soll-Stunden als erfüllt. |
| Zeiterfassung | Start/Stopp-Timer (genau ein laufender Timer pro Benutzer) sowie manuelle Einträge mit Von/Bis. Überlappungen werden abgelehnt. |
| Urlaub | Ganztägige Urlaubstage, Kontingent pro Jahr konfigurierbar (Standard 30). |
| Arbeitszeitgesetz | Hinweis (keine Sperre), wenn ein Tag mehr als 10 h erfasst (ArbZG § 3); Warnung ab 8 h mit Hinweis auf Pausen (§ 4). |
| Formate | Datum TT.MM.JJJJ, Dezimalkomma (8,50 h), Zeit HH:MM, Zeitzone Europe/Berlin. |
| CSV | Semikolon-getrennt, UTF-8 mit BOM (Excel-kompatibel), Dezimalkomma. |
| Monatsbericht/Zeitraumbericht mit Summen, Saldo und Unterschriftsfeld. | |
| Tests | Go: testing + httptest gegen SQLite in-memory; Frontend: Vitest + Testing Library. |
| Commits | Pro Schritt ein Commit, nur wenn die Tests dieses Schritts grün sind. |
Verzeichnisstruktur (Ziel)
backend/
cmd/server/main.go
internal/
config/ Umgebungsvariablen (godotenv autoload)
logging/ Logrus-Setup + Gin-Middleware
database/ GORM-Öffnung für sqlite/mariadb/postgres, Migration
models/ GORM-Modelle
auth/ Registrierung, Login, JWT, Middleware
settings/ Benutzereinstellungen (Sollzeit, Urlaubskontingent, Startsaldo)
timeentries/ Start/Stopp, manuelle Einträge, Liste
vacation/ Urlaubseinträge
overtime/ Saldo-Berechnung und Summen
export/ CSV- und PDF-Export
httpapi/ Router, Handler-Registrierung, Fehlerformat
docs/ swag-generierte Swagger-Dateien
frontend/
src/ React-App (Auth, Dashboard, Einträge, Urlaub, Export, Einstellungen)
docs/plan/ diese Dateien
Schritte
- Backend-Grundgerüst
- Datenbank und Modelle
- Auth: Registrierung und Login
- Einstellungen und Sollzeit
- Zeiteinträge (Timer und manuell)
- Urlaub
- Überstundensaldo und Übersicht
- Export: CSV und PDF
- Frontend
- Abschluss: Doku, Swagger, Docker-Compose
Konfiguration (.env)
| Variable | Standard | Bedeutung |
|---|---|---|
APP_PORT |
8080 |
HTTP-Port |
APP_JWT_SECRET |
– (Pflicht) | Signaturschlüssel für JWT |
APP_JWT_TTL_HOURS |
24 |
Gültigkeit des Tokens |
APP_LOG_LEVEL |
info |
Logrus-Level |
DB_DRIVER |
sqlite |
sqlite, mariadb oder postgres |
DB_NAME |
timetracker.db |
Dateipfad (sqlite) bzw. Datenbankname |
DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_SSLMODE |
– | Verbindungsfelder für mariadb/postgres; die DSN wird im Backend zusammengesetzt |