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/explorer_client.py

@@ -0,0 +1,23 @@
+"""
+This module will be responsible for communicating with the Company Explorer API.
+- Fetching companies that need enrichment.
+- Pushing enriched data back.
+"""
+
+class ExplorerClient:
+    def __init__(self, api_base_url, api_user, api_password):
+        self.api_base_url = api_base_url
+        self.auth = (api_user, api_password)
+        # TODO: Initialize requests session
+
+    def get_companies_to_sync(self):
+        """
+        Fetches a list of companies from the Company Explorer that are ready to be synced to SuperOffice.
+        """
+        pass
+
+    def get_company_details(self, company_id):
+        """
+        Fetches detailed information for a single company.
+        """
+        pass