Release v0.0.0.26

Outlook->Starface macht das Starface-Adressbuch zur exakten Kopie von
Outlook: Kontakte, die nur in Starface existieren, werden geloescht.
Starface->Outlook entsprechend umgekehrt (Phase 4).

Sicherheit:
- Loeschphase laeuft nur bei vollstaendig geladener Liste (unvollstaendige
  Ladevorgaenge brechen schon vorher ab).
- Ist die Quelle komplett leer (z.B. falscher Ordner), wird die Loeschphase
  uebersprungen statt die Zielseite zu leeren.

UI: Profil-Editor zeigt jetzt unter der Sync-Richtung einen Warnhinweis, der
das jeweilige Verhalten erklaert. README/CHANGELOG aktualisiert.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

CHANGELOG.md

@@ -16,9 +16,13 @@ Versionsschema ist `x.x.x.x` (siehe `release.sh`).
     "geloescht" ansehen, ihr Mapping verwerfen und sie beim naechsten Lauf neu
     anlegen. Der Kontakt-Abruf bricht jetzt mit Fehlermeldung ab (inkl.
     Wiederholversuch), statt still mit einer Teil-Liste weiterzuarbeiten.
-  - Ist ein Starface-Kontakt nicht in der geladenen Liste (z.B. anderes
-    Adressbuch), wird das Mapping jetzt **behalten** statt verworfen und neu
-    angelegt.
+  - Ist ein Starface-Kontakt nicht in der geladenen Liste, wird er jetzt per
+    ID direkt abgefragt: existiert er noch (liegt also in einem **anderen
+    Adressbuch**), bleibt das Mapping erhalten und es wird nichts neu angelegt
+    (keine Dublette). Ist er **wirklich geloescht** (404), wird er je nach
+    Sync-Richtung in Starface neu angelegt bzw. die Loeschung nach Outlook
+    gespiegelt. (Vorher wurde das Mapping faelschlich behalten und der Kontakt
+    in Outlook->Starface gar nicht neu angelegt.)
   - Das Wiederzuordnen bestehender Kontakte war zu streng: eine von Starface
     umformatierte Telefonnummer konnte einen eindeutigen E-Mail- oder
     Namens-Treffer ueberstimmen und so eine Neuanlage statt Verknuepfung
@@ -34,6 +38,20 @@ Versionsschema ist `x.x.x.x` (siehe `release.sh`).
 
 ### Geaendert
 
+- **Ein-Richtungs-Modi sind jetzt echtes "Ersetzen".** Outlook->Starface macht
+  das Starface-Adressbuch zu einer exakten Kopie von Outlook: Kontakte, die nur
+  in Starface existieren (kein Pendant in Outlook), werden geloescht.
+  Starface->Outlook entsprechend umgekehrt. Schutz: Ist die Quelle komplett
+  leer (z.B. falscher Ordner gewaehlt), wird die Loeschphase uebersprungen
+  statt die Zielseite zu leeren. Mass-Loeschungen finden nur bei vollstaendig
+  geladener Liste statt (unvollstaendige Ladevorgaenge brechen vorher ab).
+- **Bidirektionale Loeschungen** werden jetzt erkannt. Wird ein Kontakt auf
+  einer Seite geloescht und ist die andere Seite seit dem letzten Sync
+  unveraendert (Abgleich ueber die gespeicherte Baseline), wird die Loeschung
+  auf die andere Seite gespiegelt – statt den Kontakt wieder anzulegen. Wurde
+  die andere Seite zwischenzeitlich bearbeitet, gewinnt die Bearbeitung und der
+  Kontakt wird neu angelegt (kein Datenverlust). In den Ein-Richtungs-Modi
+  bleibt die jeweilige Quelle fuehrend (Loeschung im Ziel wird wiederhergestellt).
 - Starface-Kontaktdetails werden beim Laden parallel abgerufen (8 gleichzeitig)
   statt einzeln nacheinander – deutlich schneller bei grossen Adressbuechern.
 - `UpdateContact` (Outlook) und `UpdateContactAsync` (Starface) geben jetzt den

README.md

@@ -8,7 +8,10 @@ Windows-Anwendung zur bidirektionalen Synchronisation von Kontakten zwischen Mic
 - **Profil-System** zum Verwalten mehrerer Sync-Konfigurationen (verschiedene Adressbuecher oder Anlagen)
 - **Starface-Adressbuecher**: Zentrales Adressbuch, persoenliches Adressbuch und Tag-basierte Adressbuecher
 - **Outlook-Kontaktordner**: Frei waehlbarer Kontaktordner als Sync-Ziel
-- **Sync-Richtung** konfigurierbar: Outlook -> Starface, Starface -> Outlook oder bidirektional
+- **Sync-Richtung** konfigurierbar:
+  - *Bidirektional*: Aenderungen werden in beide Richtungen abgeglichen (inkl. Loeschungen)
+  - *Outlook -> Starface*: Das Starface-Adressbuch wird zur exakten Kopie von Outlook (nur in Starface vorhandene Kontakte werden geloescht)
+  - *Starface -> Outlook*: Der Outlook-Ordner wird zur exakten Kopie von Starface (nur in Outlook vorhandene Kontakte werden geloescht)
 - **Intelligentes Matching**: Kontakte werden anhand von E-Mail-Adresse oder Name abgeglichen
 - **Aenderungserkennung**: Nur geaenderte Kontakte werden uebertragen (Hash-basiert)
 - **Auto-Sync**: Optionaler automatischer Sync in konfigurierbarem Intervall

installer/setup.iss

@@ -2,7 +2,7 @@
 ; Erfordert Inno Setup 6.x (https://jrsoftware.org/isinfo.php)
 
 #define MyAppName "Starface Outlook Sync"
-#define MyAppVersion "0.0.0.24"
+#define MyAppVersion "0.0.0.26"
 #define MyAppPublisher "HackerSoft - Hacker-Net Telekommunikation"
 #define MyAppURL "https://www.hacker-net.de"
 #define MyAppExeName "StarfaceOutlookSync.exe"

src/StarfaceOutlookSync/Services/SyncEngine.cs

@@ -163,32 +163,107 @@ namespace StarfaceOutlookSync.Services
                                 continue;
                             }
 
-                            // Wirklich geloescht -> in Starface auch loeschen
-                            if (profile.SyncDirection == SyncDirection.Both || profile.SyncDirection == SyncDirection.OutlookToStarface)
+                            // Wirklich in Outlook geloescht.
+                            if (profile.SyncDirection == SyncDirection.OutlookToStarface)
                             {
+                                // Outlook ist fuehrend -> Loeschung nach Starface spiegeln.
                                 if (await starface.DeleteContactAsync(mapping.StarfaceId))
                                 {
                                     result.Updated++;
                                     Log($"  Geloescht (OL->SF): {sc.DisplayName}");
                                 }
+                                continue;
                             }
-                            else
+
+                            if (profile.SyncDirection == SyncDirection.Both)
                             {
-                                newMappings.Add(mapping);
+                                // Bidirektional: anhand der Baseline pruefen, ob die
+                                // Starface-Seite seit dem letzten Sync unveraendert ist.
+                                bool sfUnchanged = !string.IsNullOrEmpty(mapping.LastStarfaceHash)
+                                                   && sc.GetHash() == mapping.LastStarfaceHash;
+                                if (sfUnchanged)
+                                {
+                                    // Unveraendert + in Outlook geloescht -> Loeschung gilt
+                                    // -> auch aus Starface entfernen.
+                                    if (await starface.DeleteContactAsync(mapping.StarfaceId))
+                                    {
+                                        result.Updated++;
+                                        Log($"  Geloescht (OL->SF): {sc.DisplayName}");
+                                    }
+                                    continue;
+                                }
+                                // In Outlook geloescht, aber in Starface geaendert ->
+                                // Bearbeitung gewinnt, in Outlook neu anlegen (Phase 3).
+                                Log($"  In Outlook geloescht, in Starface geaendert -> neu anlegen: {sc.DisplayName}");
+                                processedStarfaceIds.Remove(sc.StarfaceId);
+                                continue;
                             }
+
+                            // StarfaceToOutlook: Starface ist alleinige Quelle -> in Outlook
+                            // neu anlegen (Loeschung im Ziel zaehlt nicht).
+                            Log($"  Outlook-Kontakt geloescht, wird neu angelegt: {sc.DisplayName}");
+                            processedStarfaceIds.Remove(sc.StarfaceId);
                             continue;
                         }
 
                         if (oc != null && sc == null)
                         {
-                            // Starface-Kontakt nicht in der geladenen Liste.
-                            // Da unvollstaendige Ladevorgaenge inzwischen abgebrochen
-                            // werden (siehe StarfaceApiClient), liegt das hoechstens an
-                            // einem anderen Adressbuch. NICHT loeschen und NICHT neu
-                            // anlegen - sonst entstehen Dubletten. Mapping behalten,
-                            // beim naechsten Sync wird es erneut abgeglichen.
-                            Log($"  Starface-Kontakt nicht in Liste (anderes Adressbuch?), behalte Mapping: {oc.DisplayName}");
-                            newMappings.Add(mapping);
+                            // Starface-Kontakt nicht in der geladenen Liste. Zwei Faelle
+                            // unterscheiden, indem wir ihn per ID direkt abfragen:
+                            //  (a) per ID noch vorhanden -> liegt in einem ANDEREN
+                            //      Adressbuch -> Mapping behalten, NICHT neu anlegen
+                            //      (sonst Dublette).
+                            //  (b) per ID 404 -> in Starface WIRKLICH geloescht.
+                            bool stillExists = !string.IsNullOrEmpty(mapping.StarfaceId)
+                                && await starface.GetContactAsync(mapping.StarfaceId) != null;
+
+                            if (stillExists)
+                            {
+                                Log($"  Starface-Kontakt in anderem Adressbuch, behalte Mapping: {oc.DisplayName}");
+                                newMappings.Add(mapping);
+                                continue;
+                            }
+
+                            // Wirklich in Starface geloescht.
+                            if (profile.SyncDirection == SyncDirection.StarfaceToOutlook)
+                            {
+                                // Starface ist fuehrend -> Loeschung nach Outlook spiegeln.
+                                if (_outlookService.DeleteContact(oc.OutlookEntryId))
+                                {
+                                    result.Updated++;
+                                    Log($"  Geloescht (SF->OL): {oc.DisplayName}");
+                                }
+                                continue;
+                            }
+
+                            if (profile.SyncDirection == SyncDirection.Both)
+                            {
+                                // Bidirektional: anhand der Baseline entscheiden, ob der
+                                // Outlook-Kontakt seit dem letzten Sync unveraendert ist.
+                                bool olUnchanged = !string.IsNullOrEmpty(mapping.LastOutlookHash)
+                                                   && oc.GetHash() == mapping.LastOutlookHash;
+                                if (olUnchanged)
+                                {
+                                    // Unveraendert + in Starface geloescht -> Loeschung gilt
+                                    // -> aus Outlook entfernen.
+                                    if (_outlookService.DeleteContact(oc.OutlookEntryId))
+                                    {
+                                        result.Updated++;
+                                        Log($"  Geloescht (SF->OL): {oc.DisplayName}");
+                                    }
+                                    continue;
+                                }
+                                // In Starface geloescht, aber in Outlook geaendert ->
+                                // Bearbeitung gewinnt, in Starface neu anlegen.
+                                Log($"  In Starface geloescht, in Outlook geaendert -> neu anlegen: {oc.DisplayName}");
+                                processedOutlookIds.Remove(oc.OutlookEntryId);
+                                continue;
+                            }
+
+                            // OutlookToStarface: Outlook ist alleinige Quelle -> Kontakt
+                            // in Starface neu anlegen (Loeschung im Ziel zaehlt nicht).
+                            Log($"  Starface-Kontakt geloescht, wird neu angelegt: {oc.DisplayName}");
+                            processedOutlookIds.Remove(oc.OutlookEntryId);
                             continue;
                         }
 
@@ -419,6 +494,77 @@ namespace StarfaceOutlookSync.Services
                         }
                     }
 
+                    // ============================================
+                    // Phase 4: Ersetzen-Modus - Zielseite an Quelle angleichen
+                    // ============================================
+                    // In den Ein-Richtungs-Modi soll die Zielseite eine exakte Kopie
+                    // der Quelle werden. Kontakte, die nur auf der Zielseite existieren
+                    // (kein Mapping, kein Treffer in der Quelle), werden geloescht.
+                    // Sicher, weil unvollstaendige Ladevorgaenge vorher abbrechen.
+                    if (profile.SyncDirection == SyncDirection.OutlookToStarface)
+                    {
+                        // Schutz gegen versehentliches Leerraeumen (z.B. falscher Ordner).
+                        if (outlookContacts.Count == 0)
+                        {
+                            Log("Ersetzen-Modus uebersprungen: Outlook-Ordner ist leer (Schutz vor versehentlichem Leeren).");
+                        }
+                        else
+                        {
+                            var leftover = starfaceContacts
+                                .Where(c => !string.IsNullOrEmpty(c.StarfaceId) && !processedStarfaceIds.Contains(c.StarfaceId))
+                                .ToList();
+                            if (leftover.Count > 0)
+                                Log($"Ersetzen-Modus: entferne {leftover.Count} Kontakt(e) aus Starface, die nicht in Outlook existieren");
+                            foreach (var sc in leftover)
+                            {
+                                try
+                                {
+                                    if (await starface.DeleteContactAsync(sc.StarfaceId))
+                                    {
+                                        result.Updated++;
+                                        Log($"  Geloescht (nur in Starface): {sc.DisplayName}");
+                                    }
+                                }
+                                catch (Exception ex)
+                                {
+                                    result.Errors++;
+                                    result.ErrorMessages.Add($"Loeschen SF {sc.DisplayName}: {ex.Message}");
+                                }
+                            }
+                        }
+                    }
+                    else if (profile.SyncDirection == SyncDirection.StarfaceToOutlook)
+                    {
+                        if (starfaceContacts.Count == 0)
+                        {
+                            Log("Ersetzen-Modus uebersprungen: Starface-Adressbuch ist leer (Schutz vor versehentlichem Leeren).");
+                        }
+                        else
+                        {
+                            var leftover = outlookContacts
+                                .Where(c => !string.IsNullOrEmpty(c.OutlookEntryId) && !processedOutlookIds.Contains(c.OutlookEntryId))
+                                .ToList();
+                            if (leftover.Count > 0)
+                                Log($"Ersetzen-Modus: entferne {leftover.Count} Kontakt(e) aus Outlook, die nicht in Starface existieren");
+                            foreach (var oc in leftover)
+                            {
+                                try
+                                {
+                                    if (_outlookService.DeleteContact(oc.OutlookEntryId))
+                                    {
+                                        result.Updated++;
+                                        Log($"  Geloescht (nur in Outlook): {oc.DisplayName}");
+                                    }
+                                }
+                                catch (Exception ex)
+                                {
+                                    result.Errors++;
+                                    result.ErrorMessages.Add($"Loeschen OL {oc.DisplayName}: {ex.Message}");
+                                }
+                            }
+                        }
+                    }
+
                     // Mappings speichern
                     _profileManager.SaveMappings(profile.Id, newMappings);
                     _profileManager.UpdateLastSync(profile.Id);

src/StarfaceOutlookSync/StarfaceOutlookSync.csproj

@@ -7,9 +7,9 @@
     <AssemblyTitle>Starface Outlook Sync</AssemblyTitle>
     <Company>HackerSoft - Hacker-Net Telekommunikation</Company>
     <Product>Starface Outlook Sync</Product>
-    <Version>0.0.0.24</Version>
-    <AssemblyVersion>0.0.0.24</AssemblyVersion>
-    <FileVersion>0.0.0.24</FileVersion>
+    <Version>0.0.0.26</Version>
+    <AssemblyVersion>0.0.0.26</AssemblyVersion>
+    <FileVersion>0.0.0.26</FileVersion>
     <Description>Synchronisiert Outlook-Kontakte mit Starface Telefonanlage</Description>
     <Copyright>Stefan Hacker - HackerSoft</Copyright>
     <RuntimeIdentifier>win-x64</RuntimeIdentifier>

src/StarfaceOutlookSync/UI/AboutForm.cs

@@ -27,7 +27,7 @@ namespace StarfaceOutlookSync.UI
 
             var lblVersion = new Label
             {
-                Text = "Version 0.0.0.24",
+                Text = "Version 0.0.0.26",
                 Left = 0, Top = 56, Width = 340, Height = 20,
                 TextAlign = ContentAlignment.MiddleCenter,
                 ForeColor = Color.Gray

src/StarfaceOutlookSync/UI/ProfileEditorForm.cs

@@ -22,6 +22,7 @@ namespace StarfaceOutlookSync.UI
         private NumericUpDown _numAutoSync;
         private Button _btnTest, _btnLoadBooks, _btnSave, _btnCancel;
         private Label _lblTestResult;
+        private Label _lblDirectionHint;
 
         private List<StarfaceAddressBook> _addressBooks = new List<StarfaceAddressBook>();
         private List<string> _outlookFolderPaths = new List<string>();
@@ -101,7 +102,18 @@ namespace StarfaceOutlookSync.UI
             _cmbDirection = new ComboBox { Left = 12, Top = y, Width = 250, DropDownStyle = ComboBoxStyle.DropDownList };
             _cmbDirection.Items.AddRange(new object[] { "Bidirektional", "Outlook -> Starface", "Starface -> Outlook" });
             _cmbDirection.SelectedIndex = 0;
-            panel.Controls.Add(_cmbDirection); y += 32;
+            panel.Controls.Add(_cmbDirection); y += 28;
+
+            _lblDirectionHint = new Label
+            {
+                Left = 12, Top = y, Width = 360, Height = 32,
+                ForeColor = Color.FromArgb(150, 80, 0),
+                Font = new Font("Segoe UI", 8.25f)
+            };
+            _cmbDirection.SelectedIndexChanged += (s, e) => UpdateDirectionHint();
+            panel.Controls.Add(_lblDirectionHint);
+            UpdateDirectionHint();
+            y += 36;
 
             panel.Controls.Add(MakeLabel("Auto-Sync Intervall (Minuten, 0 = manuell):", 12, y)); y += 22;
             _numAutoSync = new NumericUpDown { Left = 12, Top = y, Width = 80, Minimum = 0, Maximum = 1440, Value = 0 };
@@ -122,6 +134,22 @@ namespace StarfaceOutlookSync.UI
             CancelButton = _btnCancel;
         }
 
+        private void UpdateDirectionHint()
+        {
+            switch (_cmbDirection.SelectedIndex)
+            {
+                case 1: // Outlook -> Starface
+                    _lblDirectionHint.Text = "Achtung: Das Starface-Adressbuch wird zur exakten Kopie von Outlook.\nKontakte, die nur in Starface existieren, werden geloescht.";
+                    break;
+                case 2: // Starface -> Outlook
+                    _lblDirectionHint.Text = "Achtung: Der Outlook-Ordner wird zur exakten Kopie von Starface.\nKontakte, die nur in Outlook existieren, werden geloescht.";
+                    break;
+                default: // Bidirektional
+                    _lblDirectionHint.Text = "Aenderungen werden in beide Richtungen abgeglichen.";
+                    break;
+            }
+        }
+
         private Label MakeLabel(string text, int x, int y)
         {
             return new Label { Text = text, Left = x, Top = y, AutoSize = true };