frontend.blogwoman.de/docs/guides/KONZEPT-KI-ANLEITUNG.md

# Anleitung: Prompt-Erstellung für Tenant-Setup in Payload CMS

Diese Anleitung erklärt, wie du als Konzept-KI einen strukturierten Prompt für Claude Code erstellen kannst, um einen neuen Tenant im Payload CMS anzulegen und mit Inhalten zu befüllen.

---

## 1. Projektkontext

Das Payload CMS ist ein Multi-Tenant-fähiges Headless CMS mit folgenden Eigenschaften:

- **Framework:** Payload 3.69.0 + Next.js 15.5.9
- **Datenbank:** PostgreSQL 17
- **Sprachen:** Deutsch (de, Standard) und Englisch (en)
- **Tenant-Isolation:** Jede Collection ist automatisch tenant-spezifisch

---

## 2. Prompt-Struktur

Erstelle deinen Prompt nach folgendem Schema:

```markdown
## Tenant-Informationen

**Name:** [Firmenname]
**Slug:** [url-freundlicher-name]
**Domain(s):** [domain1.de, domain2.com]

### E-Mail-Konfiguration (optional)
- From-Adresse: [email]
- From-Name: [Name]
- Reply-To: [email]
- Eigener SMTP: [ja/nein]
  - Host: [smtp.example.com]
  - Port: [587]
  - User: [user]
  - Passwort: [pass]

---

## Inhalte

### Site-Settings
- Logo: [Beschreibung/URL]
- Favicon: [Beschreibung/URL]
- Primärfarbe: [#hex]
- Sekundärfarbe: [#hex]
- Footer-Text: [Text]

### Navigation
[Liste der Menüpunkte mit Links]

### Seiten
[Für jede Seite: Titel, Slug, Blocks]

### Blog-Posts (optional)
[Für jeden Post: Titel, Kategorie, Inhalt]

### Weitere Inhalte
[Services, Team, Testimonials, etc.]
```

---

## 3. Verfügbare Collections

### Kern-Collections
| Collection | Beschreibung | Wichtige Felder |
|------------|--------------|-----------------|
| `tenants` | Tenant-Konfiguration | name, slug, domains, email |
| `site-settings` | Website-Einstellungen | logo, colors, footer, contact |
| `navigations` | Menü-Strukturen | items (array mit label, link, children) |
| `pages` | Website-Seiten | title, slug, blocks (array) |
| `media` | Bilder/Dateien | file, alt, caption |

### Content-Collections
| Collection | Beschreibung | Wichtige Felder |
|------------|--------------|-----------------|
| `posts` | Blog-Artikel | title, content, categories, tags, authors, type |
| `categories` | Post-Kategorien | name, slug |
| `tags` | Post-Tags | name, slug |
| `authors` | Autoren | name, bio, image |
| `testimonials` | Kundenstimmen | quote, author, company, rating |
| `faqs` | FAQ-Einträge | question, answer |
| `team` | Team-Mitglieder | name, position, bio, image |
| `services` | Dienstleistungen | title, description, icon |
| `service-categories` | Service-Kategorien | name, slug |

### Erweiterte Collections
| Collection | Beschreibung | Wichtige Felder |
|------------|--------------|-----------------|
| `portfolios` | Portfolio-Einträge | title, images, description, category |
| `products` | Produkte | name, price, description, images |
| `events` | Veranstaltungen | title, date, location, description |
| `jobs` | Stellenangebote | title, department, description, requirements |
| `locations` | Standorte | name, address, coordinates, hours |
| `partners` | Partner/Logos | name, logo, website |
| `downloads` | Downloads | title, file, description |
| `videos` | Video-Bibliothek | title, source (youtube/vimeo/upload), url |
| `timelines` | Zeitstrahlen | title, type, entries |
| `workflows` | Prozesse | title, phases, steps |

### Formular & Newsletter
| Collection | Beschreibung |
|------------|--------------|
| `forms` | Formular-Builder |
| `newsletter-subscribers` | Newsletter-Abonnenten |

### Spezial-Collections (tenant-spezifisch)
| Collection | Tenant | Beschreibung |
|------------|--------|--------------|
| `bookings` | porwoll.de | Fotografie-Buchungen |
| `certifications` | c2s | Zertifizierungen |
| `projects` | gunshin | Spieleprojekte |
| `favorites` | BlogWoman | Affiliate-Produkte |
| `series` | BlogWoman | YouTube-Serien |

---

## 4. Verfügbare Blocks (42 Stück)

### Layout-Blocks
```
hero-block              - Hero-Banner mit Bild
hero-slider-block       - Hero-Slider mit mehreren Slides
image-slider-block      - Bild-Karussell
text-block              - Rich-Text-Inhalt
image-text-block        - Bild + Text nebeneinander
card-grid-block         - Karten-Raster
quote-block             - Zitat/Blockquote
cta-block               - Call-to-Action Button
divider-block           - Visueller Trenner
```

### Media-Blocks
```
video-block             - Video (YouTube/Vimeo/Upload)
video-embed-block       - Video-Einbettung mit Privacy-Mode
```

### Content-Blocks
```
posts-list-block        - Blog-Post-Liste mit Pagination
testimonials-block      - Testimonial-Karussell
newsletter-block        - Newsletter-Anmeldung
process-steps-block     - Schritt-für-Schritt-Prozess
faq-block               - FAQ-Akkordeon
team-block              - Team-Mitglieder-Grid
services-block          - Service-Auflistung
```

### Blog-Blocks
```
author-bio-block        - Autoren-Info
related-posts-block     - Verwandte Artikel
share-buttons-block     - Social-Share-Buttons
table-of-contents-block - Inhaltsverzeichnis
```

### Team-Blocks
```
team-filter-block       - Team mit Filter
org-chart-block         - Organigramm
```

### Feature-Blocks
```
locations-block         - Standorte mit Karte
logo-grid-block         - Partner-/Kunden-Logos
stats-block             - Statistiken/Zahlen
jobs-block              - Stellenangebote
downloads-block         - Download-Bereich
map-block               - Karten-Einbettung
events-block            - Veranstaltungs-Kalender
pricing-block           - Preis-Tabellen
tabs-block              - Tab-Inhalte
accordion-block         - Akkordeon-Sektionen
comparison-block        - Vergleichs-Tabellen
timeline-block          - Zeitleisten-Visualisierung
before-after-block      - Vorher/Nachher-Vergleich
```

### BlogWoman-Blocks
```
favorites-block         - Affiliate-Produkte
series-block            - YouTube-Serien-Übersicht
series-detail-block     - Einzelne Serie mit Hero
featured-content-block  - Kuratierte Inhalte
```

---

## 5. Block-Konfiguration (Details)

### hero-block
```json
{
  "blockType": "hero-block",
  "heading": "Willkommen",
  "subheading": "Untertitel",
  "backgroundImage": "<media-id>",
  "ctaText": "Mehr erfahren",
  "ctaLink": "/ueber-uns",
  "alignment": "center",
  "overlay": true,
  "overlayOpacity": 0.5
}
```

### hero-slider-block
```json
{
  "blockType": "hero-slider-block",
  "slides": [
    {
      "heading": "Slide 1",
      "subheading": "Text",
      "backgroundImage": "<media-id>",
      "ctaText": "Button",
      "ctaLink": "/link"
    }
  ],
  "autoplay": true,
  "autoplaySpeed": 5000,
  "showDots": true,
  "showArrows": true
}
```

### text-block
```json
{
  "blockType": "text-block",
  "content": {
    "root": {
      "type": "root",
      "children": [
        {
          "type": "paragraph",
          "children": [{"text": "Ihr Text hier..."}]
        }
      ]
    }
  }
}
```

### image-text-block
```json
{
  "blockType": "image-text-block",
  "image": "<media-id>",
  "heading": "Überschrift",
  "content": "<rich-text>",
  "imagePosition": "left",
  "ctaText": "Button",
  "ctaLink": "/link"
}
```

### card-grid-block
```json
{
  "blockType": "card-grid-block",
  "cards": [
    {
      "title": "Karte 1",
      "description": "Beschreibung",
      "image": "<media-id>",
      "link": "/link"
    }
  ],
  "columns": 3
}
```

### faq-block
```json
{
  "blockType": "faq-block",
  "heading": "Häufige Fragen",
  "faqs": ["<faq-id-1>", "<faq-id-2>"]
}
```

### testimonials-block
```json
{
  "blockType": "testimonials-block",
  "heading": "Kundenstimmen",
  "testimonials": ["<testimonial-id-1>", "<testimonial-id-2>"],
  "layout": "carousel"
}
```

### team-block
```json
{
  "blockType": "team-block",
  "heading": "Unser Team",
  "teamMembers": ["<team-id-1>", "<team-id-2>"],
  "showBio": true,
  "columns": 4
}
```

### services-block
```json
{
  "blockType": "services-block",
  "heading": "Unsere Leistungen",
  "services": ["<service-id-1>", "<service-id-2>"],
  "layout": "grid"
}
```

### posts-list-block
```json
{
  "blockType": "posts-list-block",
  "heading": "Neueste Artikel",
  "categories": ["<category-id>"],
  "limit": 6,
  "showPagination": true
}
```

### cta-block
```json
{
  "blockType": "cta-block",
  "heading": "Jetzt starten",
  "text": "Kontaktieren Sie uns noch heute.",
  "buttonText": "Kontakt aufnehmen",
  "buttonLink": "/kontakt",
  "backgroundColor": "#1a1a1a"
}
```

### stats-block
```json
{
  "blockType": "stats-block",
  "stats": [
    {"number": "500+", "label": "Kunden"},
    {"number": "10", "label": "Jahre Erfahrung"},
    {"number": "24/7", "label": "Support"}
  ]
}
```

### pricing-block
```json
{
  "blockType": "pricing-block",
  "heading": "Unsere Preise",
  "plans": [
    {
      "name": "Basic",
      "price": "29",
      "period": "monatlich",
      "features": ["Feature 1", "Feature 2"],
      "ctaText": "Auswählen",
      "ctaLink": "/checkout/basic",
      "highlighted": false
    }
  ]
}
```

---

## 6. Beispiel-Prompt (Vollständig)

```markdown
# Tenant anlegen: Musterfirma GmbH

## Tenant-Informationen

**Name:** Musterfirma GmbH
**Slug:** musterfirma
**Domains:** musterfirma.de, www.musterfirma.de

### E-Mail-Konfiguration
- From-Adresse: info@musterfirma.de
- From-Name: Musterfirma GmbH
- Reply-To: kontakt@musterfirma.de
- Eigener SMTP: nein (globalen SMTP verwenden)

---

## Site-Settings

- **Logo:** Musterfirma-Logo (blauer Kreis mit weißem "M")
- **Favicon:** Kleines "M" auf blauem Hintergrund
- **Primärfarbe:** #2563eb (Blau)
- **Sekundärfarbe:** #1e40af (Dunkelblau)
- **Akzentfarbe:** #f59e0b (Orange)
- **Footer-Text:** "© 2026 Musterfirma GmbH. Alle Rechte vorbehalten."
- **Kontakt-E-Mail:** info@musterfirma.de
- **Telefon:** +49 123 456789
- **Adresse:** Musterstraße 1, 12345 Musterstadt

---

## Navigation

### Hauptmenü
1. Startseite → /
2. Über uns → /ueber-uns
3. Leistungen → /leistungen
   - Beratung → /leistungen/beratung
   - Entwicklung → /leistungen/entwicklung
   - Support → /leistungen/support
4. Referenzen → /referenzen
5. Blog → /blog
6. Kontakt → /kontakt

### Footer-Navigation
1. Impressum → /impressum
2. Datenschutz → /datenschutz
3. AGB → /agb

---

## Seiten

### Startseite (/)
**Blocks:**
1. hero-slider-block
   - Slide 1: "Willkommen bei Musterfirma" / "Ihr Partner für digitale Lösungen" / CTA: "Jetzt beraten lassen" → /kontakt
   - Slide 2: "Innovation trifft Expertise" / "Seit 10 Jahren erfolgreich" / CTA: "Mehr erfahren" → /ueber-uns

2. stats-block
   - 500+ zufriedene Kunden
   - 10 Jahre Erfahrung
   - 50 Mitarbeiter
   - 24/7 Support

3. services-block
   - Überschrift: "Unsere Leistungen"
   - Zeige alle Services

4. testimonials-block
   - Überschrift: "Das sagen unsere Kunden"
   - 3 Testimonials im Karussell

5. cta-block
   - "Bereit für Ihr nächstes Projekt?"
   - Button: "Kostenloses Erstgespräch" → /kontakt

### Über uns (/ueber-uns)
**Blocks:**
1. hero-block
   - "Über Musterfirma"
   - "Lernen Sie uns kennen"

2. image-text-block
   - Bild: Team-Foto
   - Text: Firmengeschichte und Vision
   - Bild links

3. timeline-block
   - Firmengeschichte als Zeitstrahl
   - 2016: Gründung
   - 2018: Erster Großkunde
   - 2020: 25 Mitarbeiter
   - 2024: Expansion

4. team-block
   - "Unser Team"
   - Alle Team-Mitglieder

### Leistungen (/leistungen)
**Blocks:**
1. hero-block
   - "Unsere Leistungen"
   - "Maßgeschneiderte Lösungen für Ihren Erfolg"

2. services-block
   - Alle Services mit Icons

3. process-steps-block
   - "So arbeiten wir"
   - Schritt 1: Analyse
   - Schritt 2: Konzept
   - Schritt 3: Umsetzung
   - Schritt 4: Betreuung

4. cta-block
   - "Interesse geweckt?"
   - Button: "Jetzt anfragen"

### Kontakt (/kontakt)
**Blocks:**
1. hero-block
   - "Kontakt"
   - "Wir freuen uns auf Ihre Nachricht"

2. image-text-block
   - Kontaktinformationen
   - Bild: Büro-Foto

3. contact-form-block
   - Kontaktformular

4. map-block
   - Standort auf Karte

### Blog (/blog)
**Blocks:**
1. hero-block
   - "Unser Blog"
   - "Insights und Neuigkeiten"

2. posts-list-block
   - Alle Blog-Posts
   - 6 pro Seite
   - Mit Pagination

---

## Kategorien

1. **Technologie** (slug: technologie)
2. **Trends** (slug: trends)
3. **Case Studies** (slug: case-studies)
4. **Tipps & Tricks** (slug: tipps-tricks)

---

## Tags

1. Digitalisierung
2. Innovation
3. KI
4. Cloud
5. Sicherheit

---

## Autoren

### Max Mustermann
- **Position:** CEO & Gründer
- **Bio:** Max ist Gründer und CEO der Musterfirma GmbH. Mit über 15 Jahren Erfahrung in der IT-Branche...
- **Bild:** Professionelles Porträt

### Anna Schmidt
- **Position:** Head of Content
- **Bio:** Anna leitet das Content-Team und ist verantwortlich für alle redaktionellen Inhalte...
- **Bild:** Professionelles Porträt

---

## Team-Mitglieder

### Max Mustermann
- **Position:** CEO & Gründer
- **Bio:** Gründer mit Vision für digitale Transformation
- **E-Mail:** max@musterfirma.de
- **LinkedIn:** linkedin.com/in/maxmustermann

### Anna Schmidt
- **Position:** Head of Content
- **Bio:** Content-Strategin mit Leidenschaft für Storytelling
- **E-Mail:** anna@musterfirma.de

### Tim Weber
- **Position:** Lead Developer
- **Bio:** Full-Stack-Entwickler mit Fokus auf skalierbare Lösungen
- **E-Mail:** tim@musterfirma.de

### Lisa Müller
- **Position:** UX Designer
- **Bio:** Kreiert nutzerzentrierte Designs für digitale Produkte
- **E-Mail:** lisa@musterfirma.de

---

## Services

### Beratung
- **Icon:** lightbulb
- **Kurzbeschreibung:** Strategische IT-Beratung für Ihr Unternehmen
- **Beschreibung:** Wir analysieren Ihre Geschäftsprozesse und entwickeln maßgeschneiderte Digitalisierungsstrategien...

### Entwicklung
- **Icon:** code
- **Kurzbeschreibung:** Individuelle Softwareentwicklung
- **Beschreibung:** Unser Entwicklerteam setzt Ihre Ideen in leistungsstarke Anwendungen um...

### Support
- **Icon:** headset
- **Kurzbeschreibung:** Zuverlässiger 24/7 Support
- **Beschreibung:** Unser Support-Team steht Ihnen rund um die Uhr zur Verfügung...

---

## Testimonials

### Testimonial 1
- **Zitat:** "Die Zusammenarbeit mit Musterfirma hat unsere digitale Transformation beschleunigt. Hervorragende Arbeit!"
- **Name:** Dr. Peter Schneider
- **Position:** CTO
- **Unternehmen:** TechCorp AG
- **Rating:** 5

### Testimonial 2
- **Zitat:** "Professionell, zuverlässig und innovativ. Genau der Partner, den wir gesucht haben."
- **Name:** Maria Hofmann
- **Position:** Geschäftsführerin
- **Unternehmen:** Digital Solutions GmbH
- **Rating:** 5

### Testimonial 3
- **Zitat:** "Das Team von Musterfirma versteht es, komplexe Anforderungen in elegante Lösungen zu verwandeln."
- **Name:** Thomas Klein
- **Position:** IT-Leiter
- **Unternehmen:** InnoTech AG
- **Rating:** 5

---

## FAQs

### Wie lange dauert ein typisches Projekt?
Die Projektdauer hängt vom Umfang ab. Kleine Projekte dauern 2-4 Wochen, größere Projekte 3-6 Monate.

### Bieten Sie auch Wartung an?
Ja, wir bieten verschiedene Wartungs- und Support-Pakete an, die auf Ihre Bedürfnisse zugeschnitten sind.

### Wie läuft die Zusammenarbeit ab?
Nach einem kostenlosen Erstgespräch erstellen wir ein Angebot. Bei Beauftragung starten wir mit einer Analysephase.

### Arbeiten Sie auch mit kleinen Unternehmen?
Ja, wir betreuen Unternehmen jeder Größe, vom Startup bis zum Konzern.

---

## Blog-Posts

### Post 1: "Die Zukunft der KI im Mittelstand"
- **Autor:** Max Mustermann
- **Kategorie:** Technologie
- **Tags:** KI, Innovation, Digitalisierung
- **Type:** blog
- **Excerpt:** Wie mittelständische Unternehmen von künstlicher Intelligenz profitieren können...
- **Content:**
  - Einleitung zur KI-Revolution
  - 3 Anwendungsbeispiele
  - Implementierungstipps
  - Fazit und Ausblick
- **Status:** published

### Post 2: "5 Tipps für erfolgreiche Digitalisierung"
- **Autor:** Anna Schmidt
- **Kategorie:** Tipps & Tricks
- **Tags:** Digitalisierung, Tipps
- **Type:** blog
- **Excerpt:** Praktische Ratschläge für Unternehmen auf dem Weg zur Digitalisierung...
- **Content:**
  - Einleitung
  - Tipp 1-5 mit Erklärungen
  - Zusammenfassung
- **Status:** published

### Post 3: "Case Study: TechCorp digitalisiert Prozesse"
- **Autor:** Max Mustermann
- **Kategorie:** Case Studies
- **Tags:** Case Study, Digitalisierung
- **Type:** blog
- **Excerpt:** Wie wir TechCorp bei der Prozessdigitalisierung unterstützt haben...
- **Content:**
  - Ausgangslage
  - Herausforderungen
  - Lösung
  - Ergebnisse
- **Status:** published

---

## Rechtliche Seiten

### Impressum (/impressum)
- Angaben gemäß § 5 TMG
- Kontaktdaten
- Geschäftsführer
- Handelsregister
- USt-IdNr.

### Datenschutz (/datenschutz)
- DSGVO-konforme Datenschutzerklärung
- Verantwortlicher
- Datenerfassung
- Cookies
- Rechte der Betroffenen

### AGB (/agb)
- Allgemeine Geschäftsbedingungen

---

## Formulare

### Kontaktformular
- Felder: Name, E-Mail, Telefon (optional), Betreff, Nachricht
- Bestätigungs-E-Mail an Absender
- Benachrichtigungs-E-Mail an info@musterfirma.de
```

---

## 7. Wichtige Hinweise für den Prompt

### Pflichtangaben
- [ ] Tenant-Name und Slug
- [ ] Mindestens eine Domain
- [ ] Site-Settings (Logo, Farben)
- [ ] Navigation (Header, Footer)
- [ ] Mindestens eine Seite mit Blocks

### Empfohlene Angaben
- [ ] E-Mail-Konfiguration
- [ ] Team-Mitglieder
- [ ] Services/Leistungen
- [ ] Testimonials
- [ ] FAQ-Einträge
- [ ] Blog-Kategorien und Posts
- [ ] Rechtliche Seiten

### Formatierung
- Verwende Markdown für Strukturierung
- Nutze klare Überschriften und Listen
- Gib Block-Typen explizit an
- Beschreibe Inhalte so detailliert wie möglich
- Gib Beziehungen zwischen Inhalten an (z.B. Post → Kategorie)

### Lokalisierung
- Standard-Sprache ist Deutsch (de)
- Gib bei Bedarf englische Übersetzungen an:
  ```
  **Titel (DE):** Über uns
  **Titel (EN):** About Us
  ```

---

## 8. Ausgabe-Format für Claude

Dein Prompt sollte Claude bitten, folgende Aufgaben auszuführen:

1. **Tenant erstellen** via Payload API
2. **Site-Settings anlegen** mit allen Konfigurationen
3. **Navigationen erstellen** (Header, Footer)
4. **Media-Assets hochladen** (falls URLs bereitgestellt)
5. **Kategorien/Tags anlegen** für Blog
6. **Autoren erstellen** für Blog
7. **Team-Mitglieder anlegen**
8. **Services erstellen**
9. **Testimonials anlegen**
10. **FAQs erstellen**
11. **Seiten mit Blocks erstellen**
12. **Blog-Posts anlegen**
13. **Formulare konfigurieren**

---

## 9. Beispiel-Einleitung für deinen Prompt

```markdown
# Auftrag: Neuen Tenant anlegen und befüllen

Bitte lege im Payload CMS einen neuen Tenant mit folgenden Daten an.
Erstelle alle notwendigen Inhalte (Collections, Seiten, Posts) gemäß
der Spezifikation unten.

Nutze die Payload Local API oder REST API für die Datenerstellung.
Stelle sicher, dass alle Beziehungen korrekt verknüpft werden
(z.B. Posts → Categories, Pages → Blocks).

## Technische Hinweise
- Tenant-ID wird automatisch generiert
- Media-Uploads: Erstelle Platzhalter oder nutze bereitgestellte URLs
- Lexical-Format für Rich-Text-Inhalte verwenden
- Status: 'published' für alle Live-Inhalte

---

[Hier folgen deine Tenant-Daten...]
```

---

## 10. Checkliste vor Prompt-Übergabe

- [ ] Alle Pflichtfelder ausgefüllt?
- [ ] Block-Typen korrekt angegeben?
- [ ] Beziehungen zwischen Inhalten definiert?
- [ ] Bilder/Media beschrieben oder URLs bereitgestellt?
- [ ] Texte vollständig formuliert (nicht nur Platzhalter)?
- [ ] Navigation logisch strukturiert?
- [ ] Rechtliche Seiten berücksichtigt?
- [ ] E-Mail-Adressen korrekt formatiert?
- [ ] Farben als Hex-Werte angegeben?