Aufgaben — Übersicht¶

Aufgaben (interne To-dos und Wiedervorlagen) werden in calServer V2 über das Notepad-Modul verwaltet. Aufgaben und Wartungserinnerungen teilen sich – wie in calServer V1 (FrontendNotepad) – eine Datenbasis (Tabelle notepad) und werden über einen Typ unterschieden:

Typ (`entry_type`)	Bedeutung
`task`	Aufgabe / Wiedervorlage – ein zuweisbares To-do mit Fälligkeit, Status und Kalendereintrag. Nicht mit einer Reparatur verknüpft.
`maintenance_reminder`	Wartungserinnerung – eine mit einer Reparatur verknüpfte Notiz (Feld `repair_id`/`RTAG`). Siehe Wartungsübersicht.

Der Typ wird automatisch aus der Reparatur-Verknüpfung abgeleitet: Ohne Reparaturbezug ist der Eintrag eine Aufgabe, mit Reparaturbezug eine Wartungserinnerung.

Beschreibung¶

Das Aufgabenmodul bietet eine zentrale Aufgabenverwaltung für das Team. Aufgaben können angelegt, einem Bearbeiter oder einer Gruppe zugewiesen, mit einem Status und einem Fälligkeitsdatum versehen und in einer Kalenderansicht nachverfolgt werden. Eine Aufgabe kann optional mit einem Inventargerät, einem Kunden oder einem Kontakt verknüpft werden.

Funktionsumfang in V2¶

Funktion	Beschreibung
Aufgabenliste	Übersicht aller Aufgaben mit Filtern (Status, Bearbeiter, Typ, Freitext) und Sortierung nach Fälligkeit
Aufgabe anlegen	Neue Aufgabe mit Inhalt, Fälligkeitsdatum, Status und Zuweisung
Statusverwaltung	Statuswechsel über das Status-System (Statustyp `notepad`) inkl. Pflichtfeld- und Folge-Logik
Zuweisung	Zuweisung an einen Bearbeiter (`assigned_to`), eine Gruppe (`assigned_to_group`) und weitere Empfänger (`additional_recipients`)
Kalenderansicht	Monatskalender mit Drag-&-Drop-Terminverschiebung und Multi-Inventar-Anlage
Verknüpfungen	Bezug zu Inventar (`inventory_id`), Kunde (`customer_id`), Kontakt (`contact_id`) und Reparatur (`repair_id`)
Anhänge	Datei-Anhänge pro Aufgabe

API-Endpunkte¶

Aufgaben werden als eigenständige Ressource über den NotepadController verwaltet:

GET    /api/v2/notepads                     # Liste (Filter: filter[type]=task)
GET    /api/v2/notepads/{id}                # Einzelansicht
POST   /api/v2/notepads                     # Anlegen
PUT    /api/v2/notepads/{id}                # Bearbeiten
DELETE /api/v2/notepads/{id}                # Löschen
GET    /api/v2/notepads/calendar            # Kalenderansicht
GET    /api/v2/inventories/{mtag}/notepads  # Aufgaben eines Geräts
GET    /api/v2/customers/{ktag}/notepads    # Aufgaben eines Kunden

Über filter[type]=task werden ausschließlich Aufgaben (ohne Reparaturverknüpfung) geliefert, über filter[type]=maintenance_reminder nur Wartungserinnerungen.

Abgrenzung zum Notizbuch¶

Das Notizbuch ist keine eigene Datenbasis, sondern eine gefilterte Sicht auf dieselben Notepad-Einträge im Kontext eines Inventargeräts. Eine formlose Notiz ist technisch eine Aufgabe ohne Zuweisung und ohne Fälligkeit.

Berechtigungen¶

Berechtigung	Beschreibung
`notepad_view`	Aufgaben lesen
`notepad_edit`	Aufgaben anlegen und bearbeiten
`notepad_delete`	Aufgaben löschen
`notepad_global`	Alle Aufgaben sehen — ohne diese Berechtigung sind nur eigene, zugewiesene (direkt oder per Gruppe) oder als weiterer Empfänger hinterlegte Aufgaben sichtbar (V1-Verhalten)

E-Mail-Benachrichtigung¶

Ist beim Anlegen oder Bearbeiten die Option E-Mail-Benachrichtigung (send_email) aktiv, werden der verknüpfte Kontakt (ersatzweise der Kunde über das konfigurierte Kunden-E-Mail-Feld), die zugewiesene Person und die weiteren Empfänger per E-Mail informiert (Vorlagen task_create / task_update). Aktualisierungen lösen nur bei tatsächlichen Änderungen eine E-Mail aus.