Fix Advoware timestamp parsing bug causing sync loops

- Change .replace(tzinfo=BERLIN_TZ) to BERLIN_TZ.localize() for correct pytz TZ handling
- Update Phase 4 to use proper TZ localization for adv_ts
- Add documentation section on correct Advoware timestamp handling
- Add .gitignore, GOOGLE_SETUP_README.md, and check_db.py utility

bitbylaw/steps/advoware_cal_sync/README.md

@@ -256,5 +256,33 @@ Cron-Step für regelmäßige Ausführung.
 - Timestamps: Fehlende in Google können zu Fallback führen.
 - Performance: Bei vielen Terminen könnte Paginierung helfen.
 
+## Korrekter Umgang mit Advoware-Timestamps
+
+### Problemstellung
+Advoware-Timestamps (z.B. `'zuletztGeaendertAm'`) werden in Berlin-Zeit geliefert, aber das Parsing mit `datetime.datetime.fromisoformat(...).replace(tzinfo=BERLIN_TZ)` führte zu falschen Offsets (z.B. 53 Minuten Unterschied), da `replace(tzinfo=...)` auf naive datetime nicht korrekt mit pytz-TZ-Objekten funktioniert. Dies verursachte Endlosschleifen in Phase 4, da `adv_ts` falsch hochgesetzt wurde.
+
+### Lösung
+Verwende `BERLIN_TZ.localize(naive_datetime)` statt `.replace(tzinfo=BERLIN_TZ)`:
+- `localize()` setzt die TZ korrekt auf pytz-TZ-Objekte.
+- Beispiel:
+  ```python
+  naive = datetime.datetime.fromisoformat('2025-10-23T14:18:36.245')
+  adv_ts = BERLIN_TZ.localize(naive)  # Ergebnis: 2025-10-23 14:18:36.245+02:00
+  ```
+- Dies stellt sicher, dass Timestamps korrekt in UTC konvertiert werden (z.B. 12:18 UTC) und Vergleiche in Phase 4 funktionieren.
+
+### Implementierung
+- In `calendar_sync_event_step.py`, Phase 4:
+  ```python
+  adv_ts = BERLIN_TZ.localize(datetime.datetime.fromisoformat(adv_data['zuletztGeaendertAm']))
+  ```
+- Für Google-Timestamps: `.astimezone(BERLIN_TZ)` bleibt korrekt.
+- Alle Timestamps werden zu UTC normalisiert für DB-Speicherung und Vergleiche.
+
+### Vermeidung von Fehlern
+- Niemals `.replace(tzinfo=pytz_tz)` verwenden – immer `tz.localize(naive)`.
+- Teste Parsing: `BERLIN_TZ.localize(datetime.datetime.fromisoformat(ts)).astimezone(pytz.utc)` sollte korrekte UTC ergeben.
+- Bei anderen TZ: Gleiche Regel anwenden.
+
 ## Erweiterungen