feat(superoffice): POC API handshake & auth flow [2ff88f42]

Establishes the initial structure for the SuperOffice connector. Implements the complete, iterative authentication process, culminating in a successful refresh token exchange. Documents the process and the final blocker (API authorization) in the integration plan, awaiting IT action to change the application type to 'Server to server'.

connector-superoffice/sync_engine.py

@@ -0,0 +1,22 @@
+"""
+This module contains the core logic for the synchronization process.
+- Fetches data from Company Explorer.
+- Fetches data from SuperOffice.
+- Performs deduplication checks.
+- Creates or updates companies and contacts in SuperOffice.
+"""
+
+class SyncEngine:
+    def __init__(self, superoffice_client, explorer_client):
+        self.so_client = superoffice_client
+        self.ex_client = explorer_client
+
+    def run_sync(self):
+        """
+        Executes a full synchronization run.
+        """
+        # 1. Get companies from Explorer
+        # 2. For each company, check if it exists in SuperOffice
+        # 3. If not, create it
+        # 4. If yes, update it (or skip)
+        pass