BauIN/docs/datenmodell.md

KI-BauIN – Datenmodell (Kern)

Stand: 5. Oktober 2026. Grundlage für Phase 1. Später ergänzt werden LV-Positionen und Vorbemerkungen (GAEB-Import, AP5), Prüfung, Feedback und Regeln (AP6–AP8) sowie die Einstellungen der KI-Schnittstelle (AP3).

Übersicht

erDiagram
    MANDANT ||--o{ PROJEKT : hat
    MANDANT ||--o{ AUFTRAGNEHMER : hat
    MANDANT ||--o{ USER : hat
    PROJEKT ||--o{ ABSCHNITT : "gliedert sich in (PFA)"
    ABSCHNITT ||--o{ VERTRAG : enthält
    AUFTRAGNEHMER ||--o{ VERTRAG : "ist Partner von"
    VERTRAG ||--o{ LEISTUNGSVERZEICHNIS : "hat (oft 20–35)"
    VERTRAG ||--o{ NACHTRAG : "erhält"
    NACHTRAG ||--o{ NACHTRAGSPOSITION : hat
    PROJEKT ||--o{ DOKUMENT : "enthält"
    LEISTUNGSVERZEICHNIS ||--o{ DOKUMENT : "X86, D86, PDF"
    NACHTRAG ||--o{ DOKUMENT : "Nachtrags-LV, Anschreiben, Anlagen"
    PROJEKT }o--o{ USER : "Mitglieder mit Projektrolle"
    DOKUMENT }o--o{ USER : "Freigaben (vertraulich)"

Modell	Tabelle	Inhalt
Mandant	mandanten	Kunde der Anwendung (im Pilot nur BauIn)
Projekt	projekte	z. B. „Elektrifizierung Musterbahn“; Auftraggeber, Vertragsgrundlage, Status, Suchreihenfolge
Abschnitt	abschnitte	PFA bzw. Abschnitt; die Bezeichnung „PFA“ steht am Projekt (abschnitt_bezeichnung)
Auftragnehmer	auftragnehmer	Firma oder ARGE; kann in mehreren PFAs Verträge haben
Vertrag	vertraege	Auftrag an einen Auftragnehmer in einem Abschnitt, z. B. „Gleisbau“
Leistungsverzeichnis	leistungsverzeichnisse	ein LV des Vertrags; Dateien als Dokumente, Importstatus
Nachtrag	nachtraege	Nr., Eingang, Betreff, MKA-Bezug (Liste), Status, zugewiesen an
Nachtragsposition	nachtragspositionen	OZ, Kurztext, Langtext, Menge, Einheit, EP (nur Information)
Dokument	dokumente	hochgeladene Datei; gehört zu Projekt und optional zu LV, Nachtrag usw.; vertraulich ja/nein

Pivot-Tabellen: projekt_mitglieder (Benutzer, Projekt, Projektrolle) und dokument_freigaben (vertrauliche Dokumente für benannte Personen).

Festlegungen

• Mandant, Land und Projekt an jedem Fachdatensatz. mandant_id und land stehen an allen Fachtabellen; projekt_id an allem unterhalb des Projekts. Die Werte werden beim Speichern vom übergeordneten Datensatz übernommen (App\Models\Concerns\ErbtZuordnung). Ein Datensatz, der auf einen Datensatz eines anderen Mandanten, Landes oder Projekts zeigt, wird abgewiesen. Das gilt auch für Vertrag und Auftragnehmer.
• Rollen: Globale Rollen (Administrator, Regelverantwortlicher) über Spatie laravel-permission. Projektrollen (Projektleiter, Bearbeiter, Leser) in projekt_mitglieder, weil sie je Projekt verschieden sind. Der Teams-Modus von Spatie bleibt aus.
• MKA nur als Bezug: nachtraege.mka_bezug ist eine Liste von Nummern (Fragenkatalog A8).
• Dokumente polymorph: dokumentable zeigt auf LV, Nachtrag oder Vertrag; projekt_id bleibt für die Rechteprüfung immer gesetzt. Ohne Projekt ist es ein allgemeines Dokument (Einstellungen). Die Morph-Namen sind fest (projekt, vertrag, leistungsverzeichnis, nachtrag, user), damit Klassennamen nicht in der Datenbank stehen.
• Löschen: Fachdaten werden nicht kaskadierend gelöscht; ein Projekt mit Abschnitten lässt sich nicht löschen, sondern wird archiviert. Ausnahmen: Nachtragspositionen hängen am Nachtrag, Pivot-Einträge an ihren beiden Seiten.
• Suchreihenfolge je Projekt (vorläufig, Fragenkatalog A10): andere Verträge im selben Abschnitt einbeziehen = nein, andere Abschnitte = ja, nur gleicher Auftragnehmer = nein.
• Beträge als Dezimalzahlen (Menge 15,3, EP 15,2); Preise sind in Phase 1 nur Information.