M1: CRUD-Slice 'Mahlzeit' Schritt 1 – Logik + Daten + Tests
Rich-Model Mahlzeit (MahlzeitStatus, Wochentag) mit Invarianten und Zustandsübergängen; DTOs + MahlzeitFactory (reine Mapping-Funktionen); Manager (create hängt an Ende an: maxSortOrder+1, find → 404) und Create/Update/Delete-UseCases mit Transaktion + Events nach Commit. Data-Layer: MahlzeitEntity (Tabelle essens_mahlzeiten, wochentage als CSV), Mapper (CSV/Enum/null), Provider (find/list/maxSortOrder), Processor (create/save/delete). DI-Bindings in services.yaml. ClockInterface (Logic) + SystemClock (Data). Tests: Model/Factory/UseCase-Unit + Provider/Processor/Mapper-Integration (In-Mem-SQLite). composer test grün (53 Tests, 161 Assertions).
This commit is contained in:
@@ -0,0 +1,232 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App\Logic\Essen\Model;
|
||||
|
||||
use App\Logic\Common\Exception\BusinessRuleViolationException;
|
||||
|
||||
/**
|
||||
* Aggregat "Mahlzeit" – reines Rich Domain Model (POPO, kein Framework).
|
||||
*
|
||||
* Unveränderlich: Zustandsübergaben geben ein neues Modell zurück und kapseln
|
||||
* dabei die fachlichen Regeln (Status + Zeitstempel). `sort_order` wird nicht
|
||||
* über `mitSortOrder` verändert, sondern über eine dedizierte Transition.
|
||||
*/
|
||||
final class Mahlzeit
|
||||
{
|
||||
/**
|
||||
* @param int $id
|
||||
* @param non-empty-string $name
|
||||
* @param non-empty-string $notiz
|
||||
* @param list<Wochentag> $wochentage
|
||||
* @param int $sortOrder Position in der Planungsliste (>= 0)
|
||||
* @param MahlzeitStatus $status
|
||||
* @param \DateTimeImmutable $erstelltAm
|
||||
* @param \DateTimeImmutable $aktualisiertAm
|
||||
* @param \DateTimeImmutable|null $gegessenAm
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly int $id,
|
||||
public readonly string $name,
|
||||
public readonly string $notiz,
|
||||
public readonly array $wochentage,
|
||||
public readonly int $sortOrder,
|
||||
public readonly MahlzeitStatus $status,
|
||||
public readonly \DateTimeImmutable $erstelltAm,
|
||||
public readonly \DateTimeImmutable $aktualisiertAm,
|
||||
public readonly ?\DateTimeImmutable $gegessenAm,
|
||||
) {
|
||||
foreach ($wochentage as $wochentag) {
|
||||
if (!$wochentag instanceof Wochentag) {
|
||||
throw new \TypeError('wochentage muss eine Liste von Wochentag sein.');
|
||||
}
|
||||
}
|
||||
|
||||
if ($status === MahlzeitStatus::Gegessen && $gegessenAm === null) {
|
||||
throw new BusinessRuleViolationException('Eine gegessene Mahlzeit benötigt einen gegessenAm-Zeitpunkt.');
|
||||
}
|
||||
if ($status === MahlzeitStatus::Geplant && $gegessenAm !== null) {
|
||||
throw new BusinessRuleViolationException('Eine geplante Mahlzeit darf keinen gegessenAm-Zeitpunkt haben.');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Anlegen einer neuen, geplanten Mahlzeit (noch keine ID – die bekommt die Persistenz).
|
||||
*
|
||||
* @param non-empty-string $name
|
||||
* @param non-empty-string $notiz
|
||||
* @param list<Wochentag> $wochentage
|
||||
*/
|
||||
public static function anlegen(
|
||||
string $name,
|
||||
string $notiz,
|
||||
array $wochentage,
|
||||
int $sortOrder,
|
||||
\DateTimeImmutable $jetzt,
|
||||
): self {
|
||||
return new self(
|
||||
id: 0,
|
||||
name: \trim($name),
|
||||
notiz: \trim($notiz),
|
||||
wochentage: $wochentage,
|
||||
sortOrder: $sortOrder,
|
||||
status: MahlzeitStatus::Geplant,
|
||||
erstelltAm: $jetzt,
|
||||
aktualisiertAm: $jetzt,
|
||||
gegessenAm: null,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Bearbeiten der Inhalt-Felder (Name, Notiz, Wochentage, Reihenfolge).
|
||||
* Status/Zeitstempel bleiben dabei erhalten.
|
||||
*
|
||||
* @param non-empty-string $name
|
||||
* @param non-empty-string $notiz
|
||||
* @param list<Wochentag> $wochentage
|
||||
*/
|
||||
public function aktualisieren(
|
||||
string $name,
|
||||
string $notiz,
|
||||
array $wochentage,
|
||||
int $sortOrder,
|
||||
\DateTimeImmutable $jetzt,
|
||||
): self {
|
||||
if (\trim($name) === '') {
|
||||
throw new BusinessRuleViolationException('name ist ein Pflichtfeld.');
|
||||
}
|
||||
|
||||
foreach ($wochentage as $wochentag) {
|
||||
if (!$wochentag instanceof Wochentag) {
|
||||
throw new BusinessRuleViolationException('wochentage enthält einen ungültigen Wochentag.');
|
||||
}
|
||||
}
|
||||
|
||||
return $this->neuesModell(
|
||||
name: \trim($name),
|
||||
notiz: \trim($notiz),
|
||||
wochentage: $wochentage,
|
||||
sortOrder: $sortOrder,
|
||||
status: $this->status,
|
||||
gegessenAm: $this->gegessenAm,
|
||||
aktualisiertAm: $jetzt,
|
||||
);
|
||||
}
|
||||
|
||||
public function mitSortOrder(int $sortOrder): self
|
||||
{
|
||||
if ($sortOrder < 0) {
|
||||
throw new BusinessRuleViolationException('sortOrder muss >= 0 sein.');
|
||||
}
|
||||
|
||||
return $this->neuesModell(
|
||||
name: $this->name,
|
||||
notiz: $this->notiz,
|
||||
wochentage: $this->wochentage,
|
||||
sortOrder: $sortOrder,
|
||||
status: $this->status,
|
||||
gegessenAm: $this->gegessenAm,
|
||||
aktualisiertAm: $this->aktualisiertAm,
|
||||
);
|
||||
}
|
||||
|
||||
public function markAsGegessen(\DateTimeImmutable $jetzt): self
|
||||
{
|
||||
if ($this->status === MahlzeitStatus::Gegessen) {
|
||||
return $this;
|
||||
}
|
||||
|
||||
return $this->neuesModell(
|
||||
name: $this->name,
|
||||
notiz: $this->notiz,
|
||||
wochentage: $this->wochentage,
|
||||
sortOrder: $this->sortOrder,
|
||||
status: MahlzeitStatus::Gegessen,
|
||||
gegessenAm: $jetzt,
|
||||
aktualisiertAm: $jetzt,
|
||||
);
|
||||
}
|
||||
|
||||
public function markAsGeplant(\DateTimeImmutable $jetzt): self
|
||||
{
|
||||
if ($this->status === MahlzeitStatus::Geplant) {
|
||||
return $this;
|
||||
}
|
||||
|
||||
return $this->neuesModell(
|
||||
name: $this->name,
|
||||
notiz: $this->notiz,
|
||||
wochentage: $this->wochentage,
|
||||
sortOrder: $this->sortOrder,
|
||||
status: MahlzeitStatus::Geplant,
|
||||
gegessenAm: null,
|
||||
aktualisiertAm: $jetzt,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Setzt die Persistenz-ID (id) – wird vom Processor nach dem Insert verwendet.
|
||||
*/
|
||||
public function mitId(int $id): self
|
||||
{
|
||||
return new self(
|
||||
id: $id,
|
||||
name: $this->name,
|
||||
notiz: $this->notiz,
|
||||
wochentage: $this->wochentage,
|
||||
sortOrder: $this->sortOrder,
|
||||
status: $this->status,
|
||||
erstelltAm: $this->erstelltAm,
|
||||
aktualisiertAm: $this->aktualisiertAm,
|
||||
gegessenAm: $this->gegessenAm,
|
||||
);
|
||||
}
|
||||
|
||||
public function istGegessen(): bool
|
||||
{
|
||||
return $this->status === MahlzeitStatus::Gegessen;
|
||||
}
|
||||
|
||||
public function istGeplant(): bool
|
||||
{
|
||||
return $this->status === MahlzeitStatus::Geplant;
|
||||
}
|
||||
|
||||
/** @return list<Wochentag> */
|
||||
public function wochentage(): array
|
||||
{
|
||||
return $this->wochentage;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param non-empty-string $name
|
||||
* @param non-empty-string $notiz
|
||||
* @param list<Wochentag> $wochentage
|
||||
* @param int $sortOrder
|
||||
* @param MahlzeitStatus $status
|
||||
* @param \DateTimeImmutable|null $gegessenAm
|
||||
* @param \DateTimeImmutable $aktualisiertAm
|
||||
*/
|
||||
private function neuesModell(
|
||||
string $name,
|
||||
string $notiz,
|
||||
array $wochentage,
|
||||
int $sortOrder,
|
||||
MahlzeitStatus $status,
|
||||
?\DateTimeImmutable $gegessenAm,
|
||||
\DateTimeImmutable $aktualisiertAm,
|
||||
): self {
|
||||
return new self(
|
||||
id: $this->id,
|
||||
name: $name,
|
||||
notiz: $notiz,
|
||||
wochentage: $wochentage,
|
||||
sortOrder: $sortOrder,
|
||||
status: $status,
|
||||
erstelltAm: $this->erstelltAm,
|
||||
aktualisiertAm: $aktualisiertAm,
|
||||
gegessenAm: $gegessenAm,
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user