docs: vollständige Bot-Beschreibung und 0.8.x Release-Notes hinzugefügt

- docs/bot-beschreibung.md: umfassende Dokumentation mit Architektur, Komponenten, API-Referenz, Konfiguration, Datenbank-Schema, Deployment und chronologischer Erweiterungshistorie (v0.1.0–v0.8.9) - docs/whats-new-0.8.md: Neuigkeiten der 0.8.x-Release-Serie (NINA, Paket-Log, Karte, Bugfixes, API-Endpunkte, Versionshistorie) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 17:53:39 +01:00 · 2026-02-19 17:53:39 +01:00 · 79f80563c8
parent f36a126200
commit 79f80563c8
2 changed files with 802 additions and 0 deletions
--- a/docs/bot-beschreibung.md
+++ b/docs/bot-beschreibung.md
@ -0,0 +1,597 @@
+# MeshDD-Bot — Vollständige Beschreibung
+
+> Aktueller Stand: **v0.8.9** · Letztes Update: 2026-02-19
+
+---
+
+## Inhaltsverzeichnis
+
+1. [Überblick](#überblick)
+2. [Architektur](#architektur)
+3. [Komponenten im Detail](#komponenten-im-detail)
+4. [Bot-Kommandos](#bot-kommandos)
+5. [Weboberfläche & Seiten](#weboberfläche--seiten)
+6. [REST-API-Referenz](#rest-api-referenz)
+7. [Zugriffsrechte](#zugriffsrechte)
+8. [Konfiguration](#konfiguration)
+9. [Datenbank](#datenbank)
+10. [Deployment](#deployment)
+11. [Wichtige Erweiterungsschritte](#wichtige-erweiterungsschritte)
+
+---
+
+## Überblick
+
+**MeshDD-Bot** ist ein Python-basierter Bot für **Meshtastic**-Funknetze mit integriertem Web-Dashboard. Er verbindet sich per TCP mit einem lokalen Meshtastic-Node, empfängt und speichert alle Pakete im Netz, beantwortet Bot-Kommandos und stellt eine browserbasierte Oberfläche für Echtzeit-Monitoring, Verwaltung und Notfall-Warnsystem-Integration bereit.
+
+**Hauptmerkmale:**
+
+- Meshtastic TCP-Verbindung mit automatischem Reconnect
+- Bot-Kommandos (Ping, Wetter, Node-Info, Mesh-Statistiken u.a.)
+- Echtzeit-Web-Dashboard via WebSocket
+- Interaktive Leaflet-Karte aller Nodes
+- Zeitgesteuerter Scheduler (Cron-Ausdrücke)
+- NINA BBK Warnmeldungs-Integration (warnung.bund.de)
+- Benutzerverwaltung mit Rollen (public / user / admin)
+- Hot-Reload für alle Konfigurationsdateien
+- Paket-Log mit Typ-Filterung
+- Docker-ready mit docker-compose
+
+---
+
+## Architektur
+
+```
+┌─────────────────────────────────────────────────────┐
+│                    main.py                          │
+│  asyncio event loop + threading für Meshtastic      │
+│                                                     │
+│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │
+│  │ MeshBot  │  │Scheduler │  │    NinaBot       │  │
+│  │ bot.py   │  │scheduler │  │    nina.py       │  │
+│  └────┬─────┘  │   .py    │  └────────┬─────────┘  │
+│       │        └────┬─────┘           │             │
+│  ┌────▼─────────────▼─────────────────▼──────────┐  │
+│  │              WebSocketManager                 │  │
+│  │          webserver.py (aiohttp)               │  │
+│  └───────────────────┬───────────────────────────┘  │
+│                      │                              │
+│  ┌───────────────────▼───────────────────────────┐  │
+│  │             Database (aiosqlite)              │  │
+│  │               database.py                    │  │
+│  └───────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────┘
+         │ TCP                     │ HTTP
+         ▼                         ▼
+  Meshtastic-Node           Browser-Client
+  (192.168.11.4:4403)       (Bootstrap 5.3 / Tabler)
+```
+
+### Technologie-Stack
+
+| Schicht | Technologie |
+|---|---|
+| Sprache | Python 3.12 |
+| Async-Framework | asyncio + aiohttp |
+| Meshtastic | meshtastic-python (TCPInterface) |
+| Event-Bus | PyPubSub |
+| Datenbank | SQLite via aiosqlite |
+| Web-Server | aiohttp + WebSocket |
+| Auth | bcrypt, aiohttp-session, EncryptedCookieStorage |
+| Frontend | Bootstrap 5.3, Tabler 1.4.0, Bootstrap Icons |
+| Karte | Leaflet.js |
+| Charts | Chart.js |
+| NINA-API | aiohttp (async HTTP-Polling) |
+| Konfiguration | YAML (config.yaml, scheduler.yaml, nina.yaml) |
+| Deployment | systemd Service / Docker + docker-compose |
+
+---
+
+## Komponenten im Detail
+
+### `main.py` — Einstiegspunkt
+
+Startet alle Subsysteme in der richtigen Reihenfolge:
+
+1. SQLite-Datenbank verbinden
+2. `WebSocketManager` erzeugen
+3. `MeshBot` (mit Loop-Referenz)
+4. `Scheduler` (referenziert Bot + WS-Manager)
+5. `NinaBot` (referenziert Bot's `send_message` + WS-Manager)
+6. `WebServer` starten
+7. Meshtastic-Verbindung in separatem Thread starten
+8. Config-Watcher, Scheduler-Watcher, NINA-Watcher als asyncio-Tasks
+9. Auf SIGINT/SIGTERM warten → sauberer Shutdown
+
+### `meshbot/bot.py` — MeshBot
+
+Kernklasse für die Meshtastic-Integration:
+
+- **Verbindung:** `TCPInterface` über Host/Port aus `config.yaml`
+- **PubSub-Subscriptions** (registriert *vor* dem Konstruktor):
+  - `meshtastic.receive` → Paket empfangen
+  - `meshtastic.connection.established` → Verbindung hergestellt
+  - `meshtastic.connection.lost` → Verbindung verloren
+  - `meshtastic.node.updated` → Node-Update
+- **Race-Condition-Fix:** `threading.Event` wartet nach dem Konstruktor bis zu 10 s auf `connection.established`; Fallback-Initialisierung nur bei echtem Ausbleiben
+- **Paket-Handler:** Extrahiert portnum, from/to-IDs, SNR, RSSI, Hop-Infos; erstellt `payload_summary` je Pakettyp
+- **Nachrichtenversand:** `_send_text()` teilt lange Nachrichten automatisch mit `[x/y]`-Nummerierung (max. 170 Byte); 3 Sekunden Pause zwischen Teilen
+- **Node-Config:** `get_node_config()` liest LoRa, Device, Channels, Position, Power, Bluetooth, Network via Protobuf
+
+**Unterstützte Pakettypen mit Payload-Zusammenfassung:**
+
+| Portnum | Gespeicherte Felder |
+|---|---|
+| `TEXT_MESSAGE_APP` | Nachrichtentext |
+| `POSITION_APP` | lat, lon, alt, Geschwindigkeit, Satelliten |
+| `TELEMETRY_APP` | Akku, Spannung, CH-Util, TX-Util, Temp, Feuchte, Druck |
+| `NODEINFO_APP` | long_name, short_name, hw_model |
+| `ROUTING_APP` | Fehlercode |
+| `TRACEROUTE_APP` | Hop-Anzahl, Route |
+| `NEIGHBORINFO_APP` | Anzahl Nachbarn |
+
+### `meshbot/nina.py` — NinaBot
+
+Integration des **NINA Warn-App des BBK** (Bundesamt für Bevölkerungsschutz und Katastrophenhilfe):
+
+- **API-Basis:** `https://warnung.bund.de/api31`
+- **Duales Polling** pro Zyklus:
+  1. **Dashboard-Endpunkt** (`/dashboard/{AGS12}.json`) — regionale Filterung durch den BBK-Server; bevorzugt wenn AGS-Codes konfiguriert
+  2. **mapData-Endpunkt** (`/{quelle}/mapData.json`) — bundesweit, nur aktiv wenn **keine** AGS-Codes konfiguriert
+- **De-Duplikation:** ID-Normalisierung verhindert Doppelmeldungen (`dwdmap.` → `dwd.`, `mow.` → `mowas.` usw.)
+- **Schweregrade:** Minor / Moderate / Severe (Standard) / Extreme
+- **Quellen:** Katwarn, BIWAPP, MoWaS, DWD, LHP, Polizei (einzeln aktivierbar)
+- **Monitor-Modus:** `send_to_mesh=false` → Weboberfläche empfängt Warnungen, kein Funk-Versand
+- **Resend-Loop:** Aktive Warnungen werden in konfigurierbarem Abstand erneut gesendet
+- **Hot-Reload:** Konfigurationsänderungen in `nina.yaml` werden live übernommen
+- **AGS-Unterstützung:** Alle 13 sächsischen Landkreise / kreisfreie Städte mit lesbaren Namen
+
+**Mesh-Nachrichtenformat:**
+```
+[NINA] Schwerwiegend: Sturmböen (Dresden, Stadt)
+Beschreibung des Ereignisses (max. 120 Zeichen)...
+
+[NINA] Aufgehoben: Sturmböen (Dresden, Stadt)
+```
+
+### `meshbot/scheduler.py` — Scheduler
+
+Zeitgesteuerte Bot-Aktionen via Cron-Ausdrücke:
+
+- **Cron-Parser:** eigene Implementierung (keine externen Abhängigkeiten)
+  - Format: `Minute Stunde Tag Monat Wochentag`
+  - Unterstützt `*`, `*/N`, Einzelwerte und Kommalisten
+- **Job-Typen:** `command` (Bot-Kommando) oder `message` (freier Text)
+- **Template-Variablen** für Nachrichten-Jobs:
+  - `{time}`, `{date}`, `{datetime}`, `{weekday}`
+  - `{nodes}`, `{nodes_24h}` (live aus der DB)
+- **Hot-Reload:** Änderungen in `scheduler.yaml` werden alle 2 Sekunden erkannt
+- **CRUD-API:** Jobs können über die Weboberfläche angelegt, bearbeitet und gelöscht werden
+
+### `meshbot/webserver.py` — WebServer
+
+aiohttp-basierter HTTP- und WebSocket-Server:
+
+- **WebSocketManager:** trennt `clients` (alle) von `auth_clients` (authentifiziert)
+- **Initial-Payload bei WS-Verbindung:** Nodes, Stats, Channels, my_node_id, Bot-Status, letzte 200 Pakete, letzte 50 Nachrichten (nur auth)
+- **broadcast vs. broadcast_auth:** Nachrichten und Warnmeldungen nur an authentifizierte Clients
+
+### `meshbot/auth.py` — Authentifizierung
+
+Session-basierte Authentifizierung mit E-Mail-Verifikation:
+
+- **Passwort-Hashing:** bcrypt, 12 Runden, Mindestlänge 8 Zeichen
+- **Session-Storage:** `EncryptedCookieStorage` (Fernet, AES-128-CBC)
+- **Token-System:** UUID-Tokens für Verifikation und Passwort-Reset (24h gültig)
+- **E-Mail-Versand:** aiosmtplib (TLS Port 465), Fallback: Link ins Server-Log
+- **Rollen:** `public` (nicht eingeloggt), `user`, `admin`
+- **Admin kann:** Benutzer anlegen/bearbeiten/löschen, Rollen ändern, manuell verifizieren, Passwörter zurücksetzen, Info-Mails versenden
+
+### `meshbot/database.py` — Datenbank
+
+SQLite via aiosqlite mit WAL-Modus für bessere Nebenläufigkeit:
+
+| Tabelle | Inhalt |
+|---|---|
+| `nodes` | Alle bekannten Meshtastic-Nodes (ID, Name, HW, Position, Batterie, SNR, Hops) |
+| `messages` | Empfangene und gesendete Textnachrichten |
+| `commands` | Bot-Kommando-Protokoll pro Kanal |
+| `packets` | Alle empfangenen Pakete mit Typ und Payload |
+| `users` | Registrierte Web-Benutzer |
+| `tokens` | Verifikations- und Reset-Tokens |
+| `email_logs` | E-Mail-Versandprotokoll |
+
+Automatische DB-Migration bei Schema-Änderungen (z.B. `channel`-Spalte in `commands`).
+
+### `meshbot/config.py` — Konfiguration
+
+Live-Reload-fähige Konfiguration aus `config.yaml`:
+
+- Datei-Watcher prüft alle 5 Sekunden auf Änderungen
+- Umgebungsvariablen über `config.env()` (für Secrets wie AUTH_SECRET_KEY, SMTP)
+- Verschachtelte Keys per Punkt-Notation: `config.get("meshtastic.host")`
+
+---
+
+## Bot-Kommandos
+
+Alle Kommandos beginnen mit dem konfigurierten Präfix (Standard: `?`).
+
+| Kommando | Beschreibung |
+|---|---|
+| `?ping` | Antwortet mit „Pong" und Hop-Anzahl des Absenders |
+| `?nodes` | Anzahl bekannter Nodes im Netz |
+| `?info` | Bot-Name, Version und Uptime |
+| `?help` | Liste aller Kommandos |
+| `?stats` | Gesamt-Nodes, aktive Nodes (24h), Anfragen-Zähler |
+| `?uptime` | Laufzeit des Bots |
+| `?me` | Eigene Node-Infos (Name, HW, Hops, SNR, RSSI, Batterie, Position) |
+| `?weather` | Aktuelles Wetter am eigenen Standort (open-meteo.com) |
+| `?weather plz:XXXXX` | Wetter für deutsche Postleitzahl |
+| `?mesh` | Mesh-Netzwerk-Übersicht (Online-Nodes, Hop-Verteilung, Top-Hardware) |
+
+Lange Antworten werden automatisch gesplittet (`[1/3] ... [2/3] ... [3/3]`).
+
+---
+
+## Weboberfläche & Seiten
+
+Alle Seiten verwenden ein einheitliches Layout: Tabler 1.4.0 (Bootstrap 5.3), fixed Top-Navbar (46px), Sidebar (200px), Content-Wrapper. Theme-Toggle (Hell/Dunkel) auf allen Seiten. Sidebar-Einträge für Admin-Bereiche werden per JS ausgeblendet wenn nicht admin.
+
+### `/` — Dashboard (public: Nodes/Stats, user: Nachrichten/Senden)
+
+- **Info-Boxen:** Nodes gesamt, aktiv (24h), Anfragen (24h), Bot-Uptime
+- **Nodes-Tabelle:** Name, ID, HW, Hops, SNR, RSSI, Batterie, Zuletzt gesehen; Suchfeld, Online-Filter, sortierbar
+- **Node-Detail-Modal:** Klick auf Node-Zeile öffnet Modal mit allen Feldern + Leaflet-Minikarte
+- **Kanalfilter** in der Nachrichtenliste
+- **Sende-Card** (user): Kanal-Dropdown + Textfeld → `POST /api/send`
+- **Charts** (3 + 1):
+  - Kanal-Anfragen (Doughnut)
+  - Hop-Verteilung (Bar)
+  - Hardware Top-5 (Bar)
+  - Pakettypen 24h (Doughnut)
+
+### `/map` — Karte (public)
+
+- Leaflet.js mit Node-Markierungen
+- **Farb-Codierung nach Hop-Anzahl:** Direkt=Grün, 1 Hop=Blau, 2 Hops=Orange, ≥3 Hops=Rot, via MQTT=Lila
+- **Transparenz nach Alter:** <24h=90%, 24–48h=45%, 48–72h=20%, >72h=ausgeblendet
+- **Kartenlegende** (topleft): Theme-aware, kompaktes Design mit HOPS- und ALTER-Sektionen
+- **Dark/Light Tiles:** CartoDB Dark Matter / OpenStreetMap, wechselt live mit Theme
+- **Tooltip** mit Node-Name, HW, Hops, Batterie, SNR beim Hover
+
+### `/packets` — Paket-Log (public)
+
+- Echtzeit-Tabelle aller empfangenen Pakete (max. 300 Einträge im Browser)
+- Spalten: Zeit, Von, An, Typ, Kanal, SNR, RSSI, Hops, Info
+- **Typ-Filterleiste** (farbige Pills, aktiv/inaktiv)
+- **Pause- und Löschen-Funktion**
+- Eigene Telemetrie-Pakete werden unterdrückt (`my_node_id` oder FTLW-Fallback)
+- Informativer Info-Payload je Pakettyp
+
+### `/scheduler` — Scheduler (admin)
+
+- Jobs-Tabelle: Name, Cron-Ausdruck, Typ, Kommando/Nachricht, Kanal, Aktiv
+- CRUD-Modals für Anlegen/Bearbeiten/Löschen
+- Variablen-Badges (`{time}`, `{date}`, ...) klickbar im Nachrichten-Modus
+
+### `/nina` — NINA-Warnmeldungen (admin)
+
+- **Konfigurationskarte** mit allen NINA-Einstellungen (aktiviert, Send-to-Mesh, Intervalle, Kanal, Schweregrad, AGS-Codes, Quellen)
+- **AGS-Code-Tabelle** mit Ortsname und Lösch-Button; Combobox mit allen sächsischen AGS-Codes
+- **Status-Badge** (Aktiv/Deaktiviert, Regions-Anzahl, Mesh+Web/Nur Web)
+- **Warnmeldungs-Tabelle:** Schweregrad-Badge, Headline, Gebiet, Typ, Mesh-Icon, Zeitstempel
+- Aktive Warnungen werden beim Seitenaufruf sofort geladen (`GET /api/nina/alerts`)
+- Neue Warnungen erscheinen live via WebSocket
+
+### `/settings` — Node-Einstellungen (admin)
+
+- Liest aktuelle Konfiguration vom lokalen Meshtastic-Node
+- Zeigt: Gerät (Name, Firmware, HW-Modell, Node-Num), LoRa (Region, Preset, Hops, TX-Power), Kanäle, Position, Power, Bluetooth, Netzwerk
+
+### `/admin` — Benutzerverwaltung (admin)
+
+- Benutzertabelle mit Rolle, Verifikationsstatus, Erstellt-Datum
+- Aktionen: Anlegen, Bearbeiten, Rolle ändern, Passwort zurücksetzen, verifizieren, löschen, Info-Mail senden
+- Passwort-Generator in der UI
+
+### `/login` + `/register` — Authentifizierung (public)
+
+- Login / Registrierung / Passwort vergessen auf einer Seite
+- E-Mail-Verifikationsflow: Token → Passwort setzen → Login
+- Passwort-Reset-Flow analog
+
+---
+
+## REST-API-Referenz
+
+### Öffentliche Endpunkte
+
+| Methode | Pfad | Beschreibung |
+|---|---|---|
+| `GET` | `/api/nodes` | Alle Nodes |
+| `GET` | `/api/stats` | Statistiken + Version + Uptime |
+| `GET` | `/api/packets` | Letzte Pakete (limit-Parameter) |
+| `GET` | `/ws` | WebSocket-Verbindung |
+
+### User-Endpunkte
+
+| Methode | Pfad | Beschreibung |
+|---|---|---|
+| `GET` | `/api/auth/me` | Eigene Benutzerdaten |
+| `GET` | `/api/messages` | Letzte Nachrichten |
+| `POST` | `/api/send` | Nachricht senden |
+
+### Admin-Endpunkte
+
+| Methode | Pfad | Beschreibung |
+|---|---|---|
+| `GET` | `/api/node/config` | Node-Konfiguration lesen |
+| `GET/POST` | `/api/scheduler/jobs` | Jobs lesen / anlegen |
+| `PUT/DELETE` | `/api/scheduler/jobs/{name}` | Job bearbeiten / löschen |
+| `GET` | `/api/nina/config` | NINA-Konfiguration lesen |
+| `PUT` | `/api/nina/config` | NINA-Konfiguration speichern + Poll auslösen |
+| `GET` | `/api/nina/alerts` | Aktuell aktive Warnmeldungen |
+| `GET/POST` | `/api/admin/users` | Alle Benutzer / Anlegen |
+| `PUT` | `/api/admin/users/{id}` | Benutzer bearbeiten |
+| `DELETE` | `/api/admin/users/{id}` | Benutzer löschen |
+| `POST` | `/api/admin/users/{id}/role` | Rolle ändern |
+| `POST` | `/api/admin/users/{id}/verify` | Manuell verifizieren |
+| `POST` | `/api/admin/users/{id}/reset-password` | Passwort zurücksetzen |
+| `POST` | `/api/admin/users/{id}/send-info` | Info-Mail senden |
+
+### Auth-Endpunkte
+
+| Methode | Pfad | Beschreibung |
+|---|---|---|
+| `POST` | `/auth/login` | Einloggen |
+| `POST` | `/auth/register` | Registrieren |
+| `GET` | `/auth/logout` | Ausloggen |
+| `GET` | `/auth/verify` | Verifikations-Link |
+| `POST` | `/auth/set-password` | Passwort nach Verifikation setzen |
+| `POST` | `/auth/forgot-password` | Passwort-Reset anfordern |
+| `GET/POST` | `/auth/reset-password` | Passwort zurücksetzen |
+
+### WebSocket-Events (Server → Client)
+
+| Event | Inhalt | Auth |
+|---|---|---|
+| `initial` | Alle Nodes | alle |
+| `stats_update` | Statistiken | alle |
+| `channels` | Kanäle | alle |
+| `my_node_id` | Eigene Node-ID | alle |
+| `bot_status` | connected + uptime | alle |
+| `initial_packets` | Letzte 200 Pakete | alle |
+| `node_update` | Node-Daten (ein Node) | alle |
+| `packet` | Neues Paket | alle |
+| `initial_messages` | Letzte 50 Nachrichten | auth |
+| `new_message` | Neue Nachricht | auth |
+| `scheduler_update` | Jobs-Liste | alle |
+| `nina_alert` | Neue Warnmeldung | alle |
+
+---
+
+## Zugriffsrechte
+
+| Bereich | Public | User | Admin |
+|---|---|---|---|
+| Dashboard (Nodes, Stats, Karte) | Ja | Ja | Ja |
+| Paket-Log | Ja | Ja | Ja |
+| Dashboard (Nachrichten, Senden) | Nein | Ja | Ja |
+| Scheduler | Nein | Nein | Ja |
+| NINA-Verwaltung | Nein | Nein | Ja |
+| Node-Einstellungen | Nein | Nein | Ja |
+| Benutzerverwaltung | Nein | Nein | Ja |
+
+---
+
+## Konfiguration
+
+### `config.yaml` — Hauptkonfiguration
+
+```yaml
+version: "0.8.9"
+
+bot:
+  name: "MeshDD-Bot"
+  command_prefix: "?"       # Präfix für Bot-Kommandos
+
+meshtastic:
+  host: "192.168.11.4"      # IP des Meshtastic-Nodes
+  port: 4403                # TCP-Port
+
+web:
+  host: "0.0.0.0"           # Web-Server-Bindung
+  port: 8081                # Web-Server-Port
+
+database:
+  path: "meshdd.db"         # Pfad zur SQLite-DB
+
+auth:
+  session_max_age: 86400    # Session-Gültigkeit in Sekunden
+```
+
+### `.env` — Secrets (Umgebungsvariablen)
+
+```
+AUTH_SECRET_KEY=change-this-secret-key-32bytes!!
+SMTP_HOST=ssl0.example.com
+SMTP_PORT=465
+SMTP_USER=bot@example.com
+SMTP_PASSWORD=secret
+SMTP_FROM=MeshDD-Bot <bot@example.com>
+SMTP_APP_URL=http://192.168.11.x:8081
+```
+
+Ohne `SMTP_HOST` werden Verifikationslinks ins Server-Log ausgegeben (kein E-Mail-Versand).
+
+### `scheduler.yaml` — Scheduler-Jobs
+
+```yaml
+jobs:
+  - name: "tagesinfo"
+    enabled: true
+    cron: "0 8 * * *"        # täglich 08:00
+    type: "message"
+    command: "Guten Morgen! Heute {weekday}, {date}. Aktive Nodes: {nodes_24h}"
+    channel: 0
+  - name: "morgen-ping"
+    enabled: false
+    cron: "0 7 * * 1-5"      # Mo–Fr 07:00
+    type: "command"
+    command: "?ping"
+    channel: 0
+```
+
+**Cron-Felder:** `Minute(0-59) Stunde(0-23) Tag(1-31) Monat(1-12) Wochentag(0-6, 0=Sonntag)`
+
+**Template-Variablen:** `{time}` `{date}` `{datetime}` `{weekday}` `{nodes}` `{nodes_24h}`
+
+### `nina.yaml` — NINA-Konfiguration
+
+```yaml
+enabled: false
+send_to_mesh: true
+poll_interval: 300         # Abfrageintervall in Sekunden (min. 60)
+resend_interval: 3600      # Wiederholungsintervall aktiver Warnungen
+channel: 0                 # Meshtastic-Kanal 0–7
+min_severity: Severe       # Minor | Moderate | Severe | Extreme
+ags_codes:
+  - "146120000000"         # Dresden, Stadt
+  - "146270000000"         # Meißen
+  - "146280000000"         # Sächsische Schweiz-Osterzgebirge
+  - "146250000000"         # Bautzen
+  - "146260000000"         # Görlitz
+sources:
+  katwarn: true
+  biwapp: true
+  mowas: true
+  dwd: true
+  lhp: true
+  police: false
+```
+
+---
+
+## Datenbank
+
+SQLite-Datei `meshdd.db` (konfigurierbar). WAL-Modus für bessere Nebenläufigkeit.
+
+### Tabelle `nodes`
+
+```sql
+node_id TEXT PRIMARY KEY,   -- z.B. "!1a2b3c4d"
+node_num INTEGER,           -- Dezimalzahl
+long_name TEXT,             -- Langer Name
+short_name TEXT,            -- Kurzname (4 Zeichen)
+hw_model TEXT,              -- Hardware-Modell
+lat REAL, lon REAL,         -- Position
+alt REAL,                   -- Höhe in Metern
+battery INTEGER,            -- Akkustand 0–100%
+voltage REAL,               -- Spannung in Volt
+snr REAL,                   -- Signal-Rausch-Abstand
+rssi INTEGER,               -- Empfangsstärke in dBm
+last_seen REAL,             -- Unix-Timestamp
+first_seen REAL,            -- Unix-Timestamp
+hop_count INTEGER,          -- Hops vom Bot
+via_mqtt INTEGER            -- 0 oder 1
+```
+
+### Tabelle `packets`
+
+```sql
+id INTEGER PRIMARY KEY AUTOINCREMENT,
+timestamp REAL,
+from_id TEXT, to_id TEXT,
+portnum TEXT,               -- z.B. "TEXT_MESSAGE_APP"
+channel INTEGER,
+snr REAL, rssi INTEGER,
+hop_limit INTEGER, hop_start INTEGER,
+packet_id INTEGER,
+payload TEXT                -- JSON-Zusammenfassung je Typ
+```
+
+---
+
+## Deployment
+
+### Systemd-Service
+
+```bash
+# Service-Datei installieren
+sudo cp meshdd-bot.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable meshdd-bot
+sudo systemctl start meshdd-bot
+
+# Logs live verfolgen
+journalctl -u meshdd-bot -f
+```
+
+### Docker / docker-compose
+
+```bash
+# Bauen und starten
+docker compose up -d
+
+# Logs
+docker compose logs -f
+
+# Stoppen
+docker compose down
+```
+
+`docker-compose.yml` verwendet Host-Netzwerk (direkter TCP-Zugriff auf Meshtastic-Node), Named Volume für SQLite, JSON-File-Logging (10 MB / 3 Dateien) und Health-Check (`/api/stats` alle 30s).
+
+### Direkt (Entwicklung)
+
+```bash
+cd /home/peter/MeshDD-Bot
+source venv/bin/activate
+python main.py
+```
+
+---
+
+## Wichtige Erweiterungsschritte
+
+Die folgende Tabelle zeigt die wichtigsten Entwicklungsmeilensteine von der ersten Version bis heute:
+
+| Version | Datum | Erweiterungsschritt |
+|---|---|---|
+| **0.1.0** | 2026-02-15 | **Grundgerüst:** Meshtastic TCP-Bot, SQLite-DB, Web-Dashboard mit WebSocket, Leaflet-Karte, Bot-Kommandos (ping, nodes, info, help, weather, stats, uptime) |
+| **0.2.0** | 2026-02-15 | **Konfiguration & Karte:** Zentrale `config.yaml` mit Live-Reload, Hop-Farbcodierung auf der Karte, Theme-Toggle (Hell/Dunkel), Kanalnamen in Nachrichten |
+| **0.2.5** | 2026-02-15 | **Nachrichten-Splitting:** Automatisches Aufteilen langer Nachrichten mit `[x/y]`-Nummerierung und Pause |
+| **0.3.1** | 2026-02-15 | **Scheduler:** Zeitgesteuerte Bot-Kommandos via Cron-Ausdrücke, `scheduler.yaml` mit File-Watcher, REST-CRUD-API, Live-Updates via WebSocket |
+| **0.3.2** | 2026-02-15 | **Nachrichten senden:** Direktes Senden aus dem Dashboard (`POST /api/send`); Scheduler-Typ „Nachricht" |
+| **0.3.5** | 2026-02-15 | **AdminLTE-Layout:** Einheitliches Sidebar-Layout für alle Seiten mit Active-State |
+| **0.3.6** | 2026-02-15 | **Node-Einstellungen:** `/settings`-Seite liest Gerät, LoRa, Kanäle, Position, Power, Bluetooth via Protobuf vom Node |
+| **0.4.0** | 2026-02-16 | **UX-Verbesserungen:** `?me`-Kommando, Ping mit Hop-Anzahl, PLZ-Support fürs Wetter, Luftdruck & Taupunkt, gesendete Nachrichten im Dashboard |
+| **0.5.0** | 2026-02-16 | **Benutzerverwaltung:** Session-Auth mit bcrypt, E-Mail-Verifikation, Rollen (public/user/admin), Admin-Panel, Passwort-Reset |
+| **0.5.3** | 2026-02-16 | **Secrets in .env:** AUTH_SECRET_KEY und SMTP-Einstellungen aus config.yaml in Umgebungsvariablen ausgelagert |
+| **0.5.4** | 2026-02-16 | **Admin erweitert:** Benutzer direkt anlegen mit Passwort, Bearbeiten-Modal, Passwort-Reset, Passwort-Generator |
+| **0.6.0** | 2026-02-17 | **Node-Detail-Modal:** Klick auf Node → Modal mit allen Feldern + Leaflet-Minikarte |
+| **0.6.1** | 2026-02-17 | **Docker-Support:** Dockerfile, docker-compose.yml, .dockerignore |
+| **0.6.2** | 2026-02-17 | **Geteiltes app.js:** ~360 Zeilen duplizierten Frontend-Code in gemeinsames Modul extrahiert |
+| **0.6.3** | 2026-02-17 | **WebSocket-Sicherheit:** `auth_clients` vs. `clients` — Nachrichten nur an authentifizierte WS-Clients |
+| **0.6.5** | 2026-02-17 | **Dark-Mode-Karte + Charts:** CartoDB Dark Matter, 3 Charts (Kanal, Hops, Hardware) |
+| **0.6.7** | 2026-02-17 | **Tabler 1.4.0:** Professionelleres CSS-Framework, überarbeitetes style.css |
+| **0.6.10** | 2026-02-18 | **Paket-Log:** Neue `/packets`-Seite, `packets`-Tabelle in DB, Typ-Filter, Echtzeit via WebSocket |
+| **0.6.13** | 2026-02-18 | **Karten-Alter-Transparenz:** Nodes >72h werden ausgeblendet; Legende mit Alter-Sektion |
+| **0.6.14** | 2026-02-18 | **Pakettypen-Chart:** Viertes Doughnut-Chart mit Pakettyp-Verteilung 24h |
+| **0.6.15** | 2026-02-18 | **Scheduler Template-Variablen:** `{time}`, `{date}`, `{weekday}`, `{nodes}` etc.; Footer auf allen Seiten |
+| **0.7.0** | 2026-02-18 | **Docker-Verbesserungen:** HEALTHCHECK, Logging-Config, korrigierter Port |
+| **0.8.0** | 2026-02-19 | **NINA-Integration:** BBK Warn-App angebunden; duales Polling (Dashboard + mapData); Konfigurationsseite; Monitor-Modus; Live-Tabelle via WebSocket |
+| **0.8.1** | 2026-02-19 | **NINA Resend-Loop:** Aktive Warnungen werden zyklisch wiederholt; AGS-Code-Tabelle statt Badges |
+| **0.8.2** | 2026-02-19 | **NINA geografische Filterung:** mapData nur noch ohne AGS-Codes aktiv (verhindert bundesweite Meldungen) |
+| **0.8.3** | 2026-02-19 | **NINA Gebietsanzeige:** Regionsname aus AGS-Labels in Meldung und Mesh-Text; Sachsen-Combobox |
+| **0.8.4** | 2026-02-19 | **NINA Sofortabfrage:** Nach Speichern der Config sofort pollen; `last_poll`-Zeitstempel anzeigen |
+| **0.8.5** | 2026-02-19 | **Kartenlegende Position:** von bottomright nach topleft verschoben |
+| **0.8.6** | 2026-02-19 | **Paket-Log informativer:** Erweiterte Payload-Zusammenfassung; eigene Telemetrie unterdrückt |
+| **0.8.7** | 2026-02-19 | **Race-Condition-Fix:** `threading.Event` verhindert falsche Startup-Warning „connection.established missed" |
+| **0.8.8** | 2026-02-19 | **Kartenlegende neu gestaltet:** Theme-aware CSS-Variablen, kompaktes Design |
+| **0.8.9** | 2026-02-19 | **NINA aktive Warnungen:** `GET /api/nina/alerts` gibt beim Seitenaufruf alle aktiven Warnungen zurück |
+
+---
+
+*MeshDD-Bot — entwickelt für das Dresdner Meshtastic-Netz · © MeshDD / PPfeiffer*
--- a/docs/whats-new-0.8.md
+++ b/docs/whats-new-0.8.md
@ -0,0 +1,205 @@
+# Was ist neu in MeshDD-Bot 0.8.x
+
+> Aktueller Stand: **v0.8.9** · Release-Datum: 2026-02-19
+
+---
+
+## Übersicht
+
+Release 0.8 bringt die vollständige Integration des **NINA BBK Warnsystems** in den
+MeshDD-Bot, ergänzt um eine Reihe von Verbesserungen am Paket-Log, der Karte und der
+Verbindungsinitialisierung.
+
+---
+
+## Neue Funktionen
+
+### NINA Warnmeldungs-Integration (`/nina`)
+
+Der Bot ist jetzt an die **NINA Warn-App des BBK** (Bundesamt für Bevölkerungsschutz
+und Katastrophenhilfe) angebunden. Warnmeldungen werden automatisch per HTTP-Polling
+von `warnung.bund.de/api31` abgerufen und ins Meshtastic-Netz gesendet.
+
+#### Konfigurationsseite
+
+Unter `/nina` (Admin-only) steht eine vollständige Verwaltungsseite bereit:
+
+| Einstellung | Beschreibung |
+|---|---|
+| **Aktiviert** | NINA-Abfragen ein-/ausschalten |
+| **Ins Mesh senden** | Aus = Monitor-Modus (nur Weboberfläche, kein Mesh-Versand) |
+| **Abfrageintervall** | Wie oft neue Warnmeldungen abgerufen werden (Sek., min. 60) |
+| **Wiederholungsintervall** | Aktive Warnungen werden in diesem Abstand erneut ins Mesh gesendet |
+| **Kanal** | Meshtastic-Kanal (0–7) für den Versand |
+| **Mindest-Schweregrad** | Gering / Mäßig / Schwerwiegend / Extrem |
+| **AGS-Codes** | Amtliche Gemeindeschlüssel der zu überwachenden Regionen |
+| **Quellen** | Katwarn, BIWAPP, MoWaS, DWD, LHP, Polizei |
+
+#### AGS-Code-Verwaltung
+
+- AGS-Codes werden in einer **Tabelle** mit Ortsname und Lösch-Button angezeigt
+- Bei der Eingabe schlägt eine **Combobox** alle sächsischen Landkreise und kreisfreien
+  Städte vor (Name + 12-stelliger Code)
+- Voreingestellt: 5 Codes für den **Raum Dresden** (Stadt Dresden, LK Meißen,
+  LK Sächsische Schweiz-Osterzgebirge, LK Bautzen, LK Görlitz)
+
+#### Polling-Strategie
+
+Zwei parallele Abfragestrategien pro Zyklus:
+
+1. **Dashboard-Endpunkt** (`/dashboard/{AGS12}.json`) — regionale Filterung durch den
+   BBK-Server; deckt alle Quellen für konfigurierte AGS-Codes ab.
+2. **mapData-Endpunkt** (`/{quelle}/mapData.json`) — wird **nur verwendet, wenn keine
+   AGS-Codes konfiguriert sind** (bundesweite Abfrage ohne Geo-Filterung).
+
+Quellenübergreifende **De-Duplikation** via ID-Normalisierung verhindert doppelte
+Meldungen (z. B. `dwdmap.` ↔ `dwd.`, `mow.` ↔ `mowas.`).
+
+#### Warnmeldungen im Mesh
+
+Nachrichten-Format im Meshtastic-Netz:
+
+```
+[NINA] Schwerwiegend: Sturmböen (Dresden, Stadt)
+Beschreibung des Ereignisses (max. 120 Zeichen)...
+
+[NINA] Aufgehoben: Sturmböen (Dresden, Stadt)
+```
+
+Das **Herkunftsgebiet** (AGS-Regionsname) wird automatisch an Meldung und Aufhebung
+angehängt.
+
+#### Live-Anzeige in der Weboberfläche
+
+Die Tabelle „Letzte Warnmeldungen" zeigt:
+
+| Spalte | Inhalt |
+|---|---|
+| **Schweregrad** | Farbiger Badge (Extrem / Schwerwiegend / Mäßig / Gering / Aufgehoben) |
+| **Meldung** | Headline der Warnung |
+| **Gebiet** | AGS-Regionsname (z. B. „Dresden, Stadt") |
+| **Typ** | Quell-Präfix (z. B. `dwd`, `katwarn`) |
+| **Mesh** | Broadcast-Icon (gesendet) oder Auge-Icon (Monitor-Only) |
+| **Zeitstempel** | Sendezeitpunkt der Warnung |
+
+Beim Seitenaufruf werden alle **aktuell aktiven Warnungen** sofort geladen
+(`GET /api/nina/alerts`). Neue Warnungen erscheinen live via WebSocket.
+
+#### Sofortabfrage nach dem Speichern
+
+Nach dem Klick auf „Speichern" wird unmittelbar eine NINA-Abfrage gestartet — kein
+Warten auf den nächsten Intervall-Zyklus. Unterhalb des Abfrageintervall-Felds wird
+Datum und Uhrzeit der **letzten erfolgreichen Abfrage** angezeigt.
+
+---
+
+## Verbesserungen am Paket-Log (`/packets`)
+
+### Informativerer Payload
+
+Die Info-Spalte zeigt jetzt deutlich mehr Daten je Pakettyp:
+
+| Typ | Angezeigte Felder |
+|---|---|
+| `POSITION_APP` | Koordinaten + Höhe (m), Geschwindigkeit (km/h), Satelliten |
+| `TELEMETRY_APP` | Akku (%), Spannung (V), Kanalauslastung (%), TX-Auslastung (%), Temperatur (°C), Luftfeuchtigkeit (%), Luftdruck (hPa) |
+| `NODEINFO_APP` | long_name, short_name, Hardware-Modell |
+| `ROUTING_APP` | Fehlercode (wenn vorhanden) |
+| `TRACEROUTE_APP` | Anzahl Hops |
+| `NEIGHBORINFO_APP` | Anzahl Nachbarn |
+
+### Unterdrückung eigener Telemetrie
+
+Telemetriepakete vom **eigenen Node** werden im Paket-Log weder angezeigt noch gezählt.
+Die Erkennung erfolgt automatisch per `my_node_id` (WebSocket-Initial-Payload) sowie als
+Fallback über den Short-Name `FTLW`.
+
+---
+
+## Verbesserungen an der Karte (`/map`)
+
+### Neue Legendenposition
+
+Die Kartenlegende wurde von `bottomright` nach **`topleft`** verschoben — direkt
+unterhalb der Zoom-Schaltfläche, wo sie auf allen Bildschirmgrößen sicher sichtbar ist.
+
+### Neues Legengendesign
+
+Die Legende wurde komplett neu gestaltet:
+
+- **Theme-aware**: passt sich automatisch Light- und Dark-Mode an (CSS-Variablen)
+- **Kompaktes Layout**: kleine Uppercase-Abschnittsköpfe (`HOPS` / `ALTER`)
+- **Weicherer Schatten** und dezentes Border
+
+---
+
+## Bugfixes
+
+### Startup-Warning „connection.established missed" (fixes #2)
+
+Beim Start erschien regelmäßig eine Warnung im Log:
+
+```
+[WARNING] meshbot.bot: connection.established missed – applying fallback
+```
+
+**Ursache:** `bot.connect()` läuft in einem separaten Thread. Der `TCPInterface`-Konstruktor
+kehrte zurück, bevor das `connection.established`-Event aus dem Meshtastic-Bibliotheks-Thread
+gefeuert wurde. Der sofortige Check sah `_connected = False` und löste den Fallback aus.
+
+**Fix:** Ein `threading.Event` (`_conn_event`) wird in `_on_connection` gesetzt.
+Nach dem Konstruktor wartet der Code bis zu 10 Sekunden auf dieses Event. Der
+Fallback greift nur noch bei echtem Ausbleiben.
+
+---
+
+## Konfigurationsdateien
+
+### `nina.yaml`
+
+Separate Hot-reload-fähige Konfigurationsdatei für NINA (analog zu `scheduler.yaml`).
+Wird automatisch angelegt wenn nicht vorhanden.
+
+```yaml
+enabled: false
+send_to_mesh: true
+poll_interval: 300       # Sekunden, min. 60
+resend_interval: 3600    # Sekunden, Wiederholung aktiver Warnungen
+channel: 0               # Meshtastic-Kanal 0–7
+min_severity: Severe     # Minor | Moderate | Severe | Extreme
+ags_codes: []
+sources:
+  katwarn: true
+  biwapp: true
+  mowas: true
+  dwd: true
+  lhp: true
+  police: false
+```
+
+---
+
+## Neue API-Endpunkte
+
+| Methode | Pfad | Beschreibung | Auth |
+|---|---|---|---|
+| `GET` | `/api/nina/config` | NINA-Konfiguration lesen | Admin |
+| `PUT` | `/api/nina/config` | NINA-Konfiguration speichern + Poll auslösen | Admin |
+| `GET` | `/api/nina/alerts` | Aktuell aktive Warnmeldungen | Admin |
+
+---
+
+## Versionshistorie 0.8.x
+
+| Version | Datum | Schwerpunkt |
+|---|---|---|
+| 0.8.0 | 2026-02-19 | NINA-Integration (Grundfunktion) |
+| 0.8.1 | 2026-02-19 | Wiederholungsintervall, AGS-Tabelle, Badge-Fixes |
+| 0.8.2 | 2026-02-19 | mapData nur ohne AGS-Codes (geografische Filterung) |
+| 0.8.3 | 2026-02-19 | Gebietsanzeige, AGS-Ortsname, Sachsen-Combobox |
+| 0.8.4 | 2026-02-19 | Sofortabfrage nach Speichern, Zeitstempel letzte Abfrage |
+| 0.8.5 | 2026-02-19 | Kartenlegende nach topleft verschoben (fixes #5) |
+| 0.8.6 | 2026-02-19 | Informativer Paket-Payload, FTLW-Telemetrie unterdrückt (fixes #3) |
+| 0.8.7 | 2026-02-19 | threading.Event-Fix für Startup-Warning (fixes #2) |
+| 0.8.8 | 2026-02-19 | Kartenlegende neu gestaltet (theme-aware) |
+| 0.8.9 | 2026-02-19 | Aktive NINA-Warnungen beim Seitenaufruf laden |