Master-Prompt-Ergebnis vom 2026-09-05 (Epic-Übersicht, vollständige Kachel- Liste, Abhängigkeitsgraph, MVP-Abgrenzung, Details zu den ersten 20 Kacheln) aus dem Chat in Dateien überführt statt nur im Gespräch zu bleiben. 00_index.md: Decisions Required, Epic-Übersicht, vollständige Kachel-Tabelle, Abhängigkeitsgraph, MVP-Abgrenzung. 01_foundation.md / 02_identity.md / 03_digital_file.md: Detailspezifikation je Kachel (Ziel/Beschreibung/Datenmodell/Rechte/Akzeptanzkriterien/Tests/DoD), jeweils mit Abgleich gegen den aktuellen MABEA-Ist-Stand. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KC8HYvv6UkCVYheYiTw9DD
124 lines
6.1 KiB
Markdown
124 lines
6.1 KiB
Markdown
# Epic 03 — Digital File (Akte)
|
|
|
|
Details zu FILE-001 … FILE-005. FILE-006 (Übersichtsseite) und FILE-007
|
|
(Audit-Anbindung) noch nicht detailliert, siehe `00_index.md`-Tabelle.
|
|
|
|
---
|
|
|
|
## FILE-001 — Akte-Grundgerüst
|
|
|
|
- **Ziel:** Zentrale Entität, die alle Teilbereiche einer Ressource bündelt.
|
|
- **Beschreibung:** Konzeptionelle „Akte" muss keine eigene Tabelle sein, sondern eine
|
|
Aggregations-Sicht (View/Backend-Endpunkt), der Stammdaten+Standort+Historie+Dokumente+
|
|
Prüfungen+Wartungen+Mängel für eine gegebene Ressourcen-ID zusammenführt.
|
|
- **Benutzerwert:** Ein Helfer/Prüfer sieht auf einen Blick alles zu einer Ressource, ohne
|
|
mehrere Screens durchklicken zu müssen.
|
|
- **Abhängigkeiten:** IDENT-001
|
|
- **Datenmodell:** kein neues Datenmodell — Aggregations-Logik über bestehende Tabellen (die
|
|
zum Zeitpunkt dieser Kachel z.T. noch nicht existieren, daher zunächst nur
|
|
Stammdaten+Historie als Platzhalter, Rest wird nachgezogen sobald die jeweiligen Module
|
|
existieren)
|
|
- **Backend:** GET /akte/{ressourcen_id} (aggregiert)
|
|
- **Frontend/Mobile:** —
|
|
- **QR-Code:** Ziel des QR-Scans (IDENT-008)
|
|
- **Seriennummer/Inventarnummer:** werden hier nur angezeigt, nicht neu verwaltet
|
|
- **Akte:** ist diese Kachel selbst
|
|
- **Rechte:** Lesen wie Ressourcen-Leserecht
|
|
- **Audit:** Akte-Aufruf selbst wird NICHT geloggt (zu granular/kein Mehrwert), nur
|
|
Änderungen an den Teilbereichen
|
|
- **Akzeptanzkriterien:** Endpunkt liefert für eine existierende Ressourcen-ID ein
|
|
zusammengesetztes JSON, für unbekannte ID 404.
|
|
- **Tests:** Aggregations-Test mit Dummy-Daten in mind. zwei Teilbereichen.
|
|
- **DoD:** Grundgerüst erweiterbar, ohne bestehende Endpunkt-Konsumenten zu brechen, wenn
|
|
neue Teilbereiche dazukommen.
|
|
|
|
## FILE-002 — Akte-Stammdatenbereich
|
|
|
|
- **Ziel:** Feste, immer sichtbare Kopfzeile jeder Akte.
|
|
- **Beschreibung:** Name, Kategorie/Typ, Inventarnummer, Seriennummer, Hersteller/Modell,
|
|
Status-Badge gebündelt.
|
|
- **Benutzerwert:** Sofortige Grundorientierung ohne Scrollen.
|
|
- **Abhängigkeiten:** FILE-001, IDENT-002/004/005, ASSET-004
|
|
- **Datenmodell:** keins neu, reine Aggregation
|
|
- **Backend:** Teil des FILE-001-Aggregations-Endpunkts
|
|
- **Frontend:** Kopfzeilen-Komponente
|
|
- **Mobile:** kompakte Variante (Karte statt Tabellenzeile)
|
|
- **QR-Code:** Druckbutton hier verankert (IDENT-007)
|
|
- **Seriennummer/Inventarnummer:** zentrale Anzeige hier
|
|
- **Akte:** ist dieser Bereich selbst
|
|
- **Rechte:** wie Lese-Recht
|
|
- **Audit:** nein (nur Anzeige)
|
|
- **Akzeptanzkriterien:** alle Kernfelder korrekt angezeigt, Status-Badge farbcodiert.
|
|
- **Tests:** Rendering-Test mit Beispieldaten.
|
|
- **DoD:** an mind. zwei unterschiedlichen Ressourcentypen (z.B. Fahrzeug + Gerät) getestet.
|
|
|
|
## FILE-003 — Akte-Standortbereich
|
|
|
|
- **Ziel:** Aktueller Standort direkt sichtbar, mit Sprung zur vollständigen
|
|
Standorthistorie.
|
|
- **Beschreibung:** Anzeige aktueller Standort (Lagerplatz/Fahrzeug/Person), Link zu
|
|
WH-Modul für Details.
|
|
- **Benutzerwert:** „Wo ist das Ding gerade" ist die häufigste Frage im Alltag.
|
|
- **Abhängigkeiten:** FILE-001, WH-001 (zumindest Platzhalter-Standortfeld, bevor
|
|
Warehouse-Epic fertig ist)
|
|
- **Datenmodell:** Referenz auf aktuellen Standort (Feld existiert ggf. schon am Asset,
|
|
hier nur Anzeige)
|
|
- **Backend:** Teil des Aggregations-Endpunkts
|
|
- **Frontend:** Standort-Kachel in der Akte
|
|
- **Mobile:** gleiche Anzeige, kompakt
|
|
- **QR-Code/Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** ist dieser Bereich
|
|
- **Rechte:** wie Lese-Recht
|
|
- **Audit:** nein (Standortänderung selbst wird in WH-Modul geloggt, hier nur Anzeige)
|
|
- **Akzeptanzkriterien:** aktueller Standort korrekt, Link funktioniert.
|
|
- **Tests:** Rendering-Test.
|
|
- **DoD:** funktioniert, sobald WH-001 minimal existiert (auch als Platzhalter-Freitextfeld
|
|
vor vollem Warehouse-Modul akzeptabel).
|
|
|
|
## FILE-004 — Akte-Verantwortlichkeitsbereich
|
|
|
|
- **Ziel:** Klar erkennbar, wer für eine Ressource zuständig ist.
|
|
- **Beschreibung:** Anzeige zuständige Person/Einheit (aus Personnel-Epic).
|
|
- **Benutzerwert:** Ansprechpartner bei Fragen/Problemen sofort ersichtlich.
|
|
- **Abhängigkeiten:** FILE-001, PERS-003 (zumindest Einheiten-Grundgerüst)
|
|
- **Datenmodell:** Referenz auf zuständige Einheit/Person
|
|
- **Backend:** Teil des Aggregations-Endpunkts
|
|
- **Frontend:** Verantwortlichkeits-Kachel
|
|
- **Mobile:** gleiche Anzeige
|
|
- **QR-Code/Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** ist dieser Bereich
|
|
- **Rechte:** wie Lese-Recht; Ändern nur Administrator/Zugführer
|
|
- **Audit:** Änderung wird geloggt
|
|
- **Akzeptanzkriterien:** Zuständigkeit anzeigen/ändern funktioniert, Änderung geloggt.
|
|
- **Tests:** Anzeige- und Änderungstest.
|
|
- **DoD:** funktioniert mit mind. einer Einheit.
|
|
|
|
## FILE-005 — Akte-Historienbereich
|
|
|
|
- **Ziel:** Chronologische Ereignisliste je Ressource, direkt in der Akte statt in einem
|
|
separaten globalen Log.
|
|
- **Beschreibung:** Gefilterte Sicht auf FOUND-006 (Audit-Log), gefiltert nach
|
|
`entitaet_id`.
|
|
- **Benutzerwert:** „Was ist mit diesem Gerät in letzter Zeit passiert" auf einen Blick.
|
|
- **Abhängigkeiten:** FILE-001, FOUND-006
|
|
- **Datenmodell:** keins neu
|
|
- **Backend:** Filter-Query auf Audit-Log nach Ressourcen-ID
|
|
- **Frontend:** Zeitleisten-Komponente in der Akte
|
|
- **Mobile:** kompakte Liste
|
|
- **QR-Code/Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** ist dieser Bereich
|
|
- **Rechte:** wie Lese-Recht (evtl. eingeschränkter als Vollzugriff auf globales Audit-Log)
|
|
- **Audit:** zeigt Audit-Daten, erzeugt selbst keine
|
|
- **Akzeptanzkriterien:** Ereignisse chronologisch, korrekt gefiltert auf die Ressource.
|
|
- **Tests:** Filter-Test mit mehreren Ressourcen (keine Vermischung).
|
|
- **DoD:** mind. drei unterschiedliche Ereignistypen sichtbar getestet.
|
|
|
|
---
|
|
|
|
**MABEA-Ist-Stand-Abgleich:** Das gesamte Digital-File-Epic **fehlt in MABEA komplett** —
|
|
es gibt keine gebündelte Akte-Ansicht, nur Einzelseiten (Objektliste, Historie-Filter,
|
|
Dokumente-Panel je Ressource getrennt aufrufbar). Größte konkrete Lücke aus diesem Backlog
|
|
gegenüber dem MABEA-Ist-Stand, obwohl alle Bausteine (Stammdaten, Standort, Historie,
|
|
Dokumente, Prüfungen, Mängel) einzeln bereits existieren — es fehlt nur die
|
|
Aggregations-Seite/der Aggregations-Endpunkt, der sie bündelt.
|