[2ff88f42] 1. Analyse der Änderungen:

1. Analyse der Änderungen:
      * superoffice_client.py: Implementierung der Methoden create_contact (Standardfelder) und create_person (inkl. Firmenverknüpfung).
      * auth_handler.py: Härtung der Authentifizierung durch Priorisierung von SO_CLIENT_ID und Unterstützung für load_dotenv(override=True).
      * main.py: Erweiterung des Test-Workflows für den vollständigen Lese- und Schreib-Durchstich (Erstellung von Demo-Firmen und Personen).
      * README.md: Aktualisierung des Status Quo und der verfügbaren Client-Methoden.

connector-superoffice/README.md

@@ -7,9 +7,11 @@ Der Connector nutzt die **REST API (v1)** und authentifiziert sich via **OAuth 2
 
 Der **Proof of Concept (POC)** ist erfolgreich abgeschlossen.
 - **Verbindung:** Erfolgreich hergestellt (`Cust55774`).
-- **Authentifizierung:** Funktioniert automatisch via Refresh Token.
-- **Datenabruf:** Stammdaten (Contact ID 1) können gelesen werden.
-- **Daten schreiben:** Vorbereitet (Code ist fertig), erfordert jedoch noch das Anlegen der UDF-Felder im SuperOffice Admin-Panel.
+- **Authentifizierung:** Funktioniert automatisch via Refresh Token (gehärtet via `load_dotenv(override=True)`).
+- **Daten schreiben (Erfolg):**
+    - **Firmen (Contacts):** Erfolgreich angelegt (inkl. Name, URL, OrgNr).
+    - **Personen (Persons):** Erfolgreich angelegt und mit Firmen verknüpft (inkl. E-Mail).
+- **UDF-Felder:** Vorbereitet im Code, erfordert finalen Abgleich der `ProgId` nach Anlage im Admin-Panel.
 
 ## 2. Einrichtung & Installation
 
@@ -42,14 +44,20 @@ SO_REFRESH_TOKEN="<Dein langlebiger Refresh Token>"
 
 ## 3. Nutzung
 
-### Verbindungstest (Main Script)
-Führt einen Login durch und sucht nach einer Test-Firma.
+### Verbindungstest & Demo
+Führt einen Login durch, sucht nach einer Test-Firma und legt bei Bedarf einen Demo-Account mit Ansprechpartner an.
 
 ```bash
 cd connector-superoffice
 ../.venv/bin/python main.py
 ```
 
+### Verfügbare Methoden (SuperOfficeClient)
+- `find_contact_by_criteria(...)`: Suche nach Name, URL oder OrgNr.
+- `create_contact(...)`: Erstellt eine neue Firma.
+- `create_person(...)`: Erstellt einen Ansprechpartner (verknüpft mit ContactId).
+- `update_udfs(...)`: (Vorbereitet) Aktualisiert KI-Felder.
+
 ### Felder entdecken
 Listet alle verfügbaren Felder (inkl. UDFs) auf, um die technischen Namen (`ProgId`) für das Mapping zu finden.