Secretary Journal (Android)

Android-Client für ein digitales Tagebuch/Journal auf dem secretary-server (CalDAV). Jeder Eintrag ist ein VJOURNAL-Komponent (RFC 5545 §3.6.3) in einer .ics-Datei unter einer Journal-Collection (/journal/main/, seit v129 eigener Namespace-Root; zuvor /calendars/journal-*/).

What it does

• A daily journal where every entry is a VJOURNAL component (RFC 5545 3.6.3) on your own server
• Track mood per entry, with the surrounding context that actually moves it: triggers, skills and habits
• Free text per entry, plus the entry date
• Offline first: entries live in a local JSON cache and edits queue up until the server is reachable again
• Shared offline sync engine with the other Secretary apps, so all of them behave the same way when the network drops
• Search and filter your entries

How to use

• Opens on the calendar/month view
• Shows entries by day
• Tap an entry to open/edit it
• Supports different entry types (text, mood, habit, skill, trigger, medicine, food/drink, excreta)
• Leave the editor via back without saving (changes saved only via "Speichern")
• Scroll to see all entries of a day

Screenshots

Entry types

Developer information

Every released version: Apps/journal/changelog

Verzeichnisstruktur

secretary-journal-android/
├── build.gradle.kts              # Root-Build
├── settings.gradle.kts
├── gradle.properties
├── CONTEXT.md
├── gradle/wrapper/
└── app/
    ├── build.gradle.kts
    ├── proguard-rules.pro
    └── src/main/
        ├── AndroidManifest.xml
        ├── res/values/
        │   ├── strings.xml                 # Englisch (Systemstandard)
        │   └── themes.xml
        ├── res/values-de/strings.xml       # Deutsch
        └── java/org/beowulf/secretary/journal/
            ├── SecretaryJournalApp.kt       # Application (Service-Locator)
            ├── MainActivity.kt              # Single-Activity
            ├── data/
            │   ├── JournalModels.kt         # JournalEntry, Mood
            │   ├── VJournal.kt              # RFC-5545-Parser/-Writer
            │   ├── JournalRepository.kt     # Config-Persistenz (zentrales Konto)
            │   └── AccountResolver.kt       # Zentrales Konto (ContentProvider)
            ├── vm/
            │   └── JournalViewModel.kt      # App-State
            └── ui/
                ├── Theme.kt                 # Material 3
                ├── LoginScreen.kt           # Server + Basic-Auth
                ├── JournalCalendarScreen.kt # Monatskalender
                ├── JournalEditScreen.kt     # Editor (Datum/Stimmung/Text)
                ├── SettingsScreen.kt        # Verbindung/Abmelden
                └── navigation/NavGraph.kt   # Routen: login, calendar, entry, settings

Die Sync-Engine (OfflineSyncEngine) und ihre Test-Suite liegen im gemeinsamen secretary-common-android (nicht im Journal) und werden von allen secretary-Apps genutzt.

Befehle

Voraussetzungen: JDK 21, Android-SDK (Platform 37, Build-Tools 34) und Gradle 9.x. Im Repository liegt bewusst kein Gradle-Wrapper -- entweder Android Studio nutzen (bringt sein Gradle mit) oder Gradle 9 selbst installieren; die Beispiele unten rufen deshalb gradle direkt.

export ANDROID_HOME="$HOME/Android/Sdk"   # bzw. sdk.dir=... in local.properties

gradle :journal:assembleDebug             # Debug-APK
gradle :common:testDebugUnitTest          # gemeinsame Engine (local/online/offline)
gradle :journal:compileDebugKotlin        # Kompilierung inkl. Engine-Wiring

Konzepte

• Journal: VJOURNAL-Einträge mit Datum, Stimmung (Mood) und Freitext in einer (journal--präfixten) Calendar-Collection auf dem secretary-server.
• Offline: Einträge liegen als JSON-Cache (filesDir/secretary_journal_cache.json) vor; Änderungen gehen bei fehlender Verbindung in eine Write-Behind-Queue und werden beim nächsten erfolgreichen loadCollections() abgespielt.
• Sync-Engine: loadEntriesInternal delegiert an die gemeinsame OfflineSyncEngine aus secretary-common-android (OfflineSyncEngine.kt), die alle secretary-Apps für den Offline-first-Load/Handoff nutzen. Das Journal bindet sie über Codec + GOfflineStore + CrudItemRemote, parametrisiert mit einem prepare-Lambda (Decrypt → Re-Encode → Encrypt, null überspringt nicht entschlüsselbare Einträge) und onDavError → logErr. Lokal-only-Einträge werden beim ersten Connect re-homed auf den Server-Ressourcenpfad und geladen; ein IOException beim Upload markiert sie für die Write-Behind-Queue, ein DavException (Server-Reject) lässt sie im Cache und meldet sie über onDavError; ein IOException beim Fetch ergibt Offline (Cache bleibt Quelle).
• Zentrales Konto: Zugangsdaten kommen aus dem gemeinsamen Android-Konto (AccountManager, Typ org.beowulf.secretary) mit lokalem SharedPreferences-Cache und Legacy-Fallback für die eigene Anmeldung.

Berechtigungen

• INTERNET – CalDAV-Zugriff
• GET_ACCOUNTS – zentrales Konto lesen (damit nicht von der Signer-Visibility-Provisionierung des Android-Kontos abhängig)
• org.beowulf.secretary.account.permission.READ_ACCOUNT (signature, legacy)

Server-Referenz

• secretary-server (CalDAV, Rust): ~/Projects/secretary-server/ (/calendars/, PROPFIND, REPORT calendar-query, PUT/DELETE, MKCALENDAR)