Websites (Website-Baukasten)

Zweck

Mit dem Website-Baukasten (/websites, neu Juni 2026) kann eine Firma ihre eigene öffentliche Website oder Landingpage bauen, mit einem KI-Editor bearbeiten, veröffentlichen und direkt aus SpeamCore hosten. Typischer Einsatz: eine Internet-Seite für die eigenen Brandschutz-Leistungen mit Kontaktformular für Kundenanfragen.

Pro Website (Website) gibt es einen Entwurf (Arbeitsstand) und eine veröffentlichte Fassung (live). Veröffentlichte Seiten sind öffentlich unter einer Adresse vom Typ /sites/<slug> erreichbar. Mehrseiten (WebsitePage), ein Versionsverlauf und eingegangene Kontaktformular-Anfragen (WebsiteLead) gehören dazu.

Voraussetzungen

- Berechtigung `view:FE_Website` und `view:Website` (das Navigations-Kachel „Website" erscheint nur dann). Die Rolle wird vom Admin vergeben. - Zum Veröffentlichen zusätzlich `do:PublishWebsite`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Website, Website	Liste/Editor aufrufbar	APP_SPEAMCORE_VIEW_WEBSITE
create/update/delete	Website	Website anlegen/bearbeiten/löschen	APP_SPEAMCORE_CREATE/UPDATE/DELETE_WEBSITE
do	PublishWebsite	Veröffentlichen / Zurückziehen	APP_SPEAMCORE_DO_PUBLISH_WEBSITE

Schritt-für-Schritt-Anleitung

Website anlegen + bearbeiten

1. Website (/websites) → + Neue Website.
2. Im Editor (/websites/:id) arbeiten Sie über mehrere Tabs:

Tab	Inhalt
Allgemein	Name, Slug (öffentliche Adresse), Grund-Einstellungen.
Seiten	Unterseiten verwalten (Mehrseiten-Website).
Files	Dateien/Bilder für die Website.
Design & SEO	Design-Optionen, SEO-Angaben, Favicon, OG-Bild, eigene Domain, DSGVO-Consent-Banner, Kontaktformular-Schalter.
Footer	Fußzeile mit Live-Vorschau.
Verlauf	Versions-Historie mit Wiederherstellen (Rollback).
Leads	Eingegangene Kontaktformular-Anfragen.

3. Veröffentlichen — schaltet den aktuellen Entwurf live (do:PublishWebsite). Zurückziehen nimmt die Seite wieder offline.

„Zentralen Rahmen verwenden"-Schalter (Design-Tab)

Im Design-Tab steuert der Schalter „Zentralen Rahmen verwenden", ob die Seite den zentralen SpeamCore-Rahmen (einheitlicher Kopf-/Fußbereich) nutzt:

• An: Die Seite wird in den zentralen Rahmen (Header/Footer) eingebettet — die Header-Optionen sind aktiv.
• Aus: Die Seite bringt ihr eigenes Kopf-/Fußdesign mit (z. B. aus einem importierten Template); die zentralen Header-Optionen sind dann ausgegraut. Technisch entspricht „Aus" einem Roh-Import (rawImport), der die zentralen Branding-Bausteine deaktiviert.

KI-Editor und Import

• KI-Editor: Über den Editor-Chat (POST /websites/:id/editor-chat) kann die Website KI-gestützt erstellt/angepasst werden.
• Migration: POST /websites/:id/migrate baut eine bestehende Website (per URL) KI-gestützt nach.
• Schnell-Import: POST /websites/:id/quick-import klont eine Vorlage ohne KI (setzt rawImport).

Öffentliche Auslieferung

Veröffentlichte Websites werden über nicht angemeldete Routen ausgeliefert:

Methode	Endpoint	Zweck
GET	/api/public-sites/:slug	Veröffentlichte Startseite rendern
GET	/api/public-sites/:slug/:path	Unterseite rendern
POST	/api/public-sites/:slug/contact	Kontaktformular absenden (erzeugt einen Lead)
GET	/api/public-sites/sitemap.xml / robots.txt	SEO-Auslieferung

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• KI-Chat-Aktionen — der KI-Editor nutzt den SpeamCore-Chat-Mechanismus.
• Anpassung — zentrales Branding (Logo, Farben), das der „Zentrale Rahmen" verwendet.

API/Schnittstellen (Auswahl)

Methode	Endpoint	Zweck	CASL
GET	/api/websites	Liste	view Website
POST	/api/websites	Anlegen	create Website
PATCH	/api/websites/:id	Bearbeiten	update Website
POST	/api/websites/:id/publish	Veröffentlichen	do PublishWebsite
POST	/api/websites/:id/unpublish	Zurückziehen	do PublishWebsite
POST	/api/websites/:id/editor-chat	KI-Editor-Chat öffnen	update Website + view Chat
POST	/api/websites/:id/migrate	Website per URL KI-gestützt nachbauen	update Website
POST	/api/websites/:id/quick-import	Vorlage klonen (rawImport)	update Website
GET	/api/websites/:id/revisions	Versionsverlauf	view Website
GET	/api/websites/:id/pages	Unterseiten	view Website
GET	/api/websites/:id/leads	Kontaktformular-Anfragen	view Website

Hinweise

Das Modul erscheint nur bei Anwendern mit `view:FE_Website`. Nicht jede Brandschutz-Firma nutzt den Website-Baukasten — er ist optional und muss vom Admin freigeschaltet werden.

Versionshinweise

• 2026-06-02: Initiale Veröffentlichung. Website-Baukasten mit Entwurf/Veröffentlicht-Trennung, 7 Editor-Tabs (Allgemein, Seiten, Files, Design & SEO, Footer, Verlauf, Leads), KI-Editor, Migration/Schnell-Import, „Zentraler Rahmen"-Schalter (rawImport), öffentlicher Auslieferung (/public-sites/:slug), Kontaktformular-Leads und Versionsverlauf. Quelle: FE WebsiteEditorPage.tsx, WebsiteNavigationTab.tsx, config/navigationTiles.ts; BE website.router.ts.