fix(gtm): Pin openai==0.28.1 to resolve helpers.py compatibility and update migration docs

BUILDER_APPS_MIGRATION.md

@@ -42,6 +42,16 @@ Wenn die App unter einem Unterverzeichnis (z.B. `/gtm/`) läuft, findet sie ihre
     });
     ```
 
+### 1.4 Python Dependencies (OpenAI Version)
+Das Projekt nutzt ein geteiltes `helpers.py`, das auf der alten OpenAI Python Library (v0.28.1) basiert.
+*   **Fehler:** `ModuleNotFoundError: No module named 'openai.error'`
+*   **Ursache:** `pip install openai` installiert standardmäßig v1.x, was inkompatibel ist.
+*   **Fix:** In `requirements.txt` zwingend die Version pinnen:
+    ```text
+    openai==0.28.1
+    # weitere deps...
+    ```
+
 ---
 
 ## 2. Die Backend-Bridge (`server.cjs`)
@@ -192,6 +202,7 @@ Achtung beim Routing. Wenn die App unter `/app/` laufen soll, muss der Trailing
 
 - [ ] `express` in `package.json`?
 - [ ] `vite.config.ts` hat `base: './'`?
+- [ ] `requirements.txt` hat `openai==0.28.1`?
 - [ ] `server.cjs` hat Timeouts (>600s)?
 - [ ] `docker-compose.yml` mountet auch `helpers.py` und `config.py`?
 - [ ] Leere `.db` Datei auf dem Host erstellt?

gtm-architect/requirements.txt

@@ -1,4 +1,4 @@
-openai
+openai==0.28.1
 pandas
 gspread
 oauth2client