duffyduck
212ced4c81
Verhindert, dass mehrere Arbeitsplaetze gleichzeitig dasselbe Starface- Adressbuch synchronisieren (Dubletten/Lost-Updates bei echter Ueberlappung). - Neues optionales Setting "Gemeinsames Verzeichnis" (UserSettings.SharedDirectory) in der Einstellungen-Maske inkl. Ordner-Browser. - SyncLock: atomare Lock-Datei (FileMode.CreateNew) im gemeinsamen Verzeichnis, waehrend des Syncs offen gehalten -> bei Absturz gibt das OS das Handle frei und ein anderer Client uebernimmt die verwaiste Datei (Stale-Erkennung 15 Min, Loeschen scheitert am offenen Handle eines lebenden Halters). - MainForm wartet vor dem Sync bis zu 2 Min auf eine freie Sperre, sonst wird der Lauf uebersprungen. Ohne/bei nicht erreichbarem Verzeichnis laeuft der Sync ohne diese Sperre weiter (lokaler Interlocked-Schutz bleibt). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.6 KiB
5.6 KiB
Changelog
Alle nennenswerten Aenderungen an Starface Outlook Sync werden hier dokumentiert.
Format orientiert sich an Keep a Changelog,
Versionsschema ist x.x.x.x (siehe release.sh).
[Unreleased]
Behoben
-
Dubletten auf beiden Seiten beim Synchronisieren. Mehrere zusammenhaengende Ursachen wurden beseitigt:
- Eine unvollstaendig geladene Starface-Kontaktliste (z.B. durch einen Lade-Fehler oder Timeout) liess die Engine Kontakte faelschlich als "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, 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 ausloesen. Ein gleicher E-Mail- oder voller Namens-Treffer reicht jetzt.
-
Synchronisation extrem langsam / schrieb bei jedem Lauf alle Kontakte neu. Die Aenderungserkennung verglich einen einzigen Hash gegen beide Seiten. Outlook und Starface stellen denselben Kontakt aber unterschiedlich dar (nicht uebertragene Felder, abweichendes Telefonformat), wodurch der Hash nie uebereinstimmte und praktisch jeder Kontakt bei jedem Sync neu geschrieben wurde. Jede Seite hat jetzt eine eigene Baseline (
LastOutlookHash/LastStarfaceHash); nur tatsaechlich geaenderte Kontakte werden geschrieben.
Hinzugefuegt
- Clientuebergreifende Sync-Sperre (Mehrplatz). In den Einstellungen laesst
sich ein gemeinsames Verzeichnis (Netzlaufwerk/UNC) hinterlegen. Synct ein
Arbeitsplatz, legt er dort eine Lock-Datei an (atomar via
CreateNew); andere Clients warten, bis sie frei ist (bis 2 Min, sonst wird der Lauf uebersprungen). Stuerzt ein Client ab, uebernimmt ein anderer die verwaiste Sperre. Ist kein Verzeichnis konfiguriert oder nicht erreichbar, wird ohne diese Sperre weitergearbeitet (der lokale Schutz auf dem PC bleibt). - Feldweises 3-Wege-Merge bei Konflikten (bidirektional). Wenn derselbe Kontakt zwischen zwei Syncs auf beiden Seiten geaendert wurde, bleiben jetzt Aenderungen an unterschiedlichen Feldern beide erhalten (z.B. einer aendert die Telefonnummer in Outlook, ein anderer die E-Mail in Starface). Nur wenn DASSELBE Feld auf beiden Seiten unterschiedlich geaendert wurde, greift die Vorrang-Regel (Outlook gewinnt). Dafuer wird im Mapping zusaetzlich ein Snapshot des letzten Sync-Stands je Seite gespeichert. Solche echten Feld-Konflikte werden dem Benutzer per Tray-Meldung angezeigt.
Geaendert
- Doppelte Syncs verhindert (lokal). Der Schutz gegen gleichzeitig laufende
Syncs (manuell + Auto-Sync-Timer) ist jetzt atomar (
Interlocked) statt eines nicht-atomarenvolatile bool, bei dem beide in einem Zeitfenster durchrutschen konnten. - 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) undUpdateContactAsync(Starface) geben jetzt den frisch eingelesenen Stand zurueck, damit die Baseline nach dem Schreiben korrekt gesetzt wird und der Sync sauber konvergiert.
Migration
- Bestehende Mapping-Dateien werden beim ersten Sync automatisch uebernommen (ein ruhiger Durchlauf ohne Massen-Update).
- Bereits vorhandene Dubletten werden nicht automatisch entfernt – die Fixes verhindern nur neue. Vorhandene Doppel-Kontakte einmalig manuell bereinigen.
[0.0.0.23]
Behoben
- Kritischer Loesch-Fehler: Kontakte wurden bei einer geaenderten Outlook-EntryID nicht mehr massenhaft geloescht.
Geaendert
- Outlook-Sicherheitsschluessel werden fuer Domaenenumgebungen zusaetzlich nach HKLM geschrieben (unterdrueckt die Outlook-Sicherheitsabfrage).
Aeltere Versionen
Aeltere Releases (v0.0.0.1 – v0.0.0.22) sind ueber die Git-Historie und die Git-Tags nachvollziehbar.