- Introduced comprehensive SEO and marketing requirements in a new document (SEO-Marketing.md) to enhance visibility and user engagement. - Developed a strategic framework for the ongoing development of the Lara & Felix platform, focusing on digital product strategy, user experience, and marketing automation in a new document (Strategieentwicklung.md).
87 KiB
Lara & Felix – Technische Zielarchitektur für Website, CMS, SEO und Marketing
Stand: 15.11.2026
Status: Entwurf zur gemeinsamen Prüfung. Nichts hiervon ist gebaut oder erprobt. Kein Implementierungsauftrag; bestehende Dokumente, Code und Daten sind unverändert.
Schwesterdokument: docs/strategie/website-cms-seo-marketing-zielkonzept.md (im Folgenden „Zielkonzept“). Dort stehen Positionierung, Designbewertung, Informationsarchitektur, Seitentypen, Funktionsanforderungen, Roadmap und die Quellenliste (Q01 bis Q28). Dieses Dokument beschreibt die technischen Varianten, die empfohlene Lösung und die Folgen für die bestehende Architektur.
Einordnung: Ergänzt 03_Zielarchitektur.md, 04_Domaenenmodell.md und 09_CMS_Administration_Community.md, ersetzt sie nicht. Bezeichner in Diagrammen sind Arbeitstitel.
Änderungsstand: Am 15.11.2026 konsolidiert mit der Fassung nach Review von docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md (Entscheidungen E-A, E-T, E-L, E-M, E-D) und docs/analysen/umsetzungsplan-mitgliederbibliothek.md (Pakete 0 bis 9). Geändert: 4.4 und neu 4.5 (Eigen-CMS unter Vorbehalt, Editor-Prototyp), 6.2 (drei Zustände, Inhaltsart, Fassungswahl, Sichtbarkeit von Modulen), 6.4 (neue Paketnummern), Kapitel 14 (gemeinsame Reihenfolge, Einstufung der Pakete), dazu Folgestellen in 1, 6.3, 7, 8.5, 11, 12, 13 und 15.
Kennzeichnung wie im Zielkonzept: [FEST], [ENTWURF], [BELEGT], [EMPF], [ANNAHME], [OFFEN].
1. Kurzfassung
| Thema | Empfehlung |
|---|---|
| CMS | Bevorzugt, unter Vorbehalt: Das vorhandene Seitensystem wird zum Vorlagen- und Abschnittssystem ausgebaut (Variante D). Entschieden wird nach einem Editor-Prototyp mit neun Bedienaufgaben (4.5). |
| Editor | Filament-Builder mit Blockvorschau aus denselben Blade-Ansichten wie die öffentliche Seite; vorhandene Vorschauroute mit Breitenumschalter. |
| Frontend | Servergerendertes Blade, Tailwind 4 mit zweistufigen Tokens, gezieltes JavaScript. Öffentliche Seiten ohne Sitzung und zwischenspeicherbar. |
| Öffentlicher Katalog | Ein öffentliches Profil je Fachobjekt hält nur Veröffentlichungsentscheidungen. Gezeigt wird nur eine zur Anzeige freigegebene Fassung; Seitentyp und Adresse folgen der redaktionellen Inhaltsart. Inhalte werden zur Laufzeit aus den maßgeblichen Fachdaten gelesen. |
| Gemeinsame Reihenfolge | Bibliothekspakete 0 bis 9 bleiben inhaltlich unverändert. Sechs sind unverändert umsetzbar, vier hängen an gemeinsamen Komponenten, deren Vertrag vorher feststeht (Kapitel 14). |
| SEO | Adressauflösung mit Weiterleitungstabelle, Indexierungsrichtlinie je Seitentyp und Umgebung, erzeugte Sitemap, erzeugtes Markup, Prüfungen vor Veröffentlichung. |
| Marketing | Neues Modul „Marketing“ im Kern mit eigener, personenfreier Datenhaltung, Regeln, Maßnahmen und Wirkungsmessung (Variante E). |
| KI | Einzelne, protokollierte Arbeitsschritte hinter einem Modelladapter; Ergebnis ist immer ein Vorschlag oder ein Entwurf. |
| Workflow-Werkzeug | n8n nur optional und nur für fremde Kanäle, mit eng begrenztem Zugang. |
| Reichweitenmessung | Eigenzählung ohne Cookies; selbst betriebenes Werkzeug als Ausbauweg. |
2. Ausgangslage im Code [BELEGT]
Gesichtet wurden die für die Entscheidung nötigen Stellen, kein vollständiger Audit.
| Bereich | Befund | Fundstelle |
|---|---|---|
| Stapel | Laravel 13, Filament 5, PHP 8.4, Tailwind 4, Vite 8, PHPUnit | composer.json, package.json |
| Seiten | pages (eindeutiger Pfad, Zeiger auf veröffentlichte Revision), page_revisions (Bausteine als JSON, SEO-Titel, SEO-Beschreibung, Bearbeiter), navigation_items (Kopf- und Fußbereich) |
database/migrations/2026_11_15_100000_create_cms_tables.php |
| Bausteine | sechs Arten in einer Klasse mit Regeln je Art; Bildpfade nur aus dem öffentlichen Bereich cms/; Linkprüfung |
app/Domain/Cms/Blocks/BlockRegistry.php |
| Redaktion | Speichern erzeugt Revision, Veröffentlichung setzt den Zeiger, Wiederherstellung erzeugt neue Revision, Vorschau für Personal | app/Domain/Cms/PageService.php, PageController::preview |
| Routen | feste Routen für Start, Sitemap, Themen, Medien, Anmeldung, Mitgliederbereich; Auffangroute für Seiten mit einem Pfadteil | routes/web.php |
| Themen | veröffentlichte Säulen als /themen und /themen/{slug} mit zugeordneten Seiten |
ThemeController, Migration publish_pillars_to_the_site |
| Kopfbereich | Titel, Beschreibung, kanonische Adresse; keine Social-Angaben, kein strukturiertes Markup; Navigation unterscheidet angemeldet und nicht angemeldet | resources/views/layouts/site.blade.php |
| Sitemap | Seiten und Themen, ohne Änderungsdatum | resources/views/public/sitemap.blade.php |
robots.txt |
statische Datei, erlaubt alles | public/robots.txt |
| Gestaltung | eigenes Stylesheet mit fünf Farbwerten, Source Sans 3 und Source Serif 4 | resources/css/app.css |
| Öffentliche Medien | Auftrag zum Veröffentlichen öffentlicher Medien vorhanden | app/Jobs/PublishPublicMedia.php |
Nicht geprüft: Format und Bereinigung des Fließtexts; Erzeugung von Bildgrößen; Stand der Trennung der drei Herkunftsadressen aus 03, Abschnitt 6; Schutz der Testinstanz am Reverse Proxy; ob öffentliche Routen eine Sitzung öffnen.
Bewertung: Der in 10, Abschnitt 2.1 als Hauptrisiko benannte Teil (Entwurf, Vorschau, Revision, Wiederherstellung für Seiten) besteht. Es fehlen Struktur (Seitentypen, Unterpfade, Vorlagen), Gestaltungsspielraum (Varianten), Katalogbezug und die SEO-Mechanik.
3. Architekturtreiber, Kriterien und Gewichtung
3.1 Treiber
| Treiber | Herkunft |
|---|---|
| Redaktionelle Änderungen ohne Entwickler und ohne Release | WEB-001 [FEST] |
| Keine widersprüchlichen, mehrfach gepflegten Datenbestände | WEB-004 [FEST] |
| Eine Verwaltung, eine Anmeldung, getrennte Herkunftsadressen | 09, B.1, C.8 [ENTWURF] |
| Unveränderliche Fassungen, eine Stelle entscheidet über Zugriff | 03, Abschnitt 8 [FEST] |
| Web-Prozess ohne Schreibrecht auf Medien, ohne Zugriff auf Originale | Projektregel [FEST] |
| Betrieb durch eine Person auf einem Server | VIS-006 [FEST] |
| Migrationen abwärtskompatibel; Deployments nur über Workflows | Projektregel [FEST] |
| Tests ohne Netzwerkaufrufe; nie gegen Produktion | Projektregel [FEST] |
3.2 Kriterien und Gewichte [EMPF, eigene Gewichtung]
| Kriterium | Gewicht | Begründung |
|---|---|---|
| Fachlicher Nutzen | 15 | Beitrag zur Darstellung des Trainingskonzepts |
| Konfigurierbarkeit | 15 | Kernforderung des Auftrags |
| UX-Qualität | 10 | Besucher, Mitglieder, Redaktion |
| Entwicklungsaufwand | 10 | einmalig, durch Agenten gut leistbar; deshalb nicht höher |
| Betriebskosten | 5 | Unterschiede zwischen den Varianten sind klein |
| Wartbarkeit | 15 | ein Betreiber über Jahre |
| Integrationsfähigkeit | 15 | Katalog, Lizenzen, Rollen, Audit |
| Sicherheit | 5 | Grundniveau ist in allen Varianten erreichbar; Unterschiede in der Angriffsfläche |
| Erweiterbarkeit | 5 | weitere Linien und Zielgruppen |
| Migrationsrisiko | 5 | geringe Bestandsmenge |
Bewertung von 1 (schwach) bis 5 (stark); bei Aufwand, Kosten und Risiko bedeutet 5 „gering“.
4. CMS-Varianten und Bewertung
4.1 Untersuchte Varianten
| Variante | Beschreibung | Belegte Eckdaten |
|---|---|---|
| A – Eigenes Seitensystem linear erweitern | weitere Bausteine und Felder im heutigen Aufbau | Bestand, Kapitel 2 |
| B1 – Statamic im selben Laravel | Laravel-CMS mit eigener Verwaltung, Inhalte als Dateien oder in der Datenbank | Version 6.42 vom 13.11.2026, verlangt Laravel 12.40 oder 13, Lizenzangabe „proprietary“ (Q14); Pro 349 USD je Site, danach 99 USD jährlich; Pro bringt mehrere Nutzer, Rollen, Revisionen, Schnittstellen (Q13) |
| B2 – freier Page Builder als Filament-Plugin | Zeilen-, Spalten- oder Canvas-Editor in der vorhandenen Verwaltung | mehrere Pakete für Filament 5, etwa Layup mit Zeilen und Spalten (Q12) und GrapesJS-Einbindungen; alle jung |
| B3 – Twill | Laravel-CMS mit Blockeditor und eigener Verwaltung | Version 3.6 vom 19.07.2026, Laravel 9 bis 13, Apache-2.0 (Q15) |
| C1 – Headless-Dienst mit visuellem Editor | Inhalte beim Dienst, Darstellung durch Laravel über Schnittstelle | Storyblok: kostenlos für einen Platz, 99 USD monatlich für fünf Plätze (Q16) |
| C2 – Payload mit eigenem Frontend | Node-CMS innerhalb von Next.js | MIT, „Next.js native“ (Q17); in 10 bereits nicht empfohlen |
| D – Hybrid: Eigenkern mit Vorlagen, Varianten, Katalogbausteinen, Vorschau-Editor | Ausbau des Bestands; Filament-Bordmittel für die Bearbeitung | Filament-Builder mit Blockvorschau aus Blade-Ansichten, auch interaktiv (Q08); eigene Blöcke im Texteditor (Q09); Vorschau-Plugin für Filament 5 verfügbar (Q10); Blockeditor-Feld Mason für Filament 4 und 5, MIT (Q11) |
WordPress mit Erweiterungen und reine Headless-Dienste ohne visuellen Editor (Directus, Strapi) sind in 10, Abschnitt 2 bewertet und verworfen; die Gründe gelten fort.
4.2 Entscheidungsmatrix
| Kriterium | Gewicht | A | B1 | B2 | B3 | C1 | C2 | D |
|---|---|---|---|---|---|---|---|---|
| Fachlicher Nutzen | 15 | 4 | 4 | 3 | 4 | 3 | 3 | 5 |
| Konfigurierbarkeit | 15 | 3 | 5 | 5 | 4 | 5 | 4 | 4 |
| UX-Qualität | 10 | 3 | 4 | 3 | 4 | 5 | 4 | 4 |
| Entwicklungsaufwand | 10 | 3 | 3 | 4 | 3 | 2 | 1 | 3 |
| Betriebskosten | 5 | 5 | 4 | 5 | 5 | 3 | 3 | 5 |
| Wartbarkeit | 15 | 4 | 3 | 2 | 3 | 3 | 2 | 4 |
| Integrationsfähigkeit | 15 | 5 | 3 | 3 | 3 | 2 | 2 | 5 |
| Sicherheit | 5 | 5 | 3 | 3 | 3 | 3 | 3 | 5 |
| Erweiterbarkeit | 5 | 4 | 4 | 3 | 4 | 4 | 4 | 4 |
| Migrationsrisiko | 5 | 5 | 3 | 3 | 3 | 2 | 1 | 5 |
| Gewichtet (von 5) | 3,95 | 3,65 | 3,35 | 3,55 | 3,25 | 2,70 | 4,35 |
Empfindlichkeit: Wird Konfigurierbarkeit auf 30 und UX auf 20 angehoben (zulasten von Nutzen, Wartbarkeit und Integration), liegt D bei 4,20, Statamic bei 4,00, der Headless-Dienst bei 3,85. Die Reihenfolge bleibt, der Abstand schrumpft. Die Empfehlung hängt also daran, dass Integration und Wartbarkeit für dieses Vorhaben mindestens so wichtig sind wie Bearbeitungskomfort.
4.3 Begründung der Bewertungen
| Variante | Entscheidende Vorteile | Nachteile und Risiken |
|---|---|---|
| A | kein neues Teil; volle Integration | ohne Vorlagen und Varianten entsteht für jede neue Seitenform ein Auftrag; verfehlt die Konfigurierbarkeit |
| B1 Statamic | ausgereifte Redaktion mit Live-Vorschau, Revisionen, Blueprints | zweite Verwaltung neben Filament mit eigenem Nutzer- und Rechtemodell; widerspricht „eine Verwaltung“ und der Trennung von Alltags- und Systemkonto; Katalogbausteine wären eigene Feldtypen und damit dieselbe Eigenentwicklung; proprietäre Lizenz |
| B2 freier Builder | sofort sehr hohe Freiheit | genau die im Zielkonzept, 10.4 ausgeschlossenen Folgen (uneinheitlich, nicht prüfbar barrierearm); junge Pakete mit ungewisser Pflege; Inhalte im Format des Pakets |
| B3 Twill | bewährter Blockeditor | zweite Verwaltung wie B1; eigene Medienbibliothek; Katalogbezug Eigenbau |
| C1 Headless-Dienst | beste visuelle Bearbeitung | Inhalte außerhalb des Kerns; Katalogdaten müssten kopiert oder bei jedem Aufruf zusammengeführt werden (verletzt WEB-004 oder kostet Laufzeit und Verfügbarkeit); laufende Kosten; weiterer Auftragsverarbeiter |
| C2 Payload | moderne Redaktion | dritter Stapel (Node), zweite Darstellungsschicht, höchster Aufwand und höchstes Risiko |
| D Hybrid | Katalogbausteine ohne Datenkopie; eine Verwaltung, ein Rollen- und Auditmodell; baut auf Erprobtem auf; schrittweise lieferbar | Eigenentwicklung bleibt Pflegeaufwand; Bearbeitungskomfort unter dem eines Spezialprodukts; Disziplin bei Varianten nötig |
4.4 Empfehlung unter Vorbehalt und Wechselkriterien
[EMPF] Variante D ist die bevorzugte Variante unter Vorbehalt. Die Matrix bewertet Bearbeitungskomfort und Aufwand von D nach Dokumentation, nicht nach Erprobung. Entschieden wird nach dem Editor-Prototyp aus 4.5. Bis dahin beginnt kein Paket der Stufe W2.
Wann eine Alternative vorzuziehen wäre:
- Mason als Editorfläche innerhalb von D, wenn der Prototyp an der Bedienung über Formular und Vorschau scheitert, die Technik aber trägt. Der Bausteinvertrag aus 5.3 ist so gewählt, dass die Editorfläche austauschbar bleibt.
- B1 (Statamic), wenn auch die zweite Runde scheitert, oder wenn mehrere nichttechnische Redakteure täglich arbeiten und die Marketingseiten kaum Katalogbezug haben.
- C1 (Headless-Dienst), wenn eine Agentur die Marketingseiten gestaltet und betreibt.
Rückweg: Bausteindaten sind strukturiertes JSON mit festem Vertrag und lassen sich in jedes blockorientierte System überführen. Die Entscheidung bindet nicht dauerhaft.
4.5 Editor-Prototyp als Entscheidungskriterium
Zweck: nachweisen, dass der Betreiber mit Filament-Bordmitteln alltägliche Seitenarbeit ohne Hilfe erledigt, und dass Editor und öffentliche Darstellung dieselben Ansichten und dieselben Daten verwenden.
Rahmen:
| Bauzeit | höchstens drei Arbeitstage; Erprobung ein halber Tag |
| Art | Wegwerfcode auf einem Feature-Branch; lokal oder auf der Testinstanz erprobt; nie Produktion |
| Datenbank | keine Migration. Der Prototyp arbeitet auf den vorhandenen Tabellen pages und page_revisions. |
| Gestaltung | vorhandenes Stylesheet; kein Designsystem |
| Berührte Dateien | nur Seiteneditor, Bausteinregister und Bausteinansichten; keine Mitgliedsansichten, keine Kataloglogik |
| Verhältnis zur Bibliothek | unabhängig von den Paketen 0 bis 9; kann parallel zu Paket 1 und 2 laufen |
Umfang:
| Teil | Im Prototyp |
|---|---|
| Bausteine | vier Arten: Heldenbereich mit zwei Varianten; Bild und Text mit zwei Varianten; FAQ aus dem Bestand; Programmkarten als Katalogbaustein |
| Katalogbaustein | wählt zwei vorhandene Kompositionen über ein Suchfeld und zeigt deren gespeicherte Bezeichnung; speichert nur Kennungen |
| Bearbeitung | Filament-Builder mit Blockvorschau aus den öffentlichen Blade-Ansichten |
| Ganzseitige Vorschau | vorhandene Vorschauroute mit Umschalter für 390, 768 und 1440 px |
| Vorlage | eine vorhandene Seite wird dupliziert |
| Globaler Abschnitt | eine eigene Seite, deren Bausteine über einen Verweis-Baustein eingebunden werden |
| Nicht enthalten | Seitentypen, Schemaversion, Medienbibliothek, Prüfungen, Zeitsteuerung, öffentliches Profil |
Bedienaufgaben. Der Betreiber löst sie allein, nach einer Einweisung von höchstens zehn Minuten, ohne Rückfrage. Gemessen wird mit der Uhr; eine zweite Person notiert Stockungen.
| Nr. | Aufgabe | Zeitgrenze | Bestanden, wenn |
|---|---|---|---|
| T1 | Neue Landingpage aus der Vorlage anlegen, drei Texte ändern, veröffentlichen | 10 min | die Seite ist unter eigener Adresse öffentlich und die Vorlage unverändert |
| T2 | Abschnitt „Bild und Text“ hinzufügen, Bild wählen, Alternativtext setzen, Variante wechseln | 3 min | die Blockvorschau zeigt die gewählte Variante ohne Speichern |
| T3 | Zwei Abschnitte umsortieren, einen duplizieren | 1 min | die Reihenfolge stimmt in der ganzseitigen Vorschau |
| T4 | Programmkarten: zwei Programme auswählen und ihre Reihenfolge tauschen | 2 min | die Karten zeigen die Bezeichnungen aus den Fachdaten; kein Titel wurde getippt |
| T5 | In der Vorschau bei 390 px einen zu langen Titel erkennen und beheben | 3 min | der Fehler wird ohne Hinweis gefunden und in derselben Sitzung korrigiert |
| T6 | Globalen Abschnitt ändern | 3 min | die Änderung erscheint nach Veröffentlichung auf beiden einbindenden Seiten |
| T7 | Frühere Revision wiederherstellen | 1 min | die Live-Seite zeigt den früheren Stand |
| T8 | Seite mit zwanzig Abschnitten öffnen, einen Text ändern, speichern | je Vorgang 3 s auf der Testinstanz | keine verlorene Eingabe, kein Abbruch |
| T9 | Pflichtfeld leer lassen und speichern | 30 s bis zum Auffinden | die Meldung steht am betroffenen Abschnitt |
Technische Kriterien:
| Nr. | Kriterium |
|---|---|
| K1 | Blockvorschau und öffentliche Seite verwenden je Baustein dieselbe Blade-Ansicht; es gibt keinen doppelten Darstellungscode. |
| K2 | Die vom Editor gespeicherten Daten entsprechen der Hülle aus 5.3 und werden von der öffentlichen Darstellung unverändert gelesen. |
| K3 | Vorhandene Seiten mit den sechs Bestandsbausteinen bleiben bearbeitbar und werden unverändert dargestellt. |
| K4 | Kein zusätzliches Paket ist nötig, oder es ist genau eines benannt und begründet. |
| K5 | Die Bauzeit von drei Tagen wird eingehalten. |
Entscheidungsregel:
| Ergebnis | Folge |
|---|---|
| T1, T4 und T8 bestanden, insgesamt mindestens acht von neun Aufgaben, K1 bis K5 erfüllt, und der Betreiber bejaht „so würde ich wöchentlich arbeiten“ | Der Vorbehalt entfällt. ADR-28 wird Entscheidung; W2 beginnt. |
| K1 bis K3 erfüllt, aber T2, T3 oder T5 scheitern an der Bedienung | Zweite Runde von höchstens zwei Tagen mit Mason als Editorfläche auf demselben Bausteinvertrag, dieselben neun Aufgaben. |
| Zweite Runde scheitert, oder K1, K2 oder K5 sind verfehlt | Gegenprobe mit Statamic an denselben neun Aufgaben, bevor W2 beginnt. Katalogbausteine und öffentliches Profil (Kapitel 6) bleiben davon unberührt; sie wären in jeder Variante Eigenentwicklung. |
Das Ergebnis wird mit Zeiten je Aufgabe und den beobachteten Stockungen festgehalten. Der Prototyp-Code wird nicht übernommen; W2 baut auf dem Vertrag, nicht auf dem Wegwerfcode.
5. Empfohlene CMS- und Frontend-Architektur
5.1 Bausteinsicht
flowchart TB
subgraph Verw["Verwaltung (Filament)"]
ED["Seiteneditor: Builder, Vorschau"]
VL["Vorlagen und globale Abschnitte"]
MB["Medienbibliothek Website"]
OP["Öffentliche Profile"]
PR["Prüfungen vor Veröffentlichung"]
end
subgraph Web["Modul Web und CMS"]
PG["Seiten, Revisionen, Weiterleitungen"]
BR["Bausteinregister"]
RS["Adressauflösung"]
RD["Darstellung: Blade-Komponenten, Tokens"]
SE["SEO-Dienste: Sitemap, Markup, Kopfangaben"]
PC["Lesesicht Öffentlicher Katalog"]
end
subgraph Fach["Fachmodule (unverändert)"]
INH["Inhalte und Versionen"]
KAT["Katalog"]
VER["Veröffentlichung"]
end
ED --> PG
VL --> PG
OP --> PC
PR --> PG
RS --> PG
RS --> PC
RD --> BR
BR --> PC
PC -->|"nur lesen"| INH
PC -->|"nur lesen"| KAT
PC -->|"nur lesen"| VER
SE --> PG
SE --> PC
Die Leserichtung bleibt wie in 03, Abschnitt 3: Web und CMS darf Katalog und Veröffentlichung aufrufen; Inhalte und Katalog kennen das CMS nicht.
5.2 Datenmodell des Seitensystems
erDiagram
PAGE ||--o{ PAGE_REVISION : "hat Revisionen"
PAGE ||--o{ REDIRECT : "frühere Pfade"
PAGE }o--o| TOPIC_CLUSTER : "gehört zu"
PAGE_REVISION }o--o{ SHARED_SECTION : "bindet ein, per Verweis"
SHARED_SECTION ||--o{ SHARED_SECTION_REVISION : "hat Revisionen"
PAGE_REVISION }o--o{ WEB_MEDIA : "verwendet"
PAGE }o--o| PUBLIC_LISTING : "Rahmen für Objektseite"
PAGE {
id id PK
string path "mehrteilig, eindeutig"
string type "standard, thema, landing, beitrag, hilfe, recht, kampagne"
string status "entwurf, veroeffentlicht, zurueckgezogen, archiviert"
bool is_template "nie routbar"
id published_revision_id
id scheduled_revision_id
datetime scheduled_at
}
PAGE_REVISION {
id id PK
json blocks "Bausteinvertrag 5.3"
string seo_title
string seo_description
string robots "richtlinie, index, noindex"
string canonical_override
id social_image_id
id author_id "bei Beitrag"
id reviewed_by
date content_date "Stand"
json sources "Quellenliste"
string origin "mensch, ki"
id ai_run_id
}
REDIRECT {
string from_path PK
string to_path
int status "301 oder 410"
string cause "automatisch, manuell"
}
SHARED_SECTION {
id id PK
string key
id published_revision_id
}
WEB_MEDIA {
id id PK
string path "öffentlicher Bereich"
string alt
bool decorative
json focal_point
string release_status "Asset-Katalog"
string source_note
}
Regeln:
- Vorlage = Seite mit Kennzeichen. Sie nutzt Editor, Revision und Vorschau und ist nie routbar. „Seite aus Vorlage“ kopiert die veröffentlichte Revision der Vorlage in eine neue Seite. Spätere Änderungen der Vorlage wirken nicht auf bestehende Seiten.
- Globaler Abschnitt = Verweis, keine Kopie. Die Darstellung löst zur Laufzeit auf die veröffentlichte Revision des Abschnitts auf. Eine ältere Seitenrevision zeigt deshalb den heutigen globalen Abschnitt. Das ist zulässig, weil Seitenrevisionen Bearbeitungshilfe und kein Vertragsbestandteil sind (
04, 5.1). - SEO-Felder bleiben an der Revision und sind damit versioniert und gemeinsam mit dem Inhalt veröffentlichbar (
seo-prinzipien, §5). - Zeitsteuerung: Ein geplanter Zeiger und ein Zeitpunkt an der Seite; die vorhandene Zeitsteuerung des Frameworks setzt den Zeiger. Kein eigener Mechanismus.
- Zurückziehen setzt den Status und trägt den Pfad mit Status 410 in die Weiterleitungstabelle ein.
- Migration: alle Ergänzungen als neue Spalten und Tabellen mit Vorgabewerten. Bestehende Seiten erhalten Typ „standard“.
5.3 Bausteinvertrag
Jeder Baustein in blocks hat dieselbe Hülle:
| Feld | Bedeutung |
|---|---|
id |
stabile Kennung, bleibt über Revisionen erhalten; dient als Sprungmarke und als Quelle für Aufrufzählung |
type |
Bausteinart aus dem Register |
v |
Schemaversion der Art |
variant |
benannte Variante der Art |
settings |
Aufzählungswerte: Flächenton, Breite, Abstand, Themenakzent |
data |
redaktionelle Inhalte |
refs |
Verweise auf Fachobjekte oder Medien, nur Kennungen |
Jede Bausteinart ist eine Klasse mit: Formularschema für die Verwaltung, Prüfregeln, Liste der Varianten, Blade-Ansicht, Funktion zum Auflösen der Verweise, Funktion „Links und Medien dieses Bausteins“ (für Prüfungen und Verwendungsnachweis) und optional einem Beitrag zum strukturierten Markup.
Schemaversion statt Datenmigration: Ändert sich das Schema einer Art, hebt eine Aufwärtsfunktion ältere Daten beim Lesen an. Alte Revisionen bleiben unangetastet. Die sechs vorhandenen Arten werden als Version 1 übernommen.
Katalogbausteine speichern ausschließlich Verweise und Anzeigeoptionen. Ist ein verwiesenes Objekt nicht öffentlich, stellt der Baustein nichts dar und die Prüfung meldet es; der Besucher sieht keinen Fehler.
Grenze: Kein Baustein nimmt freies HTML oder Skripte an. Fließtext wird beim Speichern bereinigt.
5.4 Editor und Vorschau
| Teil | Lösung | Beleg |
|---|---|---|
| Bearbeitung | Filament-Builder: Blöcke in Gruppen, Suche, Duplizieren, Sortieren, Einklappen | Q08 |
| Vorschau im Formular | blockPreviews() rendert je Block die Blade-Ansicht mit den Blockdaten; es ist dieselbe Ansicht wie öffentlich |
Q08 |
| Ganzseitige Vorschau | vorhandene Route für Revisionen, ergänzt um einen Rahmen mit drei Breiten (390, 768, 1440 px) | Bestand |
| Vorschau vor dem Speichern | optional über das Vorschau-Plugin | Q10 |
| Text innerhalb von Bausteinen | Filament-Texteditor mit eingeschränkter Werkzeugleiste | Q09 |
| Schutz großer Seiten | Obergrenze je Seite über maxItemsForProcessing() |
Q08 |
Die Auswahl der Fachobjekte in Katalogbausteinen erfolgt über Suchfelder, die nur öffentlich geschaltete Objekte anbieten.
5.5 Frontend-Stapel
| Thema | Festlegung | Begründung |
|---|---|---|
| Darstellung | Blade, servergerendert | bereits beschlossen (10, Abschnitt 2.1); crawlbar ohne JavaScript |
| Komponenten | Blade-Komponenten in zwei Familien: Grundelemente und Bausteine | Wiederverwendung in Website und Mitgliederbereich |
| Stil | Tailwind 4; Tokens als @theme-Variablen |
vorhanden |
| Tokens | eine Quelldatei im Repository mit Markenwerten und Bedeutungswerten; daraus die Variablen | Zielkonzept, 7.1; Änderungen sind selten und laufen über das Deployment |
| JavaScript | kleine Module für Navigation, Aufklappen, Filterauszug, Player | keine Einzelseiten-Anwendung |
| Livewire | nur in der Verwaltung und, wo es Bedienung spart, im Mitgliederbereich; nicht auf öffentlichen Seiten | Zwischenspeicherbarkeit |
| Schriften | lokal ausgeliefert, zwei Familien, mit font-display: swap und Vorabladen der Auszeichnungsschrift |
Datenschutz, Ladezeit |
| Bilder | abgeleitete Größen und Formate über die Hintergrundverarbeitung; srcset, feste Abmessungen, Fokuspunkt als Objektposition |
der Web-Prozess schreibt nicht in den Medienbestand |
| Symbole | eigene SVG-Familie als Sprite | Zielkonzept, Kapitel 6 |
| Druck | eigenes Druckstylesheet für Programm- und Angebotsseiten | Kurzunterlage für Institutionen |
Markenwerte in der Datenbank (Stufe 3 des Konfigurationsmodells) sind Zielbild und nicht Teil des MVP: Die Quelldatei im Repository genügt, solange sich Markenwerte seltener als einmal im Jahr ändern.
5.6 Auslieferung und Zwischenspeicher
[EMPF]
- Öffentliche Seiten werden für alle Besucher identisch gerendert. Die Kopfzeile zeigt einen neutralen Eintrag „Anmelden“ beziehungsweise „Mein Bereich“, der zum Mitgliederbereich führt; die heutige Unterscheidung im Layout entfällt.
- Öffentliche Routen laufen ohne Sitzung. Formulare (Anfrage, Newsletter) liegen auf eigenen Routen mit Mengenbegrenzung und Schutzfeld.
- Die fertige Antwort wird in der Anwendung zwischengespeichert, mit dem vorhandenen Speicher (Datei oder Datenbank; kein weiterer Dienst,
10, Abschnitt 3). - Entwertet wird ereignisgesteuert: Seite veröffentlicht oder zurückgezogen, globaler Abschnitt veröffentlicht, öffentliches Profil geändert, Artikel-Stand veröffentlicht oder zurückgezogen, Angebotsfassung aktiviert oder beendet, Säule geändert. Zusätzlich eine kurze Höchstdauer als Sicherheitsnetz.
- Angemeldete Bereiche werden nie zwischengespeichert (
09, A.6).
Zielkonflikt: Ereignisgesteuerte Entwertung ist fehleranfällig. Ausweg für den Start: gesamten Seitenspeicher bei jedem der genannten Ereignisse leeren. Bei dieser Seitengröße ist das unkritisch.
6. Öffentlicher Katalog
6.1 Fünf Datenklassen und ihre Hoheit
| Klasse | Beispiele | Führend | Änderungsweg | Öffentlich sichtbar durch |
|---|---|---|---|---|
| 1 Fachliche Inhaltsdaten | Medium, Fassung, Datei, Lehrtext | Inhalte und Versionen | neue Fassung | nie die Datei; nur freigegebene Vorschau |
| 2 Didaktische Kompositionen | Modul, Programm, Reihenfolge, Rollen, Lernziele | Inhalte und Versionen | neue Kompositionsfassung | öffentliches Profil |
| 3 Kommerzielle Daten | Artikel, Paket, Angebotsfassung, Rechte, Preis | Katalog, Veröffentlichung | neue Fassung, neuer Stand | Angebotsseite und Angebotsbausteine |
| 4 Redaktionelle Präsentation | Seiten, Bausteine, Vorlagen, Navigation, SEO-Felder, öffentliche Profile | Web und CMS | Revision, Veröffentlichung | selbst |
| 5 Marketing- und Analysedaten | Suchwerte, Zählwerte, Befunde, Maßnahmen, KI-Läufe | Marketing (neu) | Abruf, Regeln, Entscheidungen | nie |
Zusätzlich die aktuellen Anzeigedaten der Klasse A aus produktkonfiguration, §4 (Titel, Kurzbeschreibung, Vorschaubild, Dimensionen): Sie liegen an der stabilen Identität und gelten für Bibliothek und Website. Es gibt keinen zweiten öffentlichen Titel.
Keine Kopien: Klasse 4 speichert Verweise auf Klasse 2 und 3, nie deren Inhalte. Klasse 5 speichert Adressen und verdichtete Zahlen, keine Konten.
6.2 Drei Zustände und das öffentliche Profil
Der Ist-Soll-Abgleich der Bibliothek trennt technische Bereitschaft und Anzeigefreigabe (Entscheidung E-A) und verweist die öffentliche Vorstellung von Programmen an dieses Konzept. Daraus ergeben sich drei aufeinander aufbauende Zustände.
| Zustand | Ebene | Bedeutung | Herkunft | Wirkung |
|---|---|---|---|---|
| technisch bereit | Inhalts- oder Kompositionsfassung | vollständig, unveränderlich, nicht gesperrt | Bestand | als Baustein und als Wurzel eines Artikel-Stands wählbar; für sich nirgends sichtbar |
| zur Anzeige freigegeben | genau eine Kompositionsfassung | redaktionelle Freigabe für Mitglieder; ändert keine Mitglieder, legt keinen Artikel an | E-A, Paket 3 [FEST] | Struktur erscheint in der Bibliothek berechtigter Personen und in der redaktionellen Vorschau |
| öffentlich gelistet | Identität mit einer gezeigten Fassung | öffentliche Objektseite | dieses Konzept, Stufe W3 [EMPF] | Objektseite, Katalogbausteine, Sitemap |
Davon unabhängig bleibt die kommerzielle Veröffentlichung im Artikel-Stand. Sie entscheidet, ob ein Blatt ausgeliefert und ob etwas gekauft werden kann, nicht ob eine Struktur gezeigt wird.
Regeln [EMPF]:
- Teilmenge. Öffentlich gezeigt wird nur eine Fassung, die zur Anzeige freigegeben ist. Eine nur bereite Fassung erscheint auf keiner öffentlichen Seite, auch nicht als Bestandteil.
- Eigene Entscheidung. Die Anzeigefreigabe macht nichts öffentlich. Die Listung ist eine zweite, ausdrückliche Entscheidung an der Identität.
- Rücknahme. Die Anzeigefreigabe einer öffentlich gezeigten Fassung lässt sich erst zurücknehmen, wenn das Profil auf eine andere freigegebene Fassung zeigt oder verborgen ist.
- Eine Quelle für Titel. Anzeigetitel und Kurzbeschreibung kommen aus den Klasse-A-Feldern der Identität (Paket 4) und gelten für Bibliothek und Website.
- Keine Rückwirkung. Die Bibliothek liest das öffentliche Profil nicht. Das Profil vergibt keine Rechte und ändert keine Mitgliedersicht.
- Nachweis. Listen, Entlisten und Wechsel der gezeigten Fassung werden protokolliert.
erDiagram
PUBLIC_LISTING }o--|| SUBJECT : "zeigt ein Fachobjekt"
PUBLIC_LISTING }o--o| COMPOSITION_VERSION : "gezeigte Fassung"
COMPOSITION_VERSION ||--o| DISPLAY_RELEASE : "Anzeigefreigabe (Paket 3)"
PUBLIC_LISTING }o--o| LICENSE_ARTICLE : "führender Artikel, nur bei folgt_stand"
PUBLIC_LISTING }o--o| WEB_MEDIA : "öffentlich freigegebenes Bild"
PUBLIC_LISTING }o--o| PAGE : "redaktioneller Rahmen"
PUBLIC_LISTING {
id id PK
string subject_type "saeule, komposition, inhaltselement, angebot"
uuid subject_id
string slug "eindeutig je Seitentyp"
string status "verborgen, gelistet"
string version_mode "folgt_stand, fest"
uuid shown_version_id "muss zur Anzeige freigegeben sein"
string robots "richtlinie, index, noindex"
string seo_title "optional, sonst aus Klasse A"
string seo_description
datetime listed_at
}
Das Profil enthält nur Veröffentlichungsentscheidungen: sichtbar oder nicht, Adresse, gezeigte Fassung, öffentlich freigegebenes Bild, SEO-Überschreibung, optional eine redaktionelle Rahmenseite. Die vorhandene Veröffentlichung der Säulen als Themen ist der erste Fall dieses Musters.
Inhaltsart bestimmt Seitentyp und Adresse
[FEST] Technische Struktur (CompositionKind mit kurs, uebung, kombination) und redaktionelle Inhaltsart sind getrennt. Programm, Modul, Merkblatt und Traineranleitung sind Werte der konfigurierbaren Inhaltsart mit stabiler Kennung; sie werden je Identität ausdrücklich gesetzt (Entscheidung E-T, Paket 2).
[EMPF] Für die Website folgt daraus:
- Öffentlich gelistet werden kann nur eine Identität mit gesetzter Inhaltsart. Die technische Bezeichnung des Strukturtyps erscheint öffentlich nie.
- Eine Zuordnungstabelle verbindet die stabile Kennung der Inhaltsart mit Seitentyp und Adresspräfix:
programm→/programme,modul→/module. Alle übrigen Werte und einzelne Medien können nur als Materialbeispiel unter/beispieleerscheinen. - Ein neuer Wert der Inhaltsart braucht keine Codeänderung, um in Strukturen und Filtern zu erscheinen. Eine eigene öffentliche Seitenart erhält er erst durch einen Eintrag in der Zuordnung (Konfigurationsstufe 3) und, falls die Darstellung abweicht, durch Entwicklung.
- Wird die Inhaltsart eines gelisteten Objekts geändert, wechselt seine Adresse; die Weiterleitung entsteht wie bei jeder Pfadänderung.
Welche Fassung zeigt die öffentliche Seite
Es wird immer genau eine Fassung gezeigt.
| Fall | Merkmal | Modus | Gezeigte Fassung | Bei Abweichung |
|---|---|---|---|---|
| A – Programm ist Wurzel eines Lizenzartikels | ein Artikel, dessen Stand die Komposition als Wurzel fixiert, ist als führend benannt | folgt_stand |
Wurzelfassung des aktuellen veröffentlichten Stands, sofern zur Anzeige freigegeben; andernfalls bleibt die bisher gezeigte Fassung stehen | Befund „neuer Stand ohne Anzeigefreigabe“ |
| B – Programm nur über mehrere Artikel abgedeckt | kein Artikel-Stand hat eine Programmfassung als Wurzel; die Module sind eigene Artikel | fest |
von der Redaktion bestätigte Fassung. Vorschlag des Systems: die höchste zur Anzeige freigegebene Fassung | Befund, wenn eine höhere freigegebene Fassung existiert oder die Abdeckung der gezeigten Fassung sinkt |
| C – beides | führender Programm-Artikel und zusätzlich Einzelartikel für Module | folgt_stand |
wie A | wie A; Einzelangebote erscheinen als „deckt teilweise“ |
| D – noch nicht verkauft | kein Stand, kein aktives Angebot | fest |
bestätigte freigegebene Fassung; die Seite hat keinen Angebotsbereich | — |
Begründung für Fall B. Ohne Programm-Wurzel gibt es keinen Stand, dem die Seite folgen könnte. Eine neu freigegebene Programmfassung kann Kindesfassungen nennen, die noch in keinem veröffentlichten Stand der Modul-Artikel liegen; die Seite würde dann Inhalte beschreiben, die kein Angebot liefert. Deshalb bestätigt die Redaktion die Fassung, und der Abdeckungsbefund (Paket 7) wird gegen genau diese Fassung gerechnet.
Übereinstimmung mit der Bibliothek. Nach E-A sieht ein Mitglied mit Programm-Artikel die Wurzelfassung seines berechtigten aktuellen Stands, ein Mitglied mit einzelnen Modul-Artikeln die höchste zur Anzeige freigegebene Programmfassung mit mindestens einem berechtigten Blatt. Im Fall A ist das dieselbe Fassung wie öffentlich. Im Fall B ist es dieselbe, solange die Redaktion dem Vorschlag folgt; andernfalls weist der Befund darauf hin.
Abdeckung je Angebot. Für jedes Blatt der gezeigten Fassung gilt: gedeckt, wenn genau diese Inhaltsfassung im aktuellen veröffentlichten Stand eines Artikels liegt, der zum aufgelösten Umfang der aktiven Angebotsfassung gehört. Daraus folgt je Angebot „deckt vollständig“, „deckt teilweise“ oder „deckt nicht“; nicht gedeckte Blätter werden als „nicht enthalten“ ausgewiesen. Gelesen wird je Angebot genau eine aktive Fassung, bei Dubletten die höchste aktive Nummer (Paket 1).
Sichtbarkeit enthaltener Module und Materialien
| Gegenstand | Auf der Programmseite | Eigene öffentliche Seite |
|---|---|---|
| Modul oder andere enthaltene Komposition | erscheint an ihrer Position als Strukturzeile mit Anzeigetitel, Inhaltsart, Rolle der Verwendung sowie Zahl und Art der enthaltenen Materialien. Das gehört zur freigegebenen Programmstruktur und braucht keine eigene Freigabe des Moduls. | nur mit eigenem Profil. Voraussetzung ist eine eigene Anzeigefreigabe einer Modulfassung (E-A) und eine gesetzte Inhaltsart. |
| Verlinkung Programm → Modul | nur, wenn die öffentlich gezeigte Modulfassung dieselbe ist wie die in der gezeigten Programmfassung fixierte Kindesfassung | andernfalls Zeile ohne Link und Befund „Modulseite zeigt andere Fassung als das Programm“ |
| Film, Dokument, Übungstext | Zeile mit Anzeigetitel, Inhaltsart und Rolle | nur als Materialbeispiel mit ausdrücklicher öffentlicher Freigabe; nie die Datei |
| Enthaltenes Element ohne Inhaltsart | Zeile mit Anzeigetitel und Rolle, ohne Typangabe; Warnung in den Prüfungen | keine |
Die Verlinkungsregel verhindert, dass eine Modulseite Lernziele einer neueren Fassung beschreibt, während das verlinkende Programm eine ältere enthält und liefert. Der Abschnitt „Enthalten in“ der Modulseite nennt nur öffentlich gelistete Programme, deren gezeigte Fassung dieses Modul enthält.
Was die öffentliche Seite liest
Klasse-A-Daten der Identität; die Inhaltsart; aus der gezeigten Fassung Reihenfolge, Rollen und Verschachtelung; Zahl und Art der Materialien. Nie: Dateien, Lehrtexte, Trainerfragen, Abrufadressen.
Lücke: Lernziele, Zeit- und Materialbedarf haben heute keine Felder (Ist-Soll-Abgleich, C-03) und sind in keinem Bibliothekspaket vorgesehen. Sie sind nach produktkonfiguration, §4 Lehrinhalt der Klasse B und gehören an die Kompositionsfassung. Bis sie bestehen, zeigen Programm- und Modulseite Kurzbeschreibung und Struktur; siehe Kapitel 15, Nr. 7.
Vorschaubilder. Paket 6 erzeugt ein geschütztes Bild oder einen Platzhalter und schließt die öffentliche Verwendung ausdrücklich aus. Die öffentliche Freigabe ist ein eigener Schritt der Stufe W3: Sie übernimmt eine Ableitung des Bildes in den öffentlichen Medienbereich und trägt sie im Profil ein (Abnahmefall B04). Ohne Freigabe erscheint die Themen-Signatur.
6.3 Datenfluss einer Programmseite
sequenceDiagram
participant B as Besucher
participant R as Adressauflösung
participant C as Lesesicht Öffentlicher Katalog
participant I as Inhalte
participant K as Katalog und Veröffentlichung
participant D as Darstellung
B->>R: /programme/{slug}
R->>C: Profil zu Art und Slug
C-->>R: gelistet, Fassungsmodus
C->>K: aktueller Stand des führenden Artikels
K-->>C: fixierte Kompositionsfassung
C->>I: Anzeigefreigabe prüfen, Struktur über den Strukturleser, Inhaltsart, Klasse-A-Daten
C->>K: aktive Angebotsfassungen mit Abdeckung
C-->>D: öffentliche Sicht ohne geschützte Felder
D-->>B: HTML mit Markup und Kopfangaben
Die Lesesicht ist der einzige Weg, auf dem öffentliche Seiten Fachdaten erhalten. Sie gibt ein eigenes, schmales Datenobjekt zurück, das geschützte Felder nicht enthält. Damit ist „öffentlich zeigt nichts Geschütztes“ an einer Stelle prüfbar. Die Lesesicht nutzt den Strukturleser der Bibliothek (G1, Kapitel 14.1) und baut keinen eigenen. Das Diagramm zeigt den Modus folgt_stand; im Modus fest entfällt die Abfrage des Stands.
6.4 Bezug zu den Bibliothekspaketen 0 bis 9
Grundlage ist docs/analysen/umsetzungsplan-mitgliederbibliothek.md in der Fassung nach Review. Die gemeinsamen Komponenten G1 bis G9 sind in Kapitel 14.1 beschrieben.
| Der öffentliche Katalog braucht | Aus Paket | Gemeinsame Komponente |
|---|---|---|
| genau eine aktive Angebotsfassung je Angebot | 1 | G8 |
| Inhaltsart mit stabilen Kennungen | 2 | G3 |
| Anzeigefreigabe je Kompositionsfassung | 3 | G2 |
| Leser der freigegebenen Fassung als Baum | 3 | G1 |
| Klasse-A-Anzeigefelder mit Protokoll | 4 | G4 |
| direkte Themen an Kompositionen, Kennzeichen „abgeleitet“ | 5 | G5 |
| geschütztes Vorschaubild und Ableitungsauftrag | 6 | G6 |
| Abdeckungsbefund je Angebotsfassung | 7 | G7 |
| — | 8 | keine Abhängigkeit. Öffentliche Filmvorschauen sind eigene öffentliche Medien und nutzen die Mitgliederausgabe nicht. |
| Browser-Lauf gegen die Testinstanz | 9 | G9 |
Die Bibliothek baut nach E-D bewusst kein Designsystem, keine CMS-Bausteine und keine öffentlichen Themenseiten. Diese Teile entstehen ausschließlich in den Stufen W1 bis W3.
7. SEO-Implementierungsmechanismen
7.1 Adressauflösung
Reihenfolge je Anfrage:
- feste Anwendungsrouten (Anmeldung, Mitgliederbereich, Medien, Sitemap,
robots.txt); - Objektrouten mit festem Präfix (
/themen,/programme,/module,/angebote,/beispiele) über das öffentliche Profil; bei Kompositionen und Medien ergibt sich der Präfix aus der Inhaltsart (6.2), nicht ausCompositionKind; - Seiten über den vollständigen, mehrteiligen Pfad;
- Weiterleitungstabelle;
-
Reservierte Präfixe können nicht als Seitenpfad vergeben werden. Die heutige Auffangroute mit einem Pfadteil wird durch Schritt 3 ersetzt.
7.2 Mechanismen im Vergleich
| Aufgabe | Empfohlen | Alternative | Abwägung |
|---|---|---|---|
| Objektseiten | zur Laufzeit aus Fachdaten, zwischengespeichert | je Objekt eine CMS-Seite erzeugen | Laufzeit: immer aktuell, keine Kopie; erzeugte Seiten: frei gestaltbar, aber veralten. Der Rahmen aus 6.2 gibt die Freiheit ohne Kopie. |
| Weiterleitungen | Tabelle in der Anwendung, automatisch bei Pfadänderung in derselben Transaktion | Regeln am Reverse Proxy | Tabelle ist redaktionell pflegbar und testbar; der Proxy wird von Lars verwaltet und bleibt unberührt |
| Ketten und Schleifen | beim Speichern auflösen und ablehnen | zur Laufzeit folgen | einmal prüfen statt bei jedem Aufruf |
| Kanonische Adresse | Regel je Seitentyp, Überschreibung je Seite | nur manuell | Regel verhindert Vergessen |
| Sitemap | erzeugt, getrennt nach Seiten und Objekten, mit Änderungsdatum | Paket spatie/laravel-sitemap (Q20) |
die eigene Ansicht besteht und ist klein; ein Paket bringt hier keinen Vorteil |
| Strukturiertes Markup | Erzeuger je Seitentyp aus Daten | Eingabefeld für Markup | Eingabefeld erzeugt Widersprüche zu sichtbaren Inhalten |
| Interne Verlinkung | Bausteine aus Fachbezügen; Vorschläge für Links im Text | automatisches Verlinken von Begriffen im Text | automatische Textlinks sind unkontrolliert und wirken künstlich |
| Titel und Beschreibung | Vorbelegung aus Klasse A, Überschreibung | Erzeugung durch KI ohne Bestätigung | Vorschlag mit Bestätigung (Zielkonzept, 12.6) |
| Indexierung | Richtlinie je Typ, Überschreibung je Seite, harte Übersteuerung je Umgebung | nur je Seite | Umgebung darf nie von Redaktionsentscheidungen abhängen |
7.3 Indexierungsrichtlinie
| Ebene | Regel |
|---|---|
| Umgebung | Jede Umgebung außer Produktion sendet für alle Antworten X-Robots-Tag: noindex und liefert eine sperrende robots.txt. Das ersetzt nicht den Zugangsschutz (seo-prinzipien, §10). |
| Seitentyp | Vorgabe laut Zielkonzept, 8.2 |
| Seite oder Profil | Überschreibung „indexieren“ oder „nicht indexieren“ |
| Mindestinhalt | Objektseiten ohne Kurzbeschreibung und Struktur werden nicht indexiert, auch wenn sie gelistet sind. Lernziele kommen als Bedingung hinzu, sobald das Feld besteht (Kapitel 15, Nr. 7). |
| Ansichten | Adressen mit Filter- oder Sortierparametern nennen die Übersicht als kanonisch und stehen nicht in der Sitemap |
robots.txt wird von der Anwendung erzeugt; die statische Datei entfällt. Inhalt in Produktion: Sperre der Anwendungspfade, Verweis auf die Sitemap, je nach Entscheidung E-M2 Regeln für einzelne Crawler.
7.4 Strukturiertes Markup und Kopfangaben
| Seitentyp | Erzeugt aus | Typ |
|---|---|---|
| alle | Seitenbaum, Profil | BreadcrumbList |
| Start | Einstellungen | Organization, WebSite |
| Beitrag | Revision: Autor, Stand, Titel, Bild | Article |
| Angebot | aktive Angebotsfassung | Product mit Offer, nur bei sichtbarem Preis |
| Seiten mit öffentlicher Filmvorschau | öffentliches Medium | VideoObject |
| Programm, Modul | Profil und Fassung | optional LearningResource; kein Ergebnis in der Suche zu erwarten (Zielkonzept, 11.7) |
Social-Angaben: Titel, Beschreibung, Bild in 1200 × 630 px als eigene Ableitung, mit Markenbild als Rückfall.
Prüfung: Tests vergleichen das erzeugte Markup je Seitentyp mit erwarteten Strukturen und stellen sicher, dass jeder Wert auch sichtbar auf der Seite steht. Vor einem Start zusätzlich einmalige Sichtprüfung mit dem Prüfwerkzeug des Suchdienstes.
7.5 Prüfungen vor Veröffentlichung
| Prüfung | Wirkung |
|---|---|
| defekter interner Link, Verweis auf nicht öffentliches Objekt | blockiert |
| Bild ohne Alternativtext und ohne Kennzeichen „dekorativ“ | blockiert |
| keine oder mehrere H1; Sprung in der Überschriftenfolge | blockiert |
| Pfad kollidiert mit reserviertem Präfix oder bestehender Weiterleitung | blockiert |
| Beitrag ohne Autor, Stand, Cluster oder verlinktes Modul | blockiert |
| KI-Entwurf mit offener Markierung „Quelle nötig“ | blockiert |
| Titel oder Beschreibung fehlt oder ist doppelt vergeben | Warnung |
| Titel oder Beschreibung außerhalb sinnvoller Länge | Warnung |
| Seite ohne eingehende interne Links | Warnung |
| Social-Bild fehlt | Warnung |
| Preis oder Rechte als Text im Baustein erkannt | Warnung |
Dieselben Prüfungen laufen regelmäßig über den Bestand und speisen die Maßnahmenliste (Kapitel 8).
7.6 Zuordnung der Anforderungen
| Anforderung (Zielkonzept, 11.8) | CMS | Frontend | Deployment und Betrieb |
|---|---|---|---|
| Servergerendert | Bausteine als Blade | kein Nachladen von Inhalt per Skript | — |
| Statuscodes | Seitenstatus, Weiterleitungstabelle | Fehlerseiten | — |
| Kanonisch, Indexierung | Regeln und Felder | Kopfangaben | Umgebungsvariable steuert Übersteuerung |
Sitemap, robots.txt |
Erzeugung | — | Zugangsschutz der Testinstanz am Proxy (durch Lars) |
| Leistung | Bildableitungen, Obergrenzen je Seite | Budget je Seitentyp, Schriften, kein blockierendes Skript | Kompression und Zwischenspeicherkopf; Messung in der Suite auf der Testinstanz |
| Barrierefreiheit | Pflichtfelder, Prüfungen | geprüfte Komponenten | automatische Prüfung in der Suite auf der Testinstanz |
| PWA | — | Service Worker ohne Zugriff auf angemeldete Seiten | — |
Messung und Tests: Leistungs-, Barrierefreiheits- und Sichtprüfungen laufen als Browser-Tests gegen die Testinstanz über HTTP, nie gegen Produktion und nie mit php artisan test im Test-Container (Projektregel). Feldwerte der Web Vitals liefert die Search Console, sobald genügend Besuche vorliegen.
8. Marketing-Intelligence-Architektur
8.1 Variantenvergleich
| Kriterium | Gewicht | A im Kern | B n8n steuert | C eigenes System | D KI-Agenten | E Hybrid |
|---|---|---|---|---|---|---|
| Fachlicher Nutzen | 15 | 4 | 3 | 4 | 3 | 5 |
| Konfigurierbarkeit | 15 | 3 | 4 | 3 | 4 | 4 |
| UX-Qualität | 10 | 4 | 2 | 3 | 3 | 4 |
| Entwicklungsaufwand | 10 | 3 | 4 | 1 | 3 | 3 |
| Betriebskosten | 5 | 5 | 4 | 3 | 3 | 4 |
| Wartbarkeit | 15 | 5 | 2 | 2 | 2 | 4 |
| Integrationsfähigkeit | 15 | 5 | 2 | 3 | 3 | 5 |
| Sicherheit | 5 | 5 | 2 | 3 | 2 | 4 |
| Erweiterbarkeit | 5 | 3 | 4 | 4 | 4 | 5 |
| Migrationsrisiko | 5 | 5 | 4 | 4 | 4 | 5 |
| Gewichtet (von 5) | 4,15 | 2,95 | 2,90 | 3,05 | 4,30 |
| Ansatz | Stärken | Schwächen |
|---|---|---|
| A – im Kern | Zeitsteuerung, Warteschlange, Rollen, Audit, Tests und Sicherung sind vorhanden; Maßnahmen liegen neben den Seiten | ohne KI bleiben Sprachaufgaben liegen; Fremdkanäle sind Eigenbau |
| B – n8n als Steuerung | viele fertige Verbindungen; schnelle Änderung; menschliche Prüfung von Werkzeugaufrufen über Chat, E-Mail und Messenger (Q19); Nutzung für eigene Geschäftszwecke ist erlaubt (Q18) | Logik liegt außerhalb von Versionsverwaltung, Tests und Deploymentweg; weiteres System mit Zugangsdaten; Freigaben außerhalb der Verwaltung; Fehlerbehandlung je Ablauf von Hand |
| C – eigenes System | saubere Trennung, eigene Skalierung | weiterer Dienst, eigene Datenbank, eigene Anmeldung; für diese Größe ohne Gegenwert |
| D – KI-Agenten | flexibel bei offenen Aufgaben | nicht vorhersagbar, schwer testbar, höheres Risiko bei Schreibrechten; deterministische Abläufe lösen die meisten Aufgaben zuverlässiger |
| E – Hybrid | Daten, Regeln, Maßnahmen und Freigaben im Kern; KI als austauschbare Einzelschritte; Fremdkanäle über ein Werkzeug mit engem Zugang | zwei Mechanismen (Kern, optional n8n), die sauber getrennt bleiben müssen |
[EMPF] E, in dieser Aufteilung: Der Kern ist führend für alles, was Zahlen, Entscheidungen und Veröffentlichung betrifft. KI liefert Text. n8n verbindet, falls nötig, nach außen.
8.2 Modul „Marketing“
Neues Modul des Kerns (Ergänzung zu 03, Abschnitt 3):
| Verantwortung | Abruf und Verdichtung von Such- und Zählwerten; Themencluster; Regeln; Befunde; Maßnahmen mit Entscheidung; Wirkungsmessung; Protokoll der KI-Läufe; Berichte |
| Besitzt | Datenquelle, Tageswert Suche, Tageswert Seite, Zuordnung Anfrage → Cluster, Befund, Maßnahme, Wirkungsnotiz, KI-Lauf, Schwellenwert |
| Darf aufrufen | Web und CMS (lesend; schreibend nur „Entwurfsrevision anlegen“), Katalog und Veröffentlichung (lesend), Bestellung und Lizenzen (nur verdichtete Zählungen über eine eigene Lesesicht) |
| Wird aufgerufen von | Administration; Ereignisse „Seite veröffentlicht“, „Stand veröffentlicht“, „Angebotsfassung aktiviert“ |
| Kennt nicht | Konten, E-Mail-Adressen, Bestellungen, Berechtigungen im Einzelnen |
8.3 Datenmodell
erDiagram
DATA_SOURCE ||--o{ IMPORT_RUN : "wird abgerufen"
SEARCH_DAILY }o--|| DATA_SOURCE : "aus"
SEARCH_DAILY }o--o| TOPIC_CLUSTER : "Anfrage zugeordnet"
PAGE_DAILY }o--o| TOPIC_CLUSTER : "Seite zugeordnet"
FINDING }o--|| RULE : "ausgelöst durch"
ACTION ||--o{ FINDING : "fasst zusammen"
ACTION ||--o| EFFECT_NOTE : "Wirkung"
ACTION }o--o| AI_RUN : "Entwurf aus"
AI_RUN }o--o| PAGE_REVISION : "ergab Revision"
SEARCH_DAILY {
date day
string source "google, bing"
string url
string query
int impressions
int clicks
float position
}
PAGE_DAILY {
date day
string url
string channel "suche, direkt, verweis, kampagne, antwortdienst"
int views
int cta_clicks
int registrations
int free_claims
int purchases
}
RULE {
string key
int version
string needs "bestand, verkehr"
json thresholds
}
FINDING {
string subject "Seite oder Profil"
json evidence "Zahlen und Zeitraum"
string status "offen, erledigt, entfallen"
}
ACTION {
string kind
string impact "gemessene Größe"
string certainty "eindeutig, vermutung"
string effort "klein, mittel, gross"
string status "vorgeschlagen, geplant, in_arbeit, erledigt, verworfen"
string decision_note
date done_on
}
EFFECT_NOTE {
date before_from
date after_to
json metrics
string verdict "besser, gleich, schlechter, nicht_beurteilbar"
}
AI_RUN {
string task
string model
string prompt_version
string input_ref
int tokens_in
int tokens_out
string status "ok, abgelehnt, fehler"
}
Alle Tabellen tragen ein gemeinsames Präfix und liegen in der Kerndatenbank. Es gibt keinen Fremdschlüssel auf Konten.
8.4 Abruf der Daten
| Quelle | Adapter | Rhythmus | Besonderheit |
|---|---|---|---|
| Google Search Console | Suchanalyse je Tag, Seite, Anfrage | täglich; die letzten Tage werden jeweils neu geholt und überschrieben, weil die Werte nachlaufen [ANNAHME] | Zugang über ein Dienstkonto mit Leserecht; Grenzen laut Q06 sind für diese Größe unkritisch |
| Bing Webmaster | Suchwerte je Tag | täglich | Schnittstelle nicht in dieser Sitzung geprüft [ANNAHME] |
| KI-Berichte beider Dienste | kein Adapter; Einlesen einer exportierten Datei | monatlich, von Hand | keine belegte Schnittstelle (Q04, Q07) |
| Reichweite | Eigenzählung (Kapitel 10) oder Adapter des Werkzeugs | laufend | — |
| Kern | Lesesicht mit Zählungen je Tag und Quelle | täglich | keine Einzeldatensätze |
| Keyword-Daten | optionaler Adapter | bei Bedarf | Werte als Schätzung gekennzeichnet |
Regeln für alle Adapter: hinter einer gemeinsamen Schnittstelle; laufen ausschließlich in der Hintergrundverarbeitung; schreiben idempotent je Tag; protokollieren jeden Lauf; ein Fehler erzeugt eine sichtbare Lücke, keinen geschätzten Wert. Abrufe laufen nur in Produktion. Tests verwenden nachgebildete Antworten (Http::fake()).
Herkunft von Registrierungen ohne Cookie: Handlungsaufrufe tragen die Kennung der auslösenden Seite und des Bausteins als Parameter; die Registrierung speichert diese Angabe und einen vorhandenen Kampagnenparameter am Konto. Das Marketingmodul liest davon nur Zählungen. Damit entsteht eine Zuordnung „von welcher Seite kam die Registrierung“, ohne Speicherung im Browser.
8.5 Regeln
Jede Regel ist eine Klasse mit Schlüssel, Version, Datenbedarf und Schwellen aus einer pflegbaren Tabelle. Sie ist mit festen Testdaten prüfbar und liefert Befunde mit den Zahlen, auf denen sie beruht.
| Regel | Bedarf | Befund |
|---|---|---|
| R01 Titel oder Beschreibung fehlt oder doppelt | Bestand | Metaangaben ergänzen |
| R02 Bild ohne Alternativtext | Bestand | Text ergänzen |
| R03 defekter interner Link | Bestand | Link berichtigen |
| R04 verwaiste Seite | Bestand | verlinken |
| R05 Objekt gelistet, aber ohne Mindestinhalt | Bestand | Stammdaten ergänzen |
| R06 Thema ohne gelistetes Modul oder Programm | Bestand | Katalog prüfen |
| R07 Programm oder Modul ohne passendes aktives Angebot | Bestand | Angebot prüfen |
| R08 gezeigte Fassung weicht ab: neuer Stand ohne Anzeigefreigabe, höhere freigegebene Fassung vorhanden, Abdeckung gesunken, Modulseite zeigt andere Fassung als das Programm | Bestand | Profil oder Freigabe prüfen |
| R09 neuer Artikel-Stand oder neues gelistetes Objekt ohne Ankündigung | Ereignis | Vermarktungsliste abarbeiten |
| R10 Beitrag älter als Prüfdatum | Bestand | Wiedervorlage |
| R11 Cluster mit weniger als zwei Beiträgen | Bestand | Themenlücke |
| R12 Position 8 bis 20 bei nennenswerten Impressionen | Verkehr | Inhalt ausbauen, verlinken |
| R13 Klickrate deutlich unter dem Vergleichswert gleicher Position | Verkehr | Titel und Beschreibung prüfen |
| R14 Anfragen mit Impressionen ohne passende Seite im Cluster | Verkehr und Zuordnung | Thema vorschlagen |
| R15 Rückgang gegenüber der Vorperiode über Schwelle | Verkehr | Ursache prüfen |
| R16 Seite mit Besuchen, aber ohne Klick auf den Handlungsaufruf | Verkehr | Aufruf oder Angebot prüfen |
Regeln mit Bedarf „Verkehr“ ruhen sichtbar, bis die Mindestmenge erreicht ist.
8.6 Wirkungsmessung
Beim Erledigen einer Maßnahme wird das Datum festgehalten. Nach Ablauf des Vergleichszeitraums stellt ein Auftrag gleich lange Zeiträume davor und danach gegenüber und schreibt eine Wirkungsnotiz. Liegen zu wenige Daten vor oder fallen mehrere Änderungen an derselben Seite in den Zeitraum, lautet das Urteil „nicht beurteilbar“. Ein Ursachennachweis wird nicht behauptet.
8.7 Oberfläche
Ein Bereich „Marketing“ in der Verwaltung mit vier Ansichten: Übersicht (Kennzahlen mit Quelle, Zeitraum, Abrufzeit), Maßnahmen (Liste mit Herleitung und Entscheidung), Themen (Cluster mit Seiten und Anfragen), Protokoll (Abrufe, KI-Läufe). Eine Maßnahme führt mit einem Klick zur betroffenen Seite; ein Entwurf ist eine Revision dieser Seite.
9. KI- und Workflow-Orchestrierung
9.1 Grundsätze
- Ein KI-Schritt ist ein Auftrag mit festem Zweck, festen Eingaben, festem Ausgabeschema und festem Freigabegrad. Er ist kein Gespräch und hat keine Werkzeuge außer denen, die sein Zweck verlangt.
- Zahlen kommen nie aus dem Modell. Berichte erhalten die Zahlen vom System und formulieren nur.
- Ergebnis ist ein Vorschlag oder eine Entwurfsrevision. Kein Schritt kann veröffentlichen, versenden oder Fachdaten ändern.
- Eingaben sind eine Positivliste: öffentliche Seiteninhalte, öffentlich gelistete Fachdaten, verdichtete Zahlen, bereinigte Suchanfragen, die Liste zulässiger Aussagen. Keine Kontodaten.
- Alles ist protokolliert: Aufgabe, Modell, Fassung der Anweisung, Verweis auf die Eingabe, Mengen, Ergebniszustand.
9.2 Aufbau
flowchart LR
M["Maßnahme oder Zeitplan"] --> A["KI-Auftrag in der Warteschlange"]
A --> E["Eingaben nach Positivliste"]
E --> AD["Modelladapter"]
AD --> X["KI-Dienst"]
X --> AD
AD --> P["Prüfung des Ausgabeschemas"]
P --> L["KI-Lauf protokolliert"]
L --> V["Vorschlag Stufe 1"]
L --> R["Entwurfsrevision Stufe 2, markiert"]
V --> H["Redakteur übernimmt oder verwirft"]
R --> H2["Redaktionelle und fachliche Prüfung"]
H2 --> PUB["Veröffentlichung über das Seitensystem"]
| Teil | Festlegung |
|---|---|
| Auftragsdefinition | im Repository: Schlüssel, Zweck, Eingabebauer, Anweisung mit Versionsnummer, Ausgabeschema, Modellstufe, Freigabegrad |
| Modelladapter | eine Schnittstelle „Text nach Schema erzeugen“; eine Umsetzung für den gewählten Dienst, eine Nachbildung für Tests |
| Modellstufen | drei benannte Stufen (klein, mittel, groß); die Zuordnung zu konkreten Modellen ist Konfiguration |
| Ausführung | nur in der Hintergrundverarbeitung; Zeitlimit; ein Wiederholungsversuch bei technischem Fehler |
| Ablehnung durch den Dienst | eigener Ergebniszustand ohne Wiederholung. Bei Themen wie sexualisierter Gewalt ist mit Ablehnungen durch Schutzfilter zu rechnen [ANNAHME]; solche Texte schreibt ein Mensch. |
| Ausfall des Dienstes | Maßnahmenliste, Regeln und Website sind nicht betroffen |
| Fremdinhalte | Suchanfragen und abgerufene Webseiten sind nicht vertrauenswürdige Eingaben; Ausgaben werden nur gespeichert, nie ausgeführt; HTML wird bereinigt; Links werden geprüft |
9.3 Modellstufen und Kosten
Preise laut Q25 (Stand 03.11.2026, je Million Token Eingabe und Ausgabe): kleines Modell 0,10 und 0,50 USD; mittleres 2 und 10 USD; großes 4 und 20 USD. Stapelverarbeitung kostet nach derselben Quelle die Hälfte; wiederverwendete Eingaben aus dem Zwischenspeicher etwa ein Zehntel.
| Aufgabe | Menge je Monat [ANNAHME] | Stufe | Eingabe und Ausgabe | Kosten |
|---|---|---|---|---|
| Anfragen einem Cluster zuordnen | 2.000 Anfragen | klein | 1,0 Mio. und 0,2 Mio. | etwa 0,20 USD |
| Titel, Beschreibung, Alternativtext | 40 Seiten | klein | 0,12 Mio. und 0,012 Mio. | etwa 0,02 USD |
| Briefings | 20 | mittel | 0,2 Mio. und 0,04 Mio. | etwa 0,80 USD |
| Beitragsentwürfe | 8 | groß | 0,24 Mio. und 0,048 Mio. | etwa 1,90 USD |
| Berichte | 4 | mittel | 0,2 Mio. und 0,012 Mio. | etwa 0,50 USD |
| Summe | etwa 3,50 USD |
Zum Vergleich: alle Aufgaben mit dem großen Modell etwa 13 USD; mit dreifacher Ausgabemenge durch Denkanteile unter 30 USD. Folgerung: Die Stufung ist eine Frage von Geschwindigkeit und Angemessenheit, nicht des Budgets. Für Entwürfe und fachlich heikle Zusammenfassungen ist die höchste verfügbare Qualität zu wählen. Die tatsächlichen Mengen sind nach den ersten Wochen aus dem Protokoll abzulesen.
Modellunabhängigkeit: Anweisungen und Schemata sind dienstneutral formuliert; der Adapter kapselt den Aufruf. Ein Wechsel des Anbieters ist eine neue Adapterumsetzung plus Neubewertung der Anweisungen an einer festen Beispielsammlung.
9.4 Rolle von n8n
| Einsatz | Urteil |
|---|---|
| Träger der Marketinglogik (Abruf, Regeln, Freigaben) | nein |
| Verbindung zu fremden Kanälen (soziale Netze, Newsletter-Dienst, Kalender) | optional ab M3 |
| Prototyp eines neuen Ablaufs vor der Übernahme in den Kern | sinnvoll |
Bedingungen für den Einsatz: eigener Zugang zum Kern über eine schmale Schnittstelle mit drei Rechten (verdichtete Kennzahlen lesen, veröffentlichte Neuigkeiten lesen, Maßnahme als Vorschlag anlegen); kein Datenbankzugang; keine Veröffentlichung; Abläufe als Dateien im Repository gesichert; eigene Zugangsdaten je Kanal. Ob auf dem Server bereits eine n8n-Instanz läuft, wurde nicht geprüft; andere Anwendungen dort dürfen nicht verändert werden (Projektregel).
Vor dem Einsatz zu prüfen: ob der Freigabeschritt in der Community-Ausgabe verfügbar ist (Q19 sagt dazu nichts).
9.5 Agenten
Ein einzelner Auftrag mit Websuche („Rechercheauftrag zu einem Thema mit Quellenliste“) ist ab M3 denkbar: nur lesend, Ergebnis ist ein Briefing mit Quellen. Ein Verbund mehrerer Agenten mit Schreibrechten im CMS wird nicht empfohlen; kein beschriebener Ablauf braucht ihn.
10. Reichweitenmessung
| Variante | Betrieb | Aussagekraft | Datenschutz | Urteil |
|---|---|---|---|---|
| Eigenzählung im Kern | kein weiterer Dienst | Aufrufe je Seite, Herkunftsklasse, Kampagne, Klick auf Handlungsaufruf; keine Sitzungen, keine Wiederkehrer | keine Speicherung im Browser, keine IP, nur Tageszähler | Empfehlung für den Start |
| Umami, selbst betrieben | weiterer Container mit PostgreSQL [ANNAHME] | zusätzlich Sitzungen, Geräte, Verläufe | ohne Cookies; Konfiguration zu prüfen | Ausbauweg |
| Matomo, selbst betrieben | weiterer Container, eigene MySQL-Datenbank [ANNAHME] | umfangreich | ohne Cookies einstellbar; Standard protokolliert mehr | nur bei deutlich höherem Bedarf |
| Plausible, selbst betrieben | zwei weitere Dienste [ANNAHME] | wie Umami | ohne Cookies | für einen Betreiber zu viel Betrieb |
| Analysedienst eines Drittanbieters | keiner | hoch | Einwilligung nötig, Drittlandfragen | nicht empfohlen |
Eigenzählung im Einzelnen [EMPF]: Ein Zählaufruf aus dem Browser an die eigene Adresse übermittelt Pfad und Herkunftsklasse; der Server erhöht Tageszähler. Dadurch zählen nur Browser, die Skripte ausführen, was automatische Abrufe weitgehend ausschließt. Es wird nichts im Browser gespeichert und keine Kennung gebildet. Ob das Auslesen der Herkunft als Zugriff auf das Endgerät zu werten ist, gehört zur rechtlichen Prüfung (Zielkonzept, Kapitel 13).
Grenze: keine Besucherzahlen, keine Verweildauer, keine Pfade. Für die Leitkennzahl und den Trichter genügen Aufrufe und die Ereignisse des Kerns. Ein Werkzeug wird erst eingeführt, wenn eine konkrete Frage damit nicht zu beantworten ist; das wäre eine Änderung an docker-compose.yml und am Server.
11. Sicherheit, Rollen und Datenschutz (technisch)
| Thema | Regel |
|---|---|
| Ausgehende Verbindungen | Suchdienste, KI-Dienst und optional Keyword-Dienst werden nur von der Hintergrundverarbeitung angesprochen. Der Web-Prozess kennt diese Zugangsdaten nicht (03, Abschnitt 6, Geheimnisse je Prozess). |
| Zugangsdaten | nur in der Umgebungsdatei der Produktion auf dem Server; in Test keine echten Zugänge |
| Datenbankrechte | Marketingtabellen: Hintergrundverarbeitung schreibt, Verwaltung liest und schreibt Entscheidungen, Web-Betriebsart nur die Tageszähler |
| Personendaten | keine im Marketingmodul; Zählungen aus dem Kern über eine eigene Lesesicht ohne Kennungen |
| Rollen | keine neue Sammelrolle. Redakteur: Übersicht, Maßnahmen, KI-Aufträge anfordern, Entwürfe prüfen. Fachprüfer: Freigabe von Fachaussagen. Systemverwalter: Datenquellen, Schwellen, Modellzuordnung. |
| Audit | Listen und Entlisten öffentlicher Profile, Änderungen an Schwellen und Modellzuordnung, Veröffentlichungen. KI-Läufe stehen im eigenen Protokoll. |
| Öffentliche Lesesicht | einziger Weg von Fachdaten auf öffentliche Seiten; gibt ein Datenobjekt ohne geschützte Felder zurück |
| Formulare | Mengenbegrenzung, Schutzfeld, minimale Pflichtangaben, Löschfrist |
| Schnittstelle für n8n | eigener Schlüssel mit drei Rechten; widerrufbar; Zugriffe protokolliert |
| Herkunftsadressen | Marketing liegt in der Verwaltung und damit auf deren Adresse |
| Test und Produktion | Abrufe und KI-Aufrufe nur in Produktion; Tests mit Nachbildungen; die Suite auf der Testinstanz ruft keine Fremddienste |
Negativtests für die Umsetzung (in der Art von 11, Abschnitt 7.6):
| Nr. | Test |
|---|---|
| NT-W1 | Eine öffentliche Objektseite enthält keine Abrufadresse und keinen Lehrtext einer geschützten Fassung. |
| NT-W2 | Ein nicht gelistetes Objekt ist weder über seine Adresse noch über einen Katalogbaustein noch über die Sitemap erreichbar. |
| NT-W3 | Ein Vorschaubild ohne öffentliche Freigabe ist über keine öffentliche Route abrufbar. |
| NT-W4 | Angebotsseite, Programmseite und Landingpage zeigen nach Aktivierung einer neuen Angebotsfassung denselben Preis. |
| NT-W5 | In einer Umgebung außer Produktion trägt jede Antwort die Sperrkennzeichnung. |
| NT-W6 | Ein Baustein mit Skript oder fremdem HTML wird beim Speichern abgewiesen. |
| NT-W7 | Eine nur bereite, nicht zur Anzeige freigegebene Fassung erscheint auf keiner öffentlichen Seite, auch nicht als Bestandteil, Pfad oder Verwendungshinweis. |
| NT-W8 | Eine Identität ohne gesetzte Inhaltsart lässt sich nicht listen; die technische Bezeichnung des Strukturtyps erscheint auf keiner öffentlichen Seite. |
| NT-M1 | Kein Datensatz des Marketingmoduls enthält eine Kontokennung oder E-Mail-Adresse. |
| NT-M2 | Ein KI-Auftrag kann den Veröffentlichungszeiger einer Seite nicht setzen. |
| NT-M3 | Die an den KI-Dienst übergebene Eingabe enthält nur Felder der Positivliste. |
| NT-M4 | Der Schlüssel der n8n-Schnittstelle kann keine Seite veröffentlichen und keine Fachdaten lesen. |
12. Architekturentscheidungen (Entwürfe)
Zur Übernahme in 12_Entscheidungsprotokoll_ADR.md nach Annahme. Nummern sind Vorschläge.
| Nr. | Entscheidung | Alternativen | Vorteile | Nachteile und Risiken | Voraussetzung | Alternative vorziehen, wenn |
|---|---|---|---|---|---|---|
| ADR-28 (bevorzugt, unter Vorbehalt) | Seitensystem bleibt Eigenkern und erhält Seitentypen, Vorlagen, Abschnittsvarianten und globale Abschnitte (ergänzt ADR-22) | Statamic, Twill, freier Builder, Headless-Dienst, Payload | eine Verwaltung; Katalogbezug ohne Kopie; Bestand genutzt | Pflegeaufwand; Komfortgrenze | bestandener Editor-Prototyp (4.5); vorher keine Entscheidung | der Prototyp scheitert auch in der zweiten Runde; mehrere tägliche Redakteure ohne Katalogbezug |
| ADR-29 | Öffentliches Profil je Fachobjekt mit Fassungsmodus „folgt Stand“ oder „fest“. Gezeigt wird nur eine zur Anzeige freigegebene Fassung. Seitentyp und Adresse folgen der Inhaltsart. Enthaltene Module erscheinen als Struktur; eine eigene Seite braucht eine eigene Freigabe. | je Objekt eine CMS-Seite; öffentliche Felder an der Identität; Seitentyp aus CompositionKind |
keine Kopie; öffentlich kann weder dem verkauften noch dem freigegebenen Stand vorauseilen | weiteres Objekt; bei Programmen über mehrere Artikel bestätigt die Redaktion die Fassung | Bibliothek Pakete 2, 3, 4; für Angebote 1 und 7 | — |
| ADR-30 | Bausteinvertrag mit Hülle, Varianten, Verweisen und Schemaversion | freie Felder je Baustein; Format eines Fremdeditors | Editorfläche austauschbar; keine Migration alter Revisionen | Aufwärtsfunktionen sind zu pflegen | — | ein Fremdeditor wird führend |
| ADR-31 | Adressauflösung in der Anwendung mit Weiterleitungstabelle und Indexierungsrichtlinie je Typ und Umgebung | Regeln am Proxy; nur manuelle Einstellungen | redaktionell pflegbar, testbar; Umgebung nicht übersteuerbar | zusätzliche Abfrage bei unbekannter Adresse | Entscheidung zur kanonischen Hauptadresse | — |
| ADR-32 | Öffentliche Seiten ohne Sitzung, identisch für alle, in der Anwendung zwischengespeichert | Sitzung überall; Zwischenspeicher am Proxy | schnell; einfacher Schutz; Proxy bleibt unberührt | Entwertung muss stimmen; Formulare getrennt | — | Personalisierung öffentlicher Seiten gewünscht |
| ADR-33 | Marketing als Modul des Kerns mit personenfreier Datenhaltung | n8n als Steuerung; eigenes System | Tests, Rollen, Audit, Sicherung vorhanden | Kern wächst | — | Marketing wird von einem eigenen Team mit eigenen Werkzeugen betrieben |
| ADR-34 | KI als einzelne protokollierte Aufträge hinter einem Modelladapter, Ergebnis nie öffentlich ohne Mensch | Agentenverbund; KI-Funktionen eines Fremd-CMS | vorhersagbar, prüfbar, anbieterunabhängig | weniger „selbstständig“ | Entscheidung KI-Dienst; Liste zulässiger Aussagen | — |
| ADR-35 | Reichweitenmessung als Eigenzählung ohne Cookies | selbst betriebenes Werkzeug; Drittanbieter | kein Betriebsteil, keine Einwilligung nach heutiger Einschätzung | geringe Aussagetiefe | rechtliche Prüfung | Fragen zu Sitzungen und Pfaden werden geschäftsrelevant |
| ADR-36 | Design-Tokens zweistufig im Repository; Website und Mitgliederbereich teilen Komponenten | Markenwerte in der Datenbank; getrennte Stile | eine Quelle; Änderungen nachvollziehbar | Markenänderung braucht Deployment | Markenfreigabe | häufige Markenänderungen |
| ADR-37 | n8n nur für fremde Kanäle über eine schmale Schnittstelle | n8n mit Datenbankzugang; ganz ohne n8n | Schaden begrenzt; Logik bleibt testbar | zweiter Mechanismus | Bedarf an einem konkreten Kanal | kein Fremdkanal nötig: dann ganz ohne |
13. Änderungen an bestehenden Architekturkomponenten und Dokumenten
13.1 Komponenten
| Komponente | Änderung | Art |
|---|---|---|
| Modul Web und CMS | Seitentypen, Vorlagen, globale Abschnitte, Weiterleitungen, Medienbibliothek, öffentliche Profile, Lesesicht, SEO-Dienste, Prüfungen | Erweiterung |
| Bausteinregister | von einer Klasse mit Fallunterscheidung zu einer Klasse je Art mit gemeinsamem Vertrag | Umbau ohne Datenänderung |
| Routen | mehrteilige Pfade, Objektrouten, erzeugte robots.txt |
Erweiterung; statische Datei entfällt |
| Layout | neutrale Kopfzeile, Kopfangaben, Markup, Tokens | Umbau |
| Säulen als Themen | werden erster Fall des öffentlichen Profils, nachdem Bibliothekspaket 5 die Säulen als Dimension übernommen hat | Einordnung, abwärtskompatibel |
| Mitgliederbereich | fachlicher Neuaufbau durch die Bibliothekspakete 3 bis 7 auf dem vorhandenen Layout; erst danach Umstellung auf Tokens und Grundkomponenten (W1b) | getrennte Schritte, siehe 14.3 |
| Strukturleser, Anzeigefreigabe, Abdeckungsbefund | entstehen in den Bibliothekspaketen 3 und 7 nach den Verträgen G1, G2, G7 und werden vom öffentlichen Katalog mitgenutzt | gemeinsame Komponenten, einmal gebaut |
| Modul Marketing | neu | neu |
| Ereignisverarbeitung | drei bestehende Ereignisarten erhalten einen weiteren Abnehmer | Erweiterung |
| Hintergrundverarbeitung | Abrufe, KI-Aufträge, Bildableitungen für die Website | Erweiterung |
| Fachmodule (Inhalte, Katalog, Veröffentlichung, Lizenzen, Bestellung) | keine Änderung an Tabellen, Invarianten oder Schnittstellen | — |
| Deployment-Dateien | keine für W1 bis M2; nur bei Einführung eines Messwerkzeugs oder von n8n | — |
13.2 Dokumente
| Dokument | Abschnitt | Änderung |
|---|---|---|
03_Zielarchitektur.md |
2, 3 | Modul Marketing; Erweiterung von Web und CMS; Lesesicht |
| 4 | Datenhoheit: öffentliches Profil, Marketingdaten | |
| 5.1 | externe Schnittstellen: Suchdienste, KI-Dienst, optional Keyword-Dienst | |
| 6 | öffentliche Seiten ohne Sitzung; Zugangsdaten nur in der Hintergrundverarbeitung | |
04_Domaenenmodell.md |
neu | Seitensystem und öffentliches Profil als fünftes Diagramm; Abgrenzung zu Klasse A |
09_CMS_Administration_Community.md |
A.2 | Seitentypen nach Zielkonzept, Kapitel 9; „Episode“ durch Programm und Modul ersetzen |
| A.3 | Bausteinbibliothek, Varianten, globale Abschnitte | |
| A.4 | Verweis auf Klasse A, B, C und öffentliches Profil (deckt Abgleich A01 und A09) | |
| A.5 | Vorlagen, Zeitsteuerung, Prüfungen | |
| A.6 | Zuordnung nach Kapitel 7.6 | |
| B.1, B.2 | Bereich Marketing; Rollen | |
10_Technologiebewertung.md |
2 | Ergebnis des CMS-Vergleichs; Editorbausteine von Filament |
| neu | Reichweitenmessung, KI-Dienst, n8n | |
11_Betrieb_Sicherheit_Datenschutz.md |
7.6 | Negativtests NT-W und NT-M |
| 8.1, 8.3 | Verarbeitungen und Empfänger: Suchdienste, KI-Dienst, Messung, Newsletter; Fristen | |
| 9 | Betriebskosten | |
12_Entscheidungsprotokoll_ADR.md |
— | ADR-28 bis ADR-37; Vermerk an ADR-22 |
13_Risiken_Annahmen_offene_Entscheidungen.md |
3, 4 | Risiken und Entscheidungen aus dem Zielkonzept, Kapitel 16 und 17 |
15_Roadmap.md |
1, 2 | Spuren W und M; Einordnung in A1 |
16_MVP_Slice.md |
3.1 | Website und CMS: Umfang nach W0 bis W3; Player nach Abgleich A06 |
design-prinzipien.md |
5, 3, 8 | Verweis auf freigegebene Tokens und Signaturen; Kursplayer als Add-on |
seo-und-content-prinzipien.md |
8, 9, 13 | Stand der Ergebnisarten; Aussagen von Google zu KI-Funktionen; Berichte |
produktkonfiguration-und-mitgliederbereich.md |
5, 8 | öffentliche Sichtbarkeit über das Profil |
analysen/umsetzungsplan-mitgliederbibliothek.md |
Pakete 3, 5, 7, 9 | Vertragsvermerke zu G1, G2, G5, G7, G9; Verweis auf die gemeinsame Reihenfolge. Inhalt und Folge der Pakete bleiben. |
analysen/ist-soll-abgleich-mitgliederbibliothek.md |
E-A, E-D | Verweis: Die öffentliche Vorstellung von Programmen ist in Kapitel 6.2 dieses Dokuments geregelt. |
betrieb/DEPLOYMENT.md |
— | Umgebungssteuerung der Indexierung; neue Umgebungswerte für Datenquellen und KI-Dienst |
tasks/SEO-Marketing.md |
— | Vermerk „durch Zielkonzept abgelöst“ |
Brand-UI-Kit/README.md |
— | Status nach W0 |
Es entsteht kein weiteres Spezifikationsdokument. Nach der Übernahme der angenommenen Teile können beide neuen Dokumente als Entscheidungsgrundlage archiviert werden.
14. Gemeinsame Implementierungsreihenfolge für Bibliothek, Website und CMS
Dieses Kapitel führt die Bibliothekspakete 0 bis 9 (docs/analysen/umsetzungsplan-mitgliederbibliothek.md, Fassung nach Review) und die Stufen W und M dieses Konzepts in eine Reihenfolge. Die Paketinhalte der Bibliothek werden nicht geändert. Jedes Paket bringt Tests mit; Migrationen sind ergänzend.
14.1 Gemeinsame Architekturkomponenten
Diese Teile werden von Bibliothek und Website gebraucht. Sie entstehen jeweils einmal, in dem Paket, das sie zuerst braucht, und nach einem Vertrag, der vor Beginn dieses Pakets feststeht.
| Nr. | Komponente | Vertrag | Entsteht in | Genutzt von |
|---|---|---|---|---|
| G1 | Strukturleser | Liest eine zur Anzeige freigegebene Kompositionsfassung als Baum mit Identität, fixierter Kindesfassung, Rolle, Reihenfolge, Inhaltsart und Klasse-A-Daten. Kennt keine Person und keine Berechtigung. Die Mitgliederansicht legt die Berechtigung je Blatt als zweite Schicht darüber; die öffentliche Seite legt eine Projektion ohne geschützte Felder darüber. | Paket 3 | Paket 3, Paket 7, W3 |
| G2 | Anzeigefreigabe | Eigener Zustand je Kompositionsfassung mit Bearbeiter und Zeitpunkt; unabhängig vom Status bereit und vom Artikel-Stand; abfragbar „ist diese Fassung freigegeben“ und „höchste freigegebene Fassung dieser Identität“. |
Paket 3 | Paket 3, Paket 7, W3 |
| G3 | Inhaltsart | Konfigurierbare Werte mit stabiler Kennung; Startwerte programm, modul, merkblatt, traineranleitung; je Identität ausdrücklich gesetzt; ändert weder kind noch output_class. |
Paket 2 | Paket 3, Paket 5, W3 (Seitentyp und Adresse) |
| G4 | Klasse-A-Anzeigefelder | Anzeigetitel und Kurzbeschreibung an der Identität, mit Protokoll; ein Titel für Bibliothek und Website. | Paket 4 | Paket 3, Paket 5, W3, SEO-Vorbelegung |
| G5 | Dimensionswerte | Stabile Kennung je Wert; die Säulen behalten ihre Identität; direkte und abgeleitete Zuordnung sind unterscheidbar; öffentliche Themen bleiben funktionsfähig. | Paket 5 | Paket 5, Themenseiten, Signaturen, öffentliches Profil der Säulen |
| G6 | Bildableitung | Auftrag in der Hintergrundverarbeitung, der aus einem Bild oder Videoframe geschützte Ableitungen erzeugt; Freigabeklasse „geschützt“ oder „öffentlich“ als Eigenschaft der Verwendung. | Paket 6 | Paket 6, W2 (Medienbibliothek), W3 (öffentliche Freigabe) |
| G7 | Abdeckungsbefund | Lesedienst „welche Blätter dieser Kompositionsfassung liegen in keinem Artikel-Stand dieses Angebotsumfangs“, aufrufbar auch außerhalb der Aktivierung. | Paket 7 | Paket 7, W3 (Angebots- und Programmseite) |
| G8 | Aktuelle Angebotsfassung | Eine Lesefunktion „die eine aktive Fassung dieses Angebots“, bei Dubletten die höchste aktive Nummer. | Paket 1 | Paket 1, Registrierung, Kauf, W3 |
| G9 | Instanz-Suite | Browser-Lauf über HTTP gegen die Testinstanz oder Wegwerf-Container; nie gegen Produktion; nie mit Leeren der Testdatenbank. | Paket 9 oder W1, je nachdem, was zuerst beginnt | Paket 9 (Tor A, Tor B), W1 bis W4 (Sicht-, Leistungs- und Barrierefreiheitsprüfung) |
14.2 Einstufung der Bibliothekspakete
| Paket | Einstufung | Bezug | Vor Beginn festzulegen |
|---|---|---|---|
| 0 Bestandsaufnahme | unverändert umsetzbar | keiner | — |
| 1 Angebotsfassung, Registrierung, Bestellbezeichnung | unverändert umsetzbar | liefert G8 | — |
| 2 Technische Struktur und Inhaltsart | unverändert umsetzbar | liefert G3 | die vier Startkennungen werden als stabil festgehalten |
| 3 Bibliothek und interne Medienaktionen | abhängig von gemeinsamen Komponenten | baut G1 und G2; ändert gemeinsam berührte Dateien (14.4) | Schnitt des Lesers in Struktur und Berechtigungsschicht; Anzeigefreigabe als eigener Zustand |
| 4 Klasse-A-Stammdaten | unverändert umsetzbar | liefert G4 | Feldnamen werden als gemeinsamer Vertrag festgehalten |
| 5 Fachdimensionen, Suche, Filter | abhängig von gemeinsamen Komponenten | baut G5; berührt die Säulen, auf denen die öffentlichen Themen beruhen | Kennungen der Säulenwerte bleiben; /themen bleibt während und nach der Übernahme erreichbar |
| 6 Einfache Thumbnails | unverändert umsetzbar | liefert G6 | — (öffentliche Freigabe ist ein Schritt von W3, nicht dieses Pakets) |
| 7 Redaktionelle Vorschau und Angebotsabdeckung | abhängig von gemeinsamen Komponenten | nutzt G1, G2; baut G7 | Abdeckungsbefund als Lesedienst, nicht nur als Prüfung in der Aktivierungsmaske |
| 8 Kommerzielle Medienausgabe | unverändert umsetzbar | keiner zur Website | — |
| 9 E2E-Abnahme, Tor A und Tor B | abhängig von gemeinsamen Komponenten | nutzt G9 | eine gemeinsame Instanz-Suite für Bibliothek und Website |
„Abhängig“ heißt nicht, dass ein Paket warten muss oder anders zugeschnitten wird. Es heißt: Der genannte Vertrag wird vorher abgestimmt, damit W3 keinen zweiten Leser, keine zweite Freigabe und keinen zweiten Abdeckungsbefund baut.
14.3 Gemeinsame Reihenfolge
flowchart TB
subgraph S0["Schritt 0: sofort, parallel"]
P0["Paket 0 Bestandsaufnahme"]
W0["W0 Markenbasis"]
V["Verträge G1 bis G8 festhalten"]
WP["W-P Editor-Prototyp"]
end
subgraph S1["Schritt 1"]
P1["Paket 1 Lizenz und Bestellung"]
P2["Paket 2 Inhaltsart"]
W1["W1 Designsystem, Adressen, SEO-Technik"]
M0["M0 Messbasis"]
end
subgraph S2["Schritt 2"]
P3["Paket 3 Bibliothek mit G1, G2"]
TA["Paket 9, Tor A"]
W2["W2 Seitensystem"]
end
subgraph S3["Schritt 3"]
P4["Paket 4 Klasse A"]
P5["Paket 5 Dimensionen, Filter"]
P6["Paket 6 Thumbnails"]
P7["Paket 7 Vorschau, Abdeckung"]
W1B["W1b Mitgliederbereich im Designsystem"]
end
subgraph S4["Schritt 4"]
W3["W3 Öffentlicher Katalog"]
P8["Paket 8 Medienausgabe"]
end
subgraph S5["Schritt 5"]
TB["Paket 9, Tor B"]
VS["Verkaufsstart"]
W4["W4 Wissen und Landingpages"]
end
V --> P3
WP --> W2
W0 --> W1
P1 --> P3
P2 --> P3
P3 --> TA
P3 --> P4
P4 --> P5
P3 --> P6
P3 --> P7
P3 --> W1B
W1 --> W1B
W1 --> W2
W2 --> W3
P4 --> W3
P7 --> W3
P3 --> P8
P5 --> TB
P6 --> TB
P7 --> TB
P8 --> TB
TB --> VS
W3 --> VS
W3 --> W4
| Schritt | Bibliothek | Website und CMS | Warum konfliktfrei | Übergang |
|---|---|---|---|---|
| 0 | Paket 0 | W0; Verträge G1 bis G8; W-P | Paket 0 liest nur; W0 ist Gestaltung und Entscheidung; W-P berührt nur den Seiteneditor und braucht keine Migration | Verträge liegen vor; Ergebnis von W-P steht fest |
| 1 | Paket 1, Paket 2 | W1 ohne Mitgliedsansichten; M0 | Pakete 1 und 2 liegen in Katalog und Verwaltung; W1 in Layout, Tokens, öffentlichen Ansichten und Adressauflösung | Tests grün; W1 mit Sichtprüfung abgenommen |
| 2 | Paket 3, danach Tor A | W2 | Paket 3 ersetzt die Mitgliedsansichten und die Routen unter bereich; W2 liegt im Seitensystem |
Tor A bestanden |
| 3 | Pakete 4 und 5 nacheinander; 6 und 7 parallel dazu | W1b; W2 läuft weiter | W1b beginnt erst, wenn Paket 3 die Mitgliedsansichten neu aufgebaut hat, und fasst deren Struktur nicht an | Pakete 4 und 7 fertig |
| 4 | Paket 8 | W3 in drei Teilen (unten) | Paket 8 liegt in der Auslieferung; W3 liest nur | W3 abgenommen; Pakete 1 bis 8 fertig |
| 5 | Tor B | W4; danach M1, M2 | — | Verkaufsstart nach Tor B und W3 |
W3 in drei Teilen, damit früh etwas sichtbar wird:
| Teil | Inhalt | Braucht |
|---|---|---|
| W3a | öffentliches Profil, Lesesicht, Programm- und Modulseite | Pakete 2, 3, 4 (G1 bis G4) |
| W3b | Angebotsseite, Angebotsbausteine, Lizenzvergleich, „nicht enthalten“ | Pakete 1, 7 (G7, G8) |
| W3c | Module je Thema, Katalogfilter, öffentlich freigegebene Vorschaubilder | Pakete 5, 6 (G5, G6) |
Kaufaufrufe auf öffentlichen Seiten werden erst nach Tor B geschaltet. Tor A gibt nichts frei und ist auch für die Website kein Starttor.
Was sich gegenüber dem Bibliotheksplan ändert: nichts an Inhalt und Reihenfolge der Pakete 0 bis 9. Hinzu kommen die Vertragsabstimmung vor Paket 3, 5 und 7 und die Regel für gemeinsam berührte Dateien.
14.4 Gemeinsam berührte Dateien
| Datei oder Bereich | Geändert von | Regel |
|---|---|---|
resources/views/member/*, CourseOutline, LibraryController |
Paket 3 (neu aufgebaut), Pakete 4 bis 7 (ergänzt), W1b (Gestaltung) | W1 fasst diese Dateien nicht an. W1b folgt nach Paket 3 und ändert Klassen und Komponenten, nicht Struktur und Logik. |
routes/web.php |
Paket 3 (Gruppe bereich), W1 (öffentliche Routen, Auffangroute, robots.txt), W3 (Objektrouten) |
getrennte Abschnitte der Datei; Änderungen nacheinander zusammenführen, nicht in parallelen langlebigen Zweigen |
resources/views/layouts/site.blade.php |
W1 (Kopfzeile, Kopfangaben) | Die Bibliothekspakete nutzen das Layout unverändert (E-D). Die neutrale Kopfzeile aus 5.6 muss den Einstieg in den Mitgliederbereich erhalten. |
resources/css/app.css |
W1 (Tokens), W1b | Bibliothekspakete fügen keine neuen Gestaltungsregeln hinzu; funktionale Listen genügen (E-D). |
resources/js/app.js |
Paket 3 (entfernt den Entscheidungsknopf), W1 (Navigation) | Paket 3 zuerst; W1 ergänzt eigene Module |
Säulen: pillars, content_element_pillar, page_pillar, ThemeController |
Paket 5 (Übernahme in Dimensionen), W3 (Säulen als öffentliches Profil) | Paket 5 löscht keine Spalten und erhält die Kennungen. Die Einordnung der Themen in das öffentliche Profil folgt erst nach Paket 5. |
Ableitungsauftrag neben StoreContentFile |
Paket 6, W2, W3 | ein Auftrag mit Parametern, kein zweiter |
DemoCatalogSeeder |
Paket 9 | Der Seeder setzt keine Inhaltsart auf vorhandene Zeilen (Bibliotheksplan). Öffentliche Profile werden vom Seeder nur in der Testumgebung und nur für eigene Demokennungen angelegt. |
14.5 Arbeitspakete der Spuren W und M
Stufen wie im Zielkonzept, Kapitel 14.
| Stufe | Paket | Hängt ab von | Tests (Auswahl) |
|---|---|---|---|
| W-P | Editor-Prototyp nach 4.5 | — | Bedienaufgaben T1 bis T9, Kriterien K1 bis K5 |
| W1 | Tokens und Grundkomponenten | W0 | Darstellungstests je Komponente; Sichtprüfung |
| mehrteilige Pfade, reservierte Präfixe | — | Auflösung, Kollision | |
| Weiterleitungen und Statuscodes | Pfade | Pfadänderung, Kette, Schleife, 410 | |
Kopfangaben, Markup, Sitemap, robots.txt je Umgebung |
— | je Seitentyp; NT-W5 | |
| neutrale Kopfzeile, öffentliche Routen ohne Sitzung, Seitenspeicher | — | gleiche Antwort für Gast und Mitglied; Entwertung | |
| W1b | Mitgliederbereich auf Tokens und Grundkomponenten | W1, Paket 3 | Tests der Pakete 3 bis 7 bleiben grün; Sichtprüfung in drei Breiten |
| M0 | Zählaufruf und Tageszähler | W1 | Zählung, keine Speicherung im Browser |
| Herkunft an der Registrierung | — | Parameter wird gespeichert, Zählung ohne Kennung | |
| W2 | Bausteinvertrag, Klasse je Art, Schemaversion | W-P bestanden | Altbestand wird unverändert dargestellt |
| Varianten und Abschnittseinstellungen | Vertrag | je Variante | |
| Vorlagen, Duplizieren | Vertrag | Kopie ist unabhängig | |
| globale Abschnitte | Vertrag | Änderung wirkt nach Veröffentlichung | |
| Medienbibliothek mit Ableitungen | G6 oder eigener Vorgriff nach demselben Vertrag | Web-Prozess schreibt nicht | |
| Builder mit Blockvorschau, Vorschau in drei Breiten | W-P bestanden | Bedienaufgaben aus 4.5 als Abnahme | |
| Prüfungen vor Veröffentlichung | Vertrag | je Prüfung | |
| W3a | öffentliches Profil, Zuordnung Inhaltsart → Seitentyp, Lesesicht | Pakete 2, 3, 4 | NT-W1 bis NT-W3, NT-W7 |
| Programm- und Modulseite, Fassungswahl, Verlinkungsregel | Profil | Fälle A bis D aus 6.2; Modul mit abweichender Fassung wird nicht verlinkt | |
| W3b | Angebotsseite, Katalog- und Angebotsbausteine, Lizenzvergleich | Pakete 1, 7 | NT-W4; „nicht enthalten“ |
| Anfrageformular | — | Mengenbegrenzung | |
| W3c | Module je Thema, Katalogfilter | Paket 5 | direkte und abgeleitete Themen unterscheidbar |
| öffentliche Freigabe eines Vorschaubilds | Paket 6 | NT-W3 | |
| W4 | Seitentyp Beitrag, Autorenangaben | W2 | Pflichtangaben |
| Zeitsteuerung | W2 | Termin wird wirksam | |
| Themencluster | — | Zuordnung | |
| M1 | Adapter für Suchdaten | M0 | nachgebildete Antworten; Lücke bei Fehler |
| Regeln R01 bis R11 | W3 | je Regel mit Testdaten | |
| Maßnahmen, Entscheidung, Wirkungsnotiz | Regeln | Urteil „nicht beurteilbar“ | |
| Regeln R12 bis R16 | Datenmenge | Ruhen unter Mindestmenge | |
| M2 | Modelladapter, Auftragsdefinitionen, Protokoll | M1 | NT-M2, NT-M3; Ablehnung; Ausfall |
| Vorschläge Stufe 1, Entwurfsrevision Stufe 2 | Adapter | Markierung; Sperre bei offener Quelle | |
| M3 | Schnittstelle für n8n | M2 | NT-M4 |
Reihenfolge innerhalb von W2: zuerst Vertrag und Altbestand, dann Varianten, dann Vorlagen. So bleibt jede Zwischenstufe auslieferbar.
15. Offene technische Punkte und Nachweise
| Nr. | Punkt | Art | Vor |
|---|---|---|---|
| 1 | Editor-Prototyp nach 4.5 mit neun Bedienaufgaben und fünf technischen Kriterien | Prototyp, höchstens drei Tage Bau und ein halber Tag Erprobung | W2 |
| 2 | Öffnen öffentliche Routen heute eine Sitzung, und wie verhält sich der Seitenspeicher mit dem vorhandenen Proxy | lesende Prüfung | W1 |
| 3 | Stand der drei Herkunftsadressen und Schutz der Testinstanz | lesende Prüfung am Server (erlaubt), Änderung durch Lars | W1 |
| 4 | Erzeugung von Bildableitungen unter der Trennung von Web-Prozess und Hintergrundverarbeitung | lesende Codeprüfung | W2 |
| 5 | Format und Bereinigung des vorhandenen Fließtexts | lesende Codeprüfung | W2 |
| 6 | Fassungswahl nach 6.2, Fälle A bis D, an einem echten Programm mit Modul-Artikeln durchspielen und bestätigen | fachliche Bestätigung mit Beispiel | W3a |
| 7 | Lernziele, Zeit- und Materialbedarf als Lehrinhalt an der Kompositionsfassung: heute ohne Felder und in keinem Bibliothekspaket enthalten. Zuschnitt und Zeitpunkt festlegen. | Entscheidung; kleines eigenes Paket | W3a, spätestens W4 |
| 8 | Zugang zur Search Console über ein Dienstkonto; Schnittstelle von Bing | Erprobung mit echtem Zugang | M1 |
| 9 | Verhalten des KI-Dienstes bei sensiblen Präventionsthemen | Erprobung mit zehn Beispielaufträgen | M2 |
| 10 | Verarbeitungsort und Aufbewahrung beim KI-Dienst | Vertragsprüfung | M2 |
| 11 | Verfügbarkeit des Freigabeschritts in der Community-Ausgabe von n8n; vorhandene Instanz | Prüfung | M3 |
| 12 | Kanonische Hauptadresse und Weiterleitung der Nebenform | Entscheidung, Einrichtung am Proxy durch Lars | W1 |
| 13 | Verträge G1 bis G8 aus 14.1 als kurze Festlegung, bevor die Bibliothekspakete 3, 5 und 7 beginnen | Abstimmung, etwa ein halber Tag | Bibliothek Paket 3 |
16. Quellen
Die Quellenliste mit Links, Prüfdatum und Einstufung steht im Zielkonzept, Kapitel 20. In diesem Dokument verwendet: Q04, Q06 bis Q20, Q25. Aussagen zum Code beruhen auf lesender Sichtung der in Kapitel 2 genannten Dateien am 15.11.2026. Mit [ANNAHME] gekennzeichnete technische Angaben (Datenbankbedarf der Messwerkzeuge, Nachlauf der Suchdaten, Schnittstelle von Bing) sind Erfahrungswissen ohne aktuelle Prüfung.