Add README with logo and project documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
EiSiMo 2026-04-13 19:53:21 +02:00
parent 46307e7cb0
commit 9cd78ec25f
2 changed files with 74 additions and 0 deletions

74
README.md Normal file
View file

@ -0,0 +1,74 @@
<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.

BIN
images/logo_round.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB