Zum Inhalt

Roadmap-Synchronisierung zum Prisma-Zielschema v3

Stand: 12.10.2026 09:58 Branch: main Status: Roadmap

Änderungshistorie anzeigen

Bezug:

  • backend/prisma/schema.prisma v3
  • docs/developer/database/db-schema.md v6
  • docs/developer/database/schema-abgleich/db-schema-zielbild-uc-matrix.md
  • docs/developer/database/schema-abgleich/db-schema-entscheidungen-phase-2.md

Zweck

Dieses Dokument hält die Roadmap-Korrekturen fest, die sich aus der Schema-Bereinigung ergeben.

Die eigentliche Roadmap docs/management/roadmap.md bleibt das führende Management-Dokument. Dieses Sync-Dokument markiert verbindlich, welche Aussagen dort nachzuführen sind, damit Roadmap und Prisma-Zielschema konsistent bleiben.

1. Status UC00 Datenmodell

Der Status „UC00 Schritt 3: Datenmodell“ darf nicht mehr als schlicht abgeschlossen geführt werden.

Neuer Status:

🟡 In Bereinigung – Prisma-Schema v3 erstellt, Doku/SQL/Backend-Nachzug offen

Begründung:

  • Prisma-Schema wurde auf v3 erweitert.
  • db-schema.md wurde auf v6 synchronisiert.
  • SQL-Scripte und mehrere UC-/GEM-Dokumente sind noch nachzuführen.

2. V1-Schema-Tabellen

Die Roadmap-Tabelle „Schema-Tabellen Version 1“ muss gegenüber dem bisherigen 18-Tabellen-Stand erweitert werden.

Zusätzlich oder präzisiert aufzunehmen sind:

Tabelle Version Status Grund
refresh_tokens V1 GREEN Session-Handling / Refresh-Token-Rotation
recovery_codes V1 GREEN UC00 2FA-Recovery
notification_templates V1 GREEN UC00 / UC07 E-Mail-Templates
equipment_notes V1 GREEN UC01 strukturierte Notizen
equipment_identifiers V1 GREEN UC01 QR-Code / Identifier
fill_subscriptions V1 GREEN UC03 Füll-Abo
fill_cards V1 GREEN UC03 Füllkarten
fill_card_transactions V1 GREEN UC03 Füllkartenbuchungen

3. Roadmap-Korrektur zu customers.organization_id

Die bisherige Roadmap-Aussage:

customers.organization_id ist in V1 bereits als nullable FK vorbereitet

ist nach der Schemaentscheidung nicht mehr korrekt.

Neue Aussage:

organizations und eine organisatorische Gruppierung von Kunden bleiben V2. customers.organization_id wird in V1 nicht ergänzt.

Begründung:

  • V1 hält Customer bewusst als natürliche Person.
  • UC06 Portal-Verknüpfung erfolgt über Customer.userId.
  • Organisationslogik bleibt V2.

4. UC18 Equipment-Verleih

UC18 bleibt V2/Backlog.

Roadmap-Aussage bleibt gültig:

  • UC18 ist als optionales V2-Zusatzmodul vorgesehen.
  • UC18 setzt fachlich auf UC01 Equipment erfassen auf.
  • Spätere Tabellen bleiben V2:
  • rental_transactions
  • rental_items
  • rental_condition_logs

Zusätzlicher Roadmap-Hinweis:

V1 berücksichtigt UC18 als V2-Kompatibilitätsanforderung. Das V1-Schema darf spätere Verleihhistorien nicht blockieren. Verleihstatus wird nicht direkt in equipment modelliert.

5. UC01 Equipment-Core

Die Roadmap sollte UC01 nicht nur als „Equipment erfassen“ führen, sondern die neuen V1-Schemaobjekte erwähnen:

  • equipment_notes
  • equipment_identifiers
  • data_quality_status
  • assignment_type
  • inventory_number
  • display_name

6. UC03 Füll-Abo und Füllkarten

Da UC03 V1 ist, sind die neuen Tabellen in der Roadmap zu ergänzen:

  • fill_subscriptions
  • fill_cards
  • fill_card_transactions

V1 bleibt bewusst ohne vollständige Rechnungs-/Order-Engine.

7. Offene Roadmap-Nacharbeit

  • [ ] docs/management/roadmap.md direkt nachführen.
  • [ ] Änderungshistorie der Roadmap um Schema-Sync v1.6 ergänzen.
  • [ ] customers.organization_id-Hinweise entfernen oder korrigieren.
  • [ ] V1-Tabellenliste um die oben genannten Tabellen ergänzen.
  • [ ] UC18 als V2-Kompatibilitätsanforderung ausdrücklich markieren.

Änderungshistorie

Datum, Uhrzeit Version Änderung Autor
12.10.2026 09:58 1.2 Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) Claude
12.10.2026 09:08 1.1 Branch-Angabe im Kopfbereich auf main korrigiert Claude
01.08.2026 14:55 1.0 Kopfbereich vereinheitlicht David Mittig