Files
ChristophandClaude Opus 5.5 6aac8b0a16 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

117 lines
3.4 KiB
PHP

<?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;
}
}