Seminar Wagtail: Headless CMS mit API v2 und modernen Frontends

Das Seminar entwickelt eine belastbare Headless-Architektur, erweitert die Wagtail API v2 und verbindet strukturierte Inhalte mit modernen Frontends einschließlich Vorschau, Caching und Sicherheit.

Inhaltsübersicht

1. Headless-Zielbild und Verantwortungsgrenzen
2. API-v2-Grundlagen und Inhaltsausgabe
3. Eigene Endpunkte und Serialisierung
4. StreamField und Medien im Headless-Betrieb
5. Frontend-Datenzugriff und Routing
6. Vorschau und redaktioneller Veröffentlichungsfluss
7. Caching, Revalidierung und Webhooks
8. Sicherheit, Tests und Betrieb

Seminarprofil

Die Inhalte verbinden fachliche Einordnung, geführte Demonstrationen und eigenständige Übungen. Jeder Themenblock baut auf den vorherigen Arbeitsschritten auf; Konfigurationen und Implementierungen werden unmittelbar anhand definierter Qualitätskriterien überprüft. Drei Tage sind notwendig, weil API-Modellierung, eigene Endpunkte, Frontend-Integration, Vorschau, Cache-Strategie, Authentisierung und Tests als Ende-zu-Ende-System umgesetzt werden.

Zielgruppe und Voraussetzungen

Zielgruppe: Backend- und Frontend-Entwickler, Solution Architects sowie Teams, die Wagtail als Content-Plattform für Web, Apps oder mehrere Kanäle einsetzen.

Voraussetzungen: Gute Kenntnisse in Python, Django, HTTP und JSON sowie Erfahrung mit einem modernen Frontend-Framework oder vergleichbarer Client-Entwicklung.

Seminarinhalte

Kapitel 1: Headless-Zielbild und Verantwortungsgrenzen

Das Kapitel ordnet Headless-Zielbild und Verantwortungsgrenzen in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Kanäle, Nutzergruppen und Content-Lebenszyklus; 2. Abgrenzung zwischen Wagtail, Integrationsschicht und Frontend; 3. Serverseitiges, statisches und hybrides Rendering; 4. Qualitätsattribute und Akzeptanzkriterien

1. Schritt 1: Kanäle, Nutzergruppen und Content-Lebenszyklus fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Abgrenzung zwischen Wagtail, Integrationsschicht und Frontend in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Serverseitiges, statisches und hybrides Rendering in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Qualitätsattribute und Akzeptanzkriterien durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 2: API-v2-Grundlagen und Inhaltsausgabe

Das Kapitel ordnet API-v2-Grundlagen und Inhaltsausgabe in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Pages-, Images- und Documents-Endpunkte; 2. Feldselektion, Detailansicht und Paginierung; 3. api_fields und strukturierte Serialisierung; 4. Fehlerantworten und stabile Ressourcendarstellung

1. Schritt 1: Pages-, Images- und Documents-Endpunkte fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Feldselektion, Detailansicht und Paginierung in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: api_fields und strukturierte Serialisierung in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Fehlerantworten und stabile Ressourcendarstellung durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 3: Eigene Endpunkte und Serialisierung

Das Kapitel ordnet Eigene Endpunkte und Serialisierung in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Eigene Modelle und Endpoint-Klassen; 2. Zusätzliche Felder, Beziehungen und verschachtelte Daten; 3. Filter, Suche und projektspezifische Parameter; 4. Versionierung und rückwärtskompatible Erweiterung

1. Schritt 1: Eigene Modelle und Endpoint-Klassen fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Zusätzliche Felder, Beziehungen und verschachtelte Daten in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Filter, Suche und projektspezifische Parameter in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Versionierung und rückwärtskompatible Erweiterung durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 4: StreamField und Medien im Headless-Betrieb

Das Kapitel ordnet StreamField und Medien im Headless-Betrieb in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Blocktypen als stabile API-Verträge; 2. Serialisierung verschachtelter Inhalte; 3. Bild-Renditions und responsive Medieninformationen; 4. Dokumente, Embeds und alternative Darstellungen

1. Schritt 1: Blocktypen als stabile API-Verträge fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Serialisierung verschachtelter Inhalte in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Bild-Renditions und responsive Medieninformationen in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Dokumente, Embeds und alternative Darstellungen durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 5: Frontend-Datenzugriff und Routing

Das Kapitel ordnet Frontend-Datenzugriff und Routing in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Abbildung von URL-Pfaden und Seitentypen; 2. Typsichere Datenmodelle und Fehlerzustände; 3. Komponentenauflösung für Block- und Seitentypen; 4. Fallbacks bei unbekannten oder neuen Inhalten

1. Schritt 1: Abbildung von URL-Pfaden und Seitentypen fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Typsichere Datenmodelle und Fehlerzustände in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Komponentenauflösung für Block- und Seitentypen in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Fallbacks bei unbekannten oder neuen Inhalten durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 6: Vorschau und redaktioneller Veröffentlichungsfluss

Das Kapitel ordnet Vorschau und redaktioneller Veröffentlichungsfluss in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Preview-Token und nicht veröffentlichte Inhalte; 2. Sichere Vorschauverbindung zum Frontend; 3. Entwurfs-, Freigabe- und Live-Zustände; 4. Prüfung von Vorschau und Publikation in mehreren Kanälen

1. Schritt 1: Preview-Token und nicht veröffentlichte Inhalte fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Sichere Vorschauverbindung zum Frontend in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Entwurfs-, Freigabe- und Live-Zustände in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Prüfung von Vorschau und Publikation in mehreren Kanälen durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 7: Caching, Revalidierung und Webhooks

Das Kapitel ordnet Caching, Revalidierung und Webhooks in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Cache-Schlüssel und Gültigkeitsgrenzen; 2. Ereignisse bei Veröffentlichung und Zurücknahme; 3. Gezielte Revalidierung betroffener Routen; 4. Idempotenz, Wiederholung und Ausfallsicherheit

1. Schritt 1: Cache-Schlüssel und Gültigkeitsgrenzen fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Ereignisse bei Veröffentlichung und Zurücknahme in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Gezielte Revalidierung betroffener Routen in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Idempotenz, Wiederholung und Ausfallsicherheit durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 8: Sicherheit, Tests und Betrieb

Das Kapitel ordnet Sicherheit, Tests und Betrieb in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Öffentliche gegenüber geschützten Inhalten; 2. Rate Limits, Eingabevalidierung und Informationsminimierung; 3. Vertrags-, Integrations- und Ende-zu-Ende-Tests; 4. Monitoring, Fehleranalyse und kompatible Releases

1. Schritt 1: Öffentliche gegenüber geschützten Inhalten fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Rate Limits, Eingabevalidierung und Informationsminimierung in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Vertrags-, Integrations- und Ende-zu-Ende-Tests in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Monitoring, Fehleranalyse und kompatible Releases durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.