weegschaal-app/docs/superpowers/plans/2026-07-25-sync-refactor-plan.md

Sync refactor — Implementation Plan ✅ (completed 2026-07-25)

Fix 6 sync bugs + herstel architectuur naar best-practice bidirectional timestamp sync.

Status: Alle 6 bugs gefixt. 15/15 tests passen. APK build + geinstalleerd.

Bug Overzicht

#	Bug	Oorzaak	Fix
1	Server deleted:true wordt genegeerd	mergeMeasurements mapt deleted niet naar deletedAt	Detecteer (r as any).deleted in merge, zet deletedAt = r.updatedAt
2	setDeletedAt update updatedAt niet	Alleen deletedAt wordt gezet, updatedAt blijft oud	Voeg updatedAt = ? toe aan de UPDATE
3	Pull-then-push double-push	Na upsert van remote records hebben die updatedAt > lastSyncAt → worden teruggestuurd	Skip in push-fase records die uit remote pull komen en waar remote.updatedAt ≥ local.updatedAt
4	Hard delete ondanks falende API	removeMeasurement() wordt ALTIJD aangeroepen, ook na catch	Alleen hard delete bij API-succes
5	syncStatus dead column	In schema, nooit gebruikt	Laat staan, geen impact
6	getAllMeasurements filtert deletedAt niet	UI-schermen moeten zelf filteren (.filter(m => !m.deletedAt))	Rename naar getAllMeasurementsForSync (ongefilterd), vervang UI-calls door getAllMeasurements met WHERE deletedAt IS NULL

Sync Protocol (vastgelegd)

lastSyncAt = SecureStore.getItem(LAST_SYNC_KEY)

── PULL ──
remote[] = GET /api/v1/measurements?since=lastSyncAt
local[]   = getAllMeasurementsForSync()   // ALLE records (incl. deleted)
remoteUpdatedMap: Map<id, updatedAt>      // track welke IDs + timestamps we binnenhaalden

for each r in remote:
  remoteUpdatedMap.set(r.id, r.updatedAt)
  if (r as any).deleted:
    r.deletedAt = r.updatedAt     // Bug 1 fix

── MERGE ──
remoteDeletedIds: Set<id>          // track welke remote records 'deleted' zijn

for each r in remote:
  if (r as any).deleted:
    remoteDeletedIds.add(r.id)

merged = mergeMeasurements(local, remote)

for each m in merged:
  remoteUA = remoteUpdatedMap.get(m.id)
  if remoteUA && new Date(remoteUA) >= new Date(m.updatedAt):
    // remote won de merge
    if remoteDeletedIds.has(m.id):
      removeMeasurement(m.id)     // hard-delete lokaal (server heeft 'm al)
    else:
      upsertMeasurement(m)        // remote gewijzigd, niet verwijderd
  else:
    upsertMeasurement(m)          // local won of nieuw → gewoon bewaren

── PUSH ──
cutoff = lastSyncAt ?? '1970-01-01T00:00:00.000Z'
localChanges[] = getMeasurementsUpdatedSince(cutoff)

for each m in localChanges:
  remoteUA = remoteUpdatedMap.get(m.id)
  if remoteUA && new Date(remoteUA) >= new Date(m.updatedAt):
    continue                    // remote won merge → niet terugpushen (Bug 3 fix)

  if m.deletedAt:
    DELETE /api/v1/measurements/:id
    if success:
      removeMeasurement(m.id)   // Bug 4 fix: alleen hard-delete bij API-succes
  else:
    POST /api/v1/measurements

SecureStore.setItem(LAST_SYNC_KEY, now())

Delete Protocol (vastgelegd)

Lokaal:  setDeletedAt(id) + updatedAt = now()   (Bug 2 fix)
Cache:   removeFromCache(id)
API:     DELETE /api/v1/measurements/:id
if success:
  Lokaal: removeMeasurement(id)                  (Bug 4 fix: alleen bij succes)
// bij falen: blijft met deletedAt in DB → syncAll pakt op

Files om te wijzigen

1. src/sync/syncService.ts — REWRITE syncAll + mergeMeasurements

Wijzigingen:

• mergeMeasurements: detecteer (r as any).deleted → zet deletedAt = r.updatedAt
• syncAll:
  • Track remoteUpdatedMap in pull-fase
  • Merge via bestaande mergeMeasurements
  • Push: skip records waar remote.updatedAt ≥ local.updatedAt (remote won)
  • Alleen removeMeasurement na succesvolle API DELETE
• Exporteer cleanupDeletedRecord(id) voor gebruik door screens (DRY)

2. src/database/db.ts — setDeletedAt fix + query filters

Wijzigingen:

• setDeletedAt(id): voeg updatedAt = ? toe aan SQL
• getAllMeasurements(): voeg WHERE deletedAt IS NULL toe
• getLatestMeasurement(): voeg WHERE deletedAt IS NULL toe
• Nieuw: getAllMeasurementsForSync() — ongefilterd (voor syncService)
• Verwijder: deleteMeasurement() (dode code, duplicate van removeMeasurement)

3. src/screens/HistoryScreen.tsx — delete fix

Wijzigingen:

• confirmDelete: alleen removeMeasurement() na API-succes
• load: gebruik getMeasurementsSince('1970-01-01') i.p.v. getAllMeasurements() (of de nieuwe getAllMeasurements die filtert)

4. src/screens/MeasurementDetailScreen.tsx — delete fix

Wijzigingen:

• handleDelete: alleen removeMeasurement() na API-succes

5. src/store/measurementStore.ts — geen wijzigingen nodig

De store gebruikt getLatestMeasurements(count) en getMeasurementsSince(date) die al filteren. /loadFromDb gebruikt getAllMeasurements() → die gaat nu ook filteren. ✓

6. tests/syncService.test.ts — nieuwe test cases

Wijzigingen:

• Test: deleted van server wordt correct naar deletedAt gemapt
• Test: syncAll push skips remote-won records
• Test: syncAll push stuurt local-won records wel

7. tests/database.test.ts — update voor nieuwe functies

Wijzigingen:

• Test setDeletedAt update ook updatedAt
• Test getAllMeasurementsForSync returned deleted records

Uitvoeringsvolgorde

1. db.ts — setDeletedAt fix + query filters
2. syncService.ts — merge fix + syncAll refactor
3. HistoryScreen.tsx + MeasurementDetailScreen.tsx — delete fix
4. Tests updaten + TypeScript check + npm test
5. Build APK, testen