Seminar ApostropheCMS Module und Erweiterungsentwicklung

In vier Tagen entsteht ein vollständiges Fachmodul mit Datenmodell, Serverlogik, Aufgaben, API, Berechtigungen, Admin-Erweiterung, Migrationen, Tests und paketierbarer Konfiguration. Der Schwerpunkt liegt auf klaren Modulgrenzen, Erweiterbarkeit und langfristiger Wartbarkeit.

Inhaltsübersicht

• Zielsetzung und Einordnung
• Zielgruppe und Voraussetzungen
• Modularchitektur und Erweiterungsmuster
• Datenmodell, Routen und Aufgaben
• Admin-UI und fachlicher Workflow
• Migration, Tests und Paketierung
• Praxisübungen
• Methodik

Zielsetzung

• Modularchitektur, Optionen, Erweiterung und Wiederverwendung sauber strukturieren.
• Servermethoden, Handler, Aufgaben, Routen und Berechtigungen sicher implementieren.
• Eigene Content-Typen und Admin-Komponenten zu einer vertikalen Funktion verbinden.
• Migrationen, Tests, Versionierung und technische Dokumentation auslieferungsfähig gestalten.

Zielgruppe

Erfahrene JavaScript- und Node.js-Entwickler, Softwarearchitekten, technische Leads und Erweiterungsentwickler

Voraussetzungen

Sehr gute JavaScript- und Node.js-Kenntnisse, Erfahrung mit npm, Git, HTTP und ApostropheCMS-Grundlagen zu Modulen, Schemas und Templates

Seminarinhalte

Tag 1: Modularchitektur und Erweiterungsmuster

1. Schritt 1.1: Fachgrenzen, Verantwortlichkeiten, öffentliche Schnittstellen und Abhängigkeiten definieren.
2. Schritt 1.2: Moduldateien, Optionen, Initialisierung und Erweiterung vorhandener Module strukturieren.
3. Schritt 1.3: Wiederverwendbare Konfiguration, Hilfsfunktionen und serverseitige Methoden implementieren.
4. Schritt 1.4: Lebenszyklus-Hooks und Handler gezielt einsetzen und Seiteneffekte begrenzen.
5. Schritt 1.5: Modulkonventionen, Logging und Fehlerklassen für das Projekt festlegen.

Tag 2: Datenmodell, Routen und Aufgaben

1. Schritt 2.1: Page- oder Piece-Typen mit Schemas, Beziehungen, Validierung und Berechtigungen entwickeln.
2. Schritt 2.2: Eigene API-Routen mit Eingabeprüfung, Authentifizierung und konsistenten Responses implementieren.
3. Schritt 2.3: Kommandozeilenaufgaben für Import, Wartung oder Datenkorrektur wiederholbar aufbauen.
4. Schritt 2.4: Abfragen, Indexbedarf und Verarbeitung größerer Datenmengen analysieren.
5. Schritt 2.5: Fehler-, Wiederholungs- und Transaktionsgrenzen anhand konkreter Fälle testen.

Tag 3: Admin-UI und fachlicher Workflow

1. Schritt 3.1: Client-Modul und Vue-3-Komponente für einen fachlichen Bearbeitungsschritt anlegen.
2. Schritt 3.2: Ein eigenes Feld oder einen Dialog mit Validierung und Serverkommunikation integrieren.
3. Schritt 3.3: Rollenabhängige Aktionen, Statuswechsel und verständliche Rückmeldungen umsetzen.
4. Schritt 3.4: Barrierefreiheit, Tastaturbedienung und robuste Lade- und Fehlerzustände prüfen.
5. Schritt 3.5: Den vollständigen Workflow von Eingabe über Serverlogik bis Speicherung testen.

Tag 4: Migration, Tests und Paketierung

1. Schritt 4.1: Datenmigrationen für neue Versionen entwerfen, protokollieren und wiederholbar ausführen.
2. Schritt 4.2: Unit-, Integrations-, API- und UI-nahe Tests mit kontrollierten Testdaten erstellen.
3. Schritt 4.3: Konfigurationsvarianten, Abwärtskompatibilität und Upgradepfade prüfen.
4. Schritt 4.4: README, Installationsschritte, Optionen, Sicherheitsannahmen und Betriebsdiagnose dokumentieren.
5. Schritt 4.5: Modul paketieren, versionieren, in einem zweiten Projekt installieren und zur Freigabe reviewen.

Praxisübungen

• Entwicklung eines vertikalen Fachmoduls mit Piece Type, eigener Route und Wartungsaufgabe.
• Ergänzung eines Vue-3-Dialogs mit Rollenprüfung und serverseitiger Validierung.
• Paketierung, Installation und Upgrade des Moduls in einer separaten Testanwendung.

Methodik

Vertikales Entwicklungsprojekt, Architekturentscheidungen, Live-Coding, Pair-Reviews, Testautomatisierung und Paketierungsübung.