Seminar TYPO3 v14: Headless-Architekturen und Schnittstellen

Das Seminar behandelt TYPO3 v14 als Content-Plattform für entkoppelte Frontends. Im Mittelpunkt stehen ein stabiler Content-Vertrag, gezielt entwickelte Ausgabeschnittstellen, sichere Zugriffe, kontrollierte Cache-Invalidierung und ein praxistauglicher Vorschau- und Betriebsprozess.

Die Inhalte sind auf einzelseminar mit hohem Praxisanteil ausgelegt. Theorie, Demonstration, geführte Konfiguration und kontrollierte Übungen greifen unmittelbar ineinander.

Lernziele

• Headless- und Hybridarchitekturen sachgerecht auswählen
• Content-Modelle für kanalübergreifende Ausgabe entwickeln
• Schnittstellen mit klaren Verträgen und sicheren Endpunkten umsetzen
• Caching, Vorschau und Mehrsprachigkeit zuverlässig abbilden
• Tests, Monitoring und Versionsmanagement für Clients etablieren

Inhaltsübersicht

1. Architekturentscheidung und Systemgrenzen
2. Content-Modell und Redaktionsvertrag
3. Routing und Endpunktdesign
4. JSON-Ausgabe und Datenaufbereitung
5. Authentisierung und Autorisierung
6. Caching und Invalidierung
7. CORS, CSP und Ausgabesicherheit
8. Vorschau, Mehrsprachigkeit und Fehlerfälle
9. Tests, Monitoring und Client-Versionen

Kapitel 1: Architekturentscheidung und Systemgrenzen

Inhaltsübersicht des Kapitels

• Headless, Hybrid und klassisch vergleichen
• Verantwortlichkeiten trennen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Headless, Hybrid und klassisch vergleichen, Verantwortlichkeiten trennen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 1.1: Headless, Hybrid und klassisch vergleichen

Fachliche Ausarbeitung: Anforderungen an Rendering, Redaktion, Vorschau, Personalisierung und Betrieb gegenübergestellt. Praktische Umsetzung: Für mehrere Projektszenarien eine begründete Architekturentscheidung getroffen. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 1.2: Verantwortlichkeiten trennen

Fachliche Ausarbeitung: TYPO3, API-Schicht, Frontend-Anwendung, Authentisierung und Infrastruktur als getrennte Verantwortungsbereiche beschrieben. Praktische Umsetzung: Ein Architekturdiagramm mit Datenflüssen und Fehlergrenzen erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 2: Content-Modell und Redaktionsvertrag

Inhaltsübersicht des Kapitels

• Kanalneutrale Inhalte modellieren
• Redaktionelle Vorschau berücksichtigen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Kanalneutrale Inhalte modellieren, Redaktionelle Vorschau berücksichtigen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 2.1: Kanalneutrale Inhalte modellieren

Fachliche Ausarbeitung: Inhaltsbedeutung, Varianten, Relationen und Präsentationsdetails voneinander getrennt. Praktische Umsetzung: Ein Content-Modell für mehrere Ausgabekanäle entworfen. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 2.2: Redaktionelle Vorschau berücksichtigen

Fachliche Ausarbeitung: Entwurfsstatus, Sichtbarkeit, Sprache, Zeitsteuerung und Workspace-Kontext in den Vertrag aufgenommen. Praktische Umsetzung: Einen Vorschauablauf vom Backend bis zum entkoppelten Frontend beschrieben. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 3: Routing und Endpunktdesign

Inhaltsübersicht des Kapitels

• Endpunkte fachlich schneiden
• TYPO3-Routing integrieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Endpunkte fachlich schneiden, TYPO3-Routing integrieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 3.1: Endpunkte fachlich schneiden

Fachliche Ausarbeitung: Ressourcen, Listen, Detailansichten, Navigation und Suchfälle mit stabilen Verantwortlichkeiten definiert. Praktische Umsetzung: Eine kleine Endpunktlandschaft mit konsistenten Namen und Antwortformen entworfen. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 3.2: TYPO3-Routing integrieren

Fachliche Ausarbeitung: Site-Kontext, Slugs, Sprachen, Parameter und Fehlerantworten in die Auslieferung einbezogen. Praktische Umsetzung: Mehrsprachige Routen mit definierten Nichtgefunden- und Weiterleitungsfällen umgesetzt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 4: JSON-Ausgabe und Datenaufbereitung

Inhaltsübersicht des Kapitels

• Antwortschema festlegen
• Daten gezielt serialisieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Antwortschema festlegen, Daten gezielt serialisieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 4.1: Antwortschema festlegen

Fachliche Ausarbeitung: Felder, Typen, optionale Werte, Relationen, Metadaten und Versionierung als Datenvertrag dokumentiert. Praktische Umsetzung: Ein maschinenlesbares Beispielschema mit gültigen und ungültigen Fällen erstellt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 4.2: Daten gezielt serialisieren

Fachliche Ausarbeitung: TYPO3-Datensätze, Dateien, Links und gerenderte Fragmente kontrolliert in Ausgabedaten überführt. Praktische Umsetzung: Eine Ausgabe ohne unbeabsichtigte interne Felder und zyklische Strukturen implementiert. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 5: Authentisierung und Autorisierung

Inhaltsübersicht des Kapitels

• Öffentliche und geschützte Daten trennen
• Zugriffe serverseitig absichern
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Öffentliche und geschützte Daten trennen, Zugriffe serverseitig absichern. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 5.1: Öffentliche und geschützte Daten trennen

Fachliche Ausarbeitung: Anonyme Inhalte, geschützte Bereiche und benutzerbezogene Antworten nach Risiko unterschieden. Praktische Umsetzung: Eine Zugriffsmatrix für Endpunkte und Datensätze erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 5.2: Zugriffe serverseitig absichern

Fachliche Ausarbeitung: Identität, Berechtigung, Eigentum, Rate Limits und Fehlermeldungen kontrolliert verarbeitet. Praktische Umsetzung: Unerlaubte Direktzugriffe und manipulierte Identitäten mit Tests abgefangen. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 6: Caching und Invalidierung

Inhaltsübersicht des Kapitels

• Cache-Ebenen planen
• Änderungen zuverlässig propagieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Cache-Ebenen planen, Änderungen zuverlässig propagieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 6.1: Cache-Ebenen planen

Fachliche Ausarbeitung: TYPO3-Cache, Reverse Proxy, CDN-nahe Schichten und Client-Cache nach Datenart bewertet. Praktische Umsetzung: Eine Cache-Matrix mit Lebensdauer und Privatheitsmerkmalen erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 6.2: Änderungen zuverlässig propagieren

Fachliche Ausarbeitung: Tags, Zeitsteuerung, Publikationsereignisse und gezielte Invalidierung in einen Ablauf überführt. Praktische Umsetzung: Eine Inhaltsänderung bis zur aktualisierten Client-Ausgabe nachvollzogen. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 7: CORS, CSP und Ausgabesicherheit

Inhaltsübersicht des Kapitels

• Browsergrenzen korrekt konfigurieren
• Inhalte sicher ausgeben
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Browsergrenzen korrekt konfigurieren, Inhalte sicher ausgeben. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 7.1: Browsergrenzen korrekt konfigurieren

Fachliche Ausarbeitung: Erlaubte Ursprünge, Methoden, Header und Anmeldeinformationen minimal festgelegt. Praktische Umsetzung: Eine enge CORS-Konfiguration für definierte Frontends aufgebaut. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 7.2: Inhalte sicher ausgeben

Fachliche Ausarbeitung: Escaping, HTML-Fragmente, Dateiverweise, sensible Metadaten und Content Security Policy bewertet. Praktische Umsetzung: Eine riskante Antwort analysiert und auf notwendige Daten reduziert. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 8: Vorschau, Mehrsprachigkeit und Fehlerfälle

Inhaltsübersicht des Kapitels

• Entwürfe sicher vorschauen
• Sprachen und Fallbacks abbilden
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Entwürfe sicher vorschauen, Sprachen und Fallbacks abbilden. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 8.1: Entwürfe sicher vorschauen

Fachliche Ausarbeitung: Preview-Tokens, Workspace-Kontext, Ablaufzeiten und Trennung von öffentlicher Ausgabe geplant. Praktische Umsetzung: Einen sicheren Vorschauweg mit zeitlich begrenztem Zugriff umgesetzt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 8.2: Sprachen und Fallbacks abbilden

Fachliche Ausarbeitung: Sprachkontext, Übersetzungsstatus, Fallbacks und fehlende Inhalte im Antwortvertrag geklärt. Praktische Umsetzung: Mehrere Sprachfälle mit konsistenten Status- und Fehlerantworten getestet. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 9: Tests, Monitoring und Client-Versionen

Inhaltsübersicht des Kapitels

• Verträge automatisiert prüfen
• Betrieb und Weiterentwicklung absichern
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Verträge automatisiert prüfen, Betrieb und Weiterentwicklung absichern. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 9.1: Verträge automatisiert prüfen

Fachliche Ausarbeitung: Schema-, Integrations-, Berechtigungs- und Cache-Tests nach Risiko aufgebaut. Praktische Umsetzung: Einen kleinen Vertragstest für mehrere Beispielantworten implementiert. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 9.2: Betrieb und Weiterentwicklung absichern

Fachliche Ausarbeitung: Monitoring, Protokollierung, Deprecation, Client-Kompatibilität und Rollback dokumentiert. Praktische Umsetzung: Eine Versions- und Abschaltstrategie für Schnittstellen erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Didaktischer Aufbau

Jeder Themenblock beginnt mit einer Einordnung, wird am System demonstriert und anschließend praktisch umgesetzt. Übungen bauen aufeinander auf, sodass am Ende eine zusammenhängende, prüfbare TYPO3-Konfiguration oder ein vollständiger redaktioneller Arbeitsablauf vorliegt.