drk-blutspende-orte/docs

DRK Blutspende – Arbeitsorte: Dokumentation

Developer/maintainer documentation for the Arbeitsorte-Logger, a small desktop app that records blood-drive work assignments (date + city + postal code) and plots them on an interactive map.

Context: built as a personal tool for a single user, running locally on a Linux Mint laptop. Ease of use for a non-technical user is the primary design constraint. There is no server, no multi-user story, and no network dependency beyond geocoding and the map tiles.

Documents

File	Contents
overview.md	What the app does, feature by feature
architecture.md	Code structure, threading model, data flow
data-model.md	The orte.csv schema and how it is read/written
setup.md	Install & run on a fresh Linux Mint machine, plus a desktop launcher
improvements.md	Prioritized review findings and suggested changes
changelog.md	What has changed, newest first
dev-notes.md	Assumptions that turned out wrong — read before editing

At a glance

• Language / stack: Python 3, Tkinter via ttkbootstrap
• Single file: app.py (~760 lines)
• Storage: one CSV file, data/orte.csv
• Map: generated on demand as data/karte.html with Folium (Leaflet), opened in the default browser
• Geocoding: OpenStreetMap Nominatim via geopy, rate-limited to 1 request/second on a background thread
• UI language: German; DRK-red header, enlarged font, colour-coded status bar, window position remembered
• Persistence: atomic CSV writes + rotating backups in data/backups/; log at data/app.log
• Tests: non-GUI smoke checks only (not yet a committed tests/ suite)
• Version control: git initialized 2026-09-07