bollwerkadmin/bollwerk
1
0
Fork 0
Code Issues 12 Pull requests Projects Releases Packages Wiki Activity Actions

User-Konzept (Teil 2): Offline-Queue, Sofort-Sync & Last-Write-Wins #61

New issue
Closed
opened 2026-05-16 18:21:03 +00:00 by jreinemann-euris · 1 comment
jreinemann-euris commented 2026-05-16 18:21:03 +00:00 (Migrated from github.com)
Copy link

Kontext

Folge-Ticket zu #57 (Server + App-Phase). Die Kern-Auth (JWT, Login, WebSocket-Client) ist fertig. Dieser Restaufwand vervollständigt das User-Konzept um robuste Offline-Fähigkeit und konfliktfreie Synchronisierung.

Akzeptanzkriterien

1. Offline-Queue (pending_sync_ops)

  • Room-Entity \PendingSyncOpEntity: \id, \itemId, \operation\ (PATCH/DELETE), \payload\ (JSON), \createdAt\
  • DAO + Migration (DB-Version bump)
  • ItemRepository: Bei Änderung → sofortiger PATCH-Versuch; bei Fehler (offline/server nicht erreichbar) → Op in Queue einreihen
  • Nach WebSocket-Reconnect (Connected-Event) → Queue automatisch abarbeiten

2. Sofort-Sync bei lokalen Änderungen

  • \SyncService.patchItem(itemId, item)\ → \PATCH /api/inventory/items/{id}\
  • ItemRepository löst bei \insert/\update/\delete\ automatisch Sync-Versuch aus (wenn Server-URL + Token vorhanden)
  • Fehler-Handling: Netzwerkfehler → Queue, Auth-Fehler → Silent (Token-Refresh wird separat gehandelt)

3. Last-Write-Wins beim Pull-Sync

  • \pullSync()\ vergleicht \lastUpdated-Timestamps pro Item
  • Nur Items übernehmen, bei denen der Server-Timestamp neuer ist als der lokale
  • Lokale Änderungen werden nicht überschrieben, wenn sie neuer sind

Technische Hinweise

  • PATCH-Endpoint ist serverseitig bereits implementiert (\PATCH /api/inventory/items/{id})
  • WebSocket-Events (\inventoryUpdated, \ ullSyncRequired) sind serverseitig vorhanden
  • \WebSocketEvent.Connected\ im \WebSocketClient\ kann als Trigger für Queue-Verarbeitung genutzt werden
  • Room \ allbackToDestructiveMigration()\ ist aktiv (keine Produktivdaten)
## Kontext Folge-Ticket zu #57 (Server + App-Phase). Die Kern-Auth (JWT, Login, WebSocket-Client) ist fertig. Dieser Restaufwand vervollständigt das User-Konzept um robuste Offline-Fähigkeit und konfliktfreie Synchronisierung. ## Akzeptanzkriterien ### 1. Offline-Queue (pending_sync_ops) - [ ] Room-Entity \PendingSyncOpEntity\: \id\, \itemId\, \operation\ (PATCH/DELETE), \payload\ (JSON), \createdAt\ - [ ] DAO + Migration (DB-Version bump) - [ ] ItemRepository: Bei Änderung → sofortiger PATCH-Versuch; bei Fehler (offline/server nicht erreichbar) → Op in Queue einreihen - [ ] Nach WebSocket-Reconnect (Connected-Event) → Queue automatisch abarbeiten ### 2. Sofort-Sync bei lokalen Änderungen - [ ] \SyncService.patchItem(itemId, item)\ → \PATCH /api/inventory/items/{id}\ - [ ] ItemRepository löst bei \insert\/\update\/\delete\ automatisch Sync-Versuch aus (wenn Server-URL + Token vorhanden) - [ ] Fehler-Handling: Netzwerkfehler → Queue, Auth-Fehler → Silent (Token-Refresh wird separat gehandelt) ### 3. Last-Write-Wins beim Pull-Sync - [ ] \pullSync()\ vergleicht \lastUpdated\-Timestamps pro Item - [ ] Nur Items übernehmen, bei denen der Server-Timestamp neuer ist als der lokale - [ ] Lokale Änderungen werden nicht überschrieben, wenn sie neuer sind ## Technische Hinweise - PATCH-Endpoint ist serverseitig bereits implementiert (\PATCH /api/inventory/items/{id}\) - WebSocket-Events (\inventoryUpdated\, \ ullSyncRequired\) sind serverseitig vorhanden - \WebSocketEvent.Connected\ im \WebSocketClient\ kann als Trigger für Queue-Verarbeitung genutzt werden - Room \ allbackToDestructiveMigration()\ ist aktiv (keine Produktivdaten)
jreinemann-euris commented 2026-05-16 19:40:27 +00:00 (Migrated from github.com)
Copy link

Abgeschlossen (2026-05-16)

Zyklen: 2 (1 Implementierung + 1 Review-Korrektur)
Tests: ✅ 223 Tests, 0 Fehler

Implementierte Artefakte

  • ✅ PendingSyncOpEntity + PendingSyncOpDao: Room-Queue für PATCH/DELETE-Ops
  • ✅ MIGRATION_2_3: Tabelle \pending_sync_ops\ (DB-Version 2→3)
  • ✅ SyncService.patchItem() + deleteItem(): PATCH/DELETE gegen Server-API
  • ✅ ItemRepositoryImpl: Sofort-Sync fire-and-forget nach insert/update/delete; bei Netzwerkfehler → Queue, AuthError/NotConfigured → silent
  • ✅ drainQueue() bei WebSocketEvent.Connected: Queue abarbeiten, korrupte Ops löschen
  • ✅ ImportExportRepositoryImpl.applyInventoryDto(): Last-Write-Wins per lastUpdated-Timestamp
  • ✅ KrisenvorratDatabaseMigrationTest: V2→V3-Test ergänzt

Abweichungen

  • Keine
## Abgeschlossen (2026-05-16) **Zyklen:** 2 (1 Implementierung + 1 Review-Korrektur) **Tests:** ✅ 223 Tests, 0 Fehler ### Implementierte Artefakte - ✅ PendingSyncOpEntity + PendingSyncOpDao: Room-Queue für PATCH/DELETE-Ops - ✅ MIGRATION_2_3: Tabelle \pending_sync_ops\ (DB-Version 2→3) - ✅ SyncService.patchItem() + deleteItem(): PATCH/DELETE gegen Server-API - ✅ ItemRepositoryImpl: Sofort-Sync fire-and-forget nach insert/update/delete; bei Netzwerkfehler → Queue, AuthError/NotConfigured → silent - ✅ drainQueue() bei WebSocketEvent.Connected: Queue abarbeiten, korrupte Ops löschen - ✅ ImportExportRepositoryImpl.applyInventoryDto(): Last-Write-Wins per lastUpdated-Timestamp - ✅ KrisenvorratDatabaseMigrationTest: V2→V3-Test ergänzt ### Abweichungen - Keine
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
block-planning

   
bug

Something isn't working

  
documentation

Improvements or additions to documentation

  
duplicate

This issue or pull request already exists

  
enhancement

New feature or request

  
feature

   
good first issue

Good for newcomers

  
help wanted

Extra attention is needed

  
infrastructure

   
invalid

This doesn't seem right

  
planning

   
priority:high

   
priority:low

   
question

Further information is requested

  
refactoring

   
status:backlog

Im Backlog

  
status:done

Abgeschlossen

  
status:in-progress

Aktuell in Bearbeitung

  
status:todo

Naechstes Todo-Ticket

  
tech-decision

   
test

   
wontfix

This will not be worked on

No labels
block-planning
bug
documentation
duplicate
enhancement
feature
good first issue
help wanted
infrastructure
invalid
planning
priority:high
priority:low
question
refactoring
status:backlog
status:done
status:in-progress
status:todo
tech-decision
test
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: bollwerkadmin/bollwerk#61
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?