cms.c2sgmbh/docs/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.76.1 + Next.js 16.2.0-canary.41
• 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:

## 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

{
  "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

{
  "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

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

image-text-block

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

card-grid-block

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

faq-block

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

testimonials-block

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

team-block

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

services-block

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

posts-list-block

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

cta-block

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

stats-block

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

pricing-block

{
  "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)

# 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

# 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?