Begehungen

Fotos und Unterschriften

Am Ende des Begehungsformulars befinden sich zwei Abschnitte, die besonders für den Einsatz vor Ort auf Tablets gedacht sind: Fotos und Unterschriften.

#Fotos

Der Foto-Abschnitt erlaubt die direkte Aufnahme vom Tablet bzw. Smartphone oder den Upload aus der Galerie.

#Aufnahme

Ein Klick auf Foto hinzufügen öffnet je nach Gerät:

  • auf Mobilgeräten: die Kamera-App direkt (zurückseitige Kamera bevorzugt)
  • auf Desktop-Geräten: den Datei-Dialog zur Auswahl eines oder mehrerer Bilder

Mehrere Bilder können in einem Vorgang hinzugefügt werden.

Jedes Foto wird serverseitig in der zentralen Bild-Pipeline (ImageProfile::InspectionPhoto) auf max. 1 600 px Kantenlänge skaliert und als WebP mit Qualität 80 re-encodiert. Dadurch bleiben Speicher- und Übertragungsgrößen klein, ohne sichtbare Qualitätsverluste.

#Foto-Galerie

Alle Fotos der Begehung erscheinen als Raster unterhalb des Aufnahme-Knopfes. Ein Klick auf ein Foto öffnet es groß im Lightbox-Modus. Ein Klick auf das Papierkorb-Symbol löscht das Foto — die Bestätigung erfolgt über einen Dialog. Gelöschte Fotos werden unwiderruflich entfernt.

#Online-/Offline-Anzeige

Oben im Foto-Abschnitt steht eine kleine Statuszeile:

  • Grüner Punkt „Online“ — Verbindung verfügbar, Uploads laufen direkt durch
  • Roter Punkt „Offline“ — keine Verbindung. Fotos werden lokal im Browser (IndexedDB) zwischengespeichert und bei nächster Verbindung automatisch hochgeladen.

Daneben steht, was gerade mit den Fotos passiert. Es gibt vier Meldungen, und sie können sich ergänzen — eine Warteschlange kann durchaus ein wartendes und ein gescheitertes Foto zugleich enthalten:

Meldung Bedeutung
N Foto(s) werden synchronisiert, sobald die Verbindung wiederhergestellt ist. Gerät ist offline. Sobald die Verbindung zurück ist, geht es von allein weiter.
N Foto(s) werden hochgeladen … Ein Upload läuft gerade.
N Foto(s) warten auf den Upload. Ein Versuch ist fehlgeschlagen; der nächste läuft automatisch an.
N Foto(s) konnten nicht hochgeladen werden. Aufgegeben — hier passiert ohne Zutun nichts mehr.

Sind alle Uploads erledigt, wechselt die Anzeige auf „Alle Fotos hochgeladen ✓“.

#Wenn ein Upload fehlschlägt

Ein fehlgeschlagener Upload wird automatisch wiederholt, mit wachsendem Abstand (2, 4, 8, 16 und 30 Sekunden). Nach fünf erfolglosen Versuchen gibt die Anwendung auf und sagt das auch — das Foto bleibt in der Warteschlange und geht nicht verloren.

Antwortet der Server mit einer Ablehnung, die sich durch Wiederholen nicht ändern lässt (etwa weil die Begehung inzwischen gelöscht wurde oder die Sitzung abgelaufen ist), wird gar nicht erst wiederholt.

Solange Fotos warten, steht neben der Statuszeile der Knopf Erneut versuchen. Er stößt alle wartenden Fotos sofort wieder an — auch die bereits aufgegebenen. Das ist der Weg zurück, wenn die Verbindung wieder steht und man nicht auf den nächsten automatischen Versuch warten möchte.

Ein Foto, das der Browser gar nicht erst als Bild lesen kann, erscheint in einem roten Hinweis mit seinem Dateinamen („Nicht verarbeitet: …“). Es landet dann nicht in der Warteschlange und muss neu ausgewählt werden.

#Warnung beim Abschließen

Begehung abschließen und Später fortsetzen weisen darauf hin, wenn noch Fotos nur auf dem Gerät liegen:

N Fotos sind noch nicht hochgeladen und liegen nur auf diesem Gerät. Zum Fortfahren die Schaltfläche erneut betätigen.

Ein zweiter Druck auf dieselbe Schaltfläche führt den Vorgang aus — die Warnung hält niemanden auf, etwa im Funkloch. Kommen danach weitere Fotos in die Warteschlange, wird erneut gewarnt; und die Zustimmung gilt jeweils nur für die Schaltfläche, auf der sie gegeben wurde.

Das Formular selbst (die Checkliste, Unterschriften, Speichern) benötigt weiterhin eine Verbindung — lediglich die Foto-Warteschlange funktioniert offline. Ein vollständiger Offline-Modus ist in Planung, wird aber erst bei deutlich häufigerem Bedarf umgesetzt.

#Verwerfen und Löschen

Wird ein Entwurf über Entwurf verwerfen gelöscht — oder eine abgeschlossene Begehung über Löschen —, verschwinden auch die noch wartenden Fotos aus dem lokalen Zwischenspeicher. Der Bestätigungstext („Alle Eingaben, Fotos und Unterschriften gehen verloren“) gilt damit wörtlich, nicht nur für die bereits hochgeladenen.

#Speicherort

Fotos liegen auf dem Server im Ordner storage/app/inspections/{ID}/ und werden über die Mitglieder-/Parzellen-Dokumentverwaltung verknüpft. Sie lassen sich direkt im Flyout und aus dem PDF-Protokoll heraus betrachten. Im Mängelbrief werden Fotos nicht eingebettet.

#Unterschriften

Begehungsprotokolle sind formelle Dokumente und werden vor Ort von beiden Seiten unterschrieben. Im Abschnitt Unterschriften am Ende des Flyouts stehen dafür bis zu drei Unterschrift-Felder bereit:

Feld Pflicht Beschreibung
Pächter — Unterschrift des Pächters
Vorstandsmitglied 1 — Erstes unterzeichnendes Vorstandsmitglied
Vorstandsmitglied 2 (optional) — Zweites Vorstandsmitglied, falls anwesend

Technisch sind die Unterschriften nicht pflichtig — eine Begehung kann auch ohne Unterschrift abgeschlossen werden (z. B. bei Abwesenheit des Pächters oder zur späteren händischen Unterschrift auf dem Ausdruck).

#Eingabe

Jedes Unterschrift-Feld zeigt eine Leinwand, auf der mit dem Finger oder einem Stylus signiert werden kann. Unter der Leinwand stehen zwei Knöpfe:

  • Löschen — leert die Leinwand
  • Fertig — übernimmt die aktuelle Zeichnung als Unterschrift

Wird eine neue Unterschrift über eine bestehende gezeichnet, ersetzt sie die alte.

#Zeitstempel

Beim Abschließen bzw. Speichern der Begehung werden automatisch folgende Zeitstempel gesetzt:

Zeitstempel Wird gesetzt, wenn
Unterschrieben am (Pächter) Die Pächter-Unterschrift nicht leer ist
Unterschrieben am (Vorstand) Mindestens eine Vorstands-Unterschrift nicht leer ist

Beide Zeitstempel zeigen den Zeitpunkt des Speicherns, nicht den der ursprünglichen Zeichnung.

#Anzeige nach Abschluss

Ist eine Begehung abgeschlossen, zeigt das Flyout die Unterschriften schreibgeschützt: das gespeicherte PNG wird eingeblendet, darunter der jeweilige Zeitstempel. Soll die Unterschrift nachträglich geändert werden, muss die Begehung gelöscht und neu angelegt werden — die Unterschriften sind fester Bestandteil des formellen Protokolls.

#Einbettung ins PDF

Im Begehungsprotokoll (PDF) werden die Unterschriften als Bilder eingebettet. Fehlt eine Unterschrift, erscheint an der entsprechenden Stelle eine leere Signaturzeile für die händische Unterzeichnung auf dem Ausdruck. Details unter PDF-Protokoll & Mängelbriefe.