scripte/MABEA

Fork 0

Files

T

patrickandClaude Sonnet 5 0132bb9ec9

CI / backend-tests (push) Successful in 1m57s

Details

CI / frontend-build (push) Successful in 18s

Details

docs: Benutzerhandbuch mit Funktionsübersicht und Tastenkombinationen

Bisher gab es keine reine Nutzer-Doku, nur technisches Backlog
(arbeitskacheln/) und Projekthistorie (GESAMTDOKUMENT.md). Deckt
Rollen, Command Palette (Strg/Cmd+K), Kernfunktionen je Bereich,
Dark Mode/Sync-Status/Statusfarben und Benachrichtigungen ab.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CVgbozhYmuEhiEJHffRXCV

2026-09-06 13:39:40 +02:00

4.5 KiB

Raw Blame History

MABEA – Benutzerhandbuch

Kurzübersicht über Funktionen, Rollen und Tastenkombinationen. Ergänzt die technische Doku in arbeitskacheln/ (Backlog/Epics) und GESAMTDOKUMENT.md (Projekthistorie) um eine reine Nutzer-Perspektive.

Rollen

Rolle	Kernaufgabe
Mitarbeiter	Kontrolliert Objekte, füllt nach, meldet Mängel
Materialverantwortlicher	sieht Fehlbestände, genehmigt Mindermengen, pflegt Material/Lager
Leitungsverantwortlicher	erweiterte Sicht (Dashboard, Kontrollverantwortung, Eskalation)
Administration	Stammdaten, Benutzer, Rollen, volle Verwaltung

"Verantwortliche" (Materialverantwortlicher/Leitungsverantwortlicher/ Administration) sehen zusätzlich Dashboard, Fehlbestände und Verwaltung/Administration in der Seitenleiste.

Tastenkombinationen

Kombination	Aktion
`Strg`/`⌘` + `K`	Globale Suche & Quick Actions öffnen (Command Palette)
`Esc`	Command Palette schließen

In der Command Palette: Objekt-Name oder Code eintippen (springt direkt zur Akte), oder eine der Quick Actions wählen (QR scannen, Material/Lager/ Personal/Ausgabe/Verwaltung, je nach Rolle).

Grundfunktionen

Objekte

Objekte (Seitenleiste): Liste aller Fahrzeuge/Rucksäcke/Ausstattung. Suche nach Name oder Code, Button "Scannen" öffnet die Kamera für QR-Codes.
Klick auf ein Objekt startet die Kontrolle (Soll-/Ist-Abgleich je Position, Fortschritt sichtbar, Abweichungen führen automatisch zu einem Fehlbestand).
Link "Akte ansehen" öffnet die Objektakte: Stammdaten, Verantwortlichkeit, Geräte-Prüfungen, Mängel, Dokumente, Historie an einer Stelle. Ein QR-Scan führt direkt hierher (nicht mehr in die Kontrolle).

Mängel

Mängel (Seitenleiste): alle gemeldeten Mängel, Priorität niedrig/normal/hoch. Kritische (hoch, offen) Mängel blockieren die Einsatzbereitschaft eines Objekts.

Fehlbestände (Verantwortliche)

Liste aller offenen/erledigten Fehlbestände. Nachfüllung reduziert die Fehlmenge, bei 0 automatisch erledigt. Mindermengen können mit Begründung genehmigt werden (Objekt bleibt dann "eingeschränkt einsatzbereit").

Dashboard (Verantwortliche)

Karte "Was ist jetzt zu tun?" ganz oben: offene Fehlbestände, kritische Mängel, überfällige Prüfungen, abgelaufene Chargen, nie kontrollierte Objekte – mit Direktlinks.
Karte Einsatzbereitschaft: einsatzbereit/eingeschränkt/unbekannt/nicht einsatzbereit als Zahl und Badge, "Details anzeigen" listet die betroffenen Objekte mit Begründung.
Weitere Karten: nächste Prüftermine, bevorstehende Ablaufdaten, Kennzahlen, Mängel, Qualifikationsablauf.
Ist standardmäßig die Startseite für Verantwortliche nach dem Login (in der Seitenleiste per Dropdown "Startseite: automatisch/Dashboard/Objekte" umstellbar).

Verwaltung / Administration

Tabs je nach Rolle sichtbar (in der URL als /admin?tab=... verlinkbar, z. B. aus der Command Palette):

Objekte, Vorlagen, Material, Struktur, Standorte – Stammdaten.
Lager – Lagerort-Hierarchie, Lagerplätze, Bestand, Ein-/Auslagern, Umlagern zwischen Lagerplätzen.
Ausgabe/Rückgabe – wer hat gerade welches Material/Leihgerät (z. B. Funkgerät), Rückgabe schließt den Vorgang.
Benutzer, Rollen & Rechte – Zugänge und Berechtigungen.
Zuständigkeit, Kontrollverantwortung – wer ist wofür zuständig.
Personal – Qualifikationen, Einheiten.
Eskalation – Zeitschwellen für automatische Erinnerungs-/Eskalations- E-Mails bei lange offenen Fehlbeständen.
Änderungslog, Lagerbewegungen – Nachvollziehbarkeit.

Darstellung

Dark Mode: Schalter oben in der Seitenleiste (System/Hell/Dunkel), Einstellung bleibt über Neuladen hinweg erhalten.
Online-/Sync-Status: Badge oben rechts (🟢 Online, 🟡 Synchronisiert gerade, 🔴 Offline) – bei fehlender Verbindung werden Kontroll-Eingaben lokal zwischengespeichert und automatisch übertragen, sobald wieder online.
Status-Farben: 🟢 einsatzbereit, 🟡 eingeschränkt, 🔴 nicht einsatzbereit, ⚪ unbekannt/nie kontrolliert – "unbekannt" wird nie wie "einsatzbereit" dargestellt.

Benachrichtigungen

Neuer Fehlbestand löst sofort eine E-Mail an zuständige Verantwortliche aus (falls E-Mail hinterlegt und SMTP konfiguriert).
Bleibt ein Fehlbestand lange offen, folgen automatische Erinnerungs- und Eskalations-E-Mails (Zeitschwellen unter Verwaltung → Eskalation).

4.5 KiB Raw Blame History Unescape Escape