Produkt und Laufzeit¶
Basisreferenz
Dieses Kapitel beschreibt das etablierte Produkt- und Laufzeitmodell. Die aktuelle Oberfläche und die native Companion-Grenze stehen auf der letzten Architekturseite.
Produktbild¶
Wofür Steady gedacht ist¶
Steady soll Veränderungen sichtbar machen, ohne aus dem Alltag einen Pflichtfragebogen zu machen. Alles ist freiwillig. Nicht ausgefüllte Werte bleiben unbekannt und werden nicht als Null, Fehler oder nicht erledigte Gewohnheit interpretiert.
Hauptbereiche der Oberfläche¶
flowchart TD
T[Heute] --> J[Journal]
T --> R[Recovery]
T --> P[Muster]
T --> E[Explorer]
T --> X[Toolbox / Mehr]
J:::read -->|chronologischer Rückblick| U[Gespeicherte Daten]
R:::read -->|Counter, Urges, Trigger| U
P:::read -->|Zusammenhänge| U
E:::read -->|Messreihen| U
classDef read fill:#eaf6f1,stroke:#5b9b82,color:#173d31
| Bereich | Leitfrage | Rolle |
|---|---|---|
| Heute | Was möchte ich heute festhalten? | Eingabe und Autosave |
| Journal | Was ist wann passiert? | Chronologischer Rückblick |
| Recovery | Wie entwickelt sich mein Veränderungsbereich? | Counter, Urges, Trigger, Strategien |
| Muster | Was bewegt sich möglicherweise gemeinsam? | Lebensrad, Personen, Sport, Korrelationen |
| Explorer | Wie entwickelt sich ein einzelner Messwert? | Frei konfigurierbare Graphen |
| Toolbox / Mehr | Was brauche ich zusätzlich? | Aufgaben, Meilensteine, Export, Einstellungen |
Produktgrenzen¶
- keine Diagnose und kein Medizinprodukt
- keine automatische Rückfallentscheidung
- kein verpflichtendes Konto
- keine Telemetrie und kein Steady-Backend
- Korrelationen werden nicht als Ursache bezeichnet
- der Companion besitzt keinen Schreibzugriff auf Trackingdaten
Quellen im Repository¶
Systemarchitektur¶
Laufzeitmodell¶
Steady ist eine React-Anwendung, wird mit Vite gebaut und über Capacitor als Android-App verpackt. Der Browser dient als Entwicklungs- und Testumgebung; Android ist das eigentliche Produktziel.
Eine Build-Fähigkeitsgrenze in src/product-variant.js erzeugt bei
VITE_PRODUCT_VARIANT=general-audience eine allgemeine Produktvariante. Sie
entfernt die eingebauten Profile Alkohol und Pornografie/zwanghaftes
Sexualverhalten samt Countern und 12-Schritte-Ressourcen aus der effektiven
Laufzeitkonfiguration. Inventar, Lieblingstexte und Zwölf Schritte werden auch
aus General-Audience-Navigation und Feature-Chunks ausgeschlossen. Passende
gespeicherte Datensätze werden in dieser Variante nicht an die Oberfläche
weitergereicht, aber auch nicht gelöscht. Das Schema bleibt zwischen beiden
Varianten kompatibel.
Die Variantengrenze gilt auch für die Initialkonfiguration:
general-audience verwendet den expliziten kanonischen Satz aus
src/initial-user-config.js mit sechs allgemeinen Bereichen und 21 aktiven
Feldern. Die Recovery-Variante verwendet einen eigenen kanonischen Satz mit
sieben Bereichen und 25 aktiven Feldern. Browser und Android-SQLite erhalten
jeweils denselben variantenspezifischen Seed. Eine
initialConfigurationId-Kennung verhindert, dass die
Kompatibilitätsnormalisierung den sauberen Recovery-Start wieder mit fehlenden
v5-Feldern auffüllt; tatsächlich vorhandene historische Definitionen bleiben
weiter erhalten.
Auch Beispieldaten folgen dieser Grenze. src/data/demo-data.js enthält nur den
neutralen General-Audience-Verlauf. src/data/recovery-demo-data.js ergänzt
für Recovery Suchtdruck, Trigger, drangfreie Check-ins, Rückfälle und atomar
verknüpfte Resets. Beide Varianten besitzen einen 90-Tage- und einen
1.095-Tage-Verlauf. Jeder Datensatz trägt source: "demo", damit die Entfernung
keine echten Daten oder Companion-Erinnerungen berührt.
flowchart TB
UI[React Views und Dialoge]
APP[App-Zustand und Anwendungslogik]
SVC[Services: Tracking, Export, Companion]
DB[db.js – gemeinsame Datenabstraktion]
IDX[(IndexedDB<br/>Browser/Test)]
NATIVE[native-database.js]
CAP[Capacitor-Plugin]
SQL[(verschlüsselte SQLite-Datenbank)]
UI --> APP --> SVC --> DB
DB -->|Browser| IDX
DB -->|Android| NATIVE --> CAP --> SQL
Handy als HTTPS-Server¶
Die optionale PC-Eingabe nutzt einen separat gebauten Browser-Client ohne
IndexedDB, Export oder Sync. PcEntryService stellt ihn über HTTPS auf der
privaten WLAN-IPv4-Adresse des Handys, Port 1111, bereit. Ein sichtbarer
connectedDevice-Foreground-Service und CPU-/WLAN-Locks halten den ausdrücklich
gestarteten Zugang aktiv. Selbstsigniertes Zertifikat, Kopplungscode,
Cookie-Sitzung und CSRF-/Host-/Origin-Prüfung schützen die Netzwerkgrenze.
Der TLS-Key-Manager stellt dieselbe Android-Keystore-Identität über Socket- und
Engine-Aufrufe bereit. Moderne Android-Conscrypt-Sockets nutzen den Engine-Aufruf;
ohne ihn bricht der Handshake vor der Zertifikatwarnung des Browsers ab.
Ein Instrumentierungstest prüft TLS 1.2 mit dem festgelegten Zertifikat über Loopback.
Die v2-RSA-Identität erlaubt DIGEST_NONE und rohes RSA-Padding, damit Conscrypt
seinen vorberechneten TLS-Digest signieren kann; für TLS-Kompatibilität ist
RSA-Entschlüsselung freigegeben. Der erste Start ersetzt das inkompatible v1-PC-Zertifikat
und ändert dessen Fingerabdruck; Tracking-Schlüssel und Zugangsdaten bleiben erhalten.
PcEntryCheckins erlaubt aktuelle Tagesfelder für heute und sieben Vortage.
Definitionen, Optionen, Datumsfenster und Wochentagsregeln werden vor jedem
Schreiben nativ geprüft. Die Wochentagsnummerierung verwendet Montag = 0 bis Sonntag = 6. Der PC verwendet denselben
gespeicherten Filter ohne Umrechnung; [5, 6] blendet Samstag/Sonntag aus, nicht Freitag.
Server und Capacitor verwenden dieselbe synchronisierte
EncryptedRecordStore-Abstraktion; SQLite-Schema und AES-GCM bleiben unverändert.
Ein Zellschreibvorgang erhält andere und historische Werte. Veraltete Revisionen
oder Handy-Autosaves werden als Konflikt abgelehnt, nicht zusammengewürfelt.
Der zusätzliche Leseweg GET /api/analytics liefert eine Positivliste aus
historischen typisierten Feldwerten und Feldversionen, numerischen Ereignisdaten,
referenzierten Kataloglabels mit Gewichtung sowie Counter-Start-/Resetdaten der
aktiven ausgewählten Bereiche. General-Audience-Filter bleiben erhalten. Freie
Texte werden nur als Vorhandensein für ausdrücklich aktivierte Textzählungen
übertragen; Journalinhalte und Ereignisnotizen, Gründe und Reaktionen bleiben
außerhalb dieses Analytics-Lesewegs.
Die Eingabe zeigt zusätzlich Kontakte, Sport, Selbstfürsorge, Suchtdruck, Trigger
und bewusste Null-Check-ins im achttägigen Fenster einschließlich ihrer
bearbeitbaren Texte. POST /api/event prüft Ereignistypen, Bereichs-/Datumsregeln,
ausgewählte Veränderungsbereiche, Counter-Zuordnung und Schema-/Ereignisrevisionen.
PcEntryEvents speichert Ereignis, Katalogerstellung/-reaktivierung, Null-Ersetzung
und zugehörige Resets in einer gemeinsamen Transaktion des verschlüsselten
Speichers. Rückfall-Speicherungen benötigen eine Bestätigung; Rückfälle lassen
sich nicht löschen. Stabile Vorgangskennungen verhindern doppelte Ereignisse
und Resets bei Wiederholungen. Die gemeinsamen Formulare benötigen keine
Browser-Datenbank; offene Entwürfe behalten ihre ursprünglichen Versionsbedingungen.
Unabhängige Counter-Änderungen bleiben am Handy.
Explorer, Lebensrad und Korrelationen verwenden dieselben React-Komponenten und
Berechnungen wie die Handy-App. CorrelationCacheContext bindet nur am Handy den
Datenbankcache ein; der PC rechnet im Arbeitsspeicher. Gemeinsame Kalenderachsen
zeigen Lücken, und ein angeklickter Zeitraum öffnet daneben seine erfassten Werte.
Zeitraumvergleiche überschneiden sich nicht. PC-Auswahlzustände bleiben nur in
der Sitzung; die sichtbare Analyse aktualisiert sich alle 15 Sekunden und lädt
bei unveränderter Revision keine Historie erneut. Der Handytag bestimmt Counter
und Standardzeitraum. Chats, Tokens, Providerdaten, Backups, Inventur und Aufgaben
haben keinen PC-API-Pfad. Die native Erreichbarkeit bei ausgeschaltetem Display
ist noch nicht abgenommen.
PC-Konfiguration als Transaktion¶
Die PC-Ansicht Konfiguration hält Bereiche, aktuelle Felder und
Lebensrad-Achsen als Entwurf mit gruppiertem Rückgängig-/Wiederholen-Verlauf im
Arbeitsspeicher. Die visuelle Arbeitsfläche hat eine Bibliothek, mittiges
Lebensrad/Bereichszeilen und direkt bearbeitbare Eigenschaften. Diese ändern
den gemeinsamen Entwurf ohne Dialog oder zweites Speichern; erst Übernehmen
schreibt. Feste Achsenziele bleiben ohne Score erreichbar; mehrdeutiges Ablegen
eines Felds auf einer Achse braucht einen konkreten Zielbereich oder dessen
Anlegen. GET /api/configuration liefert
eine begrenzte bearbeitbare Ansicht mit Revision, Feldversionsmetadaten, Editoroptionen und abgeleiteten
Achsen-Löschfreigaben zum Schutz erhaltener ausgeschlossener Bereiche. Historische/ausgeschlossene Definitionen und andere
Laufzeiteinstellungen sind darüber nicht bearbeitbar.
POST /api/configuration prüft Sitzung, CSRF, Host/Origin, Konfigurationsrevision,
Änderungskennung und sämtliche Definitionen/Referenzen vor dem Schreiben.
Felder, Bereiche und Laufzeitgruppen/-achsen werden in einer verschlüsselten
Transaktion gespeichert; Revisionskonflikt, Validierungsablehnung oder
Transaktionsfehler ändern nichts. Änderungsbelege
bleiben in einer begrenzten Liste im Server-Arbeitsspeicher.
Der Server prüft neue stabile IDs und verwaltet Ersatz-IDs/Versionsmetadaten. Eine verlaufsrelevante
Definitionsänderung folgt field-model.js: Abgelöste Definitionen bleiben
unverändert; eine Ersatzversion behält die logische Identität. Dieselbe
Änderungskennung mit demselben Anfrage-Prüfwert wiederholt eine bereits
gespeicherte Änderung nicht. Der Browser ersetzt seinen Ausgangsstand erst mit
der bestätigten maßgeblichen Antwort. Die Handy-Aktualisierung lädt Felder,
Bereiche und Laufzeitkonfiguration neu; veraltete Konfigurationsentwürfe dürfen
gleichzeitige PC-Änderungen nicht überschreiben. Eine ohne Verlauf geplante
Definitionsänderung am Handy prüft zusätzlich, dass vor ihrer Speicherung kein
Wert hinzugekommen ist. Ein erster PC-Eintrag währenddessen löst einen Konflikt
aus und erhält den erfassten Wert samt Definition.
Entwurfsscores nutzen die lesende Analytics-Ansicht und dieselbe Score-Berechnung. Simulierte Versionen erhalten historische Typen, Wertebereiche, Ziele und Bereiche; die Gewichtung folgt dem aktuellen logischen Feld. Neue Bereichs-Achsenzuordnungen gelten auch für erhaltene Bereichshistorie. Browser-Datenbank, native Verschlüsselungs-/Schemaänderung, externe Provider-Anfrage oder allgemeiner Metadaten-Schreibzugang kommen nicht hinzu.
Schichten und Verantwortlichkeiten¶
| Schicht | Verantwortung | Beispiele |
|---|---|---|
| Views | Darstellung und Interaktion | TodayView, RecoveryView, AnalysisViews |
| App-Orchestrierung | Navigation, Zustand, Dialoge, Datenübergabe | App.jsx |
| Services | atomare Fachoperationen | tracking-service.js, Export-Service |
| Datenabstraktion | Lesen, Schreiben, Migration, Browser-/Android-Umschaltung | db.js |
| Native Grenze | SQLite, Keystore, Datenschutz, lokale KI | Capacitor-Plugins |
Warum ein generischer Record-Store?¶
Die native SQLite-Datenbank verwendet logisch getrennte Stores, speichert die eigentlichen Objekte aber als verschlüsselte JSON-Payloads. Das passt zur konfigurierbaren Feldstruktur: Neue Felder erfordern nicht automatisch eine neue SQL-Spalte.
Atomare Operationen¶
Ein Urge mit Rückfall kann gleichzeitig ein Ereignis und mehrere Counter-Resets erzeugen.
Diese Änderungen werden mit applyBatch in einer Transaktion geschrieben. Dadurch gibt es
keinen Zwischenzustand, in dem der Rückfall gespeichert, der Counter aber noch nicht
zurückgesetzt wurde.
Die nativen Managed-Device-Tests erzwingen Fehler nach bereits begonnenen Schreibvorgängen
für putMany, Store-Ersetzung, applyBatch, vollständigen Store-Import und
Klartextmigration. Danach müssen alle ursprünglichen Datensätze unverändert vorhanden sein.
Eine manipulierte Daten-Key-Hülle oder ein ersetzter Android-Keystore-Schlüssel wird
abgelehnt; Steady überschreibt dabei weder die vorhandene Hülle noch setzt es die Datenbank
automatisch zurück.
sequenceDiagram
participant UI as Urge-Dialog
participant S as tracking-service.js
participant DB as db.js / applyBatch
participant Store as events + resets
UI->>S: payload speichern
S->>S: Ereignis und Reset-Datensätze vorbereiten
S->>DB: eine Batch-Operation
DB->>Store: alles committen
Store-->>UI: Erfolg oder vollständiger Fehler