Alle Funktionen im Detail

Vollständige Übersicht aller Funktionen der HH Door Measure App

📸 4-Perspektiven-Fotoaufnahme

Die App führt Mitarbeitende durch einen strukturierten Fotoaufnahme-Prozess mit vier definierten Perspektiven, um eine vollständige und konsistente Dokumentation jeder Tür sicherzustellen:

1. Front-Ansicht: Die Tür wird frontal fotografiert, sodass die gesamte Türöffnung inklusive Zarge vollständig sichtbar ist. Der Zollstock (Referenzmaß) muss dabei im Bild platziert sein.
2. Seitenansicht: Aufnahme von der Seite, um die Tiefe der Zarge und des Mauerwerks zu erfassen. Diese Perspektive liefert wichtige Daten für die Berechnung der Einbautiefe.
3. Ansicht von oben: Aufnahme der Oberkante der Tür, um die obere Zargenbreite und den oberen Abschluss zu dokumentieren.
4. Detailansicht: Nahaufnahme spezifischer Details wie Scharniere, Schloss, Zargenprofile oder besondere bauliche Gegebenheiten.

🤖 KI-gestützte Bildanalyse

Das Herzstück der App ist die KI-basierte Bildanalyse mittels OpenAI GPT-4o Vision API. Nach Erfassung aller vier Perspektiven werden die Bilder automatisch an das Vision-Modell übertragen und analysiert.

Analyseprozess

• Die Fotos werden als Base64-kodierte Bilder an die OpenAI API gesendet.
• Der Referenz-Zollstock im Bild dient als bekanntes Maß. Die Standardlänge beträgt 200 cm und kann in den Einstellungen angepasst werden.
• Die KI identifiziert die Tür, die Zarge und den Zollstock und berechnet die Proportionen.
• Ermittelte Maße: Breite, Höhe und Tiefe der Tür sowie der Zarge – alle Werte in Millimetern.

Konsens-Algorithmus für maximale Genauigkeit

Um die Zuverlässigkeit der Messergebnisse zu maximieren, führt die App nicht nur eine, sondern drei unabhängige Analyseläufe durch. Jeder Lauf verwendet identische Parameter:

• Temperature: 0 – Keine zufällige Variation in den Antworten
• Seed: 42 – Fester Seed für deterministische Ergebnisse
• Modell: GPT-4o – Das leistungsstärkste verfügbare Vision-Modell

Aus den drei Ergebnissen wird für jeden Messwert (Breite, Höhe, Tiefe – jeweils für Tür und Zarge) der Median berechnet. Dieses Verfahren eliminiert Ausreißer und liefert ein robusten Konsensus-Ergebnis, das deutlich zuverlässiger ist als eine einzelne Messung.

⏳ Dynamische Statusanzeige

Während der Analyse rotiert die App durch zehn verschiedene, informative Statustexte, die den aktuellen Verarbeitungsstand widerspiegeln:

1. „Bilder werden analysiert…"
2. „KI vermisst die Tür…"
3. „Zollstock wird erkannt…"
4. „Proportionen werden berechnet…"
5. „Maße werden ermittelt…"
6. „Zarge wird analysiert…"
7. „Daten werden zusammengeführt…"
8. „Ergebnisse werden aufbereitet…"
9. „Konsens wird berechnet…"
10. „Fast geschafft…"

Zusätzlich wird nach Abschluss der Analyse die Gesamtdauer in Sekunden angezeigt, um eine transparente Rückmeldung über die Verarbeitungszeit zu geben.

📊 Ergebnisanzeige

Nach erfolgreicher Analyse präsentiert die App die ermittelten Maße in einer übersichtlichen Ergebnis-Darstellung:

• Tür-Maße: Breite × Höhe × Tiefe in Millimetern
• Zargen-Maße: Breite × Höhe × Tiefe in Millimetern
• GPS-Koordinaten: Breiten- und Längengrad des Aufnahmestandorts
• Adresse: Per Reverse Geocoding aufgelöste Adresse (Google Geocoding API)
• Google Maps Link: Die GPS-Koordinaten sind als tippbarer Link hinterlegt, der direkt Google Maps öffnet und den Standort auf der Karte anzeigt
• Analysedauer: Zeitangabe der Verarbeitungsdauer in Sekunden

🔍 Zoom- und Blätterfunktion

Die aufgenommenen Fotos können nach der Analyse interaktiv betrachtet werden:

• Pinch-to-Zoom: Mit der bekannten Zwei-Finger-Geste können Fotos stufenlos vergrößert und verkleinert werden (bis zu 4-fache Vergrößerung).
• Wischgesten: Zwischen den vier Perspektiv-Fotos kann per horizontaler Wischbewegung navigiert werden (PageView).
• Seitenindikator: Eine Punkt-Anzeige unter dem Foto zeigt die aktuelle Position im Bilderset an.

📄 Automatische PDF-Erstellung

Für jede Messung erstellt die App automatisch einen professionellen PDF-Bericht, der alle relevanten Informationen enthält:

• Alle vier Fotos in voller Auflösung
• Tür- und Zargenmaße in tabellarischer Darstellung
• GPS-Koordinaten und aufgelöste Adresse
• Datum und Uhrzeit der Aufnahme
• Name und Profil des durchführenden Mitarbeiters

Der PDF-Bericht wird automatisch in Firebase Cloud Storage hochgeladen und kann über die API abgerufen werden.

☁️ Cloud-Speicherung & Synchronisation

Sämtliche Daten werden sicher in der Google-Cloud-Infrastruktur gespeichert:

Firebase Firestore

• Collection door_results: Alle Messergebnisse mit sämtlichen Metadaten (Maße, GPS, Adresse, Zeitstempel, Mitarbeiterdaten)
• Collection users: Mitarbeiterprofile (Name, Profilbild-URL)

Firebase Cloud Storage

• Pfad door_results/{docId}/: Alle vier Fotos und der PDF-Bericht jeder Messung
• Pfad users/{userId}/: Profilbilder der Mitarbeiter

Cloud Functions

Eine Firebase Cloud Function (getAllResults) stellt eine REST API bereit, über die alle gespeicherten Messergebnisse inklusive Mitarbeiterdaten abgerufen werden können. Die API aggregiert Daten aus der door_results-Collection und reichert sie mit Mitarbeitername und Profilbild-URL aus der users-Collection an. Die Cloud Function läuft in der Region europe-west3 (Frankfurt).

👤 Mitarbeiterprofil

Jeder Mitarbeitende kann ein persönliches Profil anlegen, das automatisch mit jeder Messung verknüpft wird:

• Profilbild: Eigenes Foto aufnehmen oder aus der Galerie auswählen. Das Bild wird in Firebase Cloud Storage hochgeladen und als URL im Profil hinterlegt.
• Name: Frei wählbarer Mitarbeitername. Änderungen werden automatisch beim Verlassen der Profilseite gespeichert – kein manuelles Speichern nötig (Auto-Save).
• Standard-Profilbild: Solange kein eigenes Foto hinterlegt ist, wird ein grünes Standard-Avatar-Bild angezeigt.

⚙️ Einstellungen

Die Einstellungsseite ermöglicht die Anpassung des Referenzmaßes (Zollstock-Länge):

• Zollstock-Länge: Standardmäßig 200 cm. Kann auf beliebige Werte angepasst werden, falls ein kürzerer oder längerer Zollstock verwendet wird.
• Die eingestellte Länge wird beim nächsten Analyseprozess automatisch als Referenzmaß verwendet.
• Die Einstellung wird lokal auf dem Gerät gespeichert und bleibt dauerhaft erhalten.

📍 GPS-Standort & Adressauflösung

Bei jeder Messung erfasst die App automatisch den GPS-Standort des Aufnahmeortes:

• GPS-Koordinaten: Breiten- und Längengrad werden aus den EXIF-Daten der Fotos oder über die Geräte-Standortdienste ermittelt.
• Reverse Geocoding: Die Koordinaten werden über die Google Geocoding API in eine lesbare Adresse (Straße, Hausnummer, PLZ, Ort) umgewandelt.
• Google Maps Integration: Auf der Ergebnisseite sind die GPS-Koordinaten als antippbarer Link dargestellt. Ein Tipp öffnet Google Maps und zeigt den exakten Aufnahmestandort.

🔐 Persistente Geräteidentifikation

Jedem Gerät wird eine eindeutige, persistente ID zugewiesen, die als Basis für die Zuordnung aller Daten dient:

• UUID v4: Beim ersten Start wird eine zufällige UUID generiert.
• iOS: Speicherung im iOS Keychain – die ID überlebt App-Deinstallation und Neuinstallation.
• Android: Speicherung im Android Keystore – ebenfalls installations-persistent.
• Migration: Falls eine ältere ID aus SharedPreferences existiert, wird diese automatisch in den sicheren Speicher migriert.

ℹ️ App-Informationen

Die App-Info-Seite bietet detaillierte technische Informationen in fünf Abschnitten:

1. VERSION: App-Version, Build-Nummer, Package-Name
2. APP-DETAILS: App-Name, Geräte-ID, Plattforminformationen
3. TECHNOLOGIE: Flutter/Dart-Version, KI-Modell, Analyseschritte, Konsensverfahren
4. BACKEND & SPEICHER: Firebase-Konfiguration, Storage-Pfade, Cloud Function URL
5. ENTWICKLER: Firmenname und Standort

🛡️ Integrierte Datenschutzseite

Direkt in der App ist eine vollständige Datenschutzerklärung abrufbar, die alle relevanten Informationen gemäß DSGVO enthält. Die Datenschutzseite wird aus einer Markdown-Datei geladen und mit einem eigenen Markdown-Renderer dargestellt, der Überschriften, Fettdruck, Links, Tabellen, Aufzählungen und horizontale Linien unterstützt.

☰ Navigation in der App

Das Hauptmenü der App ist über ein Hamburger-Icon (drei horizontale Linien) erreichbar und bietet folgende Einträge:

1. Profil – Mitarbeiterprofil bearbeiten
2. Einstellungen – Zollstock-Länge anpassen
3. App-Info – Technische Details und Versionsinfo
4. Datenschutz – Vollständige Datenschutzerklärung

Alle Seiten verwenden ein konsistentes grünes Gradient-Design als Hintergrund, passend zur Markenidentität der HeimHaus GmbH.