From 9c9f72eb5b2f57ef51e4b5f03e871436e1905047 Mon Sep 17 00:00:00 2001
From: Floke <floke.com@gmail.com>
Date: Wed, 31 Dec 2025 14:01:21 +0000
Subject: [PATCH] fix(gtm): Pin openai==0.28.1 to resolve helpers.py
 compatibility and update migration docs

---
 BUILDER_APPS_MIGRATION.md      | 11 +++++++++++
 gtm-architect/requirements.txt |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/BUILDER_APPS_MIGRATION.md b/BUILDER_APPS_MIGRATION.md
index e54bfe70..1f719c4b 100644
--- a/BUILDER_APPS_MIGRATION.md
+++ b/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?
diff --git a/gtm-architect/requirements.txt b/gtm-architect/requirements.txt
index 8ea053c9..4a1992f9 100644
--- a/gtm-architect/requirements.txt
+++ b/gtm-architect/requirements.txt
@@ -1,4 +1,4 @@
-openai
+openai==0.28.1
 pandas
 gspread
 oauth2client