Zum Inhalt

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

Quellen