Reworked pause and stop buttons and documentation

README.md

@@ -68,44 +68,9 @@ public/vendor/jquery-ui/images/*.png
 
 Die Anwendung verwendet aus jQuery UI insbesondere die Widgets **Button** und **Controlgroup**. Das offizielle vollständige jQuery-UI-Bundle bleibt lokal verfügbar, damit weitere aktuelle Widgets ohne erneuten CDN-Bezug ergänzt werden können. Die frühere jQuery-Mobile-Seitensteuerung wurde durch eine eigene, History-API-basierte Navigation ersetzt.
 
-## REST-API
+## API-Dokumentation
 
-| Methode | Pfad | Zweck |
-|---|---|---|
-| GET | `/api/health` | Server- und SQLite-Selbsttest |
-| GET | `/api/routes?lat=…&lon=…&radiusKm=25` | aktive, optional nahe Routen |
-| GET | `/api/routes/:id` | Route, Trackpunkte, POIs und Medien-URLs |
-| GET | `/api/routes/:id/pois` | POIs einer Route |
-| GET | `/api/pois/:id` | einzelner POI samt Bild- und Audio-URLs |
-| POST | `/api/routes` | neue Route; `multipart/form-data`, Feld `gpx` |
-| PUT | `/api/routes/:id` | Metadaten und optional GPX vollständig ersetzen |
-| POST | `/api/routes/:id/append` | zusätzliche GPX-Trackpunkte anhängen |
-| POST | `/api/routes/:id/pois` | POI anlegen; Felder `audio` und `images` |
-| PUT | `/api/pois/:id` | POI ändern und weitere Medien ergänzen |
-| DELETE | `/api/routes/:id` | Route samt Medien in den Papierkorb verschieben |
-| POST | `/api/routes/:id/restore` | Route aus dem Papierkorb wiederherstellen |
-
-### Route anlegen
-
-```bash
-curl -X POST http://127.0.0.1:47145/api/routes \
-  -F 'name=Schulwald-Runde' \
-  -F 'schoolName=Beispielschule' \
-  -F 'description=Naturkundlicher Rundweg' \
-  -F 'gpx=@examples/sample-route.gpx;type=application/gpx+xml'
-```
-
-### POI mit Bildern und Audio anlegen
-
-```bash
-curl -X POST http://127.0.0.1:47145/api/routes/1/pois \
-  -F 'title=Die alte Eiche' \
-  -F 'description=Hier wird das Alter der Eiche erklärt.' \
-  -F 'lat=52.5208' -F 'lon=13.4070' -F 'triggerRadiusM=60' \
-  -F 'audio=@ansage.mp3;type=audio/mpeg' \
-  -F 'images=@eiche-1.jpg;type=image/jpeg' \
-  -F 'images=@eiche-2.jpg;type=image/jpeg'
-```
+Die vollständige REST-API ist einschließlich aller Pfad-, Query-, Formular- und Datei-Parameter sowie ausführlicher `curl`-Beispiele in [`docs/REST-API.md`](docs/REST-API.md) dokumentiert. Die README beschreibt bewusst nur Installation, Architektur und Bedienverhalten.
 
 ## Dateistruktur
 
@@ -171,8 +136,10 @@ Beim Start der Route wird der aktuellen Position nächstgelegene GPX-Trackpunkt
 Die Routenansicht besitzt drei nebeneinanderliegende, semantische Schaltflächen mit lokalen SVG-Symbolen:
 
 - **Route starten beziehungsweise fortsetzen:** aktiviert `navigator.geolocation.watchPosition()` und die Geräteausrichtung.
-- **Route pausieren:** beendet den aktiven GPS-Watcher und den Kompass-Listener, behält aber Routenfortschritt und bereits ausgelöste POIs bei.
-- **Route beenden:** beendet alle Sensor-Listener, setzt den Fortschritt zurück und leert die Liste bereits ausgelöster POIs.
+- **Route pausieren:** beendet den aktiven GPS-Watcher und den Kompass-Listener, pausiert eine laufende Audioansage und behält Routenfortschritt, Audioquelle, Abspielposition und bereits ausgelöste POIs bei.
+- **Route beenden:** beendet alle Sensor-Listener, hält die Audioansage an, entlädt ihre Quelldatei, setzt den Fortschritt zurück und kehrt zur Routenauswahl zurück.
+
+Die aktuell geöffnete beziehungsweise automatisch ausgelöste Station wird in der Stationsliste sichtbar hervorgehoben und mit `aria-current="step"` semantisch gekennzeichnet.
 
 Während die Route läuft, werden Positionsänderungen fortlaufend verarbeitet. Eine Browser-Webanwendung ist jedoch kein nativer Hintergrunddienst: Betriebssystem und Browser können die Aktualisierung bei gesperrtem Bildschirm, Energiesparmodus oder im Hintergrund drosseln beziehungsweise anhalten.