diff --git a/TODO.md b/TODO.md index 0502298..28c0a66 100644 --- a/TODO.md +++ b/TODO.md @@ -1766,6 +1766,42 @@ CSV-Exports der Auswertung (6.3.3) über die gemeinsame Export-Infrastruktur aus nur tatsächlich erfasste `TimeEntry`-Zeilen auswertet, keine `WorkTask`-Metadaten. In der Aufgabenliste und im Dashboard-Widget "Offene Aufgaben" durch ein 🔔-Symbol gekennzeichnet. +- [ ] **6.1.7** TickTick-Sync für Erinnerungen (Nutzerwunsch): Der Nutzer pflegt Erinnerungen + privat bereits in TickTick (Handy-App, eingespielte Routine dort). Ziel: ausgewählte + `WorkTask`s (zunächst `TaskKind.Reminder`, 6.1.6) bidirektional mit einer TickTick-Liste + abgleichen, damit Fälligkeiten auf dem Handy ankommen und dort abgehakte Erinnerungen auch + in LehrerApp als erledigt gelten. Rechercheergebnis zur TickTick Open API + (developer.ticktick.com/docs#/openapi, Stand 2026-08-24) unten festgehalten, damit das nicht + erneut nachgeschlagen werden muss. + - **Auth:** Kein OAuth2-Redirect-Flow nötig — für den Eigengebrauch (ein Nutzer, ein Gerät) + reicht ein persönliches API-Token (TickTick-Web: Avatar → Settings → Account → API Token), + gesendet als `Authorization: Bearer `. Ein neues Einstellungsfeld "TickTick API + Token" genügt, analog zur bereits pro Gerät hinterlegten WebUntis-URL — kein lokaler + Redirect-Listener, keine Client-ID/Secret-Registrierung. + - **Push (LehrerApp → TickTick):** `POST /open/v1/task` (einzeln) bzw. + `POST /open/v1/task/batch` (bis 50 Creates/Updates in einem Call) beim Anlegen/Ändern einer + passenden `WorkTask`. Erledigt-Setzen auf TickTick-Seite über + `POST /open/v1/project/{projectId}/task/{taskId}/complete` bzw. gebündelt + `POST /open/v1/task/completeTasks` (bis 50 Task-IDs). + - **Pull erledigt (TickTick → LehrerApp):** `POST /open/v1/task/completed`, gefiltert nach + `projectIds` + Zeitfenster (`completedTime`-Range) — liefert bis zu 200 im Poll-Intervall + erledigte Tasks der Zielliste in einem Call, kein Abklappern einzelner Task-IDs nötig. + - **Pull neu (TickTick → LehrerApp):** `POST /open/v1/task/filter` (Filter nach `projectIds` + + `status`, bis 200 Treffer) oder `GET /open/v1/project/{projectId}/data` (Projekt + aktive + Tasks + Columns in einem Call) auf die Zielliste pollen, Ergebnis gegen die lokal + gespeicherten Fremd-IDs diffen — neue IDs werden als `WorkTask` angelegt. + - **Architektur-Vorbild:** gleiches Muster wie der bestehende WebUntis-Abgleich — + framework-freie Diff-Logik nach `LehrerApp.Core/Services/` (analog `UntisDiffService`), + HTTP-Aufruf + Timer-Orchestrierung in `LehrerApp.Desktop/Services/` (analog + `UntisSyncService`). Zuordnung TickTick-Task-ID ↔ `WorkTask` über ein neues + `WorkTask.ExternalId`-Feld, idempotent wie `SubstitutionEntry.ExternalId` + (`GetByExternalId`, Update statt Duplikat). + - **Offen:** kein Webhook-Support in der API bekannt — nur Polling. Rate-Limits sind in der + Doku nicht dokumentiert, vor Produktivbetrieb mit kurzem Poll-Intervall (< 5 Min.) prüfen. + Vorher klären: welche `WorkTask`-Teilmenge synct (nur `Reminder` oder auch `WorkItem`?), + welche TickTick-Liste ist die Zielliste (fest in den Einstellungen hinterlegt, analog zur + WebUntis-URL)? + **Nachtrag — Pädagogische Klassen-Aufgaben (Nutzer-Feedback):** Wunsch nach einer zweiten, "weniger arbeitszeitrelevant als pädagogisch" gedachten Art von Todo-Item (Beispiele: "Ansage an die Klasse", "Etwas zum Stichtag einsammeln/austeilen"), gleichberechtigt im