feat(sync): Implement comprehensive sync fixes and optimizations as of February 8, 2026

- Fixed initial sync logic to respect actual timestamps, preventing unwanted overwrites.
- Introduced exponential backoff for retry logic, with auto-reset for permanently failed entities.
- Added validation checks to ensure data consistency during sync processes.
- Corrected hash calculation to only include sync-relevant communications.
- Resolved issues with empty slots ignoring user inputs and improved conflict handling.
- Enhanced handling of Var4 and Var6 entries during sync conflicts.
- Documented changes and added new fields required in EspoCRM for improved sync management.

Also added a detailed analysis of syncStatus values in EspoCRM CBeteiligte, outlining responsibilities and ensuring robust sync mechanisms.

bitbylaw/docs/archive/README.md

@@ -0,0 +1,80 @@
+# Archiv - Historische Analysen & Detail-Dokumentationen
+
+Dieser Ordner enthält **historische** Dokumentationen, die während der Entwicklung der Sync-Funktionalität erstellt wurden.
+
+## ⚠️ Hinweis
+
+**Für die aktuelle, konsolidierte Dokumentation siehe**: [../SYNC_OVERVIEW.md](../SYNC_OVERVIEW.md)
+
+Die Dateien hier sind historisch wertvoll, aber **nicht mehr aktiv gepflegt**.
+
+---
+
+## Enthaltene Dateien
+
+### Original API-Analysen
+- **`KOMMUNIKATION_SYNC_ANALYSE.md`** (78K) - Umfassende API-Tests
+  - POST/PUT/DELETE Endpunkt-Tests
+  - kommKz-Enum Analyse (Telefon, Email, Fax)
+  - Entdeckung des kommKz=0 Bugs in GET
+  - Entwicklung der Marker-Strategie
+  
+- **`ADRESSEN_SYNC_ANALYSE.md`** (51K) - Detaillierte Adressen-Analyse
+  - API-Limitierungen (DELETE 403, PUT nur 4 Felder)
+  - Read-only vs. read/write Felder
+  - reihenfolgeIndex Stabilitäts-Tests
+  
+- **`ADRESSEN_SYNC_SUMMARY.md`** (7.6K) - Executive Summary der Adressen-Analyse
+
+### Detail-Dokumentationen (vor Konsolidierung)
+- **`BETEILIGTE_SYNC.md`** (16K) - Stammdaten-Sync Details
+  - Superseded by SYNC_OVERVIEW.md
+  
+- **`KOMMUNIKATION_SYNC.md`** (18K) - Kommunikation-Sync Details
+  - Superseded by SYNC_OVERVIEW.md
+  
+- **`SYNC_STATUS_ANALYSIS.md`** (13K) - Status-Design Analyse
+  - Superseded by SYNC_OVERVIEW.md
+  
+- **`ADVOWARE_BETEILIGTE_FIELDS.md`** (5.3K) - Field-Mapping Tests
+  - Funktionierende vs. ignorierte Felder
+
+### Code-Reviews & Bug-Analysen
+- **`SYNC_CODE_ANALYSIS.md`** (9.5K) - Comprehensive Code Review
+  - 32-Szenarien-Matrix
+  - Performance-Analyse
+  - Code-Qualität Bewertung
+  
+- **`SYNC_FIXES_2026-02-08.md`** (18K) - Fix-Log vom 8. Februar 2026
+  - BUG-3 (Initial Sync Duplikate)
+  - Performance-Optimierungen (doppelte API-Calls)
+  - Lock-Release Improvements
+
+---
+
+## Zweck des Archivs
+
+Diese Dateien dokumentieren:
+- ✅ Forschungs- und Entwicklungsprozess
+- ✅ Iterative Strategie-Entwicklung
+- ✅ API-Testprotokolle
+- ✅ Fehlgeschlagene Ansätze
+- ✅ Detaillierte Bug-Analysen
+
+**Nutzung**: Referenzierbar bei Fragen zur Entstehungsgeschichte bestimmter Design-Entscheidungen.
+
+---
+
+## Migration zur konsolidierten Dokumentation
+
+**Datum**: 8. Februar 2026
+
+Alle wichtigen Informationen aus diesen Dateien wurden in [SYNC_OVERVIEW.md](../SYNC_OVERVIEW.md) konsolidiert:
+- ✅ Funktionsweise aller Sync-Komponenten
+- ✅ Alle bekannten Einschränkungen dokumentiert
+- ✅ Alle Workarounds beschrieben
+- ✅ Troubleshooting Guide
+- ❌ Keine Code-Reviews (gehören nicht in User-Dokumentation)
+- ❌ Keine veralteten Bug-Analysen (alle Bugs sind gefixt)
+
+**Vorteil**: Eine zentrale, aktuelle Dokumentation statt 12 verstreuter Dateien.