NAK-Reinickendorf/intranet
2
0
Fork 0
Code Issues 2 Pull Requests Actions Projects 1 Wiki Activity

[FEATURE] web/brandschutz - Brandschutzschulung im Adminpanel vollständig modular erstellbar/bearbeitbar machen #9

New Issue
Open
opened 2026-08-29 02:10:57 +02:00 by samuelbias · 0 comments
samuelbias commented 2026-08-29 02:10:57 +02:00
Owner
Copy Link
Copy Source

Brandschutzschulung im Adminpanel vollständig modular erstellbar machen

User Story

Als Administrator
möchte ich Inhalte, Kapitel, Seiten, Quizfragen und interaktive Elemente vollständig über einen visuellen Editor im Adminpanel erstellen, bearbeiten, anordnen und verwalten können,
damit Änderungen an der Schulung ohne Anpassungen am Anwendungscode möglich sind und Aufbau, Navigation, Inhalte und Auswertung vollständig aus einer zentral gespeicherten Konfiguration erzeugt werden.

Aufgabenbeschreibung

Die Brandschutzschulung ist aktuell in brandschutz.php vollständig fest definiert und direkt im Code hin# terlegt. Im Adminpanel (admin_brandschutz.php) können derzeit dagegen nur Schulungsstände und Schulungsdaten verwaltet werden.

Als neues Feature soll dort ein visueller Schulungseditor entstehen, mit dem die komplette Brandschutzschulung aus den bereits vorhandenen Elementtypen aufgebaut und bearbeitet werden kann. Dazu sollen unter anderem Textblöcke, Info- und Warnboxen, Listen, Akkordeons, Checklisten, Szenarien, Multiple-Choice-Fragen, Lückentexte und Zuordnungsaufgaben als wiederverwendbare Bausteine zur Verfügung stehen. Auch ein neues Bildelement mit der Möglichkeit, Bilder (gespeichert in Docker Volume) in der Schulung einzubauen, wäre umzusetzen. Kapitel beziehungsweise Seiten und einzelne Elemente müssen angelegt, bearbeitet, gelöscht und frei angeordnet werden können. Bei Quiz-Elementen müssen insbesondere Antworten, korrekte Lösungen und Feedback konfigurierbar sein. Auch Reihenfolge, Navigation und die für die Auswertung relevanten Fragen sollen sich aus dieser Konfiguration ergeben.

Die bestehende Schulung soll zunächst vollständig in dieses neue Modell überführt werden, ohne das aktuelle Nutzererlebnis oder die bestehende Abschluss-, Schulungsstatus- und Erinnerungslogik zu verändern. Ziel ist, dass Inhalt und Aufbau der eigentlichen Schulung anschließend vollständig aus der gespeicherten Konfiguration gerendert werden und keine schulungsspezifischen Inhalte, Säulen, Fragen oder Abläufe mehr hart im Frontend beziehungsweise in brandschutz.php codiert sind.

Akzeptanzkriterien

  • Im Adminpanel steht ein visueller Editor für die vollständige Konfiguration der Brandschutzschulung zur Verfügung.
  • Kapitel beziehungsweise Schulungsseiten können angelegt, umbenannt, bearbeitet, gelöscht und in ihrer Reihenfolge verändert werden.
  • Elemente innerhalb einer Seite können angelegt, bearbeitet, gelöscht und frei in ihrer Reihenfolge angeordnet werden.
  • Die bereits in der Schulung verwendeten Elementtypen stehen als wiederverwendbare Bausteine im Editor zur Verfügung.
  • Mindestens folgende Elementtypen können konfiguriert werden:
    • Textblock
    • Infobox
    • Warnbox
    • Liste
    • Akkordeon
    • Checkliste
    • Szenario
    • Multiple-Choice-Frage
    • Lückentext
    • Bild
  • Für Bildelemente können Bilder über das Adminpanel hochgeladen, ausgewählt, ersetzt und entfernt werden.
  • Hochgeladene Bilder werden persistent in einem dafür vorgesehenen Docker Volume gespeichert.
  • Bildelemente können mindestens Bilddatei, Alternativtext und gegebenenfalls eine Bildunterschrift konfigurieren.
  • Bei Multiple-Choice-Fragen können Fragetext, Antwortmöglichkeiten, eine oder mehrere korrekte Antworten sowie Feedback konfiguriert werden.
  • Bei Lückentexten können die erwarteten Lösungen konfiguriert werden.
  • Im Frontend sind keine schulungsspezifischen Kapitel, Inhalte, Fragen, Antwortmöglichkeiten oder Navigationsabläufe mehr hart codiert.
  • brandschutz.php rendert die Schulung ausschließlich auf Grundlage der gespeicherten Konfiguration.
  • Die bestehende Brandschutzschulung wurde vollständig in das neue Datenmodell migriert.
  • Die bestehende Logik für Schulungsabschluss bleibt unverändert funktionsfähig.
  • Die bestehende Verwaltung des Schulungsstatus bleibt unverändert funktionsfähig.
  • Die bestehende Erinnerungslogik bleibt unverändert funktionsfähig.
  • Bereits vorhandene Schulungsstände und historische Abschlussdaten werden durch die Umstellung nicht verändert oder ungültig.
  • Änderungen an der Schulung über das Adminpanel werden ohne Codeänderung im Frontend wirksam.
  • Inhalte werden im Frontend sicher gerendert. Über den Editor eingegebene Inhalte dürfen keine unkontrollierte Script-/HTML-Ausführung ermöglichen.
  • Der Editor bietet definierte Leerzustände für neue Schulungen, leere Kapitel und Seiten ohne Elemente.
  • Fehler beim Laden oder Speichern der Schulungskonfiguration werden im Adminpanel verständlich angezeigt.
  • Die Konfiguration ist so strukturiert, dass künftig weitere Elementtypen ergänzt werden können, ohne das komplette Schulungsmodell neu aufzubauen.
# Brandschutzschulung im Adminpanel vollständig modular erstellbar machen ### User Story **Als Administrator** **möchte ich** Inhalte, Kapitel, Seiten, Quizfragen und interaktive Elemente vollständig über einen visuellen Editor im Adminpanel erstellen, bearbeiten, anordnen und verwalten können, **damit** Änderungen an der Schulung ohne Anpassungen am Anwendungscode möglich sind und Aufbau, Navigation, Inhalte und Auswertung vollständig aus einer zentral gespeicherten Konfiguration erzeugt werden. --- ### Aufgabenbeschreibung Die Brandschutzschulung ist aktuell in `brandschutz.php` vollständig fest definiert und direkt im Code hin# terlegt. Im Adminpanel (`admin_brandschutz.php`) können derzeit dagegen nur Schulungsstände und Schulungsdaten verwaltet werden. Als neues Feature soll dort ein visueller Schulungseditor entstehen, mit dem die komplette Brandschutzschulung aus den bereits vorhandenen Elementtypen aufgebaut und bearbeitet werden kann. Dazu sollen unter anderem Textblöcke, Info- und Warnboxen, Listen, Akkordeons, Checklisten, Szenarien, Multiple-Choice-Fragen, Lückentexte und Zuordnungsaufgaben als wiederverwendbare Bausteine zur Verfügung stehen. Auch ein neues Bildelement mit der Möglichkeit, Bilder (gespeichert in Docker Volume) in der Schulung einzubauen, wäre umzusetzen. Kapitel beziehungsweise Seiten und einzelne Elemente müssen angelegt, bearbeitet, gelöscht und frei angeordnet werden können. Bei Quiz-Elementen müssen insbesondere Antworten, korrekte Lösungen und Feedback konfigurierbar sein. Auch Reihenfolge, Navigation und die für die Auswertung relevanten Fragen sollen sich aus dieser Konfiguration ergeben. Die bestehende Schulung soll zunächst vollständig in dieses neue Modell überführt werden, ohne das aktuelle Nutzererlebnis oder die bestehende Abschluss-, Schulungsstatus- und Erinnerungslogik zu verändern. Ziel ist, dass Inhalt und Aufbau der eigentlichen Schulung anschließend vollständig aus der gespeicherten Konfiguration gerendert werden und keine schulungsspezifischen Inhalte, Säulen, Fragen oder Abläufe mehr hart im Frontend beziehungsweise in `brandschutz.php` codiert sind. ### Akzeptanzkriterien - [ ] Im Adminpanel steht ein visueller Editor für die vollständige Konfiguration der Brandschutzschulung zur Verfügung. - [ ] Kapitel beziehungsweise Schulungsseiten können angelegt, umbenannt, bearbeitet, gelöscht und in ihrer Reihenfolge verändert werden. - [ ] Elemente innerhalb einer Seite können angelegt, bearbeitet, gelöscht und frei in ihrer Reihenfolge angeordnet werden. - [ ] Die bereits in der Schulung verwendeten Elementtypen stehen als wiederverwendbare Bausteine im Editor zur Verfügung. - [ ] Mindestens folgende Elementtypen können konfiguriert werden: - Textblock - Infobox - Warnbox - Liste - Akkordeon - Checkliste - Szenario - Multiple-Choice-Frage - Lückentext - Bild - [ ] Für Bildelemente können Bilder über das Adminpanel hochgeladen, ausgewählt, ersetzt und entfernt werden. - [ ] Hochgeladene Bilder werden persistent in einem dafür vorgesehenen Docker Volume gespeichert. - [ ] Bildelemente können mindestens Bilddatei, Alternativtext und gegebenenfalls eine Bildunterschrift konfigurieren. - [ ] Bei Multiple-Choice-Fragen können Fragetext, Antwortmöglichkeiten, eine oder mehrere korrekte Antworten sowie Feedback konfiguriert werden. - [ ] Bei Lückentexten können die erwarteten Lösungen konfiguriert werden. - [ ] Im Frontend sind keine schulungsspezifischen Kapitel, Inhalte, Fragen, Antwortmöglichkeiten oder Navigationsabläufe mehr hart codiert. - [ ] `brandschutz.php` rendert die Schulung ausschließlich auf Grundlage der gespeicherten Konfiguration. - [ ] Die bestehende Brandschutzschulung wurde vollständig in das neue Datenmodell migriert. - [ ] Die bestehende Logik für Schulungsabschluss bleibt unverändert funktionsfähig. - [ ] Die bestehende Verwaltung des Schulungsstatus bleibt unverändert funktionsfähig. - [ ] Die bestehende Erinnerungslogik bleibt unverändert funktionsfähig. - [ ] Bereits vorhandene Schulungsstände und historische Abschlussdaten werden durch die Umstellung nicht verändert oder ungültig. - [ ] Änderungen an der Schulung über das Adminpanel werden ohne Codeänderung im Frontend wirksam. - [ ] Inhalte werden im Frontend sicher gerendert. Über den Editor eingegebene Inhalte dürfen keine unkontrollierte Script-/HTML-Ausführung ermöglichen. - [ ] Der Editor bietet definierte Leerzustände für neue Schulungen, leere Kapitel und Seiten ohne Elemente. - [ ] Fehler beim Laden oder Speichern der Schulungskonfiguration werden im Adminpanel verständlich angezeigt. - [ ] Die Konfiguration ist so strukturiert, dass künftig weitere Elementtypen ergänzt werden können, ohne das komplette Schulungsmodell neu aufzubauen.
samuelbias self-assigned this 2026-08-29 02:10:57 +02:00
samuelbias added this to the Intranet NAK-Reinickendorf project 2026-08-29 02:10:57 +02:00
samuelbias changed title from Brandschutzschulung im Adminpanel vollständig modular erstellbar machen to Neues Feature: Brandschutzschulung im Adminpanel vollständig modular erstellbar machen 2026-08-29 02:24:59 +02:00
samuelbias changed title from Neues Feature: Brandschutzschulung im Adminpanel vollständig modular erstellbar machen to Neues Feature: Brandschutzschulung im Adminpanel vollständig modular erstellbar/bearbeitbar machen 2026-08-29 02:25:21 +02:00
samuelbias added the Feature label 2026-08-29 12:56:38 +02:00
samuelbias changed title from Neues Feature: Brandschutzschulung im Adminpanel vollständig modular erstellbar/bearbeitbar machen to [FEATURE] web/brandschutz - Brandschutzschulung im Adminpanel vollständig modular erstellbar/bearbeitbar machen 2026-08-31 18:59:09 +02:00
samuelbias moved this to Next in Intranet NAK-Reinickendorf on 2026-09-04 19:21:35 +02:00
samuelbias moved this to In Progress in Intranet NAK-Reinickendorf on 2026-09-06 10:42:52 +02:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Bugfix
Fehler in vorhandener Implementierung beheben
 Documentation
Keine Code-Arbeit, reine Doku-Arbeit
 Feature
Neues Feature implementieren oder vorhandenes anpassen
 Refactoring
Verbesserung von bestehendem, funktionierenden Quellcode (OHNE äußeres Verhalten oder die Funktion des Programms zu verändern)
No labels Feature
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Intranet NAK-Reinickendorf
In Progress
Assignees
Clear assignees
Jonathan (Jonathan Bias) leoniefink (Leonie Fink) markusvonhobe (Markus von Hobe) renegrasse (René Grasse) samuelbias (Samuel Bias)
No Assignees samuelbias
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: NAK-Reinickendorf/intranet#9