Merge #3: Phase 1: Self-Updater, Lizenz, Rückmeldungen, Installer
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 2m19s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 2m13s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 2m15s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 2m17s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 2m56s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 3m8s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 2m46s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 2m30s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m11s

This commit is contained in:
Friederich Loheide 2026-09-26 11:17:55 +00:00
commit 6d0f3a7f29
713 changed files with 37564 additions and 949 deletions

View file

@ -67,8 +67,9 @@ jobs:
- name: vendor/ entspricht composer.lock (ohne Dev-Pakete)
run: |
composer install --no-dev --optimize-autoloader --no-interaction --no-progress --no-scripts
git status --porcelain vendor
test -z "$(git status --porcelain vendor)"
# installed.php enthält den Git-Commit des Projekts selbst und ändert sich daher immer.
git status --porcelain -- vendor ':!vendor/composer/installed.php'
test -z "$(git status --porcelain -- vendor ':!vendor/composer/installed.php')"
- name: public/build/ entspricht dem Quellcode
run: |
npm ci --no-audit --no-fund

4
.gitignore vendored
View file

@ -24,5 +24,9 @@
/storage/.version
/storage/.update-progress
/storage/.maintenance
# Laufzeitzustand der Installation – nie ausliefern (ein manuelles Update würde sonst fällige Migrationen überspringen)
/storage/.migrations-fingerprint
/storage/.background-heartbeat
/storage/.background.lock
_ide_helper.php
Thumbs.db

18
.htaccess Normal file
View file

@ -0,0 +1,18 @@
# Nur nötig, wenn der Hoster das Installationsverzeichnis selbst als Webroot
# verwendet und sich dieser nicht auf „public/“ umstellen lässt:
# Alle Anfragen werden intern nach public/ geleitet – .env, storage/, vendor/
# usw. sind so von außen nicht erreichbar.
# Diese Datei wird von Aktualisierungen nicht überschrieben (geschützter Pfad).
Options -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_URI} !/public/
RewriteRule ^(.*)$ public/$1 [L]
</IfModule>
<IfModule !mod_rewrite.c>
# Ohne mod_rewrite lieber gar nichts ausliefern als Konfigurationsdateien.
Require all denied
</IfModule>

View file

@ -4,6 +4,79 @@ Neueste Version oben. Jeder Abschnitt beginnt mit `## MAJOR.MINOR.PATCH` und
enthält kurze Stichpunkte für Anwenderinnen und Anwender – keine Commit-Texte.
Der Self-Updater zeigt diese Abschnitte bei neuen Versionen an.
## 0.7.0
- Erscheinungsbild vollständig anpassbar: Portalname, Logos für helle und dunkle Flächen, Signet für Smartphones, App-Symbol für Favicon und Homescreen
- Markenfarbe wird exakt übernommen, optional eine zweite Akzentfarbe; Kopfleiste hell, in der Markenfarbe oder dunkel
- Kontrastprüfung nach WCAG AA: zu helle Markenfarben bekommen automatisch gut lesbare Linkfarben
- Schriften zur Auswahl oder als eigene Datei, auch getrennt für Überschriften – immer vom eigenen Server, nie von Google
- Ecken, Abstände und Dunkelmodus (frei wählbar, immer hell oder immer dunkel) einstellbar
- Anmeldeseite mit Hintergrundbild, eigenem Begrüßungstext und zwei Aufteilungen
- Fußzeile mit Links (z. B. Impressum, Datenschutz); E-Mails im gleichen Design mit eigener Fußzeile
- Entwurf, Live-Vorschau (Startseite, Anmeldung, Beispielseite – hell und dunkel) und Veröffentlichen; Export, Import und Zurücksetzen
- Eigenes CSS für Fortgeschrittene
- Der Admin-Bereich übernimmt Logo, Farbe und Favicon; „Inhaus“ erscheint nirgends mehr zwingend
- Hochgeladene SVG-Logos werden von Skripten bereinigt
## 0.6.0
- Formulare: Anträge, Anmeldungen, Umfragen und Meldungen im visuellen Baukasten zusammenstellen – so, wie das Formular später aussieht: Bezeichnungen und Auswahlmöglichkeiten direkt bearbeiten, Felder per Ziehen und Ablegen anordnen, Vorschau mit Bedingungen
- Felder lassen sich abhängig von anderen Antworten ein- und ausblenden und aus dem Profil vorbelegen
- Einsendungen landen im Backend und per E-Mail bei festen Empfängern; auf Wunsch eine Kopie an die ausfüllende Person
- Zugriff auf die Ergebnisse je Formular und Rolle – ansehen und exportieren (CSV für Excel) bzw. löschen getrennt vergebbar
- Anonyme Formulare, „nur einmal ausfüllen“, Einsendeschluss, Sichtbarkeit und automatische Löschfrist
- Formularfelder lassen sich fest mit Profilangaben füllen (z. B. Vorname, Personalnummer, Abteilung) – nicht änderbar, beim Absenden gilt immer der Profilwert
- Formulare lassen sich mit dem Pagebuilder in Seiten und unter Neuigkeiten-Beiträgen einbinden
- Ergebnisse als CSV herunterladen – alle oder nur ausgewählte Einsendungen
- WordPress-Import: Beiträge mit Kategorien, Autorinnen und Autoren, Beitragsbildern und Bildern im Text übernehmen, auf Wunsch auch Seiten – wiederholbar, ohne Doppelungen
- E-Mail-Versand im Admin einrichten (SMTP), mit Test-Mail
- Startseite anpassen: Kacheln je Bereich sortieren und ausblenden, eigene Kacheln anlegen – Bild mit Link, Text oder Hinweis, mit Zeitraum und Zielgruppe
- Geburtstage (optional, unter „Plugins“ zu aktivieren): Mitarbeitende tragen freiwillig Tag und Monat im Profil ein; Kachel und Liste der anstehenden Geburtstage, Glückwunsch auf der Startseite am eigenen Geburtstag
## 0.5.0
- Seiten: eigener Seitenbaum für Bereiche, Abteilungen und Gremien – mit Seitennavigation, Brotkrumen und optional in der Hauptnavigation
- Pagebuilder im Portal: Abschnitte, Spalten, Tabs, Akkordeon, Boxen, Text, Bilder, Galerie, Video, Tabellen, Schaltflächen, Ansprechpartner, Downloads und mehr – per Ziehen und Ablegen
- Entwürfe werden laufend gespeichert; veröffentlicht wird ausdrücklich oder zeitgesteuert, jede Veröffentlichung bleibt als Version erhalten
- Rechte je Seite inklusive Unterseiten, z. B. darf die MAV ihre Seite und alles darunter pflegen; ohne Veröffentlichungsrecht wird eine Freigabe angefordert
- Sichtbarkeit je Seite und je Block (Rollen, Abteilungen, Standorte)
- Bearbeitungssperre verhindert, dass zwei Personen gleichzeitig dieselbe Seite ändern
- Neuigkeiten direkt im Portal schreiben – mit Titelbild und Bildern im Text
- Freigabe-Workflow für Beiträge: einreichen, freigeben oder mit Anmerkung zurückgeben; wer veröffentlichen darf, kann auch planen und hervorheben
- Neuer Bereich „Redaktion“ mit Entwürfen, Freigaben und Geplantem
- Benachrichtigungen im Portal (Glocke im Kopfbereich), z. B. bei Freigabe-Anfragen
- Rechte für einzelne Seiten lassen sich im Rollen-Formular „inkl. Unterseiten“ vergeben
- Behoben: Nach einem manuellen Update per FTP wurde die Datenbank unter Umständen nicht aktualisiert
## 0.4.0
- Anmeldung mit Microsoft Entra ID („Mit Microsoft anmelden“) – Konten werden bei der ersten Anmeldung angelegt oder per E-Mail verknüpft
- Entra-Gruppen und App-Rollen lassen sich Rollen im Portal zuordnen; manuell vergebene Rollen bleiben erhalten
- Profil, Vorgesetzte*r und Profilfoto werden aus Entra übernommen – übernommene Felder sind im Portal schreibgeschützt
- Beliebige Entra-Attribute lassen sich Profilfeldern zuordnen – auch Personalnummer, Kostenstelle, lokale Erweiterungsattribute und eigene Verzeichniserweiterungen
- Eigene Profilfelder (z. B. Personalnummer, Eintrittsdatum) mit Typ, Sichtbarkeit und Angabe, ob die Person sie selbst pflegen darf
- Hintergrund-Abgleich: Änderungen und in Entra deaktivierte Konten werden auch ohne Anmeldung übernommen, optional alle Konten vorab angelegt
- „Mapping testen“ zeigt, welche Gruppen Entra für eine Person liefert und welche Rollen daraus entstehen
- Profilseite zeigt Vorgesetzte*n und Mitarbeitende
## 0.3.0
- Rollen und Rechte: eigene Rollen anlegen, Rechte global oder für einzelne Kategorien vergeben – z. B. darf die MAV nur in „MAV-Info“ schreiben
- Veröffentlichen ist ein eigenes Recht; ohne dieses Recht bleiben Beiträge Entwürfe
- Sichtbarkeit: Kategorien und Termine lassen sich auf Rollen, Abteilungen oder Standorte beschränken
- „Rechte prüfen“ zeigt, was eine Person darf und warum
- Redaktion und Sichtbarkeit direkt an der Kategorie einstellen
- Plugins: Funktionen lassen sich einzeln aktivieren und deaktivieren, eigene Plugins per ZIP installieren
- Neuigkeiten und Termine sind jetzt mitgelieferte Plugins
## 0.2.0
- Aktualisierung per Klick im Admin-Bereich – ohne Serverzugang, mit Wartungsseite und Fortschrittsanzeige
- Lizenz hinterlegen und prüfen, Laufzeit und belegte Geräteplätze einsehen
- Update-Kanäle „Stabil“ und „Entwicklung“
- Datenbank wird nach einem Update automatisch auf den neuen Stand gebracht
- Änderungsprotokoll im Admin-Bereich
## 0.1.0
- Erste Fassung des Mitarbeiterportals

View file

@ -9,3 +9,6 @@
- UI-Texte Deutsch mit Umlauten, Schlüssel/Routen ASCII. Kein Node/Shell auf dem Kundenserver voraussetzen.
- Design: Tailwind + shadcn-vue (`resources/js/components/ui`), Lucide-Icons, Inter. Farben nur über Tokens
(`brand`, `brand-text`, `card`, `muted-foreground` …); Markenfarbe kommt serverseitig als CSS-Variable.
- Funktionen als Plugins: mitgeliefert in `plugins-core/<slug>` (Namespace `Inhaus\Plugins\…`), Kunden in `plugins/`. Kern stellt
Registries bereit (Navigation, Dashboard\\Widgets, Abilities) – siehe `docs/PLUGINS.md`.
- Rechte immer über `$user->can('ability', ['typ', id])` bzw. Policies; Sichtbarkeit über `Audiences::constrain`.

View file

@ -66,3 +66,10 @@ und danach `bin/build` ausführen, damit `vendor/` nachzieht.
`text-muted-foreground` …), nie fest verdrahtet – sonst greift das Branding nicht
- N+1-Abfragen vermeiden: `Model::preventLazyLoading()` ist außerhalb der
Produktion aktiv
## Schriften
Die mitgelieferten Schriften kommen aus `@fontsource`-Paketen, eingebunden nur
mit den Zeichensätzen Latein und Latein-Erweitert. Nach dem Hinzufügen einer
Schrift `python3 scripts/generate-fonts-css.py` ausführen und die Schrift in
`App\Support\Theme\Fonts` eintragen.

View file

@ -5,6 +5,8 @@ Webhosting. Laravel 13, Filament 5 (Admin), Inertia + Vue 3 + Tailwind CSS +
shadcn-vue im Portal, MySQL/MariaDB, Apache.
- Projektplan: [`docs/PLAN.md`](docs/PLAN.md)
- Installation beim Kunden (auch Shared Hosting): [`docs/INSTALLATION.md`](docs/INSTALLATION.md)
- Plugins entwickeln: [`docs/PLUGINS.md`](docs/PLUGINS.md)
- Mitarbeit, Entwicklungsumgebung und Release-Ablauf: [`CONTRIBUTING.md`](CONTRIBUTING.md)
- Änderungen: [`CHANGELOG.md`](CHANGELOG.md)

View file

@ -0,0 +1,47 @@
<?php
namespace App\Dashboard;
use App\Http\Resources\PersonResource;
use App\Models\User;
use App\Support\QuickLinks;
/**
* Kacheln des Kerns. Plugins ergänzen weitere über App\Dashboard\Widgets.
*/
class CoreWidgets
{
public static function register(Widgets $widgets): void
{
$widgets->add('core.greeting', 'core::Greeting', 'aside', sort: 0, props: fn (User $user) => [
'profile' => [
'job_title' => $user->job_title,
'department' => $user->department,
'location' => $user->location,
'avatar_url' => $user->avatarUrl(256),
],
], label: 'Begrüßung mit Profil', mobileSort: 0);
$widgets->add('core.quick-links', 'core::QuickLinks', 'main', sort: 10, props: fn () => [
'links' => app(QuickLinks::class)->all(),
], label: 'Schnellzugriffe', mobileSort: 40);
$widgets->add('core.new-colleagues', 'core::NewColleagues', 'main', sort: 90, props: function (User $user) {
$people = User::query()
->active()
->whereKeyNot($user->getKey())
->where('created_at', '>=', now()->subDays(90))
->latest()
->limit(6)
->get();
return $people->isEmpty() ? null : ['people' => PersonResource::collection($people)->resolve()];
}, label: 'Neue Kolleginnen und Kollegen', mobileSort: 60);
$widgets->add('core.profile-incomplete', 'core::ProfileIncomplete', 'aside', sort: 50, props: fn (User $user) => $user->avatar_path && $user->job_title ? null : [], label: 'Hinweis „Profil vervollständigen“', mobileSort: 70);
$widgets->add('core.people-search', 'core::PeopleSearch', 'aside', sort: 60, props: fn () => [
'count' => User::query()->active()->count(),
], label: 'Personen finden', mobileSort: 80);
}
}

149
app/Dashboard/Widgets.php Normal file
View file

@ -0,0 +1,149 @@
<?php
namespace App\Dashboard;
use App\Models\DashboardTile;
use App\Models\User;
use App\Support\Settings;
use Illuminate\Http\Request;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Kacheln der Startseite als Registry.
*
* Bereiche (siehe resources/js/pages/Dashboard.vue):
* top – volle Breite über allem (Hinweise, z. B. Geburtstagsgruß)
* hero – groß links oben (z. B. Slider) feed – neben hero
* main – volle Breite der linken Spalte aside – rechte Spalte
*
* Die Props-Funktion liefert die Daten der Kachel oder null, wenn sie für
* diese Person nichts anzuzeigen hat.
*/
class Widgets
{
public const AREAS = ['top', 'hero', 'feed', 'main', 'aside'];
/** @var array<string, array{component: string, area: string, sort: int, mobileSort: int, props: callable, label: string}> */
private array $widgets = [];
/**
* @param string $component Vue-Komponente, z. B. „core::QuickLinks“ oder „news::Hero“
* @param callable(User, Request): (array<string, mixed>|null) $props
* @param int|null $mobileSort Reihenfolge in der einspaltigen Mobilansicht (Standard: nach Bereich)
* @param string|null $label Name im Admin unter „Startseite“
*/
public function add(string $key, string $component, string $area, int $sort, callable $props, ?int $mobileSort = null, ?string $label = null): void
{
if (! in_array($area, self::AREAS, true)) {
throw new \InvalidArgumentException("Unbekannter Bereich „{$area}“ für Kachel {$key}.");
}
$mobileSort ??= ['top' => -100, 'hero' => 10, 'feed' => 20, 'aside' => 30, 'main' => 50][$area] + $sort;
$label ??= $key;
$this->widgets[$key] = compact('component', 'area', 'sort', 'mobileSort', 'props', 'label');
}
public function remove(string $key): void
{
unset($this->widgets[$key]);
}
/**
* Alle Kacheln eines Bereichs für den Admin: mitgelieferte und eigene,
* in gespeicherter Reihenfolge, mit Sichtbarkeit.
*
* @return list<array{key: string, label: string, area: string, visible: bool, custom: bool}>
*/
public function forAdmin(string $area): array
{
$layout = $this->layout();
return $this->candidates()
->filter(fn (array $w) => $w['area'] === $area)
->map(fn (array $w, string $key) => [
'key' => $key,
'label' => $w['label'],
'area' => $w['area'],
'visible' => $layout[$key]['visible'] ?? true,
'custom' => $w['custom'] ?? false,
])
->values()
->all();
}
/**
* Mitgelieferte Kacheln plus eigene Kacheln, sortiert nach gespeicherter Anordnung.
*
* @return Collection<string, array<string, mixed>>
*/
private function candidates(?User $user = null)
{
$widgets = collect($this->widgets);
try {
$tiles = DashboardTile::query()->when($user, fn ($q) => $q->visibleTo($user))->get();
} catch (Throwable) {
$tiles = collect(); // Tabelle noch nicht angelegt (Aktualisierung läuft)
}
foreach ($tiles as $tile) {
$widgets[$tile->widgetKey()] = [
'component' => 'core::CustomTile',
'area' => array_key_exists($tile->area, DashboardTile::AREAS) ? $tile->area : 'aside',
'sort' => 1000 + $tile->id,
'mobileSort' => ['top' => -50, 'main' => 45, 'aside' => 32][$tile->area] ?? 32,
'props' => fn () => $tile->toWidgetProps(),
'label' => 'Eigene Kachel: '.$tile->name,
'custom' => true,
];
}
$layout = $this->layout();
return $widgets->sortBy(fn (array $w, string $key) => $layout[$key]['sort'] ?? $w['sort']);
}
/**
* Gespeicherte Anordnung: Schlüssel => [sort, visible].
*
* @return array<string, array{sort?: int, visible?: bool}>
*/
private function layout(): array
{
return (array) app(Settings::class)->get('dashboard.layout', []);
}
/**
* @return list<array{key: string, component: string, area: string, mobileSort: int, props: array<string, mixed>}>
*/
public function resolve(User $user, Request $request): array
{
$result = [];
$layout = $this->layout();
foreach ($this->candidates($user) as $key => $widget) {
if (($layout[$key]['visible'] ?? true) === false) {
continue;
}
try {
$props = ($widget['props'])($user, $request);
} catch (Throwable $e) {
// Eine fehlerhafte Kachel darf die Startseite nicht lahmlegen.
Log::error("Startseiten-Kachel {$key} fehlgeschlagen: ".$e->getMessage(), ['exception' => $e]);
continue;
}
if ($props !== null) {
$result[] = ['key' => $key, 'component' => $widget['component'], 'area' => $widget['area'], 'mobileSort' => $widget['mobileSort'], 'props' => $props];
}
}
return $result;
}
}

View file

@ -0,0 +1,66 @@
<?php
namespace App\Editorial;
use App\Models\User;
use Closure;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Bereich „Redaktion“ im Portal: Plugins melden hier ihre Arbeitslisten an
* (z. B. „Meine Seiten“, „Zur Freigabe“). Der Menüpunkt erscheint nur, wenn
* mindestens ein Abschnitt für die Person in Frage kommt.
*/
class Editorial
{
/** @var array<string, array{label: string, component: string, sort: int, visible: Closure, props: Closure}> */
private array $sections = [];
/**
* @param Closure(User): bool $visible schnelle Rechteprüfung (ohne Abfragen)
* @param Closure(User): array<string, mixed> $props
*/
public function add(string $key, string $label, string $component, int $sort, Closure $visible, Closure $props): void
{
$this->sections[$key] = compact('label', 'component', 'sort', 'visible', 'props');
}
public function remove(string $key): void
{
unset($this->sections[$key]);
}
public function visibleFor(User $user): bool
{
foreach ($this->sections as $section) {
if (($section['visible'])($user)) {
return true;
}
}
return false;
}
/**
* @return list<array{key: string, label: string, component: string, props: array<string, mixed>}>
*/
public function resolve(User $user): array
{
$result = [];
foreach (collect($this->sections)->sortBy('sort') as $key => $section) {
if (! ($section['visible'])($user)) {
continue;
}
try {
$result[] = ['key' => $key, 'label' => $section['label'], 'component' => $section['component'], 'props' => ($section['props'])($user)];
} catch (Throwable $e) {
Log::error("Redaktionsbereich {$key} fehlgeschlagen: ".$e->getMessage(), ['exception' => $e]);
}
}
return $result;
}
}

View file

@ -0,0 +1,53 @@
<?php
namespace App\Filament\Components;
use App\Models\Role;
use App\Models\User;
use App\Support\Permissions\Audiences;
use Filament\Forms\Components\Select;
use Filament\Schemas\Components\Section;
use Illuminate\Database\Eloquent\Model;
/**
* Formularbereich „Sichtbarkeit“ für Objekte mit Zielgruppen.
*/
class AudienceSection
{
public static function make(string $type, string $description = 'Leer lassen = für alle sichtbar. Sonst sehen es nur Personen, die mindestens eine Angabe erfüllen.'): Section
{
$field = fn (string $rule, string $label, callable $options) => Select::make("audience_{$rule}")
->label($label)
->multiple()
->searchable()
->options($options)
->afterStateHydrated(fn (Select $component, ?Model $record) => $component->state($record ? Audiences::get($type, $record->getKey())[$rule] : []))
->saveRelationshipsUsing(function (Model $record, Select $component) use ($type) {
// Alle drei Felder zusammen speichern (einmal pro Formular reicht, aber schadet nicht).
$state = $component->getContainer()->getRawState();
Audiences::sync($type, $record->getKey(), [
'role' => $state['audience_role'] ?? [],
'department' => $state['audience_department'] ?? [],
'location' => $state['audience_location'] ?? [],
]);
})
->dehydrated(false);
return Section::make('Sichtbarkeit')
->description($description)
->collapsible()
->schema([
$field('role', 'Rollen', fn () => Role::query()->orderBy('name')->pluck('name', 'id')->mapWithKeys(fn ($name, $id) => [(string) $id => $name])->all()),
$field('department', 'Abteilungen', fn () => self::distinct('department')),
$field('location', 'Standorte', fn () => self::distinct('location')),
]);
}
/**
* @return array<string, string>
*/
private static function distinct(string $column): array
{
return User::query()->whereNotNull($column)->distinct()->orderBy($column)->pluck($column, $column)->all();
}
}

View file

@ -0,0 +1,38 @@
<?php
namespace App\Filament\Components;
use App\Models\Grant;
use App\Models\Role;
use Filament\Forms\Components\Select;
use Illuminate\Database\Eloquent\Model;
/**
* „Welche Rollen haben dieses Recht auf diesem Objekt?“ – direkt am Objekt
* gepflegt, z. B. am Formular einer Kategorie. Speichert Grants.
*/
class RoleGrantSelect
{
public static function make(string $name, string $label, string $ability, string $resourceType, bool $includeChildren = false): Select
{
return Select::make($name)
->label($label)
->multiple()
->preload()
->options(fn () => Role::query()->where('slug', '!=', Role::ADMINISTRATION)->orderBy('name')->pluck('name', 'id')->all())
->afterStateHydrated(fn (Select $component, ?Model $record) => $component->state($record
? Grant::query()->where('ability', $ability)->where('resource_type', $resourceType)->where('resource_id', $record->getKey())->pluck('role_id')->all()
: []))
->saveRelationshipsUsing(function (Model $record, ?array $state) use ($ability, $resourceType, $includeChildren) {
$roleIds = array_map('intval', $state ?? []);
$existing = Grant::query()->where('ability', $ability)->where('resource_type', $resourceType)->where('resource_id', $record->getKey());
(clone $existing)->whereNotIn('role_id', $roleIds)->get()->each->delete();
foreach (array_diff($roleIds, (clone $existing)->pluck('role_id')->all()) as $roleId) {
Grant::query()->create(['role_id' => $roleId, 'ability' => $ability, 'resource_type' => $resourceType, 'resource_id' => $record->getKey(), 'include_children' => $includeChildren]);
}
})
->dehydrated(false);
}
}

View file

@ -2,27 +2,46 @@
namespace App\Filament\Pages;
use App\Support\Audit;
use App\Support\Branding;
use App\Support\Settings;
use App\Support\Theme\Contrast;
use App\Support\Theme\Fonts;
use App\Support\Theme\Icons;
use App\Support\Theme\Theme;
use App\Support\Theme\ThemeCompiler;
use App\Support\Theme\ThemeTransfer;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Actions\ActionGroup;
use Filament\Forms\Components\ColorPicker;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Radio;
use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Tabs;
use Filament\Schemas\Components\Tabs\Tab;
use Filament\Schemas\Components\Text;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\HtmlString;
use Symfony\Component\HttpFoundation\StreamedResponse;
use Throwable;
use UnitEnum;
/**
* Basis-Branding (Phase 0). Die vollständige Seite „Erscheinungsbild“ mit
* Logo-Varianten, Schriften, Vorschau usw. folgt in Phase 5.
* „Erscheinungsbild“ (docs/PLAN.md, Abschnitt 12): Entwurf bearbeiten, in der
* Vorschau ansehen, dann für alle veröffentlichen.
*/
class Appearance extends Page
{
protected string $view = 'filament.pages.settings-form';
protected string $view = 'filament.pages.appearance';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedPaintBrush;
@ -37,65 +56,189 @@ class Appearance extends Page
/** @var array<string, mixed>|null */
public ?array $data = [];
public function mount(Branding $branding): void
public static function canAccess(): bool
{
$this->form->fill([
'portal_name' => $branding->portalName(),
'primary_color' => $branding->primaryColor(),
'logo_path' => $branding->logoPath(),
]);
return auth()->user()?->can('appearance.manage') ?? false;
}
public function mount(Theme $theme): void
{
$this->form->fill($theme->working());
}
public function hasDraft(): bool
{
return app(Theme::class)->hasDraft();
}
public function form(Schema $schema): Schema
{
return $schema
->components([
Section::make('Portal')
->description('Name und Logo erscheinen im Kopfbereich, auf der Anmeldeseite und im Browser-Tab.')
->schema([
TextInput::make('portal_name')
->label('Name des Portals')
->placeholder(Branding::DEFAULT_NAME)
->maxLength(60),
FileUpload::make('logo_path')
->label('Logo')
->helperText('SVG, PNG oder WebP, am besten mit transparentem Hintergrund.')
->disk('uploads')
->directory('branding')
->visibility('public')
->acceptedFileTypes(['image/svg+xml', 'image/png', 'image/webp'])
->maxSize(2048),
$image = fn (string $name, string $label, string $help) => FileUpload::make($name)->label($label)->helperText($help)
->disk('uploads')->directory('theme')->visibility('public')->maxSize(4096);
return $schema->statePath('data')->components([
Tabs::make()->persistTabInQueryString()->tabs([
Tab::make('Identität')->icon(Heroicon::OutlinedIdentification)->columns(2)->schema([
TextInput::make('portal_name')->label('Name des Portals')->required()->maxLength(60)
->helperText('Erscheint im Kopfbereich, im Browser-Tab, in E-Mails und auf dem Homescreen.')->columnSpanFull(),
$image('logo_light', 'Logo für helle Flächen', 'SVG, PNG oder WebP mit transparentem Hintergrund.')
->acceptedFileTypes(['image/svg+xml', 'image/png', 'image/webp']),
$image('logo_dark', 'Logo für dunkle Flächen', 'Für den Dunkelmodus und farbige Kopfleisten, z. B. in Weiß. Leer = wie hell.')
->acceptedFileTypes(['image/svg+xml', 'image/png', 'image/webp']),
$image('logo_mark', 'Signet (quadratisch)', 'Kurzform für Smartphones, z. B. nur das Bildzeichen.')
->acceptedFileTypes(['image/svg+xml', 'image/png', 'image/webp']),
$image('app_icon', 'App-Symbol', 'Quadratisch, mindestens 512 × 512 Pixel (PNG oder JPG). Daraus entstehen Favicon und Homescreen-Symbole.')
->image()->acceptedFileTypes(['image/png', 'image/jpeg', 'image/webp']),
]),
Tab::make('Farben')->icon(Heroicon::OutlinedSwatch)->columns(2)->schema([
ColorPicker::make('primary_color')->label('Markenfarbe')->required()->regex('/^#[0-9a-fA-F]{6}$/')->live(onBlur: true)
->helperText('Wird exakt übernommen: Schaltflächen, aktive Navigation, Begrüßungskarte. Die Abstufungen werden berechnet.'),
ColorPicker::make('secondary_color')->label('Zweite Akzentfarbe (optional)')->regex('/^#[0-9a-fA-F]{6}$/')->live(onBlur: true)
->helperText('Für Kategorien und Datumsangaben. Leer = Markenfarbe.'),
Radio::make('header_style')->label('Kopfleiste')->options(Theme::HEADER_STYLES)->inline()->required()->columnSpanFull(),
Section::make('Kontrastprüfung (WCAG AA)')->columnSpanFull()->compact()->schema([
Text::make(fn (Get $get) => $this->contrastReport((string) $get('primary_color'), $get('secondary_color'))),
]),
Section::make('Farben')
->description('Aus der Primärfarbe wird die komplette Farbpalette für den hellen und den dunklen Modus berechnet.')
->schema([
ColorPicker::make('primary_color')
->label('Primärfarbe')
->regex('/^#[0-9a-fA-F]{6}$/')
->required(),
]),
])
->statePath('data');
]),
Tab::make('Schrift & Form')->icon(Heroicon::OutlinedLanguage)->columns(2)->schema([
Select::make('font_body')->label('Schrift')->options(fn (Get $get) => Fonts::options((bool) $get('custom_font')))->required()->native(false),
Select::make('font_heading')->label('Schrift für Überschriften')->options(fn (Get $get) => ['same' => 'Wie die Schrift'] + Fonts::options((bool) $get('custom_font')))->required()->native(false),
FileUpload::make('custom_font')->label('Eigene Schrift (WOFF2)')
->helperText('Z. B. die Hausschrift aus dem Corporate Design. Wird lokal ausgeliefert – keine Verbindung zu Google oder anderen Diensten. Bitte die Lizenz für die Nutzung im Web beachten.')
->disk('uploads')->directory('theme/fonts')->visibility('public')->maxSize(2048)
->acceptedFileTypes(['font/woff2', 'application/font-woff2', 'application/octet-stream'])
->rule('extensions:woff2')->live()->columnSpanFull(),
Radio::make('radius')->label('Ecken')->options(collect(Theme::RADII)->map(fn ($r) => $r[0])->all())->inline()->required(),
Radio::make('density')->label('Abstände')->options(collect(Theme::DENSITIES)->map(fn ($d) => $d[0])->all())->inline()->required(),
Radio::make('dark_mode')->label('Dunkelmodus')->options(Theme::DARK_MODES)->required()->columnSpanFull(),
]),
Tab::make('Anmeldeseite')->icon(Heroicon::OutlinedArrowRightOnRectangle)->columns(2)->schema([
Radio::make('login_layout')->label('Aufteilung')->options(Theme::LOGIN_LAYOUTS)->required()->columnSpanFull(),
TextInput::make('login_title')->label('Begrüßung')->maxLength(200)->columnSpanFull(),
Textarea::make('login_text')->label('Text darunter')->rows(2)->maxLength(500)->columnSpanFull(),
$image('login_image', 'Hintergrundbild', 'Querformat, mindestens 1600 Pixel breit. Leer = Fläche in der Markenfarbe.')
->image()->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp'])->maxSize(8192)->columnSpanFull(),
]),
Tab::make('Fußzeile & E-Mails')->icon(Heroicon::OutlinedEnvelope)->schema([
TextInput::make('footer_text')->label('Text in der Fußzeile')->placeholder('© 2027 Musterstift gGmbH')->maxLength(200),
Repeater::make('footer_links')->label('Links in der Fußzeile')->columns(2)->defaultItems(0)->reorderable()
->addActionLabel('Link hinzufügen')->maxItems(8)
->schema([
TextInput::make('label')->label('Bezeichnung')->required()->maxLength(60)->placeholder('Impressum'),
TextInput::make('url')->label('Adresse')->required()->maxLength(500)->placeholder('https://… oder /seiten/impressum'),
]),
Textarea::make('email_footer')->label('Fußzeile in E-Mails')->rows(3)->maxLength(500)
->helperText('Z. B. Anschrift und Hinweis. Logo und Markenfarbe übernehmen die E-Mails automatisch.'),
]),
Tab::make('Erweitert')->icon(Heroicon::OutlinedCodeBracket)->schema([
Textarea::make('custom_css')->label('Eigenes CSS')->rows(12)->maxLength(50000)
->extraInputAttributes(['class' => 'font-mono text-xs', 'spellcheck' => 'false'])
->helperText('Für Fortgeschrittene. Wird nach dem Portal-CSS geladen und bei Aktualisierungen unverändert übernommen. Klassennamen können sich mit neuen Versionen ändern – bitte nach jedem Update prüfen. Verfügbare Variablen: --brand, --brand-50 … --brand-950, --radius, --font-body, --font-heading.'),
]),
]),
]);
}
public function save(Settings $settings, Branding $branding): void
private function contrastReport(string $primary, ?string $secondary): HtmlString
{
$data = $this->form->getState();
$previousLogo = $branding->logoPath();
$settings->setMany([
'branding.portal_name' => filled($data['portal_name']) ? trim($data['portal_name']) : null,
'branding.primary_color' => strtoupper($data['primary_color']),
'branding.logo_path' => $data['logo_path'] ?: null,
]);
if ($previousLogo && $previousLogo !== $data['logo_path']) {
Storage::disk('uploads')->delete($previousLogo);
if (! preg_match('/^#[0-9a-fA-F]{6}$/', $primary)) {
return new HtmlString('');
}
Notification::make()
->success()
->title('Erscheinungsbild gespeichert')
->send();
$colors = ['ok' => '#15803d', 'info' => '#0369a1', 'warning' => '#b45309'];
$icons = ['ok' => '✓', 'info' => 'i', 'warning' => '!'];
return new HtmlString(collect(Contrast::report(strtoupper($primary), $secondary && preg_match('/^#[0-9a-fA-F]{6}$/', $secondary) ? strtoupper($secondary) : null))
->map(fn ($note) => '<p style="display:flex;gap:.5rem;margin:.25rem 0"><span style="font-weight:700;color:'.$colors[$note['level']].';width:1rem;text-align:center">'.$icons[$note['level']].'</span><span>'.e($note['text']).'</span></p>')
->implode(''));
}
/**
* Entwurf speichern und die Vorschau aktualisieren.
*/
public function save(Theme $theme, Branding $branding): void
{
$theme->saveDraft($this->form->getState());
session()->put(Branding::PREVIEW_SESSION_KEY, true);
$branding->refresh();
$this->dispatch('theme-preview-reload');
Notification::make()->success()->title('Entwurf gespeichert')->body('Die Vorschau zeigt jetzt den Entwurf. Für alle sichtbar wird er erst mit „Veröffentlichen“.')->send();
}
protected function getHeaderActions(): array
{
return [
Action::make('publish')->label('Veröffentlichen')->icon(Heroicon::OutlinedRocketLaunch)
->requiresConfirmation()
->modalHeading('Erscheinungsbild veröffentlichen?')
->modalDescription('Der gespeicherte Entwurf wird für alle sichtbar. Ungespeicherte Änderungen im Formular werden vorher als Entwurf gespeichert.')
->action(function (Theme $theme, ThemeCompiler $compiler, Icons $icons, Branding $branding) {
$theme->saveDraft($this->form->getState());
$theme->publish($compiler, $icons);
session()->forget(Branding::PREVIEW_SESSION_KEY);
$branding->refresh();
Audit::log('appearance.published');
$this->form->fill($theme->working());
$this->dispatch('theme-preview-reload');
Notification::make()->success()->title('Erscheinungsbild veröffentlicht')->send();
}),
Action::make('discard')->label('Entwurf verwerfen')->icon(Heroicon::OutlinedArrowUturnLeft)->color('gray')
->visible(fn () => $this->hasDraft())
->requiresConfirmation()
->action(function (Theme $theme, Branding $branding) {
$theme->discardDraft();
session()->forget(Branding::PREVIEW_SESSION_KEY);
$branding->refresh();
$this->form->fill($theme->working());
$this->dispatch('theme-preview-reload');
}),
ActionGroup::make([
Action::make('export')->label('Exportieren')->icon(Heroicon::OutlinedArrowDownTray)
->action(fn (ThemeTransfer $transfer): StreamedResponse => response()->streamDownload(
fn () => print (json_encode($transfer->export(app(Theme::class)->working()), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)),
'erscheinungsbild-'.now()->format('Y-m-d').'.json',
['Content-Type' => 'application/json'],
)),
Action::make('import')->label('Importieren')->icon(Heroicon::OutlinedArrowUpTray)
->modalDescription('Erscheinungsbild aus einer exportierten Datei übernehmen – als Entwurf, damit Sie es erst ansehen können.')
->schema([
FileUpload::make('file')->label('Datei (.json)')->disk('local')->directory('theme-import')
->acceptedFileTypes(['application/json', 'text/plain'])->maxSize(20 * 1024)->required(),
])
->action(function (array $data, ThemeTransfer $transfer, Theme $theme) {
try {
$values = $transfer->import((string) Storage::disk('local')->get($data['file']));
} catch (Throwable $e) {
Notification::make()->danger()->title('Import nicht möglich')->body($e->getMessage())->send();
return;
} finally {
Storage::disk('local')->delete($data['file']);
}
$theme->saveDraft($values);
session()->put(Branding::PREVIEW_SESSION_KEY, true);
$this->form->fill($theme->working());
$this->dispatch('theme-preview-reload');
Notification::make()->success()->title('Als Entwurf importiert')->send();
}),
Action::make('reset')->label('Auf Standard zurücksetzen')->icon(Heroicon::OutlinedArrowPath)->color('danger')
->requiresConfirmation()
->modalDescription('Setzt Farben, Schriften, Logos und Texte auf die Standardwerte zurück – als Entwurf. Der Portalname bleibt.')
->action(function (Theme $theme) {
$theme->resetToDefaults();
session()->put(Branding::PREVIEW_SESSION_KEY, true);
$this->form->fill($theme->working());
$this->dispatch('theme-preview-reload');
}),
])->label('Mehr')->icon(Heroicon::OutlinedEllipsisVertical)->button()->color('gray'),
];
}
}

View file

@ -0,0 +1,108 @@
<?php
namespace App\Filament\Pages;
use App\Dashboard\Widgets;
use App\Filament\Resources\DashboardTiles\DashboardTileResource;
use App\Support\Settings;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Forms\Components\Hidden;
use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Toggle;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use UnitEnum;
/**
* Anordnung der Startseite: Kacheln je Bereich sortieren und ausblenden –
* mitgelieferte wie eigene.
*/
class DashboardSettings extends Page
{
protected string $view = 'filament.pages.settings-form';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedHome;
protected static string|UnitEnum|null $navigationGroup = 'Portal';
protected static ?int $navigationSort = 10;
protected static ?string $navigationLabel = 'Startseite';
protected static ?string $title = 'Startseite';
protected static ?string $slug = 'startseite';
private const AREAS = [
'top' => ['Ganz oben (volle Breite)', 'Hinweise und Banner über allem.'],
'hero' => ['Groß links oben', 'Nur die erste sichtbare Kachel wird gezeigt.'],
'feed' => ['Neben dem großen Bereich', ''],
'main' => ['Hauptspalte', ''],
'aside' => ['Seitenleiste (rechts)', ''],
];
/** @var array<string, mixed>|null */
public ?array $data = [];
public static function canAccess(): bool
{
return auth()->user()?->can('appearance.manage') ?? false;
}
public function mount(Widgets $widgets): void
{
$this->form->fill(collect(self::AREAS)->mapWithKeys(fn ($info, $area) => [$area => $widgets->forAdmin($area)])->all());
}
public function form(Schema $schema): Schema
{
return $schema->statePath('data')->components(
collect(self::AREAS)->map(fn ($info, $area) => Section::make($info[0])
->description($info[1] ?: null)
->visible(fn () => app(Widgets::class)->forAdmin($area) !== [])
->schema([
Repeater::make($area)
->hiddenLabel()
->reorderable()
->reorderableWithDragAndDrop()
->addable(false)
->deletable(false)
->itemLabel(fn (array $state) => $state['label'] ?? $state['key'])
->schema([
Hidden::make('key'),
Hidden::make('label'),
Toggle::make('visible')->label('Anzeigen'),
]),
]))->values()->all()
);
}
public function save(Settings $settings): void
{
$layout = [];
foreach (array_keys(self::AREAS) as $area) {
foreach (array_values($this->data[$area] ?? []) as $index => $item) {
$layout[$item['key']] = ['sort' => $index * 10, 'visible' => (bool) ($item['visible'] ?? true)];
}
}
$settings->set('dashboard.layout', $layout);
Notification::make()->success()->title('Startseite gespeichert')->send();
}
protected function getHeaderActions(): array
{
return [
Action::make('tiles')->label('Eigene Kacheln')->icon(Heroicon::OutlinedRectangleGroup)->color('gray')
->url(fn () => DashboardTileResource::getUrl()),
Action::make('preview')->label('Startseite ansehen')->icon(Heroicon::OutlinedEye)->color('gray')
->url('/')->openUrlInNewTab(),
];
}
}

View file

@ -0,0 +1,142 @@
<?php
namespace App\Filament\Pages;
use App\Models\VendorFeedback;
use App\Support\Audit;
use App\Support\Feedback\FeedbackChannels;
use App\Support\Feedback\FeedbackOutbox;
use App\Support\Feedback\FeedbackResult;
use App\Support\Feedback\TechnicalInfo;
use App\Support\License\LicenseStore;
use BackedEnum;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use UnitEnum;
/**
* „Hilfe → Rückmeldung geben“: Fehlerbericht oder Funktionswunsch an den
* Hersteller (docs/specs/feedback.md).
*/
class Feedback extends Page
{
protected string $view = 'filament.pages.feedback';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedChatBubbleLeftEllipsis;
protected static string|UnitEnum|null $navigationGroup = 'Hilfe';
protected static ?string $navigationLabel = 'Rückmeldung geben';
protected static ?string $title = 'Rückmeldung geben';
public static function canAccess(): bool
{
return auth()->user()?->can('feedback.send') ?? false;
}
protected static ?string $slug = 'rueckmeldung';
public string $type = '';
public string $subject = '';
public string $body = '';
public string $severity = 'normal';
public string $email = '';
public string $name = '';
public ?string $lastReference = null;
public ?string $notice = null;
public function mount(FeedbackChannels $channels): void
{
$this->type = (string) array_key_first($channels->available());
}
public function submit(FeedbackChannels $channels, FeedbackOutbox $outbox, TechnicalInfo $info): void
{
$available = $channels->available();
$this->validate([
'type' => ['required', 'in:'.implode(',', array_keys($available))],
'subject' => ['required', 'string', 'max:255'],
'body' => ['required', 'string', 'min:10', 'max:20000'],
'severity' => ['required', 'in:low,normal,high,critical'],
'email' => ['nullable', 'email', 'max:255'],
'name' => ['nullable', 'string', 'max:255'],
], attributes: [
'type' => 'Art der Meldung', 'subject' => 'Betreff', 'body' => 'Beschreibung',
'email' => 'E-Mail-Adresse', 'name' => 'Name',
]);
$this->notice = null;
$this->lastReference = null;
$payload = array_filter([
'title' => $this->subject,
'body' => $this->body,
'email' => $this->email ?: null,
'name' => $this->name ?: null,
'severity' => $this->type === 'bugreport' ? $this->severity : null,
...$info->collect(),
], fn ($value) => $value !== null);
$result = $outbox->submit(auth()->user(), $this->type, $payload);
switch ($result->status) {
case FeedbackResult::SENT:
Audit::log('feedback.sent', ['type' => $this->type, 'reference' => $result->reference]);
$this->lastReference = $result->reference;
$this->reset(['subject', 'body', 'severity']);
Notification::make()->success()->title('Vielen Dank – Ihre Meldung ist eingegangen')->body("Referenznummer: {$result->reference}")->persistent()->send();
break;
case FeedbackResult::RETRY:
$this->reset(['subject', 'body', 'severity']);
$this->notice = 'Der Server ist gerade nicht erreichbar. Ihre Meldung ist gespeichert und wird automatisch gesendet, sobald es wieder geht. Die Referenznummer erscheint dann unten in der Liste.';
break;
case FeedbackResult::INVALID:
// Fehler direkt am betroffenen Feld anzeigen (API-Feld „title“ = Formularfeld „subject“).
foreach ($result->errors as $field => $message) {
$field = $field === 'title' ? 'subject' : $field;
$this->addError(in_array($field, ['subject', 'body', 'email', 'name', 'severity'], true) ? $field : 'body', $message);
}
if ($result->errors === []) {
$this->addError('body', $result->message ?? 'Die Eingabe ist unvollständig.');
}
break;
case FeedbackResult::RATE_LIMITED:
$minutes = $result->retryAfter ? max(1, (int) ceil($result->retryAfter / 60)) : null;
$this->notice = 'Es wurden zu viele Meldungen in kurzer Zeit gesendet. Bitte versuchen Sie es '.($minutes ? "in etwa {$minutes} Minute(n)" : 'später').' noch einmal – Ihre Eingabe bleibt erhalten.';
break;
case FeedbackResult::DISABLED:
$channels->disable($this->type);
$this->notice = 'Dieser Meldeweg steht nicht mehr zur Verfügung. Ihre Eingabe bleibt erhalten'.(count($channels->available()) ? ' – bitte wählen Sie eine andere Art der Meldung.' : '.');
$this->type = (string) array_key_first($channels->available());
break;
}
}
/**
* @return array<string, mixed>
*/
protected function getViewData(): array
{
return [
'types' => app(FeedbackChannels::class)->available(),
'technical' => app(TechnicalInfo::class)->collect(),
'hasLicense' => app(LicenseStore::class)->hasLicense(),
'history' => VendorFeedback::query()->where('user_id', auth()->id())->latest()->limit(20)->get(),
];
}
}

View file

@ -0,0 +1,109 @@
<?php
namespace App\Filament\Pages;
use App\Support\Audit;
use App\Support\MailSettings;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Illuminate\Support\Facades\Mail;
use Throwable;
use UnitEnum;
/**
* SMTP-Zugang für Benachrichtigungen, Formulare und „Passwort vergessen“.
*/
class MailSettingsPage extends Page
{
protected string $view = 'filament.pages.settings-form';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedEnvelope;
protected static string|UnitEnum|null $navigationGroup = 'System';
protected static ?int $navigationSort = 5;
protected static ?string $navigationLabel = 'E-Mail-Versand';
protected static ?string $title = 'E-Mail-Versand';
protected static ?string $slug = 'e-mail';
/** @var array<string, mixed>|null */
public ?array $data = [];
public static function canAccess(): bool
{
return auth()->user()?->can('mail.manage') ?? false;
}
public function mount(MailSettings $mail): void
{
$this->form->fill([...$mail->values(), 'password' => null]);
}
public function form(Schema $schema): Schema
{
$smtp = fn (Get $get) => $get('mailer') === 'smtp';
return $schema
->components([
Section::make('Versand')
->description('Die Zugangsdaten erhalten Sie von Ihrem Hoster oder Ihrer IT (z. B. Microsoft 365: smtp.office365.com, Port 587, TLS).')
->columns(2)
->schema([
Select::make('mailer')->label('Versandart')->options(MailSettings::MAILERS)->required()->live()->native(false)->columnSpanFull(),
TextInput::make('host')->label('SMTP-Server')->required($smtp)->visible($smtp)->maxLength(255),
TextInput::make('port')->label('Port')->numeric()->required($smtp)->visible($smtp)->minValue(1)->maxValue(65535),
Select::make('encryption')->label('Verschlüsselung')->visible($smtp)->native(false)
->options(['tls' => 'STARTTLS (meist Port 587)', 'ssl' => 'SSL/TLS (meist Port 465)', 'none' => 'Keine']),
TextInput::make('username')->label('Benutzername')->visible($smtp)->maxLength(255)->autocomplete('off'),
TextInput::make('password')->label('Passwort')->password()->revealable()->visible($smtp)->maxLength(255)
->helperText('Leer lassen, um das gespeicherte Passwort zu behalten.')->autocomplete('new-password'),
]),
Section::make('Absender')
->columns(2)
->schema([
TextInput::make('from_address')->label('Absenderadresse')->email()->required()->maxLength(255)->placeholder('intranet@firma.de'),
TextInput::make('from_name')->label('Absendername')->maxLength(100)->placeholder('Name des Portals'),
]),
])
->statePath('data');
}
public function save(MailSettings $mail): void
{
$mail->save($this->form->getState());
Audit::log('mail.settings_updated');
Notification::make()->success()->title('E-Mail-Versand gespeichert')->send();
}
protected function getHeaderActions(): array
{
return [
Action::make('test')
->label('Test-Mail senden')
->icon(Heroicon::OutlinedPaperAirplane)
->color('gray')
->action(function () {
$to = auth()->user()->email;
try {
Mail::raw('Diese Test-Mail bestätigt, dass der E-Mail-Versand des Portals funktioniert.', fn ($m) => $m->to($to)->subject('Test-Mail aus dem Portal'));
Notification::make()->success()->title('Test-Mail an '.$to.' gesendet')->send();
} catch (Throwable $e) {
Notification::make()->danger()->title('Versand fehlgeschlagen')->body($e->getMessage())->persistent()->send();
}
}),
];
}
}

View file

@ -0,0 +1,102 @@
<?php
namespace App\Filament\Pages;
use App\Models\Grant;
use App\Models\User;
use App\Support\Abilities;
use BackedEnum;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use Illuminate\Support\Facades\DB;
use UnitEnum;
/**
* „Was darf Person X – und warum?“ Zeigt Rollen samt Herkunft und alle Rechte
* mit der Rolle, aus der sie stammen.
*/
class PermissionChecker extends Page
{
protected string $view = 'filament.pages.permission-checker';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedMagnifyingGlassCircle;
protected static string|UnitEnum|null $navigationGroup = 'Benutzer & Rechte';
protected static ?int $navigationSort = 3;
protected static ?string $title = 'Rechte prüfen';
protected static ?string $slug = 'rechte-pruefen';
public ?int $userId = null;
public string $search = '';
public static function canAccess(): bool
{
return auth()->user()?->can('roles.manage') ?? false;
}
public function mount(): void
{
$this->userId = request()->integer('person') ?: null;
}
public function selectUser(int $id): void
{
$this->userId = $id;
$this->search = '';
}
/**
* @return array<string, mixed>
*/
protected function getViewData(): array
{
$abilities = app(Abilities::class);
$user = $this->userId ? User::query()->find($this->userId) : null;
$results = strlen($this->search) >= 2
? User::query()->where(fn ($q) => $q->where('name', 'like', "%{$this->search}%")->orWhere('email', 'like', "%{$this->search}%"))->orderBy('name')->limit(8)->get()
: collect();
$roles = collect();
$global = collect();
$objects = collect();
if ($user) {
$roles = DB::table('role_user')->join('roles', 'roles.id', '=', 'role_user.role_id')
->where('role_user.user_id', $user->id)
->orderBy('roles.name')
->get(['roles.id', 'roles.name', 'role_user.source', 'role_user.source_ref']);
$grants = Grant::query()->with('role')->whereIn('role_id', $roles->pluck('id')->unique())->get();
$types = $abilities->resourceTypes();
$global = $grants->whereNull('resource_type')->map(fn (Grant $g) => [
'label' => $g->ability === '*' ? 'Alle Rechte (voller Zugriff)' : $abilities->label($g->ability),
'role' => $g->role->name,
])->sortBy('label')->values();
$objects = $grants->whereNotNull('resource_type')->map(function (Grant $g) use ($abilities, $types) {
$options = isset($types[$g->resource_type]) ? ($types[$g->resource_type]['options'])() : [];
return [
'label' => $abilities->label($g->ability),
'object' => ($types[$g->resource_type]['label'] ?? $g->resource_type).': '.($g->resource_id === null ? 'alle' : ($options[$g->resource_id] ?? '#'.$g->resource_id)),
'role' => $g->role->name,
];
})->sortBy('label')->values();
}
return [
'user' => $user,
'results' => $results,
'roles' => $roles,
'global' => $global,
'objects' => $objects,
'canAdmin' => $user?->canAccessAdmin() ?? false,
];
}
}

View file

@ -0,0 +1,102 @@
<?php
namespace App\Filament\Pages;
use App\Plugins\PluginInstaller;
use App\Plugins\PluginManager;
use App\Plugins\PluginManifest;
use BackedEnum;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
use Livewire\WithFileUploads;
use Throwable;
use UnitEnum;
class Plugins extends Page
{
use WithFileUploads;
protected string $view = 'filament.pages.plugins';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedPuzzlePiece;
protected static string|UnitEnum|null $navigationGroup = 'System';
protected static ?int $navigationSort = 5;
protected static ?string $title = 'Plugins';
protected static ?string $slug = 'plugins';
/** @var TemporaryUploadedFile|null */
public $archive = null;
public static function canAccess(): bool
{
return auth()->user()?->can('plugins.manage') ?? false;
}
public function activate(string $slug, PluginManager $plugins): void
{
$this->run(fn () => $plugins->activate($slug), 'Plugin aktiviert', 'Die Änderungen sind ab dem nächsten Seitenaufruf sichtbar.');
}
public function deactivate(string $slug, PluginManager $plugins): void
{
$this->run(fn () => $plugins->deactivate($slug), 'Plugin deaktiviert', 'Die Daten bleiben erhalten und stehen nach erneuter Aktivierung wieder zur Verfügung.');
}
public function delete(string $slug, bool $removeData, PluginManager $plugins): void
{
$this->run(fn () => $plugins->delete($slug, $removeData), 'Plugin gelöscht', $removeData ? 'Das Plugin und seine Daten wurden entfernt.' : 'Die Daten des Plugins sind noch in der Datenbank.');
}
public function upload(PluginInstaller $installer): void
{
$this->validate(['archive' => ['required', 'file', 'mimes:zip', 'max:51200']], attributes: ['archive' => 'ZIP-Archiv']);
try {
$manifest = $installer->install($this->archive->getRealPath());
$this->archive = null;
Notification::make()
->success()
->title("„{$manifest->name}“ {$manifest->version} installiert")
->body('Das Plugin kann jetzt aktiviert werden.')
->send();
} catch (Throwable $e) {
$this->addError('archive', $e->getMessage());
}
}
private function run(callable $action, string $title, string $body): void
{
try {
$action();
Notification::make()->success()->title($title)->body($body)->send();
$this->redirect(static::getUrl());
} catch (Throwable $e) {
Notification::make()->danger()->title('Nicht möglich')->body($e->getMessage())->send();
}
}
/**
* @return array<string, mixed>
*/
protected function getViewData(): array
{
$plugins = app(PluginManager::class);
return [
'plugins' => collect($plugins->all())->map(fn (PluginManifest $m) => [
'manifest' => $m,
'enabled' => $plugins->isEnabled($m->slug),
'problem' => $plugins->problem($m->slug) ?? (($issues = $m->incompatibilities()) ? implode(', ', $issues) : null),
'dependents' => $plugins->dependents($m->slug),
])->sortBy(fn (array $p) => [$p['manifest']->core ? 0 : 1, $p['manifest']->name])->values(),
'uploadsAllowed' => PluginInstaller::uploadsAllowed(),
];
}
}

View file

@ -28,6 +28,11 @@ class QuickLinksSettings extends Page
protected static ?string $title = 'Schnellzugriffe';
public static function canAccess(): bool
{
return auth()->user()?->can('appearance.manage') ?? false;
}
protected static ?string $slug = 'schnellzugriffe';
/** @var array<string, mixed>|null */

View file

@ -0,0 +1,44 @@
<?php
namespace App\Filament\Pages;
use App\Support\BackgroundTasks;
use App\Support\SiteHealth;
use BackedEnum;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use UnitEnum;
class SystemHealth extends Page
{
protected string $view = 'filament.pages.system-health';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedHeart;
protected static string|UnitEnum|null $navigationGroup = 'System';
protected static ?int $navigationSort = 20;
protected static ?string $navigationLabel = 'Systemzustand';
protected static ?string $title = 'Systemzustand';
public static function canAccess(): bool
{
return auth()->user()?->can('updates.manage') ?? false;
}
protected static ?string $slug = 'systemzustand';
/**
* @return array<string, mixed>
*/
protected function getViewData(): array
{
return [
'groups' => app(SiteHealth::class)->all(),
'cronLine' => '* * * * * cd '.base_path().' && php artisan schedule:run >> /dev/null 2>&1',
'webCronUrl' => url('/cron/'.app(BackgroundTasks::class)->webCronToken()),
];
}
}

View file

@ -0,0 +1,136 @@
<?php
namespace App\Filament\Pages;
use App\Support\Audit;
use App\Support\License\LicenseService;
use App\Support\License\LicenseStore;
use App\Support\License\ServerError;
use App\Support\License\ServerMessages;
use App\Support\Update\Changelog;
use App\Support\Update\Channels;
use App\Support\Update\InstalledVersion;
use App\Support\Update\Migrations;
use App\Support\Update\UpdateProgress;
use BackedEnum;
use Filament\Notifications\Notification;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use Throwable;
use UnitEnum;
/**
* Seite „Aktualisierung“: Version, Kanal, Update-Suche und -Installation,
* Migrationen, Änderungsprotokoll und Lizenz (docs/specs/self-updater.md).
*/
class Updates extends Page
{
protected string $view = 'filament.pages.updates';
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedArrowPathRoundedSquare;
protected static string|UnitEnum|null $navigationGroup = 'System';
protected static ?int $navigationSort = 10;
protected static ?string $navigationLabel = 'Aktualisierung';
protected static ?string $title = 'Aktualisierung';
public static function canAccess(): bool
{
return auth()->user()?->can('updates.manage') ?? false;
}
protected static ?string $slug = 'aktualisierung';
public string $licenseEmail = '';
public string $licenseKey = '';
public ?string $licenseError = null;
public function mount(LicenseStore $license): void
{
$this->licenseEmail = (string) $license->email();
}
public function saveLicense(LicenseStore $license, LicenseService $service): void
{
$this->validate([
'licenseEmail' => ['required', 'email', 'max:255'],
'licenseKey' => [$license->hasLicense() ? 'nullable' : 'required', 'string', 'max:500'],
], attributes: ['licenseEmail' => 'Lizenz-E-Mail', 'licenseKey' => 'Lizenzschlüssel']);
$license->setLicense($this->licenseEmail, filled($this->licenseKey) ? $this->licenseKey : (string) $license->key());
$this->licenseKey = '';
Audit::log('license.saved', ['email' => $this->licenseEmail]);
$this->checkLicense($service);
}
public function checkLicense(LicenseService $service): void
{
$this->licenseError = null;
try {
$service->check();
Notification::make()->success()->title('Lizenz geprüft')->send();
} catch (ServerError $e) {
$this->licenseError = ServerMessages::for($e);
} catch (Throwable $e) {
$this->licenseError = 'Die Lizenz konnte nicht geprüft werden: '.$e->getMessage();
}
}
public function releaseDevice(LicenseService $service, LicenseStore $license): void
{
try {
$service->releaseDevice();
Audit::log('license.device_released', ['device_label' => $license->deviceLabel()]);
Notification::make()
->success()
->title('Installation abgemeldet')
->body('Der Geräteplatz ist wieder frei. Updates sind erst nach erneuter Lizenzprüfung wieder möglich.')
->send();
} catch (ServerError $e) {
Notification::make()->danger()->title('Abmelden fehlgeschlagen')->body(ServerMessages::for($e))->send();
}
}
/**
* @return array<string, mixed>
*/
protected function getViewData(): array
{
$version = app(InstalledVersion::class);
$license = app(LicenseStore::class);
$channels = app(Channels::class);
try {
$migrations = app(Migrations::class)->status();
} catch (Throwable) {
$migrations = [];
}
return [
'release' => $version->release(),
'shortSha' => $version->short(),
'channels' => $channels->all(),
'activeChannel' => $channels->active(),
'progress' => app(UpdateProgress::class)->get(),
'migrations' => $migrations,
'pendingMigrations' => count(array_filter($migrations, fn (array $m) => ! $m['ran'])),
'changelog' => app(Changelog::class)->sections(),
'hasLicense' => $license->hasLicense(),
'maskedKey' => ($key = $license->key()) ? str_repeat('•', 8).substr($key, -4) : null,
'licenseSummary' => app(LicenseService::class)->summary(),
'licenseStatusError' => ($code = $license->lastStatus()['error_code'] ?? null)
? ServerMessages::for(new ServerError($code, 0, $code))
: null,
'deviceLabel' => $license->deviceLabel(),
];
}
}

View file

@ -0,0 +1,104 @@
<?php
namespace App\Filament\Resources\DashboardTiles;
use App\Filament\Components\AudienceSection;
use App\Filament\Resources\DashboardTiles\Pages\ManageDashboardTiles;
use App\Models\DashboardTile;
use BackedEnum;
use Filament\Actions\DeleteAction;
use Filament\Actions\EditAction;
use Filament\Forms\Components\DateTimePicker;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\RichEditor;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Resources\Resource;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\ImageColumn;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use UnitEnum;
/**
* Eigene Kacheln der Startseite. Reihenfolge und Ein-/Ausblenden unter „Startseite“.
*/
class DashboardTileResource extends Resource
{
protected static ?string $model = DashboardTile::class;
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedRectangleGroup;
protected static string|UnitEnum|null $navigationGroup = 'Portal';
protected static ?int $navigationSort = 11;
protected static ?string $modelLabel = 'Eigene Kachel';
protected static ?string $pluralModelLabel = 'Eigene Kacheln';
protected static ?string $slug = 'kacheln';
public static function canAccess(): bool
{
return auth()->user()?->can('appearance.manage') ?? false;
}
public static function form(Schema $schema): Schema
{
$type = fn (string ...$types) => fn (Get $get) => in_array($get('type'), $types, true);
return $schema->columns(2)->components([
TextInput::make('name')->label('Name (nur im Admin)')->required()->maxLength(100),
Select::make('type')->label('Art')->options(DashboardTile::TYPES)->default('image')->required()->live()->native(false),
Select::make('area')->label('Bereich')->options(DashboardTile::AREAS)->default('aside')->required()->native(false)
->helperText('Die Reihenfolge innerhalb des Bereichs legen Sie unter „Startseite“ fest.'),
TextInput::make('title')->label(fn (Get $get) => $get('type') === 'image' ? 'Bildunterschrift (optional)' : 'Überschrift')->maxLength(150),
FileUpload::make('image_path')->label('Bild')->image()->disk('uploads')->directory('dashboard')->visibility('public')
->maxSize(8 * 1024)->required($type('image'))->visible($type('image'))->columnSpanFull()
->helperText('Für die Seitenleiste z. B. 800 × 600 Pixel, für „ganz oben“ ein breites Banner (z. B. 2400 × 500).'),
TextInput::make('alt')->label('Alternativtext')->maxLength(200)->visible($type('image'))->helperText('Beschreibt das Bild für Screenreader.'),
RichEditor::make('body')->label('Text')->toolbarButtons([['bold', 'italic', 'link'], ['bulletList', 'orderedList'], ['undo', 'redo']])
->required($type('text', 'notice'))->visible($type('text', 'notice'))->columnSpanFull(),
Select::make('variant')->label('Farbe')->options(DashboardTile::VARIANTS)->default('brand')->visible($type('notice'))->native(false),
TextInput::make('url')->label('Link')->placeholder('https://… oder /seiten/…')->maxLength(2000),
Toggle::make('new_tab')->label('In neuem Tab öffnen')->inline(false),
Section::make('Anzeige')->columnSpanFull()->columns(3)->schema([
Toggle::make('is_active')->label('Aktiv')->default(true)->inline(false),
DateTimePicker::make('starts_at')->label('Ab')->native(false)->seconds(false)->displayFormat('d.m.Y H:i'),
DateTimePicker::make('ends_at')->label('Bis')->native(false)->seconds(false)->displayFormat('d.m.Y H:i')->after('starts_at'),
]),
AudienceSection::make('dashboard_tile', 'Wer die Kachel sieht. Leer lassen = alle.')->columnSpanFull(),
]);
}
public static function table(Table $table): Table
{
return $table
->columns([
ImageColumn::make('image_path')->label('')->disk('uploads')->width(64)->height(40),
TextColumn::make('name')->label('Name')->weight('medium')->searchable(),
TextColumn::make('type')->label('Art')->formatStateUsing(fn (string $state) => DashboardTile::TYPES[$state] ?? $state),
TextColumn::make('area')->label('Bereich')->formatStateUsing(fn (string $state) => DashboardTile::AREAS[$state] ?? $state),
IconColumn::make('is_active')->label('Aktiv')->boolean(),
TextColumn::make('ends_at')->label('Bis')->dateTime('d.m.Y H:i')->placeholder('–'),
])
->recordActions([EditAction::make(), DeleteAction::make()])
->emptyStateHeading('Noch keine eigenen Kacheln')
->emptyStateDescription('Zum Beispiel ein verlinktes Bild in der Seitenleiste oder ein Hinweis ganz oben.');
}
public static function getPages(): array
{
return ['index' => ManageDashboardTiles::route('/')];
}
}

View file

@ -0,0 +1,24 @@
<?php
namespace App\Filament\Resources\DashboardTiles\Pages;
use App\Filament\Pages\DashboardSettings;
use App\Filament\Resources\DashboardTiles\DashboardTileResource;
use Filament\Actions\Action;
use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ManageRecords;
use Filament\Support\Icons\Heroicon;
class ManageDashboardTiles extends ManageRecords
{
protected static string $resource = DashboardTileResource::class;
protected function getHeaderActions(): array
{
return [
Action::make('layout')->label('Anordnung der Startseite')->icon(Heroicon::OutlinedSquares2x2)->color('gray')
->url(fn () => DashboardSettings::getUrl()),
CreateAction::make()->label('Kachel anlegen'),
];
}
}

View file

@ -0,0 +1,269 @@
<?php
namespace App\Filament\Resources\IdentityProviders;
use App\Filament\Resources\IdentityProviders\Pages\CreateIdentityProvider;
use App\Filament\Resources\IdentityProviders\Pages\EditIdentityProvider;
use App\Filament\Resources\IdentityProviders\Pages\ListIdentityProviders;
use App\Filament\Resources\IdentityProviders\Pages\TestMapping;
use App\Http\Controllers\Auth\IdentityLoginController;
use App\Identity\Entra\EntraAttributes;
use App\Identity\Entra\EntraDirectorySync;
use App\Identity\Entra\MappingTester;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\Role;
use App\Support\ProfileFields;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Actions\EditAction;
use Filament\Forms\Components\Hidden;
use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TagsInput;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Notifications\Notification;
use Filament\Resources\Resource;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Text;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Components\Utilities\Set;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Support\Carbon;
use Illuminate\Support\HtmlString;
use Throwable;
use UnitEnum;
class IdentityProviderResource extends Resource
{
protected static ?string $model = IdentityProvider::class;
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedKey;
protected static string|UnitEnum|null $navigationGroup = 'Benutzer & Rechte';
protected static ?int $navigationSort = 4;
protected static ?string $modelLabel = 'Anmeldung (Identity Provider)';
protected static ?string $pluralModelLabel = 'Anmeldung';
protected static ?string $navigationLabel = 'Anmeldung';
protected static ?string $slug = 'anmeldung';
public static function canAccess(): bool
{
return auth()->user()?->can('identity.manage') ?? false;
}
public static function form(Schema $schema): Schema
{
$guid = '/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i';
return $schema
->columns(1)
->components([
Section::make('Microsoft Entra ID')
->columns(2)
->schema([
Hidden::make('type')->default(IdentityProvider::ENTRA),
TextInput::make('name')->label('Bezeichnung')->required()->maxLength(100)->default('Microsoft Entra ID'),
TextInput::make('config.button_label')->label('Text auf dem Anmeldeknopf')->placeholder('Mit Microsoft anmelden')->maxLength(60),
Toggle::make('enabled')->label('Anmeldung aktiv')->helperText('Zeigt „Mit Microsoft anmelden“ auf der Anmeldeseite. Die Anmeldung mit Passwort bleibt für Notfälle erhalten.')->columnSpanFull(),
]),
Section::make('App-Registrierung')
->description('Aus dem Microsoft Entra Admin Center → App-Registrierungen.')
->columns(2)
->schema([
Text::make(fn (?IdentityProvider $record) => new HtmlString(
'Umleitungs-URI (Typ „Web“): <code>'.e($record ? IdentityLoginController::callbackUrlFor($record) : url('/auth/<kürzel>/callback')).'</code><br>'
.'API-Berechtigungen (Microsoft Graph): delegiert <em>User.Read</em>, <em>GroupMember.Read.All</em>; '
.'für den Hintergrund-Abgleich zusätzlich Anwendung <em>User.Read.All</em>, <em>GroupMember.Read.All</em> und <em>Application.Read.All</em> (für App-Rollen) – jeweils mit Administratorzustimmung.'
))->columnSpanFull(),
TextInput::make('config.tenant_id')->label('Verzeichnis-ID (Mandant)')->required()->regex($guid)
->validationMessages(['regex' => 'Bitte die Verzeichnis-ID als GUID angeben (nicht den Domainnamen).']),
TextInput::make('config.client_id')->label('Anwendungs-ID (Client)')->required()->regex($guid)
->validationMessages(['regex' => 'Bitte die Anwendungs-ID als GUID angeben.']),
TextInput::make('config.client_secret')->label('Geheimer Clientschlüssel')->password()->revealable()
->required(fn (string $operation) => $operation === 'create')
->helperText(fn (string $operation) => $operation === 'edit' ? 'Leer lassen, um den gespeicherten Schlüssel zu behalten.' : 'Der Wert (nicht die ID) des Geheimnisses.'),
]),
Section::make('Konten')
->columns(2)
->schema([
Toggle::make('config.auto_provision')->label('Konto bei erster Anmeldung anlegen')->default(true),
Toggle::make('config.link_by_email')->label('Bestehende Konten über die E-Mail-Adresse verknüpfen')->default(true),
TagsInput::make('config.allowed_domains')->label('Erlaubte E-Mail-Domains')->placeholder('firma.de')
->helperText('Leer = alle Konten des Mandanten.'),
Select::make('config.default_role_id')->label('Standardrolle für alle')
->options(fn () => Role::query()->where('slug', '!=', Role::ADMINISTRATION)->orderBy('name')->pluck('name', 'id')->all())
->helperText('z. B. „Mitarbeitende“ – erhält jede Person, die sich über Entra anmeldet.'),
]),
Section::make('Profil')
->key('profile')
->description('Jedes Microsoft-Graph-Attribut lässt sich einem Profilfeld zuordnen – auch Personalnummer, Kostenstelle, lokale Erweiterungsattribute oder eigene Verzeichniserweiterungen. Zugeordnete Felder sind im Portal schreibgeschützt. Eigene Felder legen Sie unter „Profilfelder“ an.')
->afterHeader([
Action::make('loadExtensions')->label('Erweiterungsattribute laden')->icon(Heroicon::OutlinedArrowPath)
->color('gray')->size('sm')
->visible(fn (string $operation) => $operation === 'edit')
->action(function (IdentityProvider $record) {
try {
$names = app(MappingTester::class)->loadExtensionProperties($record);
Notification::make()->success()->title(count($names).' Verzeichniserweiterungen gefunden')
->body($names === [] ? 'Im Mandanten sind keine Erweiterungen für Benutzer registriert.' : 'Sie stehen jetzt in der Attributauswahl zur Verfügung.')
->send();
} catch (Throwable $e) {
Notification::make()->danger()->title('Erweiterungen konnten nicht geladen werden')
->body($e->getMessage().' Benötigt die Anwendungsberechtigung Directory.Read.All.')->send();
}
}),
])
->schema([
Repeater::make('config.attribute_map')
->hiddenLabel()
->columns(3)
->addActionLabel('Zuordnung hinzufügen')
->reorderable(false)
->default(fn () => collect(EntraAttributes::DEFAULT_MAP)->map(fn ($attribute, $target) => ['target' => $target, 'attribute' => $attribute])->values()->all())
->itemLabel(fn (array $state) => static::profileTargets()[$state['target'] ?? ''] ?? null)
->collapsible(false)
->schema([
Select::make('target')->label('Profilfeld')->required()->native(false)
->options(fn () => static::profileTargets())
->disableOptionsWhenSelectedInSiblingRepeaterItems(),
Select::make('suggestion')->label('Attribut auswählen')->placeholder('Aus der Liste übernehmen …')->searchable()->native(false)
->options(fn (?IdentityProvider $record) => collect(EntraAttributes::suggestions($record))
->mapWithKeys(fn ($label, $path) => [$path => $label.' · '.$path])->all())
->live()
->afterStateUpdated(fn (?string $state, Set $set) => $state ? $set('attribute', $state) : null)
->dehydrated(false),
TextInput::make('attribute')->label('Graph-Attribut')->required()->maxLength(191)
->regex(EntraAttributes::PATH_PATTERN)
->validationMessages(['regex' => 'Attributname oder Pfad mit Punkten, z. B. employeeOrgData.costCenter.'])
->datalist(fn (?IdentityProvider $record) => array_keys(EntraAttributes::suggestions($record)))
->placeholder('z. B. employeeId'),
]),
Text::make('Pfade mit Punkt lesen verschachtelte Werte (employeeOrgData.costCenter, businessPhones.0). Listen werden mit Komma verbunden. Manche Attribute brauchen zusätzliche Berechtigungen, z. B. employeeHireDate die Berechtigung User-LifeCycleInfo.Read.All.'),
Toggle::make('config.sync_manager')->label('Vorgesetzte*n aus Entra übernehmen')->default(true),
Toggle::make('config.sync_photo')->label('Profilfoto aus Entra übernehmen')->default(true),
]),
Section::make('Hintergrund-Abgleich')
->description('Übernimmt Änderungen und deaktiviert Konten, die in Entra deaktiviert oder gelöscht wurden – auch ohne Anmeldung. Läuft alle 15 Minuten mit den Hintergrundaufgaben.')
->columns(2)
->schema([
Toggle::make('config.directory_sync')->label('Abgleich aktiv')->live(),
Toggle::make('config.directory_create_users')->label('Alle Konten vorab anlegen')
->helperText('Sonst werden Konten erst bei der ersten Anmeldung angelegt.')
->visible(fn (Get $get) => (bool) $get('config.directory_sync')),
Text::make(fn (?IdentityProvider $record) => static::syncStatus($record))->columnSpanFull()
->visible(fn (?IdentityProvider $record, Get $get) => $record && $get('config.directory_sync')),
]),
Section::make('Gruppen und App-Rollen → Rollen')
->description('Personen in diesen Entra-Gruppen bzw. mit diesen App-Rollen erhalten die Rolle im Portal. Rollen sind additiv; manuell vergebene Rollen bleiben unberührt. Mehrere Zeilen je Gruppe für mehrere Rollen.')
->schema([
Repeater::make('mappings')
->relationship()
->hiddenLabel()
->columns(4)
->defaultItems(0)
->addActionLabel('Zuordnung hinzufügen')
->schema([
Select::make('kind')->label('Art')->options([IdpGroupMapping::GROUP => 'Gruppe', IdpGroupMapping::APP_ROLE => 'App-Rolle'])
->default(IdpGroupMapping::GROUP)->required()->live(),
Select::make('group_lookup')->label('Gruppe suchen')
->searchable()
->visible(fn (Get $get) => $get('kind') === IdpGroupMapping::GROUP)
->getSearchResultsUsing(function (string $search, $livewire) {
try {
return app(MappingTester::class)->searchGroups($livewire->getRecord(), $search);
} catch (Throwable) {
return [];
}
})
->getOptionLabelUsing(fn (?string $value) => $value)
->live()
->afterStateUpdated(function (?string $state, Set $set, $component) {
if ($state) {
$set('external_id', $state);
$set('external_name', trim(preg_replace('/\s*\([0-9a-f]{8}…\)$/', '', (string) $component->getOptionLabel())));
}
})
->helperText('Erfordert den Hintergrund-Abgleich (Anwendungsberechtigung).')
->dehydrated(false),
TextInput::make('external_id')
->label(fn (Get $get) => $get('kind') === IdpGroupMapping::APP_ROLE ? 'Wert der App-Rolle' : 'Objekt-ID der Gruppe')
->required()->maxLength(191),
TextInput::make('external_name')->label('Bezeichnung')->maxLength(191),
Select::make('role_id')->label('Rolle im Portal')->required()
->options(fn () => Role::query()->orderBy('name')->pluck('name', 'id')->all()),
])
->visible(fn (string $operation) => $operation === 'edit'),
Text::make('Zuordnungen lassen sich nach dem ersten Speichern pflegen.')->visible(fn (string $operation) => $operation === 'create'),
]),
]);
}
/**
* @return array<string, string> Zielfeld => Bezeichnung
*/
public static function profileTargets(): array
{
return IdentityProvider::PROFILE_TARGETS
+ collect(app(ProfileFields::class)->options())->mapWithKeys(fn ($label, $key) => ['custom.'.$key => $label.' (Profilfeld)'])->all();
}
public static function syncStatus(?IdentityProvider $record): HtmlString
{
if (! $record) {
return new HtmlString('');
}
$status = app(EntraDirectorySync::class)->status($record);
$when = fn (?int $ts) => $ts ? Carbon::createFromTimestamp($ts)->locale('de')->diffForHumans() : 'noch nie';
return new HtmlString(
'Letzter Lauf: '.e($when($status['last_run_at'] ?? null))
.' · Benutzer vollständig abgeglichen: '.e($when($status['users_synced_at'] ?? null))
.' · Gruppen: '.e($when($status['groups_synced_at'] ?? null))
.(! empty($status['last_error']) ? '<br><span style="color: rgb(220 38 38)">Fehler: '.e($status['last_error']).'</span>' : '')
);
}
public static function table(Table $table): Table
{
return $table
->columns([
TextColumn::make('name')->label('Bezeichnung')->weight('medium'),
TextColumn::make('type')->label('Typ')->formatStateUsing(fn () => 'Microsoft Entra ID'),
IconColumn::make('enabled')->label('Aktiv')->boolean(),
TextColumn::make('mappings_count')->label('Zuordnungen')->counts('mappings'),
TextColumn::make('identities_count')->label('Verknüpfte Konten')->counts('identities'),
])
->recordActions([
Action::make('test')->label('Mapping testen')->icon(Heroicon::OutlinedBeaker)
->url(fn (IdentityProvider $record) => static::getUrl('test', ['record' => $record])),
EditAction::make(),
]);
}
public static function getPages(): array
{
return [
'index' => ListIdentityProviders::route('/'),
'create' => CreateIdentityProvider::route('/neu'),
'edit' => EditIdentityProvider::route('/{record}/bearbeiten'),
'test' => TestMapping::route('/{record}/testen'),
];
}
}

View file

@ -0,0 +1,30 @@
<?php
namespace App\Filament\Resources\IdentityProviders\Pages;
use App\Filament\Resources\IdentityProviders\IdentityProviderResource;
use App\Models\IdentityProvider;
use App\Support\Audit;
use Filament\Resources\Pages\CreateRecord;
class CreateIdentityProvider extends CreateRecord
{
protected static string $resource = IdentityProviderResource::class;
protected function mutateFormDataBeforeCreate(array $data): array
{
$data['type'] = IdentityProvider::ENTRA;
return $data;
}
protected function afterCreate(): void
{
Audit::log('identity.provider_created', ['provider' => $this->record->name]);
}
protected function getRedirectUrl(): string
{
return IdentityProviderResource::getUrl('edit', ['record' => $this->record]);
}
}

View file

@ -0,0 +1,63 @@
<?php
namespace App\Filament\Resources\IdentityProviders\Pages;
use App\Filament\Resources\IdentityProviders\IdentityProviderResource;
use App\Support\Audit;
use Filament\Actions\Action;
use Filament\Actions\DeleteAction;
use Filament\Resources\Pages\EditRecord;
use Filament\Support\Icons\Heroicon;
class EditIdentityProvider extends EditRecord
{
protected static string $resource = IdentityProviderResource::class;
/**
* Das Geheimnis nie ins Formular (und damit in den Browser) schreiben.
*/
protected function mutateFormDataBeforeFill(array $data): array
{
$data['config']['client_secret'] = null;
// Ältere Konfiguration (feste Feldliste) als Zuordnung anzeigen.
if (! is_array($data['config']['attribute_map'] ?? null)) {
$data['config']['attribute_map'] = collect($this->record->attributeMap())
->map(fn ($attribute, $target) => ['target' => $target, 'attribute' => $attribute])->values()->all();
$data['config']['sync_manager'] = $this->record->syncsManager();
}
return $data;
}
/**
* Leeres Geheimnis = gespeichertes behalten.
*/
protected function mutateFormDataBeforeSave(array $data): array
{
if (blank($data['config']['client_secret'] ?? null)) {
$data['config']['client_secret'] = $this->record->setting('client_secret');
}
// Geladene Erweiterungen liegen nur in der Datenbank, nicht im Formular.
$data['config']['extension_properties'] = $this->record->fresh()?->setting('extension_properties', []) ?? [];
$data['config']['attribute_map'] = array_values((array) ($data['config']['attribute_map'] ?? []));
unset($data['config']['synced_fields']);
return $data;
}
protected function afterSave(): void
{
Audit::log('identity.provider_updated', ['provider' => $this->record->name, 'enabled' => $this->record->enabled]);
}
protected function getHeaderActions(): array
{
return [
Action::make('test')->label('Mapping testen')->icon(Heroicon::OutlinedBeaker)->color('gray')
->url(fn () => IdentityProviderResource::getUrl('test', ['record' => $this->record])),
DeleteAction::make()->modalDescription('Verknüpfungen und Rollen aus Entra-Gruppen werden entfernt. Die Konten selbst bleiben bestehen.'),
];
}
}

View file

@ -0,0 +1,17 @@
<?php
namespace App\Filament\Resources\IdentityProviders\Pages;
use App\Filament\Resources\IdentityProviders\IdentityProviderResource;
use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ListRecords;
class ListIdentityProviders extends ListRecords
{
protected static string $resource = IdentityProviderResource::class;
protected function getHeaderActions(): array
{
return [CreateAction::make()->label('Microsoft Entra ID anbinden')];
}
}

View file

@ -0,0 +1,49 @@
<?php
namespace App\Filament\Resources\IdentityProviders\Pages;
use App\Filament\Resources\IdentityProviders\IdentityProviderResource;
use App\Identity\Entra\MappingTester;
use Filament\Resources\Pages\Concerns\InteractsWithRecord;
use Filament\Resources\Pages\Page;
use Throwable;
/**
* „Mapping testen“: zeigt für eine Person, welche Gruppen und App-Rollen Entra
* liefert und welche Rollen im Portal daraus entstehen.
*/
class TestMapping extends Page
{
use InteractsWithRecord;
protected static string $resource = IdentityProviderResource::class;
protected string $view = 'filament.pages.identity-test-mapping';
protected static ?string $title = 'Mapping testen';
public string $person = '';
/** @var array<string, mixed>|null */
public ?array $result = null;
public ?string $error = null;
public function mount(int|string $record): void
{
$this->record = $this->resolveRecord($record);
}
public function test(MappingTester $tester): void
{
$this->validate(['person' => ['required', 'string', 'max:255']], attributes: ['person' => 'E-Mail-Adresse']);
$this->result = null;
$this->error = null;
try {
$this->result = $tester->test($this->record, trim($this->person));
} catch (Throwable $e) {
$this->error = $e->getMessage();
}
}
}

View file

@ -1,19 +0,0 @@
<?php
namespace App\Filament\Resources\NewsPosts\Pages;
use App\Filament\Resources\NewsPosts\NewsPostResource;
use Filament\Actions\DeleteAction;
use Filament\Resources\Pages\EditRecord;
class EditNewsPost extends EditRecord
{
protected static string $resource = NewsPostResource::class;
protected function getHeaderActions(): array
{
return [
DeleteAction::make(),
];
}
}

View file

@ -0,0 +1,19 @@
<?php
namespace App\Filament\Resources\ProfileFields\Pages;
use App\Filament\Resources\ProfileFields\ProfileFieldResource;
use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ManageRecords;
class ManageProfileFields extends ManageRecords
{
protected static string $resource = ProfileFieldResource::class;
protected function getHeaderActions(): array
{
return [
CreateAction::make()->label('Profilfeld anlegen'),
];
}
}

View file

@ -0,0 +1,96 @@
<?php
namespace App\Filament\Resources\ProfileFields;
use App\Filament\Resources\ProfileFields\Pages\ManageProfileFields;
use App\Models\ProfileField;
use BackedEnum;
use Filament\Actions\DeleteAction;
use Filament\Actions\EditAction;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use UnitEnum;
/**
* Frei definierbare Profilfelder – etwa Personalnummer, Kostenstelle, Eintrittsdatum.
* Können von den Personen selbst gepflegt oder aus Entra ID übernommen werden.
*/
class ProfileFieldResource extends Resource
{
protected static ?string $model = ProfileField::class;
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedIdentification;
protected static string|UnitEnum|null $navigationGroup = 'Benutzer & Rechte';
protected static ?int $navigationSort = 3;
protected static ?string $modelLabel = 'Profilfeld';
protected static ?string $pluralModelLabel = 'Profilfelder';
protected static ?string $slug = 'profilfelder';
public static function canAccess(): bool
{
return auth()->user()?->can('users.manage') ?? false;
}
public static function form(Schema $schema): Schema
{
return $schema
->columns(2)
->components([
TextInput::make('label')->label('Bezeichnung')->required()->maxLength(100),
TextInput::make('key')->label('Technischer Schlüssel')
->helperText('Wird aus der Bezeichnung erzeugt, wenn leer. Nachträglich nicht änderbar.')
->regex('/^[a-z][a-z0-9_]*$/')
->validationMessages(['regex' => 'Nur Kleinbuchstaben, Ziffern und Unterstriche, beginnend mit einem Buchstaben.'])
->maxLength(60)
->unique(ignoreRecord: true)
->disabledOn('edit'),
Select::make('type')->label('Typ')->options(ProfileField::TYPES)->default('text')->required()->native(false),
Select::make('visibility')->label('Sichtbarkeit')->options(ProfileField::VISIBILITIES)->default('public')->required()->native(false),
Toggle::make('editable')->label('Von der Person selbst pflegbar')->default(true)
->helperText('Aus Entra ID übernommene Felder sind unabhängig davon schreibgeschützt.'),
TextInput::make('sort')->label('Reihenfolge')->numeric()->default(0)->minValue(0),
TextInput::make('help')->label('Hinweis im Profilformular')->maxLength(255)->columnSpanFull(),
]);
}
public static function table(Table $table): Table
{
return $table
->defaultSort('sort')
->reorderable('sort')
->columns([
TextColumn::make('label')->label('Bezeichnung')->weight('medium'),
TextColumn::make('key')->label('Schlüssel')->fontFamily('mono')->color('gray'),
TextColumn::make('type')->label('Typ')->formatStateUsing(fn (string $state) => ProfileField::TYPES[$state] ?? $state),
TextColumn::make('visibility')->label('Sichtbarkeit')->badge()
->formatStateUsing(fn (string $state) => $state === 'public' ? 'Alle' : 'Eingeschränkt')
->color(fn (string $state) => $state === 'public' ? 'gray' : 'warning'),
IconColumn::make('editable')->label('Selbst pflegbar')->boolean(),
])
->recordActions([
EditAction::make(),
DeleteAction::make()->modalDescription('Die gespeicherten Werte bleiben erhalten, werden aber nicht mehr angezeigt.'),
])
->emptyStateHeading('Noch keine Profilfelder')
->emptyStateDescription('Zum Beispiel Personalnummer, Kostenstelle oder Eintrittsdatum – selbst gepflegt oder aus Entra ID übernommen.');
}
public static function getPages(): array
{
return [
'index' => ManageProfileFields::route('/'),
];
}
}

View file

@ -0,0 +1,17 @@
<?php
namespace App\Filament\Resources\Roles\Pages;
use App\Filament\Resources\Roles\RoleResource;
use App\Support\Audit;
use Filament\Resources\Pages\CreateRecord;
class CreateRole extends CreateRecord
{
protected static string $resource = RoleResource::class;
protected function afterCreate(): void
{
Audit::log('role.created', ['role' => $this->record->name]);
}
}

View file

@ -0,0 +1,30 @@
<?php
namespace App\Filament\Resources\Roles\Pages;
use App\Filament\Resources\Roles\RoleResource;
use App\Support\Audit;
use App\Support\Permissions\Permissions;
use Filament\Actions\DeleteAction;
use Filament\Resources\Pages\EditRecord;
class EditRole extends EditRecord
{
protected static string $resource = RoleResource::class;
protected function afterSave(): void
{
Permissions::flush();
Audit::log('role.updated', [
'role' => $this->record->name,
'grants' => $this->record->grants()->get(['ability', 'resource_type', 'resource_id'])->toArray(),
]);
}
protected function getHeaderActions(): array
{
return [
DeleteAction::make()->visible(fn () => ! $this->record->is_system),
];
}
}

View file

@ -0,0 +1,22 @@
<?php
namespace App\Filament\Resources\Roles\Pages;
use App\Filament\Pages\PermissionChecker;
use App\Filament\Resources\Roles\RoleResource;
use Filament\Actions\Action;
use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ListRecords;
class ListRoles extends ListRecords
{
protected static string $resource = RoleResource::class;
protected function getHeaderActions(): array
{
return [
Action::make('checker')->label('Rechte prüfen')->color('gray')->url(PermissionChecker::getUrl()),
CreateAction::make()->label('Neue Rolle'),
];
}
}

View file

@ -0,0 +1,217 @@
<?php
namespace App\Filament\Resources\Roles;
use App\Filament\Resources\Roles\Pages\CreateRole;
use App\Filament\Resources\Roles\Pages\EditRole;
use App\Filament\Resources\Roles\Pages\ListRoles;
use App\Models\Grant;
use App\Models\Role;
use App\Models\User;
use App\Support\Abilities;
use App\Support\Permissions\Permissions;
use BackedEnum;
use Filament\Actions\DeleteAction;
use Filament\Actions\EditAction;
use Filament\Forms\Components\CheckboxList;
use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Resources\Resource;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Components\Utilities\Get;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use UnitEnum;
class RoleResource extends Resource
{
protected static ?string $model = Role::class;
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedShieldCheck;
protected static string|UnitEnum|null $navigationGroup = 'Benutzer & Rechte';
protected static ?string $modelLabel = 'Rolle';
protected static ?string $pluralModelLabel = 'Rollen';
protected static ?string $slug = 'rollen';
protected static ?int $navigationSort = 2;
protected static ?string $recordTitleAttribute = 'name';
public static function form(Schema $schema): Schema
{
$abilities = app(Abilities::class);
return $schema
->columns(1)
->components([
Section::make('Rolle')
->columns(2)
->schema([
TextInput::make('name')->label('Name')->required()->maxLength(100)->disabled(fn (?Role $record) => $record?->is_system),
Textarea::make('description')->label('Beschreibung')->rows(2)->maxLength(500),
]),
Section::make('Globale Rechte')
->description('Gelten im ganzen Portal.')
->visible(fn (?Role $record) => ! $record?->isAdministration())
->schema([
CheckboxList::make('global_abilities')
->hiddenLabel()
->columns(2)
->options(fn () => collect($abilities->global())->map(fn (array $a) => $a['label'])->all())
->descriptions(fn () => collect($abilities->global())->map(fn (array $a) => $a['group'])->all())
->bulkToggleable()
->afterStateHydrated(fn (CheckboxList $component, ?Role $record) => $component->state(
$record?->grants()->whereNull('resource_type')->pluck('ability')->all() ?? []
))
->saveRelationshipsUsing(function (Role $record, ?array $state) {
$record->grants()->whereNull('resource_type')->where('ability', '!=', '*')->delete();
foreach (array_unique($state ?? []) as $ability) {
$record->grants()->create(['ability' => $ability]);
}
})
->dehydrated(false),
]),
Section::make('Rechte für einzelne Objekte')
->description('Zum Beispiel: Beiträge schreiben nur in der Kategorie „MAV-Info“.')
->visible(fn (?Role $record) => ! $record?->isAdministration() && $abilities->resourceTypes() !== [])
->schema([
Repeater::make('object_grants')
->hiddenLabel()
->columns(3)
->addActionLabel('Recht hinzufügen')
->defaultItems(0)
->schema([
Select::make('ability')
->label('Recht')
->required()
->live()
->options(fn () => collect($abilities->all())
->filter(fn (array $a) => $a['resource'] !== null)
->map(fn (array $a) => $a['group'].': '.$a['label'])
->all()),
Select::make('resource_ids')
->label('Für')
->multiple()
->required()
->options(function (Get $get) use ($abilities) {
$type = $abilities->all()[$get('ability')]['resource'] ?? null;
$options = $type ? ($abilities->resourceTypes()[$type]['options'])() : [];
return ['*' => 'Alle'] + $options;
}),
Toggle::make('include_children')
->label('Inkl. Unterseiten')
->inline(false)
->default(true)
->visible(fn (Get $get) => $abilities->isHierarchical($abilities->all()[$get('ability')]['resource'] ?? null)),
])
->afterStateHydrated(fn (Repeater $component, ?Role $record) => $component->state(
$record?->grants()->whereNotNull('resource_type')->get()
->groupBy(fn (Grant $g) => $g->ability.'|'.(int) $g->include_children)
->map(fn ($grants) => [
'ability' => $grants->first()->ability,
'resource_ids' => $grants->map(fn (Grant $g) => $g->resource_id === null ? '*' : (string) $g->resource_id)->values()->all(),
'include_children' => (bool) $grants->first()->include_children,
])->values()->all() ?? []
))
->saveRelationshipsUsing(function (Role $record, ?array $state) use ($abilities) {
$record->grants()->whereNotNull('resource_type')->delete();
foreach ($state ?? [] as $item) {
$type = $abilities->all()[$item['ability'] ?? '']['resource'] ?? null;
if (! $type) {
continue;
}
$ids = in_array('*', (array) $item['resource_ids'], true) ? [null] : array_map('intval', (array) $item['resource_ids']);
$inherit = $abilities->isHierarchical($type) && ($item['include_children'] ?? false);
foreach (array_unique($ids) as $id) {
$record->grants()->create(['ability' => $item['ability'], 'resource_type' => $type, 'resource_id' => $id, 'include_children' => $inherit && $id !== null]);
}
}
})
->dehydrated(false),
]),
Section::make('Mitglieder')
->description('Manuell zugewiesene Personen. Personen aus Identity-Provider-Gruppen kommen automatisch dazu.')
->schema([
Select::make('members')
->hiddenLabel()
->multiple()
->searchable()
->getSearchResultsUsing(fn (string $search) => User::query()
->where(fn ($q) => $q->where('name', 'like', "%{$search}%")->orWhere('email', 'like', "%{$search}%"))
->orderBy('name')->limit(50)->pluck('name', 'id')->all())
->getOptionLabelsUsing(fn (array $values) => User::query()->whereIn('id', $values)->pluck('name', 'id')->all())
->afterStateHydrated(fn (Select $component, ?Role $record) => $component->state(
$record?->users()->wherePivot('source', 'manual')->pluck('users.id')->all() ?? []
))
->rule(fn (?Role $record) => function (string $attribute, mixed $value, \Closure $fail) use ($record) {
if ($record?->isAdministration() && ! in_array(auth()->id(), array_map('intval', (array) $value), true)) {
$fail('Sie können sich nicht selbst aus der Rolle „Administration“ entfernen.');
}
})
->saveRelationshipsUsing(function (Role $record, ?array $state) {
$ids = array_map('intval', $state ?? []);
$current = $record->users()->wherePivot('source', 'manual')->pluck('users.id')->all();
foreach (array_diff($current, $ids) as $userId) {
$record->users()->wherePivot('source', 'manual')->detach($userId);
}
foreach (array_diff($ids, $current) as $userId) {
$record->users()->attach($userId, ['source' => 'manual', 'created_at' => now()]);
}
Permissions::flush();
})
->dehydrated(false),
]),
]);
}
public static function table(Table $table): Table
{
return $table
->defaultSort('name')
->modifyQueryUsing(fn ($query) => $query->withCount(['users', 'grants']))
->columns([
TextColumn::make('name')->label('Name')->searchable()->weight('medium')
->description(fn (Role $record) => $record->description),
IconColumn::make('is_system')->label('System')->boolean()->trueIcon(Heroicon::LockClosed)->falseIcon(false),
TextColumn::make('users_count')->label('Mitglieder'),
TextColumn::make('grants_count')->label('Rechte')
->formatStateUsing(fn (Role $record, $state) => $record->isAdministration() ? 'alle' : $state),
])
->recordActions([
EditAction::make(),
DeleteAction::make()->visible(fn (Role $record) => ! $record->is_system),
]);
}
public static function getPages(): array
{
return [
'index' => ListRoles::route('/'),
'create' => CreateRole::route('/neu'),
'edit' => EditRole::route('/{record}/bearbeiten'),
];
}
}

View file

@ -2,10 +2,16 @@
namespace App\Filament\Resources\Users\Schemas;
use App\Models\ProfileField;
use App\Models\Role;
use App\Models\User;
use App\Support\ProfileFields;
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Schemas\Components\Component;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Schema;
use Illuminate\Validation\Rules\Password;
@ -14,6 +20,30 @@ class UserForm
{
public const PHONE_REGEX = '/^[0-9+()\/\-.\s]{3,50}$/';
/**
* Eingabefelder für die frei definierten Profilfelder.
*
* @return list<Component>
*/
private static function customFields(): array
{
return app(ProfileFields::class)->all()->map(function (ProfileField $field) {
$name = 'custom_fields.'.$field->key;
$hint = $field->visibility === 'restricted' ? 'Nur für die Person und die Personalverwaltung sichtbar.' : null;
$component = match ($field->type) {
'textarea' => Textarea::make($name)->rows(3)->maxLength(5000)->columnSpanFull(),
'date' => DatePicker::make($name)->native(false)->displayFormat('d.m.Y'),
'email' => TextInput::make($name)->email()->maxLength(255),
'url' => TextInput::make($name)->url()->maxLength(500),
'phone' => TextInput::make($name)->tel()->telRegex(self::PHONE_REGEX)->maxLength(50),
default => TextInput::make($name)->maxLength(255),
};
return $component->label($field->label)->helperText($hint);
})->values()->all();
}
public static function configure(Schema $schema): Schema
{
return $schema
@ -47,10 +77,26 @@ class UserForm
->label('Aktiv')
->helperText('Deaktivierte Konten können sich nicht anmelden und erscheinen nicht im Portal.')
->default(true),
Toggle::make('is_admin')
->label('Administrator')
->helperText('Zugriff auf diesen Admin-Bereich. Wird später durch Rollen ersetzt.')
->disabled(fn (?User $record) => $record?->is(auth()->user()) ?? false),
Select::make('manual_roles')
->label('Rollen')
->helperText('Rollen sind additiv. Rollen aus Identity-Provider-Gruppen werden automatisch vergeben.')
->multiple()
->preload()
->options(fn () => Role::query()->orderByDesc('is_system')->orderBy('name')->pluck('name', 'id')->all())
->afterStateHydrated(function (Select $component, ?User $record) {
$component->state($record?->roles()->wherePivot('source', 'manual')->pluck('roles.id')->all() ?? []);
})
->rule(function (?User $record) {
// Die eigene Administrationsrolle kann man sich nicht selbst entziehen.
return function (string $attribute, mixed $value, \Closure $fail) use ($record) {
if ($record?->is(auth()->user()) && $record->hasRole(Role::ADMINISTRATION)
&& ! in_array(Role::administration()->id, array_map('intval', (array) $value), true)) {
$fail('Die eigene Rolle „Administration“ kann nicht entfernt werden.');
}
};
})
->saveRelationshipsUsing(fn (User $record, ?array $state) => $record->syncManualRoles(array_map('intval', $state ?? [])))
->dehydrated(false),
TextInput::make('password')
->label(fn (string $operation) => $operation === 'create' ? 'Passwort' : 'Neues Passwort')
->helperText(fn (string $operation) => $operation === 'create'
@ -61,6 +107,11 @@ class UserForm
->rule(Password::default())
->dehydrated(fn (?string $state) => filled($state)),
]),
Section::make('Weitere Angaben')
->columnSpan(2)
->columns(2)
->schema(fn () => self::customFields())
->visible(fn () => app(ProfileFields::class)->all()->isNotEmpty()),
]);
}
}

View file

@ -28,7 +28,7 @@ class UsersTable
TextColumn::make('job_title')->label('Funktion')->toggleable(),
TextColumn::make('department')->label('Abteilung')->sortable()->toggleable(),
TextColumn::make('location')->label('Standort')->sortable()->toggleable(isToggledHiddenByDefault: true),
IconColumn::make('is_admin')->label('Admin')->boolean(),
TextColumn::make('roles.name')->label('Rollen')->badge()->color('gray'),
IconColumn::make('is_active')->label('Aktiv')->boolean(),
TextColumn::make('last_login_at')
->label('Letzte Anmeldung')
@ -38,7 +38,7 @@ class UsersTable
])
->filters([
TernaryFilter::make('is_active')->label('Aktiv'),
TernaryFilter::make('is_admin')->label('Administrator'),
SelectFilter::make('roles')->label('Rolle')->relationship('roles', 'name'),
SelectFilter::make('department')
->label('Abteilung')
->options(fn () => User::query()->whereNotNull('department')->distinct()->orderBy('department')->pluck('department', 'department')->all()),

View file

@ -13,6 +13,7 @@ use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Table;
use Illuminate\Database\Eloquent\Builder;
class UserResource extends Resource
{
@ -20,6 +21,10 @@ class UserResource extends Resource
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedUsers;
protected static string|\UnitEnum|null $navigationGroup = 'Benutzer & Rechte';
protected static ?int $navigationSort = 1;
protected static ?string $modelLabel = 'Benutzer';
protected static ?string $pluralModelLabel = 'Benutzer';
@ -28,6 +33,11 @@ class UserResource extends Resource
protected static ?string $recordTitleAttribute = 'name';
public static function getEloquentQuery(): Builder
{
return parent::getEloquentQuery()->with('roles');
}
public static function form(Schema $schema): Schema
{
return UserForm::configure($schema);

View file

@ -0,0 +1,97 @@
<?php
namespace App\Http\Controllers\Admin;
use App\Http\Controllers\Controller;
use App\Support\Audit;
use App\Support\License\ServerError;
use App\Support\License\ServerMessages;
use App\Support\Update\Channels;
use App\Support\Update\Migrations;
use App\Support\Update\UpdateCheck;
use App\Support\Update\UpdateProgress;
use App\Support\Update\Updater;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
use Throwable;
/**
* Endpunkte der Seite „Aktualisierung“ – nur für Administratoren, CSRF-geschützt.
*/
class UpdateController extends Controller
{
public function check(Request $request, UpdateCheck $check): JsonResponse
{
try {
return response()->json(['ok' => true, 'result' => $check->run()]);
} catch (ServerError $e) {
return $this->serverError($e);
}
}
public function install(Request $request, Updater $updater, UpdateProgress $progress): JsonResponse
{
if ($progress->isRunning()) {
return response()->json(['ok' => false, 'message' => 'Es läuft bereits eine Aktualisierung.'], 409);
}
// Der Ablauf läuft serverseitig zu Ende, auch wenn der Browser die Verbindung trennt.
@set_time_limit(0);
@ignore_user_abort(true);
try {
$result = $updater->installUpdate($request->user()?->id);
return response()->json(['ok' => true, 'result' => $result]);
} catch (ServerError $e) {
return $this->serverError($e);
} catch (Throwable $e) {
return response()->json(['ok' => false, 'message' => $e->getMessage()], 500);
}
}
public function progress(UpdateProgress $progress): JsonResponse
{
return response()->json($progress->get());
}
public function channel(Request $request, Channels $channels): JsonResponse
{
$validated = $request->validate([
'channel' => ['required', 'string', Rule::in(array_keys($channels->all()))],
]);
$channels->setActive($validated['channel']);
Audit::log('update.channel_changed', ['channel' => $validated['channel']]);
return response()->json(['ok' => true, 'channel' => $validated['channel']]);
}
public function migrations(Migrations $migrations): JsonResponse
{
@set_time_limit(0);
try {
$count = $migrations->run();
@file_put_contents(storage_path('.migrations-fingerprint'), $migrations->fingerprint());
Audit::log('update.migrations', ['migrations' => $count]);
return response()->json(['ok' => true, 'count' => $count, 'status' => $migrations->status()]);
} catch (Throwable $e) {
Audit::log('update.migrations_failed', ['error' => $e->getMessage()]);
return response()->json(['ok' => false, 'message' => 'Migrationen fehlgeschlagen: '.$e->getMessage()], 500);
}
}
private function serverError(ServerError $e): JsonResponse
{
return response()->json([
'ok' => false,
'code' => $e->errorCode,
'message' => ServerMessages::for($e),
'license_input' => $e->needsLicenseInput(),
], 200);
}
}

View file

@ -0,0 +1,86 @@
<?php
namespace App\Http\Controllers;
use App\Models\IdentityProvider;
use App\Pagebuilder\Content;
use App\Support\Branding;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
/**
* Web-App-Manifest und die Vorschauseiten für „Erscheinungsbild“.
*/
class AppearanceController extends Controller
{
public function manifest(Branding $branding): JsonResponse
{
$icons = collect($branding->get('icons') ?? [])
->reject(fn ($path, $size) => (int) $size < 192)
->map(fn ($path, $size) => ['src' => $branding->url($path), 'sizes' => "{$size}x{$size}", 'type' => 'image/png', 'purpose' => 'any'])
->values();
if ($icons->isEmpty()) {
$icons = collect([['src' => $branding->faviconUrl(), 'sizes' => 'any', 'type' => 'image/svg+xml']]);
}
return response()->json([
'name' => $branding->portalName(),
'short_name' => mb_substr($branding->portalName(), 0, 12),
'start_url' => '/',
'scope' => '/',
'display' => 'standalone',
'lang' => 'de',
'theme_color' => $branding->primaryColor(),
'background_color' => '#F4F5F7',
'icons' => $icons->all(),
], 200, ['Content-Type' => 'application/manifest+json', 'Cache-Control' => 'public, max-age=3600']);
}
/**
* Anmeldeseite im aktuellen Entwurf – für die Vorschau (Formular ohne Funktion).
*/
public function loginPreview(Request $request): Response
{
return Inertia::render('Auth/Login', [
'canResetPassword' => true,
'providers' => IdentityProvider::query()->where('enabled', true)->get()
->map(fn (IdentityProvider $p) => ['slug' => $p->slug, 'type' => $p->type, 'label' => $p->buttonLabel()])->values(),
'preview' => true,
]);
}
/**
* Beispielseite mit Boxen, Tabs, Akkordeon, Tabelle und Schaltflächen.
*/
public function sample(Request $request, Content $content): Response
{
$text = fn (string $html) => ['type' => 'text', 'data' => ['html' => $html]];
$box = fn (string $variant, string $title, string $html) => ['type' => 'box', 'data' => ['variant' => $variant, 'title' => $title, 'show_icon' => true], 'items' => [['blocks' => [$text($html)]]]];
$blocks = [
['type' => 'heading', 'data' => ['text' => 'Überschrift der Seite', 'level' => '2']],
$text('<p>Fließtext mit einem <a href="#">Link in der Akzentfarbe</a>, <strong>Hervorhebungen</strong> und einer Liste:</p><ul><li>erster Punkt</li><li>zweiter Punkt</li></ul>'),
['type' => 'columns', 'data' => ['layout' => '1-1'], 'items' => [
['blocks' => [$box('info', 'Info', '<p>Sprechstunde dienstags 14–16 Uhr.</p>'), $box('warning', 'Warnung', '<p>Bitte bis Freitag einreichen.</p>')]],
['blocks' => [$box('success', 'Erfolg', '<p>Das neue Verfahren gilt ab sofort.</p>'), $box('highlight', 'Hervorgehoben', '<p>In der Markenfarbe.</p>')]],
]],
['type' => 'tabs', 'items' => [
['title' => 'Erster Tab', 'blocks' => [$text('<p>Inhalt des ersten Tabs.</p>')]],
['title' => 'Zweiter Tab', 'blocks' => [$text('<p>Inhalt des zweiten Tabs.</p>')]],
]],
['type' => 'accordion', 'data' => ['first_open' => true], 'items' => [
['title' => 'Häufige Frage', 'blocks' => [$text('<p>Die Antwort steht hier.</p>')]],
['title' => 'Noch eine Frage', 'blocks' => [$text('<p>Noch eine Antwort.</p>')]],
]],
['type' => 'table', 'data' => ['header' => true, 'rows' => [['Bereich', 'Ansprechpartner', 'Durchwahl'], ['Personal', 'A. Beispiel', '123'], ['IT', 'B. Muster', '456']]]],
['type' => 'buttons', 'data' => ['buttons' => [['label' => 'Primäre Schaltfläche', 'url' => '#', 'variant' => 'primary'], ['label' => 'Umrandet', 'url' => '#', 'variant' => 'outline']]]],
];
return Inertia::render('Appearance/Sample', [
'content' => $content->render($content->sanitize(['blocks' => $blocks]), $request->user()),
]);
}
}

View file

@ -0,0 +1,83 @@
<?php
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use App\Identity\Entra\EntraLogin;
use App\Identity\IdentityException;
use App\Models\IdentityProvider;
use App\Support\Audit;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Log;
use Symfony\Component\HttpFoundation\Response;
use Throwable;
/**
* „Mit Microsoft anmelden“ – Weiterleitung und Rückkehr.
*/
class IdentityLoginController extends Controller
{
public function redirect(IdentityProvider $provider, EntraLogin $login, Request $request): Response
{
abort_unless($provider->enabled && $provider->type === IdentityProvider::ENTRA, 404);
$start = $login->start($provider, $this->callbackUrl($provider));
$request->session()->put('identity_login', $start['session']);
return redirect()->away($start['url']);
}
public function callback(IdentityProvider $provider, EntraLogin $login, Request $request): RedirectResponse
{
abort_unless($provider->enabled && $provider->type === IdentityProvider::ENTRA, 404);
$session = $request->session()->pull('identity_login');
if ($request->filled('error')) {
// z. B. Abbruch durch die Person oder fehlende Zustimmung in Entra
Log::notice('Entra-Anmeldung abgebrochen: '.$request->string('error').' '.$request->string('error_description'));
return $this->fail($request->string('error')->toString() === 'access_denied'
? 'Die Anmeldung wurde abgebrochen.'
: 'Microsoft hat die Anmeldung abgelehnt. Bitte wenden Sie sich an die Administration.');
}
if (! is_array($session) || ! hash_equals($session['state'] ?? '', (string) $request->query('state')) || ($session['provider'] ?? null) !== (string) $provider->id) {
return $this->fail('Die Anmeldung ist abgelaufen. Bitte erneut versuchen.');
}
try {
$user = $login->complete($provider, (string) $request->query('code'), $this->callbackUrl($provider), $session);
} catch (IdentityException $e) {
return $this->fail($e->getMessage());
} catch (Throwable $e) {
report($e);
return $this->fail('Die Anmeldung über Microsoft ist fehlgeschlagen. Bitte später erneut versuchen.');
}
Auth::login($user, remember: true);
$request->session()->regenerate();
$user->forceFill(['last_login_at' => now()])->saveQuietly();
Audit::log('identity.login', ['provider' => $provider->name], $user->id);
return redirect()->intended('/');
}
public static function callbackUrlFor(IdentityProvider $provider): string
{
return url('/auth/'.$provider->slug.'/callback');
}
private function callbackUrl(IdentityProvider $provider): string
{
return self::callbackUrlFor($provider);
}
private function fail(string $message): RedirectResponse
{
return redirect('/login')->with('identity_error', $message);
}
}

View file

@ -0,0 +1,23 @@
<?php
namespace App\Http\Controllers;
use App\Support\BackgroundTasks;
use Illuminate\Http\Response;
/**
* Web-Cron für Hoster ohne Cron: ein externer Dienst ruft minütlich
* /cron/{token} auf.
*/
class CronController extends Controller
{
public function __invoke(string $token, BackgroundTasks $tasks): Response
{
abort_unless(hash_equals($tasks->webCronToken(), $token), 404);
@ignore_user_abort(true);
$tasks->run('webcron');
return response()->noContent();
}
}

View file

@ -2,59 +2,17 @@
namespace App\Http\Controllers;
use App\Http\Resources\EventResource;
use App\Http\Resources\NewsPostResource;
use App\Http\Resources\PersonResource;
use App\Models\Event;
use App\Models\NewsPost;
use App\Models\User;
use App\Support\QuickLinks;
use App\Dashboard\Widgets;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class DashboardController extends Controller
{
public function __invoke(Request $request, QuickLinks $quickLinks): Response
public function __invoke(Request $request, Widgets $widgets): Response
{
$user = $request->user();
// Hervorgehobene Beiträge für den Slider; ohne Hervorhebung die neuesten mit Bild.
$featured = NewsPost::query()->published()->with('category')
->where('is_featured', true)->whereNotNull('cover_path')
->latest('published_at')->limit(5)->get();
if ($featured->isEmpty()) {
$featured = NewsPost::query()->published()->with('category')
->whereNotNull('cover_path')->latest('published_at')->limit(3)->get();
}
$recent = NewsPost::query()->published()->with('category')
->whereKeyNot($featured->modelKeys())
->latest('published_at')->limit(8)->get();
return Inertia::render('Dashboard', [
'profile' => [
'job_title' => $user->job_title,
'department' => $user->department,
'location' => $user->location,
'avatar_url' => $user->avatarUrl(256),
],
'quickLinks' => $quickLinks->all(),
'featuredNews' => NewsPostResource::collection($featured),
'latestNews' => NewsPostResource::collection($recent->take(4)->values()),
'moreNews' => NewsPostResource::collection($recent->slice(4)->values()),
'upcomingEvents' => EventResource::collection(Event::query()->upcoming()->limit(4)->get()),
'newColleagues' => PersonResource::collection(
User::query()
->active()
->whereKeyNot($user->getKey())
->where('created_at', '>=', now()->subDays(90))
->latest()
->limit(6)
->get()
),
'peopleCount' => User::query()->active()->count(),
'widgets' => $widgets->resolve($request->user(), $request),
]);
}
}

View file

@ -0,0 +1,20 @@
<?php
namespace App\Http\Controllers;
use App\Editorial\Editorial;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class EditorialController extends Controller
{
public function __invoke(Request $request, Editorial $editorial): Response
{
abort_unless($editorial->visibleFor($request->user()), 403);
return Inertia::render('Editorial/Index', [
'sections' => $editorial->resolve($request->user()),
]);
}
}

View file

@ -0,0 +1,162 @@
<?php
namespace App\Http\Controllers;
use App\Models\Role;
use App\Models\User;
use App\Support\Audit;
use App\Support\EnvFile;
use App\Support\Installation;
use App\Support\License\LicenseStore;
use App\Support\Settings;
use App\Support\SiteHealth;
use App\Support\Update\Migrations;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Validation\Rules\Password;
use Illuminate\View\View;
use PDO;
use Throwable;
/**
* Web-Installer: Systemprüfung → Datenbank → Administrator. Nur erreichbar,
* solange die Installation nicht eingerichtet ist.
*/
class InstallController extends Controller
{
public function __construct()
{
abort_if(Installation::isInstalled(), 404);
}
public function requirements(SiteHealth $health): View
{
$checks = $health->requirements();
return view('install.requirements', [
'checks' => $checks,
'canContinue' => collect($checks)->doesntContain('status', SiteHealth::ERROR) && is_file(app()->environmentFilePath()),
'envWritable' => is_file(app()->environmentFilePath()) && is_writable(app()->environmentFilePath()),
]);
}
public function database(): View
{
return view('install.database', [
'values' => [
'host' => config('database.connections.mysql.host', 'localhost'),
'port' => config('database.connections.mysql.port', 3306),
'database' => config('database.connections.mysql.database'),
'username' => config('database.connections.mysql.username'),
],
]);
}
public function saveDatabase(Request $request): RedirectResponse
{
$data = $request->validate([
'host' => ['required', 'string', 'max:255'],
'port' => ['required', 'integer', 'between:1,65535'],
'database' => ['required', 'string', 'max:64'],
'username' => ['required', 'string', 'max:255'],
'password' => ['nullable', 'string', 'max:255'],
], attributes: ['host' => 'Server', 'port' => 'Port', 'database' => 'Datenbank', 'username' => 'Benutzer', 'password' => 'Passwort']);
try {
$pdo = new PDO(
"mysql:host={$data['host']};port={$data['port']};dbname={$data['database']};charset=utf8mb4",
$data['username'],
$data['password'] ?? '',
[PDO::ATTR_TIMEOUT => 5, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION],
);
$version = (string) $pdo->query('select version()')->fetchColumn();
} catch (Throwable $e) {
return back()->withInput($request->except('password'))
->withErrors(['host' => 'Verbindung fehlgeschlagen: '.$this->pdoMessage($e->getMessage())]);
}
$mariadb = str_contains(strtolower($version), 'mariadb');
$number = preg_replace('/^(\d+\.\d+\.\d+).*$/', '$1', $version);
if (! version_compare($number, $mariadb ? '10.6.0' : '8.0.0', '>=')) {
return back()->withInput($request->except('password'))
->withErrors(['host' => ($mariadb ? 'MariaDB ' : 'MySQL ').$number.' wird nicht unterstützt. Benötigt wird MySQL ab 8.0 oder MariaDB ab 10.6.']);
}
EnvFile::set(app()->environmentFilePath(), [
'APP_URL' => $request->getSchemeAndHttpHost().$request->getBaseUrl(),
'DB_CONNECTION' => 'mysql',
'DB_HOST' => $data['host'],
'DB_PORT' => (string) $data['port'],
'DB_DATABASE' => $data['database'],
'DB_USERNAME' => $data['username'],
'DB_PASSWORD' => $data['password'] ?? '',
]);
return redirect('/install/konto');
}
public function account(): View|RedirectResponse
{
return view('install.account');
}
public function saveAccount(Request $request, Settings $settings, LicenseStore $license, Migrations $migrations): RedirectResponse
{
$data = $request->validate([
'portal_name' => ['required', 'string', 'max:60'],
'first_name' => ['required', 'string', 'max:100'],
'last_name' => ['required', 'string', 'max:100'],
'email' => ['required', 'email', 'max:255'],
'password' => ['required', 'confirmed', Password::min(10)->letters()->numbers()],
'license_email' => ['nullable', 'email', 'max:255', 'required_with:license_key'],
'license_key' => ['nullable', 'string', 'max:500', 'required_with:license_email'],
], attributes: [
'portal_name' => 'Name des Portals', 'first_name' => 'Vorname', 'last_name' => 'Nachname',
'email' => 'E-Mail-Adresse', 'password' => 'Passwort',
'license_email' => 'Lizenz-E-Mail', 'license_key' => 'Lizenzschlüssel',
]);
@set_time_limit(300);
try {
Artisan::call('migrate', ['--force' => true]);
} catch (Throwable $e) {
return back()->withInput($request->except('password', 'password_confirmation', 'license_key'))
->withErrors(['portal_name' => 'Die Datenbank konnte nicht eingerichtet werden: '.$e->getMessage()]);
}
$admin = User::query()->updateOrCreate(['email' => strtolower($data['email'])], [
'first_name' => $data['first_name'],
'last_name' => $data['last_name'],
'password' => $data['password'],
'is_active' => true,
]);
$admin->syncManualRoles([Role::administration()->id]);
$settings->set('branding.portal_name', $data['portal_name']);
if (filled($data['license_email'] ?? null)) {
$license->setLicense($data['license_email'], $data['license_key']);
}
$license->deviceId();
file_put_contents(storage_path('.migrations-fingerprint'), $migrations->fingerprint());
Installation::markInstalled();
Audit::log('install.completed', ['portal_name' => $data['portal_name']], $admin->id);
// Kein Flash: Ab jetzt liegen die Sitzungen in der Datenbank, die bisherige Sitzung ist weg.
return redirect('/login?eingerichtet=1');
}
private function pdoMessage(string $message): string
{
return match (true) {
str_contains($message, 'Access denied') => 'Benutzername oder Passwort sind falsch, oder der Benutzer hat keinen Zugriff auf diese Datenbank.',
str_contains($message, 'Unknown database') => 'Die Datenbank existiert nicht. Bitte zuerst beim Hoster anlegen.',
str_contains($message, 'getaddrinfo'), str_contains($message, 'Connection refused'), str_contains($message, 'timed out') => 'Der Datenbankserver ist nicht erreichbar. Bitte Server und Port prüfen.',
default => $message,
};
}
}

View file

@ -0,0 +1,50 @@
<?php
namespace App\Http\Controllers;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Notifications\DatabaseNotification;
use Illuminate\Support\Str;
/**
* Glocke im Portal-Header: Benachrichtigungen anzeigen und als gelesen markieren.
*/
class NotificationController extends Controller
{
public function index(Request $request): JsonResponse
{
$notifications = $request->user()->notifications()->limit(20)->get();
return response()->json([
'notifications' => $notifications->map(fn (DatabaseNotification $n) => [
'id' => $n->id,
'title' => (string) ($n->data['title'] ?? ''),
'body' => (string) ($n->data['body'] ?? ''),
'icon' => (string) ($n->data['icon'] ?? 'bell'),
'has_url' => filled($n->data['url'] ?? null),
'read' => $n->read_at !== null,
'created_at' => $n->created_at?->toIso8601String(),
]),
'unread' => $request->user()->unreadNotifications()->count(),
]);
}
public function open(Request $request, string $id): RedirectResponse
{
$notification = $request->user()->notifications()->whereKey($id)->firstOrFail();
$notification->markAsRead();
$url = (string) ($notification->data['url'] ?? '');
// Nur Adressen innerhalb des Portals ansteuern.
return redirect()->to($url !== '' && (Str::startsWith($url, '/') && ! Str::startsWith($url, '//') || Str::startsWith($url, url('/'))) ? $url : '/');
}
public function markAllRead(Request $request): JsonResponse
{
$request->user()->unreadNotifications()->update(['read_at' => now()]);
return response()->json(['unread' => 0]);
}
}

View file

@ -4,7 +4,9 @@ namespace App\Http\Controllers;
use App\Http\Resources\PersonResource;
use App\Models\User;
use App\Support\ProfileFields;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Cache;
use Inertia\Inertia;
@ -54,9 +56,34 @@ class PeopleController extends Controller
]);
}
/**
* Personenauswahl in Formularen (z. B. Block „Ansprechpartner“): Suche oder Abruf per ID.
*/
public function search(Request $request): JsonResponse
{
$data = $request->validate([
'q' => ['nullable', 'string', 'max:100'],
'ids' => ['nullable', 'array', 'max:50'],
'ids.*' => ['integer'],
]);
$search = trim($data['q'] ?? '');
$like = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\\%', '\\_'], $search).'%';
$people = User::query()->active()
->when(isset($data['ids']), fn (Builder $q) => $q->whereIn('id', $data['ids']))
->when(! isset($data['ids']), fn (Builder $q) => $q->where(fn (Builder $q) => $q->where('name', 'like', $like)->orWhere('email', 'like', $like)))
->orderBy('name')
->limit(20)
->get();
return response()->json(['people' => PersonResource::collection($people)->resolve()]);
}
public function show(User $user): Response
{
abort_unless($user->is_active, 404);
$user->load('manager');
return Inertia::render('Profile/Show', [
'person' => [
@ -70,7 +97,16 @@ class PeopleController extends Controller
'phone' => $user->phone,
'mobile' => $user->mobile,
'about' => $user->about,
'fields' => app(ProfileFields::class)->visibleValues($user, auth()->user()),
'avatar_url' => $user->avatarUrl(256),
'manager' => $user->manager?->is_active ? [
'id' => $user->manager->id,
'name' => $user->manager->name,
'initials' => $user->manager->initials,
'job_title' => $user->manager->job_title,
'avatar_url' => $user->manager->avatarUrl(96),
] : null,
'reports' => PersonResource::collection($user->reports()->active()->orderBy('name')->limit(12)->get())->resolve(),
],
'isOwnProfile' => $user->is(auth()->user()),
]);

View file

@ -4,7 +4,9 @@ namespace App\Http\Controllers;
use App\Http\Requests\UpdateProfileRequest;
use App\Models\User;
use App\Profile\ProfileSections;
use App\Support\Avatars;
use App\Support\ProfileFields;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
@ -19,9 +21,10 @@ class ProfileController extends Controller
return to_route('people.show', $request->user());
}
public function edit(Request $request): Response
public function edit(Request $request, ProfileFields $profileFields): Response
{
$user = $request->user();
$managed = $user->managedFields();
return Inertia::render('Profile/Edit', [
'profile' => [
@ -34,12 +37,22 @@ class ProfileController extends Controller
'avatar_url' => $user->avatarUrl(256),
'has_password' => $user->password !== null,
],
// Felder, die Microsoft Entra ID pflegt – im Portal nur lesbar.
'managed' => $managed,
'customFields' => $profileFields->formFor($user, $managed),
'sections' => app(ProfileSections::class)->resolve($user),
]);
}
public function update(UpdateProfileRequest $request): RedirectResponse
public function update(UpdateProfileRequest $request, ProfileFields $profileFields): RedirectResponse
{
$request->user()->update($request->validated());
$user = $request->user();
$managed = $user->managedFields();
$user->update(collect($request->validated())->except([...$managed, 'custom_fields'])->all());
if ($request->has('custom_fields')) {
$profileFields->mergeUserInput($user, (array) $request->validated('custom_fields', []), $managed);
}
return back()->with('status', 'profile-updated');
}

View file

@ -0,0 +1,35 @@
<?php
namespace App\Http\Middleware;
use App\Support\Update\MaintenanceFlag;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Während eines Updates: 503 mit Wartungsseite. Ausgenommen sind die
* Update-Endpunkte, die Seite „Aktualisierung“, die Anmeldung und der
* Health-Check – sonst könnte niemand verfolgen, wie weit das Update ist.
*/
class EnsureNotInMaintenance
{
private const EXCEPT = ['admin/update/*', 'admin/aktualisierung', 'login', 'logout', 'up'];
public function __construct(private readonly MaintenanceFlag $maintenance) {}
public function handle(Request $request, Closure $next): Response
{
if (! $this->maintenance->isActive() || $request->is(...self::EXCEPT)) {
return $next($request);
}
$retryAfter = $this->maintenance->retryAfter();
if ($request->expectsJson() || $request->header('X-Inertia')) {
return response()->json(['message' => 'Das Portal wird gerade aktualisiert.'], 503, ['Retry-After' => $retryAfter]);
}
return response()->view('maintenance', ['retryAfter' => $retryAfter], 503, ['Retry-After' => $retryAfter]);
}
}

View file

@ -35,12 +35,14 @@ class HandleInertiaRequests extends Middleware
'job_title' => $user->job_title,
'avatar_url' => $user->avatarUrl(96),
'theme' => $user->theme,
'is_admin' => $user->is_admin,
'can_admin' => $user->canAccessAdmin(),
] : null,
],
'navigation' => fn () => $user ? $this->navigation->items($request) : [],
'navigation' => fn () => $user ? $this->navigation->items($request, $user) : [],
'notifications' => fn () => $user ? ['unread' => $user->unreadNotifications()->count()] : null,
'flash' => [
'status' => fn () => $request->session()->get('status'),
'form_submitted' => fn () => $request->session()->get('form_submitted'),
],
];
}

View file

@ -0,0 +1,23 @@
<?php
namespace App\Http\Middleware;
use App\Support\Installation;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Solange nicht eingerichtet, führt jede Seite zum Web-Installer.
*/
class RedirectToInstaller
{
public function handle(Request $request, Closure $next): Response
{
if (! Installation::isInstalled() && ! $request->is('install', 'install/*', 'up')) {
return redirect('/install');
}
return $next($request);
}
}

View file

@ -0,0 +1,72 @@
<?php
namespace App\Http\Middleware;
use App\Support\Installation;
use App\Support\Update\Migrations;
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
use Symfony\Component\HttpFoundation\Response;
use Throwable;
/**
* Führt nach einem Update beim ersten Seitenaufruf ausstehende Migrationen aus –
* ohne SSH der einzige verlässliche Zeitpunkt.
*
* Migriert wird nur, wenn sich der Fingerabdruck der Migrationsdateien geändert
* hat (sonst liefe der Migrator bei jedem Request), mit einer Sperre gegen
* Parallellauf. Fehler werden protokolliert, nie geworfen.
*/
class RunPendingMigrations
{
public function __construct(private readonly Migrations $migrations) {}
public function handle(Request $request, Closure $next): Response
{
if (app()->runningUnitTests() || ! Installation::isInstalled()) {
return $next($request);
}
$stored = @file_get_contents(storage_path('.migrations-fingerprint'));
try {
$current = $this->migrations->fingerprint();
if ($stored !== $current) {
$this->migrateWithLock($current);
}
} catch (Throwable $e) {
Log::error('Automatische Migration fehlgeschlagen: '.$e->getMessage(), ['exception' => $e]);
}
return $next($request);
}
private function migrateWithLock(string $fingerprint): void
{
$lock = @fopen(storage_path('.migrate.lock'), 'c');
if ($lock === false || ! flock($lock, LOCK_EX | LOCK_NB)) {
return; // Läuft gerade in einer anderen Anfrage.
}
try {
// Nach dem Warten auf die Sperre erneut prüfen – vielleicht war jemand schneller.
if (@file_get_contents(storage_path('.migrations-fingerprint')) === $fingerprint) {
return;
}
@set_time_limit(300);
$count = $this->migrations->run();
file_put_contents(storage_path('.migrations-fingerprint'), $fingerprint);
if ($count > 0) {
Log::info("Automatische Migration: {$count} Migration(en) ausgeführt.");
}
} finally {
flock($lock, LOCK_UN);
fclose($lock);
}
}
}

View file

@ -0,0 +1,33 @@
<?php
namespace App\Http\Middleware;
use App\Support\BackgroundTasks;
use App\Support\Installation;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Pseudo-Cron: Läuft weder echter Cron noch Web-Cron, werden fällige
* Hintergrundaufgaben nach dem Ausliefern einer Seite erledigt – höchstens
* einmal pro Minute.
*/
class RunPseudoCron
{
public function __construct(private readonly BackgroundTasks $tasks) {}
public function handle(Request $request, Closure $next): Response
{
return $next($request);
}
public function terminate(Request $request, Response $response): void
{
if (app()->runningUnitTests() || ! Installation::isInstalled() || ! $this->tasks->pseudoCronDue()) {
return;
}
$this->tasks->run('pseudo');
}
}

View file

@ -0,0 +1,32 @@
<?php
namespace App\Http\Middleware;
use App\Support\Branding;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Vorschau des Entwurfs im Portal: ?vorschau=entwurf schaltet sie für die
* Sitzung ein, ?vorschau=aus wieder aus. Nur mit „Erscheinungsbild“-Recht.
*/
class ThemePreview
{
public function handle(Request $request, Closure $next): Response
{
$value = $request->query('vorschau');
if ($value !== null && $request->hasSession()) {
if ($value === 'entwurf' && $request->user()?->can('appearance.manage')) {
$request->session()->put(Branding::PREVIEW_SESSION_KEY, true);
} elseif ($value === 'aus') {
$request->session()->forget(Branding::PREVIEW_SESSION_KEY);
}
}
app(Branding::class)->refresh();
return $next($request);
}
}

View file

@ -2,6 +2,7 @@
namespace App\Http\Requests;
use App\Support\ProfileFields;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
@ -12,11 +13,13 @@ class UpdateProfileRequest extends FormRequest
*/
public function rules(): array
{
$managed = $this->user()->managedFields();
return [
'first_name' => ['required', 'string', 'max:100'],
'last_name' => ['required', 'string', 'max:100'],
'first_name' => [in_array('first_name', $managed, true) ? 'nullable' : 'required', 'string', 'max:100'],
'last_name' => [in_array('last_name', $managed, true) ? 'nullable' : 'required', 'string', 'max:100'],
'email' => [
'required', 'string', 'lowercase', 'email', 'max:255',
in_array('email', $managed, true) ? 'nullable' : 'required', 'string', 'lowercase', 'email', 'max:255',
Rule::unique('users')->ignore($this->user()->id),
],
'job_title' => ['nullable', 'string', 'max:150'],
@ -25,6 +28,8 @@ class UpdateProfileRequest extends FormRequest
'phone' => ['nullable', 'string', 'max:50'],
'mobile' => ['nullable', 'string', 'max:50'],
'about' => ['nullable', 'string', 'max:2000'],
'custom_fields' => ['nullable', 'array'],
...app(ProfileFields::class)->rules(),
];
}
@ -43,6 +48,7 @@ class UpdateProfileRequest extends FormRequest
'phone' => 'Telefon',
'mobile' => 'Mobil',
'about' => 'Über mich',
...app(ProfileFields::class)->all()->mapWithKeys(fn ($field) => ['custom_fields.'.$field->key => $field->label])->all(),
];
}
}

View file

@ -0,0 +1,141 @@
<?php
namespace App\Identity\Entra;
use App\Models\IdentityProvider;
use Illuminate\Support\Arr;
/**
* Graph-Benutzerattribute: Vorschlagsliste, Standardzuordnung, $select-Aufbau
* und das Auslesen verschachtelter Werte.
*
* Ein Attribut ist ein Pfad in der Graph-Antwort, z. B. „jobTitle“,
* „employeeOrgData.costCenter“, „onPremisesExtensionAttributes.extensionAttribute3“,
* „businessPhones.0“ oder „extension_<appId>_personalnummer“.
*/
final class EntraAttributes
{
/** Wird immer abgefragt – für Kontoanlage, Verknüpfung und Offboarding. */
public const BASE_SELECT = ['id', 'displayName', 'givenName', 'surname', 'mail', 'userPrincipalName', 'accountEnabled', 'userType'];
/** Standardzuordnung Profilfeld => Attribut (entspricht dem bisherigen Verhalten). */
public const DEFAULT_MAP = [
'first_name' => 'givenName',
'last_name' => 'surname',
'email' => 'mail',
'job_title' => 'jobTitle',
'department' => 'department',
'location' => 'officeLocation',
'phone' => 'businessPhones.0',
'mobile' => 'mobilePhone',
];
/** Häufige Attribute als Vorschläge im Formular. */
public const COMMON = [
'givenName' => 'Vorname',
'surname' => 'Nachname',
'displayName' => 'Anzeigename',
'mail' => 'E-Mail-Adresse',
'userPrincipalName' => 'Benutzerprinzipalname',
'jobTitle' => 'Position',
'department' => 'Abteilung',
'companyName' => 'Firmenname',
'officeLocation' => 'Büro',
'businessPhones.0' => 'Telefon (geschäftlich)',
'mobilePhone' => 'Mobiltelefon',
'faxNumber' => 'Fax',
'streetAddress' => 'Straße',
'postalCode' => 'Postleitzahl',
'city' => 'Ort',
'state' => 'Bundesland',
'country' => 'Land',
'usageLocation' => 'Nutzungsstandort',
'preferredLanguage' => 'Bevorzugte Sprache',
'employeeId' => 'Personalnummer',
'employeeType' => 'Mitarbeitertyp',
'employeeHireDate' => 'Eintrittsdatum',
'employeeLeaveDateTime' => 'Austrittsdatum',
'employeeOrgData.costCenter' => 'Kostenstelle',
'employeeOrgData.division' => 'Bereich',
'otherMails' => 'Weitere E-Mail-Adressen',
'proxyAddresses' => 'Proxyadressen',
'onPremisesSamAccountName' => 'Anmeldename (lokal)',
'onPremisesDistinguishedName' => 'Distinguished Name (lokal)',
'onPremisesExtensionAttributes.extensionAttribute1' => 'Erweiterungsattribut 1 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute2' => 'Erweiterungsattribut 2 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute3' => 'Erweiterungsattribut 3 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute4' => 'Erweiterungsattribut 4 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute5' => 'Erweiterungsattribut 5 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute6' => 'Erweiterungsattribut 6 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute7' => 'Erweiterungsattribut 7 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute8' => 'Erweiterungsattribut 8 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute9' => 'Erweiterungsattribut 9 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute10' => 'Erweiterungsattribut 10 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute11' => 'Erweiterungsattribut 11 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute12' => 'Erweiterungsattribut 12 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute13' => 'Erweiterungsattribut 13 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute14' => 'Erweiterungsattribut 14 (lokal)',
'onPremisesExtensionAttributes.extensionAttribute15' => 'Erweiterungsattribut 15 (lokal)',
];
/** Erlaubte Schreibweise eines Attributpfads. */
public const PATH_PATTERN = '/^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z0-9_]+)*$/';
/**
* $select für /me, /users/{id} und /users/delta.
*/
public static function select(IdentityProvider $provider): string
{
$top = array_map(fn (string $path) => self::topLevel($path), array_values($provider->attributeMap()));
return implode(',', array_values(array_unique([...self::BASE_SELECT, ...$top])));
}
public static function topLevel(string $path): string
{
return explode('.', $path, 2)[0];
}
/**
* Wert eines Attributpfads als Text. Listen werden mit Komma verbunden,
* Wahrheitswerte als „Ja“/„Nein“ ausgegeben; leere Werte ergeben null.
*
* @param array<string, mixed> $graphUser
*/
public static function value(array $graphUser, string $path): ?string
{
$value = $graphUser;
foreach (explode('.', $path) as $segment) {
if (! is_array($value) || ! array_key_exists($segment, $value)) {
return null;
}
$value = $value[$segment];
}
if (is_array($value)) {
$value = implode(', ', array_filter(Arr::flatten($value), fn ($v) => is_scalar($v) && $v !== ''));
} elseif (is_bool($value)) {
$value = $value ? 'Ja' : 'Nein';
}
$value = is_scalar($value) ? trim((string) $value) : '';
return $value === '' ? null : $value;
}
/**
* Vorschlagsliste fürs Formular: häufige Attribute plus geladene Verzeichniserweiterungen.
*
* @return array<string, string> Pfad => Beschreibung
*/
public static function suggestions(?IdentityProvider $provider): array
{
$extensions = collect((array) $provider?->setting('extension_properties', []))
->mapWithKeys(fn ($name) => [(string) $name => 'Verzeichniserweiterung'])
->all();
return self::COMMON + $extensions;
}
}

View file

@ -0,0 +1,185 @@
<?php
namespace App\Identity\Entra;
use App\Identity\IdentityException;
use App\Models\IdentityProvider;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;
/**
* Zugriff auf Microsoft Entra ID (OpenID Connect) und Microsoft Graph.
*/
class EntraClient
{
public const LOGIN_URL = 'https://login.microsoftonline.com';
public const GRAPH_URL = 'https://graph.microsoft.com/v1.0';
/** Delegierte Berechtigungen bei der Anmeldung. GroupMember.Read.All braucht Admin-Zustimmung. */
public const SCOPES = 'openid profile email offline_access User.Read GroupMember.Read.All';
public function __construct(private readonly IdentityProvider $provider) {}
public function tenant(): string
{
return (string) $this->provider->setting('tenant_id');
}
public function clientId(): string
{
return (string) $this->provider->setting('client_id');
}
public function issuer(): string
{
return self::LOGIN_URL.'/'.$this->tenant().'/v2.0';
}
/**
* @param array{state: string, nonce: string, code_challenge: string} $security
*/
public function authorizationUrl(string $redirectUri, array $security): string
{
return self::LOGIN_URL.'/'.$this->tenant().'/oauth2/v2.0/authorize?'.http_build_query([
'client_id' => $this->clientId(),
'response_type' => 'code',
'redirect_uri' => $redirectUri,
'response_mode' => 'query',
'scope' => self::SCOPES,
'state' => $security['state'],
'nonce' => $security['nonce'],
'code_challenge' => $security['code_challenge'],
'code_challenge_method' => 'S256',
'prompt' => 'select_account',
]);
}
/**
* Autorisierungscode gegen Token tauschen (mit PKCE-Verifier).
*
* @return array{id_token: string, access_token: string}
*/
public function exchangeCode(string $code, string $redirectUri, string $codeVerifier): array
{
$response = $this->tokenRequest([
'grant_type' => 'authorization_code',
'code' => $code,
'redirect_uri' => $redirectUri,
'code_verifier' => $codeVerifier,
'scope' => self::SCOPES,
]);
if (! is_string($response['id_token'] ?? null) || ! is_string($response['access_token'] ?? null)) {
throw new IdentityException('Microsoft hat keine gültige Anmeldung zurückgegeben.');
}
return ['id_token' => $response['id_token'], 'access_token' => $response['access_token']];
}
/**
* App-Token (Client Credentials) für den Hintergrund-Abgleich – benötigt
* Anwendungsberechtigungen User.Read.All und GroupMember.Read.All.
*/
public function appToken(): string
{
return Cache::remember('entra.app-token.'.$this->provider->id, 3000, fn () => (string) $this->tokenRequest([
'grant_type' => 'client_credentials',
'scope' => 'https://graph.microsoft.com/.default',
])['access_token']);
}
public function forgetAppToken(): void
{
Cache::forget('entra.app-token.'.$this->provider->id);
}
/**
* Öffentliche Signaturschlüssel von Microsoft (gecacht, bei unbekanntem
* Schlüssel einmal neu geladen – Microsoft wechselt sie regelmäßig).
*
* @return array{keys: list<array<string, mixed>>}
*/
public function jwks(bool $refresh = false): array
{
$key = 'entra.jwks.'.$this->tenant();
if ($refresh) {
Cache::forget($key);
}
return Cache::remember($key, 86400, function () {
$response = Http::timeout(10)->acceptJson()->get(self::LOGIN_URL.'/'.$this->tenant().'/discovery/v2.0/keys');
if (! $response->successful() || ! is_array($response->json('keys'))) {
throw new IdentityException('Die Schlüssel von Microsoft konnten nicht geladen werden. Bitte später erneut versuchen.');
}
return ['keys' => $response->json('keys')];
});
}
public function graph(string $token): PendingRequest
{
return Http::timeout(20)->connectTimeout(10)->acceptJson()->withToken($token)->baseUrl(self::GRAPH_URL);
}
/**
* Alle Seiten einer Graph-Abfrage (@odata.nextLink), höchstens $maxPages.
*
* @param array<string, string> $headers
* @return list<array<string, mixed>>
*/
public function graphAll(string $token, string $url, int $maxPages = 50, array $headers = []): array
{
$items = [];
for ($page = 0; $page < $maxPages && $url; $page++) {
$response = $this->graph($token)->withHeaders($headers)->get($url);
$this->assertGraph($response);
$items = array_merge($items, (array) $response->json('value', []));
$url = ($response->json() ?? [])['@odata.nextLink'] ?? null;
}
return $items;
}
public function assertGraph(Response $response): void
{
if ($response->status() === 403) {
throw new IdentityException('Microsoft Graph verweigert den Zugriff. Bitte die API-Berechtigungen der App-Registrierung und die Administratorzustimmung prüfen.');
}
if (! $response->successful()) {
throw new IdentityException('Microsoft Graph antwortet mit einem Fehler (HTTP '.$response->status().').');
}
}
/**
* @param array<string, string> $params
* @return array<string, mixed>
*/
private function tokenRequest(array $params): array
{
$response = Http::asForm()->timeout(15)->acceptJson()->post(self::LOGIN_URL.'/'.$this->tenant().'/oauth2/v2.0/token', [
'client_id' => $this->clientId(),
'client_secret' => (string) $this->provider->setting('client_secret'),
...$params,
]);
if (! $response->successful()) {
$code = (string) $response->json('error');
throw new IdentityException(match (true) {
str_contains((string) $response->json('error_description'), 'AADSTS7000215') => 'Das Client-Secret der App-Registrierung ist ungültig oder abgelaufen.',
$code === 'invalid_grant' => 'Die Anmeldung ist abgelaufen. Bitte erneut versuchen.',
$code === 'unauthorized_client', $code === 'invalid_client' => 'Die App-Registrierung in Entra ID ist nicht korrekt eingerichtet (Client-ID oder Secret).',
default => 'Microsoft hat die Anmeldung abgelehnt ('.($code ?: 'HTTP '.$response->status()).').',
});
}
return (array) $response->json();
}
}

View file

@ -0,0 +1,280 @@
<?php
namespace App\Identity\Entra;
use App\Identity\IdentityException;
use App\Identity\IdentitySync;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\UserIdentity;
use App\Support\Settings;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Hintergrund-Abgleich mit Entra ID – ohne dass sich jemand anmelden muss.
*
* - Benutzer per Delta-Abfrage (/users/delta): nur Änderungen seit dem letzten
* Lauf; deaktivierte oder gelöschte Konten werden im Portal deaktiviert
* (Offboarding). Optional werden neue Konten vorab angelegt.
* - Fotos und Vorgesetzte rollierend in kleinen Portionen.
* - Gruppen- und App-Rollen-Zuordnungen stündlich für alle verknüpften Konten.
*
* Arbeitet mit Zeitbudget und setzt beim nächsten Lauf fort (Shared Hosting,
* Pseudo-Cron). Benötigt Anwendungsberechtigungen User.Read.All und
* GroupMember.Read.All (Administratorzustimmung).
*/
class EntraDirectorySync
{
public const PHOTOS_PER_RUN = 25;
public const GROUP_SYNC_INTERVAL = 3600;
public function __construct(
private readonly IdentitySync $sync,
private readonly Settings $settings,
) {}
public function runAll(int $budgetSeconds = 45): void
{
IdentityProvider::query()->where('enabled', true)->where('type', IdentityProvider::ENTRA)->get()
->filter(fn (IdentityProvider $p) => (bool) $p->setting('directory_sync', false))
->each(fn (IdentityProvider $p) => $this->run($p, $budgetSeconds));
}
public function run(IdentityProvider $provider, int $budgetSeconds = 45): void
{
$deadline = microtime(true) + $budgetSeconds;
$client = new EntraClient($provider);
try {
$token = $client->appToken();
$this->syncUsers($provider, $client, $token, $deadline);
$this->syncPhotosAndManagers($provider, $client, $token, $deadline);
if (now()->getTimestamp() - (int) $this->state($provider, 'groups_synced_at', 0) >= self::GROUP_SYNC_INTERVAL) {
$this->syncGroups($provider, $client, $token);
$this->saveState($provider, ['groups_synced_at' => now()->getTimestamp()]);
}
$this->saveState($provider, ['last_run_at' => now()->getTimestamp(), 'last_error' => null]);
} catch (Throwable $e) {
$client->forgetAppToken();
Log::error("Entra-Abgleich ({$provider->name}) fehlgeschlagen: ".$e->getMessage());
$this->saveState($provider, ['last_run_at' => now()->getTimestamp(), 'last_error' => $e->getMessage()]);
}
}
/**
* @return array<string, mixed>
*/
public function status(IdentityProvider $provider): array
{
return (array) $this->settings->get('identity.'.$provider->id.'.sync', []);
}
private function syncUsers(IdentityProvider $provider, EntraClient $client, string $token, float $deadline): void
{
$select = EntraAttributes::select($provider);
// Neue Attribute zugeordnet: Der alte Delta-Link liefert sie nicht – einmal komplett abgleichen.
if ($this->state($provider, 'select') !== $select) {
$this->saveState($provider, ['delta_link' => null, 'next_link' => null, 'select' => $select]);
}
$url = $this->state($provider, 'next_link') ?: $this->state($provider, 'delta_link') ?: '/users/delta?$select='.$select;
while ($url && microtime(true) < $deadline) {
$response = $client->graph($token)->get($url);
// Abgelaufener Delta-Link: von vorn beginnen.
if ($response->status() === 410) {
$this->saveState($provider, ['delta_link' => null, 'next_link' => null]);
return;
}
$client->assertGraph($response);
foreach ((array) $response->json('value', []) as $graphUser) {
$this->applyUser($provider, (array) $graphUser);
}
if ($next = ($response->json() ?? [])['@odata.nextLink'] ?? null) {
$url = $next;
$this->saveState($provider, ['next_link' => $next]);
} else {
$this->saveState($provider, ['delta_link' => ($response->json() ?? [])['@odata.deltaLink'] ?? null, 'next_link' => null, 'users_synced_at' => now()->getTimestamp()]);
$url = null;
}
}
}
/**
* @param array<string, mixed> $graphUser
*/
private function applyUser(IdentityProvider $provider, array $graphUser): void
{
$subject = (string) ($graphUser['id'] ?? '');
if ($subject === '') {
return;
}
$identity = UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
if (isset($graphUser['@removed']) || ($graphUser['accountEnabled'] ?? true) === false) {
if ($identity?->user) {
$this->sync->deactivate($provider, $identity);
}
return;
}
if (! $identity) {
$createAllowed = $provider->setting('directory_create_users', false)
&& ($graphUser['userType'] ?? 'Member') === 'Member'
&& ! empty($graphUser['mail']);
// Ohne Vorab-Anlage: nur bestehende Konten per E-Mail verknüpfen.
try {
$user = $this->sync->resolveUser($provider, $subject, EntraProfile::fromGraph($provider, $graphUser), (bool) $createAllowed);
} catch (IdentityException) {
return; // z. B. nicht erlaubte E-Mail-Domain – dieses Konto überspringen
}
if (! $user) {
return;
}
$identity = UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
}
// Delta liefert nur geänderte Felder – fehlende Felder nicht leeren.
$profile = EntraProfile::fromGraph($provider, $graphUser, partial: true);
$this->sync->syncProfile($provider, $identity->user, $profile);
}
private function syncPhotosAndManagers(IdentityProvider $provider, EntraClient $client, string $token, float $deadline): void
{
$withPhoto = (bool) $provider->setting('sync_photo', true);
$withManager = $provider->syncsManager();
if (! $withPhoto && ! $withManager) {
return;
}
$identities = UserIdentity::query()->with('user')
->where('identity_provider_id', $provider->id)
->whereHas('user', fn ($q) => $q->where('is_active', true))
->orderByRaw('synced_at is not null')->orderBy('synced_at')
->limit(self::PHOTOS_PER_RUN)->get();
foreach ($identities as $identity) {
if (microtime(true) >= $deadline) {
return;
}
if ($withPhoto) {
$response = $client->graph($token)->accept('image/*')->get('/users/'.$identity->subject.'/photo/$value');
if ($response->successful() || $response->status() === 404) {
$this->sync->syncPhoto($identity, $response->successful() ? $response->body() : null);
}
}
if ($withManager) {
$manager = $client->graph($token)->get('/users/'.$identity->subject.'/manager', ['$select' => 'id']);
if ($manager->successful() || $manager->status() === 404) {
$this->sync->syncProfile($provider, $identity->user, ['manager_subject' => $manager->successful() ? $manager->json('id') : null]);
}
}
$identity->forceFill(['synced_at' => now()])->save();
}
}
/**
* Gruppen- und App-Rollen-Zuordnungen für alle verknüpften Konten neu berechnen.
*/
private function syncGroups(IdentityProvider $provider, EntraClient $client, string $token): void
{
$mappings = $provider->mappings()->get();
$groupsBySubject = [];
$appRolesBySubject = [];
foreach ($mappings->where('kind', IdpGroupMapping::GROUP)->pluck('external_id')->unique() as $groupId) {
foreach ($this->transitiveUserIds($client, $token, $groupId) as $subject) {
$groupsBySubject[$subject][] = $groupId;
}
}
if ($mappings->where('kind', IdpGroupMapping::APP_ROLE)->isNotEmpty()) {
$appRolesBySubject = $this->appRoleAssignments($provider, $client, $token);
}
UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)
->whereHas('user', fn ($q) => $q->where('is_active', true))
->each(fn (UserIdentity $identity) => $this->sync->syncRoles(
$provider,
$identity->user,
$groupsBySubject[$identity->subject] ?? [],
array_values(array_unique($appRolesBySubject[$identity->subject] ?? [])),
));
}
/**
* @return list<string>
*/
private function transitiveUserIds(EntraClient $client, string $token, string $groupId): array
{
return array_column($client->graphAll($token, '/groups/'.$groupId.'/transitiveMembers/microsoft.graph.user?$select=id&$top=999'), 'id');
}
/**
* App-Rollen der App-Registrierung: direkt zugewiesene Personen und Gruppen (aufgelöst).
*
* @return array<string, list<string>> Objekt-ID => Rollen-Werte
*/
private function appRoleAssignments(IdentityProvider $provider, EntraClient $client, string $token): array
{
$servicePrincipal = $client->graph($token)->get("/servicePrincipals(appId='".$client->clientId()."')", ['$select' => 'id,appRoles']);
$client->assertGraph($servicePrincipal);
$values = collect((array) $servicePrincipal->json('appRoles', []))->pluck('value', 'id')->all();
$result = [];
foreach ($client->graphAll($token, '/servicePrincipals/'.$servicePrincipal->json('id').'/appRoleAssignedTo?$top=999') as $assignment) {
$value = $values[$assignment['appRoleId'] ?? ''] ?? null;
if (! $value) {
continue;
}
$subjects = ($assignment['principalType'] ?? '') === 'Group'
? $this->transitiveUserIds($client, $token, $assignment['principalId'])
: [$assignment['principalId']];
foreach ($subjects as $subject) {
$result[$subject][] = $value;
}
}
return $result;
}
private function state(IdentityProvider $provider, string $key, mixed $default = null): mixed
{
return $this->status($provider)[$key] ?? $default;
}
/**
* @param array<string, mixed> $values
*/
private function saveState(IdentityProvider $provider, array $values): void
{
$this->settings->set('identity.'.$provider->id.'.sync', array_merge($this->status($provider), $values));
}
}

View file

@ -0,0 +1,139 @@
<?php
namespace App\Identity\Entra;
use App\Identity\IdentityException;
use App\Identity\IdentitySync;
use App\Models\IdentityProvider;
use App\Models\User;
use App\Models\UserIdentity;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use Throwable;
/**
* Anmeldung über Entra ID (OpenID Connect, Autorisierungscode mit PKCE).
*/
class EntraLogin
{
public function __construct(private readonly IdentitySync $sync) {}
/**
* @return array{url: string, session: array<string, string>}
*/
public function start(IdentityProvider $provider, string $redirectUri): array
{
$verifier = Str::random(64);
$security = [
'state' => Str::random(40),
'nonce' => Str::random(40),
'code_challenge' => rtrim(strtr(base64_encode(hash('sha256', $verifier, true)), '+/', '-_'), '='),
];
return [
'url' => (new EntraClient($provider))->authorizationUrl($redirectUri, $security),
'session' => ['state' => $security['state'], 'nonce' => $security['nonce'], 'verifier' => $verifier, 'provider' => (string) $provider->id],
];
}
/**
* @param array<string, string> $session aus start()
*/
public function complete(IdentityProvider $provider, string $code, string $redirectUri, array $session): User
{
$client = new EntraClient($provider);
$tokens = $client->exchangeCode($code, $redirectUri, $session['verifier']);
$claims = (new IdTokenValidator($client))->validate($tokens['id_token'], $session['nonce']);
$subject = (string) $claims['oid'];
[$profile, $groupIds, $photo] = $this->fetchFromGraph($client, $provider, $tokens['access_token'], $claims);
$user = $this->sync->resolveUser($provider, $subject, $profile, (bool) $provider->setting('auto_provision', true));
if (! $user) {
throw new IdentityException('Für Ihr Microsoft-Konto gibt es kein Konto in diesem Portal. Bitte wenden Sie sich an die Administration.');
}
if (! $user->is_active) {
throw new IdentityException('Ihr Konto ist deaktiviert. Bitte wenden Sie sich an die Administration.');
}
$identity = UserIdentity::query()->where('identity_provider_id', $provider->id)->where('subject', $subject)->firstOrFail();
$identity->update(['last_login_at' => now(), 'email' => $profile['email'] ?? $identity->email]);
$this->sync->syncProfile($provider, $user, $profile);
$this->sync->syncRoles($provider, $user, $groupIds, array_values(array_filter((array) ($claims['roles'] ?? []), 'is_string')));
if ($provider->setting('sync_photo', true) && $photo !== false) {
$this->sync->syncPhoto($identity->fresh('user'), $photo);
}
return $user->fresh();
}
/**
* Profil, Gruppen und Foto über Graph (mit dem Token der angemeldeten Person).
* Fällt Graph aus, reichen die Angaben aus dem ID-Token für die Anmeldung.
*
* @param array<string, mixed> $claims
* @return array{0: array<string, mixed>, 1: list<string>, 2: string|null|false} false = Foto unbekannt
*/
private function fetchFromGraph(EntraClient $client, IdentityProvider $provider, string $token, array $claims): array
{
$groups = array_values(array_filter((array) ($claims['groups'] ?? []), 'is_string'));
$overage = isset($claims['_claim_names']['groups']) || ($claims['hasgroups'] ?? false);
try {
$me = $client->graph($token)->get('/me', ['$select' => EntraAttributes::select($provider)]);
// Einzelne Attribute brauchen weitere Berechtigungen (z. B. employeeHireDate) –
// dann wenigstens die Grundangaben übernehmen.
if ($me->clientError() && $me->status() !== 401) {
Log::warning('Entra-Anmeldung: Zugeordnete Attribute nicht abrufbar ('.$me->status().'), nutze Grundangaben.');
$me = $client->graph($token)->get('/me', ['$select' => implode(',', EntraAttributes::BASE_SELECT)]);
}
$client->assertGraph($me);
$withManager = $provider->syncsManager();
$managerSubject = null;
if ($withManager) {
$manager = $client->graph($token)->get('/me/manager', ['$select' => 'id']);
$managerSubject = $manager->successful() ? $manager->json('id') : null;
}
$profile = EntraProfile::fromGraph($provider, (array) $me->json(), $managerSubject, $withManager);
} catch (Throwable $e) {
Log::warning('Entra-Anmeldung: Profil aus Graph nicht abrufbar, nutze ID-Token. '.$e->getMessage());
$profile = EntraProfile::fromClaims($claims);
}
// Group-Overage: Bei vielen Gruppen stehen sie nicht im Token – dann über Graph
// (transitiv, also inklusive verschachtelter Gruppen).
if ($overage || $groups === []) {
try {
$groups = array_column($client->graphAll($token, '/me/transitiveMemberOf/microsoft.graph.group?$select=id&$top=999'), 'id');
} catch (Throwable $e) {
if ($overage) {
Log::error('Entra-Anmeldung: Gruppen konnten nicht ermittelt werden. '.$e->getMessage());
throw new IdentityException('Ihre Gruppenmitgliedschaften konnten nicht ermittelt werden. Bitte später erneut versuchen.');
}
}
}
$photo = false;
if ($provider->setting('sync_photo', true)) {
try {
$response = $client->graph($token)->accept('image/*')->get('/me/photo/$value');
$photo = $response->successful() ? $response->body() : ($response->status() === 404 ? null : false);
} catch (Throwable) {
$photo = false;
}
}
return [$profile, $groups, $photo];
}
}

View file

@ -0,0 +1,79 @@
<?php
namespace App\Identity\Entra;
use App\Models\IdentityProvider;
/**
* Normalisiert Entra-/Graph-Benutzerdaten auf die Profilfelder des Portals –
* gemäß der Attribut-Zuordnung des Anbieters.
*
* Ergebnis: display_name, Kernfelder (first_name, email, …), freie Felder unter
* „custom“ und – falls abgefragt – manager_subject.
*/
final class EntraProfile
{
/**
* @param array<string, mixed> $graphUser Antwort von /me, /users/{id} oder /users/delta
* @param bool $partial Delta-Antwort: nur Felder liefern, deren Attribut enthalten ist
* @return array<string, mixed>
*/
public static function fromGraph(IdentityProvider $provider, array $graphUser, ?string $managerSubject = null, bool $withManager = false, bool $partial = false): array
{
$present = fn (string $path) => ! $partial || array_key_exists(EntraAttributes::topLevel($path), $graphUser);
$profile = [];
if ($present('displayName')) {
$profile['display_name'] = EntraAttributes::value($graphUser, 'displayName');
}
// Grundwerte für Kontoanlage und Verknüpfung; die Zuordnung überschreibt sie.
foreach (['first_name' => 'givenName', 'last_name' => 'surname', 'email' => 'mail'] as $field => $path) {
if ($present($path)) {
$profile[$field] = EntraAttributes::value($graphUser, $path);
}
}
foreach ($provider->attributeMap() as $target => $path) {
if (! $present($path)) {
continue;
}
$value = EntraAttributes::value($graphUser, $path);
if (str_starts_with($target, 'custom.')) {
$profile['custom'][substr($target, 7)] = $value;
} else {
$profile[$target] = $value;
}
}
// Gastkonten haben oft keine „mail“; der UPN ist dann eine #EXT#-Adresse.
if (array_key_exists('email', $profile) && $profile['email'] === null && ! $partial) {
$upn = (string) ($graphUser['userPrincipalName'] ?? '');
$profile['email'] = $upn !== '' && ! str_contains($upn, '#EXT#') ? $upn : null;
}
if ($withManager) {
$profile['manager_subject'] = $managerSubject;
}
return $profile;
}
/**
* Rückfall, wenn Graph nicht erreichbar ist: Angaben aus dem ID-Token.
*
* @param array<string, mixed> $claims
* @return array<string, mixed>
*/
public static function fromClaims(array $claims): array
{
return [
'display_name' => $claims['name'] ?? null,
'first_name' => $claims['given_name'] ?? null,
'last_name' => $claims['family_name'] ?? null,
'email' => $claims['email'] ?? $claims['preferred_username'] ?? null,
];
}
}

View file

@ -0,0 +1,74 @@
<?php
namespace App\Identity\Entra;
use App\Identity\IdentityException;
use Firebase\JWT\JWK;
use Firebase\JWT\JWT;
use Throwable;
use UnexpectedValueException;
/**
* Prüft das ID-Token von Entra ID: Signatur (Schlüssel von Microsoft), Aussteller
* (genau dieser Mandant), Empfänger (diese App), Gültigkeit und Nonce.
*/
class IdTokenValidator
{
public function __construct(private readonly EntraClient $client) {}
/**
* @return array<string, mixed> Claims
*/
public function validate(string $idToken, string $expectedNonce): array
{
JWT::$leeway = 120;
try {
$claims = $this->decode($idToken, $this->client->jwks());
} catch (UnexpectedValueException $e) {
if (! str_contains($e->getMessage(), '"kid"')) {
throw new IdentityException('Die Anmeldung von Microsoft konnte nicht bestätigt werden.', previous: $e);
}
// Unbekannter Schlüssel: Microsoft hat die Schlüssel gewechselt – einmal neu laden.
try {
$claims = $this->decode($idToken, $this->client->jwks(refresh: true));
} catch (UnexpectedValueException $e) {
throw new IdentityException('Die Anmeldung von Microsoft konnte nicht bestätigt werden.', previous: $e);
}
}
if (($claims['iss'] ?? null) !== $this->client->issuer()) {
throw new IdentityException('Die Anmeldung stammt nicht aus dem erwarteten Microsoft-Mandanten.');
}
if (($claims['aud'] ?? null) !== $this->client->clientId()) {
throw new IdentityException('Die Anmeldung war für eine andere Anwendung bestimmt.');
}
if (! hash_equals($expectedNonce, (string) ($claims['nonce'] ?? ''))) {
throw new IdentityException('Die Anmeldung konnte nicht zugeordnet werden. Bitte erneut versuchen.');
}
if (! is_string($claims['oid'] ?? null) || $claims['oid'] === '') {
throw new IdentityException('Microsoft hat keine Benutzerkennung übermittelt.');
}
return $claims;
}
/**
* @param array{keys: list<array<string, mixed>>} $jwks
* @return array<string, mixed>
*/
private function decode(string $token, array $jwks): array
{
try {
return (array) json_decode(json_encode(JWT::decode($token, JWK::parseKeySet($jwks, 'RS256'))), true);
} catch (UnexpectedValueException $e) {
throw $e;
} catch (Throwable $e) {
throw new IdentityException('Die Anmeldung von Microsoft konnte nicht bestätigt werden.', previous: $e);
}
}
}

View file

@ -0,0 +1,124 @@
<?php
namespace App\Identity\Entra;
use App\Identity\IdentityException;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\Role;
/**
* „Mapping testen“: Welche Gruppen und App-Rollen liefert Entra für eine Person,
* und welche Rollen entstehen daraus im Portal?
*/
class MappingTester
{
/**
* @return array{user: array<string, mixed>, groups: list<array{id: string, name: string, roles: list<string>}>, app_roles: list<array{value: string, roles: list<string>}>, roles: list<string>}
*/
public function test(IdentityProvider $provider, string $userPrincipal): array
{
$client = new EntraClient($provider);
$token = $client->appToken();
$user = $client->graph($token)->get('/users/'.rawurlencode($userPrincipal), ['$select' => 'id,displayName,mail,userPrincipalName,accountEnabled']);
if ($user->status() === 404) {
throw new IdentityException('Diese Person gibt es in Entra ID nicht.');
}
$client->assertGraph($user);
$id = (string) $user->json('id');
$groups = $client->graphAll($token, '/users/'.$id.'/transitiveMemberOf/microsoft.graph.group?$select=id,displayName&$top=999');
$servicePrincipal = $client->graph($token)->get("/servicePrincipals(appId='".$client->clientId()."')", ['$select' => 'id,appRoles']);
$appRoles = [];
if ($servicePrincipal->successful()) {
$values = collect((array) $servicePrincipal->json('appRoles', []))->pluck('value', 'id');
$assignments = $client->graphAll($token, '/users/'.$id.'/appRoleAssignments?$top=999');
$groupIds = array_column($groups, 'id');
foreach ($assignments as $assignment) {
if (($assignment['resourceId'] ?? null) === $servicePrincipal->json('id') && $values->has($assignment['appRoleId'] ?? '')) {
$appRoles[] = $values[$assignment['appRoleId']];
}
}
// Über Gruppen zugewiesene App-Rollen
foreach ($client->graphAll($token, '/servicePrincipals/'.$servicePrincipal->json('id').'/appRoleAssignedTo?$top=999') as $assignment) {
if (($assignment['principalType'] ?? '') === 'Group' && in_array($assignment['principalId'], $groupIds, true) && $values->has($assignment['appRoleId'] ?? '')) {
$appRoles[] = $values[$assignment['appRoleId']];
}
}
}
$mappings = $provider->mappings()->with('role')->get();
$roleNames = fn (string $kind, string $external) => $mappings
->filter(fn (IdpGroupMapping $m) => $m->kind === $kind && strtolower($m->external_id) === strtolower($external))
->map(fn (IdpGroupMapping $m) => $m->role->name)->values()->all();
$groupRows = array_map(fn (array $g) => ['id' => $g['id'], 'name' => $g['displayName'] ?? $g['id'], 'roles' => $roleNames(IdpGroupMapping::GROUP, $g['id'])], $groups);
usort($groupRows, fn ($a, $b) => [empty($a['roles']), $a['name']] <=> [empty($b['roles']), $b['name']]);
$appRoleRows = array_map(fn (string $v) => ['value' => $v, 'roles' => $roleNames(IdpGroupMapping::APP_ROLE, $v)], array_values(array_unique($appRoles)));
$roles = collect($groupRows)->pluck('roles')->flatten()->merge(collect($appRoleRows)->pluck('roles')->flatten());
if ($default = $provider->setting('default_role_id')) {
$roles->push(Role::query()->find($default)?->name.' (Standardrolle)');
}
return [
'user' => [
'name' => $user->json('displayName'),
'email' => $user->json('mail') ?: $user->json('userPrincipalName'),
'enabled' => (bool) $user->json('accountEnabled', true),
],
'groups' => $groupRows,
'app_roles' => $appRoleRows,
'roles' => $roles->filter()->unique()->values()->all(),
];
}
/**
* Gruppensuche für das Mapping-Formular.
*
* @return array<string, string> Objekt-ID => Anzeigename
*/
public function searchGroups(IdentityProvider $provider, string $search): array
{
$client = new EntraClient($provider);
$response = $client->graph($client->appToken())
->withHeaders(['ConsistencyLevel' => 'eventual'])
->get('/groups', ['$search' => '"displayName:'.str_replace('"', '', $search).'"', '$select' => 'id,displayName', '$top' => 20]);
$client->assertGraph($response);
return collect((array) $response->json('value', []))->mapWithKeys(fn ($g) => [$g['id'] => $g['displayName'].' ('.substr($g['id'], 0, 8).'…)'])->all();
}
/**
* Verzeichniserweiterungen des Mandanten (extension_<appId>_<name>) für Benutzer –
* etwa aus Entra Connect synchronisierte AD-Attribute. Wird in der Konfiguration
* gespeichert und im Formular als Vorschlag angeboten.
*
* @return list<string>
*/
public function loadExtensionProperties(IdentityProvider $provider): array
{
$client = new EntraClient($provider);
$response = $client->graph($client->appToken())->post('/directoryObjects/getAvailableExtensionProperties', (object) []);
$client->assertGraph($response);
$names = collect((array) $response->json('value', []))
->filter(fn ($property) => in_array('User', (array) ($property['targetObjects'] ?? []), true))
->pluck('name')
->filter(fn ($name) => is_string($name) && preg_match(EntraAttributes::PATH_PATTERN, $name))
->unique()->sort()->values()->all();
$provider->update(['config' => array_merge((array) $provider->config, ['extension_properties' => $names])]);
return $names;
}
}

View file

@ -0,0 +1,11 @@
<?php
namespace App\Identity;
use RuntimeException;
/**
* Anmeldung über einen Identity Provider ist fehlgeschlagen. Die Meldung ist
* für die anmeldende Person gedacht (deutsch, ohne technische Details).
*/
class IdentityException extends RuntimeException {}

View file

@ -0,0 +1,273 @@
<?php
namespace App\Identity;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\User;
use App\Models\UserIdentity;
use App\Support\Audit;
use App\Support\Avatars;
use App\Support\Permissions\Permissions;
use App\Support\ProfileFields;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use Throwable;
/**
* Überträgt Daten eines Identity Providers ins Portal: Konto finden oder anlegen,
* Profilfelder, Foto und Rollen. Wird bei der Anmeldung und im Hintergrund-Abgleich genutzt.
*/
class IdentitySync
{
public function __construct(
private readonly Avatars $avatars,
private readonly ProfileFields $profileFields,
) {}
/**
* Konto zu einer externen Identität finden, verknüpfen oder anlegen.
*
* @param array<string, mixed> $profile normalisiertes Profil (siehe EntraProfile)
*/
public function resolveUser(IdentityProvider $provider, string $subject, array $profile, bool $allowCreate): ?User
{
$identity = UserIdentity::query()->with('user')
->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
if ($identity?->user) {
return $identity->user;
}
$email = isset($profile['email']) ? Str::lower((string) $profile['email']) : null;
if ($email && ! $provider->isEmailDomainAllowed($email)) {
throw new IdentityException('Konten mit dieser E-Mail-Domain dürfen sich hier nicht anmelden.');
}
$user = $email && $provider->setting('link_by_email', true)
? User::query()->where('email', $email)->first()
: null;
if (! $user) {
if (! $allowCreate) {
return null;
}
if (! $email) {
throw new IdentityException('Für dieses Microsoft-Konto ist keine E-Mail-Adresse hinterlegt.');
}
$user = User::query()->create([
'email' => $email,
'first_name' => $profile['first_name'] ?? null,
'last_name' => $profile['last_name'] ?? null,
'name' => $profile['display_name'] ?? $email,
'password' => null,
'is_active' => true,
]);
Audit::log('identity.user_created', ['provider' => $provider->name, 'email' => $email], null);
}
UserIdentity::query()->create([
'user_id' => $user->id,
'identity_provider_id' => $provider->id,
'subject' => $subject,
'email' => $email,
]);
return $user;
}
/**
* Profilfelder übernehmen – nur die in der Konfiguration gewählten.
*
* @param array<string, mixed> $profile
*/
public function syncProfile(IdentityProvider $provider, User $user, array $profile): void
{
$fields = $provider->syncedFields();
$changes = [];
foreach (['first_name', 'last_name', 'job_title', 'department', 'location', 'phone', 'mobile'] as $field) {
if (in_array($field, $fields, true) && array_key_exists($field, $profile)) {
$changes[$field] = $profile[$field] !== '' ? $profile[$field] : null;
}
}
if (in_array('first_name', $fields, true) && empty($profile['first_name']) && empty($profile['last_name']) && ! empty($profile['display_name'])) {
$changes['name'] = $profile['display_name'];
}
if (in_array('email', $fields, true) && ! empty($profile['email'])) {
$email = Str::lower($profile['email']);
if (User::query()->where('email', $email)->whereKeyNot($user->id)->exists()) {
Log::warning("Entra-Abgleich: E-Mail {$email} ist bereits einem anderen Konto zugeordnet – nicht übernommen.");
} else {
$changes['email'] = $email;
}
}
if (in_array('manager', $fields, true) && array_key_exists('manager_subject', $profile)) {
$changes['manager_id'] = $profile['manager_subject']
? UserIdentity::query()->where('identity_provider_id', $provider->id)->where('subject', $profile['manager_subject'])->value('user_id')
: null;
}
$custom = $this->customFieldChanges($user, $fields, (array) ($profile['custom'] ?? []));
if ($custom !== null) {
$changes['custom_fields'] = $custom;
}
if ($changes !== []) {
$user->forceFill($changes)->save();
}
}
/**
* Freie Profilfelder aus dem Anbieter übernehmen. Datumswerte werden als
* Y-m-d gespeichert, Werte ohne Felddefinition ignoriert.
*
* @param list<string> $fields
* @param array<string, string|null> $incoming
* @return array<string, string>|null null = keine Änderung
*/
private function customFieldChanges(User $user, array $fields, array $incoming): ?array
{
$definitions = $this->profileFields->all()->keyBy('key');
$values = (array) ($user->custom_fields ?? []);
$before = $values;
foreach ($incoming as $key => $value) {
$field = $definitions->get($key);
if (! $field || ! in_array('custom.'.$key, $fields, true)) {
continue;
}
if ($value !== null && $field->type === 'date') {
try {
$value = Carbon::parse($value)->format('Y-m-d');
} catch (Throwable) {
// Unlesbares Datum: unverändert übernehmen.
}
}
if ($value === null) {
unset($values[$key]);
} else {
$values[$key] = $value;
}
}
return $values === $before ? null : $values;
}
/**
* Profilfoto übernehmen, wenn es sich geändert hat. null = kein Foto beim Anbieter.
*/
public function syncPhoto(UserIdentity $identity, ?string $binary): void
{
$user = $identity->user;
try {
if ($binary === null) {
// Nur ein Foto entfernen, das auch aus Entra stammte.
if ($identity->photo_hash !== null) {
$this->avatars->delete($user);
$identity->update(['photo_hash' => null]);
}
return;
}
$hash = hash('sha256', $binary);
if ($hash !== $identity->photo_hash || $user->avatar_path === null) {
$this->avatars->storeFromBinary($user, $binary);
$identity->update(['photo_hash' => $hash]);
}
} catch (Throwable $e) {
Log::warning("Profilfoto für {$user->email} konnte nicht übernommen werden: ".$e->getMessage());
}
}
/**
* Rollen aus Gruppen und App-Rollen abgleichen. Nur Zuweisungen dieses
* Anbieters werden hinzugefügt oder entfernt – manuelle bleiben unberührt.
*
* @param list<string> $groupIds Objekt-IDs der Gruppen
* @param list<string> $appRoles Werte der App-Rollen
* @return list<int> resultierende Rollen-IDs aus diesem Anbieter
*/
public function syncRoles(IdentityProvider $provider, User $user, array $groupIds, array $appRoles): array
{
$desired = [];
foreach ($provider->mappings()->get() as $mapping) {
$values = $mapping->kind === IdpGroupMapping::APP_ROLE ? $appRoles : array_map('strtolower', $groupIds);
$external = $mapping->kind === IdpGroupMapping::APP_ROLE ? $mapping->external_id : strtolower($mapping->external_id);
if (in_array($external, $values, true)) {
$desired[$mapping->role_id.'|'.$provider->sourcePrefix().$mapping->kind.':'.$mapping->external_id] = $mapping->role_id;
}
}
if ($defaultRole = $provider->setting('default_role_id')) {
$desired[$defaultRole.'|'.$provider->sourcePrefix().'default'] = (int) $defaultRole;
}
$current = DB::table('role_user')
->where('user_id', $user->id)
->where('source', 'idp')
->where('source_ref', 'like', $provider->sourcePrefix().'%')
->get(['id', 'role_id', 'source_ref'])
->keyBy(fn ($row) => $row->role_id.'|'.$row->source_ref);
$removed = $current->keys()->diff(array_keys($desired));
$added = collect(array_keys($desired))->diff($current->keys());
if ($removed->isNotEmpty()) {
DB::table('role_user')->whereIn('id', $removed->map(fn ($key) => $current[$key]->id)->all())->delete();
}
foreach ($added as $key) {
[$roleId, $sourceRef] = explode('|', $key, 2);
DB::table('role_user')->insert(['role_id' => (int) $roleId, 'user_id' => $user->id, 'source' => 'idp', 'source_ref' => $sourceRef, 'created_at' => now()]);
}
if ($removed->isNotEmpty() || $added->isNotEmpty()) {
Permissions::flush();
Audit::log('identity.roles_synced', [
'provider' => $provider->name,
'user' => $user->email,
'added' => $added->values()->all(),
'removed' => $removed->values()->all(),
], null);
}
return array_values(array_unique($desired));
}
/**
* Konto wurde beim Anbieter deaktiviert oder gelöscht: im Portal deaktivieren
* und die Rollen aus diesem Anbieter entfernen.
*/
public function deactivate(IdentityProvider $provider, UserIdentity $identity): void
{
$user = $identity->user;
if ($user->is_active) {
$user->forceFill(['is_active' => false])->save();
Audit::log('identity.user_deactivated', ['provider' => $provider->name, 'email' => $user->email], null);
}
$this->syncRoles($provider, $user, [], []);
DB::table('sessions')->where('user_id', $user->id)->delete();
}
}

18
app/Models/Audience.php Normal file
View file

@ -0,0 +1,18 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
/**
* Zielgruppen-Regel: Objekt X ist sichtbar für Rolle/Abteilung/Standort Y.
* Objekte ohne Regel sind für alle sichtbar; mehrere Regeln verknüpft ODER.
*/
#[Fillable(['resource_type', 'resource_id', 'rule_type', 'rule_value'])]
class Audience extends Model
{
public const TYPES = ['role' => 'Rolle', 'department' => 'Abteilung', 'location' => 'Standort'];
public $timestamps = false;
}

29
app/Models/AuditLog.php Normal file
View file

@ -0,0 +1,29 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable(['user_id', 'action', 'data'])]
class AuditLog extends Model
{
public const UPDATED_AT = null;
protected function casts(): array
{
return [
'data' => 'array',
'created_at' => 'datetime',
];
}
/**
* @return BelongsTo<User, $this>
*/
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
}

View file

@ -0,0 +1,94 @@
<?php
namespace App\Models;
use App\Pagebuilder\Field;
use App\Support\Permissions\Audiences;
use App\Support\RichText;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Storage;
/**
* Eigene Kachel auf der Startseite („Administration → Portal → Startseite“).
*/
#[Fillable(['name', 'type', 'area', 'title', 'image_path', 'url', 'new_tab', 'alt', 'body', 'variant', 'is_active', 'starts_at', 'ends_at'])]
class DashboardTile extends Model
{
public const TYPES = [
'image' => 'Bild mit Link',
'text' => 'Text',
'notice' => 'Hinweis',
];
public const AREAS = [
'aside' => 'Seitenleiste (rechts)',
'main' => 'Hauptspalte (breit)',
'top' => 'Ganz oben (volle Breite)',
];
public const VARIANTS = [
'brand' => 'Markenfarbe',
'info' => 'Info (blau)',
'success' => 'Erfolg (grün)',
'warning' => 'Warnung (rot)',
'neutral' => 'Neutral (grau)',
];
protected static function booted(): void
{
static::saving(function (DashboardTile $tile) {
$tile->url = filled($tile->url) ? (Field::safeUrl($tile->url) ?: null) : null;
if ($tile->isDirty('body')) {
$tile->body_html = app(RichText::class)->toSafeHtml($tile->body);
}
});
static::deleted(fn (DashboardTile $tile) => $tile->image_path && Storage::disk('uploads')->delete($tile->image_path));
}
protected function casts(): array
{
return ['new_tab' => 'boolean', 'is_active' => 'boolean', 'starts_at' => 'datetime', 'ends_at' => 'datetime'];
}
public function widgetKey(): string
{
return 'tile.'.$this->id;
}
/**
* Aktiv, im Zeitraum und für die Person sichtbar.
*
* @param Builder<DashboardTile> $query
*/
public function scopeVisibleTo(Builder $query, User $user): void
{
$query->where('is_active', true)
->where(fn ($q) => $q->whereNull('starts_at')->orWhere('starts_at', '<=', now()))
->where(fn ($q) => $q->whereNull('ends_at')->orWhere('ends_at', '>', now()));
Audiences::constrain($query, 'dashboard_tile', 'dashboard_tiles.id', $user);
}
/**
* @return array<string, mixed>
*/
public function toWidgetProps(): array
{
return [
'tile' => [
'type' => $this->type,
'title' => $this->title,
'image_url' => $this->image_path ? Storage::disk('uploads')->url($this->image_path) : null,
'url' => $this->url,
'new_tab' => $this->new_tab,
'alt' => $this->alt ?: '',
'html' => $this->body_html,
'variant' => $this->variant ?: 'brand',
],
];
}
}

35
app/Models/Grant.php Normal file
View file

@ -0,0 +1,35 @@
<?php
namespace App\Models;
use App\Support\Permissions\Permissions;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Ein Recht einer Rolle: global (resource_type = null) oder für ein Objekt
* (resource_id = null bedeutet: alle Objekte dieses Typs).
*/
#[Fillable(['role_id', 'ability', 'resource_type', 'resource_id', 'include_children'])]
class Grant extends Model
{
protected static function booted(): void
{
static::saved(fn () => Permissions::flush());
static::deleted(fn () => Permissions::flush());
}
protected function casts(): array
{
return ['include_children' => 'boolean', 'resource_id' => 'integer'];
}
/**
* @return BelongsTo<Role, $this>
*/
public function role(): BelongsTo
{
return $this->belongsTo(Role::class);
}
}

View file

@ -0,0 +1,141 @@
<?php
namespace App\Models;
use App\Identity\Entra\EntraAttributes;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Support\Str;
/**
* Ein angebundener Identity Provider (zunächst Microsoft Entra ID).
*
* config (verschlüsselt): tenant_id, client_id, client_secret, button_label,
* auto_provision, link_by_email, allowed_domains, default_role_id,
* attribute_map (Liste aus target + attribute), sync_manager, sync_photo,
* extension_properties, directory_sync, directory_create_users
* (älter: synced_fields – wird noch gelesen, siehe attributeMap())
*/
#[Fillable(['type', 'name', 'slug', 'enabled', 'config'])]
class IdentityProvider extends Model
{
public const ENTRA = 'entra';
/** Profilfelder, die aus dem Identity Provider übernommen werden können. */
/** Kernfelder des Profils, die aus einem Attribut befüllt werden können. */
public const PROFILE_TARGETS = [
'first_name' => 'Vorname',
'last_name' => 'Nachname',
'email' => 'E-Mail-Adresse',
'job_title' => 'Funktion',
'department' => 'Abteilung',
'location' => 'Standort',
'phone' => 'Telefon',
'mobile' => 'Mobil',
];
protected static function booted(): void
{
static::saving(function (IdentityProvider $provider) {
$provider->slug = $provider->slug ?: Str::slug($provider->name) ?: $provider->type;
});
}
protected function casts(): array
{
return [
'enabled' => 'boolean',
'config' => 'encrypted:array',
];
}
public function setting(string $key, mixed $default = null): mixed
{
return data_get($this->config, $key, $default);
}
/**
* Zuordnung Profilfeld => Graph-Attribut. Ziele sind Kernfelder („job_title“)
* oder freie Profilfelder („custom.personalnummer“). Ohne gespeicherte Zuordnung
* gilt die Standardzuordnung für die früher gewählten Felder.
*
* @return array<string, string>
*/
public function attributeMap(): array
{
$rows = $this->setting('attribute_map');
if (! is_array($rows)) {
$legacy = (array) $this->setting('synced_fields', array_keys(EntraAttributes::DEFAULT_MAP));
return array_intersect_key(EntraAttributes::DEFAULT_MAP, array_flip($legacy));
}
$map = [];
foreach ($rows as $row) {
$target = (string) ($row['target'] ?? '');
$attribute = trim((string) ($row['attribute'] ?? ''));
if ($attribute !== '' && preg_match(EntraAttributes::PATH_PATTERN, $attribute)
&& (array_key_exists($target, self::PROFILE_TARGETS) || str_starts_with($target, 'custom.'))) {
$map[$target] = $attribute;
}
}
return $map;
}
public function syncsManager(): bool
{
return (bool) $this->setting('sync_manager', in_array('manager', (array) $this->setting('synced_fields', ['manager']), true));
}
/**
* Felder, die dieser Anbieter pflegt (im Portal schreibgeschützt).
*
* @return list<string>
*/
public function syncedFields(): array
{
return [...array_keys($this->attributeMap()), ...($this->syncsManager() ? ['manager'] : [])];
}
public function buttonLabel(): string
{
return $this->setting('button_label') ?: 'Mit Microsoft anmelden';
}
public function isEmailDomainAllowed(?string $email): bool
{
$domains = array_filter(array_map(fn ($d) => strtolower(trim((string) $d)), (array) $this->setting('allowed_domains', [])));
if ($domains === []) {
return true;
}
return $email !== null && in_array(strtolower(substr(strrchr($email, '@') ?: '', 1)), $domains, true);
}
public function sourcePrefix(): string
{
return $this->id.':';
}
/**
* @return HasMany<IdpGroupMapping, $this>
*/
public function mappings(): HasMany
{
return $this->hasMany(IdpGroupMapping::class);
}
/**
* @return HasMany<UserIdentity, $this>
*/
public function identities(): HasMany
{
return $this->hasMany(UserIdentity::class);
}
}

View file

@ -0,0 +1,33 @@
<?php
namespace App\Models;
use App\Support\Permissions\Permissions;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Entra-Gruppe (Objekt-ID) bzw. App-Rolle (Wert) → Rolle im Portal.
*/
#[Fillable(['identity_provider_id', 'kind', 'external_id', 'external_name', 'role_id'])]
class IdpGroupMapping extends Model
{
public const GROUP = 'group';
public const APP_ROLE = 'app_role';
protected static function booted(): void
{
static::saved(fn () => Permissions::flush());
static::deleted(fn () => Permissions::flush());
}
/**
* @return BelongsTo<Role, $this>
*/
public function role(): BelongsTo
{
return $this->belongsTo(Role::class);
}
}

View file

@ -1,22 +0,0 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
#[Fillable(['name', 'slug', 'description', 'sort'])]
class NewsCategory extends Model
{
use HasFactory;
/**
* @return HasMany<NewsPost, $this>
*/
public function posts(): HasMany
{
return $this->hasMany(NewsPost::class, 'category_id');
}
}

View file

@ -0,0 +1,41 @@
<?php
namespace App\Models;
use App\Support\ProfileFields;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;
#[Fillable(['key', 'label', 'type', 'visibility', 'editable', 'help', 'sort'])]
class ProfileField extends Model
{
public const TYPES = [
'text' => 'Text',
'textarea' => 'Mehrzeiliger Text',
'email' => 'E-Mail-Adresse',
'phone' => 'Telefonnummer',
'url' => 'Link',
'date' => 'Datum',
];
public const VISIBILITIES = [
'public' => 'Für alle sichtbar',
'restricted' => 'Nur die Person selbst und die Personalverwaltung',
];
protected static function booted(): void
{
static::saving(function (ProfileField $field) {
$field->key = $field->key ?: Str::slug($field->label, '_', 'de');
});
static::saved(fn () => app(ProfileFields::class)->flush());
static::deleted(fn () => app(ProfileFields::class)->flush());
}
protected function casts(): array
{
return ['editable' => 'boolean'];
}
}

70
app/Models/Role.php Normal file
View file

@ -0,0 +1,70 @@
<?php
namespace App\Models;
use App\Support\Permissions\Permissions;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Support\Str;
#[Fillable(['name', 'slug', 'description', 'is_system'])]
class Role extends Model
{
use HasFactory;
public const ADMINISTRATION = 'administration';
protected static function booted(): void
{
static::saving(function (Role $role) {
$role->slug = $role->slug ?: Str::slug($role->name, language: 'de');
});
static::saved(fn () => Permissions::flush());
static::deleted(fn () => Permissions::flush());
}
protected function casts(): array
{
return ['is_system' => 'boolean'];
}
public static function administration(): self
{
$role = static::query()->firstOrCreate(['slug' => self::ADMINISTRATION], [
'name' => 'Administration',
'description' => 'Voller Zugriff auf alle Bereiche und Einstellungen.',
'is_system' => true,
]);
if (! $role->grants()->where('ability', '*')->exists()) {
$role->grants()->create(['ability' => '*']);
}
return $role;
}
/**
* @return BelongsToMany<User, $this>
*/
public function users(): BelongsToMany
{
return $this->belongsToMany(User::class)->withPivot('source', 'source_ref', 'created_at');
}
/**
* @return HasMany<Grant, $this>
*/
public function grants(): HasMany
{
return $this->hasMany(Grant::class);
}
public function isAdministration(): bool
{
return $this->slug === self::ADMINISTRATION;
}
}

View file

@ -3,6 +3,8 @@
namespace App\Models;
use App\Support\Avatars;
use App\Support\Permissions\Permissions;
use App\Support\Permissions\PermissionSet;
use Database\Factories\UserFactory;
use Filament\Models\Contracts\FilamentUser;
use Filament\Models\Contracts\HasAvatar;
@ -12,14 +14,17 @@ use Illuminate\Database\Eloquent\Attributes\Hidden;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Support\Str;
#[Fillable([
'name', 'first_name', 'last_name', 'email', 'password',
'job_title', 'department', 'location', 'phone', 'mobile', 'about',
'is_admin', 'is_active', 'theme',
'job_title', 'department', 'location', 'phone', 'mobile', 'about', 'custom_fields',
'is_active', 'theme',
])]
#[Hidden(['password', 'remember_token'])]
class User extends Authenticatable implements FilamentUser, HasAvatar
@ -46,19 +51,107 @@ class User extends Authenticatable implements FilamentUser, HasAvatar
return [
'email_verified_at' => 'datetime',
'last_login_at' => 'datetime',
'custom_fields' => 'array',
'password' => 'hashed',
'is_admin' => 'boolean',
'is_active' => 'boolean',
];
}
/**
* Vorläufig: Zugriff auf das Admin-Backend über das Flag is_admin.
* Wird in Phase 2 durch das Rollen- und Rechtesystem ersetzt.
* Admin-Backend: für alle mit irgendeinem Recht (z. B. Redaktion einer
* Kategorie). Was sie dort sehen, regeln die Policies der einzelnen Seiten.
*/
public function canAccessPanel(Panel $panel): bool
{
return $this->is_admin && $this->is_active;
return $this->canAccessAdmin();
}
public function canAccessAdmin(): bool
{
$permissions = $this->permissions();
return $this->is_active && ($permissions->global !== [] || $permissions->hasAnyObjectGrant());
}
public function permissions(): PermissionSet
{
return app(Permissions::class)->for($this);
}
/**
* @return HasMany<UserIdentity, $this>
*/
public function identities(): HasMany
{
return $this->hasMany(UserIdentity::class);
}
/**
* @return BelongsTo<User, $this>
*/
public function manager(): BelongsTo
{
return $this->belongsTo(User::class, 'manager_id');
}
/**
* @return HasMany<User, $this>
*/
public function reports(): HasMany
{
return $this->hasMany(User::class, 'manager_id');
}
/**
* Profilfelder, die ein Identity Provider pflegt – im Portal nur lesbar.
*
* @return list<string>
*/
public function managedFields(): array
{
return $this->identities()->with('provider')->get()
->filter(fn (UserIdentity $identity) => $identity->provider?->enabled)
->flatMap(fn (UserIdentity $identity) => $identity->provider->syncedFields())
->unique()->values()->all();
}
/**
* @return BelongsToMany<Role, $this>
*/
public function roles(): BelongsToMany
{
return $this->belongsToMany(Role::class)->withPivot('source', 'source_ref', 'created_at');
}
public function hasRole(string $slug): bool
{
return $this->roles()->where('slug', $slug)->exists();
}
public function isAdministrator(): bool
{
return $this->permissions()->isSuperuser();
}
/**
* Manuell vergebene Rollen setzen. Rollen aus Identity-Provider-Gruppen
* (Quelle „idp“) bleiben unberührt – Rollen sind additiv.
*
* @param list<int> $roleIds
*/
public function syncManualRoles(array $roleIds): void
{
$current = $this->roles()->wherePivot('source', 'manual')->pluck('roles.id')->all();
foreach (array_diff($current, $roleIds) as $roleId) {
$this->roles()->wherePivot('source', 'manual')->detach($roleId);
}
foreach (array_diff($roleIds, $current) as $roleId) {
$this->roles()->attach($roleId, ['source' => 'manual', 'created_at' => now()]);
}
Permissions::flush();
}
public function getFilamentAvatarUrl(): ?string

View file

@ -0,0 +1,32 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable(['user_id', 'identity_provider_id', 'subject', 'email', 'photo_hash', 'last_login_at', 'synced_at'])]
class UserIdentity extends Model
{
protected function casts(): array
{
return ['last_login_at' => 'datetime', 'synced_at' => 'datetime'];
}
/**
* @return BelongsTo<User, $this>
*/
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
/**
* @return BelongsTo<IdentityProvider, $this>
*/
public function provider(): BelongsTo
{
return $this->belongsTo(IdentityProvider::class, 'identity_provider_id');
}
}

View file

@ -0,0 +1,40 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable(['user_id', 'type', 'payload', 'idempotency_key', 'status', 'attempts', 'next_attempt_at', 'reference', 'last_error'])]
class VendorFeedback extends Model
{
public const PENDING = 'pending';
public const SENT = 'sent';
public const DISCARDED = 'discarded';
public const TYPES = [
'bugreport' => 'Fehlerbericht',
'featurerequest' => 'Funktionswunsch',
];
protected $table = 'vendor_feedback';
protected function casts(): array
{
return [
'payload' => 'array',
'next_attempt_at' => 'datetime',
];
}
/**
* @return BelongsTo<User, $this>
*/
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
}

View file

@ -0,0 +1,40 @@
<?php
namespace App\Notifications;
use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
/**
* Benachrichtigung im Portal (Glocke im Header). Kern und Plugins nutzen dieselbe
* Klasse – E-Mail und Push kommen später als weitere Kanäle hinzu.
*
* $user->notify(new PortalNotification('Beitrag freigegeben', '„Sommerfest“ ist online.', '/neuigkeiten/sommerfest', 'check'));
*/
class PortalNotification extends Notification
{
use Queueable;
public function __construct(
public readonly string $title,
public readonly string $body = '',
public readonly ?string $url = null,
public readonly string $icon = 'bell',
) {}
/**
* @return list<string>
*/
public function via(object $notifiable): array
{
return ['database'];
}
/**
* @return array<string, mixed>
*/
public function toArray(object $notifiable): array
{
return ['title' => $this->title, 'body' => $this->body, 'url' => $this->url, 'icon' => $this->icon];
}
}

View file

@ -0,0 +1,94 @@
<?php
namespace App\Pagebuilder;
use App\Models\User;
use Closure;
/**
* Eine Blockart des Pagebuilders.
*
* Container (Abschnitt, Spalten, Tabs, Akkordeon, Box) haben „items“: jeweils
* ein Bereich mit eigener Blockliste, bei Tabs und Akkordeon mit Titel.
*/
final class BlockType
{
/**
* @param list<Field> $fields
* @param array{min: int, max: int, titled: bool, label: string}|null $container
* @param (Closure(array<string, mixed>, User|null, array<string, mixed>): (array<string, mixed>|null))|null $resolve
* Daten für die Anzeige (z. B. Bild-URL, aktuelle Beiträge); null = Block ausblenden
*/
public function __construct(
public readonly string $key,
public readonly string $label,
public readonly string $icon,
public readonly string $group,
public readonly string $component,
public readonly array $fields = [],
public readonly ?array $container = null,
public readonly ?Closure $resolve = null,
public readonly string $description = '',
) {}
public static function make(string $key, string $label, string $icon, string $group, ?string $component = null): self
{
return new self($key, $label, $icon, $group, $component ?? str_replace(' ', '', ucwords(str_replace(['-', '_', '.'], ' ', $key))));
}
/**
* @param list<Field> $fields
*/
public function fields(array $fields): self
{
return new self($this->key, $this->label, $this->icon, $this->group, $this->component, $fields, $this->container, $this->resolve, $this->description);
}
public function container(int $min = 1, int $max = 1, bool $titled = false, string $label = 'Bereich'): self
{
return new self($this->key, $this->label, $this->icon, $this->group, $this->component, $this->fields, ['min' => $min, 'max' => $max, 'titled' => $titled, 'label' => $label], $this->resolve, $this->description);
}
public function resolveUsing(Closure $resolve): self
{
return new self($this->key, $this->label, $this->icon, $this->group, $this->component, $this->fields, $this->container, $resolve, $this->description);
}
public function description(string $description): self
{
return new self($this->key, $this->label, $this->icon, $this->group, $this->component, $this->fields, $this->container, $this->resolve, $description);
}
/**
* @return array<string, mixed>
*/
public function defaults(): array
{
$data = [];
foreach ($this->fields as $field) {
$data[$field->name] = $field->default();
}
return $data;
}
/**
* @return array<string, mixed>
*/
public function toArray(): array
{
return [
'key' => $this->key,
'label' => $this->label,
'icon' => $this->icon,
'group' => $this->group,
'component' => $this->component,
'description' => $this->description,
'fields' => array_map(fn (Field $field) => $field->toArray(), $this->fields),
'container' => $this->container,
'defaults' => $this->defaults(),
'dynamic' => $this->resolve !== null,
];
}
}

239
app/Pagebuilder/Blocks.php Normal file
View file

@ -0,0 +1,239 @@
<?php
namespace App\Pagebuilder;
use App\Http\Resources\PersonResource;
use App\Models\User;
use App\Plugins\Hooks;
use Illuminate\Support\Facades\Storage;
/**
* Registry der Pagebuilder-Blöcke. Der Kern bringt Layout- und Inhaltsblöcke
* mit, Plugins tragen eigene ein (z. B. „Neueste Beiträge“):
*
* app(Blocks::class)->add(BlockType::make('news.latest', 'Neuigkeiten', 'newspaper', 'dynamic', 'news::LatestBlock')
* ->fields([...])->resolveUsing(fn (array $data, ?User $user) => [...]));
*
* Vue-Komponenten liegen unter resources/js/pagebuilder/blocks/<Komponente>.vue
* bzw. plugins-core/<slug>/resources/js/blocks/<Name>.vue („slug::Name“).
*/
class Blocks
{
public const GROUPS = [
'layout' => 'Layout',
'content' => 'Inhalt',
'media' => 'Medien',
'dynamic' => 'Dynamisch',
];
/** @var array<string, BlockType> */
private array $types = [];
public function __construct()
{
$this->registerLayout();
$this->registerContent();
}
public function add(BlockType $type): void
{
$this->types[$type->key] = $type;
}
public function remove(string $key): void
{
unset($this->types[$key]);
}
public function get(string $key): ?BlockType
{
return $this->types[$key] ?? null;
}
/**
* @return array<string, BlockType>
*/
public function all(): array
{
return Hooks::apply('pagebuilder.blocks', $this->types);
}
/**
* @return list<array<string, mixed>>
*/
public function forEditor(): array
{
return array_values(array_map(fn (BlockType $type) => $type->toArray(), $this->all()));
}
public static function imageUrl(?string $path): ?string
{
return $path ? Storage::disk('uploads')->url($path) : null;
}
private function registerLayout(): void
{
$backgrounds = ['none' => 'Ohne', 'muted' => 'Grau', 'card' => 'Weiß mit Rahmen', 'brand-soft' => 'Markenfarbe hell', 'brand' => 'Markenfarbe'];
$this->add(BlockType::make('section', 'Abschnitt', 'square-dashed', 'layout')
->description('Fasst Blöcke zusammen, optional mit Hintergrund.')
->container()
->fields([
Field::select('background', 'Hintergrund', $backgrounds, 'none'),
Field::select('padding', 'Innenabstand', ['none' => 'Ohne', 'normal' => 'Normal', 'large' => 'Groß'], 'normal'),
]));
$this->add(BlockType::make('columns', 'Spalten', 'columns-3', 'layout')
->description('Zwei bis vier Spalten nebeneinander.')
->container(1, 4, label: 'Spalte')
->fields([
Field::select('layout', 'Aufteilung', [
'1-1' => '2 Spalten (1:1)',
'2-1' => '2 Spalten (2:1)',
'1-2' => '2 Spalten (1:2)',
'1-1-1' => '3 Spalten',
'1-2-1' => '3 Spalten (1:2:1)',
'1-1-1-1' => '4 Spalten',
], '1-1'),
Field::select('stack', 'Untereinander auf', ['sm' => 'Smartphones', 'md' => 'Tablets und Smartphones', 'lg' => 'Kleinen Bildschirmen'], 'md'),
Field::select('gap', 'Abstand', ['small' => 'Klein', 'normal' => 'Normal', 'large' => 'Groß'], 'normal'),
Field::select('align', 'Vertikal ausrichten', ['start' => 'Oben', 'center' => 'Mitte', 'stretch' => 'Gleiche Höhe'], 'start'),
]));
$this->add(BlockType::make('tabs', 'Tabs', 'panel-top', 'layout')
->description('Inhalte auf Reiter verteilt.')
->container(1, 12, titled: true, label: 'Tab'));
$this->add(BlockType::make('accordion', 'Akkordeon', 'list-collapse', 'layout')
->description('Aufklappbare Abschnitte, z. B. für häufige Fragen.')
->container(1, 30, titled: true, label: 'Abschnitt')
->fields([
Field::toggle('first_open', 'Ersten Abschnitt geöffnet anzeigen'),
Field::toggle('multiple', 'Mehrere gleichzeitig öffnen'),
]));
$this->add(BlockType::make('box', 'Box', 'message-square-warning', 'layout')
->description('Hervorgehobener Kasten: Info, Hinweis, Warnung …')
->container()
->fields([
Field::select('variant', 'Art', [
'info' => 'Info',
'note' => 'Hinweis',
'warning' => 'Warnung',
'success' => 'Erfolg',
'neutral' => 'Neutral',
'highlight' => 'Hervorgehoben',
], 'info'),
Field::text('title', 'Überschrift', 150),
Field::toggle('show_icon', 'Symbol anzeigen', true),
]));
}
private function registerContent(): void
{
$this->add(BlockType::make('heading', 'Überschrift', 'heading', 'content')
->fields([
Field::text('text', 'Text', 200, placeholder: 'Überschrift'),
Field::select('level', 'Größe', ['2' => 'Groß (H2)', '3' => 'Mittel (H3)', '4' => 'Klein (H4)'], '2'),
Field::select('align', 'Ausrichtung', ['left' => 'Links', 'center' => 'Zentriert'], 'left'),
]));
$this->add(BlockType::make('text', 'Text', 'text', 'content')
->description('Absätze, Listen, Links und Hervorhebungen.')
->fields([Field::html('html', 'Text')]));
$this->add(BlockType::make('quote', 'Zitat', 'quote', 'content')
->fields([
Field::textarea('text', 'Zitat', 1000),
Field::text('source', 'Quelle', 150),
]));
$this->add(BlockType::make('buttons', 'Schaltflächen', 'mouse-pointer-click', 'content')
->fields([
Field::repeater('buttons', 'Schaltflächen', [
Field::text('label', 'Beschriftung', 80),
Field::url('url', 'Link'),
Field::select('variant', 'Darstellung', ['primary' => 'Markenfarbe', 'outline' => 'Umrandet', 'link' => 'Als Link'], 'primary'),
Field::toggle('new_tab', 'In neuem Tab öffnen'),
], 6, 'Schaltfläche'),
Field::select('align', 'Ausrichtung', ['left' => 'Links', 'center' => 'Zentriert'], 'left'),
]));
$this->add(BlockType::make('icon-list', 'Symbolliste', 'list-checks', 'content')
->fields([
Field::repeater('items', 'Einträge', [
Field::icon('icon', 'Symbol'),
Field::text('title', 'Titel', 120),
Field::textarea('text', 'Text', 500),
Field::url('url', 'Link'),
], 30, 'Eintrag'),
Field::select('layout', 'Darstellung', ['list' => 'Liste', 'grid' => 'Kacheln'], 'list'),
]));
$this->add(BlockType::make('table', 'Tabelle', 'table', 'content')
->fields([
Field::table('rows', 'Tabelle'),
Field::toggle('header', 'Erste Zeile als Kopfzeile', true),
Field::text('caption', 'Beschriftung', 200),
]));
$this->add(BlockType::make('divider', 'Trennlinie', 'minus', 'content'));
$this->add(BlockType::make('spacer', 'Abstand', 'move-vertical', 'content')
->fields([Field::select('size', 'Höhe', ['small' => 'Klein', 'medium' => 'Mittel', 'large' => 'Groß'], 'medium')]));
$this->add(BlockType::make('image', 'Bild', 'image', 'media')
->fields([
Field::image('path', 'Bild'),
Field::text('alt', 'Alternativtext', 200)->help('Beschreibt das Bild für Screenreader.'),
Field::text('caption', 'Bildunterschrift', 300),
Field::select('size', 'Breite', ['full' => 'Volle Breite', 'medium' => 'Mittel', 'small' => 'Klein'], 'full'),
Field::url('url', 'Link beim Anklicken'),
])
->resolveUsing(fn (array $data) => ['url' => self::imageUrl($data['path'])]));
$this->add(BlockType::make('gallery', 'Galerie', 'images', 'media')
->fields([
Field::repeater('images', 'Bilder', [
Field::image('path', 'Bild'),
Field::text('alt', 'Alternativtext', 200),
Field::text('caption', 'Bildunterschrift', 300),
], 60, 'Bild'),
Field::select('columns', 'Spalten', ['2' => '2', '3' => '3', '4' => '4'], '3'),
])
->resolveUsing(fn (array $data) => ['urls' => array_map(fn ($image) => self::imageUrl($image['path'] ?? null), $data['images'])]));
$this->add(BlockType::make('video', 'Video', 'play', 'media')
->description('YouTube, Vimeo oder MP4-Datei. Externe Videos laden erst nach Klick.')
->fields([
Field::url('url', 'Adresse des Videos'),
Field::text('title', 'Titel', 200),
])
->resolveUsing(fn (array $data) => ['embed' => VideoEmbed::from($data['url'])]));
$this->add(BlockType::make('hero', 'Titelbild mit Text', 'panorama', 'media')
->fields([
Field::image('path', 'Hintergrundbild'),
Field::text('title', 'Titel', 150),
Field::textarea('text', 'Text', 400),
Field::text('button_label', 'Beschriftung der Schaltfläche', 80),
Field::url('button_url', 'Link der Schaltfläche'),
Field::select('height', 'Höhe', ['small' => 'Niedrig', 'medium' => 'Mittel', 'large' => 'Hoch'], 'medium'),
])
->resolveUsing(fn (array $data) => ['url' => self::imageUrl($data['path'])]));
$this->add(BlockType::make('contacts', 'Ansprechpartner', 'contact', 'dynamic')
->description('Personen aus dem Verzeichnis – immer mit aktuellen Kontaktdaten.')
->fields([
Field::text('title', 'Überschrift', 150),
Field::people('people', 'Personen'),
Field::select('layout', 'Darstellung', ['cards' => 'Karten', 'list' => 'Liste'], 'cards'),
])
->resolveUsing(function (array $data) {
$people = User::query()->active()->whereIn('id', $data['people'])->get()
->sortBy(fn (User $user) => array_search($user->id, $data['people'], true))->values();
return ['people' => PersonResource::collection($people)->resolve()];
}));
}
}

292
app/Pagebuilder/Content.php Normal file
View file

@ -0,0 +1,292 @@
<?php
namespace App\Pagebuilder;
use App\Models\User;
use App\Support\Permissions\Audiences;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use Throwable;
/**
* Inhalt einer Seite: ein Baum aus Blöcken.
*
* {"blocks": [{"id": "…", "type": "columns", "data": {…}, "visibility": {…},
* "items": [{"id": "…", "title": "…", "blocks": [ … ]}]}]}
*
* sanitize() läuft beim Speichern: unbekannte Blöcke und Felder fallen weg,
* HTML wird bereinigt, Adressen geprüft. render() läuft bei der Anzeige:
* blendet Blöcke nach Sichtbarkeit aus und ergänzt dynamische Daten.
*/
class Content
{
public const MAX_DEPTH = 6;
public const MAX_BLOCKS = 800;
private int $count = 0;
public function __construct(private readonly Blocks $blocks) {}
/**
* @return array{blocks: list<array<string, mixed>>}
*/
public static function empty(): array
{
return ['blocks' => []];
}
/**
* @param array<mixed>|null $content
* @return array{blocks: list<array<string, mixed>>}
*/
public function sanitize(?array $content): array
{
$this->count = 0;
return ['blocks' => $this->sanitizeList($content['blocks'] ?? [], 1)];
}
/**
* Anzeigefertiger Inhalt für eine Person.
*
* @param array<mixed>|null $content bereits bereinigter Inhalt
* @return array{blocks: list<array<string, mixed>>}
*/
public function render(?array $content, ?User $user, array $context = []): array
{
return ['blocks' => $this->renderList($content['blocks'] ?? [], $user, $context)];
}
/**
* Ein einzelner Block (Editor-Vorschau dynamischer Blöcke).
*
* @param array<mixed> $block
* @return array<string, mixed>|null
*/
public function preview(array $block, ?User $user, array $context = []): ?array
{
$this->count = 0;
$clean = $this->sanitizeList([$block], 1)[0] ?? null;
if (! $clean) {
return null;
}
$type = $this->blocks->get($clean['type']);
return $type?->resolve ? $this->resolve($type, $clean, $user, $context) : [];
}
/**
* Alle Werte eines Feldtyps im Baum, z. B. alle Bildpfade (für Aufräumarbeiten).
*
* @param array<mixed>|null $content
* @return list<mixed>
*/
public function collect(?array $content, callable $picker): array
{
$result = [];
$walk = function (array $blocks) use (&$walk, &$result, $picker) {
foreach ($blocks as $block) {
array_push($result, ...(array) $picker($block));
foreach ($block['items'] ?? [] as $item) {
$walk($item['blocks'] ?? []);
}
}
};
$walk($content['blocks'] ?? []);
return $result;
}
/**
* Reiner Text des Inhalts, z. B. für die Suche.
*
* @param array<mixed>|null $content
*/
public function plainText(?array $content): string
{
$parts = $this->collect($content, function (array $block) {
$texts = [];
array_walk_recursive($block['data'], function ($value) use (&$texts) {
if (is_string($value) && ! str_starts_with($value, 'pagebuilder/')) {
$texts[] = strip_tags($value);
}
});
foreach ($block['items'] ?? [] as $item) {
$texts[] = $item['title'] ?? '';
}
return [implode(' ', $texts)];
});
return trim(preg_replace('/\s+/u', ' ', html_entity_decode(implode(' ', $parts))) ?? '');
}
/**
* @return list<array<string, mixed>>
*/
private function sanitizeList(mixed $blocks, int $depth): array
{
if (! is_array($blocks) || $depth > self::MAX_DEPTH) {
return [];
}
$result = [];
foreach (array_values($blocks) as $block) {
if (! is_array($block) || ++$this->count > self::MAX_BLOCKS) {
continue;
}
$type = $this->blocks->get((string) ($block['type'] ?? ''));
if (! $type) {
continue;
}
$data = is_array($block['data'] ?? null) ? $block['data'] : [];
$clean = [
'id' => self::id($block['id'] ?? null),
'type' => $type->key,
'data' => [],
];
foreach ($type->fields as $field) {
$clean['data'][$field->name] = $field->sanitize(array_key_exists($field->name, $data) ? $data[$field->name] : $field->default());
}
$visibility = $this->sanitizeVisibility($block['visibility'] ?? null);
if ($visibility !== null) {
$clean['visibility'] = $visibility;
}
if ($type->container) {
$clean['items'] = $this->sanitizeItems($type, $clean['data'], $block['items'] ?? [], $depth);
}
$result[] = $clean;
}
return $result;
}
/**
* @param array<string, mixed> $data
* @return list<array<string, mixed>>
*/
private function sanitizeItems(BlockType $type, array $data, mixed $items, int $depth): array
{
$items = is_array($items) ? array_values(array_filter($items, 'is_array')) : [];
$container = $type->container;
// Spalten: Anzahl folgt der Aufteilung. Überzählige Spalten werden an die letzte angehängt, nichts geht verloren.
$count = $type->key === 'columns'
? count(explode('-', (string) ($data['layout'] ?? '1-1')))
: max($container['min'], min($container['max'], count($items)));
if (count($items) > $count && $count > 0) {
$overflow = array_merge(...array_map(fn ($item) => (array) ($item['blocks'] ?? []), array_slice($items, $count)));
$items = array_slice($items, 0, $count);
$items[$count - 1]['blocks'] = array_merge((array) ($items[$count - 1]['blocks'] ?? []), $overflow);
}
$items = array_pad($items, $count, []);
return array_map(fn (array $item) => array_filter([
'id' => self::id($item['id'] ?? null),
'title' => $container['titled'] ? mb_substr(trim((string) ($item['title'] ?? '')), 0, 120) : null,
'blocks' => $this->sanitizeList($item['blocks'] ?? [], $depth + 1),
], fn ($value) => $value !== null), $items);
}
/**
* @return array{role?: list<string>, department?: list<string>, location?: list<string>}|null
*/
private function sanitizeVisibility(mixed $visibility): ?array
{
if (! is_array($visibility)) {
return null;
}
$clean = [];
foreach (['role', 'department', 'location'] as $rule) {
$values = array_values(array_unique(array_filter(array_map(
fn ($value) => is_scalar($value) ? mb_substr(trim((string) $value), 0, 150) : '',
(array) ($visibility[$rule] ?? []),
))));
if ($values !== []) {
$clean[$rule] = array_slice($values, 0, 50);
}
}
return $clean === [] ? null : $clean;
}
/**
* @param list<array<string, mixed>> $blocks
* @return list<array<string, mixed>>
*/
private function renderList(array $blocks, ?User $user, array $context): array
{
$result = [];
foreach ($blocks as $block) {
$type = $this->blocks->get($block['type'] ?? '');
// Blöcke deaktivierter Plugins und fremde Zielgruppen einfach auslassen.
if (! $type || ! Audiences::matches($block['visibility'] ?? null, $user)) {
continue;
}
if ($type->resolve) {
$props = $this->resolve($type, $block, $user, $context);
if ($props === null) {
continue;
}
$block['props'] = $props;
}
unset($block['visibility']);
$block['component'] = $type->component;
if (isset($block['items'])) {
$block['items'] = array_map(fn (array $item) => [...$item, 'blocks' => $this->renderList($item['blocks'] ?? [], $user, $context)], $block['items']);
}
$result[] = $block;
}
return $result;
}
/**
* @param array<string, mixed> $block
* @return array<string, mixed>|null
*/
private function resolve(BlockType $type, array $block, ?User $user, array $context): ?array
{
try {
return ($type->resolve)($block['data'], $user, $context);
} catch (Throwable $e) {
// Ein fehlerhafter Plugin-Block darf die Seite nicht mitreißen.
Log::warning("Pagebuilder-Block {$type->key} konnte nicht geladen werden: ".$e->getMessage());
return null;
}
}
private static function id(mixed $id): string
{
return is_string($id) && preg_match('/^[A-Za-z0-9_-]{4,40}$/', $id) ? $id : Str::random(12);
}
}

209
app/Pagebuilder/Field.php Normal file
View file

@ -0,0 +1,209 @@
<?php
namespace App\Pagebuilder;
use App\Support\QuickLinks;
use App\Support\RichText;
use Closure;
/**
* Ein Eingabefeld eines Blocks. Beschreibt zugleich das Formular im Editor
* (toArray) und die Bereinigung beim Speichern (sanitize) – Plugin-Blöcke
* bekommen so Editor und Absicherung ohne eigenen Code.
*/
final class Field
{
/**
* @param array<string, mixed> $options
*/
private function __construct(
public readonly string $name,
public readonly string $type,
public readonly string $label,
private readonly array $options = [],
) {}
public static function text(string $name, string $label, int $max = 200, string $default = '', ?string $placeholder = null): self
{
return new self($name, 'text', $label, ['max' => $max, 'default' => $default, 'placeholder' => $placeholder]);
}
public static function textarea(string $name, string $label, int $max = 2000, string $default = ''): self
{
return new self($name, 'textarea', $label, ['max' => $max, 'default' => $default]);
}
/** Formatierter Text – im Editor direkt im Block bearbeitet (TipTap). */
public static function html(string $name, string $label): self
{
return new self($name, 'html', $label, ['default' => '']);
}
/**
* @param array<string, string>|Closure(): array<string, string> $choices
*/
public static function select(string $name, string $label, array|Closure $choices, ?string $default = null): self
{
return new self($name, 'select', $label, ['choices' => $choices, 'default' => $default]);
}
public static function toggle(string $name, string $label, bool $default = false): self
{
return new self($name, 'toggle', $label, ['default' => $default]);
}
public static function number(string $name, string $label, int $min, int $max, int $default): self
{
return new self($name, 'number', $label, ['min' => $min, 'max' => $max, 'default' => $default]);
}
public static function url(string $name, string $label, string $default = ''): self
{
return new self($name, 'url', $label, ['default' => $default]);
}
/** Hochgeladenes Bild (Pfad im Upload-Speicher). */
public static function image(string $name, string $label): self
{
return new self($name, 'image', $label, ['default' => null]);
}
/** Personen aus dem Verzeichnis (IDs). */
public static function people(string $name, string $label, int $max = 24): self
{
return new self($name, 'people', $label, ['max' => $max, 'default' => []]);
}
/** Einfache Tabelle: Zeilen aus Textzellen. */
public static function table(string $name, string $label): self
{
return new self($name, 'table', $label, ['default' => [['', ''], ['', '']]]);
}
/** Symbol aus dem Symbolsatz der Schnellzugriffe. */
public static function icon(string $name, string $label, string $default = 'link'): self
{
return new self($name, 'icon', $label, ['default' => $default, 'choices' => QuickLinks::ICONS]);
}
/** Liste gleichartiger Einträge, z. B. Schaltflächen oder Galeriebilder. */
public static function repeater(string $name, string $label, array $fields, int $max = 20, string $itemLabel = 'Eintrag'): self
{
return new self($name, 'repeater', $label, ['fields' => $fields, 'max' => $max, 'default' => [], 'itemLabel' => $itemLabel]);
}
/** Beliebige Liste von IDs, deren Einträge der Block selbst verwaltet (z. B. Dateien). */
public static function ids(string $name, string $label, string $kind, int $max = 50): self
{
return new self($name, 'ids', $label, ['kind' => $kind, 'max' => $max, 'default' => []]);
}
public function default(): mixed
{
if ($this->type === 'repeater') {
return [];
}
return $this->options['default'] ?? null;
}
public function help(string $help): self
{
return new self($this->name, $this->type, $this->label, [...$this->options, 'help' => $help]);
}
/**
* @return array<string, mixed> Beschreibung für das Editor-Formular
*/
public function toArray(): array
{
$options = $this->options;
if (isset($options['choices'])) {
$choices = $options['choices'] instanceof Closure ? ($options['choices'])() : $options['choices'];
$options['choices'] = collect($choices)->map(fn ($label, $value) => ['value' => (string) $value, 'label' => $label])->values()->all();
}
if (isset($options['fields'])) {
$options['fields'] = array_map(fn (Field $field) => $field->toArray(), $options['fields']);
}
return ['name' => $this->name, 'type' => $this->type, 'label' => $this->label, ...$options];
}
public function sanitize(mixed $value): mixed
{
return match ($this->type) {
'text', 'textarea' => mb_substr(trim(is_scalar($value) ? (string) $value : ''), 0, $this->options['max']),
'html' => app(RichText::class)->sanitize(is_string($value) ? mb_substr($value, 0, 200_000) : ''),
'select' => $this->sanitizeChoice($value),
'toggle' => (bool) $value,
'number' => max($this->options['min'], min($this->options['max'], is_numeric($value) ? (int) $value : $this->options['default'])),
'url' => self::safeUrl($value),
'image' => is_string($value) && preg_match('#^pagebuilder/[A-Za-z0-9/_.-]+$#', $value) && ! str_contains($value, '..') ? $value : null,
'people', 'ids' => array_values(array_slice(array_unique(array_filter(array_map('intval', is_array($value) ? $value : []))), 0, $this->options['max'])),
'table' => $this->sanitizeTable($value),
'icon' => is_string($value) && array_key_exists($value, QuickLinks::ICONS) ? $value : $this->options['default'],
'repeater' => $this->sanitizeRepeater($value),
default => null,
};
}
public static function safeUrl(mixed $value): string
{
$url = trim(is_string($value) ? $value : '');
if ($url === '' || mb_strlen($url) > 2000) {
return '';
}
// Relative Adressen im Portal, Anker oder http(s)/mailto/tel – nichts anderes (kein javascript:).
if (preg_match('#^(/(?!/)|\#)#', $url) || preg_match('#^(https?://|mailto:|tel:)#i', $url)) {
return $url;
}
return preg_match('#^[a-z0-9.-]+\.[a-z]{2,}(/|$)#i', $url) ? 'https://'.$url : '';
}
private function sanitizeChoice(mixed $value): ?string
{
$choices = $this->options['choices'] instanceof Closure ? ($this->options['choices'])() : $this->options['choices'];
$value = is_scalar($value) ? (string) $value : null;
return $value !== null && array_key_exists($value, $choices) ? $value : $this->options['default'];
}
/**
* @return list<list<string>>
*/
private function sanitizeTable(mixed $value): array
{
$rows = array_slice(is_array($value) ? array_values($value) : [], 0, 100);
$width = min(10, max(1, ...array_map(fn ($row) => is_array($row) ? count($row) : 1, $rows ?: [[]])));
return array_map(function ($row) use ($width) {
$cells = array_slice(is_array($row) ? array_values($row) : [], 0, $width);
return array_pad(array_map(fn ($cell) => mb_substr(is_scalar($cell) ? (string) $cell : '', 0, 1000), $cells), $width, '');
}, $rows);
}
/**
* @return list<array<string, mixed>>
*/
private function sanitizeRepeater(mixed $value): array
{
$items = array_slice(is_array($value) ? array_values($value) : [], 0, $this->options['max']);
return array_map(function ($item) {
$item = is_array($item) ? $item : [];
$clean = [];
foreach ($this->options['fields'] as $field) {
$clean[$field->name] = $field->sanitize($item[$field->name] ?? $field->default());
}
return $clean;
}, $items);
}
}

View file

@ -0,0 +1,34 @@
<?php
namespace App\Pagebuilder;
/**
* Wandelt Video-Adressen in datenschutzfreundliche Einbettungen um.
* YouTube über youtube-nocookie.com; geladen wird erst nach einem Klick.
*/
final class VideoEmbed
{
/**
* @return array{provider: string, src: string}|null
*/
public static function from(string $url): ?array
{
if ($url === '') {
return null;
}
if (preg_match('~(?:youtube\.com/(?:watch\?(?:.*&)?v=|embed/|shorts/)|youtu\.be/)([A-Za-z0-9_-]{11})~', $url, $m)) {
return ['provider' => 'YouTube', 'src' => 'https://www.youtube-nocookie.com/embed/'.$m[1].'?rel=0'];
}
if (preg_match('~vimeo\.com/(?:video/)?(\d+)~', $url, $m)) {
return ['provider' => 'Vimeo', 'src' => 'https://player.vimeo.com/video/'.$m[1].'?dnt=1'];
}
if (preg_match('~\.(mp4|webm)(\?.*)?$~i', $url)) {
return ['provider' => 'file', 'src' => $url];
}
return null;
}
}

67
app/Plugins/Hooks.php Normal file
View file

@ -0,0 +1,67 @@
<?php
namespace App\Plugins;
/**
* Actions und Filter nach WordPress-Vorbild.
*
* Hooks::on('post.published', fn (NewsPost $post) => …); // Action
* Hooks::do('post.published', $post);
*
* Hooks::filter('navigation.items', fn (array $items) => [...]); // Filter
* $items = Hooks::apply('navigation.items', $items);
*
* Niedrigere Priorität läuft zuerst (Standard 10).
*/
class Hooks
{
/** @var array<string, array<int, list<callable>>> */
private array $actions = [];
/** @var array<string, array<int, list<callable>>> */
private array $filters = [];
public static function on(string $name, callable $callback, int $priority = 10): void
{
app(self::class)->actions[$name][$priority][] = $callback;
}
public static function do(string $name, mixed ...$arguments): void
{
foreach (app(self::class)->sorted(app(self::class)->actions[$name] ?? []) as $callback) {
$callback(...$arguments);
}
}
public static function filter(string $name, callable $callback, int $priority = 10): void
{
app(self::class)->filters[$name][$priority][] = $callback;
}
public static function apply(string $name, mixed $value, mixed ...$arguments): mixed
{
foreach (app(self::class)->sorted(app(self::class)->filters[$name] ?? []) as $callback) {
$value = $callback($value, ...$arguments);
}
return $value;
}
public static function has(string $name): bool
{
$hooks = app(self::class);
return ! empty($hooks->actions[$name]) || ! empty($hooks->filters[$name]);
}
/**
* @param array<int, list<callable>> $byPriority
* @return list<callable>
*/
private function sorted(array $byPriority): array
{
ksort($byPriority);
return array_merge(...array_values($byPriority) ?: [[]]);
}
}

39
app/Plugins/Plugin.php Normal file
View file

@ -0,0 +1,39 @@
<?php
namespace App\Plugins;
use Illuminate\Contracts\Foundation\Application;
/**
* Basisklasse für Plugins – mitgelieferte wie vom Kunden installierte.
*
* register(): Dienste binden, Navigation/Kacheln/Rechte registrieren (früh, vor boot).
* boot(): Hooks, Routen, Views – alles, was andere Dienste braucht.
* activate()/deactivate()/uninstall(): Lebenszyklus, vom Admin ausgelöst.
*/
abstract class Plugin
{
public function __construct(
protected readonly Application $app,
public readonly PluginManifest $manifest,
) {}
public function register(): void {}
public function boot(): void {}
public function activate(): void {}
public function deactivate(): void {}
/**
* Beim Löschen mit „Daten entfernen“. Die Tabellen aus den Migrationen des
* Plugins entfernt der Kern selbst.
*/
public function uninstall(): void {}
protected function path(string $path = ''): string
{
return $this->manifest->path.($path !== '' ? '/'.ltrim($path, '/') : '');
}
}

View file

@ -0,0 +1,75 @@
<?php
namespace App\Plugins;
use App\Support\Audit;
use App\Support\Update\Filesystem;
use App\Support\Update\ZipExtractor;
use RuntimeException;
use Throwable;
/**
* Installiert Kunden-Plugins aus einem ZIP-Archiv nach plugins/<slug>.
* Nutzt denselben ZIP-Slip-Schutz wie der Self-Updater. Ein vorhandenes Plugin
* mit gleichem Kürzel wird ersetzt (Update), seine Daten bleiben erhalten.
*/
class PluginInstaller
{
public function __construct(
private readonly PluginManager $plugins,
private readonly ZipExtractor $extractor,
) {}
public static function uploadsAllowed(): bool
{
return ! filter_var(config('inhaus.disallow_file_mods'), FILTER_VALIDATE_BOOL);
}
public function install(string $zipFile): PluginManifest
{
if (! self::uploadsAllowed()) {
throw new RuntimeException('Das Installieren von Plugins ist in dieser Installation abgeschaltet.');
}
$staging = storage_path('framework/plugin-upload-'.bin2hex(random_bytes(4)));
try {
$this->extractor->extract($zipFile, $staging);
try {
$manifest = PluginManifest::fromDirectory($staging, core: false);
} catch (Throwable $e) {
throw new RuntimeException('Das Archiv enthält kein gültiges Plugin: '.$e->getMessage());
}
$existing = $this->plugins->find($manifest->slug);
if ($existing?->core) {
throw new RuntimeException("Das Kürzel „{$manifest->slug}“ gehört zu einem mitgelieferten Plugin.");
}
if (! is_file($staging.'/src/'.str_replace('\\', '/', substr($manifest->class, strlen($manifest->namespace))).'.php')) {
throw new RuntimeException("Die Plugin-Klasse {$manifest->class} fehlt im Archiv (erwartet unter src/).");
}
$target = $this->plugins->customerPath().'/'.$manifest->slug;
if (! is_dir(dirname($target)) && ! @mkdir(dirname($target), 0775, true)) {
throw new RuntimeException('Das Verzeichnis plugins/ ist nicht beschreibbar.');
}
Filesystem::deleteDirectory($target);
if (! Filesystem::moveDirectory($staging, $target)) {
throw new RuntimeException('Das Plugin konnte nicht nach plugins/ verschoben werden. Bitte Schreibrechte prüfen.');
}
$this->plugins->forgetDiscovered();
Audit::log($existing ? 'plugin.updated' : 'plugin.installed', ['plugin' => $manifest->slug, 'version' => $manifest->version]);
return PluginManifest::fromDirectory($target, core: false);
} finally {
Filesystem::deleteDirectory($staging);
}
}
}

View file

@ -0,0 +1,411 @@
<?php
namespace App\Plugins;
use App\Support\Audit;
use App\Support\Update\Filesystem;
use Illuminate\Contracts\Foundation\Application;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Route;
use RuntimeException;
use Throwable;
/**
* Findet, lädt und verwaltet Plugins.
*
* plugins-core/<slug>/ mitgeliefert (Teil jedes Updates)
* plugins/<slug>/ vom Kunden installiert (geschützt, Updates lassen sie in Ruhe)
*
* Wiederherstellungsmodus: Vor dem Laden eines Plugins wird eine Markierung
* geschrieben und danach entfernt. Bleibt sie liegen, ist der Prozess beim
* Laden abgestürzt (Fatal Error) – das Plugin wird beim nächsten Aufruf
* deaktiviert, das Portal bleibt erreichbar. Ausnahmen führen sofort dazu.
*/
class PluginManager
{
/** Ab diesem Alter gilt eine liegengebliebene Lade-Markierung als Absturz. */
private const CRASH_AFTER_SECONDS = 30;
/** @var array<string, PluginManifest>|null */
private ?array $manifests = null;
/** @var array<string, Plugin> */
private array $loaded = [];
/** @var array<string, string> Slug => Grund */
private array $problems = [];
/** @var array<string, bool> */
private array $autoloaded = [];
public function __construct(
private readonly Application $app,
private readonly PluginState $state,
private readonly ?string $corePath = null,
private readonly ?string $customerPath = null,
) {}
/**
* @return array<string, PluginManifest>
*/
public function all(): array
{
if ($this->manifests !== null) {
return $this->manifests;
}
$this->manifests = [];
foreach ([[$this->corePath(), true], [$this->customerPath(), false]] as [$directory, $core]) {
foreach (glob($directory.'/*/plugin.json') ?: [] as $file) {
try {
$manifest = PluginManifest::fromDirectory(dirname($file), $core);
} catch (Throwable $e) {
$this->problems[basename(dirname($file))] = $e->getMessage();
continue;
}
if (isset($this->manifests[$manifest->slug])) {
$this->problems[$manifest->slug] = 'Ein Plugin mit diesem Kürzel ist bereits vorhanden.';
continue;
}
$this->manifests[$manifest->slug] = $manifest;
}
}
ksort($this->manifests);
return $this->manifests;
}
public function find(string $slug): ?PluginManifest
{
return $this->all()[$slug] ?? null;
}
public function isEnabled(string $slug): bool
{
$manifest = $this->find($slug);
return $manifest !== null && $this->state->isEnabled($manifest);
}
public function isLoaded(string $slug): bool
{
return isset($this->loaded[$slug]);
}
/**
* @return array<string, Plugin>
*/
public function loaded(): array
{
return $this->loaded;
}
public function problem(string $slug): ?string
{
return $this->problems[$slug] ?? $this->state->disabledReason($slug);
}
/**
* Aktive, lauffähige Plugins in Abhängigkeitsreihenfolge.
*
* @return list<PluginManifest>
*/
public function bootOrder(): array
{
$candidates = array_filter($this->all(), fn (PluginManifest $m) => $this->state->isEnabled($m));
$ordered = [];
$visiting = [];
$visit = function (PluginManifest $manifest) use (&$visit, &$ordered, &$visiting, $candidates): bool {
if (isset($ordered[$manifest->slug])) {
return true;
}
if (isset($visiting[$manifest->slug]) || $manifest->incompatibilities() !== []) {
$this->problems[$manifest->slug] ??= implode(', ', $manifest->incompatibilities()) ?: 'Zirkuläre Abhängigkeit.';
return false;
}
$visiting[$manifest->slug] = true;
foreach ($manifest->requiredPlugins() as $dependency) {
if (! isset($candidates[$dependency]) || ! $visit($candidates[$dependency])) {
$this->problems[$manifest->slug] ??= "benötigt das Plugin „{$dependency}“";
unset($visiting[$manifest->slug]);
return false;
}
}
unset($visiting[$manifest->slug]);
$ordered[$manifest->slug] = $manifest;
return true;
};
foreach ($candidates as $manifest) {
$visit($manifest);
}
return array_values($ordered);
}
/**
* Phase 1: Autoload und register() aller aktiven Plugins.
*/
public function registerAll(): void
{
$this->recoverFromCrash();
foreach ($this->bootOrder() as $manifest) {
$this->guard($manifest, function () use ($manifest) {
$this->registerAutoload($manifest);
$plugin = $this->instantiate($manifest);
$plugin->register();
$this->loaded[$manifest->slug] = $plugin;
});
}
}
/**
* Phase 2: Migrationen, Views, Routen und boot().
*/
public function bootAll(): void
{
foreach ($this->loaded as $slug => $plugin) {
$manifest = $plugin->manifest;
$this->guard($manifest, function () use ($plugin, $manifest) {
if (is_dir($manifest->migrationsPath())) {
$this->app['migrator']->path($manifest->migrationsPath());
}
if (is_dir($manifest->path.'/resources/views')) {
$this->app['view']->addNamespace($manifest->slug, $manifest->path.'/resources/views');
}
if (is_file($manifest->path.'/routes/web.php') && ! $this->app->routesAreCached()) {
Route::middleware('web')->group($manifest->path.'/routes/web.php');
}
$plugin->boot();
});
}
}
public function activate(string $slug): void
{
$manifest = $this->find($slug) ?? throw new RuntimeException('Plugin nicht gefunden.');
if ($problems = $manifest->incompatibilities()) {
throw new RuntimeException('Das Plugin kann nicht aktiviert werden: '.implode(', ', $problems).'.');
}
foreach ($manifest->requiredPlugins() as $dependency) {
if (! $this->isEnabled($dependency)) {
throw new RuntimeException("Bitte zuerst das Plugin „{$dependency}“ aktivieren.");
}
}
$this->registerAutoload($manifest);
if (is_dir($manifest->migrationsPath())) {
Artisan::call('migrate', ['--path' => $manifest->migrationsPath(), '--realpath' => true, '--force' => true]);
}
$this->instantiate($manifest)->activate();
$this->state->setEnabled($slug, true);
Audit::log('plugin.activated', ['plugin' => $slug, 'version' => $manifest->version]);
}
public function deactivate(string $slug, ?string $reason = null): void
{
$manifest = $this->find($slug) ?? throw new RuntimeException('Plugin nicht gefunden.');
if ($reason === null && ($dependents = $this->dependents($slug)) !== []) {
throw new RuntimeException('Wird noch benötigt von: '.implode(', ', $dependents).'.');
}
if ($reason === null && isset($this->loaded[$slug])) {
$this->loaded[$slug]->deactivate();
}
$this->state->setEnabled($slug, false, $reason);
Audit::log('plugin.deactivated', ['plugin' => $slug, 'reason' => $reason]);
}
/**
* Kunden-Plugin löschen, optional samt Daten (Tabellen aus den Migrationen).
*/
public function delete(string $slug, bool $removeData): void
{
$manifest = $this->find($slug) ?? throw new RuntimeException('Plugin nicht gefunden.');
if ($manifest->core) {
throw new RuntimeException('Mitgelieferte Plugins können nur deaktiviert werden.');
}
if ($this->isEnabled($slug)) {
$this->deactivate($slug);
}
if ($removeData) {
$this->registerAutoload($manifest);
$this->instantiate($manifest)->uninstall();
if (is_dir($manifest->migrationsPath())) {
Artisan::call('migrate:reset', ['--path' => $manifest->migrationsPath(), '--realpath' => true, '--force' => true]);
}
}
Filesystem::deleteDirectory($manifest->path);
$this->state->forget($slug);
$this->manifests = null;
Audit::log('plugin.deleted', ['plugin' => $slug, 'data_removed' => $removeData]);
}
/**
* @return list<string>
*/
public function dependents(string $slug): array
{
return array_values(array_map(
fn (PluginManifest $m) => $m->name,
array_filter($this->all(), fn (PluginManifest $m) => $this->isEnabled($m->slug) && in_array($slug, $m->requiredPlugins(), true)),
));
}
/**
* Verzeichnisse für Filament (Ressourcen, Seiten, Widgets) der geladenen Plugins.
*
* @return list<array{type: string, path: string, namespace: string}>
*/
public function filamentDiscovery(): array
{
$result = [];
foreach ($this->loaded as $plugin) {
foreach (['Resources', 'Pages', 'Widgets'] as $type) {
$path = $plugin->manifest->path."/src/Filament/{$type}";
if (is_dir($path)) {
$result[] = ['type' => $type, 'path' => $path, 'namespace' => $plugin->manifest->namespace."Filament\\{$type}"];
}
}
}
return $result;
}
public function corePath(): string
{
return $this->corePath ?? base_path('plugins-core');
}
public function customerPath(): string
{
return $this->customerPath ?? base_path('plugins');
}
public function forgetDiscovered(): void
{
$this->manifests = null;
}
private function instantiate(PluginManifest $manifest): Plugin
{
if (! class_exists($manifest->class)) {
throw new RuntimeException("Plugin-Klasse {$manifest->class} nicht gefunden.");
}
$plugin = new ($manifest->class)($this->app, $manifest);
if (! $plugin instanceof Plugin) {
throw new RuntimeException("{$manifest->class} muss von ".Plugin::class.' erben.');
}
return $plugin;
}
private function registerAutoload(PluginManifest $manifest): void
{
if (isset($this->autoloaded[$manifest->slug])) {
return;
}
$prefix = $manifest->namespace;
$base = $manifest->path.'/src/';
spl_autoload_register(function (string $class) use ($prefix, $base) {
if (str_starts_with($class, $prefix)) {
$file = $base.str_replace('\\', '/', substr($class, strlen($prefix))).'.php';
if (is_file($file)) {
require $file;
}
}
});
// Eigene Abhängigkeiten eines Plugins (gescoped, siehe docs/PLAN.md 4.2).
if (is_file($manifest->path.'/vendor/autoload.php')) {
require_once $manifest->path.'/vendor/autoload.php';
}
$this->autoloaded[$manifest->slug] = true;
}
private function guard(PluginManifest $manifest, callable $callback): void
{
$marker = $this->markerPath($manifest->slug);
@file_put_contents($marker, (string) time());
try {
$callback();
} catch (Throwable $e) {
unset($this->loaded[$manifest->slug]);
$this->problems[$manifest->slug] = $e->getMessage();
Log::error("Plugin {$manifest->slug} wurde wegen eines Fehlers deaktiviert: ".$e->getMessage(), ['exception' => $e]);
try {
$this->deactivate($manifest->slug, 'Fehler beim Laden: '.$e->getMessage());
} catch (Throwable) {
$this->state->setEnabled($manifest->slug, false, 'Fehler beim Laden: '.$e->getMessage());
}
} finally {
@unlink($marker);
}
}
private function recoverFromCrash(): void
{
foreach (glob($this->markerPath('*')) ?: [] as $marker) {
if (time() - (int) @filemtime($marker) < self::CRASH_AFTER_SECONDS) {
continue; // Lädt vermutlich gerade in einer parallelen Anfrage.
}
$slug = substr(basename($marker), strlen('booting-'));
Log::critical("Plugin {$slug} hat beim Laden einen schweren Fehler verursacht und wurde deaktiviert.");
$this->state->setEnabled($slug, false, 'Schwerer Fehler beim Laden (das Portal wurde dadurch unterbrochen).');
@unlink($marker);
}
}
private function markerPath(string $slug): string
{
$dir = storage_path('framework/plugins');
if (! is_dir($dir)) {
@mkdir($dir, 0775, true);
}
return $dir.'/booting-'.$slug;
}
}

View file

@ -0,0 +1,130 @@
<?php
namespace App\Plugins;
use App\Version;
use InvalidArgumentException;
/**
* Inhalt einer plugin.json.
*
* {
* "slug": "mav-kalender",
* "name": "MAV-Kalender",
* "version": "1.0.0",
* "description": "…",
* "author": "…",
* "namespace": "Acme\\MavKalender\\",
* "class": "Acme\\MavKalender\\Plugin",
* "requires": { "core": ">=0.3.0", "php": ">=8.3", "plugins": ["news"] },
* "update_url": "https://…"
* }
*/
final class PluginManifest
{
public const SLUG_PATTERN = '/^[a-z0-9]+(?:-[a-z0-9]+)*$/';
/**
* @param array<string, mixed> $data
*/
private function __construct(
public readonly string $slug,
public readonly string $name,
public readonly string $version,
public readonly string $description,
public readonly string $author,
public readonly string $namespace,
public readonly string $class,
public readonly string $path,
public readonly bool $core,
public readonly array $requires,
public readonly ?string $updateUrl,
public readonly bool $enabledByDefault = true,
) {}
public static function fromDirectory(string $path, bool $core): self
{
$file = rtrim($path, '/').'/plugin.json';
$data = json_decode((string) @file_get_contents($file), true);
if (! is_array($data)) {
throw new InvalidArgumentException('plugin.json fehlt oder ist kein gültiges JSON.');
}
return self::fromArray($data, $path, $core);
}
/**
* @param array<string, mixed> $data
*/
public static function fromArray(array $data, string $path, bool $core): self
{
foreach (['slug', 'name', 'version', 'namespace', 'class'] as $field) {
if (! is_string($data[$field] ?? null) || trim($data[$field]) === '') {
throw new InvalidArgumentException("plugin.json: Feld „{$field}“ fehlt.");
}
}
if (! preg_match(self::SLUG_PATTERN, $data['slug'])) {
throw new InvalidArgumentException('plugin.json: „slug“ darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.');
}
$namespace = rtrim($data['namespace'], '\\').'\\';
if (! str_starts_with(ltrim($data['class'], '\\'), $namespace)) {
throw new InvalidArgumentException('plugin.json: „class“ muss im angegebenen Namespace liegen.');
}
if (str_starts_with($namespace, 'App\\') || str_starts_with($namespace, 'Illuminate\\')) {
throw new InvalidArgumentException('plugin.json: Der Namespace „App\\“ ist dem Kern vorbehalten.');
}
return new self(
slug: $data['slug'],
name: $data['name'],
version: $data['version'],
description: (string) ($data['description'] ?? ''),
author: (string) ($data['author'] ?? ''),
namespace: $namespace,
class: ltrim($data['class'], '\\'),
path: rtrim($path, '/'),
core: $core,
requires: is_array($data['requires'] ?? null) ? $data['requires'] : [],
updateUrl: is_string($data['update_url'] ?? null) ? $data['update_url'] : null,
enabledByDefault: (bool) ($data['enabled_by_default'] ?? true),
);
}
/**
* @return list<string>
*/
public function requiredPlugins(): array
{
return array_values(array_filter((array) ($this->requires['plugins'] ?? []), 'is_string'));
}
/**
* Gründe, warum das Plugin in dieser Umgebung nicht laufen kann.
*
* @return list<string>
*/
public function incompatibilities(): array
{
$problems = [];
if (! VersionConstraint::satisfies(Version::VERSION, $this->requires['core'] ?? null)) {
$problems[] = 'benötigt Inhaus '.$this->requires['core'];
}
if (! VersionConstraint::satisfies(PHP_VERSION, $this->requires['php'] ?? null)) {
$problems[] = 'benötigt PHP '.$this->requires['php'];
}
return $problems;
}
public function migrationsPath(): string
{
return $this->path.'/database/migrations';
}
}

View file

@ -0,0 +1,87 @@
<?php
namespace App\Plugins;
use App\Support\Update\AtomicFile;
/**
* Aktivierungszustand der Plugins in storage/app/plugins.json – als Datei, damit
* das Laden der Plugins keine Datenbankabfrage kostet und auch ohne DB klappt.
* Mitgelieferte Plugins sind aktiv, solange nichts anderes vermerkt ist – außer sie
* sind als optional markiert („enabled_by_default“: false in plugin.json).
*/
class PluginState
{
/**
* Test-Suite: optionale mitgelieferte Plugins ebenfalls laden, damit ihre
* Tabellen und Tests dabei sind (gesetzt in tests/TestCase.php).
*/
public static bool $enableOptionalCorePlugins = false;
/** @var array<string, array<string, mixed>>|null */
private ?array $data = null;
public function __construct(private readonly ?string $file = null) {}
public function isEnabled(PluginManifest $manifest): bool
{
$entry = $this->all()[$manifest->slug] ?? null;
return is_array($entry) ? (bool) ($entry['enabled'] ?? false) : $manifest->core && ($manifest->enabledByDefault || self::$enableOptionalCorePlugins);
}
public function setEnabled(string $slug, bool $enabled, ?string $reason = null): void
{
$this->update($slug, ['enabled' => $enabled, 'disabled_reason' => $enabled ? null : $reason]);
}
public function disabledReason(string $slug): ?string
{
return $this->all()[$slug]['disabled_reason'] ?? null;
}
public function forget(string $slug): void
{
$data = $this->all();
unset($data[$slug]);
$this->write($data);
}
/**
* @return array<string, array<string, mixed>>
*/
public function all(): array
{
if ($this->data === null) {
$decoded = json_decode((string) @file_get_contents($this->path()), true);
$this->data = is_array($decoded) ? $decoded : [];
}
return $this->data;
}
/**
* @param array<string, mixed> $values
*/
private function update(string $slug, array $values): void
{
$this->data = null;
$data = $this->all();
$data[$slug] = array_merge($data[$slug] ?? [], $values);
$this->write($data);
}
/**
* @param array<string, array<string, mixed>> $data
*/
private function write(array $data): void
{
AtomicFile::write($this->path(), json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
$this->data = $data;
}
private function path(): string
{
return $this->file ?? storage_path('app/plugins.json');
}
}

View file

@ -0,0 +1,58 @@
<?php
namespace App\Plugins;
/**
* Einfache Versionsbedingungen für Plugin-Manifeste: „>=1.2“, „<2.0“, „^1.4“,
* „~1.4“, „1.2.3“, „*“ – mehrere mit Leerzeichen oder Komma verknüpft (UND).
*/
final class VersionConstraint
{
public static function satisfies(string $version, ?string $constraint): bool
{
$constraint = trim((string) $constraint);
if ($constraint === '' || $constraint === '*') {
return true;
}
foreach (preg_split('/[\s,]+/', $constraint) ?: [] as $part) {
if (! self::check(self::normalize($version), $part)) {
return false;
}
}
return true;
}
private static function check(string $version, string $part): bool
{
if (str_starts_with($part, '^')) {
$min = self::normalize(substr($part, 1));
[$major, $minor] = array_map('intval', explode('.', $min));
$max = $major > 0 ? ($major + 1).'.0.0' : '0.'.($minor + 1).'.0';
return version_compare($version, $min, '>=') && version_compare($version, $max, '<');
}
if (str_starts_with($part, '~')) {
$min = self::normalize(substr($part, 1));
[$major, $minor] = array_map('intval', explode('.', $min));
return version_compare($version, $min, '>=') && version_compare($version, $major.'.'.($minor + 1).'.0', '<');
}
if (preg_match('/^(>=|<=|>|<|==|=|!=)(.+)$/', $part, $m)) {
return version_compare($version, self::normalize($m[2]), $m[1] === '=' ? '==' : $m[1]);
}
return version_compare($version, self::normalize($part), '==');
}
private static function normalize(string $version): string
{
$parts = explode('.', preg_replace('/[^0-9.].*$/', '', ltrim(trim($version), 'vV')));
return implode('.', array_slice(array_pad(array_map('intval', $parts), 3, 0), 0, 3));
}
}

View file

@ -0,0 +1,37 @@
<?php
namespace App\Policies;
use App\Models\Role;
use App\Models\User;
class RolePolicy
{
public function viewAny(User $user): bool
{
return $user->can('roles.manage');
}
public function view(User $user, Role $role): bool
{
return $user->can('roles.manage');
}
public function create(User $user): bool
{
return $user->can('roles.manage');
}
public function update(User $user, Role $role): bool
{
return $user->can('roles.manage');
}
/**
* Systemrollen (Administration) lassen sich nicht löschen.
*/
public function delete(User $user, Role $role): bool
{
return $user->can('roles.manage') && ! $role->is_system;
}
}

View file

@ -0,0 +1,33 @@
<?php
namespace App\Policies;
use App\Models\User;
class UserPolicy
{
public function viewAny(User $user): bool
{
return $user->can('users.manage');
}
public function view(User $user, User $model): bool
{
return $user->can('users.manage');
}
public function create(User $user): bool
{
return $user->can('users.manage');
}
public function update(User $user, User $model): bool
{
return $user->can('users.manage');
}
public function delete(User $user, User $model): bool
{
return $user->can('users.manage') && ! $model->is($user);
}
}

View file

@ -0,0 +1,52 @@
<?php
namespace App\Profile;
use App\Models\User;
use Closure;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Zusätzliche Abschnitte in „Profil bearbeiten“, beigesteuert von Plugins
* (z. B. „Geburtstag“). Die Vue-Komponente liegt unter
* plugins-core/<plugin>/resources/js/profile/<Name>.vue („<plugin>::Name“)
* und speichert über eigene Routen des Plugins.
*/
class ProfileSections
{
/** @var array<string, array{component: string, sort: int, props: Closure}> */
private array $sections = [];
/**
* @param Closure(User): (array<string, mixed>|null) $props null = Abschnitt nicht zeigen
*/
public function add(string $key, string $component, int $sort, Closure $props): void
{
$this->sections[$key] = compact('component', 'sort', 'props');
}
/**
* @return list<array{key: string, component: string, props: array<string, mixed>}>
*/
public function resolve(User $user): array
{
$result = [];
foreach (collect($this->sections)->sortBy('sort') as $key => $section) {
try {
$props = ($section['props'])($user);
} catch (Throwable $e) {
Log::error("Profilabschnitt {$key} fehlgeschlagen: ".$e->getMessage());
continue;
}
if ($props !== null) {
$result[] = ['key' => $key, 'component' => $section['component'], 'props' => $props];
}
}
return $result;
}
}

View file

@ -2,12 +2,31 @@
namespace App\Providers;
use App\Dashboard\CoreWidgets;
use App\Dashboard\Widgets;
use App\Editorial\Editorial;
use App\Models\User;
use App\Pagebuilder\Blocks;
use App\Support\Abilities;
use App\Support\Avatars;
use App\Support\BackgroundTasks;
use App\Support\Branding;
use App\Support\Installation;
use App\Support\License\LicenseStore;
use App\Support\MailSettings;
use App\Support\Navigation;
use App\Support\Permissions\PermissionResource;
use App\Support\Permissions\Permissions;
use App\Support\ProfileFields;
use App\Support\QuickLinks;
use App\Support\Settings;
use App\Support\Theme\Theme;
use App\Support\Theme\ThemeCompiler;
use App\Support\Update\InstalledVersion;
use App\Support\Update\MaintenanceFlag;
use App\Support\Update\UpdateProgress;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\ServiceProvider;
use Illuminate\Validation\Rules\Password;
@ -15,18 +34,72 @@ class AppServiceProvider extends ServiceProvider
{
public function register(): void
{
// Frisch hochgeladen: .env und Schlüssel anlegen; bis zur Einrichtung ohne Datenbank
// für Sitzungen, Cache und Queue auskommen (der Web-Installer braucht das).
if (! $this->app->runningUnitTests()) {
Installation::prepareEnvironment();
}
if (! Installation::isInstalled()) {
config(['session.driver' => 'file', 'cache.default' => 'file', 'queue.default' => 'sync']);
}
$this->app->singleton(Settings::class);
$this->app->singleton(MailSettings::class);
$this->app->singleton(Branding::class);
$this->app->singleton(Theme::class);
$this->app->singleton(ThemeCompiler::class);
$this->app->singleton(Avatars::class);
$this->app->singleton(Navigation::class);
$this->app->singleton(QuickLinks::class);
$this->app->singleton(LicenseStore::class);
$this->app->singleton(Permissions::class);
$this->app->singleton(ProfileFields::class);
$this->app->singleton(Blocks::class);
$this->app->singleton(Editorial::class);
$this->app->singleton(BackgroundTasks::class);
$this->app->singleton(InstalledVersion::class);
$this->app->singleton(UpdateProgress::class);
$this->app->singleton(MaintenanceFlag::class);
}
public function boot(): void
{
CoreWidgets::register($this->app->make(Widgets::class));
$this->app->make(Navigation::class)->add('editorial', 'Redaktion', '/redaktion', active: ['editorial', 'pages.editor', 'news.editor.*', 'forms.builder'], sort: 85,
visible: fn (User $user) => $this->app->make(Editorial::class)->visibleFor($user));
// N+1-Abfragen in Entwicklung und Tests sofort sichtbar machen (docs/PLAN.md, Performance).
Model::preventLazyLoading(! $this->app->isProduction());
// Rechte aus Rollen (App\Support\Abilities) entscheidet das Rechtesystem – Administration
// hat sie alle. Alles andere (z. B. „delete“ auf einem Modell) entscheiden die Policies,
// damit Regeln wie „Systemrollen nie löschen“ auch für Administratoren gelten.
Gate::before(function (User $user, string $ability, array $arguments) {
if (! $user->is_active) {
return false;
}
if (! $this->app->make(Abilities::class)->exists($ability)) {
return null;
}
[$type, $id] = PermissionResource::from($arguments);
return $user->permissions()->can($ability, $type, $id);
});
Password::defaults(fn () => Password::min(10)->letters()->numbers());
if (Installation::isInstalled()) {
$this->app->make(MailSettings::class)->apply();
// Whitelabel: Laravel nutzt app.name z. B. in Benachrichtigungs-Mails („Viele Grüße …“).
try {
config(['app.name' => $this->app->make(Branding::class)->portalName()]);
} catch (\Throwable) {
// Datenbank noch nicht bereit
}
}
}
}

View file

@ -3,7 +3,15 @@
namespace App\Providers\Filament;
use App\Filament\AvatarProviders\InitialsAvatarProvider;
use App\Filament\Pages\Feedback;
use App\Filament\Resources\DashboardTiles\DashboardTileResource;
use App\Filament\Resources\IdentityProviders\IdentityProviderResource;
use App\Filament\Resources\ProfileFields\ProfileFieldResource;
use App\Filament\Resources\Roles\RoleResource;
use App\Filament\Resources\Users\UserResource;
use App\Plugins\PluginManager;
use App\Support\Branding;
use Filament\Actions\Action;
use Filament\Http\Middleware\Authenticate;
use Filament\Http\Middleware\AuthenticateSession;
use Filament\Http\Middleware\DisableBladeIconComponents;
@ -27,24 +35,43 @@ class AdminPanelProvider extends PanelProvider
{
// Keine eigene Filament-Anmeldung: das Admin-Backend nutzt den Portal-Login
// (und damit später auch Entra ID). Nicht angemeldete Personen landen auf /login.
return $panel
$panel = $panel
->default()
->id('admin')
->path('admin')
->defaultAvatarProvider(InitialsAvatarProvider::class)
->brandName(fn () => app(Branding::class)->portalName())
->brandLogo(fn () => app(Branding::class)->logoUrl())
->darkModeBrandLogo(fn () => app(Branding::class)->logoDarkUrl())
->brandLogoHeight('2rem')
->favicon(fn () => app(Branding::class)->faviconUrl())
->colors(fn () => [
'primary' => app(Branding::class)->palette(),
])
->navigationGroups(['Inhalte', 'Portal'])
->navigationGroups(['Inhalte', 'Benutzer & Rechte', 'Portal', 'System', 'Hilfe'])
->databaseNotifications()
->userMenuItems([
Action::make('feedback')
->label('Rückmeldung geben')
->icon(Heroicon::OutlinedChatBubbleLeftEllipsis)
->url(fn () => Feedback::getUrl()),
])
->navigationItems([
NavigationItem::make('Zum Portal')
->url('/')
->icon(Heroicon::OutlinedArrowTopRightOnSquare)
->sort(100),
])
->discoverResources(in: app_path('Filament/Resources'), for: 'App\Filament\Resources')
// Kern-Ressourcen ausdrücklich registrieren statt das Verzeichnis zu durchsuchen:
// Der Self-Updater löscht nie Dateien, verschobene Ressourcen (z. B. nach
// plugins-core/) blieben sonst als Doppelgänger liegen und würden mitgeladen.
->resources([
UserResource::class,
RoleResource::class,
ProfileFieldResource::class,
DashboardTileResource::class,
IdentityProviderResource::class,
])
->discoverPages(in: app_path('Filament/Pages'), for: 'App\Filament\Pages')
->pages([
Dashboard::class,
@ -67,5 +94,16 @@ class AdminPanelProvider extends PanelProvider
->authMiddleware([
Authenticate::class,
]);
// Admin-Seiten der aktiven Plugins (src/Filament/{Resources,Pages,Widgets}).
foreach (app(PluginManager::class)->filamentDiscovery() as $discovery) {
match ($discovery['type']) {
'Resources' => $panel->discoverResources(in: $discovery['path'], for: $discovery['namespace']),
'Pages' => $panel->discoverPages(in: $discovery['path'], for: $discovery['namespace']),
'Widgets' => $panel->discoverWidgets(in: $discovery['path'], for: $discovery['namespace']),
};
}
return $panel;
}
}

View file

@ -4,6 +4,7 @@ namespace App\Providers;
use App\Actions\Fortify\ResetUserPassword;
use App\Actions\Fortify\UpdateUserPassword;
use App\Models\IdentityProvider;
use App\Models\User;
use Illuminate\Auth\Events\Login;
use Illuminate\Cache\RateLimiting\Limit;
@ -25,7 +26,12 @@ class FortifyServiceProvider extends ServiceProvider
Fortify::loginView(fn (Request $request) => Inertia::render('Auth/Login', [
'canResetPassword' => true,
'status' => $request->session()->get('status'),
'providers' => IdentityProvider::query()->where('enabled', true)->orderBy('name')->get()
->map(fn (IdentityProvider $p) => ['slug' => $p->slug, 'label' => $p->buttonLabel(), 'type' => $p->type])->values(),
'identityError' => $request->session()->get('identity_error'),
'status' => $request->boolean('eingerichtet')
? 'Die Einrichtung ist abgeschlossen. Sie können sich jetzt mit Ihrem Administratorkonto anmelden.'
: $request->session()->get('status'),
]));
Fortify::requestPasswordResetLinkView(fn (Request $request) => Inertia::render('Auth/ForgotPassword', [

View file

@ -0,0 +1,37 @@
<?php
namespace App\Providers;
use App\Dashboard\Widgets;
use App\Plugins\Hooks;
use App\Plugins\PluginManager;
use App\Plugins\PluginState;
use App\Profile\ProfileSections;
use App\Support\Abilities;
use App\Support\Navigation;
use Illuminate\Support\ServiceProvider;
/**
* Lädt die Plugins. Muss vor den Panel-Providern registriert sein, damit
* Plugins ihre Admin-Seiten beitragen können.
*/
class PluginServiceProvider extends ServiceProvider
{
public function register(): void
{
$this->app->singleton(Hooks::class);
$this->app->singleton(PluginState::class);
$this->app->singleton(PluginManager::class);
$this->app->singleton(Navigation::class);
$this->app->singleton(Widgets::class);
$this->app->singleton(Abilities::class);
$this->app->singleton(ProfileSections::class);
$this->app->make(PluginManager::class)->registerAll();
}
public function boot(): void
{
$this->app->make(PluginManager::class)->bootAll();
}
}

97
app/Support/Abilities.php Normal file
View file

@ -0,0 +1,97 @@
<?php
namespace App\Support;
/**
* Registry der Rechte (Abilities). Kern und Plugins melden hier an, welche
* Rechte es gibt – das Rollen-Formular und der Rechte-Prüfer bauen darauf auf.
*
* Globale Rechte gelten überall („Benutzer verwalten“). Objekt-Rechte gelten für
* einzelne Objekte eines Typs („Beiträge schreiben in Kategorie MAV-Info“).
*/
class Abilities
{
/** @var array<string, array{label: string, group: string, resource: string|null}> */
private array $abilities = [];
/** @var array<string, array{label: string, options: callable, descendants: callable|null}> */
private array $resourceTypes = [];
public function __construct()
{
$this->define('users.manage', 'Benutzer verwalten', 'System');
$this->define('roles.manage', 'Rollen und Rechte verwalten', 'System');
$this->define('identity.manage', 'Anmeldung (Microsoft Entra ID) einrichten', 'System');
$this->define('plugins.manage', 'Plugins verwalten und installieren', 'System');
$this->define('appearance.manage', 'Erscheinungsbild und Schnellzugriffe', 'System');
$this->define('updates.manage', 'Aktualisierungen, Lizenz und Systemzustand', 'System');
$this->define('mail.manage', 'E-Mail-Versand einrichten', 'System');
$this->define('feedback.send', 'Rückmeldungen an den Hersteller senden', 'System');
}
public function define(string $ability, string $label, string $group, ?string $resource = null): void
{
$this->abilities[$ability] = ['label' => $label, 'group' => $group, 'resource' => $resource];
}
/**
* Objekttyp, auf den sich Rechte beziehen können (z. B. „news_category“).
*
* Hierarchische Typen (z. B. Seiten) geben $descendants an: Rechte mit
* „inkl. Unterobjekten“ gelten dann auch für alle Nachfahren.
*
* @param callable(): array<int|string, string> $options ID => Bezeichnung
* @param (callable(list<int>): list<int>)|null $descendants IDs => IDs aller Nachfahren
*/
public function resourceType(string $type, string $label, callable $options, ?callable $descendants = null): void
{
$this->resourceTypes[$type] = ['label' => $label, 'options' => $options, 'descendants' => $descendants];
}
public function isHierarchical(?string $type): bool
{
return $type !== null && isset($this->resourceTypes[$type]['descendants']);
}
/**
* @return array<string, array{label: string, group: string, resource: string|null}>
*/
public function all(): array
{
return $this->abilities;
}
/**
* @return array<string, array{label: string, group: string, resource: string|null}>
*/
public function global(): array
{
return array_filter($this->abilities, fn (array $a) => $a['resource'] === null);
}
/**
* @return array<string, array{label: string, group: string, resource: string|null}>
*/
public function forResource(string $type): array
{
return array_filter($this->abilities, fn (array $a) => $a['resource'] === $type);
}
/**
* @return array<string, array{label: string, options: callable, descendants: callable|null}>
*/
public function resourceTypes(): array
{
return $this->resourceTypes;
}
public function exists(string $ability): bool
{
return isset($this->abilities[$ability]);
}
public function label(string $ability): string
{
return $this->abilities[$ability]['label'] ?? $ability;
}
}

30
app/Support/Audit.php Normal file
View file

@ -0,0 +1,30 @@
<?php
namespace App\Support;
use App\Models\AuditLog;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Protokoll für Admin-Aktionen. Schreibt zusätzlich ins Log – falls die
* Datenbank gerade nicht erreichbar ist (z. B. mitten in einem Update).
*/
class Audit
{
/**
* @param array<string, mixed> $data
*/
public static function log(string $action, array $data = [], ?int $userId = null): void
{
$userId ??= auth()->id();
Log::info("audit: {$action}", [...$data, 'user_id' => $userId]);
try {
AuditLog::query()->create(['user_id' => $userId, 'action' => $action, 'data' => $data]);
} catch (Throwable $e) {
Log::warning('Audit-Eintrag konnte nicht gespeichert werden: '.$e->getMessage());
}
}
}

View file

@ -25,8 +25,28 @@ class Avatars
public function store(User $user, UploadedFile $file): void
{
Images::raiseMemoryLimitFor($file->getRealPath());
$image = ImageManager::usingDriver(Driver::class)->decodePath($file->getRealPath());
$this->storeFromPath($user, $file->getRealPath());
}
/**
* Profilbild aus Binärdaten (z. B. Foto aus Microsoft Entra).
*/
public function storeFromBinary(User $user, string $binary): void
{
$temporary = tempnam(sys_get_temp_dir(), 'avatar');
file_put_contents($temporary, $binary);
try {
$this->storeFromPath($user, $temporary);
} finally {
@unlink($temporary);
}
}
private function storeFromPath(User $user, string $path): void
{
Images::raiseMemoryLimitFor($path);
$image = ImageManager::usingDriver(Driver::class)->decodePath($path);
$base = 'avatars/'.$user->getKey().'/'.Str::random(12);
// Größte Stufe zuerst und danach schrittweise verkleinern – so liegt nur eine

View file

@ -0,0 +1,80 @@
<?php
namespace App\Support;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Hintergrundaufgaben ohne Dauerprozess (Shared Hosting):
* 1. echter Cron: * * * * * php artisan schedule:run
* 2. Web-Cron: externer Dienst ruft /cron/{token} auf
* 3. Pseudo-Cron: nach Auslieferung einer Seite, wenn 1 und 2 fehlen (wie WP-Cron)
* Jeder Lauf hinterlässt ein Lebenszeichen, das „Systemzustand“ anzeigt.
*/
class BackgroundTasks
{
/** Ohne Lebenszeichen von Cron/Web-Cron springt der Pseudo-Cron ein. */
public const PSEUDO_CRON_AFTER_SECONDS = 300;
public function __construct(private readonly Settings $settings) {}
public function run(string $source): void
{
$lock = @fopen(storage_path('.background.lock'), 'c');
if ($lock === false || ! flock($lock, LOCK_EX | LOCK_NB)) {
return;
}
try {
@set_time_limit(55);
$this->heartbeat($source);
Artisan::call('schedule:run');
} catch (Throwable $e) {
Log::error('Hintergrundaufgaben fehlgeschlagen: '.$e->getMessage(), ['exception' => $e]);
} finally {
flock($lock, LOCK_UN);
fclose($lock);
}
}
public function heartbeat(string $source): void
{
$beats = $this->heartbeats();
$beats[$source] = now()->getTimestamp();
@file_put_contents(storage_path('.background-heartbeat'), json_encode($beats));
}
/**
* @return array<string, int> Quelle (cron, webcron, pseudo) => Zeitpunkt
*/
public function heartbeats(): array
{
$data = json_decode((string) @file_get_contents(storage_path('.background-heartbeat')), true);
return is_array($data) ? array_map('intval', $data) : [];
}
public function pseudoCronDue(): bool
{
$beats = $this->heartbeats();
$external = max($beats['cron'] ?? 0, $beats['webcron'] ?? 0);
return now()->getTimestamp() - $external > self::PSEUDO_CRON_AFTER_SECONDS
&& now()->getTimestamp() - ($beats['pseudo'] ?? 0) >= 60;
}
public function webCronToken(): string
{
$token = $this->settings->get('system.cron_token');
if (! is_string($token) || strlen($token) < 32) {
$token = bin2hex(random_bytes(20));
$this->settings->set('system.cron_token', $token);
}
return $token;
}
}

Some files were not shown because too many files have changed in this diff Show more