Feature-Inventar
Dieses Dokument ist das Quellinventar, um die Produktfeatures von WebBlocks CMS auffindbar zu machen. Es ist ein Inventar für Produkt- und Betriebssichtbarkeit, kein Laufzeitvertrag. Detaillierte technische Verträge verbleiben in den verlinkten Dokumenten.
Das Inventar hilft neuen Benutzern sowie KI-/Operator-Workflows zu verstehen, welche CMS-Fähigkeiten existieren, wo sie in Admin-, öffentlichen und API-Oberflächen erscheinen und welche benutzerorientierten Dokumentationsseiten noch fehlen. Es eignet sich außerdem als Markdown-Quellseite für eine künftige quellenverknüpfte CMS-Dokumentationsseite.
Inventarspalten
- Feature: die Produktfähigkeit oder die dokumentierte Richtung.
- Bereich: der Produktbereich, dem das Feature gehört.
- Status: implementiert, dokumentierte Richtung, nur geplant oder klarere Doku erforderlich.
- Admin-Pfad: die Browser-Admin-Oberfläche, sofern vorhanden.
- Öffentliches Verhalten: was öffentliche Besucher oder gerenderte Sites erleben.
- API-Unterstützung: ob die Internal Content API oder Discovery-Oberflächen das Feature bereitstellen.
- Quell-/Implementierungshinweise: kurzer Quell- oder Implementierungskontext.
- Vorhandene Doku: aktuelle repo-relative Dokumentationslinks.
- Dokumentationslücke / nächste Doku-Seite: der nächste Dokumentationsbedarf.
Kerninhaltsmodell und Page Builder
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quell-/Implementierungshinweise | Vorhandene Doku | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| Sites | Kerninhalt | Implementiert | /webadmin/sites | Site-bezogenes öffentliches Routing, Branding, Sprachen (Locales), Variablen und Inhalte | Über die Internal Content API auffindbar | Wurzel-Inhaltsbereich für Seiten, Domains, Sprachen (Locales), Medien und Navigation | docs/multisite.md, docs/core-concepts.md | abgedeckt |
| Sprachen (Locales) / Lokalisierung | Kerninhalt | Implementiert | /webadmin/locales, Locales in der Site-Bearbeitung | Locale-bewusste Seiten und öffentliche URLs | Über die Internal Content API auffindbar | Lokalisierte Seitenübersetzungen und Locale-Routing | docs/localization.md, docs/multisite.md | abgedeckt |
| Seiten | Page Builder | Implementiert | /webadmin/pages | Veröffentlichte Seiten werden über das öffentliche CMS-Routing gerendert | Seiten-Lesezugriff und Content-Plan-Unterstützung | Relationale Seiten, Übersetzungen, Slots und Blöcke | docs/core-concepts.md, docs/internal-content-api.md | Benutzerhandbuch erforderlich |
| Seiten-Layouts | Page Builder | Implementiert | /webadmin/page-layouts, Edit-Page-Einstellungen | Öffentliches Shell- und Slot-Wrapper-Verhalten | Für Content-Planung auffindbar | Verwaltete Layouts mit Layout-Slots und Body-Klassen | docs/page-layouts.md | abgedeckt |
| Slots | Page Builder | Implementiert | Edit-Page-Slot-Editor | Slot-Bereiche rendern seiteneigene oder geteilte Inhalte | Content-Pläne zielen auf seiteneigene Slots | Slots trennen Seitenbereiche vom Blockinhalt | docs/core-concepts.md, docs/page-layouts.md | Page-Builder-Übersicht erforderlich |
| Shared Slots | Page Builder | Implementiert | /webadmin/shared-slots, Edit-Page-Slot-Quelle | Wiederverwendbare site-bezogene Slot-Blockbäume werden in Seiten gerendert | Shared-Slot-API-Grundlagen und Zuweisungsunterstützung | Referenzen auf geteilte Inhalte, keine kopierten Vorlagen | docs/core-concepts.md, docs/internal-content-api.md | Benutzerhandbuch erforderlich |
| Blöcke | Page Builder | Implementiert | Edit-Page-Slot-Block-Editor | Blöcke rendern öffentliche Seiteninhalte | Block-/Inhalts-Discovery und Content-Pläne | Relationale Blockbäume mit Übersetzungen und Einstellungen | docs/core-concepts.md, docs/public-block-render-markup.md | Page-Builder-Übersicht erforderlich |
| Blocktyp-Verträge | Page Builder | Implementiert | /webadmin/block-types Vertrags-Modal | Leitet sicheres Renderer- und Editor-Verhalten an | Content-Contract- und Discovery-Oberflächen stellen Blockverträge bereit | Die Vertrags-Registry definiert Felder, Einstellungen und Fähigkeiten | docs/block-type-contracts.md, docs/api-discovery.md | abgedeckt |
| Page Builder | Page Builder | Implementiert | Edit Page | Erstellt öffentliche Seiten aus Layouts, Slots und Blöcken | Entwurfssichere Inhaltsvalidierung/-anwendung | Zentrales Bearbeitungsmodell für seiteneigene Inhalte | docs/core-concepts.md, docs/ai-page-building-guide.md | Page-Builder-Übersicht erforderlich |
| Seiten-Assets | Page Builder | Implementiert | Edit Page -> Page Management -> Assets | Seitenbezogenes CSS und JS wird nur auf der besitzenden Seite gerendert | Keine primäre Content-Plan-Oberfläche | Relationale Seiten-Assets unter site-bezogenen öffentlichen Pfaden | docs/public-assets.md, README.md | Benutzerhandbuch erforderlich |
| Medienbibliothek | Inhalts-Assets | Implementiert | /webadmin/media | Öffentliche Mediendateien können von Blöcken und Assets referenziert werden | Bestehende Medienreferenzen sind für spätere API-Nutzung geplant | Site-bezogene Medienverwaltung und Nutzungsprüfungen | docs/core-concepts.md, docs/public-assets.md | Medien-Leitfaden erforderlich |
| Navigation | Öffentliche Struktur | Implementiert | /webadmin/navigation | Navigationsblöcke und Menüs rendern die öffentliche Navigation | Navigations-API-Grundlagen | Site-bezogene Menüs und Einträge mit Gruppen und Icons | docs/internal-content-api.md, README.md | Benutzerhandbuch erforderlich |
| Navbar-/Header-Komposition | Öffentliche Struktur | Implementiert | Page-Builder-Blockauswahl | Navbar, Brand, Navigation und Header-Aktionen setzen öffentliche Header zusammen | Erstellbar, wenn in Blockverträgen entdeckt | Systemeigene Navbar-Primitive und komponierbare Kind-Elemente | docs/public-block-render-markup.md, README.md | Page-Builder-Übersicht erforderlich |
| Seitenvorschau | Redaktion | Implementiert | Edit Page -> Preview | Authentifizierte Vorschau für Entwürfe, Seiten in Prüfung und veröffentlichte Seiten | Vorschau-URLs können von Operator-Workflows gemeldet werden | Verwendet öffentliches Rendering mit Noindex-Vorschau-Banner | docs/editorial-workflow.md, docs/internal-content-api.md | abgedeckt |
| Seiten-Revisionen | Redaktion | Implementiert | Edit-Page-Revisionen | Stellt frühere Seiteninhalte sicher für Editoren wieder her | Keine primäre API-Schreiboberfläche | Seiten-Revisions-Snapshots mit Akteur-/Quellmetadaten | docs/revisions.md | abgedeckt |
| Shared-Slot-Revisionen | Redaktion | Implementiert | Shared-Slot-Revisionen | Stellt wiederverwendbare geteilte Inhalte wieder her | Keine primäre API-Schreiboberfläche | Shared-Slot-Revisionsverlauf und Wiederherstellung | docs/revisions.md | abgedeckt |
| Seiten-Konverter | Page Builder | Implementiert | /webadmin/pages, Import-/Konvertierungs-Flows | Erstellt CMS-Seitenentwürfe aus geprüfter statischer HTML-Analyse | Verwendet interne Content-Planungskonzepte, keine öffentliche API | Bereichsbezogene HTML-Analyse und signierte Konvertierungspläne | docs/page-converter-roadmap.md, README.md | Benutzerhandbuch erforderlich |
| Einzelseiten-Import | Page Builder | Implementiert | /webadmin/pages -> Import Page | Erstellt eine Entwurfsseite aus einer dokumentierten JSON-Payload | Getrennt von der Internal Content API | Admin-Modal-Workflow für geprüften Einzelseiten-JSON-Import | README.md | Benutzerhandbuch erforderlich |
Redaktioneller Workflow und Berechtigungen
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quell-/Implementierungshinweise | Vorhandene Doku | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| Workflow Entwurf / In Prüfung / Veröffentlicht / Archiviert | Redaktion | Implementiert | Edit Page -> Overview | Öffentliche Routen rendern nur veröffentlichte Seiten | Die API bleibt für Inhalts-Schreibvorgänge Entwurf-zuerst | Seitenstatus trennen Erstellung, Prüfung, Veröffentlichung und Archivierung | docs/editorial-workflow.md | abgedeckt |
| Editor-Rolle | Berechtigungen | Implementiert | /webadmin/users, Rollenverwaltung | Editoren können zugewiesene Inhalte im Rahmen ihrer Berechtigungen verwalten | Autorisierung wirkt sich auf Admin-/API-Zugriff aus | CMS-Rolle getrennt vom Admin-Status des Host-Produkts | docs/users-and-permissions.md | abgedeckt |
| Site-Admin-Rolle | Berechtigungen | Implementiert | /webadmin/users, Rollenverwaltung | Site-Admins verwalten Inhalte zugewiesener Sites | Autorisierung wirkt sich auf Admin-/API-Zugriff aus | Site-bezogene Verwaltungsrolle | docs/users-and-permissions.md | abgedeckt |
| Super-Admin-Rolle | Berechtigungen | Implementiert | /webadmin/users, Rollenverwaltung | CMS-Verwaltung auf Installationsebene | Für Token- und Systemoperationen erforderlich | Der CMS-Super-Admin ist eine CMS-Rolle, kein Host-Admin-Status | docs/users-and-permissions.md, ARCHITECTURE_DECISIONS.md | abgedeckt |
| Zugriff auf zugewiesene Sites | Berechtigungen | Implementiert | Benutzerverwaltung | Beschränkt Admin-Arbeit auf zugewiesene Sites | Gilt für die API-Autorisierung | Site-Mitgliedschaften beschränken den CMS-Zugriff | docs/users-and-permissions.md, docs/multisite.md | abgedeckt |
| Workflow-Übergänge | Redaktion | Implementiert | Edit Page -> Overview | Steuert, wann Seiten öffentlich werden oder die Veröffentlichung verlassen können | Der Veröffentlichungs-Workflow bleibt von normalen Content-Plänen getrennt | Übergangsberechtigungen schützen redaktionelle Statusänderungen | docs/editorial-workflow.md | abgedeckt |
| Veröffentlichungsberechtigungen | Berechtigungen | Implementiert | Rollen-/Benutzerberechtigungen | Legt fest, wer öffentliche Seiten veröffentlichen darf | Die Publish-API-Fähigkeit ist fortgeschritten und getrennt | Veröffentlichung ist für KI-/Operator-Schreibvorgänge bewusst nicht der Standard | docs/editorial-workflow.md, docs/internal-content-api.md | KI-/Operator-Beispiel erforderlich |
| Archivierungsberechtigungen | Berechtigungen | Implementiert | Rollen-/Benutzerberechtigungen | Steuert die Entfernung aus der öffentlichen Veröffentlichung | Kein normales Content-Plan-Verhalten | Archivierung ist redaktioneller Workflow, keine destruktive Löschung | docs/editorial-workflow.md | abgedeckt |
| Berechtigungen für Revisionswiederherstellung | Berechtigungen | Implementiert | Revisionsansichten für Seiten und Shared Slots | Wiederhergestellte Inhalte wirken sich nach der Veröffentlichung auf künftiges öffentliches Rendering aus | Kein normales Content-Plan-Verhalten | Wiederherstellungs-Flows erfordern CMS-Autorisierung | docs/revisions.md | abgedeckt |
| CMS-Profilseite | Admin-UX | Implementiert | /webadmin/profile | Kein direktes öffentliches Verhalten | Nicht API-orientiert | Angemeldete Admins verwalten ihr eigenes Profil | README.md | Benutzerhandbuch erforderlich |
| Benutzer auf Installationsebene | Berechtigungen | Implementiert | /webadmin/users | Kein direktes öffentliches Verhalten | Autorisierung wirkt sich auf API-Tokens und Zugriff aus | Die CMS-Benutzerverwaltung verknüpft CMS-Rollen mit Host-Benutzern | docs/users-and-permissions.md | abgedeckt |
Öffentliche Site-Features
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quell-/Implementierungshinweise | Vorhandene Doku | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| Öffentliches Seiten-Rendering | Öffentliche Site | Implementiert | Page Builder und öffentliche Einstellungen | Rendert veröffentlichte CMS-Seiten aus Layouts, Slots und Blöcken | Content-Pläne können renderbare Entwurfsseiten erstellen | Der öffentliche Presenter löst Sites, Seiten, Slots, Shared Slots und Blöcke auf | docs/core-concepts.md, docs/public-block-render-markup.md | Page-Builder-Übersicht erforderlich |
| Öffentliche Suche | Öffentliche Site | Implementiert | Maintenance -> Search Rebuild, öffentliche Sucheinstellungen | Site-/Locale-bezogene öffentliche Suchergebnisse | Keine Delivery-API | Datenbankgestützter Suchindex | docs/search.md | abgedeckt |
| Such-Modal | Öffentliche Site | Implementiert | Header-Actions-Block und öffentliche Assets | Über den Header ausgelöstes Such-Modal | Nicht API-orientiert | Verwendet die CMS-eigene öffentliche Such-Modal-Laufzeit | docs/search.md, README.md | abgedeckt |
| Search-Form-Block | Öffentliche Blöcke | Implementiert | Page-Builder-Blockauswahl | Rendert das öffentliche Suchformular | Erstellbar, wenn in Blockverträgen entdeckt | Blockbasierter Sucheinstiegspunkt | docs/search.md, docs/public-block-render-markup.md | abgedeckt |
| Besucherberichte | Analytics | Implementiert | /webadmin/visitor-reports | Datenschutzfreundliche Berichterstattung über öffentlichen Traffic | Keine öffentliche Delivery-API | Besucherereignis-Aggregate und Reporting | README.md | Benutzerhandbuch erforderlich |
| Site-Branding / SEO-Standardwerte | Öffentliche Site | Implementiert | Edit Site -> Branding, SEO Defaults | Öffentlicher Metadaten-Fallback und Brand-Assets | Site-Discovery-Oberflächen stellen Kontext bereit | Site-eigener Anzeigename, Tagline, SEO-Standardwerte, Favicon, Social-Bild | docs/core-concepts.md, README.md | Benutzerhandbuch erforderlich |
| SEO-Überschreibungen auf Seitenebene | Öffentliche Site | Implementiert | Einstellungen der Seitenübersetzung | Locale-bewusste Überschreibungen von Seitenmetadaten | Seiten-Leseoberflächen enthalten Seitenmetadaten-Kontext | SEO-Werte liegen auf Seitenübersetzungen | README.md, docs/localization.md | Benutzerhandbuch erforderlich |
| Favicon / Social-Bild | Öffentliche Site | Implementiert | Edit Site -> Branding | Öffentliche Favicon- und Social-Preview-Fallbacks | Keine primäre API-Schreiboberfläche | Brand-Medien-Unterstützung auf Site-Ebene | README.md | Benutzerhandbuch erforderlich |
| Site-Variablen | Öffentliche Site | Implementiert | Edit Site -> Variables | Ersetzt {{ site.variable_key }}-Tokens im unterstützten öffentlichen Rendering | Keine primäre API-Schreiboberfläche | Relationale, wiederverwendbare, site-bezogene Text-Tokens | README.md | Benutzerhandbuch erforderlich |
| Multisite-Routing | Öffentliche Site | Implementiert | /webadmin/sites, Domainverwaltung | Leitet Anfragen an die passende Site/Domain weiter | Site-Discovery unterstützt Operator-Kontext | Primär- und Alias-Domains pro Site | docs/multisite.md, docs/coexistence.md | abgedeckt |
| Lokalisierte öffentliche URLs | Öffentliche Site | Implementiert | Locales und Seitenübersetzungen | Locale-bewusste Seitenpfade und Fallbacks | Locale-Discovery unterstützt Operator-Kontext | Seitenübersetzungen und Locale-Routing | docs/localization.md | abgedeckt |
Formulare und Nachrichten
Contact Form und Contact Messages sind erstklassige Features von WebBlocks CMS. Der benutzerorientierte Leitfaden zu Einrichtung, Übermittlung, Spam-Behandlung, E-Mail-Fallback und Fehlerbehebung befindet sich jetzt in docs/contact-forms-and-messages.md.
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quell-/Implementierungshinweise | Vorhandene Doku | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| Contact-Form-Block | Formulare | Implementiert | Page-Builder-Blockauswahl | Rendert ein öffentliches Formular und speichert Übermittlungen | Über Content-Pläne erstellbar, wenn contact_form entdeckt wird | Erstklassiger Block mit Empfänger-Fallback-Unterstützung | docs/contact-forms-and-messages.md, docs/block-type-contracts.md, docs/public-block-render-markup.md | abgedeckt |
| Contact-Messages-Admin-Ansicht | Formulare | Implementiert | /webadmin/contact-messages | Keine öffentliche Auflistung; Admins prüfen Übermittlungen | Keine öffentliche Delivery-API | Die Admin-Tabelle enthält Zustell- und Spam-Status | docs/contact-forms-and-messages.md, README.md | abgedeckt |
| Speicherung von Kontaktformular-Übermittlungen | Formulare | Implementiert | Contact Messages | Speichert echte öffentliche Übermittlungen zur Prüfung | Nicht API-orientiert | Übermittlungen werden vor E-Mail-Benachrichtigungsversuchen gespeichert | docs/contact-forms-and-messages.md | abgedeckt |
| Verwerfen per Anti-Spam-Prüfung | Formulare | Implementiert | Contact-Form-Renderer und Übermittlungsverarbeitung | Übermittlungen mit ausgefülltem generiertem Prüffeld erhalten die normale Erfolgsumleitung und werden verworfen | Nicht API-orientiert | CMS-eigenes verstecktes .wb-form-check, vom nativen Renderer generiert | docs/contact-forms-and-messages.md | abgedeckt |
| Spam-Bewertung / Quarantäne | Formulare | Implementiert | Contact Messages | Verdächtige Übermittlungen können zur Admin-Prüfung unter Quarantäne gestellt werden | Nicht API-orientiert | Konservative Spam-Signale für Links, kommerzielle Muster und wiederholte IPs | docs/contact-forms-and-messages.md | abgedeckt |
| E-Mail-Benachrichtigungs-Fallback-Kette | Formulare | Implementiert | Contact-Form-Block, Edit Site -> Contact, Umgebungs-Mail | Versucht die Empfängerauflösung über Block, Site und sicheren Mail-Fallback | Nicht API-orientiert | Zustellversuche erfolgen nach dauerhafter Speicherung; die Einrichtungsanleitung behandelt .env, Site-Empfänger und das Leeren des Caches | docs/contact-forms-and-messages.md, docs/installation.md, docs/getting-started.md | abgedeckt |
| Diagnosebefehl für Kontakt-Mail | Betrieb | Implementiert | Operator-seitige Diagnose | Kein öffentliches Verhalten | Nicht API-orientiert | Geheimnis-sichere Mail-Konfigurationsdiagnose und kontrollierte SMTP-Sendeprüfungen | docs/contact-forms-and-messages.md, docs/operations.md, README.md | abgedeckt |
| Zustellstatus / Fehlerdetails | Formulare | Implementiert | Contact Messages | Keine öffentliche Offenlegung von Fehlern | Nicht API-orientiert | Gespeicherte Nachrichten enthalten einen für Admins sichtbaren Benachrichtigungsstatus | docs/contact-forms-and-messages.md | abgedeckt |
Internal Content API und KI-Operationen
Die Internal Content API ist für vertrauenswürdige KI-/Operator-Tools gedacht. Sie ist keine öffentliche Delivery-API, keine Integration eines KI-Anbieters und kein Ersatz für Import/Export. KI-/Operator-Tools müssen Live-Discovery verwenden und dürfen Block-Handles nicht raten.
Empfohlene zusätzliche Dokumente:
docs/ai-page-building-overview.md- docs/contact-forms-and-messages.md existiert jetzt.
- docs/markdown-docs-to-cms-sync.md existiert bereits.
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quelle / Implementierungshinweise | Vorhandene Dokumentation | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| API-Tokens | KI-Operationen | Implementiert | /webadmin/system/api-tokens | Kein öffentliches Verhalten | Bearer-Token-Authentifizierung | Tokens werden gehasht und nur einmal angezeigt | docs/internal-content-api.md, docs/api-discovery.md | abgedeckt |
| Token-Capabilities | KI-Operationen | Implementiert | API-Token erstellen/bearbeiten | Kein öffentliches Verhalten | Capability-basierte API-Autorisierung | Veröffentlichungs-/Lösch-Capabilities sind erweiterte Opt-ins | docs/internal-content-api.md | benötigt KI-/Operator-Beispiel |
| API-Discovery-Endpunkt | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Discovery-Root für vertrauenswürdige Tools | Beginnt mit der API-Basis-URL und dem Token | docs/api-discovery.md | abgedeckt |
| OpenAPI-Endpunkt | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Maschinenlesbarer API-Vertrag | Von der Discovery verlinkt | docs/api-discovery.md, docs/internal-content-api.md | abgedeckt |
| KI-Leitfaden-Endpunkt | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Leitfaden-Link aus der Discovery | Hilft Operatoren, sicher zu bauen | docs/ai-page-building-guide.md | benötigt Überblick |
| Content-Contract-Endpunkt | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Block-/Content-Vertrags-Discovery | Vor der Inhaltsplanung erforderlich | docs/api-discovery.md, docs/block-type-contracts.md | abgedeckt |
| Beispiel-Endpunkt | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Discovery von Beispiel-Content-Plänen | Von der Discovery verlinkt | docs/api-discovery.md | benötigt KI-/Operator-Beispiel |
| Seiten-Lese-API | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Schreibgeschützte Seiteninspektion | Ressourcenartiger Endpunkt unter der internen API | docs/internal-content-api.md | abgedeckt |
| Block-/Content-Discovery | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Inspektion von Block-Verträgen und Inhalten | Verhindert geratene Block-Handles | docs/block-type-contracts.md, docs/api-discovery.md | abgedeckt |
| Content-Validierung | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Validiert Content-Pläne vor dem Apply | Erforderlicher Sicherheitsschritt für Operator-Workflows | docs/internal-content-api.md, docs/ai-page-building-guide.md | abgedeckt |
| Content-Apply | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Erstellt CMS-Inhalte als Entwurf, standardmäßig nicht öffentlich | Wendet genehmigte Content-Pläne an | Standardmäßig Entwurf-zuerst und nicht-destruktiv | docs/internal-content-api.md, docs/ai-page-building-guide.md | abgedeckt |
| Entwurfssichere Seitenerstellung | KI-Operationen | Implementiert | Erstellte Seite erscheint unter Pages | Entwurfsseiten können vor der Veröffentlichung in der Vorschau angezeigt werden | Über Content-Pläne unterstützt | Erstellt Seiten, Slots, Übersetzungen und Block-Bäume | docs/internal-content-api.md | benötigt KI-/Operator-Beispiel |
| replace_existing_draft_page / entwurfssicheres Ersetzungsmodell | KI-Operationen | Implementiert | Vorhandene Entwurfsseite unter Pages | Ersetzt nur verwaltete Slots, die der Entwurfsseite gehören | Unterstützter Validate-/Apply-Modus | Verwendet Sicherheitsprüfungen über erwarteten Pfad oder updated-at | docs/internal-content-api.md, docs/markdown-docs-to-cms-sync.md | benötigt KI-/Operator-Beispiel |
| Grundlagen der Navigations-API | KI-Operationen | Implementiert | Navigationsressourcen im Admin | Geplante Inhalte können nach Genehmigung die öffentliche Navigation beeinflussen | Grundlagen für Navigationsmenüs und -einträge | Sichere Grundlagen ohne breites destruktives Verhalten | docs/internal-content-api.md | benötigt KI-/Operator-Beispiel |
| Grundlagen der Shared-Slot-API | KI-Operationen | Implementiert | Shared-Slots-Admin | Gemeinsame Inhalte können nach Genehmigung seitenübergreifend gerendert werden | Grundlagen für Shared Slots und Zuweisungen | Unterstützung kompatibler Zuweisungen innerhalb derselben Site | docs/internal-content-api.md | benötigt KI-/Operator-Beispiel |
| Nur-JSON-Fehler | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | API-Fehler liefern JSON zurück | Trennt die Operator-API von Browser-Admin-Antworten | docs/internal-content-api.md | abgedeckt |
| CSRF-freies Bearer-API-Schreibverhalten | KI-Operationen | Implementiert | Kein Browser-Admin-Pfad | Kein öffentliches Verhalten | Bearer-Schreibvorgänge hängen nicht vom Browser-CSRF ab | Vertrauenswürdiger Token-Vertrag für Operator-Tools | docs/internal-content-api.md | abgedeckt |
| Meldung von Vorschau-URLs | KI-Operationen | Implementiert | Edit-Page-Vorschau | Operatoren können Entwurfs-Vorschauen prüfen | Apply-Antworten können den Vorschau-Kontext melden | Die Vorschau bleibt authentifiziert und entwurfssicher | docs/ai-page-building-guide.md, docs/editorial-workflow.md | abgedeckt |
| Entwurf-zuerst-Workflow für KI-Seitenerstellung | KI-Operationen | Implementiert | Seiten- und Vorschau-Bildschirme | KI-erstellte Seiten sind bis zur Genehmigung Entwürfe | Discovery-, Validate-, Apply-Workflow | Erfordert Live-Discovery und exakte Verträge | docs/ai-page-building-guide.md | benötigt docs/ai-page-building-overview.md |
| Runbook für die Markdown-Docs-zu-CMS-Synchronisierung | Dokumentation | Dokumentierte Richtung | Kein Laufzeit-Admin-Pfad | Künftige quellenverknüpfte Doku-Seiten können aus Markdown abgeleitete Inhalte veröffentlichen | Würde Discovery-, Validate- und genehmigte entwurfssichere Apply-Workflows verwenden | Die Markdown-Quelle bleibt maßgeblich, und geänderte docs/-Dateien steuern die KI-/Operator-Planung | docs/markdown-docs-to-cms-sync.md | abgedeckt |
Betrieb
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quelle / Implementierungshinweise | Vorhandene Dokumentation | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| System-Updates | Betrieb | Implementiert | /webadmin/system/updates | Aktualisiert installierten CMS-Code und Paket-Assets | Keine öffentliche Auslieferungs-API | Paket-nativer Update-Ablauf | docs/updates.md, docs/operations.md | benötigt Operator-Leitfaden |
| Release-Paket-Updates | Betrieb | Implementiert | System-Updates | Öffentliches Site-Verhalten ändert sich nach genehmigtem Update | Nicht API-orientiert | Verwendet Paket-Release-Artefakte | docs/updates.md, docs/package-architecture.md | benötigt Operator-Leitfaden |
| Paket-natives Update-Root | Betrieb | Implementiert | System-Updates | Kein direktes öffentliches Verhalten | Nicht API-orientiert | Kanonisches Paket-Root ist vendor/fklavyenet/webblocks-cms | docs/package-architecture.md, ARCHITECTURE_DECISIONS.md | abgedeckt |
| Update-Migrationen | Betrieb | Implementiert | System-Updates | Hält das zur Laufzeit erforderliche Schema aktuell | Nicht API-orientiert | Paket-Update-Migrationen unterstützen bestehende Installationen | docs/updates.md, ARCHITECTURE_DECISIONS.md | abgedeckt |
| Update-Bereitschaft | Betrieb | Implementiert | System-Updates | Kein öffentliches Verhalten | Nicht API-orientiert | Bereitschafts- und Release-Detail-Prüfungen vor dem Update | docs/updates.md | benötigt Operator-Leitfaden |
| Letzter Update-Lauf | Betrieb | Implementiert | System-Updates | Kein öffentliches Verhalten | Nicht API-orientiert | Berichte über den letzten Lauf für Operatoren | docs/updates.md, README.md | benötigt Operator-Leitfaden |
| Support-Bericht | Betrieb | Implementiert | System-Updates | Kein öffentliches Verhalten | Nicht API-orientiert | Herunterladbare Support-Diagnosen für Update-Probleme | docs/updates.md | benötigt Operator-Leitfaden |
| Backups | Betrieb | Implementiert | /webadmin/backups | Schützt Site-Inhalte und Installationszustand | Nicht API-orientiert | Backup-Datensätze und Speicher-Disk | docs/operations.md | abgedeckt |
| Wiederherstellung | Betrieb | Implementiert | Wiederherstellungsablauf unter /webadmin/backups | Wiederhergestellte Inhalte können die öffentliche Site beeinflussen | Nicht API-orientiert | Kontrollierter Backup-Wiederherstellungs-Workflow | docs/operations.md | abgedeckt |
| Site-Export / -Import | Betrieb | Implementiert | /webadmin/site-transfers/exports, /webadmin/site-transfers/imports | Verschiebt Site-Inhalte zwischen Installationen | Getrennt von der Internal Content API | Paketiert Inhalte, Medien, Navigation und zugehörige Site-Daten | docs/operations.md, README.md | benötigt Benutzerhandbuch |
| Site-Klonen / -Promotion | Betrieb | Implementiert / dokumentiert | Site- und Promotion-Workflows | Geklonte/promotete Site-Inhalte können öffentlich werden | Keine öffentliche Auslieferungs-API | Paketbasierte Site-Transfer- und Promotion-Konzepte | docs/operations.md, README.md | benötigt Operator-Leitfaden |
| Suchindex-Neuaufbau | Betrieb | Implementiert | Maintenance -> Search Rebuild | Aktualisiert den öffentlichen Suchindex | Nicht API-orientiert | Baut die datenbankgestützte öffentliche Suche neu auf | docs/search.md, docs/operations.md | abgedeckt |
| Katalog-Reparaturbefehle | Betrieb | Implementiert | Wartung auf Operator-Seite | Repariert die von Admin/Rendering genutzten CMS-Kataloge | Nicht API-orientiert | Wartungsbefehle für Katalogkonsistenz | docs/operations.md, README.md | benötigt Operator-Leitfaden |
| Installationsassistent | Installation | Implementiert | Installationsbildschirme beim ersten Start | Erstellt den anfänglichen CMS-Installationszustand | Nicht API-orientiert | Browsergeführte Ersteinrichtung | docs/installation.md | abgedeckt |
| Paket-Consumer-Installation | Installation | Implementiert | Paket-Installations-Workflow | Aktiviert öffentliche/Admin-Routen des CMS in einer Host-Anwendung | Nicht API-orientiert | Der Paket-Installer bereitet Schema, Assets und den ersten Benutzer vor | docs/installation.md, README.md | abgedeckt |
| Native lokale Entwicklung | Entwicklung | Doku implementiert | Nur lokale Entwicklung | Lokale .test-Entwicklungsumgebung | Nicht API-orientiert | Anleitung für HTTPS-only lokale Entwicklung | docs/native-local-development.md | abgedeckt |
| Teststrategie | Entwicklung | Doku implementiert | Entwicklungs-Workflow | Kein direktes öffentliches Verhalten | Nicht API-orientiert | Risikobasierte Testskripte und Validierungsleitfaden | docs/testing-strategy.md | abgedeckt |
Plugin-System
| Feature | Bereich | Status | Admin-Pfad | Öffentliches Verhalten | API-Unterstützung | Quelle / Implementierungshinweise | Vorhandene Dokumentation | Dokumentationslücke / nächste Doku-Seite |
|---|---|---|---|---|---|---|---|---|
| Plugin-Host-Architektur | Plugins | Implementierte Grundlagen | /webadmin/system/plugins | Plugins können bei Aktivierung öffentliches Verhalten hinzufügen | Keine generische öffentliche API | Der CMS-Kern ist ein Plugin-Host | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | abgedeckt |
| Manuelle ZIP-Plugin-Installation | Plugins | Implementiert | System -> Plugins -> Upload | Installierte Plugins sind standardmäßig deaktiviert | Nicht API-orientiert | Storage-eigener Installationspfad und Paketvalidierung | docs/plugin-system.md | benötigt Plugin-Lifecycle-Leitfaden |
| Standardmäßig deaktivierter Plugin-Lifecycle | Plugins | Implementiert | System -> Plugins | Deaktivierte Plugins sind inaktiv | Nicht API-orientiert | Installierte Pakete müssen explizit aktiviert werden | docs/plugin-system.md | abgedeckt |
| Aktivieren / Deaktivieren | Plugins | Implementiert | System -> Plugins | Aktiviert oder entfernt aktives Plugin-Verhalten | Nicht API-orientiert | Kompatibilitäts- und Setup-Prüfungen sichern die Aktivierung ab | docs/plugin-system.md | benötigt Plugin-Lifecycle-Leitfaden |
| Plugin-Setup / -Migrationen | Plugins | Implementierte Grundlagen | Plugin-Detail-/Setup-Bildschirme | Plugin-Verhalten kann ein Setup erfordern, bevor Routen funktionieren | Nicht API-orientiert | Fehlende plugineigene Tabellen zeigen kontrollierte Setup-Hinweise | docs/plugin-system.md | benötigt Plugin-Lifecycle-Leitfaden |
| Plugin-Berechtigungen | Plugins | Implementiert | Rollen-/Benutzer-Berechtigungsverwaltung | Steuert den Zugriff auf Plugin-Admin-Routen | Nicht API-orientiert | Berechtigungen sind mit Handle-Präfix versehen | docs/plugin-system.md | abgedeckt |
| Plugin-Admin-Routen | Plugins | Implementiert | /webadmin/plugins/{plugin-handle} | Browser-Admin-Verhalten des Plugins bei Aktivierung | Nicht API-orientiert | Routen sind nur bei Aktivierung verfügbar und Namespace-geschützt | docs/plugin-system.md | abgedeckt |
| Plugin-Zustand/-Status | Plugins | Implementiert | System -> Plugins | Kein direktes öffentliches Verhalten | Nicht API-orientiert | Health-Checks und Kompatibilitätsstatus | docs/plugin-system.md | abgedeckt |
| Plugineigene Blocks/Block-Packs | Plugins | Implementierte Grundlagen | Block-Auswahl bei aktivem Plugin | Plugin-Blocks können öffentliche Inhalte rendern | Auffindbar, wenn Block-Verträge sie offenlegen | Plugin-Block-Handles gehören dem Plugin | docs/plugin-system.md, docs/block-type-contracts.md | benötigt Plugin-Lifecycle-Leitfaden |
| Öffentliche Asset-Hooks | Plugins | Implementierte Grundlagen | Plugin-Registrierung | Plugins können sichere öffentliche Assets beisteuern | Nicht API-orientiert | Sichere Hooks für Head- und Body-Ende-Beiträge | docs/plugin-system.md | abgedeckt |
| Plugin-Katalog-Browser | Plugins | Implementiert | System -> Plugins -> Browse Plugin Catalog | Kein direktes öffentliches Site-Verhalten | Liest Katalog-Metadaten, keine öffentliche Auslieferungs-API | Durchsuchen öffentlicher Katalog-Metadaten | docs/plugin-system.md, docs/plugin-ecosystem-and-catalog.md | benötigt Plugin-Lifecycle-Leitfaden |
| Katalog-Installation | Plugins | Implementiert | Plugin-Katalog-Detail | Installiertes Plugin bleibt bis zur Aktivierung deaktiviert | Nicht API-orientiert | Checksummen-verifizierte Installation von Katalog-Artefakten | docs/plugin-system.md | benötigt Plugin-Lifecycle-Leitfaden |
| Katalog-gestützte Plugin-Updates | Plugins | Implementiert | System -> Plugins | Aktualisiertes Plugin-Verhalten nach genehmigtem Update | Nicht API-orientiert | Verwendet den Checksummen- und Paketvalidierungspfad wieder | docs/plugin-system.md | benötigt Plugin-Lifecycle-Leitfaden |
| Manuelle Deinstallation | Plugins | Implementiert | System -> Plugins | Entfernt ein deaktiviertes hochgeladenes Plugin-Paket | Nicht API-orientiert | Bewahrt plugineigene Datenbanktabellen | docs/plugin-system.md | abgedeckt |
| WebBlocks UI Manager als Operator-Plugin, nicht als gebündeltes CMS-Kernfeature | Plugins | Implementierte Architektur | Nur bei manuellem Upload/Aktivierung installiert | Kein gewöhnliches CMS-Laufzeitverhalten | Nicht API-orientiert | First-Party-Operator-Plugin bleibt außerhalb des gebündelten Kerns | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | abgedeckt |
Dokumentation und Produkt-Site-Bereitschaft
Die aktuelle Dokumentation ist technisch umfangreich, aber die Auffindbarkeit der Features ist unvollständig. Dieses Inventar soll bei der Entscheidung helfen, welche benutzerorientierten Doku-Seiten fehlen und welche Quellseiten später als quellenverknüpfte Dokumentationsseiten auf einer Ziel-Dokumentations-Site veröffentlicht werden können.
Priorisierte Dokumentationsseiten:
- Überblick über KI-Seitenerstellung
- Überblick über den Page Builder
- Feature-Inventar
- Fehlerbehebung für Formulare / Nachrichten
- Plugin-Lifecycle-Leitfaden
- Operator-Leitfaden für System-Updates
Die Marketing-Inhalte von webblocksui.com sollten von der technischen Dokumentation getrennt bleiben. Marketing-Seiten können den Produktwert zusammenfassen, während die Markdown-Dokumentation die Quelle für technische und Operator-Anleitungen bleiben sollte.