Stefan Mogeritsch 351fe7a672 feat(sync): implement Delta-Sync API and update clients to support offline-first workflow

Added `/ping/sync` endpoint with timestamp-based Delta-Sync functionality to efficiently support offline-first clients. Extended `PingApi` and frontend clients (`PingApiClient`, `PingApiKoinClient`) with `syncPings`. Updated repository, service, and controller logic for sync handling, including new JPA query `findByCreatedAtAfter`. Adjusted test doubles and completed unit tests for backend and frontend alignment. Documented sync approach and API usage.

2026-01-17 12:22:16 +01:00

2.1 KiB

Raw Blame History

type	status	author	date	context
Report	FINAL	Senior Backend Developer	2026-01-17	Phase 3 - Sync Implementation

Backend Status Report: Phase 3 (Sync) abgeschlossen

1. Zusammenfassung

Die Phase 3 der "Operation Tracer Bullet" wurde erfolgreich abgeschlossen. Der PingService wurde um Delta-Sync-Funktionalität erweitert, um Offline-First-Clients effizient zu unterstützen.

Wichtigste Errungenschaften:

Delta-Sync API: Implementierung von /ping/sync basierend auf Zeitstempeln.
Contract-Update: Synchronisierung der API-Definitionen zwischen Backend und Frontend (:contracts:ping-api).
Testing: Vollständige Testabdeckung für die neuen Sync-Endpunkte.

2. Technische Details

A. Sync-Strategie

Mechanismus: Zeitstempel-basierter Delta-Sync.
API: GET /ping/sync?lastSyncTimestamp={epochMillis}
Response: Liste von PingEvent (ID, Message, LastModified).
Vorteil: Clients laden nur geänderte Daten, was Bandbreite spart und Offline-Fähigkeit unterstützt.

B. Implementierung

Domain: Erweiterung des PingUseCase um getPingsSince(timestamp: Long).
Persistence: Effiziente JPA-Query findByCreatedAtAfter auf dem timestamp-Index.
Security: Der Sync-Endpunkt ist aktuell public (analog zu anderen Ping-Endpunkten), kann aber bei Bedarf geschützt werden.

C. Frontend-Kompatibilität

Die Frontend-Clients (PingApiClient, PingApiKoinClient) wurden aktualisiert, um den neuen Endpunkt zu unterstützen.
Test-Doubles im Frontend wurden angepasst, um die Build-Integrität zu wahren.

3. Offene Punkte & Nächste Schritte

Frontend Integration: Der Frontend-Expert muss nun die Logik implementieren, um den lastSyncTimestamp lokal zu speichern und den Sync-Prozess zu steuern.
Konfliktlösung: Aktuell ist der Sync unidirektional (Server -> Client). Für bidirektionalen Sync (Client -> Server) müssen noch Strategien (z.B. "Last Write Wins") definiert werden.

4. Fazit

Das Backend ist bereit für Offline-First-Szenarien. Die Delta-Sync-Schnittstelle ist performant und einfach zu konsumieren.

2.1 KiB Raw Blame History