Docs: Documented successful Notion DB setup and Puma M20 import; Added setup and import scripts.

This commit is contained in:
2026-01-08 16:39:47 +00:00
parent fc119f74d8
commit 9273bfffb1
4 changed files with 617 additions and 2 deletions

View File

@@ -132,14 +132,27 @@ Während der initialen Prototyping-Phase wurden kritische technische Hürden ide
* **Erkenntnis:** Notion-Integrationen benötigen explizite Freigaben pro Seite. Wenn eine Datenbank gelöscht und neu erstellt wird, muss die Verbindung in der Notion-UI oft **manuell neu autorisiert** werden, auch wenn die übergeordnete Seite bereits freigegeben war.
* **Lösung:** Bei jedem neuen Deployment-Lauf in der Notion-UI prüfen, ob die „RoboPlanet GTM Engine“ unter den `Connections` der Zielseite gelistet ist.
### 8.7 Initial Database IDs (Stand 08. Jan. 2026)
Die folgenden IDs wurden bei der initialen Erstellung der Datenbanken generiert und sollten für die weitere Entwicklung verwendet werden, um Suchindex-Verzögerungen zu vermeiden:
* **Product Master:** `2e288f42-8544-81d8-96f5-c231f84f719a`
* **Sector & Persona Master:** `2e288f42-8544-8113-b878-ec99c8a02a6b`
* **Messaging Matrix:** `2e288f42-8544-81b0-83d4-c16623cc32d1`
* **Competitive Radar:** `2e288f42-8544-814a-a2ad-eee8a181a3cc`
* **Enrichment Factory & RevOps:** `2e288f42-8544-8172-a3a7-f5101b6ac0f0`
* **The Brain:** `2e288f42-8544-810f-8e7d-e9a2a3100779`
* **GTM Workspace:** `2e288f42-8544-81cc-b167-f9dffe9c7bde`
---
### Checkliste für den Neustart mit Gemini CLI:
1. [ ] **Requests statt SDK:** Nutze die native HTTP-Library für alle Notion-Calls.
2. [ ] **ID-Persistence:** Speichere IDs in einer lokalen JSON-Variable während des Laufs.
2. [ ] **ID-Persistence:** Speichere IDs in einer lokalen JSON-Variable während des Laufs. (Nun fest in Doku hinterlegt)
3. [ ] **Schema-Validation:** Nutze einen `database.retrieve` Call vor dem ersten Daten-Push, um die Existenz der Spaltennamen zu verifizieren.
4. [ ] **Error-Logging:** Implementiere detailliertes Logging der API-Response-Bodys, da Notion dort sehr präzise Hinweise gibt (z.B. `property_not_found`).
---
**Status:** Blueprint Finalisiert.
**Nächster Schritt:** Umsetzung der Datenbank-Properties und API-Endpunkte gemäß diesem Dokument.
**Nächster Schritt:** Umsetzung der Datenbank-Properties und API-Endpunkte gemäß diesem Dokument.
### 8.8 Erfolgreicher Datenimport (08. Jan. 2026)
Der Produkt-Datensatz "Puma M20" wurde erfolgreich mithilfe des `import_product.py`-Skripts und der Quelldatei `Puma_m20_2026-01-08.md` in die Notion-Datenbanken "Product Master", "Sector & Persona Master" und "Messaging Matrix" importiert.