einsatzprotokoll/README.md
EiSiMo 9cd78ec25f Add README with logo and project documentation
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 19:53:21 +02:00

74 lines
3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<p align="center">
<img src="images/logo_round.png" alt="Einsatzprotokoll Logo" width="150">
</p>
<h1 align="center">Einsatzprotokoll</h1>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Garmin_Connect_IQ-blue.svg" alt="Platform">
<img src="https://img.shields.io/badge/Language-Monkey_C-orange.svg" alt="Language">
<img src="https://img.shields.io/github/last-commit/EiSiMo/Einsatzprotokoll.svg" alt="Last Commit">
<img src="https://img.shields.io/badge/Status-Alpha-orange" alt="Status">
</p>
Eine **Garmin Connect IQ App** für Polizisten, die es ermöglicht, Uhrzeiten und Standorte von Ereignissen direkt über die Smartwatch zu protokollieren.
## Das Problem
Im Einsatz müssen Polizisten häufig Uhrzeiten und Standorte dokumentieren — Eintreffen am Einsatzort, Festnahmen, Zwangsanwendungen. Dafür muss man den Notizblock zücken und die Adresse ermitteln. Das kostet Zeit und Nerven in stressigen Situationen.
**Einsatzprotokoll** löst das: Ein Knopfdruck auf der Garmin-Smartwatch erfasst Uhrzeit, GPS-Koordinaten und die nächste Adresse — automatisch und in Sekunden.
## Features
- **10-Icon Menüring** — Schnellzugriff auf Ereignistypen mit animierter Rotation
- **GPS-Erfassung** — Automatische Standortbestimmung mit 30s Best-Fix
- **Reverse Geocoding** — Straße und Hausnummer via Photon API
- **Verlauf** — Alle Einträge durchblättern mit Adresse, PLZ, Koordinaten
- **Glance Widget** — Letztes Ereignis direkt auf dem Watchface sichtbar
- **Löschen** — Countdown-Bestätigung zum Schutz vor Fehlbedienung
- **Reine Knopfbedienung** — Funktioniert auch mit Handschuhen
- **Datenschutz** — Alle Daten bleiben lokal auf der Uhr, keine Cloud-Sync
## Ereignistypen
| Icon | Typ | Beschreibung |
|:----:|-----|-------------|
| ▶️ | Einsatzbeginn | Start eines Einsatzes |
| ✅ | Einsatzende | Ende eines Einsatzes |
| 📍 | Eintreffen | Ankunft am Einsatzort |
| 🔗 | Festnahme | Festnahme einer Person |
| ✊ | Zwanganwendung | Einsatz von Zwangsmitteln |
| 🔍 | Beweismittel | Sicherung von Beweismitteln |
| 👁️ | Sichtung | Sichtung einer Person/Sache |
| | Allgemeines Ereignis | Frei verwendbar |
## Unterstützte Geräte
Aktuell getestet auf:
- Garmin Forerunner 265
- Garmin Fenix 7
## Entwicklung
### Voraussetzungen
- [Garmin Connect IQ SDK 9.1.0](https://developer.garmin.com/connect-iq/sdk/)
- Java (OpenJDK 25)
- Developer Key (`~/.Garmin/developer_keys/developer_key.der`)
### Bauen
```bash
monkeyc -d fr265 -f monkey.jungle -o build/Einsatzprotokoll.prg -y ~/.Garmin/developer_keys/developer_key.der
```
### Auf Uhr installieren (USB/MTP)
```bash
gio mount "mtp://[usb:BUS,DEVICE]/"
gio copy build/Einsatzprotokoll.prg "mtp://[usb:BUS,DEVICE]/Internal Storage/GARMIN/Apps/Einsatzprotokoll.prg"
```
## Hinweis
Diese App ist ein privates Projekt und steht in keiner Verbindung zu einer Polizeibehörde. Die Nutzung im Dienst obliegt der eigenen Verantwortung unter Beachtung der jeweiligen Dienstvorschriften.