QM: Wiedervorlage und Lesebestätigung, Platzhalter für Profilbilder (0.21.0)
Some checks failed
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 3m49s
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 3m54s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 5m27s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 5m29s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 6m38s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 6m40s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 6m7s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 6m13s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m24s

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Friederich Loheide 2026-09-27 07:36:47 +00:00
parent 8701b6d1b8
commit 4d855c8a74
213 changed files with 1729 additions and 515 deletions

View file

@ -0,0 +1,32 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Wiedervorlage: Prüfintervall, letzte Prüfung und Erinnerung (Felder für Termin,
* Verantwortliche und Lesebestätigung gibt es seit der ersten QM-Migration).
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('qm_entries', function (Blueprint $table) {
$table->unsignedTinyInteger('review_interval_months')->nullable()->after('review_due_at');
$table->timestamp('reviewed_at')->nullable()->after('review_interval_months');
$table->foreignId('reviewed_by')->nullable()->after('reviewed_at')->constrained('users')->nullOnDelete();
$table->timestamp('review_notified_at')->nullable()->after('reviewed_by');
$table->index('review_due_at');
});
}
public function down(): void
{
Schema::table('qm_entries', function (Blueprint $table) {
$table->dropIndex(['review_due_at']);
$table->dropConstrainedForeignId('reviewed_by');
$table->dropColumn(['review_interval_months', 'reviewed_at', 'review_notified_at']);
});
}
};

View file

@ -0,0 +1,88 @@
<script setup>
import { computed, ref, watch } from 'vue';
import { Download, LoaderCircle } from '@lucide/vue';
import { Button } from '@/components/ui/button';
import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from '@/components/ui/dialog';
import PersonAvatar from '@/components/PersonAvatar.vue';
import { http } from '@/lib/http';
/**
* Auswertung der Lesebestätigungen eines Dokuments (QM-Team).
*/
const props = defineProps({
open: { type: Boolean, default: false },
entry: { type: Object, default: null },
});
const emit = defineEmits(['update:open']);
const report = ref(null);
const tab = ref('missing');
const query = ref('');
watch(() => props.open, async (open) => {
if (!open || !props.entry) return;
report.value = null;
query.value = '';
report.value = await http.get(`/qm/eintraege/${props.entry.id}/lesebestaetigungen`);
tab.value = report.value.missing.length ? 'missing' : 'confirmed';
});
const total = computed(() => (report.value ? report.value.confirmed.length + report.value.missing.length : 0));
const percent = computed(() => (total.value ? Math.round((report.value.confirmed.length / total.value) * 100) : 0));
const list = computed(() => {
const people = report.value?.[tab.value] ?? [];
const term = query.value.trim().toLowerCase();
return term ? people.filter((p) => [p.name, p.department, p.job_title].some((v) => v?.toLowerCase().includes(term))) : people;
});
const dateTime = new Intl.DateTimeFormat('de-DE', { dateStyle: 'medium', timeStyle: 'short' });
</script>
<template>
<Dialog :open="open" @update:open="(v) => emit('update:open', v)">
<DialogContent class="sm:max-w-lg">
<DialogHeader>
<DialogTitle>Lesebestätigungen</DialogTitle>
<DialogDescription>„{{ entry?.title }}“ – aktuelle Fassung{{ entry?.version ? ` (Version ${entry.version})` : '' }}</DialogDescription>
</DialogHeader>
<div v-if="!report" class="grid place-items-center py-10"><LoaderCircle class="size-6 animate-spin text-muted-foreground" /></div>
<template v-else>
<div>
<div class="flex items-baseline justify-between text-sm">
<span><strong class="text-lg tabular-nums">{{ report.confirmed.length }}</strong> von {{ total }} bestätigt</span>
<span class="text-muted-foreground tabular-nums">{{ percent }} %</span>
</div>
<div class="mt-2 h-2 overflow-hidden rounded-full bg-muted"><div class="h-full rounded-full bg-emerald-600" :style="{ width: `${percent}%` }" /></div>
</div>
<div class="flex flex-wrap items-center gap-2">
<div class="inline-flex rounded-md border p-0.5 text-[13px]" role="tablist">
<button type="button" role="tab" :aria-selected="tab === 'missing'" class="rounded-sm px-3 py-1" :class="tab === 'missing' ? 'bg-muted font-medium' : 'text-muted-foreground'" @click="tab = 'missing'">Offen ({{ report.missing.length }})</button>
<button type="button" role="tab" :aria-selected="tab === 'confirmed'" class="rounded-sm px-3 py-1" :class="tab === 'confirmed' ? 'bg-muted font-medium' : 'text-muted-foreground'" @click="tab = 'confirmed'">Bestätigt ({{ report.confirmed.length }})</button>
</div>
<input v-model="query" type="search" placeholder="Filtern …" aria-label="Personen filtern" class="h-8 min-w-0 flex-1 rounded-md border border-input bg-card px-2.5 text-sm focus-visible:outline-none focus-visible:ring-3 focus-visible:ring-ring/30" />
</div>
<ul class="-mx-1 max-h-80 divide-y overflow-y-auto">
<li v-for="person in list" :key="person.id" class="flex items-center gap-3 px-1 py-2">
<PersonAvatar :person="person" class="size-8 text-xs" />
<div class="min-w-0 flex-1">
<p class="truncate text-sm font-medium">{{ person.name }}</p>
<p class="truncate text-xs text-muted-foreground">{{ [person.job_title, person.department].filter(Boolean).join(' · ') || '–' }}</p>
</div>
<span v-if="person.acknowledged_at" class="shrink-0 text-xs text-muted-foreground tabular-nums">{{ dateTime.format(new Date(person.acknowledged_at.replace(' ', 'T'))) }}</span>
</li>
<li v-if="!list.length" class="py-6 text-center text-sm text-muted-foreground">{{ tab === 'missing' ? 'Alle haben bestätigt.' : 'Noch keine Bestätigungen.' }}</li>
</ul>
<div class="flex justify-end">
<Button variant="outline" size="sm" as-child><a :href="`/qm/eintraege/${entry.id}/lesebestaetigungen?format=csv`"><Download /> Als CSV (Excel)</a></Button>
</div>
</template>
</DialogContent>
</Dialog>
</template>

View file

@ -7,6 +7,7 @@ import { Input } from '@/components/ui/input';
import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from '@/components/ui/dialog';
import FormField from '@/components/FormField.vue';
import NativeSelect from '@/components/NativeSelect.vue';
import PersonPicker from '@/components/PersonPicker.vue';
import FilePick from './FilePick.vue';
/**
@ -24,7 +25,7 @@ const props = defineProps({
const emit = defineEmits(['update:open']);
const today = () => new Date().toISOString().slice(0, 10);
const form = useForm({ type: 'file', title: '', description: '', version: '', valid_from: today(), url: '', form_id: null, reading: null, editable: null, remove_editable: false });
const form = useForm({ type: 'file', title: '', description: '', version: '', valid_from: today(), url: '', form_id: null, reading: null, editable: null, remove_editable: false, review_due_at: '', review_interval_months: null, responsible_id: null, requires_acknowledgement: false });
watch(() => props.open, (open) => {
if (!open) return;
@ -42,10 +43,22 @@ watch(() => props.open, (open) => {
reading: null,
editable: null,
remove_editable: false,
review_due_at: e?.review?.due_at ?? '',
review_interval_months: e?.review?.interval_months ?? null,
responsible_id: e?.review?.responsible?.id ?? null,
requires_acknowledgement: e?.requires_acknowledgement ?? false,
});
form.reset();
});
const intervals = [
{ value: null, label: 'Einmalig' },
{ value: 6, label: 'Alle 6 Monate' },
{ value: 12, label: 'Jährlich' },
{ value: 24, label: 'Alle 2 Jahre' },
{ value: 36, label: 'Alle 3 Jahre' },
];
const types = [
{ value: 'file', label: 'Datei', icon: FileText },
{ value: 'link', label: 'Link', icon: Link2 },
@ -122,6 +135,28 @@ function submit() {
<NativeSelect id="qm-form" v-model="form.form_id" :options="[{ value: null, label: 'Bitte wählen …' }, ...forms]" />
</FormField>
<fieldset v-if="mode !== 'version'" class="grid gap-4 rounded-lg border bg-muted/30 p-4">
<legend class="px-1 text-[13px] font-semibold">Prüfung und Kenntnisnahme</legend>
<div class="grid gap-4 sm:grid-cols-2">
<FormField id="qm-review" label="Nächste Prüfung (Wiedervorlage)" :error="form.errors.review_due_at">
<Input id="qm-review" v-model="form.review_due_at" type="date" />
</FormField>
<FormField id="qm-interval" label="Danach" :error="form.errors.review_interval_months">
<NativeSelect id="qm-interval" v-model="form.review_interval_months" :options="intervals" :disabled="!form.review_due_at" />
</FormField>
</div>
<FormField id="qm-responsible" label="Verantwortlich" :error="form.errors.responsible_id" hint="Wird vor der Prüfung im Portal erinnert und kann sie als erledigt vermerken.">
<PersonPicker id="qm-responsible" v-model="form.responsible_id" :person="entry?.review?.responsible" />
</FormField>
<label class="flex items-start gap-2.5 text-sm">
<input v-model="form.requires_acknowledgement" type="checkbox" class="mt-0.5 size-4 accent-(--color-brand)" />
<span>
<span class="font-medium">Lesebestätigung anfordern</span>
<span class="block text-[13px] text-muted-foreground">Alle, die den Ordner sehen, bestätigen „Gelesen und verstanden“ – bei jeder neuen Fassung erneut.</span>
</span>
</label>
</fieldset>
<DialogFooter>
<Button type="button" variant="outline" @click="emit('update:open', false)">Abbrechen</Button>
<Button type="submit" :disabled="form.processing || (mode === 'version' && !form.reading && !form.editable)">

View file

@ -1,6 +1,6 @@
<script setup>
import { Link } from '@inertiajs/vue3';
import { Archive, ClipboardList, Download, EllipsisVertical, ExternalLink, FileUp, PencilLine, ScanText, Trash2 } from '@lucide/vue';
import { Archive, CalendarCheck, CalendarClock, CircleCheck, ClipboardList, FileCheck2, Download, EllipsisVertical, ExternalLink, FileUp, PencilLine, ScanText, Trash2 } from '@lucide/vue';
import { Button } from '@/components/ui/button';
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';
import FileIcon from '@/components/FileIcon.vue';
@ -15,7 +15,12 @@ defineProps({
canManage: { type: Boolean, default: false },
});
defineEmits(['edit', 'new-version', 'archive', 'remove']);
defineEmits(['edit', 'new-version', 'archive', 'remove', 'acknowledgements', 'reviewed']);
const reviewBadge = {
overdue: ['Prüfung überfällig', 'bg-red-100 text-red-800 dark:bg-red-950 dark:text-red-300'],
due: ['Prüfung fällig', 'bg-amber-100 text-amber-800 dark:bg-amber-950 dark:text-amber-300'],
};
const actionLabel = { view: 'Lesen', download: 'Herunterladen', link: 'Öffnen', form: 'Ausfüllen' };
const isExternal = (entry) => entry.open_kind === 'link' || entry.open_kind === 'download';
@ -61,6 +66,15 @@ const isExternal = (entry) => entry.open_kind === 'link' || entry.open_kind ===
<a v-if="entry.editable" :href="entry.editable.url" class="inline-flex items-center gap-1 text-brand-text hover:underline" :title="entry.editable.name">
<Download class="size-3" /> Vorlage ({{ entry.editable.extension }})
</a>
<span v-if="entry.requires_acknowledgement && !entry.acknowledged_at" class="inline-flex items-center gap-1 rounded-pill bg-amber-100 px-1.5 font-medium text-amber-800 dark:bg-amber-950 dark:text-amber-300">
<FileCheck2 class="size-3" /> Bitte lesen und bestätigen
</span>
<span v-else-if="entry.requires_acknowledgement" class="inline-flex items-center gap-1 text-emerald-700 dark:text-emerald-400" :title="`Bestätigt am ${formatStand(entry.acknowledged_at.slice(0, 10))}`">
<CircleCheck class="size-3" /> Gelesen
</span>
<span v-if="canManage && reviewBadge[entry.review?.state]" class="inline-flex items-center gap-1 rounded-pill px-1.5 font-medium" :class="reviewBadge[entry.review.state][1]">
<CalendarClock class="size-3" /> {{ reviewBadge[entry.review.state][0] }} ({{ formatStand(entry.review.due_at) }})
</span>
<span v-if="canManage && entry.text_status === 'needs_ocr'" class="inline-flex items-center gap-1 text-amber-700 dark:text-amber-400" title="Eingescanntes PDF – Inhalt erst nach Texterkennung durchsuchbar">
<ScanText class="size-3" /> Scan, Inhalt nicht durchsuchbar
</span>
@ -89,6 +103,8 @@ const isExternal = (entry) => entry.open_kind === 'link' || entry.open_kind ===
<DropdownMenuItem @select="$emit('edit', entry)"><PencilLine /> Bearbeiten</DropdownMenuItem>
<DropdownMenuItem v-if="entry.type === 'file'" @select="$emit('new-version', entry)"><FileUp /> Neue Fassung hochladen</DropdownMenuItem>
<DropdownMenuItem v-if="entry.type === 'file'" @select="$emit('archive', entry)"><Archive /> Archiv (frühere Fassungen)</DropdownMenuItem>
<DropdownMenuItem v-if="entry.requires_acknowledgement" @select="$emit('acknowledgements', entry)"><FileCheck2 /> Lesebestätigungen</DropdownMenuItem>
<DropdownMenuItem v-if="entry.review?.due_at" @select="$emit('reviewed', entry)"><CalendarCheck /> Als geprüft vermerken</DropdownMenuItem>
<DropdownMenuSeparator />
<DropdownMenuItem class="text-destructive" @select="$emit('remove', entry)"><Trash2 /> Löschen</DropdownMenuItem>
</DropdownMenuContent>

View file

@ -8,6 +8,7 @@ import EmptyState from '@/components/EmptyState.vue';
import PageHeader from '@/components/PageHeader.vue';
import AppLayout from '@/layouts/AppLayout.vue';
import { qmColor } from '../colors';
import AckReportDialog from '../components/AckReportDialog.vue';
import ArchiveDialog from '../components/ArchiveDialog.vue';
import ContactCard from '../components/ContactCard.vue';
import EntryDialog from '../components/EntryDialog.vue';
@ -37,8 +38,15 @@ const hasAside = computed(() => props.folder.contacts.length > 0);
// Pflege
const dialog = ref({ open: false, mode: 'create', entry: null });
const archive = ref({ open: false, entry: null });
const report = ref({ open: false, entry: null });
const openDialog = (mode, entry = null) => (dialog.value = { open: true, mode, entry });
function reviewed(entry) {
if (window.confirm(`„${entry.title}“ als geprüft vermerken?${entry.review.interval_months ? ' Der nächste Termin wird automatisch gesetzt.' : ''}`)) {
router.post(`/qm/eintraege/${entry.id}/geprueft`, {}, { preserveScroll: true });
}
}
function remove(entry) {
if (window.confirm(`„${entry.title}“ mit allen Fassungen löschen?`)) {
router.delete(`/qm/eintraege/${entry.id}`, { preserveScroll: true });
@ -85,6 +93,8 @@ function remove(entry) {
@new-version="(e) => openDialog('version', e)"
@archive="(e) => (archive = { open: true, entry: e })"
@remove="remove"
@acknowledgements="(e) => (report = { open: true, entry: e })"
@reviewed="reviewed"
/>
<div v-else class="rounded-lg border border-dashed bg-card">
<EmptyState :icon="Files" title="Noch keine Dokumente" :text="canManage ? 'Mit „Eintrag hinzufügen“ Dateien, Links oder Formulare ergänzen.' : ''" />
@ -102,5 +112,6 @@ function remove(entry) {
<EntryDialog v-if="canManage" v-model:open="dialog.open" :mode="dialog.mode" :entry="dialog.entry" :folder-id="folder.id" :forms="forms" :max-upload-mb="maxUploadMb" />
<ArchiveDialog v-if="canManage" v-model:open="archive.open" :entry="archive.entry" />
<AckReportDialog v-if="canManage" v-model:open="report.open" :entry="report.entry" />
</AppLayout>
</template>

View file

@ -1,6 +1,6 @@
<script setup>
import { Link } from '@inertiajs/vue3';
import { FolderCog, ShieldCheck, Users } from '@lucide/vue';
import { CalendarClock, FileCheck2, FolderCog, ShieldCheck, Users } from '@lucide/vue';
import { Button } from '@/components/ui/button';
import EmptyState from '@/components/EmptyState.vue';
import PageHeader from '@/components/PageHeader.vue';
@ -17,6 +17,8 @@ defineProps({
categories: { type: Array, required: true },
canManage: { type: Boolean, default: false },
adminUrl: { type: String, default: null },
toAcknowledge: { type: Array, default: () => [] },
reviews: { type: Object, default: null },
});
</script>
@ -24,11 +26,29 @@ defineProps({
<AppLayout title="Qualitätsmanagement">
<PageHeader title="Qualitätsmanagement" description="Verfahrensanweisungen, Standards und Formulare – immer in der gültigen Fassung.">
<template #actions>
<Button v-if="reviews" variant="outline" class="h-10" as-child>
<Link :href="reviews.url"><CalendarClock /> Prüfungen<span v-if="reviews.open" class="rounded-pill bg-amber-500 px-1.5 text-[11px] leading-4 font-semibold text-white tabular-nums">{{ reviews.open }}</span></Link>
</Button>
<Button v-if="adminUrl" variant="outline" class="h-10" as-child><a :href="adminUrl"><FolderCog /> Ordner verwalten</a></Button>
<QmSearchBox />
</template>
</PageHeader>
<section v-if="toAcknowledge.length" id="bestaetigen" class="mb-8 overflow-hidden rounded-lg border border-amber-300 bg-card dark:border-amber-800">
<h2 class="flex items-center gap-2 bg-amber-50 px-4 py-2.5 text-sm font-semibold dark:bg-amber-950/40">
<FileCheck2 class="size-4 text-amber-700 dark:text-amber-400" /> Bitte lesen und bestätigen
<span class="rounded-pill bg-amber-500 px-1.5 text-[11px] leading-4 text-white tabular-nums">{{ toAcknowledge.length }}</span>
</h2>
<ul class="divide-y">
<li v-for="entry in toAcknowledge" :key="entry.id">
<Link :href="entry.open_kind === 'view' ? entry.open_url : entry.folder.url" class="flex flex-wrap items-center gap-x-3 gap-y-0.5 px-4 py-2.5 hover:bg-accent/60">
<span class="min-w-0 flex-1 text-sm font-medium">{{ entry.title }}</span>
<span class="inline-flex items-center gap-1.5 text-xs text-muted-foreground"><span class="size-2 rounded-sm" :class="qmColor(entry.folder.color).dot" />{{ entry.folder.path }}</span>
</Link>
</li>
</ul>
</section>
<div v-if="intro || contacts.length" class="mb-8 grid items-start gap-6" :class="{ 'lg:grid-cols-[minmax(0,1fr)_20rem]': intro && contacts.length }">
<section v-if="intro" class="relative overflow-hidden rounded-lg border bg-card p-5 pl-6">
<span class="absolute inset-y-0 left-0 w-1.5 bg-brand" aria-hidden="true" />

View file

@ -0,0 +1,81 @@
<script setup>
import { computed, ref, watch } from 'vue';
import { Link, router, usePage } from '@inertiajs/vue3';
import { CalendarCheck, CalendarClock } from '@lucide/vue';
import { toast } from 'vue-sonner';
import { Button } from '@/components/ui/button';
import EmptyState from '@/components/EmptyState.vue';
import PageHeader from '@/components/PageHeader.vue';
import AppLayout from '@/layouts/AppLayout.vue';
import { qmColor } from '../colors';
import { formatStand } from '../format';
/**
* Wiedervorlage: Prüftermine der QM-Dokumente – überfällige und fällige zuerst.
*/
const props = defineProps({
entries: { type: Array, required: true },
intervals: { type: Object, required: true },
leadDays: { type: Number, required: true },
});
const page = usePage();
watch(() => page.props.flash.status, (status) => status && toast.success(status), { immediate: true });
const groups = computed(() => [
{ key: 'overdue', title: 'Überfällig', tone: 'text-red-700 dark:text-red-400', dot: 'bg-red-500' },
{ key: 'due', title: `Fällig in den nächsten ${props.leadDays} Tagen`, tone: 'text-amber-700 dark:text-amber-400', dot: 'bg-amber-500' },
{ key: 'planned', title: 'Geplant', tone: 'text-muted-foreground', dot: 'bg-muted-foreground/40' },
].map((group) => ({ ...group, entries: props.entries.filter((e) => e.review.state === group.key) })).filter((group) => group.entries.length));
const confirming = ref(null);
function complete(entry) {
router.post(`/qm/eintraege/${entry.id}/geprueft`, {}, { preserveScroll: true, onFinish: () => (confirming.value = null) });
}
const dateTime = new Intl.DateTimeFormat('de-DE', { dateStyle: 'medium' });
</script>
<template>
<AppLayout title="QM-Prüfungen">
<PageHeader
title="Prüfungen"
description="Wiedervorlage der QM-Dokumente: Was steht wann zur Prüfung an?"
:breadcrumbs="[{ label: 'Qualitätsmanagement', href: '/qm' }]"
/>
<div v-if="groups.length" class="grid gap-8">
<section v-for="group in groups" :key="group.key">
<h2 class="mb-3 flex items-center gap-2 text-sm font-semibold" :class="group.tone">
<span class="size-2 rounded-full" :class="group.dot" /> {{ group.title }} <span class="font-normal text-muted-foreground">({{ group.entries.length }})</span>
</h2>
<ul class="divide-y overflow-hidden rounded-lg border bg-card">
<li v-for="entry in group.entries" :key="entry.id" class="grid gap-x-4 gap-y-2 px-4 py-3 sm:grid-cols-[minmax(0,1fr)_auto] sm:items-center">
<div class="min-w-0">
<Link :href="entry.open_kind === 'view' ? entry.open_url : entry.folder.url" class="font-medium hover:underline">{{ entry.title }}</Link>
<p class="mt-0.5 flex flex-wrap items-center gap-x-3 gap-y-0.5 text-xs text-muted-foreground">
<Link :href="entry.folder.url" class="inline-flex items-center gap-1.5 hover:underline"><span class="size-2 rounded-sm" :class="qmColor(entry.folder.color).dot" />{{ entry.folder.path }}</Link>
<span class="inline-flex items-center gap-1 font-medium" :class="group.tone"><CalendarClock class="size-3" /> {{ formatStand(entry.review.due_at) }}</span>
<span v-if="entry.review.interval_months">{{ intervals[entry.review.interval_months] }}</span>
<span v-if="entry.review.responsible">Verantwortlich: {{ entry.review.responsible.name }}</span>
<span v-if="entry.review.reviewed_at">Zuletzt geprüft {{ dateTime.format(new Date(entry.review.reviewed_at)) }}{{ entry.reviewer ? ` von ${entry.reviewer}` : '' }}</span>
</p>
</div>
<div v-if="entry.can_complete" class="flex items-center gap-2">
<template v-if="confirming === entry.id">
<span class="text-[13px] text-muted-foreground">Inhalt geprüft und aktuell?</span>
<Button size="sm" variant="ghost" @click="confirming = null">Abbrechen</Button>
<Button size="sm" @click="complete(entry)"><CalendarCheck /> Ja, geprüft</Button>
</template>
<Button v-else size="sm" variant="outline" @click="confirming = entry.id"><CalendarCheck /> Als geprüft vermerken</Button>
</div>
</li>
</ul>
</section>
</div>
<div v-else class="rounded-lg border bg-card">
<EmptyState :icon="CalendarCheck" title="Keine Prüftermine" text="Termine setzen Sie beim Bearbeiten eines Dokuments unter „Prüfung und Kenntnisnahme“." />
</div>
</AppLayout>
</template>

View file

@ -1,17 +1,28 @@
<script setup>
import { Head, Link } from '@inertiajs/vue3';
import { ArrowLeft, Download, ExternalLink, FileDown } from '@lucide/vue';
import { ref, watch } from 'vue';
import { Head, Link, router, usePage } from '@inertiajs/vue3';
import { ArrowLeft, Check, CircleCheck, Download, ExternalLink, FileCheck2, FileDown, LoaderCircle } from '@lucide/vue';
import { toast } from 'vue-sonner';
import { Button } from '@/components/ui/button';
import AppLayout from '@/layouts/AppLayout.vue';
import { qmColor } from '../colors';
import PdfViewer from '../components/PdfViewer.vue';
import { formatSize, formatStand } from '../format';
defineProps({
const props = defineProps({
entry: { type: Object, required: true },
file: { type: Object, required: true },
query: { type: String, default: '' },
});
const page = usePage();
watch(() => page.props.flash.status, (status) => status && toast.success(status));
const sending = ref(false);
function acknowledge() {
router.post(`/qm/eintraege/${props.entry.id}/gelesen`, {}, { preserveScroll: true, onStart: () => (sending.value = true), onFinish: () => (sending.value = false) });
}
</script>
<template>
@ -35,6 +46,17 @@ defineProps({
<Button size="sm" as-child><a :href="entry.download_url"><Download /> Herunterladen</a></Button>
</div>
</header>
<div v-if="entry.requires_acknowledgement" class="flex flex-wrap items-center gap-x-4 gap-y-2 border-b px-4 py-2.5" :class="entry.acknowledged_at ? 'bg-emerald-50 dark:bg-emerald-950/40' : 'bg-amber-50 dark:bg-amber-950/40'">
<template v-if="entry.acknowledged_at">
<CircleCheck class="size-5 shrink-0 text-emerald-700 dark:text-emerald-400" />
<p class="flex-1 text-sm">Sie haben diese Fassung am {{ formatStand(entry.acknowledged_at.slice(0, 10)) }} gelesen und bestätigt.</p>
</template>
<template v-else>
<FileCheck2 class="size-5 shrink-0 text-amber-700 dark:text-amber-400" />
<p class="min-w-0 flex-1 text-sm"><strong>Lesebestätigung erbeten:</strong> Bitte lesen Sie das Dokument und bestätigen Sie anschließend die Kenntnisnahme.</p>
<Button size="sm" :disabled="sending" @click="acknowledge"><LoaderCircle v-if="sending" class="animate-spin" /><Check v-else /> Gelesen und verstanden</Button>
</template>
</div>
<PdfViewer v-if="file.kind === 'pdf'" :url="file.url" class="min-h-0 flex-1" />
<div v-else class="grid min-h-0 flex-1 place-items-center overflow-auto bg-muted/60 p-6">
<img :src="file.url" :alt="entry.title" class="max-h-full max-w-full rounded shadow-md" />

View file

@ -0,0 +1,30 @@
<script setup>
import { Link } from '@inertiajs/vue3';
import { FileCheck2 } from '@lucide/vue';
import Panel from '@/components/Panel.vue';
/**
* Startseite: QM-Dokumente, deren Lesebestätigung noch fehlt (erscheint nur dann).
*/
defineProps({
entries: { type: Array, required: true },
total: { type: Number, required: true },
url: { type: String, required: true },
});
</script>
<template>
<Panel title="Bitte lesen und bestätigen" :action-label="total > entries.length ? `Alle ${total}` : 'QM'" :action-href="url">
<p class="-mt-1 mb-3 text-[13px] text-muted-foreground">
{{ total === 1 ? 'Ein QM-Dokument wartet' : `${total} QM-Dokumente warten` }} auf Ihre Lesebestätigung.
</p>
<ul class="grid gap-1">
<li v-for="entry in entries" :key="entry.id">
<Link :href="entry.url" class="flex items-center gap-2.5 rounded-md px-2 py-1.5 text-sm hover:bg-accent">
<FileCheck2 class="size-4 shrink-0 text-amber-600 dark:text-amber-400" />
<span class="min-w-0 truncate">{{ entry.title }}</span>
</Link>
</li>
</ul>
</Panel>
</template>

View file

@ -12,6 +12,12 @@ Route::middleware(['auth', EnsureQmAccess::class])->prefix('qm')->name('qm.')->c
Route::get('/ordner/{folder}', 'folder')->name('folder');
Route::get('/lesen/{entry}', 'view')->name('view');
Route::get('/datei/{file}/{name}', 'file')->name('file');
Route::post('/eintraege/{entry}/gelesen', 'acknowledge')->name('entries.acknowledge');
// Wiedervorlage (QM-Team und Verantwortliche)
Route::get('/pruefungen', 'reviews')->name('reviews');
Route::post('/eintraege/{entry}/geprueft', 'completeReview')->name('entries.reviewed');
Route::get('/eintraege/{entry}/lesebestaetigungen', 'acknowledgements')->name('entries.acknowledgements');
// Pflege (Recht „qm.manage“)
Route::post('/ordner/{folder}/eintraege', 'store')->name('entries.store');

View file

@ -0,0 +1,118 @@
<?php
namespace Inhaus\Plugins\Qm;
use App\Models\User;
use App\Support\Audit;
use App\Support\Permissions\Audiences;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
use Inhaus\Plugins\Qm\Models\QmEntry;
/**
* Lesebestätigungen: Wer ein Dokument mit „Lesebestätigung“ sehen darf, bestätigt
* die aktuelle Fassung. Eine neue Fassung braucht eine neue Bestätigung.
*/
class Acknowledgements
{
public function __construct(private readonly QmTree $tree, private readonly QmAccess $access) {}
/**
* Bestätigungen der Person zu den Einträgen: Eintrag => bestätigt am (nur für die aktuelle Fassung).
*
* @param iterable<QmEntry> $entries
* @return array<int, string>
*/
public function stateFor(iterable $entries, User $user): array
{
$entries = collect($entries)->filter(fn (QmEntry $e) => $e->requires_acknowledgement);
if ($entries->isEmpty()) {
return [];
}
$rows = DB::table('qm_acknowledgements')->where('user_id', $user->id)->whereIn('entry_id', $entries->pluck('id'))->get()->keyBy('entry_id');
$state = [];
foreach ($entries as $entry) {
$row = $rows[$entry->id] ?? null;
if ($row && (int) $row->file_id === (int) $entry->currentFileId()) {
$state[$entry->id] = (string) $row->acknowledged_at;
}
}
return $state;
}
public function acknowledge(QmEntry $entry, User $user): void
{
DB::table('qm_acknowledgements')->updateOrInsert(
['entry_id' => $entry->id, 'user_id' => $user->id],
['file_id' => $entry->currentFileId(), 'acknowledged_at' => now()],
);
Audit::log('qm.acknowledged', ['entry' => $entry->id, 'title' => $entry->title]);
}
/**
* Noch zu bestätigende Dokumente der Person.
*
* @return Collection<int, QmEntry>
*/
public function outstanding(User $user): Collection
{
if (! $this->access->allows($user)) {
return collect();
}
$entries = QmEntry::query()
->where('requires_acknowledgement', true)
->whereIn('folder_id', $this->tree->visibleIds($user) ?: [0])
->with(['readingFile', 'editableFile'])
->orderBy('title')
->get();
$done = $this->stateFor($entries, $user);
return $entries->reject(fn (QmEntry $entry) => isset($done[$entry->id]) || ! $entry->currentFileId())->values();
}
/**
* Auswertung für das QM-Team: wer hat die aktuelle Fassung bestätigt, wer nicht.
*
* @return array{confirmed: list<array<string, mixed>>, missing: list<array<string, mixed>>}
*/
public function report(QmEntry $entry): array
{
$fileId = $entry->currentFileId();
$category = $this->tree->categoryId($entry->folder_id);
// Alle aktiven Personen, die den Ordner sehen dürfen (Zielgruppe der Kategorie, Rollen-Ausschluss des Moduls)
$excluded = $this->access->excludedRoles();
$rules = $category !== null ? Audiences::get('qm_category', $category) : [];
$include = array_filter(array_intersect_key($rules, array_flip(['role', 'department', 'location'])));
$people = User::query()->where('is_active', true)
->when($include !== [], fn (Builder $q) => $q->where(fn (Builder $q) => $q
->whereHas('roles', fn (Builder $r) => $r->whereIn('roles.id', $include['role'] ?? [0]))
->orWhereIn('department', $include['department'] ?? [])
->orWhereIn('location', $include['location'] ?? [])))
->when(filled($rules['exclude_role'] ?? []), fn (Builder $q) => $q->whereDoesntHave('roles', fn (Builder $r) => $r->whereIn('roles.id', $rules['exclude_role'])))
// Rollen-Ausschluss des Moduls gilt nicht für das QM-Team
->when($excluded !== [], fn (Builder $q) => $q->where(fn (Builder $q) => $q->whereDoesntHave('roles', fn (Builder $r) => $r->whereIn('roles.id', $excluded))
->orWhereHas('roles.grants', fn (Builder $g) => $g->whereIn('ability', ['qm.manage', '*']))))
->orderBy('last_name')->orderBy('first_name')
->get(['id', 'name', 'first_name', 'last_name', 'department', 'job_title', 'avatar_path']);
$acks = DB::table('qm_acknowledgements')->where('entry_id', $entry->id)->where('file_id', $fileId)->pluck('acknowledged_at', 'user_id');
$row = fn (User $u) => ['id' => $u->id, 'name' => $u->name, 'department' => $u->department, 'job_title' => $u->job_title, 'initials' => $u->initials, 'avatar_url' => $u->avatarUrl(96)];
[$confirmed, $missing] = $people->partition(fn (User $u) => isset($acks[$u->id]));
return [
'confirmed' => $confirmed->map(fn (User $u) => [...$row($u), 'acknowledged_at' => (string) $acks[$u->id]])->sortByDesc('acknowledged_at')->values()->all(),
'missing' => $missing->map($row)->values()->all(),
];
}
}

View file

@ -6,6 +6,7 @@ use App\Http\Controllers\Controller;
use App\Support\Audit;
use App\Support\RichText;
use App\Support\Settings;
use Carbon\Carbon;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@ -14,6 +15,7 @@ use Illuminate\Support\Facades\Storage;
use Illuminate\Validation\Rule;
use Inertia\Inertia;
use Inertia\Response;
use Inhaus\Plugins\Qm\Acknowledgements;
use Inhaus\Plugins\Qm\Library;
use Inhaus\Plugins\Qm\Models\QmEntry;
use Inhaus\Plugins\Qm\Models\QmFile;
@ -21,6 +23,7 @@ use Inhaus\Plugins\Qm\Models\QmFolder;
use Inhaus\Plugins\Qm\Presenter;
use Inhaus\Plugins\Qm\QmAccess;
use Inhaus\Plugins\Qm\QmTree;
use Inhaus\Plugins\Qm\Reviews;
use Inhaus\Plugins\Qm\Search;
use Symfony\Component\HttpFoundation\Response as HttpResponse;
@ -49,16 +52,85 @@ class QmController extends Controller
])->values(),
'canManage' => $this->access->canManage($request->user()),
'adminUrl' => $this->access->canManage($request->user()) ? url('/admin/qm-ordner') : null,
'toAcknowledge' => app(Acknowledgements::class)->outstanding($request->user())->map(fn (QmEntry $entry) => $this->presenter->entry($entry, withFolder: true))->values(),
'reviews' => app(Reviews::class)->canSee($request->user()) ? ['open' => app(Reviews::class)->openCount($request->user()), 'url' => route('qm.reviews')] : null,
]);
}
/**
* Wiedervorlagen: alle Termine (QM-Team) bzw. die eigenen (Verantwortliche).
*/
public function reviews(Request $request, Reviews $reviews): Response
{
abort_unless($reviews->canSee($request->user()), 403);
return Inertia::render('qm::Reviews', [
'entries' => $reviews->list($request->user())->map(fn (QmEntry $entry) => [
...$this->presenter->entry($entry, withFolder: true),
'reviewer' => $entry->reviewer?->name,
'can_complete' => $reviews->canComplete($entry, $request->user()),
])->values(),
'intervals' => Reviews::INTERVALS,
'leadDays' => Reviews::LEAD_DAYS,
]);
}
public function completeReview(Request $request, QmEntry $entry, Reviews $reviews): RedirectResponse
{
abort_unless($reviews->canComplete($entry, $request->user()), 403);
$reviews->complete($entry, $request->user());
return back()->with('status', $entry->review_due_at
? 'Als geprüft vermerkt – nächste Prüfung am '.$entry->review_due_at->format('d.m.Y').'.'
: 'Als geprüft vermerkt.');
}
public function acknowledge(Request $request, QmEntry $entry, Acknowledgements $acknowledgements): RedirectResponse
{
abort_unless($entry->requires_acknowledgement && $this->tree->isVisible($entry->folder_id, $request->user()), 404);
$acknowledgements->acknowledge($entry, $request->user());
return back()->with('status', 'Danke – Ihre Lesebestätigung ist gespeichert.');
}
/**
* Auswertung der Lesebestätigungen (QM-Team), als JSON oder CSV.
*/
public function acknowledgements(Request $request, QmEntry $entry, Acknowledgements $acknowledgements): JsonResponse|HttpResponse
{
$this->authorizeManage($request);
$report = $acknowledgements->report($entry);
if ($request->query('format') === 'csv') {
$rows = [['Name', 'Abteilung', 'Funktion', 'Status', 'Bestätigt am']];
foreach ($report['confirmed'] as $p) {
$rows[] = [$p['name'], $p['department'], $p['job_title'], 'bestätigt', Carbon::parse($p['acknowledged_at'])->format('d.m.Y H:i')];
}
foreach ($report['missing'] as $p) {
$rows[] = [$p['name'], $p['department'], $p['job_title'], 'offen', ''];
}
$csv = "\u{FEFF}".collect($rows)->map(fn (array $row) => implode(';', array_map(fn ($v) => '"'.str_replace('"', '""', (string) $v).'"', $row)))->implode("\r\n");
return response($csv, 200, [
'Content-Type' => 'text/csv; charset=UTF-8',
'Content-Disposition' => 'attachment; filename="lesebestaetigungen-'.$entry->id.'.csv"',
]);
}
return response()->json($report);
}
public function folder(Request $request, QmFolder $folder): Response
{
abort_unless($this->tree->isVisible($folder->id, $request->user()), 404);
$counts = $this->entryCounts();
$canManage = $this->access->canManage($request->user());
$entries = $folder->entries()->with(['readingFile', 'editableFile'])->orderBy('sort')->orderBy('title')->get();
$entries = $folder->entries()->with(['readingFile', 'editableFile', 'responsible'])->orderBy('sort')->orderBy('title')->get();
$acks = app(Acknowledgements::class)->stateFor($entries, $request->user());
$node = $this->tree->folder($folder->id);
return Inertia::render('qm::Folder', [
@ -72,7 +144,7 @@ class QmController extends Controller
],
'breadcrumbs' => array_map(fn (array $f) => ['id' => $f['id'], 'name' => $f['name'], 'color' => $f['color']], array_slice($this->tree->path($folder->id), 0, -1)),
'children' => array_map(fn (int $id) => $this->presenter->tile($id, $counts), $this->tree->childIds($folder->id)),
'entries' => $entries->map(fn (QmEntry $entry) => $this->presenter->entry($entry)),
'entries' => $entries->map(fn (QmEntry $entry) => [...$this->presenter->entry($entry), 'acknowledged_at' => $acks[$entry->id] ?? null]),
'canManage' => $canManage,
'forms' => $canManage ? $this->formOptions() : [],
'maxUploadMb' => (int) floor(min(Library::MAX_KB / 1024, self::phpUploadLimitMb())),
@ -110,7 +182,7 @@ class QmController extends Controller
}
return Inertia::render('qm::Viewer', [
'entry' => $this->presenter->entry($entry, withFolder: true),
'entry' => [...$this->presenter->entry($entry, withFolder: true), 'acknowledged_at' => app(Acknowledgements::class)->stateFor([$entry], $request->user())[$entry->id] ?? null],
'file' => ['url' => $file->url(inline: true), 'kind' => $file->mime === 'application/pdf' ? 'pdf' : 'image', 'name' => $file->name],
'query' => (string) $request->query('suche', ''),
]);
@ -206,9 +278,14 @@ class QmController extends Controller
'form_id' => [Rule::requiredIf($type === QmEntry::FORM), 'nullable', 'integer', Rule::exists('forms', 'id')],
'reading' => [...$fileRule, Rule::requiredIf($type === QmEntry::FILE && ! $entry && ! $request->hasFile('editable'))],
'editable' => $fileRule,
'review_due_at' => ['nullable', 'date'],
'review_interval_months' => ['nullable', 'integer', Rule::in(array_keys(Reviews::INTERVALS))],
'responsible_id' => ['nullable', 'integer', Rule::exists('users', 'id')],
'requires_acknowledgement' => ['nullable', 'boolean'],
], ['url.regex' => 'Bitte eine Adresse angeben, die mit https:// oder / beginnt.', 'reading.required' => 'Bitte eine Datei auswählen.'], [
'title' => 'Titel', 'version' => 'Version', 'valid_from' => 'Stand', 'url' => 'Adresse', 'form_id' => 'Formular',
'reading' => 'Datei', 'editable' => 'Bearbeitbare Vorlage',
'reading' => 'Datei', 'editable' => 'Bearbeitbare Vorlage', 'review_due_at' => 'Nächste Prüfung',
'review_interval_months' => 'Prüfintervall', 'responsible_id' => 'Verantwortlich',
]) + ['type' => $type];
}

View file

@ -52,7 +52,14 @@ class Library
public function update(QmEntry $entry, array $data, ?UploadedFile $reading, ?UploadedFile $editable, bool $removeEditable, User $user): QmEntry
{
return DB::transaction(function () use ($entry, $data, $reading, $editable, $removeEditable, $user) {
$entry->update([...$this->attributes([...$data, 'type' => $entry->type]), 'updated_by' => $user->id]);
$entry->fill([...$this->attributes([...$data, 'type' => $entry->type]), 'updated_by' => $user->id]);
// Neuer Prüftermin oder andere Verantwortliche → erneut erinnern
if ($entry->isDirty(['review_due_at', 'responsible_id'])) {
$entry->review_notified_at = null;
}
$entry->save();
if ($entry->type !== QmEntry::FILE) {
return $entry;
@ -89,6 +96,10 @@ class Library
'valid_from' => filled($data['valid_from'] ?? null) ? Carbon::parse($data['valid_from'])->toDateString() : now()->toDateString(),
'url' => $type === QmEntry::LINK ? trim((string) $data['url']) : null,
'form_id' => $type === QmEntry::FORM ? (int) $data['form_id'] : null,
'review_due_at' => filled($data['review_due_at'] ?? null) ? Carbon::parse($data['review_due_at'])->toDateString() : null,
'review_interval_months' => filled($data['review_interval_months'] ?? null) ? (int) $data['review_interval_months'] : null,
'responsible_id' => filled($data['responsible_id'] ?? null) ? (int) $data['responsible_id'] : null,
'requires_acknowledgement' => (bool) ($data['requires_acknowledgement'] ?? false),
];
}

View file

@ -2,6 +2,7 @@
namespace Inhaus\Plugins\Qm\Models;
use App\Models\User;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
@ -12,7 +13,8 @@ use Illuminate\Database\Eloquent\Relations\HasOne;
* Ein Eintrag in einem QM-Ordner: Datei (mit Lesefassung und optional bearbeitbarer
* Vorlage), Link oder Online-Formular. „Stand“ = valid_from.
*/
#[Fillable(['folder_id', 'type', 'title', 'description', 'version', 'valid_from', 'url', 'form_id', 'sort', 'created_by', 'updated_by'])]
#[Fillable(['folder_id', 'type', 'title', 'description', 'version', 'valid_from', 'url', 'form_id', 'sort', 'created_by', 'updated_by',
'review_due_at', 'review_interval_months', 'responsible_id', 'requires_acknowledgement', 'reviewed_at', 'reviewed_by', 'review_notified_at'])]
class QmEntry extends Model
{
public const FILE = 'file';
@ -29,7 +31,7 @@ class QmEntry extends Model
protected function casts(): array
{
return ['valid_from' => 'date', 'review_due_at' => 'date', 'requires_acknowledgement' => 'boolean'];
return ['valid_from' => 'date', 'review_due_at' => 'date', 'requires_acknowledgement' => 'boolean', 'reviewed_at' => 'datetime', 'review_notified_at' => 'datetime', 'review_interval_months' => 'integer'];
}
/**
@ -40,6 +42,33 @@ class QmEntry extends Model
return $this->belongsTo(QmFolder::class);
}
/**
* @return BelongsTo<User, $this>
*/
public function responsible(): BelongsTo
{
return $this->belongsTo(User::class, 'responsible_id');
}
/**
* @return BelongsTo<User, $this>
*/
public function reviewer(): BelongsTo
{
return $this->belongsTo(User::class, 'reviewed_by');
}
/**
* Aktuelle Fassung, auf die sich eine Lesebestätigung bezieht (Lesefassung, sonst Vorlage).
*/
public function currentFileId(): ?int
{
$file = $this->relationLoaded('readingFile') ? $this->readingFile : $this->readingFile()->first();
$file ??= $this->relationLoaded('editableFile') ? $this->editableFile : $this->editableFile()->first();
return $file?->id;
}
/**
* @return HasMany<QmFile, $this>
*/

View file

@ -83,6 +83,14 @@ class Presenter
'url' => $entry->url,
'form_id' => $entry->form_id,
'folder' => $withFolder ? $this->folderLabel($entry->folder_id) : null,
'requires_acknowledgement' => (bool) $entry->requires_acknowledgement,
'review' => [
'due_at' => $entry->review_due_at?->toDateString(),
'state' => Reviews::state($entry),
'interval_months' => $entry->review_interval_months,
'responsible' => $entry->responsible_id ? ['id' => $entry->responsible_id, 'name' => $entry->responsible?->name] : null,
'reviewed_at' => $entry->reviewed_at?->toIso8601String(),
],
];
}

View file

@ -28,11 +28,19 @@ class QmAccess
return true;
}
$excluded = array_map('intval', (array) $this->settings->get(self::EXCLUDED_ROLES, []));
$excluded = $this->excludedRoles();
return $excluded === [] || ! $user->roles()->whereIn('roles.id', $excluded)->exists();
}
/**
* @return list<int>
*/
public function excludedRoles(): array
{
return array_values(array_map('intval', (array) $this->settings->get(self::EXCLUDED_ROLES, [])));
}
public function canManage(?User $user): bool
{
return (bool) $user?->can('qm.manage');

View file

@ -2,6 +2,7 @@
namespace Inhaus\Plugins\Qm;
use App\Dashboard\Widgets;
use App\Models\User;
use App\Plugins\Plugin;
use App\Search\GlobalSearch;
@ -18,13 +19,23 @@ class QmPlugin extends Plugin
{
$this->app->make(GlobalSearch::class)->add('qm', 'Qualitätsmanagement', 'shield-check', fn (...$args) => app(QmSearch::class)(...$args), sort: 50);
foreach ([QmTree::class, QmAccess::class, Presenter::class, Search::class, Library::class, Indexer::class, TextExtractor::class, Ocr::class] as $class) {
foreach ([QmTree::class, QmAccess::class, Presenter::class, Search::class, Library::class, Reviews::class, Acknowledgements::class, Indexer::class, TextExtractor::class, Ocr::class] as $class) {
$this->app->singleton($class);
}
$this->app->make(Navigation::class)->add('qm', 'Qualitätsmanagement', '/qm', active: 'qm.*', sort: 55,
visible: fn (User $user) => $this->app->make(QmAccess::class)->allows($user));
// Startseite: noch zu bestätigende QM-Dokumente (nur wenn es welche gibt)
$this->app->make(Widgets::class)->add('qm.acknowledgements', 'qm::Acknowledgements', 'aside', sort: 15, label: 'QM: Lesebestätigungen',
props: function (User $user) {
$open = $this->app->make(Acknowledgements::class)->outstanding($user);
return $open->isEmpty() ? null : ['entries' => $open->take(5)->map(fn ($entry) => [
'id' => $entry->id, 'title' => $entry->title, 'url' => route('qm.view', $entry),
])->values(), 'total' => $open->count(), 'url' => route('qm.index').'#bestaetigen'];
});
$abilities = $this->app->make(Abilities::class);
$abilities->define('qm.manage', 'Qualitätsmanagement pflegen (Ordner, Dokumente, Einstellungen)', 'Qualitätsmanagement');
$abilities->resourceType('qm_category', 'QM-Kategorie', fn () => QmCategory::query()->orderBy('sort')->pluck('name', 'id')->all());
@ -35,5 +46,9 @@ class QmPlugin extends Plugin
// Eingescannte PDFs per Texterkennung durchsuchbar machen (nur wenn eingerichtet).
Schedule::call(fn () => $this->app->make(Indexer::class)->processOcr())
->everyTenMinutes()->name('qm-ocr')->withoutOverlapping(30);
// Wiedervorlage: fällige Prüfungen melden
Schedule::call(fn () => $this->app->make(Reviews::class)->notifyDue())
->dailyAt('07:00')->name('qm-reviews')->withoutOverlapping(30);
}
}

View file

@ -0,0 +1,119 @@
<?php
namespace Inhaus\Plugins\Qm;
use App\Models\User;
use App\Notifications\PortalNotification;
use App\Support\Audit;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Collection;
use Inhaus\Plugins\Qm\Models\QmEntry;
/**
* Wiedervorlage: Dokumente, die zu einem Termin geprüft werden müssen.
* Die verantwortliche Person (sonst wer den Eintrag angelegt hat) wird
* LEAD_DAYS Tage vorher im Portal benachrichtigt.
*/
class Reviews
{
public const LEAD_DAYS = 14;
public const INTERVALS = [6 => '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<int, QmEntry>
*/
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();
}
}