Workorder — Dokumente (Sub-Route)

Zweck

Sub-Route /workorders/:id/documents zeigt alle Dokumente mit Polymorph-Verknuepfung parentType = Workorder, parentId = :id — typischerweise Pruefprotokolle, Vor-Ort-Fotos, Mess-Berichte. Pflege erfolgt nach dem Standard-Pattern fuer Dokumente und Anhaenge.

Voraussetzungen

- Berechtigung `view:Workorder`, `view:Document`, `view:DocumentParent`. - Für Upload: `create:Document`/`create:DocumentParent`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Workorder, Workorder	Detail aufrufbar	—
view/create	Document, DocumentParent	Anhänge pflegen	APP_SPEAMCORE_VIEW/CREATE_DOCUMENT, DOCUMENT_PARENT

Schritt-für-Schritt-Anleitung

1. Auftrag (/workorders/:id) → Tab Dokumente.
2. Hochladen — Datei auswählen oder per Drag-and-Drop ablegen. Backend legt Document an + DocumentParent mit parentType = Workorder, parentId = :id.
3. Klick auf eine Zeile → Detail unter /documents/:id mit Versionen, Aktivitäten, Public-Link.

Typische Inhalte am Auftrag:

• Vor-Ort-Fotos (Anlage, Mangel-Beweis)
• Stoerungsmeldung (Eingangs-PDF/Mail)
• Pruefberichts-PDFs
• Unterschrift (siehe SIGNATUR-Quick-Button) — wird automatisch als Document mit documentType = 'signature' abgelegt.

Folge-Pattern siehe Dokumente und Anhaenge — gilt für alle Module.

Wiederverwendbare Konzepte

• Dokumente und Anhaenge
• Polymorpher Parent-Pattern
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Workorders — Eltern-Modul.
• Document-Center — globale Browse-Sicht.
• Documents — Detail.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/document-parents?filter[parentType=Workorder]	Anhänge	view DocumentParent
POST	/api/documents	Upload	create Document

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.