Notizbuch¶

Das Notizbuch ermöglicht das Erstellen und Verwalten von Notizen, die an Inventargeräte angehängt werden. Die Verwaltung erfolgt über den NotepadController in der Laravel-API.

Notizbuch = gefilterte Sicht auf Notepad-Einträge

Notizen, Aufgaben und Wartungserinnerungen teilen sich eine Datenbasis (Tabelle notepad). Das Notizbuch ist die gerätebezogene Sicht auf diese Einträge; eine formlose Notiz ist technisch eine Aufgabe (entry_type = task) ohne Zuweisung und ohne Fälligkeit. Details zu Typen und Feldern siehe Aufgaben — Übersicht.

Zweck¶

Notizen dienen der formlosen Dokumentation von Beobachtungen, Hinweisen oder Informationen zu einem bestimmten Inventargerät. Sie ergänzen die strukturierten Datenfelder um eine flexible Kommentarfunktion.

Typische Anwendungsfälle¶

Besonderheiten bei der Handhabung eines Geräts festhalten
Ergebnisse informeller Sichtprüfungen dokumentieren
Kommunikation zwischen Teammitgliedern zu einem Gerät
Hinweise für die nächste Kalibrierung notieren

CRUD-Operationen¶

Notizen werden über die Notepad-Ressource verwaltet. Der Gerätebezug wird über das Feld inventory_id hergestellt; die Notizen eines Geräts lassen sich über die Unterressource GET /api/v2/inventories/{mtag}/notepads lesend abrufen.

Notiz anlegen¶

POST /api/v2/notepads

Feld	Pflicht	Beschreibung
`comment`	Ja	Notiztext (Freitext, bis 2048 Zeichen)
`inventory_id`	Nein	Verknüpftes Inventargerät
`date_time`	Nein	Fälligkeit (leer lassen für eine reine Notiz)
`status`	Nein	Status (Standard: `new`)

Keine Prioritätsspalte

Das Datenmodell kennt kein separates Prioritätsfeld. Dringlichkeit wird über Fälligkeit (date_time) und Status abgebildet.

Notiz bearbeiten¶

PUT /api/v2/notepads/{id}

Notiz löschen¶

DELETE /api/v2/notepads/{id}

Achtung

Gelöschte Notizen können nicht wiederhergestellt werden. Die Löschung wird im Änderungsprotokoll des Geräts festgehalten.

Anzeige im Inventar¶

Notizen werden in der Detailansicht eines Inventargeräts im Tab „Notizbuch" angezeigt. Die Sortierung erfolgt chronologisch (neueste zuerst).

Jede Notiz zeigt:

Notiztext (comment)
Erstelldatum und Autor
Letztes Änderungsdatum (falls bearbeitet)
Status

Im Dashboard wird ein Widget „Aktuelle Notizen" angezeigt, das die zuletzt erstellten oder bearbeiteten Notizen auflistet. Es bietet einen schnellen Überblick über die neuesten Einträge im gesamten System.

Information	Beschreibung
Inhalt	Notiztext (`comment`)
Gerät	Zugeordnetes Inventargerät (verlinkt)
Autor	Ersteller der Notiz
Datum	Erstellungs- oder Änderungsdatum

Widget-Konfiguration

Die Anzahl der im Widget angezeigten Notizen kann in den Benutzereinstellungen angepasst werden (Standard: 5).

Berechtigungen¶

Die Zugriffskontrolle für das Notizbuch erfolgt über drei separate Berechtigungen:

Berechtigung	Beschreibung
`notepad_view`	Notizen lesen und im Dashboard-Widget anzeigen
`notepad_edit`	Notizen anlegen und bearbeiten
`notepad_delete`	Notizen löschen

Tipp

Vergeben Sie die Löschberechtigung (notepad_delete) nur an ausgewählte Benutzer, um eine versehentliche Löschung wichtiger Notizen zu vermeiden.

Suche¶

Notizen können über die globale Suchfunktion gefunden werden. Die Suche berücksichtigt den Notiztext (comment).