Mobile App

Die mobile Benutzeroberfläche von Aptli wurde für Außendienstmitarbeiter auf Smartphones und Tablets entwickelt. Installieren Sie sie direkt über Ihren Browser – ganz ohne App-Store – und erhalten Sie Offline-Zugriff auf Ihre Aufträge, einen QR-Scanner für die Bestandserfassung, die Erstellung von Berichten mit GPS und Fotoaufnahmen sowie die Erstellung von Karten. Die mobile Nutzung konzentriert sich auf die Ausführung; Verwaltungsaufgaben bleiben auf dem Desktop.

Was ist eine PWA?

Progressive Web App = installierbare Website, die wie eine native App funktioniert:

Installation: Installieren Sie die App direkt über den Browser – kein App-Store, kein Genehmigungsverfahren. Der genaue Pfad hängt von Ihrem Gerät ab (detaillierte Schritte für die einzelnen Plattformen siehe unten):

• Android (Chrome/Edge): Melden Sie sich an und tippen Sie dann in der Seitenleiste der App auf Zum Startbildschirm hinzufügen. Fallback: Das Drei-Punkte-Menü des Browsers → App installieren / Zum Startbildschirm hinzufügen.
• iOS (Safari): Tippen Sie auf die Teilen-Schaltfläche → Zum Startbildschirm hinzufügen. iOS zeigt niemals automatisch eine Aufforderung an.
• Desktop (Chrome/Edge): Klicken Sie auf das kleine Installationssymbol rechts neben der Adressleiste oder nutzen Sie das Drei-Punkte-Menü → Aptli installieren.

Nach der Installation öffnet sich die App im Vollbildmodus ohne Browser-Oberfläche.

Vorteile gegenüber dem mobilen Browser:

• Schnellerer Start (auf dem Gerät zwischengespeichert)
• Funktioniert offline (Offline-Caching)
• Push-Benachrichtigungen
• Verknüpfungen auf dem Startbildschirm zu bestimmten Funktionen
• Bessere Leistung (optimierte Assets)

Zusätzliche Desktop-Tools: Einige Funktionen wie Massenimporte, erweiterte Bearbeitung und Datenexport sind nur in der Desktop-App verfügbar; die mobile PWA bietet eine Verknüpfung „Datenübertragung“, der Export ist jedoch auf die Desktop-Version beschränkt.

Kein App Store erforderlich:

• Kein Genehmigungsverfahren durch Apple/Google
• Updates werden sofort bereitgestellt (keine Verzögerung durch App-Store-Prüfung)
• Gleiche Codebasis wie die Webversion (effiziente Wartung)

Mobiler Umfang

Enthalten – Ausführungsfunktionen:

• ✅ Aufträge anzeigen (alle oder nur meine)
• ✅ Berichte aus Aufträgen erstellen
• ✅ QR-Codes scannen (Abholautorisierung)
• ✅ Karte mit Objekten und Aufgaben anzeigen
• ✅ Einfache Kartenobjekte erstellen (Punkt, Linie, Polygon)
• ✅ Berichte anzeigen (alle oder nur meine)
• ✅ Fotos in Berichte hochladen
• ✅ Eigenes Benutzerprofil bearbeiten
• ✅ Telefonnummer bestätigen (2FA)
• ✅ Hilfe anfordern (Hilfeanfrageformular)
• ✅ Auf an Sie gerichtete Hilfeanfragen antworten

Ausgeschlossen – Verwaltungsfunktionen:

• ❌ Aufträge erstellen (nur Desktop)
• ❌ Bestand ändern (nur Desktop, außer bei Scans durch autorisiertes Personal)
• ❌ Neue Funktionen registrieren (einfache Entwürfe OK, Massenimporte nur auf dem Desktop)
• ❌ Benutzern Rollen zuweisen (nur Desktop)
• ❌ Massenoperationen (nur Desktop)

Begründung:

• 5 % der Größe/Komplexität der Desktop-App
• Fokus auf die Ausführung vor Ort
• Komplexe Verwaltungsaufgaben lassen sich besser auf dem Desktop erledigen

Mobile Benutzeroberfläche

Mobile PWA-Oberfläche – Startbildschirm, Aufträge, Berichte und QR-Scanner

In-App-Oberfläche für den QR-Code-Scanner

Navigationsleiste unten:

• Startseite (Schnellübersicht)
• Aufträge (anzeigen und filtern)
• Berichte (erstellen und anzeigen)
• Karte (Objekte, Aufgaben, Skizzieren)
• Profil (Kontoeinstellungen)

Schnellzugriffe (langes Drücken auf das Start-Symbol):

• Scanner (QR-Code-Leser)
• Schnellbericht (Bericht vom aktuellen Standort erstellen)
• Meine Aufgaben (Aufträge mit meinen Aufgaben auf der Karte hervorgehoben)

Gestenunterstützung:

• Zwischen Registerkarten wischen
• Pull-to-Refresh (Daten aktualisieren)
• Langes Drücken für Kontextmenüs
• Zoomen auf der Karte durch Zusammen- und Auseinanderziehen

Scanner-Funktion

QR-Code-Scanner für Bestandsabholungen und Objektverweise:

Anwendungsfälle:

• QR-Code für Auftragsabholung scannen → Bestandsübertragung genehmigen
• QR-Tag für Objekt scannen → Objektdetails öffnen
• QR-Code für Hilfeanfrage scannen → auf spezifisches Problem reagieren

Ablauf:

1. Auf Scanner-Verknüpfung tippen (oder Scanner-Symbol in der unteren Navigationsleiste)
2. Die Kamera öffnet sich mit dem QR-Sucher
3. Richten Sie die Kamera auf den QR-Code
4. Automatische Erkennung und Dekodierung
5. Aktion ausgeführt (Abholung, zur Funktion navigieren usw.)

Abholungsautorisierung:

1. Scannen Sie den QR-Code für die Abholung der Zuweisung
2. Überprüfen Sie:
   • Sie sind der autorisierte Empfänger (oder verfügen über die Berechtigung canFacilitatePickups)
   • Lagerbestand am Ursprungsstandort verfügbar
   • GPS-Standort (innerhalb des Geofence, falls konfiguriert)
3. Abholung bestätigen
4. Transaktion wird automatisch erstellt
5. Lagerbestand wird Ihrem persönlichen Standort hinzugefügt

Offline-QR-Scans:

• Scans werden offline zwischengespeichert
• Werden verarbeitet, sobald wieder online
• Verhindert doppelte Abholungen (Deduplizierungslogik)

Ansicht „Aufträge“

Filteroptionen:

• Alle Aufträge
• Mir zugewiesen
• Von mir erstellt
• Status (ausstehend, in Bearbeitung, abgeschlossen)

Auftragskarte:

• Name und Beschreibung
• Zugewiesene Benutzer (Avatare)
• Status-Badge
• Zusammenfassung der Ressourcenziele
• Fortschrittsbalken
• Fälligkeitsanzeige

Aktionen:

• Tippen, um Details anzuzeigen
• Bericht erstellen (Schnellaktionsschaltfläche)
• QR-Code anzeigen (sofern autorisiert und Abholcode vorhanden)
• Status aktualisieren (in Bearbeitung → abgeschlossen)

Erstellung von Berichten

Ablauf der Schnellberichterstellung:

1. Aus dem Auftrag → auf „Bericht erstellen“ tippen
2. Vorausgefüllt: Auftrag, Aufgaben, vorgeschlagener Verbrauch
3. Ist-Werte anpassen (was tatsächlich passiert ist)
4. Auf Kamerasymbol tippen → Fotos aufnehmen
5. GPS-Standort automatisch erfasst (aktueller Standort)
6. Absenden → Verbrauchstransaktionen erstellt

Für Mobilgeräte optimierte Felder:

• Große Touch-Ziele (Schaltflächen, Eingabefelder)
• Sprach-zu-Text für Beschreibungen
• Foto-Upload von Kamera oder Galerie
• Automatische GPS-Erfassung (oder manuelle Kartenauswahl)
• Minimale Pflichtfelder (Name, abgeschlossene Arbeit, Verbrauch von)

Offline-Berichterstellung:

• Bericht offline erstellen
• Fotos lokal zwischengespeichert
• Automatisches Absenden bei Wiederherstellung der Verbindung
• Konfliktlösung bei serverseitigen Datenänderungen

Kartenansicht

Angezeigte Objekte:

• Alle festgeschriebenen Objekte (aus Ebenen)
• Aufgaben in der Nähe des aktuellen Standorts (Nähefilter)
• Ihre Aufträge hervorgehoben (farblich gekennzeichnet)

Kartensteuerung:

• Ebenenauswahl (Sichtbarkeit von Objekten umschalten)
• Schaltfläche „Aktueller Standort“ (auf GPS zentrieren)
• Basiskarten-Umschalter (Straßen, Satellit, Gelände)
• Suche (Objekt nach Name/ID suchen)

Einfaches Zeichnen:

• Tippen Sie auf die schwebende Aktionsschaltfläche +; beim ersten Tippen werden die Zeichenwerkzeuge angezeigt, beim zweiten Tippen wird das ausgewählte Werkzeug aktiviert (dieses zweistufige Verhalten sorgt für eine übersichtliche Benutzeroberfläche auf kleinen Bildschirmen)
• Wählen Sie den Geometrietyp (Punkt, Linie, Polygon)
• Tippen Sie auf die Karte, um Punkte hinzuzufügen
• Grundlegende Eigenschaften eingeben
• Als Entwurf speichern
• Hinweis: Auf Mobilgeräten erstellte Entwürfe unterliegen demselben Versions-/Commit-System wie auf dem Desktop. Mobilnutzer können ein Commit beantragen, aber nur Administratoren können dies genehmigen; endgültige Versionen sind nach der Genehmigung für alle sichtbar.

Offline-Kartenkacheln:

• Kartenkacheln werden zwischengespeichert (30 Tage gültig)
• Zwischengespeicherte Kacheln werden aus Geschwindigkeitsgründen zuerst geladen; das Netzwerk wird nur genutzt, wenn sie fehlen
• Funktioniert ohne Internetverbindung
• Synchronisiert Funktionen, sobald wieder online

Lagerübertragung (nur für autorisiertes Personal)

Mitarbeiter mit der Berechtigung canFacilitatePickups:

Ablauf:

1. Der Mitarbeiter kommt im Lager an
2. Zeigt den QR-Code für den Auftrag vor
3. Der Mitarbeiter scannt den QR-Code im Namen des Mitarbeiters
4. Das System überprüft:
   • Ob der Mitarbeiter der autorisierte Empfänger ist
   • Ob der Mitarbeiter die Berechtigung canFacilitatePickups hat
   • Ob Lagerbestand verfügbar ist
5. Die Übertragung wird durchgeführt
6. Die Transaktion protokolliert, wer den Scan durchgeführt hat, in wessen Auftrag und mit welcher Scanmethode (selbstständig oder mit Unterstützung durch einen Mitarbeiter)

Manuelle Erstellung von Übertragungen: Mitarbeiter können manuelle Übertragungen erstellen:

• Quellstandort auswählen
• Empfänger auswählen
• Ressourcen und Mengen auswählen
• Bestätigen → Transaktion erstellt

Profilverwaltung

Bearbeitbare Felder:

• Name, Titel, Abteilung
• Telefonnummer (mit Validierung)
• Benachrichtigungseinstellungen
• Sprachauswahl

Telefonvalidierung:

1. Telefonnummer eingeben
2. Auf „Code senden“ tippen
3. SMS mit 6-stelligem Code erhalten
4. Code eingeben
5. Telefon validiert (aktiviert SMS-Benachrichtigungen)

Zwei-Faktor-Authentifizierung:

• 2FA im Profil aktivieren
• TOTP-QR-Code mit Authentifizierungs-App scannen
• 6-stelligen Code zur Bestätigung eingeben
• Bei zukünftigen Anmeldungen erforderlich

Auf Mobilgeräten nicht bearbeitbar:

• E-Mail (Sicherheitsbeschränkung)
• Rollen (Admin-Funktion)
• Administratorrechte (Admin-Funktion)

Hilfeanfragen

Hilfeanfrage erstellen:

1. Tippen Sie auf „Hilfe anfordern“ (im Profil oder im Menü)
2. Formular ausfüllen:
   • Betreff
   • Beschreibung (Sprach-zu-Text-Funktion wird unterstützt)
   • Kategorie (technisch, Zugriff, Materialien usw.)
   • Priorität (niedrig, mittel, hoch, dringend)
3. Optional: Fotos hinzufügen
4. Absenden → Benachrichtigung wird an das zuständige Team gesendet

Auf Hilfeanfragen antworten:

• An Sie gerichtete Anfragen anzeigen
• Kommentare/Notizen hinzufügen
• Status aktualisieren
• Fotos zur Antwort hochladen
• Nach Lösung schließen

Offline-Funktionen

Offline-Caching:

• API-Antworten zwischengespeichert (1 Stunde gültig)
• Kartenkacheln zwischengespeichert (30 Tage gültig)
• App-Shell zwischengespeichert (sofortiges Laden)
• Bilder und Assets zwischengespeichert

Offline-First-Aktionen:

• Berichte erstellen (bei Online-Verbindung senden)
• Fotos aufnehmen (bei Online-Verbindung hochladen)
• Kartenelemente entwerfen (bei Online-Verbindung synchronisieren)
• Zwischengespeicherte Aufträge/Berichte anzeigen

Synchronisierungsanzeigen:

• Online: Grüner Punkt
• Offline: Grauer Punkt + „X Elemente warten auf Synchronisierung“
• Synchronisierung läuft: Ladekreisel + „X Elemente werden synchronisiert...“
• Letzte Synchronisierungszeit wird angezeigt

Installationsanleitung

Aptli wird direkt über Ihren Browser installiert – kein App-Store, kein Genehmigungsverfahren. Der genaue Pfad hängt von Ihrem Gerät ab.

Android (Chrome oder Edge)

Primärer Pfad – Schaltfläche in der App:

1. Öffne Aptli in Chrome oder Edge.
2. Melde dich an → du gelangst auf die mobile Startseite.
3. Tippe in der Seitenleiste auf Zum Startbildschirm hinzufügen (Download-Symbol).
4. Der native Installationsdialog von Chrome erscheint – tippe auf Installieren.
5. Das Aptli-Symbol erscheint auf deinem Startbildschirm.

Alternativer Weg – Browser-Menü:

1. Tippen Sie auf das Drei-Punkte-Menü des Browsers.
2. Tippen Sie auf App installieren oder Zum Startbildschirm hinzufügen.
3. Bestätigen Sie – das Aptli-Symbol erscheint auf Ihrem Startbildschirm.

Chrome hat das automatisch erscheinende Installationsbanner in Chrome 76 (2019) entfernt. Auf modernen Android-Geräten beginnt die Installation immer mit einem Tippen – entweder auf die Schaltfläche Zum Startbildschirm hinzufügen in der App oder auf das Browser-Menü. Beides funktioniert; die Schaltfläche in der App ist schneller, sobald Sie angemeldet sind.

iOS (Safari)

Auf iOS ist die Installation von PWAs nur über Safari möglich – Chrome und Firefox auf iOS sind WebKit-Shells ohne Installations-UI. iOS zeigt zudem niemals eine automatische Installationsaufforderung an; Sie starten den Vorgang über das Menü „Teilen“.

1. Öffne Aptli in Safari.
2. Tippe auf die Schaltfläche Teilen (Kästchen mit Pfeil).
3. Scrolle nach unten und tippe auf Zum Startbildschirm hinzufügen.
4. Tippe auf Hinzufügen.
5. Das Aptli-Symbol erscheint auf deinem Startbildschirm.

Desktop (Chrome, Edge oder anderer Chromium-Browser)

1. Öffne Aptli im Browser.
2. Suche nach dem Installationssymbol (⊕ oder ein kleines Monitor-/Computersymbol) auf der rechten Seite der Adressleiste.
3. Klicke darauf – der Installationsdialog des Browsers erscheint.
4. Klicke auf Installieren.
5. Aptli öffnet sich in einem eigenen Fenster ohne Browser-Leisten. Es erscheint auch in deinem App-Launcher des Betriebssystems (Startmenü, Ordner „Programme“ usw.).

Falls das Installationssymbol nicht sichtbar ist:

• Chrome: Drei-Punkte-Menü → Aptli installieren.
• Edge: Drei-Punkte-Menü → Apps → Diese Website als App installieren.

Firefox und andere Browser

Die PWA-Installation wird am besten in Chromium-basierten Browsern (Chrome, Edge, Opera, Brave) und Safari unter iOS unterstützt. Firefox unterstützt die Installation auf Android, jedoch nicht auf dem Desktop.

Updates

Die PWA wird automatisch aktualisiert:

• Keine Updates über den App-Store erforderlich
• Neue Versionen werden im Hintergrund heruntergeladen
• Aufforderung zum Aktualisieren, sobald ein Update verfügbar ist
• Sofortige Bereitstellung von Fehlerbehebungen/Funktionen

Sicherheitshinweise

Speicherung auf dem Gerät:

• Sitzungsdaten werden auf dem Gerät gesichert
• Es werden keine sensiblen Daten im Klartext gespeichert
• Alle lokalen Daten werden beim Abmelden gelöscht

GPS-Datenschutz:

• Zugriff auf den Standort nur bei Bedarf (Berichte, QR-Abholungen)
• Explizite Einwilligung erforderlich
• Ablehnung möglich (manuelle Standorteingabe unterstützt)
• GPS-Daten werden während der Übertragung verschlüsselt (HTTPS)

Fotodatenschutz:

• Fotos werden bis zum Hochladen lokal gespeichert
• Nach erfolgreichem Hochladen gelöscht
• Serverspeicher verschlüsselt
• Zugriff durch Berechtigungen kontrolliert

Best Practices

Installieren Sie die PWA:

• Schneller als der mobile Browser
• Funktioniert offline
• Bessere Benutzererfahrung

Aktivieren Sie Benachrichtigungen:

• Erhalten Sie Aktualisierungen zu Aufträgen
• Antworten auf Hilfeanfragen
• Ablauf von Abholcodes

Synchronisieren Sie regelmäßig:

• Öffnen Sie die App täglich (auch offline)
• Vorgänge in der Warteschlange werden automatisch verarbeitet
• Verhindert große Rückstände

Kamera nutzen:

• Fotos belegen die Erledigung der Arbeit
• Qualitätsprobleme dokumentieren
• Schneller als Beschreibungen einzutippen

Bericht vom Einsatzort:

• Noch vor Ort einreichen
• Frische Erinnerung = genaue Details
• Automatische GPS-Erfassung (Standort nicht vergessen)

Kartenkacheln zwischenspeichern:

• Karte im Einsatzgebiet öffnen, solange man online ist
• Kacheln werden 30 Tage lang zwischengespeichert
• Karte offline nutzbar