WORTMANN AG Β· Personal Management System
TerraHR ist eine vollstΓ€ndige, intern gehostete Management-Plattform fΓΌr Personalverwaltung, Zeiterfassung, Aufgabenmanagement und KI-gestΓΌtzte HR-Analysen. Die Plattform lΓ€uft vollstΓ€ndig On-Premises ohne externe Cloud-AbhΓ€ngigkeiten.
Alle implementierten Module mit aktuellem Entwicklungsstand.
VollstΓ€ndig On-Premises β keine externen Cloud-AbhΓ€ngigkeiten. Alle Daten bleiben intern.
VollstΓ€ndig containerisierte Monorepo-Architektur mit klarer Service-Trennung.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| POST | /api/auth/login | Admin-Login (Username + Passwort β JWT-Cookie) |
| POST | /api/auth/ma/login | MA-Portal-Login (Personalnummer + Passwort) |
| GET | /api/auth/check | Session validieren |
| POST | /api/auth/logout | Session beenden |
| POST | /api/auth/change-password | Passwort Γ€ndern (Admin) |
| GET | /api/auth/ma/check | MA-Session validieren |
| POST | /api/auth/ma/logout | MA-Session beenden |
| POST | /api/auth/ma/change-password | MA-Passwort Γ€ndern |
VollstΓ€ndiger Personalstamm mit Profilfotos, Status-Tracking und Employee Self-Service.
| Feld | Typ | Beschreibung |
|---|---|---|
| personalnummer | TEXT | Eindeutige Personalnummer |
| vorname / nachname | TEXT | VollstΓ€ndiger Name |
| status | ENUM | aktiv, inaktiv, ausgeschieden, probezeit |
| beschaeftigungsart | ENUM | Vollzeit, Teilzeit, Minijob, Ausbildung, Praktikum |
| positionId / abteilungId | FK | Org-Einordnung |
| eintrittsdatum | DATE | FΓΌr JubilΓ€ums-Berechnung |
| urlaubsanspruch | INT | Jahres-Urlaubstage (Standard 30) |
| extraData | JSONB | Erweiterbare Custom-Felder |
| Methode | Endpoint | Funktion |
|---|---|---|
| GET | /api/mitarbeiter | Liste (Filter: status, Abteilung) |
| GET | /api/mitarbeiter/:id | Einzelprofil |
| POST | /api/mitarbeiter | Neuer Mitarbeiter |
| PUT | /api/mitarbeiter/:id | Aktualisieren |
| DELETE | /api/mitarbeiter/:id | Archivieren (soft) |
| POST | /api/mitarbeiter/:id/avatar | Foto hochladen |
| GET | /api/mitarbeiter/:id/avatar | Foto abrufen |
| GET | /api/portal/profil | MA-Self-Service |
VollstΓ€ndiges Stempeluhrsystem mit Arbeitszeitmodellen, Terminal-Integration und automatischer Γberstunden-Berechnung.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/zeiterfassung/anwesenheit | Live-Anwesenheitsliste (aktuell eingestempelte MA) |
| GET | /api/zeiterfassung/eintraege | ZeiteintrΓ€ge (Filter: MA, Zeitraum) |
| POST | /api/zeiterfassung/stempel | Manuelles Ein-/Ausstempeln |
| PUT | /api/zeiterfassung/eintraege/:id | Zeiteintrag korrigieren |
| DELETE | /api/zeiterfassung/eintraege/:id | Zeiteintrag lΓΆschen |
| GET | /api/zeiterfassung/terminals | Alle Terminals auflisten |
| POST | /api/zeiterfassung/terminals | Terminal anlegen |
| PUT | /api/zeiterfassung/terminals/:id | Terminal bearbeiten |
| PUT | /api/zeiterfassung/terminals/:id/nachricht | Laufschrift-Ansage setzen |
| DELETE | /api/zeiterfassung/terminals/:id | Terminal lΓΆschen |
| GET | /api/zeiterfassung/modelle | Arbeitszeitmodelle auflisten |
| POST | /api/zeiterfassung/modelle | Arbeitszeitmodell anlegen |
| PUT | /api/zeiterfassung/ma/:id/modell | Modell einem MA zuweisen |
| GET | /api/portal/zeit | MA-Portal: eigene ZeiteintrΓ€ge |
8 Abwesenheitstypen mit vollstΓ€ndigem Genehmigungsworkflow und Saldo-Berechnung.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/abwesenheiten | Liste (Filter: MA, Typ, Status, Datum) |
| POST | /api/abwesenheiten | Abwesenheit erstellen |
| PUT | /api/abwesenheiten/:id | Abwesenheit bearbeiten |
| DELETE | /api/abwesenheiten/:id | Abwesenheit lΓΆschen |
| POST | /api/abwesenheiten/:id/genehmigen | Genehmigen (Status β genehmigt) |
| POST | /api/abwesenheiten/:id/ablehnen | Ablehnen (Status β abgelehnt) |
| GET | /api/portal/abwesenheiten | MA-Portal: eigene AntrΓ€ge |
| POST | /api/portal/abwesenheiten | MA-Portal: Antrag stellen |
Kanban-Board mit Drag & Drop, PrioritΓ€ten, FΓ€lligkeitsdaten und DateianhΓ€ngen bis 20 MB.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/aufgaben | Liste (Filter: MA, Status, PrioritΓ€t) |
| POST | /api/aufgaben | Aufgabe erstellen |
| PUT | /api/aufgaben/:id | Aufgabe aktualisieren (inkl. Statuswechsel) |
| DELETE | /api/aufgaben/:id | Aufgabe lΓΆschen |
| POST | /api/aufgaben/:id/anhaenge | Dateianhang hochladen (max 20 MB) |
| GET | /api/aufgaben/:id/anhaenge | AnhΓ€nge auflisten |
| GET | /api/aufgaben/:id/anhaenge/:aid/download | Anhang herunterladen |
| DELETE | /api/aufgaben/:id/anhaenge/:aid | Anhang lΓΆschen |
Asset-Inventar mit Zuweisung, Statusverfolgung und visuellem Hallenplan.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/betriebsmittel | Asset-Inventar auflisten |
| POST | /api/betriebsmittel | Asset anlegen |
| PUT | /api/betriebsmittel/:id | Asset aktualisieren / zuweisen |
| DELETE | /api/betriebsmittel/:id | Asset archivieren |
VollstΓ€ndig lokal betriebene KI auf Basis von Qwen 3.5 35B via LM Studio. Kein Datentransfer in externe Clouds. Multimodal: Text, Bilder und PDFs.
| Tool | Parameter | RΓΌckgabe | Verwendung |
|---|---|---|---|
| get_attendance | β | Aktuell eingestempelte MA | Live-Anwesenheit |
| get_absences | datum?, typ? | Abwesenheitsliste | Urlaubsplanung |
| get_employees | status?, abteilungId? | Mitarbeiterliste | PersonalΓΌbersicht |
| get_open_tasks | mitarbeiterId?, nurUeberfaellige? | Offene Aufgaben | Task-Management |
| get_vacation_balance | mitarbeiterId, jahr? | Resturlaub | Urlaubssaldo |
| get_department_overview | β | Abteilungen + KΓΆpfe | Org-Analyse |
| get_probation_status | β | Probezeit-Mitarbeiter | Onboarding-Check |
| get_overtime_summary | mitarbeiterId?, von?, bis? | Γberstunden-Γbersicht | Zeitanalyse |
| get_employee_profile | mitarbeiterId | VollstΓ€ndiges Profil | Einzel-Snapshot |
| get_employee_notes | mitarbeiterId | Notizenliste | MA-Akte |
| get_monthly_timesheet | mitarbeiterId, monat? | Monatsnachweis | Abrechnung |
| Methode | Endpoint | Beschreibung |
|---|---|---|
| POST | /api/ki/chat | Streaming-Chat (mode, messages, conversationId) |
| GET | /api/ki/conversations | Konversationsliste des Benutzers |
| POST | /api/ki/conversations | Neue Konversation anlegen |
| PATCH | /api/ki/conversations/:id | Titel aktualisieren |
| DELETE | /api/ki/conversations/:id | Konversation + Dateien lΓΆschen |
| GET | /api/ki/conversations/:id/messages | Nachrichtenverlauf laden |
| POST | /api/ki/conversations/:id/messages | Nachrichten persistieren (nach Stream) |
| POST | /api/ki/conversations/:id/files | Datei hochladen (Bild/PDF, max 20 MB) + Text-Extraktion |
| GET | /api/ki/conversations/:id/files | Dateien der Konversation auflisten |
| DELETE | /api/ki/conversations/:id/files/:fid | Datei lΓΆschen |
| GET | /api/ki/files/:fileId | Datei inline ausliefern (auth-geschΓΌtzt) |
VollstΓ€ndige Systemkonfiguration, Benutzerverwaltung mit Rollen-RBAC, Backup und Audit.
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/admin/benutzer | Admin-Benutzer auflisten |
| POST | /api/admin/benutzer | Admin anlegen (Rolle, Scope, Bereich) |
| PUT | /api/admin/benutzer/:id | Benutzer bearbeiten |
| DELETE | /api/admin/benutzer/:id | Benutzer lΓΆschen |
| POST | /api/admin/benutzer/:id/reset-password | Passwort-Reset erzwingen |
| GET | /api/admin/rollen | Rollen + Berechtigungen |
| POST | /api/admin/rollen | Rolle anlegen (Views-Array, Scope) |
| PUT | /api/admin/rollen/:id | Rolle bearbeiten |
| GET | /api/admin/abteilungen | Abteilungen |
| POST | /api/admin/abteilungen | Abteilung anlegen |
| GET | /api/admin/positionen | Positionen / Stellen |
| POST | /api/admin/positionen | Position anlegen |
| POST | /api/admin/backup | VollstΓ€ndiges JSON-Backup erstellen (alle 23 Tabellen) |
| GET | /api/admin/backup | Backup-Liste anzeigen |
| GET | /api/admin/audit | Audit-Log (paginiert) |
| GET | /api/admin/audit/verify | SHA256-Kette verifizieren |
| GET | /api/admin/system-info | Systemstatus & Statistiken |
Γffentlicher Stempel-Kiosk mit eigenem WORTMANN-Design. Authentifizierung via Token (kein JWT erforderlich).
| Methode | Endpoint | Beschreibung |
|---|---|---|
| GET | /api/terminal/info?token=X | Terminal-Name, Standort, Laufschrift |
| GET | /api/terminal/anwesenheit?token=X | Aktuell eingestempelte MA |
| POST | /api/terminal/stempel?token=X | Stempeln via Personalnummer (Auto Ein/Aus) |
VollstΓ€ndige Mitarbeiterentwicklung, Dokumentenmanagement und Kalender-Integration.
PostgreSQL 16 Β· 23 Tabellen Β· Drizzle ORM Β· 6 Migrationen
Alle Endpoints nach Bereich. Basis-URL: http://localhost:3000 Β· Auth: JWT-Cookie
| Bereich | Methode | Endpoint | Beschreibung | Auth |
|---|---|---|---|---|
| π Auth | POST | /api/auth/login | Admin-Login | Public |
| POST | /api/auth/ma/login | MA-Portal-Login | Public | |
| GET | /api/auth/check | Session prΓΌfen | JWT | |
| POST | /api/auth/logout | Abmelden | JWT | |
| POST | /api/auth/change-password | Passwort Γ€ndern | JWT | |
| GET | /api/auth/ma/check | MA-Session prΓΌfen | MA-JWT | |
| POST | /api/auth/ma/logout | MA abmelden | MA-JWT | |
| POST | /api/auth/ma/change-password | MA-PW Γ€ndern | MA-JWT | |
| π₯ Mitarbeiter | GET | /api/mitarbeiter | Liste (Filter) | JWT |
| GET | /api/mitarbeiter/:id | Profil abrufen | JWT | |
| POST | /api/mitarbeiter | Anlegen | JWT | |
| PUT | /api/mitarbeiter/:id | Bearbeiten | JWT | |
| DELETE | /api/mitarbeiter/:id | Archivieren | JWT | |
| POST | /api/mitarbeiter/:id/avatar | Avatar hochladen | JWT | |
| GET | /api/portal/profil | MA-Self-Service | MA-JWT | |
| β±οΈ Zeit | GET | /api/zeiterfassung/anwesenheit | Live-Anwesenheit | JWT |
| GET | /api/zeiterfassung/eintraege | ZeiteintrΓ€ge | JWT | |
| POST | /api/zeiterfassung/stempel | Stempeln | JWT | |
| PUT | /api/zeiterfassung/eintraege/:id | Korrektur | JWT | |
| GET | /api/portal/zeit | MA eigene Zeiten | MA-JWT | |
| π₯οΈ Terminal | GET | /api/terminal/info | Terminal-Info | Token |
| GET | /api/terminal/anwesenheit | Aktuelle Anwesenheit | Token | |
| POST | /api/terminal/stempel | Stempeln via Personalnr. | Token | |
| π€ TerraKI | POST | /api/ki/chat | Streaming-Chat | JWT |
| GET | /api/ki/conversations | Konversationen | JWT | |
| POST | /api/ki/conversations/:id/files | Datei-Upload | JWT | |
| GET | /api/ki/files/:id | Datei ausliefern | JWT |