Loheide-eu-mitarbeiterplatt.../docs/PLAN.md
Friederich Loheide 82bbeef31b
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 2m7s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 2m11s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 2m16s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 2m18s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 2m49s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 2m46s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 2m41s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 2m33s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m0s
Phase 5: Erscheinungsbild mit Entwurf, Vorschau und Veröffentlichen
- Theme in den Einstellungen (Entwurf/veröffentlicht), Übernahme der
  Einstellungen aus Phase 0; statische CSS-Datei mit Hash beim Veröffentlichen
- Logos hell/dunkel, Signet, App-Symbol → Favicon, Homescreen-Symbole,
  Web-App-Manifest; SVG-Bereinigung
- Markenfarbe exakt, zweite Akzentfarbe, Kopfleiste hell/Marke/dunkel,
  Kontrastprüfung (WCAG AA) mit automatisch lesbarer Linkfarbe
- Lokale Schriften (Latein), Überschriften-Schrift, eigene WOFF2-Schrift,
  Ecken, Dichte, Dunkelmodus-Regel
- Anmeldeseite (geteilt/zentriert, Bild, Texte), Fußzeile, E-Mails im Design
- Admin: Live-Vorschau (Startseite, Anmeldung, Beispielseite; hell/dunkel),
  Veröffentlichen, Verwerfen, Export/Import, Zurücksetzen, eigenes CSS
- Admin-Bereich übernimmt Logo, Farbe und Favicon; Whitelabel

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 10:46:05 +00:00

26 KiB
Raw Permalink Blame History

Inhaus – Projektplan

Stand: 2026-09-25 · Status: Entwurf · Produktname: Inhaus (Arbeitstitel) (technischer Schlüssel beim Hersteller: mitarbeiterportal)

Ein modulares Mitarbeiterportal (Intranet/CMS) mit an- und abschaltbaren Plugins nach WordPress-Prinzip, Anbindung an Identity Provider (Schwerpunkt Microsoft Entra ID), feingranularem Berechtigungskonzept, Pagebuilder und anpassbarem Design. Kunden hosten selbst – auch auf Shared Webhosting. Lizenzpflichtig, mit Self-Updater und Rückmeldeweg zum Hersteller.

Mitgeltende Spezifikationen (verbindlich, wörtlich umzusetzen):


1. Rahmenbedingungen & Entscheidungen

Thema Entscheidung
Betriebsmodell Eigene Installation pro Kunde, vom Kunden selbst gehostet
Hosting-Ziel Muss auf Shared Webhosting laufen (Apache, PHP, MySQL – ohne Shell, Node, Docker, Redis)
Größe 10 bis 5.000 Mitarbeitende pro Instanz → Performance ist Kernanforderung
Sprache/Framework PHP ≥ 8.3 + Laravel
Datenbank MySQL ≥ 8.0 und MariaDB ≥ 10.6
Webserver Apache (mod_rewrite, .htaccess), PHP-FPM oder mod_php
Lizenz Lizenzpflichtig – Lizenz-E-Mail + Schlüssel + Gerätekennung; Lizenzfehler blockieren nur Updates
Updates Self-Updater gegen update.loheide.cloud (Branch-Stand per Commit-SHA, Kanäle stable/development)
Rückmeldungen Fehlerbericht & Funktionswunsch an api.loheide.cloud, mit Lizenzzuordnung
Plugins WordPress-Prinzip: ZIP hochladen, aktivieren, Hooks/Filter
Wichtigster IdP Microsoft Entra ID
Admin-Backend Filament – nur für Administratoren
Portal-Frontend Inertia + Vue 3 + Tailwind CSS + shadcn-vue (reka-ui) + Lucide-Icons, vorkompiliert ausgeliefert
Design Nüchtern-professionell (Vorbild: moderne Intranets wie MeinMagenta/Viva Connections): neutrale Flächen, Markenfarbe nur als Akzent, Schrift Inter (lokal) – kein Material 3 (entschieden 2026-09-25, wirkte verspielt)
Redaktion Direkt im Portal (Inline-Bearbeitung/Pagebuilder)
Später Push-Benachrichtigungen, native App (Architektur jetzt schon API-fähig halten)

2. Hosting & Auslieferung (Shared-Hosting-tauglich)

Grundsatz: Auf dem Server des Kunden wird nichts gebaut und nichts per Shell ausgeführt.

  • Das Repo ist das Release. Der Update-Proxy liefert den Branch-Stand als ZIP – deshalb werden kompilierte Frontend-Assets und PHP-Abhängigkeiten mitversioniert (siehe 5.2 zu vendor/).
  • Erstinstallation: ZIP (vom Kundenportal/Proxy) hochladen → Web-Installer (Systemprüfung, DB-Zugang, Admin-Konto, Lizenzdaten, Basis-Branding).
  • Document Root: Wenn der Hoster kein Umbiegen auf public/ erlaubt, leitet eine Root-.htaccess auf public/ um und sperrt alle anderen Verzeichnisse.
  • Hintergrundjobs ohne Worker:
    • bevorzugt Cron * * * * * → schedule:run + Queue mit Zeitlimit (queue:work --stop-when-empty --max-time=50),
    • Fallback Web-Cron (URL mit Token für externen Cron-Dienst),
    • letzter Fallback Pseudo-Cron (wie WP-Cron) nach Auslieferung der Antwort.
    • Jobs in kleinen, wiederaufnehmbaren Häppchen.
  • Treiber mit Fallbacks: Cache/Session/Queue über Datenbank oder Dateien; APCu/Redis wenn vorhanden. Bilder über GD, Imagick optional. Dateien lokal, optional S3-kompatibel.
  • Für Kunden mit eigenem Server zusätzlich: Docker-Image und Anleitung.
  • Site Health im Admin: PHP-Version/Extensions, OPcache, Schreibrechte, Cron-Status, ausstehende Migrationen, Lizenzstatus.

3. Architektur

app/ (Core)            Auth, User, Profil, Rollen & Rechte, Einstellungen,
                       Theming, Plugin-Loader, Hooks, Erweiterungspunkte,
                       Audit-Log, Self-Updater, Lizenz, Rückmeldungen, Site Health
plugins-core/<slug>/   Mitgelieferte Plugins (News, Seiten, Verzeichnis, …) –
                       Teil des Repos, kommen per Self-Updater
plugins/<slug>/        Vom Kunden installierte Plugins – **geschützter Pfad**,
                       wird vom Self-Updater nie angefasst
  • Eigene Module sind Plugins und nutzen dieselbe API wie Kunden-Plugins.
  • Fachlogik in Actions/Services, nicht in Controllern → später wiederverwendbar für REST-API und native App.

Oberflächen:

  • Portal (Vue, Tailwind/shadcn-vue): Mitarbeitende und Redakteure. Zweizeiliger Header (Logo, Suche, Avatar-Menü; darunter Hauptnavigation), Startseite als Raster aus Kacheln (Schnellzugriffe, Begrüßung, News …).
  • Admin (Filament): Plugins, Rollen & Rechte, Identity Provider, Gruppen-Mapping, Theme, Benutzer, Audit-Log, Aktualisierung & Lizenz, Rückmeldung geben, Site Health.

4. Plugin-System (WordPress-Prinzip)

4.1 Aus Sicht des Admins

  • Plugin-ZIP im Admin hochladen, aktivieren / deaktivieren / löschen.
  • Wiederherstellungsmodus: Fatal Error beim Laden → Plugin wird automatisch deaktiviert, Admin wird informiert, Portal bleibt erreichbar.
  • Datei-Änderungen über den Admin per Konfiguration abschaltbar (analog DISALLOW_FILE_MODS).
  • Updates von Kunden-Plugins: später über eine update_url im Manifest; für eigene, lizenzpflichtige Plugins kann dasselbe Proxy-Modell wie beim Core genutzt werden.

4.2 Aufbau eines Plugins

plugins/mav-kalender/
  plugin.json          Name, Slug, Version, Autor, Beschreibung,
                       requires.core, requires.php, requires.plugins,
                       update_url, Einstiegsklasse
  src/                 PHP-Code (PSR-4, Autoload registriert der Core)
  src/Plugin.php       extends BasePlugin:
                         register(), boot(), activate(), deactivate(), uninstall()
  vendor/              eigene Abhängigkeiten – gescoped (Strauss/PHP-Scoper)
  database/migrations/ laufen bei Aktivierung/Update
  resources/lang/      Übersetzungen
  dist/                vorkompilierte JS/CSS-Module (kein Build beim Kunden)

4.3 Hooks & Erweiterungspunkte

  • Actions: Hooks::on('post.published', fn($post) => …)
  • Filter: Hooks::filter('navigation.items', fn($items) => …)
  • Prioritäten wie bei WordPress, intern auf Laravel-Events aufgebaut.
  • Typisierte Registries: Navigation, Dashboard-Widgets, Profil-Tabs, Profilfelder, Pagebuilder-Blöcke, Objekttypen & Abilities, Einstellungsseiten, Admin-Ressourcen, Routen, Suche, Benachrichtigungen, geplante Jobs.
  • Stabile, versionierte Plugin-API (SemVer); Deprecations mit Vorlauf.
  • Entwickleranleitung: docs/PLUGINS.md.

4.4 Frontend von Plugins

  • Portal stellt Vue, reka-ui und das Portal-UI-Kit (shadcn-vue-Komponenten) per Import Map bereit; Plugin-Styles nutzen die Design-Tokens (CSS-Variablen) des Portals.
  • Plugins werden beim Entwickler mit @portal/plugin-sdk (Vite-Preset) gebaut; Vue & Co. sind „external“.
  • Der Core lädt die ES-Module aktiver Plugins lazy zur Laufzeit.

4.5 Sicherheit & Tooling

  • Plugins laufen mit vollen Rechten; Installation nur mit plugins.manage.
  • Kein Plugin-Verzeichnis/Store (entschieden 2026-09-25): Plugins werden ausschließlich per ZIP-Upload installiert. Warnhinweis vor der Installation, dass Plugins vollen Zugriff auf das System haben.
  • Später „Remote Apps“ (Webhooks + API + iFrame-Widgets).
  • Plugin-Generator, Doku, Beispiel-Plugins, lokale Dev-Umgebung.

5. Self-Updater & Lizenz

Verbindlich: docs/specs/self-updater.md. Hier nur die Übertragung auf Laravel und projektspezifische Entscheidungen.

5.1 Komponenten (Laravel)

Spezifikation Umsetzung
Version-Helper App\Support\Update\InstalledVersion – SHA in storage/.version, App\Version::VERSION (SemVer-Konstante)
Fortschritts-Datei App\Support\Update\UpdateProgress → storage/.update-progress
Wartungsmodus App\Support\Update\MaintenanceFlag → storage/.maintenance (selbstheilend) – eigener Mechanismus, nicht php artisan down, damit ohne Shell und DB funktionsfähig
Updater-Kern App\Support\Update\Updater::installUpdate() – Laravel HTTP-Client (Guzzle) mit sink für den ZIP-Stream, nur HTTPS, begrenzte Redirects, 180 s für ZIP
Entpacken ZipArchive, zweistufiger ZIP-Slip-Schutz, Staging in storage/.update-staging
Übernehmen Datei für Datei: temporär daneben schreiben → rename(); nur überschreiben/ergänzen, nie löschen
Migrationen Artisan::call('migrate', ['--force' => true]) im Prozess, Zähler über Migrator-Repository
Caches optimize:clear + opcache_reset() (falls verfügbar), danach config:cache/route:cache neu
Kanal-Factory UpdaterFactory::for(?string $channel) – Kanäle in config/updater.php, aktiver Kanal in App-Einstellungen (DB, Fallback Datei)
Auto-Migration Middleware RunPendingMigrations – Fingerabdruck über Migrationsdateien (Core + aktive Plugins), Cache::lock() bzw. Lock-Datei, Fehler nur loggen
Wartungs-Middleware EnsureNotInMaintenance – 503 + Retry-After, Ausnahmen: /admin/update/*, Login, /up (Health)
Lizenz-Speicher App\Support\License\LicenseStore – E-Mail & Schlüssel (verschlüsselt), device_id, device_token in storage/app/license.json (außerhalb der DB, überlebt DB-Probleme)
Lizenz-Client Guzzle-Middleware, die jede Antwort (auch Fehler, auch Downloads) sofort auf X-Device-Token/device_token prüft und speichert, bevor irgendetwas anderes passiert
Admin-UI Filament-Seite „Aktualisierung“ (Version, Kanal, Suche, Changelog-Vorschau, Fortschritt per Polling, Migrationen, Changelog-Historie, Lizenzbereich, Datenschutzhinweis)
Endpunkte POST /admin/update/check, POST /admin/update/install, GET /admin/update/progress, POST /admin/update/channel, POST /admin/update/migrations – Admin-only, CSRF
Markdown league/commonmark mit html_input: strip, allow_unsafe_links: false
Audit Audit-Log-Eintrag je Lauf: Kanal, Ziel-SHA, Anzahl Migrationen, Benutzer, Ergebnis
  • hostname = gethostname(), device_label = hostname:base_path().
  • Gerät abmelden: Button „Diese Installation abmelden“ im Lizenzbereich (POST …/license/release-device).
  • Grundregel: Lizenzfehler erzeugen nur Hinweise im Admin und Log-Einträge. Keine Middleware, kein Feature hängt vom Lizenzstatus ab.
  • Datenschutzhinweis wörtlich unter „Nach Updates suchen“; Zeilen für nicht gesendete Felder streichen (z. B. Betriebssystem/Programmversion, falls nicht übertragen – bei Umsetzung abgleichen). Verweis auf die im Portal hinterlegte Datenschutzerklärung, falls gesetzt.

5.2 Projektspezifische Entscheidungen

  • vendor/ – bewusste Abweichung (entschieden 2026-09-25): Die Spezifikation führt vendor/ als geschützten Pfad. Auf Shared Hosting ohne Shell kann aber kein composer install laufen – neue PHP-Abhängigkeiten kämen dann nie beim Kunden an. Daher wird vendor/ mitversioniert (nur --no-dev) und nicht geschützt, analog zu den kompilierten Assets. composer.lock bleibt geschützt. Da nur überschrieben, nie gelöscht wird, bleiben alte Pakete liegen – unschön, aber harmlos (Autoloader kennt sie nicht mehr).
  • Geschützte Pfade (Erweiterung der Mindestliste): .env, .git/, storage/, node_modules/, composer.lock, package-lock.json, plugins/ (Kunden-Plugins), public/storage, public/uploads/, config/local.php, .htaccess im Root (falls vom Kunden angepasst → als .htaccess.dist ausliefern).
  • Kanäle (bestätigt): stable → Branch main, development → Branch develop.
  • Rollout Lizenzpflicht: Da es noch keine Installationen gibt, kann die erste Version direkt mit Lizenzdaten ausgeliefert werden; die Stufen „nur protokollieren“ → „durchsetzen“ trotzdem wie beschrieben nutzen.

5.3 Versionierung & Changelog

  • CHANGELOG.md im Repo-Root, neueste Version oben, Abschnitte ## MAJOR.MINOR.PATCH, kurze deutsche Stichpunkte.
  • App\Version::VERSION (SemVer).
  • Ablauf für jede Änderung (in CONTRIBUTING.md dokumentiert):
    1. CHANGELOG.md ergänzen
    2. VERSION anheben (Patch = Fix, Minor = Funktion)
    3. Tests grün, bin/build (Frontend-Build + composer install --no-dev) → Assets und vendor/ mitcommitten. Entwicklungspakete liegen getrennt in vendor-dev/ (siehe CONTRIBUTING.md)
    4. Merge in den ausgelieferten Branch
  • CI prüft: CHANGELOG-Abschnitt passt zu VERSION, Build-Artefakte sind aktuell.

6. Rückmeldungen an den Hersteller

Verbindlich: docs/specs/feedback.md.

  • Ort: Im Admin-Backend (Filament) ein Menüpunkt „Hilfe → Rückmeldung geben“ in der Navigation und im Benutzermenü → Dialog (≤ 2 Klicks). Optional später auch für Redakteure im Portal.
  • Freigeschaltete Wege via GET https://api.loheide.cloud/v1/software (Feld endpoints), gecacht; 404 auf einen Weg → dauerhaft ausblenden (in App-Einstellungen gemerkt). Aktuell: Fehlerbericht, Funktionswunsch.
  • Automatisch befüllt & im Dialog aufklappbar sichtbar: app_version (= App\Version::VERSION), current_sha, os (Server-Betriebssystem, z. B. „Linux 6.8 (Debian 12)“), metadata: PHP-Version, DB-Typ/-Version, Webserver, aktiver Update-Kanal, Anzahl aktiver Plugins + deren Slugs/Versionen, Cache-/Queue-Treiber. Keine personenbezogenen Daten, keine Pfade mit Benutzernamen, keine Inhalte.
  • Lizenz-Kopfzeilen aus dem LicenseStore – nur wenn Lizenz hinterlegt, nie leere Werte; keine Vorabprüfung der Lizenz. Rückmeldeadresse ist ein eigenes, freiwilliges Feld (vorbelegt mit der E-Mail des Admins, änderbar).
  • Warteschlange: Tabelle vendor_feedback_outbox (Payload, Art, idempotency_key, Versuche, nächster Versuch, Status, Referenz). Absenden bestätigt sofort, der Versand läuft als Queue-Job (Cron/Pseudo-Cron). Max. 5 Versuche, dann verwerfen + Admin-Benachrichtigung. 409 → kurz warten, erneut; 429 → Retry-After; 503/Netzfehler → später erneut; 422 → zurück an das Formular (Eingabe bleibt erhalten).
  • Referenznummer wird angezeigt und in einer Liste „Meine Rückmeldungen“ gespeichert.
  • Rotierendes Gerätetoken auch hier über denselben Lizenz-Client speichern; mehrere Meldungen nacheinander senden.
  • Datenschutzhinweis wörtlich über dem Absendeknopf. Anhänge sind zunächst nicht vorgesehen → Zeile „die von Ihnen angehängten Dateien“ entfällt; der „Bitte beachten“-Absatz wird bei der Umsetzung entsprechend auf die tatsächlich gesendeten Inhalte abgeglichen.

7. Berechtigungskonzept

7.1 Drei Ebenen

Ebene Beispiel
Globale Rechte „Plugins verwalten“, „Benutzer verwalten“, „Aktualisieren“
Objekt-Rechte (Grants) „Rolle MAV darf Seite /mav inkl. Unterseiten bearbeiten“
Sichtbarkeit (Zielgruppen) „Seite nur für Standort Hamburg sichtbar“

7.2 Datenmodell (vereinfacht)

roles        id, name, description, is_system
role_user    user_id, role_id, source, source_ref, created_at
             source     = manual | idp
             source_ref = z. B. identity_provider_id + Gruppen-Objekt-ID
grants       role_id, ability, resource_type, resource_id (NULL = alle),
             include_children
audiences    resource_type, resource_id, rule (Rolle / Abteilung / Standort / …)
  • Abilities je Objekttyp: view, create, edit, publish, delete, manage_permissions. Plugins registrieren eigene Objekttypen und Abilities.
  • Prüfung zentral über Laravel Policies + Grant-Resolver.
  • Rollen sind additiv (manuell + IdP), keine „Verbots“-Rechte.

7.3 Beispiel MAV

  • Rolle MAV – Mitglieder manuell oder über Entra-Gruppe.
  • page.edit, page.publish auf Seite „MAV“ inkl. Unterseiten.
  • post.create, post.publish in Kategorie „MAV-Info“.

7.4 Admin-UI

  • Rollen-Editor, Tab „Berechtigungen“ an Seite/Kategorie, Rechte-Prüfer, optionaler Freigabe-Workflow, Audit-Log.

8. Identity Provider & Gruppen-Mapping

8.1 Anbieter

  1. Microsoft Entra ID (OIDC) – Priorität 1
  2. Lokaler Login mit 2FA (TOTP) – immer verfügbar für Notfall-Admin
  3. Generisch OIDC, LDAP/AD, SAML 2 – später, technisch als Plugins

8.2 Gruppen → Rollen

  • Je IdP Mapping-Tabelle: IdP-Gruppe → eine oder mehrere Rollen; optionale Standardrolle.
  • Additiv; Sync gleicht nur IdP-Zuweisungen ab, manuelle Zuweisungen werden nie verändert.

8.3 Entra-spezifisch

  • Sicherheitsgruppen (groups) und App-Rollen (roles) mappbar, über Objekt-ID; Gruppensuche per Graph.
  • Group-Overage → Graph /me/transitiveMemberOf (inkl. verschachtelter Gruppen).
  • Profil-Sync inkl. Profilfoto → Avatar im Header; jedes Graph-Attribut (auch employeeOrgData.*, onPremisesExtensionAttributes.*, extension_…) frei einem Kern- oder eigenen Profilfeld zuordenbar.
  • Hintergrund-Sync mit Delta-Abfragen, Offboarding deaktivierter Konten.
  • JIT-Provisioning, „Mapping testen“.

8.4 Datenmodell

identity_providers   id, type, name, config (verschlüsselt), enabled
user_identities      user_id, identity_provider_id, subject (oid), last_login_at
idp_group_mappings   identity_provider_id, external_group_id,
                     external_group_name, role_id

9. Performance (10 – 5.000 Mitarbeitende, Shared Hosting)

Ziel: Portal-Seiten < 200 ms Serverzeit bei 5.000 Usern.

  • Effektive Rechte pro User vorberechnet und gecacht; Zielgruppen als indizierte SQL-Bedingungen.
  • Pagebuilder-JSON beim Veröffentlichen in vorbereitete Render-Struktur übersetzt und gecacht; dynamische Blöcke mit kurzem Cache.
  • Cursor-Pagination, Indizes, preventLazyLoading() in Dev/CI.
  • Gehashte Assets mit langen Cache-Headern; Bilder beim Upload in feste Größen + WebP.
  • OPcache voraussetzen; Config/Route/View-Cache nach jedem Update.
  • Auto-Migration prüft nur den Fingerabdruck – kein Migrator pro Request.
  • Seed-Datensatz (5.000 MA, 2.000 Seiten, 20.000 Beiträge), k6-Lasttests in CI.

10. Profil & Portal-Frontend

  • Header: Logo, Navigation, Suche, Benachrichtigungen, Avatar mit Menü.
  • Avatar aus Entra oder Upload; Fallback Initialen.
  • Profil mit frei definierbaren Feldern und Sichtbarkeit pro Feld.
  • Organisationsstruktur als Basis für Zielgruppen. Mobile-first, PWA-fähig.

11. Pagebuilder

  • Seite = Baum aus Blöcken (versioniertes JSON), registrierte Blöcke, gleicher Renderer für Editor und Frontend.
  • Layout: Abschnitt, Spalten (1–4, Verhältnisse, Umbruchpunkt), Tabs, Akkordeon, Boxen (Info/Hinweis/Warnung/Erfolg/neutral/ hervorgehoben), Raster – beliebig verschachtelbar.
  • Inhalt: Rich Text (TipTap), Überschrift, Zitat, Liste, Tabelle, Bild, Galerie, Video, Embed, Buttons, Trenner, Abstand, Icon-Liste, Hero, Downloads.
  • Dynamisch: Ansprechpartner, News-Liste, Events, App-Kacheln, Geburtstage.
  • Editor: Drag & Drop, Vorschau Desktop/Tablet/Mobil, Entwürfe, Versionen, Zeitsteuerung, Vorlagen, wiederverwendbare Blöcke, Sichtbarkeit pro Block, Bearbeitungssperre.

12. Branding & Theming

Jede Installation soll wie das eigene Portal des Kunden aussehen – ohne Entwickler, ohne Build, direkt im Admin unter „Erscheinungsbild“.

12.1 Was der Kunde anpassen kann

Identität

  • Portalname (z. B. „Caritas-Netz“ statt „Inhaus“) – erscheint in Header, Browser-Tab, E-Mails, PWA
  • Logo – getrennt für hellen und dunklen Hintergrund, optional quadratisches Signet für kleine Bildschirme
  • Favicon und App-Icon (PWA/Homescreen), automatisch in alle Größen umgerechnet
  • Login-Seite: Hintergrundbild, Begrüßungstext, Logo-Position

Farben

  • Markenfarbe (Pflicht) → wird exakt übernommen (Buttons, aktive Navigation, Links, Begrüßungskarte); daraus werden die Abstufungen 50–950 im OKLCH-Farbraum berechnet (serverseitig, App\Support\ColorPalette)
  • Flächen bleiben neutral (weiß/grau) – die Markenfarbe ist Akzent, kein Anstrich
  • optional eine zweite Akzentfarbe
  • Header-Stil: farbig (Primärfarbe), hell oder dunkel
  • Kontrastprüfung (WCAG AA): Warnung, wenn Text auf Farben schlecht lesbar wird – blockiert nicht, schlägt aber eine Korrektur vor

Typografie & Form

  • Schriftart: Auswahl gängiger Schriften oder eigene Schrift hochladen (WOFF2) – immer lokal ausgeliefert, nie von Google Fonts o. ä. geladen (DSGVO)
  • Eckenradius (eckig ↔ rund), Dichte (kompakt ↔ luftig)
  • Dark Mode: erlaubt / Standard hell / Standard dunkel / Systemeinstellung

Weiteres

  • E-Mail-Vorlagen im gleichen Branding (Logo, Farbe, Fußzeile)
  • Admin-Backend übernimmt Logo und Primärfarbe (Filament unterstützt das)
  • Fußzeile: Links zu Impressum, Datenschutz, eigenen Seiten
  • White-Label (entschieden 2026-09-25): „Inhaus“ lässt sich vollständig ausblenden – Portal, Login, E-Mails, Admin-Backend, PWA, Browser-Tab. Kein Pflicht-„Powered by“. Hersteller-Bezüge bleiben nur dort, wo sie sachlich nötig sind (Seite „Aktualisierung“, Lizenz, Rückmeldungen, Datenschutzhinweise).
  • Für Fortgeschrittene: eigenes CSS (mit Warnhinweis, pro Update unverändert übernommen, weil in der DB gespeichert)

12.2 Bedienung

  • Live-Vorschau neben den Einstellungen: Portal-Startseite, Login, Beispielseite mit Boxen/Tabs/Akkordeon, hell und dunkel
  • Entwurf → Veröffentlichen: Änderungen erst ansehen, dann für alle freischalten; „Auf Standard zurücksetzen“
  • Export/Import des Themes als Datei (z. B. von Test- auf Produktivsystem)

12.3 Technik

  • Einstellungen in der DB, Logos/Schriften in storage/ (geschützter Pfad – überleben jedes Update)
  • Beim Veröffentlichen wird eine statische CSS-Datei mit CSS-Variablen erzeugt (Hash im Dateinamen, lange Cache-Header) – kein Build, keine Laufzeitkosten pro Request
  • Farbberechnung in PHP (App\Support\ColorPalette); die Werte werden als CSS-Variablen (--brand, --brand-50 … --brand-950) in die Seite geschrieben – keine Farbberechnung im Browser
  • Portal-Tokens (Tailwind), Filament-Farben, E-Mail-Vorlagen und Pagebuilder-Boxen lesen alle dieselben Tokens → ein Farbwechsel wirkt überall
  • Später: Theme-Pakete als Plugins (eigene Layouts, Header-Varianten)

13. Mitgelieferte Plugins

Start: Dashboard, News/Feed mit Kategorien, CMS-Seiten, Formulare, WordPress-Import, Verzeichnis & Organigramm, Dokumente, App-Launcher.

Später: Events, Umfragen, Geburtstage/Jubiläen, Onboarding, Raumbuchung, Kantinenplan, Ideenbox, Urlaubsanträge.


14. Querschnitt

  • DSGVO & Mitbestimmung: keine personenbezogene Nutzungsauswertung, Audit-Log für Admin-Aktionen, Löschkonzept, Datenexport; Datenschutzhinweise für Update-Prüfung und Rückmeldungen gemäß Spezifikationen.
  • Mehrsprachigkeit DE/EN; UI-Texte mit echten Umlauten, Schlüssel/Routen ASCII.
  • Tests: PHPUnit (Pest scheidet aus, weil es fest vendor/autoload.php lädt – dort liegen nur die Produktionspakete), Vitest, Playwright, k6.
  • CI-Matrix: PHP 8.3/8.4 × MySQL 8.0/8.4 × MariaDB 10.6/11.

15. Phasen

Phase Inhalt
0 – Fundament ✅ Laravel-Skeleton, Docker-Dev, CI-Matrix, VERSION + CHANGELOG.md + Build-Workflow (Assets/vendor mitversioniert), lokaler Login, User & Profil, Header mit Avatar, Design-System (Tailwind/shadcn-vue) mit Design-Tokens, Basis-Branding (Portalname, Logo, Markenfarbe), Personenverzeichnis, Schnellzugriffe, Filament-Grundgerüst
0b – News & Termine (vorgezogen) ✅ Neuigkeiten mit Kategorien, Titelbild, Planung, Hervorhebung (Slider); Termine mit .ics-Export; Startseite nach Intranet-Vorbild. Redaktion vorerst nur im Admin-Backend – Rechte pro Kategorie, Redaktion im Portal und Umzug in Plugins folgen mit Phase 2
1 – Betrieb & Lizenz ✅ Self-Updater (inkl. Wartungsmodus, Auto-Migration, Kanäle), Lizenz-Speicher & -Client (rotierendes Token), Seite „Aktualisierung“, Rückmeldungen, Web-Installer, Site Health, Cron-Varianten
2 – Plugin-System & Rechte ✅ Plugin-Loader, Hooks/Filter, Registries, Recovery-Modus, Import-Map-Frontend; Rollen, Grants, Zielgruppen, Rechte-Cache, Rechte-Prüfer
3 – Entra ID ✅ OIDC-Login, JIT, Gruppen-/App-Rollen-Mapping (additiv), Graph-Profil- & Foto-Sync mit frei zuordenbaren Attributen (inkl. Erweiterungsattributen) und eigenen Profilfeldern, Delta-Sync
4 – CMS ✅ Seitenbaum, Pagebuilder (Layout-, Inhalts-, Medien- und dynamische Blöcke, Sichtbarkeit je Block), Entwürfe, Versionen, Zeitsteuerung, Bearbeitungssperre, Freigaben; News-Freigabe-Workflow und Redaktion im Portal; Benachrichtigungen. Offen: Vorlagen und wiederverwendbare Blöcke
4b – Formulare & Umstieg ✅ Formular-Plugin (visueller Baukasten im Portal, Bedingungen, Uploads, anonyme Formulare, Mail + Backend, Ergebnis-Rechte je Formular und Rolle, CSV, Löschfristen; eingebunden per Pagebuilder-Block und unter Beiträgen, kein eigener Menüpunkt); WordPress-Import (Beiträge, Kategorien, Bilder, Seiten); E-Mail-Versand im Admin; anpassbare Startseite mit eigenen Kacheln; Geburtstage (optionales Plugin)
5 – Branding & Theming ✅ Vollständige Seite „Erscheinungsbild“: Logo-Varianten, Farben inkl. Farbtreue & Kontrastprüfung, Schriften, Form, Login-Seite, E-Mails, Live-Vorschau, Entwurf/Veröffentlichen, Export/Import
6 – Weitere Plugins & IdPs Verzeichnis/Organigramm, Dokumente, Events …; OIDC generisch, LDAP, SAML; Lasttests 5.000 User
7 – Plugin-SDK öffentlich Doku, Generator, Beispiel-Plugins (kein Plugin-Verzeichnis)
8 – Mobil REST-API (Sanctum), Web-Push, native App

Begründung für Phase 1: Ohne Self-Updater erreicht jede spätere Version Shared-Hosting-Kunden nur per manuellem Upload – der Updater muss deshalb in der allerersten ausgelieferten Version stecken.


16. Offene Punkte

  • Produktname „Inhaus“: Marken- und Domainprüfung (DPMA, EUIPO, .de/.app); technischer Schlüssel mitarbeiterportal bleibt, sofern der Proxy nicht umkonfiguriert wird
  • Update-Weg für lizenzpflichtige Hersteller-Plugins (eigene Proxy-Einträge?)