'Alle 6 Monate', 12 => 'Jährlich', 24 => 'Alle 2 Jahre', 36 => 'Alle 3 Jahre']; public function __construct(private readonly QmAccess $access) {} /** Status eines Termins: overdue | due (innerhalb der Vorlaufzeit) | planned | null */ public static function state(QmEntry $entry): ?string { if (! $entry->review_due_at) { return null; } return match (true) { $entry->review_due_at->isBefore(today()) => 'overdue', $entry->review_due_at->isBefore(today()->addDays(self::LEAD_DAYS + 1)) => 'due', default => 'planned', }; } public function canSee(?User $user): bool { return $user && ($this->access->canManage($user) || QmEntry::query()->where('responsible_id', $user->id)->whereNotNull('review_due_at')->exists()); } public function canComplete(QmEntry $entry, ?User $user): bool { return $user && ($this->access->canManage($user) || $entry->responsible_id === $user->id); } /** * Alle Termine (QM-Team) bzw. die eigenen (Verantwortliche), fällige zuerst. * * @return Collection */ public function list(User $user): Collection { return QmEntry::query() ->whereNotNull('review_due_at') ->when(! $this->access->canManage($user), fn (Builder $q) => $q->where('responsible_id', $user->id)) ->with(['responsible', 'reviewer', 'readingFile', 'editableFile']) ->orderBy('review_due_at') ->get(); } /** Anzahl überfälliger und bald fälliger Termine für die Person */ public function openCount(User $user): int { return QmEntry::query() ->whereNotNull('review_due_at') ->where('review_due_at', '<=', today()->addDays(self::LEAD_DAYS)) ->when(! $this->access->canManage($user), fn (Builder $q) => $q->where('responsible_id', $user->id)) ->count(); } /** * Prüfung erledigt: nächster Termin nach Intervall (ohne Intervall: keiner). */ public function complete(QmEntry $entry, User $user): void { $entry->forceFill([ 'reviewed_at' => now(), 'reviewed_by' => $user->id, 'review_due_at' => $entry->review_interval_months ? today()->addMonthsNoOverflow($entry->review_interval_months) : null, 'review_notified_at' => null, ])->save(); Audit::log('qm.entry_reviewed', ['entry' => $entry->id, 'title' => $entry->title, 'next' => $entry->review_due_at?->toDateString()]); } /** * Täglich: fällige Termine melden (einmal je Termin). */ public function notifyDue(): int { $entries = QmEntry::query() ->whereNotNull('review_due_at') ->whereNull('review_notified_at') ->where('review_due_at', '<=', today()->addDays(self::LEAD_DAYS)) ->with(['responsible', 'folder']) ->get(); foreach ($entries as $entry) { $recipient = $entry->responsible ?? User::query()->find($entry->created_by); if ($recipient?->is_active) { $overdue = $entry->review_due_at->isBefore(today()); $recipient->notify(new PortalNotification( $overdue ? 'QM-Prüfung überfällig' : 'QM-Prüfung steht an', '„'.$entry->title.'“ – fällig am '.$entry->review_due_at->format('d.m.Y').'.', route('qm.reviews'), 'calendar-clock', )); } $entry->forceFill(['review_notified_at' => now()])->save(); } return $entries->count(); } }