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>

database/factories/AbschnittFactory.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Abschnitt;
+use App\Models\Projekt;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Abschnitt>
+ */
+class AbschnittFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'projekt_id' => Projekt::factory(),
+            'bezeichnung' => 'PFA '.fake()->unique()->numberBetween(1, 999999),
+            'sortierung' => 0,
+        ];
+    }
+}

database/factories/AuftragnehmerFactory.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\Land;
+use App\Models\Auftragnehmer;
+use App\Models\Mandant;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Auftragnehmer>
+ */
+class AuftragnehmerFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'mandant_id' => Mandant::factory(),
+            'land' => Land::DE,
+            'name' => fake()->unique()->company(),
+        ];
+    }
+}

database/factories/DokumentFactory.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\DokumentKategorie;
+use App\Models\Dokument;
+use App\Models\Projekt;
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Str;
+
+/**
+ * @extends Factory<Dokument>
+ */
+class DokumentFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        $uuid = (string) Str::uuid();
+
+        return [
+            'projekt_id' => Projekt::factory(),
+            'kategorie' => DokumentKategorie::Sonstiges,
+            'dateiname' => 'beispiel.pdf',
+            'pfad' => 'dokumente/'.$uuid.'.pdf',
+            'mime_type' => 'application/pdf',
+            'groesse' => fake()->numberBetween(10_000, 5_000_000),
+            'sha256' => hash('sha256', $uuid),
+            'vertraulich' => false,
+        ];
+    }
+
+    /**
+     * Dokument zu einem LV, Nachtrag oder Vertrag; Projekt, Mandant und Land kommen von dort.
+     */
+    public function zu(Model $dokumentable, DokumentKategorie $kategorie): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'projekt_id' => null,
+            'dokumentable_type' => $dokumentable->getMorphClass(),
+            'dokumentable_id' => $dokumentable->getKey(),
+            'kategorie' => $kategorie,
+        ]);
+    }
+
+    public function vertraulich(): static
+    {
+        return $this->state(fn (array $attributes) => ['vertraulich' => true]);
+    }
+}

database/factories/LeistungsverzeichnisFactory.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\VerarbeitungStatus;
+use App\Models\Leistungsverzeichnis;
+use App\Models\Vertrag;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Leistungsverzeichnis>
+ */
+class LeistungsverzeichnisFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'vertrag_id' => Vertrag::factory(),
+            'bezeichnung' => sprintf('LV %02d %s', fake()->numberBetween(1, 35), fake()->randomElement([
+                'Baustelleneinrichtung', 'Oberbau', 'Entwässerung', 'Kabeltiefbau', 'Erdbau',
+            ])),
+            'import_status' => VerarbeitungStatus::Wartet,
+        ];
+    }
+}

database/factories/MandantFactory.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Mandant;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Mandant>
+ */
+class MandantFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => fake()->unique()->company(),
+        ];
+    }
+}

database/factories/NachtragFactory.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\NachtragStatus;
+use App\Models\Nachtrag;
+use App\Models\Vertrag;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Nachtrag>
+ */
+class NachtragFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'vertrag_id' => Vertrag::factory(),
+            'nummer' => 'N'.fake()->unique()->numberBetween(1, 999999),
+            'eingang_am' => fake()->dateTimeBetween('-3 months'),
+            'betreff' => fake()->sentence(4),
+            'mka_bezug' => ['MKA '.fake()->numberBetween(1, 200)],
+            'status' => NachtragStatus::Eingegangen,
+        ];
+    }
+}

database/factories/NachtragspositionFactory.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Nachtrag;
+use App\Models\Nachtragsposition;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Nachtragsposition>
+ */
+class NachtragspositionFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'nachtrag_id' => Nachtrag::factory(),
+            'oz' => sprintf('01.%07d', fake()->unique()->numberBetween(1, 9999999)),
+            'kurztext' => fake()->sentence(5),
+            'langtext' => fake()->paragraph(),
+            'menge' => fake()->randomFloat(3, 1, 2000),
+            'einheit' => fake()->randomElement(['m', 'm²', 'm³', 'St', 'psch']),
+            'einheitspreis' => fake()->randomFloat(2, 1, 500),
+            'sortierung' => 0,
+        ];
+    }
+}

database/factories/ProjektFactory.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\Land;
+use App\Enums\ProjektStatus;
+use App\Enums\Vertragsgrundlage;
+use App\Models\Mandant;
+use App\Models\Projekt;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Projekt>
+ */
+class ProjektFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'mandant_id' => Mandant::factory(),
+            'land' => Land::DE,
+            'name' => 'Elektrifizierung '.fake()->city(),
+            'nummer' => fake()->numerify('P-####'),
+            'auftraggeber' => 'DB InfraGO AG',
+            'vertragsgrundlage' => Vertragsgrundlage::VobB,
+            'abschnitt_bezeichnung' => 'PFA',
+            'status' => ProjektStatus::Aktiv,
+        ];
+    }
+
+    public function archiviert(): static
+    {
+        return $this->state(fn (array $attributes) => ['status' => ProjektStatus::Archiviert]);
+    }
+}

database/factories/VertragFactory.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Abschnitt;
+use App\Models\Auftragnehmer;
+use App\Models\Vertrag;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Vertrag>
+ */
+class VertragFactory extends Factory
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'abschnitt_id' => Abschnitt::factory(),
+            // Auftragnehmer im selben Mandanten und Land wie der Abschnitt
+            'auftragnehmer_id' => function (array $attributes) {
+                $abschnitt = Abschnitt::query()->whereKey($attributes['abschnitt_id'])->firstOrFail();
+
+                return Auftragnehmer::factory()->state([
+                    'mandant_id' => $abschnitt->mandant_id,
+                    'land' => $abschnitt->land,
+                ]);
+            },
+            'bezeichnung' => fake()->randomElement(['Gleisbau', 'Tunnelbau', 'Oberleitung', 'Kabeltiefbau']),
+            'vertragsnummer' => fake()->numerify('V-#####'),
+            'vertrag_vom' => fake()->dateTimeBetween('-2 years', '-1 month'),
+        ];
+    }
+}