Projektabschlussbericht - Foerderprojekt Stayfix

Ergebnisbericht: Funktionsumfang, technische Umsetzung und Nachhaltigkeit

Die Software wurde vollstaendig intern umgesetzt. Hosting erfolgt ueber Vercel, Datenbank, Authentifizierung und Kernlogik ueber Supabase. Serverstandort ist Frankfurt am Main, ebenso die Supabase-Region.

Dokumentierte Seiten

Website + Dashboard-Routen

Backend-Module

Auth, CRUD, Reminder, Upload

Projektbilder

Aus `public/` eingebunden

Standort

Frankfurt

Vercel + Supabase Region FRA

1) Umgesetzter Inhalt innerhalb des Projekts

1043 / 1500 Zeichen

Im Projekt Stayfix wurde ein webbasierter MVP zur Verwaltung von Aufenthaltstiteln von Mitarbeitenden umgesetzt. Die Anwendung deckt den gesamten Kernprozess ab: Mitarbeitendenprofile anlegen, Aufenthaltstitel erfassen und verwalten, Fristen beobachten, Dokumente strukturiert speichern und Status transparent darstellen. Erfasst werden Titeltyp, Nummer, Ausstellungs- und Ablaufdatum, Auflagen/Beschraenkungen, zustaendige Behoerde sowie optionale Felder wie Vorrangpruefung und Zustimmungscode. Im Dashboard sind Suche, Filter und Priorisierung integriert (z. B. gueltig, laeuft bald ab, abgelaufen). Detailansichten unterstuetzen die Fallbearbeitung mit nachvollziehbarem Status. Fuer Fristen wurden automatisierte Reminder mit Eskalationslogik umgesetzt, damit Mitarbeitende und Verantwortliche rechtzeitig informiert werden. Zusaetzlich wurden Datenschutz und Sicherheit von Anfang an beruecksichtigt: rollenbasierte Zugriffe, Ownership-Pruefungen pro Datensatz, datensparsame Felder, sichere Upload-Pfade und DSGVO-konforme Verarbeitung.

2) Realisierte Aspekte oekonomischer, sozialer oder oekologischer Nachhaltigkeit

472 / 500 Zeichen

Green Coding wurde durchgaengig angewendet: schlanke Datenmodelle, effiziente Abfragen mit user_id-Filterung, gezielte Sortierung, minimale Payloads, Parallelisierung mit Promise.all und Vermeidung unnoetiger Dauerprozesse. Oekonomisch reduziert Stayfix manuellen Aufwand und Fristversaeumnisse durch Automatisierung. Sozial verbessert die Loesung die Zusammenarbeit zwischen HR, Fuehrung und Mitarbeitenden durch klare Verantwortlichkeiten und verlaessliche Erinnerungen.

3) Weitere realisierte positive Effekte des umgesetzten Projekts

467 / 500 Zeichen

Stayfix senkt das Risiko von Arbeitsunterbrechungen und Bussgeldern durch fruehe Fristwarnungen. Die zentrale Datenstruktur erhoeht Transparenz und reduziert Abstimmungsaufwand zwischen Rollen. Durch dokumentierte Statuslogik, nachvollziehbare Aenderungen und zentrale Dokumentenablage steigt die Prozessqualitaet. Die Architektur ist skalierbar und bildet die Grundlage fuer weitere Module wie Reporting, erweiterte Rollenmodelle und feinere Benachrichtigungsregeln.

Technische Architektur im Detail

Stayfix basiert auf Next.js (App Router) mit serverseitigen Route-Handlern, Supabase-Authentifizierung mit Cookie-Session, relationalem Postgres-Datenmodell und strukturiertem Storage fuer Dokumente.

Hosting: Vercel in Frankfurt fuer Deployment, Build und Runtime.

API-Schicht: Next.js Route Handler unterapp/api mit serverseitiger Validierung.

Auth: Supabase Auth (Frankfurt) mit Session-Cookies und geschuetzten Dashboard-Routen.

Datenhaltung: Supabase Postgres in Frankfurt, inkl. klarer Tabellenbeziehungen.

Sicherheit: Ownership-Pruefung je Datensatz (u. a. Filter ueber user_id).

Storage: Dokument-Uploads im Bucketdokumente mit strukturierten Pfaden pro Mitarbeitendenfall.

Datenmodell

employeesresidence_titlesorg_unitsnotification_rulesnotification_rule_phasesnotification_rule_recipientsnotification_profiles

API-Module

/api/login/api/me/api/employees/api/employees/documents/api/residence-titles/api/org-units (+ /reorder)/api/notification-rules + /api/notification-profiles

Green Coding konkret umgesetzt

Schlanke Datenstrukturen, zielgenaue Queries, reduzierte Payloads, Parallelisierung von Requests, datensparsame Felder, strukturierte Caching-Strategien und Verzicht auf unnoetige Hintergrundlast.

Umgesetzte Module mit Projektscreenshots

Die folgenden Bilder stammen direkt aus dem Ordner public/.

Dashboard Uebersicht

/dashboard

KPI-Board, Fristrisiken und priorisierte Handlungsfaelle fuer HR und Compliance.

Mitarbeitenden-Modul

/dashboard/mitarbeitende

Suche, Filter und Statusmanagement fuer alle Personen mit dokumentierten Aufenthaltstiteln.

Mitarbeitenden-Detailansicht

/dashboard/mitarbeitende/[id]/ansicht

Serverseitige Einzelansicht mit Stammdaten, Titelbezug und nachvollziehbarer Fallstruktur.

Aufenthaltstitel-Konfiguration

/dashboard/aufenthaltstitel

Titeltypen inklusive Pflichtfeldlogik fuer Dokumentnummer, Fristen, Behoerden und Nachweise.

Benachrichtigungsregeln

/dashboard/benachrichtigung

Mehrstufige Reminder-Phasen mit Offsets, Empfaengergruppen und Eskalationslogik.

Organigramm

/dashboard/organigramm

Abbildung der Unternehmensstruktur mit Parent-Child-Logik und Sortierung pro Ebene.

Backend-Struktur

/api/*

Route Handler in Next.js mit Validierung, Ownership-Pruefungen und API-Schnittstellen.

Datenbankmodell

Supabase Postgres

Relationale Tabellen fuer Mitarbeitende, Titel, Regeln, Phasen und Empfaenger.

Seiten im Website-Bereich

Jede oeffentliche Route wurde fachlich und technisch klar getrennt ausgearbeitet.

Startseite

/

Fachlich: Positioniert Stayfix, erklaert Nutzen und fuehrt ueber klare CTA-Pfade zu Beratung und Erstgespraech.

Technisch: Serverseitig gerenderte Marketingseite mit modularem UI, SEO-Metadaten und optimierten Bild-Assets.

Ablauf

/ablauf

Fachlich: Beschreibt Einfuehrung und Onboarding in klaren Schritten von Erstgespraech bis produktivem Einsatz.

Technisch: Strukturierte Informationsseite mit semantischen Sections und internem Linking auf Beratungs-CTA.

Funktionen

/funktionen

Fachlich: Zeigt den konkreten Produktumfang fuer Titelverwaltung, Reminder und Compliance-Prozesse.

Technisch: Feature-basierte Inhaltsstruktur mit wiederverwendbaren UI-Bloecken und performantem Rendering.

FAQ

/haeufige-fragen

Fachlich: Beantwortet wiederkehrende Fragen zu Einsatz, Datenschutz, Integrationen und Betrieb.

Technisch: Interaktive Accordion-Elemente ohne externe Abhaengigkeiten, barrierearm und leicht pflegbar.

Beratung und Registrierung

/beratung

Fachlich: Einstieg fuer Registrierung per Einladung, Erfassung der Anfrage und Klarstellung des Onboarding-Prozesses.

Technisch: Clientseitiges Formular mit Pflichtfeldlogik, Spam-Honeypot und API-Submission fuer Lead-Erfassung.

Login

/login

Fachlich: Zentraler Zugangspunkt fuer Bestandsnutzerinnen und -nutzer mit Verweis auf den Registrierungsweg.

Technisch: Auth-Formular mit Supabase Session-Cookies, Fehlerhandling und Redirect in das Dashboard.

Datenschutz

/datenschutz

Fachlich: DSGVO-relevante Informationen zu Verarbeitung, Rechtsgrundlagen, Speicherfristen und Betroffenenrechten.

Technisch: Langform-Content mit Inhaltsverzeichnis, semantischen Anchor-Sections und dynamischer Metadatensteuerung.

Impressum

/impressum

Fachlich: Rechtliche Pflichtangaben des Anbieters inklusive Handelsregister- und Kontaktinformationen.

Technisch: Klare Informationsarchitektur mit strukturierter Ausgabe und konsistentem UI zur Datenschutzseite.

Projektabschlussbericht

/projektabschluss

Fachlich: Dokumentiert fuer die Foerderung den Ergebnisstand, die Wirkung und den technischen Umsetzungsrahmen.

Technisch: Neue Dokumentationsseite mit Bildbezug, Zeichenzahlkontrolle und detailierter Seiten-/Architekturaufbereitung.

Seiten im App-/Dashboard-Bereich

Die interne Anwendung wurde modular fuer operative Fallbearbeitung und Compliance-Transparenz aufgebaut.

Dashboard Uebersicht

/dashboard

Fachlich: Zentraler Arbeitsstart mit KPIs, Fristenfenstern, kritischen Faellen und Datenqualitaetsindikatoren.

Technisch: Breites KPI-Layout als skalierbares Fundament fuer echte Live-Metriken aus Datenbank und Reminder-Engine.

Mitarbeitenden-Liste

/dashboard/mitarbeitende

Fachlich: Operative Hauptseite zur Verwaltung, Suche und Filterung aller Mitarbeitendenfaelle.

Technisch: Paralleles Laden mehrerer API-Ressourcen, clientseitige Filterlogik und Statusklassifizierung.

Mitarbeitende neu

/dashboard/mitarbeitende/neu

Fachlich: Anlage neuer Profile inklusive Titelbezug, Pflichtdaten und Dokumentstrukturen.

Technisch: Wiederverwendung eines gemeinsamen Form-Components im Create-Modus fuer konsistente Datenqualitaet.

Mitarbeitende bearbeiten

/dashboard/mitarbeitende/[id]

Fachlich: Aktualisierung bestehender Faelle und Nachpflege von Fristen, Status und Organisationszuordnung.

Technisch: Selber Form-Component im Edit-Modus mit ID-basierter Datenbindung und sicherem Update-Flow.

Mitarbeitenden-Ansicht

/dashboard/mitarbeitende/[id]/ansicht

Fachlich: Lesende Fallansicht fuer schnelle Pruefung einzelner Datensaetze und Dokumentenstaende.

Technisch: Serverseitige Datenabfrage mit Auth-Check und Redirect, dadurch weniger clientseitige Angriffsoberflaeche.

Aufenthaltstitel

/dashboard/aufenthaltstitel

Fachlich: Konfiguriert Titeltypen und Pflichtfelder, damit Datenerfassung je Rechtsgrundlage sauber bleibt.

Technisch: CRUD-UI auf `residence_titles` mit Feld-Metalogik, Aktiv-Flags und Sortierreihenfolge.

Benachrichtigungen

/dashboard/benachrichtigung

Fachlich: Definiert Reminder-Regeln inkl. Zeitpunkten, Eskalationen und empfaengerbezogener Steuerung.

Technisch: Mehrtabellen-Workflow (`rules`, `phases`, `recipients`) mit Offset-Berechnung und Ownership-Validierung.

Organigramm

/dashboard/organigramm

Fachlich: Bildet Verantwortlichkeiten im Unternehmen ab und verknuepft sie mit Benachrichtigungswegen.

Technisch: Tree-Building aus flachen Relationen, Parent-Level-Logik und Reorder-API fuer stabile Hierarchie.

Umsetzungsform und Projektorganisation

Stayfix wurde vollstaendig intern umgesetzt. Durch die Entwicklung und Optimierung des Quellcodes mit ChatGPT Codex waren keine Freelancer oder sonstige Dritte erforderlich. Dadurch konnten Aufwand, Abstimmung und Time-to-Market deutlich reduziert werden.

Intern entwickeltKeine externen DienstleisterTechnische Steuerung in-house

Zurueck zur Projektseite