Method

Methodik

Lesbar zuerst, perfekt spater.

Shiftwell liest eine Arbeits- und Schlafwoche als Spannung zwischen Belastung, Erholung, biologischer Nacht und Regelmassigkeit. Die aktuelle Version bleibt ein nachvollziehbares MVP, das an externen Referenzen ausgerichtet ist, ohne sie identisch nachzubilden.

Position

Erklarbares MVP

Eine dokumentierte Proxy-Engine, keine finale klinische Formel.

Hauptreferenz

Workbook

Schwellen und Faktoren werden laufend mit der Arbeitskopie abgeglichen.

Ziel

Nachvollziehbar

Jeder sichtbare Faktor soll auf Quelle und Status zuruckfuhren.

Was die Formel heute liest

Der Risiko-Score fasst die Wochenbelastung aus Arbeitssegmenten, langen Schichten, kurzen Pausen, Nachten sowie biologischen und sozialen Verlust-Proxys zusammen.
Der Schlaf-Score kombiniert durchschnittliche Schlafdauer und einen Regelmassigkeits-Proxy aus dem eingegebenen Plan, ohne Aktigraphie oder physiologische Messung.
Der Anpassungs-Score verbindet inverses Risiko und Schlaf zu einer einfachen Produkt-Lesart, die fur Exploration nutzlich bleibt, aber noch nicht kohortenkalibriert ist.

Mapping

Externe Referenz	Shiftwell-Variable	Status
Arbeitsstunden	Aus Wochen-Arbeitssegmenten berechnet	Implementiert
Lange Schichten	Anzahl langer Arbeitssegmente (Proxy-Schwelle)	Implementiert (Proxy)
Erholung	Langstes Erholungsfenster zwischen Schichten	Implementiert (Proxy)
Nachtschichten	Uberlappung mit biologischem Nachtfenster	Implementiert (Proxy)
Biologischer Verlust	Arbeit im biologischen Fenster (23-7 Uhr, Proxy)	Implementiert (Proxy)
Sozialer Verlust	Arbeit im sozialen Zeitfenster (Proxy)	Implementiert (Proxy)
SRI/TST	Regelmassigkeits-Proxy + Gesamtschlafzeit	MVP Proxy

Aktuelle Grenzen

Aktuelle Version = Proxy v0.1, mehrere Schwellen mussen noch gegen das finale Protokoll fixiert werden.
Die Eingabe bleibt selbstberichtet: Im MVP gibt es weder Aktigraphie noch Wearable-Erfassung.
Der Anpassungs-Score ist noch nicht auf eine Referenzkohorte kalibriert.
Die Oberflache erklart eine aktive Formel, liefert aber weiterhin keine klinischen Empfehlungen.

Nachste Klarstellungen

Die strikte Ausrichtung mit dem Workbook fortsetzen und strittige Lucken formalisieren.
Biologische und soziale Faktoren dort verfeinern, wo Runtime noch proxy-basiert bleibt.
Die Trace erweitern, um verbleibende Explainability-Fallbacks in der UI weiter zu reduzieren.
Die ausreichend robusten Teile stabilisieren, damit Open-Source-Beitrage ruhiger andocken konnen.

MVP

Proxy, aber lesbar

Die aktuelle Prioritat ist, die Engine so klar zu machen, dass Beitragende verstehen, was bereits implementiert ist.
Das Ziel ist nicht, klinische Prazision zu uberverkaufen, sondern sauber zu dokumentieren, was schon existiert.