Berichte

Berichte sind die Aufzeichnung des Feldmitarbeiters über abgeschlossene Arbeit. Wenn ein Mitarbeiter eine Installation, Reparatur oder Inspektion abschließt, reicht er einen Bericht ein, der festhält, was getan wurde, welche Materialien verwendet wurden, wo die Arbeit stattfand und welche Fotos oder Notizen vorliegen. Das Einreichen eines Berichts erstellt automatisch Inventarverbrauchstransaktionen und fließt in Zahlungsberechnungen ein — kein separater Papierkram erforderlich.

Berichtsstruktur

Berichte-Seite zeigt Feldausführungsdatensätze mit Verbrauch und Status

Kernfelder:

• Name - Berichtstitel oder Zusammenfassung
• Beschreibung - Detaillierte Notizen, Beobachtungen, aufgetretene Probleme
• Berichtet von - Benutzer, der den Bericht eingereicht hat
• Berichtsdatum - Wann die Arbeit durchgeführt wurde
• Arbeitsauftrag - Optionale Verknüpfung zur übergeordneten Zuweisung
• Geometrie - Standort, an dem die Arbeit durchgeführt wurde (Punkt, Linie oder Polygon)

Arbeitsdokumentation:

• Arbeit abgeschlossen - Array von verbrauchten Ressourcen und fertiggestellten Aufgaben
• Verbraucht von - Welche Bestandsartikel depletiert wurden (löst Transaktionen aus)

Medien:

• Fotos - Vorher/Nachher-Bilder, aufgetretene Probleme
• Anhänge - Dokumente, Diagramme, Zertifizierungen

Arbeit-abgeschlossen-Struktur

Jeder Eintrag in der Liste „Arbeit abgeschlossen" dokumentiert eine Art von durchgeführter Arbeit:

Beispiel: Ein Mitarbeiter meldet die Installation von 45 m Cat6-Kabel, 8 Verbindungsdosen und 3,5 Stunden Elektriker-Arbeit, alles gegen dieselbe Aufgabe.

Ad-Hoc-Berichte (keine formale Aufgabe)

Das Feld Aufgabe in jedem Arbeit-abgeschlossen-Eintrag ist optional — dies unterstützt ungeplante Arbeit:

Anwendungsfälle:

• Notfallreparaturen (kaputte Ausrüstung, Unfälle)
• Kundenservice-Anrufe (ungeplante Standortbesuche)
• Während anderer Arbeit entdeckte Wartung
• Erkundungsarbeit (Umfragen, Bewertungen)

Beispiel:

Bericht: "Notfall-Glasfaserreparatur - Sturmschaden"
Arbeit abgeschlossen: [
  { resource: "Glasfaserkabel", volume: 20, uom: "meters" }
  // Keine Aufgabe verknüpft - dies war ungeplante Notfallarbeit
]
Verbraucht von: [
  { stockItemId: truck_fiber_id, resource: "Glasfaserkabel", volume: 20, uom: "meters" }
]

Das System erstellt dennoch Verbrauchstransaktionen, verfolgt Materialkosten und berechnet die Zahlung — auch ohne formale Aufgabenzuweisung.

Verbraucht von (automatische Transaktionen)

Die Liste „Verbraucht von" löst beim Einreichen des Berichts automatische Inventarabbuchungen aus:

Workflow:

1. Mitarbeiter reicht Bericht mit Einträgen unter „Verbraucht von" ein
2. System prüft Bestandsverfügbarkeit bei jedem Bestandsartikel
3. Verbrauchstransaktionen werden automatisch erstellt
4. Transaktionen werden mit diesem Bericht verknüpft
5. Bestandsartikelmengen werden reduziert
6. Bei unzureichendem Bestand → Bericht abgelehnt oder Mitarbeiter wird zur Teilmenge aufgefordert

Beispiel:

Verbraucht von: [
  { stockItemId: johns_truck_cable, resource: "Cat6-Kabel", volume: 45, uom: "meters" },
  { stockItemId: johns_truck_boxes, resource: "Verbindungsdosen", volume: 8, uom: "units" }
]

Ergebnis:
  - 2 Verbrauchstransaktionen erstellt
  - Johns Fahrzeuginventar um 45 m Kabel und 8 Dosen reduziert
  - Transaktionen mit diesem Bericht verknüpft
  - Zahlungsberechnung hat zuverlässige Verbrauchsdaten

Vorteile:

• Bestand immer genau (kann Arbeit nicht berichten ohne Verbrauch aufzuzeichnen)
• Transaktions-Audit-Trail automatisch
• Verhindert "Geisterverbrauch" (Bericht ohne Bestandsänderung)
• Zahlung basierend auf tatsächlich verwendeten Materialien

Berichtsvalidierung

Beim Einreichen eines Berichts prüft das System:

Bestandsverfügbarkeit:

• Jeder Eintrag unter „Verbraucht von" wird geprüft
• Bei unzureichendem Volumen eines Bestandsartikels → Optionen:
  1. Ganzen Bericht ablehnen (Fehlermeldung)
  2. Teilverbrauch anfordern (berichtetes Volumen reduzieren)
  3. Negativen Saldo erlauben (mit Warnung — erfordert später eine Korrekturtransaktion)

Arbeit-Verbrauch-Übereinstimmung:

• Warnung, wenn die Verbrauchssummen nicht mit den Mengen der abgeschlossenen Arbeit übereinstimmen
• Beispiel: 50 m Kabelarbeit gemeldet, aber nur 30 m aus Bestand verbraucht
• Blockiert die Einreichung nicht (Mitarbeiter könnte eigene Materialien verwendet haben)
• Wird für Validierungsprüfung markiert

Geometrievalidierung:

• Punkte müssen gültige Koordinaten haben
• Linien müssen mindestens 2 Punkte haben
• Polygone müssen geschlossen sein (erster Punkt = letzter Punkt)
• Arbeitsstandort muss innerhalb einer angemessenen Entfernung von der Aufgabengeometrie liegen (konfigurierbar)

Berichte erstellen

Erforderlicher Zugriff: Admin-Recht reportsCreate (oder Selbstberichterstattungs-Berechtigung)

Workflow:

1. Zu Fulfillment → Berichte navigieren
2. „Bericht hinzufügen" klicken
3. Grundinformationen ausfüllen (Name, Beschreibung, Datum)
4. Zuweisung verknüpfen (optional — für Fortschrittsverfolgung erforderlich)
5. Einträge unter „Arbeit abgeschlossen" hinzufügen:
   • Ressource auswählen
   • Abgeschlossenes Volumen eingeben
   • Mit Aufgabe verknüpfen (optional)
6. Einträge unter „Verbraucht von" hinzufügen:
   • Bestandsartikel auswählen (normalerweise der persönliche Standort des Mitarbeiters)
   • Ressource auswählen
   • Verbrauchtes Volumen eingeben
7. Geometrie setzen (wo Arbeit durchgeführt wurde)
8. Fotos/Anhänge hochladen
9. Einreichen → Transaktionen werden automatisch erstellt

Schnellbericht aus Arbeitsauftrag: Vorab ausgefülltes Formular aus der Zuweisungsdetailansicht:

• Arbeitsauftrag, zugewiesen an, verfügbare Aufgaben werden automatisch befüllt
• Vorgeschlagener Verbrauch basierend auf Ressourcenzielen
• Mitarbeiter passt Istwerte an und reicht ein

Mobile Berichtserstellung: Vereinfachte mobile Oberfläche:

• Kameraintegration für Fotos
• GPS-Autoerfassung für Geometrie
• Sprach-zu-Text für Beschreibungen
• Minimale erforderliche Felder

Berichtsfortschrittsbeitrag

Berichte aktualisieren den Aufgaben- und Zuweisungsfortschritt:

Aufgabenfortschritt:

• Summe aller abgeschlossenen Arbeiten für diese Aufgabe (aus allen Berichten)
• Geteilt durch Aufgaben-Ressourcenanforderungen
• Auf 100 % pro Ressource gedeckelt

Arbeitsauftragsfortschritt:

• Summe aller abgeschlossenen Arbeiten für diese Zuweisung (aus allen Berichten)
• Geteilt durch Zuweisungs-Ressourcenziele
• Auf 100 % pro Ressource gedeckelt
• Durchschnitt über alle Ziele berechnet

Überlieferung: Mitarbeiter kann mehr als zugewiesen melden:

• Trägt zum Aufgabenfortschritt bei (hilft, die Aufgabe schneller abzuschließen)
• Zuweisungsfortschritt auf 100 % gedeckelt (Mitarbeiter hat Ziele übertroffen)
• Validierung prüft Überlieferung (Genauigkeit verifizieren)

Berichtsdetailansicht

Angezeigte Informationen:

• Grunddetails (Name, Beschreibung, Datum, berichtet von)
• Arbeitsauftragslink (falls zutreffend)
• Liste „Arbeit abgeschlossen" mit Aufgabenreferenzen
• Liste „Verbraucht von" mit Bestandsartikellinks
• Verbrauchstransaktionen (automatisch erstellt)
• Fotos und Anhänge
• Geometrie auf Karte
• Validierungsergebnisse (falls QC durchgeführt)

Verfügbare Aktionen:

• Bericht bearbeiten (vor Validierung)
• Zusätzliche Fotos hochladen
• Kommentare/Notizen hinzufügen
• Validierung anfordern
• Verbrauchstransaktionen anzeigen
• Bericht drucken (PDF-Export)

Zahlungsberechnung

Berichte treiben Zahlungsworkflows:

Arbeitszahlung:

Arbeit abgeschlossen:
  - Elektriker: 3.5 Stunden
  
Zahlung = 3.5 Stunden × Stundensatz

Materialkosten:

Verbraucht von:
  - Cat6-Kabel: 45m × 2€/m = 90€
  - Verbindungsdosen: 8 Einheiten × 15€/Einheit = 120€
  
Gesamtmaterialkosten = 210€

Gesamtauftragskosten:

Arbeit + Materialien = Zahlung an Arbeiter + Materialkosten = Gesamt

Transaktions-Audit-Trail stellt zuverlässige Materialkosten bereit (kann Verbrauch nicht aufblasen - an tatsächliche Bestandsdeplezierung gebunden).

Validierungs-Badges in der Berichtsliste

Validierungen werden jetzt direkt auf der Berichtsseite als Ampel-Badges angezeigt — es ist keine Navigation mehr zu einer separaten /fulfillment/validations-Seite nötig, um sie anzuzeigen oder zu erstellen. Jede Berichtszeile hat:

• Ein aggregiertes Validierungs-Badge in einer eigenen Spalte, das den schwersten Status mit einer Zählung anzeigt (z. B. FAILED · 3). Beim Darüberfahren mit der Maus wird eine Statusaufschlüsselung eingeblendet.
• Eine statusgruppierte Badge-Zeile innerhalb des aufgeklappten Berichts, mit einem Badge pro Validierung.

Ein Klick auf ein beliebiges Badge öffnet das ValidationEditModal — ein vollständiges Overlay zum Anzeigen, Bearbeiten oder Erstellen einer Validierung, ohne die Berichtsseite zu verlassen. Die Schaltfläche Einreichen im Modal speichert Bericht- und Validierungsbearbeitungen gemeinsam atomar.

Siehe Validierungen für die vollständige Anleitung.

Berichte filtern

Vorgefertigte Filter:

• Von mir berichtet - Eigene eingereichte Berichte
• Validierung benötigt - Berichte ohne Validierung (graues Badge)
• Kürzlich - Letzte 7 Tage

Validierungsstatusfilter: Die Berichtsliste akzeptiert einen Validierungsstatusfilter mit folgenden Optionen:

• all - alle Berichte (Standard)
• none - Berichte ohne Validierung
• any - Berichte mit mindestens einer Validierung
• failed - Berichte mit mindestens einer fehlgeschlagenen Validierung
• revision - Berichte mit mindestens einer needs-revision-Validierung
• passed - Berichte, bei denen alle Validierungen bestanden sind

Benutzerdefinierte Filter:

• Datumsbereich
• Von einem bestimmten Benutzer berichtet
• Zuweisung
• Aufgabenreferenz

Best Practices

Genauer Verbrauchsbericht:

• Tatsächliche verwendete Materialien berichten (nicht geschätzt)
• Bestandsartikel von Ihrem persönlichen Standort verwenden (beweist Sie hatten Materialien)
• Überverbrauch dokumentieren (erklären warum mehr Materialien benötigt)

Rechtzeitige Einreichung:

• Berichte am selben Tag wie Arbeit durchgeführt einreichen
• GPS und Zeitstempel stellen Verantwortlichkeit bereit
• Frische Erinnerung = genauere Details

Fotodokumentation:

• Vorher-Fotos (Standortzustand)
• Während-Fotos (Arbeit im Gange)
• Nachher-Fotos (abgeschlossene Installation)
• Problembilder (Schaden, Hindernisse, nicht-standardmäßige Bedingungen)

Detaillierte Beschreibungen:

• Jegliche Abweichungen von Aufgabenanforderungen notieren
• Gründe für Über/Unter-Verbrauch dokumentieren
• Probleme für zukünftige Referenz aufzeichnen (verschlossene Tore, fehlende Genehmigungen, Wetter)

Mit Aufgaben verknüpfen wenn möglich:

• Hilft Aufgabenfortschritt zu verfolgen
• Ermöglicht räumliche Analyse (wo Arbeit konzentriert)
• Verbessert zukünftige Aufgabenschätzung

Auf Validierungsbefunde reagieren:

• Validierungsergebnisse prompt überprüfen
• Klärung bereitstellen wenn hinterfragt
• Fehler in zukünftigen Berichten korrigieren
• Von Qualitätsfeedback lernen

Berichtsunveränderlichkeit

Soft-Deletes: Berichte können als gelöscht markiert werden aber bleiben in Datenbank:

• Bewahrt Transaktionshistorie (Verbrauchstransaktionen bleiben)
• Bewahrt Zahlungs-Audit-Trail
• Konfigurierbare Aufbewahrungszeitraum (App-Einstellungen)
• viewDeleted Admin-Recht um gelöschte Berichte zu sehen

Bearbeitungsbeschränkungen: Nach Validierung durchgeführt:

• Berichte werden schreibgeschützt
• Korrekturen erfordern neuen Bericht mit Notizen
• Bewahrt QC-Integrität
• Versionshistorie verfolgt alle Änderungen vor Validierung

Audit-Trail:

• Jede Berichtsbearbeitung protokolliert (wer, wann, was geändert)
• Verbrauchstransaktionen niemals bearbeitet (unveränderlich)
• Zahlungsberechnungen zu ursprünglichen Berichtsdaten zurückverfolgbar