admin
4a3dfa5821
- Tabelle passkeys + lib/passkeys.ts (CRUD, Counter-Replay-Schutz)
- lib/webauthn.ts: RP-Config via RP_ID/RP_ORIGIN/RP_NAME, Challenge im
httpOnly-Cookie, Wrapper um @simplewebauthn/server
- API: app/api/passkey/{register,authenticate,route}; authenticate ist
öffentlich (proxy.ts ausgenommen) und setzt bei Erfolg die Session
- Login-Button "Mit Passkey anmelden", Verwaltung im Einstellungen-Tab
- Passwort bleibt als Fallback; Version 0.1.1
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.0 KiB
CLAUDE.md
Hinweise für Claude Code (claude.ai/code) zur Arbeit in diesem Repository.
Commands
npm run dev # Entwicklungsserver
npm run build # Produktions-Build (nach jeder Änderung zur Prüfung ausführen)
npm run lint # ESLint
Kein Test-Setup. Deploy via ./deploy.sh [tag] — baut ein Multiplatform-Docker-Image
(amd64 + arm64) und pusht es nach docker.citysensor.de.
Architektur
Next.js 16 App-Router-Anwendung. Seiten sind Server-Komponenten; interaktive Teile sind
Client-Komponenten in app/MainClient.tsx und components/. Layout und Design sind dem
Schwesterprojekt ~/Projekte/logbuch nachempfunden, jedoch mit grüner Grundfarbe.
Auth: Single-User. Benutzername und Passwort sind fest in .env hinterlegt
(APP_USERNAME default Birgit, APP_PASSWORD). Login über app/login/actions.ts →
lib/auth.ts (Plaintext-Vergleich, kein bcrypt). Sessions sind JWT-Cookies via jose
(lib/session.ts, 8 h Gültigkeit, Cookie arbeitszeit_session). Middleware liegt in
proxy.ts (Next.js-16-Konvention) und exportiert middleware.
Passkeys (WebAuthn): Zusätzlich zum Passwort (das als Fallback bleibt). lib/webauthn.ts
kapselt @simplewebauthn/server (RP-Config aus RP_ID/RP_ORIGIN/RP_NAME, Default
localhost); Credentials liegen in Tabelle passkeys (lib/passkeys.ts). Die Challenge wird
kurzlebig in einem httpOnly-Cookie zwischengespeichert. API unter app/api/passkey/:
register (GET Options / POST Verify, Session nötig), authenticate (GET/POST, öffentlich —
in proxy.ts von der Session-Pflicht ausgenommen, setzt bei Erfolg die Session), sowie
GET/DELETE auf app/api/passkey/route.ts zum Verwalten. Registrierung im Einstellungen-Tab
(components/Passkeys.tsx), Anmeldung per Button auf app/login/page.tsx. WebAuthn braucht
HTTPS (Prod via Traefik) bzw. localhost in der Entwicklung.
Datenbank: SQLite3 via better-sqlite3. lib/db.ts ist ein Singleton, legt Schema und
die settings-Tabelle beim ersten Zugriff an. Datei unter DB_PATH
(default ./data/arbeitszeit.db, in Produktion /app/data/arbeitszeit.db auf einem Volume).
better-sqlite3 ist nativ → serverExternalPackages in next.config.ts und im Dockerfile
python3 make g++ in der deps-Stage.
Datenzugriff: lib/repo.ts (CRUD + Pause-Setting), lib/calc.ts (Zeit-/Wochentag-Helfer),
lib/validate.ts (Body-Validierung). API-Routen unter app/api/ prüfen alle getSession()
und liefern 401 ohne Session.
Datenmodell & Berechnungen
Tabelle arbeitszeit: datum, ort (Kunde FFM | Homeoffice | Andrena), beginn, ende
(je HH:MM), reisezeit, vertriebsunterstuetzung (default 2), kommentar (max. 500).
Arbeitszeit = Ende − Beginn(dezimale Stunden)Mehrarbeit = Arbeitszeit − 8 − Pause- Die Spalte „Arbeitszeit Kunde" ist fix 8 h (
ARBEITSZEIT_KUNDE_FIX). - Die Pause ist eine globale Einstellung in der
settings-Tabelle (Tab „Einstellungen"). Mehrarbeit wird zur Laufzeit berechnet, nicht gespeichert.