Files
laraundfelix/docs/ux/verwaltung/14-verwaltungsstandard.md
Lars 4c29ab2593
Deploy Test / test (push) Successful in 55s
Deploy Test / deploy (push) Successful in 24s
Führe den gemeinsamen Redaktionsarbeitsplatz ein.
Texte, Medienzuordnung und Einordnung teilen sich einen Arbeitsplatz. Fassungen, Rechte und das Datenmodell bleiben unverändert.
2026-11-19 14:43:15 +01:00

12 KiB

Verbindlicher Designstandard für die Verwaltung

Stand: 19.11.2026. Grundlage: UX-Audit und gemeinsame Designentscheidungen mit dem Auftraggeber. Die jüngste Rückmeldung beendet weitere allgemeine Designabstimmungen als Voraussetzung für den Umbau. Die vorhandene Richtung ist ausreichend bestimmt, um einen Coding-Agenten mit der Umsetzung zu beauftragen.

Geltung und Rangfolge

Dieses Dokument ist die maßgebliche Design- und Interaktionsgrundlage für den Verwaltungsumbau und künftige Verwaltungsoberflächen. Der Umbauauftrag macht die Umsetzung konkret. Bestehende Betriebs-, Sicherheits-, Test- und fachliche Vertragsregeln bleiben erhalten. Eine Designvorgabe ersetzt keine fachliche Freigabe für geänderte Lizenz-, Erwerbs- oder Versionsregeln.

Die Entscheidungen und Abbildungen in Dokument 02 bis 13 liefern Herkunft und Referenzen. Ihre früheren Hinweise auf ausstehende Detailabstimmung sind zeitliche Arbeitsstände und kein allgemeines Startverbot mehr. Es werden nicht sämtliche alternativen Bilddetails oder offenen Fachfragen pauschal freigegeben. Bei Abweichungen gilt: dieser Standard für gemeinsame UX; bestätigte Anforderungen und bestehende fachliche Verträge für Bedeutung und Wirkung; ausgewählte Bilder für die räumliche Richtung. Bildfehler und historische Alternativen nicht nachbauen.

1. Ein gemeinsamer Arbeitsplatz

  • Laravel, Filament und Livewire bleiben Grundlage. Bestehende Modelle, Beziehungen, Registry, Rechte und Fassungsbindungen erhalten.
  • Ein gemeinsamer Verwaltungsrahmen mit klarer Navigation, verständlichem Objektkopf, direkt erreichbaren Arbeitsbereichen und nachvollziehbarem Rückweg.
  • Nichtlineare Arbeit nutzt einen Kontextarbeitsplatz. Nur tatsächlich lineare Vorgänge erhalten eine Schrittführung; abgeschlossene Bereiche bleiben direkt erreichbar. Anlegen und Bearbeiten nutzen dieselbe Grundmaske.
  • Produktinformationen, redaktionelle Präsentation, kommerzielle Angaben und technische Verwaltungsinformationen sind gezielt gegliedert. Keine lange Gesamtformularliste und keine technische Statussammlung als Hauptarbeitsfläche.
  • Vorhandene Bereiche vollständig in die gemeinsamen Muster überführen. Noch nicht gebaute Shop-, Mitglieder-, Lizenz- oder Kursbuchfunktionen werden durch diesen Auftrag nicht neu erfunden.

2. Visueller Rahmen und Größen

Ruhige helle Flächen, dunkelblaue lesbare Texte, grüne Hauptaktion, zurückhaltende Auswahlmarkierung und klare Gruppierung gemäß den ausgewählten Referenzen. Bestehende freigegebene Markenassets und Tokens aus dem Designsystem sowie den Designprinzipien verwenden. Keine Farbentnahme aus generierten Bildern und keine neue Schrift pro Bereich.

Die frühere pauschale Aussage im Designsystem, die Verwaltung bleibe in Standardgestaltung, wird für den hier beschriebenen Verwaltungsumbau durch diesen Standard abgelöst. Der Coding-Agent führt den Geltungsbereich dort entsprechend nach; öffentliche Website-Gestaltung und fachliche Verträge werden dadurch nicht geändert.

Abstände, Schriftgrößen, Zeilenhöhen, Radien, Inhalts- und Panelbreiten werden als gemeinsame Tokens an einer Stelle umgesetzt und dokumentiert. Der Coding-Agent konkretisiert diese Werte anhand vorhandener Komponenten und Referenzen; dafür ist keine neue grundsätzliche Designauswahl erforderlich. Tabellen dürfen die verfügbare Desktopbreite nutzen; Texteingaben bleiben lesbar. Technische Felder und seltene Optionen werden kontextbezogen zugänglich, nicht unauffindbar entfernt.

Die verfügbare Fensterbreite bestimmt die Anordnung. Inhalte dürfen bei kleinerem Desktopfenster und Zoom weder unbedienbar noch verdeckt werden. Sichtbarer Tastaturfokus, verständliche Beschriftungen, ausreichende Kontraste und Alternativen zum Ziehen sind Bestandteil der Umsetzung. Zustand wird nicht allein durch Farbe vermittelt.

3. Objektübersicht, Auswahl und Zuordnung

  • Gemeinsame kompakte Listen mit visueller Vorschau, Suche, nachvollziehbaren aktiven Filtern, verständlichem Zustand und kontextgerechten Aktionen. Keine individuelle Neuinterpretation je Fachobjekttyp.
  • Der gemeinsame Picker folgt der gewählten Listenbasis: kleine Vorschauen in der Liste, Detailprüfung des betrachteten Elements, eindeutig davon getrennte Auswahl zur Übernahme.
  • Auswahl bleibt bei Suche, Filtern und Seitenwechsel erhalten. Eine benannte Bestätigung übernimmt die Auswahl; Abbrechen verändert die vorhandene Zuordnung nicht. Fachlich zulässige Objekte und Fassungen sind Kontext derselben Komponente.
  • Zuordnungen zeigen Quelle und konkrete Verwendung. Hinzufügen, Austauschen und Entfernen sind unterscheidbar. Entfernen einer Referenz löscht nicht das Quellobjekt.
  • Geordnete Listen unterstützen Drag-and-drop und eine Tastaturalternative. Umordnen verändert nur den benannten Umfang. Gefilterte Teilmengen dürfen keine versteckten oder mehrdeutigen Reihenfolgeänderungen auslösen.

4. Objektbearbeitung und Zusammenstellung

Für Module und Programme gilt die gewählte Kombination: kompakte Struktur links, großer Detailbereich rechts und klare Gruppierung. Maßgebliche Referenz: kombinierter Aufbauarbeitsplatz, erläutert in Dokument 06. Medien verwenden denselben Rahmen mit ihren tatsächlichen Datei- und Fassungsfunktionen. Kein weiterer Grundentwurf ist erforderlich, um diese Funktionen einzuordnen.

Quelle und lokale Verwendung dürfen nicht unbemerkt ineinander übergehen. Ein Quellenobjekt wird über einen ausdrücklich benannten Einstieg bearbeitet. Vorschau und Produktpräsentation sind gezielte Arbeitskontexte und verdrängen nicht die eigentliche Zusammenstellung.

5. Gemeinsame Redaktion

Ein gemeinsamer Redaktionsmanager für Medien einschließlich Filmen, Module, Programme und Lizenzartikel; weitere Fachobjekte wie Trainingspläne bleiben anschließbar. Grundlage: Redaktionsübersicht 1 und gemeinsame Register am Film, erläutert in Dokument 09.

Texte, Präsentationsmedien und Einordnung werden in gezielten gemeinsamen Bereichen beziehungsweise Registern bearbeitet. Text und Medien müssen nicht gleichzeitig auf eine Seite passen. Titel, Teaser, Beschreibungen und redaktionelle Hinweise gehören zum Fachobjekt; gewöhnliche Beschreibungstexte werden nicht automatisch zu Medienobjekten. Verbindliche Lehrtexte und ihre fachlichen Fassungen bleiben getrennt.

Präsentationsmedien werden ausschließlich über den zentralen visuellen Picker referenziert. Mehrere Medien pro Rolle, visuelle Vorschau, Austausch, Entfernen und Sortierung bleiben möglich. Reine Präsentationsmedien benötigen keine Lehrinhaltsfassung. Klassifikation, tatsächliche Verwendung und Rechte sind unterschiedliche Angaben.

Übernommene Werte und eigene Abweichungen sind erkennbar; bestehende Auflösungsregeln bleiben erhalten. CMS-Verwendungen nutzen zentrale Angaben als Quelle und kennzeichnen lokale Abweichungen. Offene Vererbungsdetails nicht durch unbemerkte neue Rückfallregeln entscheiden.

6. Wechsel, Speichern und Rückmeldung

  • Wechsel zum Redaktionsmanager und zurück erhält offene Eingaben, Auswahl, Reihenfolge und Bearbeitungskontext des Ausgangseditors. Kein vorgeschaltetes Pflichtspeichern, kein verstecktes Mitspeichern und kein Überschreiben neuer Redaktionswerte durch alte Formularwerte.
  • Der Agent löst die technische Zustandserhaltung innerhalb des bestehenden Systems und prüft dabei neue Objekte, Uploads, Validierungsfehler und Browser-Rückwege. Das ist eine Umsetzungspflicht, kein weiterer allgemeiner Designfreigabeschritt.
  • Eine verständliche Hauptaktion benennt ihren Speicher- oder Wirkungsumfang. Speichern ist nicht automatisch fachliche Freigabe, Artikelaktivierung oder Website-Veröffentlichung. Ein gemeinsamer Statusbereich zeigt nur die für die aktuelle Aufgabe nötigen Aussagen.
  • Es gibt keine neue pauschale Genehmigungskette. Bestehende fachliche Prüfungen werden sinnvoll zugänglich gemacht und nicht allein aufgrund technischer Zustände zu weiteren manuellen Schritten.
  • Vorschau benennt Gegenstand, Ausgabe und Datenstand. Aktuelle offene Eingaben sollen prüfbar sein; falls ein Ausgabeweg technisch nur gespeicherte Daten unterstützt, ist dies eindeutig zu benennen und als Abweichung zu dokumentieren. Keine heimliche Speicherung zur Vorschau.

7. Website und CMS

Die Einzel-Seitenbearbeitung führt die Weiterentwicklung aus Dokument 12 fort: breite visuelle Seitenstruktur, großzügige Konfigurationsbereiche für Abschnitt und Baustein, derselbe Seitenarbeitsstand und verlustfreie Rückwege. Konfigurationsumfang nicht in eine zu schmale rechte Spalte pressen.

Das vorhandene Raster mit maximal vier logischen Einheiten, nebeneinanderliegenden Karten, verschiedenen Breiten und fachlich unterstützten Höhen bleibt sichtbar und funktional erhalten. Bestehende Abschnittsformatierungen und typabhängige Bausteinoptionen vollständig berücksichtigen. Keine neue freie Pixel-/Masonry-Logik aus einem Bild ableiten. Zentrale Redaktion bleibt Quelle für objektbezogene Inhalte; lokale Abweichungen sind erkennbar.

Die Webpräsenz-Verwaltung trennt Seitenbestand und Menüorganisation. Der Auftraggeber bevorzugt Entwurf 1 und 3. Als Umsetzungskonkretisierung wird bei ausreichender Breite die Menüliste mit festem Detailbereich nach Entwurf 1 genutzt; bei schmalerem Fenster dieselbe Bearbeitung inline nach Entwurf 3, mit höchstens einem geöffneten Eintrag. Offene Änderungen und Orientierung bleiben beim Wechsel erhalten. Keine zusätzliche Variantenwahl vor dem Start erforderlich.

Menütext, Seitentitel, Menüfolge und Seitenveröffentlichung sind unabhängig. Menü ausblenden oder Eintrag entfernen löscht keine Seite und entzieht keine Nutzungsrechte. Die vorhandenen Haupt-/Fußmenübereiche und Hierarchiegrenzen erhalten. Menüänderungen speichern benennt die Wirkung auf die öffentliche Navigation; keine zusätzliche allgemeine Website-Freigabe erfinden. „Website-Rahmen“ ist kein Auftrag für neue globale Theme-, Startseiten- oder Seitenbaumfunktionen.

8. Schutz fachlicher Wirkung

Bestehende Erwerbe, Bedingungen, zugesagte Aktualisierungen, Rechte und Historie bleiben durch normale Bearbeitung geschützt. Rechtlich notwendiger Rückzug bleibt eine ausdrückliche Handlung mit Grund, Umfang und Ergebnis. Eine rein visuelle Überarbeitung verändert dessen Sperrwirkung nicht; bestehende Ausgabewege sind bei Änderungen daran nachweisbar zu prüfen.

Dokument 04 hält offene Geschäftsfragen fest. Diese blockieren nur tatsächlich davon abhängige Funktionen. Ein offener Rabatt- oder Angebotsmechanismus verhindert keinen Medien-/Redaktionsumbau. Der Agent baut keine neue Geschäftsregel aus einem Mockup. Bei einem konkreten fachlichen Widerspruch benennt er den betroffenen Teil und arbeitet an unabhängigen Teilen weiter.

9. Wiederverwendung und Abnahme

Gleiche Aufgabe bedeutet dieselbe gepflegte Komponente: Rahmen, Listen, Picker, Redaktion, Sortierung, Status-/Aktionsbereich, Dialoge und Vorschau. Gemeinsam gepflegte Komponenten müssen von mehreren Objektarten genutzt werden; kopierte ähnlich aussehende Formulare erfüllen dies nicht.

Die Abnahme bewertet die echte Anwendung, nicht die Bildvorlage oder eine Agentenbehauptung. Für jeden Umsetzungsteil sind die relevanten PICK-, BUILD-, RED-, CMS-, WEB- und Zustandsfälle aus den Detaildokumenten auszuwählen. Sie dienen als konkretisierte Prüfaufgaben; fachlich offene Erwartungen werden nicht automatisch neue Geschäftsregeln. Keine zusätzliche Designfreigabe pro Fall.

Erforderliche Nachweise: funktionierender Hauptablauf, Erhalt offener Eingaben, Berechtigungs-/Fassungsregressionen im betroffenen Umfang, Tastaturbedienung, relevante Lade-/Leer-/Fehlerzustände sowie Screenshots bei sinnvoller breiter und schmalerer Fenstergröße. Bestehende Repository-Prüfpflichten bleiben maßgeblich. Nicht geprüfte Punkte und Abweichungen konkret angeben. Umsetzung und Abnahme schrittweise durchführen; die gesamte Verwaltung benötigt nicht vorab einen Screenkatalog.

Die Agentenregelvorlagen verweisen auf diesen Standard. Ihre Einbindung in aktive Agentenregeln gehört zum Umbauauftrag und ergänzt bestehende Betriebsregeln. Dieser Dokumentationsschritt startet keinen Coding-Agenten und verändert keine Anwendung.