Datenmodell Kern: Projekt, PFA, Vertrag, LV, Nachtrag, Dokument

- Mandant, Auftragnehmer, Projekt mit Suchreihenfolge, Abschnitt (PFA), Vertrag, Leistungsverzeichnis, Nachtrag (MKA nur als Bezug), Nachtragsposition, Dokument - Projektmitglieder mit Projektrolle, Freigaben für vertrauliche Dokumente - Mandant, Land und Projekt werden vom übergeordneten Datensatz übernommen; Fehlzuordnungen über Mandanten oder Projekte hinweg werden abgewiesen - Feste Morph-Map, Factories, Demodaten (Musterbahn, PFA 1–4, N14/N16/N21), Tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 08:34:24 +02:00
parent ca09d23a78
commit 6aac8b0a16
37 changed files with 1855 additions and 2 deletions
@@ -0,0 +1,116 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\Land;
+use App\Enums\Projektrolle;
+use App\Enums\ProjektStatus;
+use App\Enums\Vertragsgrundlage;
+use Carbon\CarbonImmutable;
+use Database\Factories\ProjektFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Attributes\Table;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/**
+ * Bauprojekt, z. B. „Elektrifizierung Musterbahn“. Gliedert sich in Abschnitte (PFA).
+ *
+ * @property int $id
+ * @property int $mandant_id
+ * @property Land $land
+ * @property string $name
+ * @property string|null $nummer
+ * @property string $auftraggeber
+ * @property Vertragsgrundlage $vertragsgrundlage
+ * @property string $abschnitt_bezeichnung
+ * @property ProjektStatus $status
+ * @property bool $suche_andere_vertraege_im_abschnitt
+ * @property bool $suche_andere_abschnitte
+ * @property bool $suche_nur_gleicher_auftragnehmer
+ * @property CarbonImmutable|null $created_at
+ * @property CarbonImmutable|null $updated_at
+ */
+#[Table('projekte')]
+#[Fillable([
+    'mandant_id', 'land', 'name', 'nummer', 'auftraggeber', 'vertragsgrundlage',
+    'abschnitt_bezeichnung', 'status', 'suche_andere_vertraege_im_abschnitt',
+    'suche_andere_abschnitte', 'suche_nur_gleicher_auftragnehmer',
+])]
+class Projekt extends Model
+{
+    /** @use HasFactory<ProjektFactory> */
+    use HasFactory;
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'land' => Land::class,
+            'vertragsgrundlage' => Vertragsgrundlage::class,
+            'status' => ProjektStatus::class,
+            'suche_andere_vertraege_im_abschnitt' => 'boolean',
+            'suche_andere_abschnitte' => 'boolean',
+            'suche_nur_gleicher_auftragnehmer' => 'boolean',
+        ];
+    }
+
+    /** @return BelongsTo<Mandant, $this> */
+    public function mandant(): BelongsTo
+    {
+        return $this->belongsTo(Mandant::class);
+    }
+
+    /** @return HasMany<Abschnitt, $this> */
+    public function abschnitte(): HasMany
+    {
+        return $this->hasMany(Abschnitt::class)->orderBy('sortierung')->orderBy('id');
+    }
+
+    /** @return HasMany<Vertrag, $this> */
+    public function vertraege(): HasMany
+    {
+        return $this->hasMany(Vertrag::class);
+    }
+
+    /** @return HasMany<Nachtrag, $this> */
+    public function nachtraege(): HasMany
+    {
+        return $this->hasMany(Nachtrag::class);
+    }
+
+    /** @return HasMany<Dokument, $this> */
+    public function dokumente(): HasMany
+    {
+        return $this->hasMany(Dokument::class);
+    }
+
+    /** @return BelongsToMany<User, $this> */
+    public function mitglieder(): BelongsToMany
+    {
+        return $this->belongsToMany(User::class, 'projekt_mitglieder')
+            ->withPivot('rolle')
+            ->withTimestamps();
+    }
+
+    /**
+     * Rolle des Benutzers in diesem Projekt oder null, wenn er kein Mitglied ist.
+     */
+    public function rolleVon(User $user): ?Projektrolle
+    {
+        /** @var string|null $rolle */
+        $rolle = $this->mitglieder()->whereKey($user->getKey())->value('projekt_mitglieder.rolle');
+
+        return $rolle === null ? null : Projektrolle::from($rolle);
+    }
+
+    public function istArchiviert(): bool
+    {
+        return $this->status === ProjektStatus::Archiviert;
+    }
+}