Timestamp Light: einfache NFC‑Zeiterfassung

Timestamp Light ist eine schlanke, lokale NFC‑Zeiterfassung (ohne Cloud-Zwang): Ein-/Ausstempeln per Tag-Scan, Web‑UI im Browser, CSV‑Export und optionaler Webhook zu deinen Systemen – inklusive Auth und einer Offline‑Queue mit Retry.

Einfach stempeln – ohne Cloud und Lizenz

Viele Teams brauchen Zeiterfassung, aber nicht zwingend ein großes System mit App-Pflicht und Abo-Modell. Häufig reicht: Tag dranhalten → Stempel gesetzt → fertig.

Timestamp Light ist genau dafür gedacht: eine kleine, zuverlässige Zeiterfassung, die im lokalen Netzwerk läuft, eine Web‑Oberfläche bereitstellt und sich per Webhook an bestehende Prozesse (ERP/HR, Automationen, Datenablagen) anbinden lässt.

Was du bekommst

NFC‑Ein/Aus-Stempeln per Karten/Tags (schnell, kein Handy nötig)
Web‑UI im Browser: Tagesübersicht, Protokoll, Mitarbeiterverwaltung
CSV‑Export fürs Controlling/Excel
Optionaler Webhook: jedes Event geht als JSON an deine URL
Zuverlässigkeit: Offline-/Fehlerfälle werden gepuffert (Queue + Retry)

Typische Einsatzfälle

Werkstatt / Lager / Produktion (schnelles „Kommen/Gehen“)
Coworking / Lab / Vereinsbetrieb
Kleine Teams, die lokal arbeiten möchten
Teams mit bestehenden Tools, die Events automatisiert übernehmen wollen

Hardware: kompakt, günstig, robust

Timestamp Light läuft auf einem kleinen Mikrocontroller (z.B. Wemos D1 mini) und einem NFC‑Reader. Der Aufbau ist überschaubar und eignet sich gut für ein kleines Gehäuse am Eingang.

Verdrahtung: Wemos D1 mini ↔ PN532 (I2C).

Web‑UI: Überblick in Sekunden

Im Alltag zählt: sofort sehen, ob alles läuft – und wer heute bereits gestempelt hat.

Übersicht: Tagesstatus und aktueller Systemzustand.

Mitarbeiterdaten: optional, aber hilfreich für Prozesse

Für Business‑Integrationen ist ein Klarname alleine oft nicht genug. Deshalb unterstützt Timestamp Light zusätzliche, optionale Felder:

Mitarbeiter‑Nr (employeeNr)
Badge‑Nr (badgeNr)

So können Events in Drittsystemen eindeutig zugeordnet werden – ohne dass du komplizierte Mappings pflegen musst.

Mitarbeiter erfassen: UID per Scan, Name + optionale Nummern.

Webhook: Events automatisch weiterverarbeiten (mit Auth)

Bei jedem Ein-/Ausstempeln kann Timestamp Light (optional) ein JSON per POST an eine URL schicken – z.B. an ein HR-/ERP-System, eine Datenbank oder eine Automations-Plattform.

Damit der Endpoint abgesichert werden kann, unterstützt die Konfiguration einen optionalen Auth‑Header, z.B.:

X-API-Key: <dein_key>
Authorization: Bearer <token>

Webhook: URL + optionaler Auth‑Header + Timeout.

Payload-Beispiel

{
  "ts": 1739200000,
  "uid": "04A3....",
  "action": "in",
  "employee": {
    "name": "Simon",
    "employeeNr": "1",
    "badgeNr": "A-023232"
  }
}

Zuverlässigkeit: Offline‑Puffer (Queue) + Retry mit Backoff

Damit Webhook‑Events nicht verloren gehen, wenn WLAN oder Zielsystem kurz nicht verfügbar sind, gibt es eine persistente Queue:

fehlgeschlagene Webhook‑Events werden lokal gepuffert (/webhook-queue.jsonl)
maximale Queue‑Größe: 50 Events
automatischer Retry im Hintergrund mit Backoff bis max. 60 Sekunden

Ergebnis: Stempeln funktioniert weiter, und Events werden später nachgeliefert.

Datenschutz

Timestamp Light läuft lokal im Netzwerk und benötigt keine externe Cloud. Welche Daten dein Webhook nach außen sendet, steuerst du selbst über die Konfiguration und die angebundenen Systeme.

Installation/Update (kurz & pragmatisch)

Timestamp Light wird mit PlatformIO gebaut und auf das Gerät geladen:

Firmware: PlatformIO → Upload
Web‑UI: PlatformIO → Upload Filesystem Image (wichtig nach UI‑Änderungen)

Wir veröffentlichen Timestamp Light OpenSource auf Github: https://github.com/pitwch/timestamp-light#deutsch

Builden, Bauen und ausprobieren !

Fazit

Timestamp Light ist eine Zeiterfassung, die sich im Alltag bewährt: schnell, lokal, verständlich. Mit Webhook + Auth + Offline‑Queue wird daraus ein solider Baustein für Business‑Prozesse – ohne die Komplexität großer Systeme.