QuasselBot // Terminal Handbuch

📔 Tagebuch im Fahrdienst (TB)

Stand: 28.05.2026 --- Dieses Modul ermöglicht Fahrerinnen und Fahrern, ihre Fahrdienste und Tätigkeiten strukturiert zu dokumentieren. Alle Einträge werden AES-256 verschlüsselt gespeichert.

Übersicht

Das Tagebuch ist ein einfaches, aber leistungsstarkes Dokumentationswerkzeug für Fahrdienste. Es speichert:

Datum des Eintrags

Zeit (optional)

Linie/Kurs

Wagennummer

Freitext/Notiz (optional)

Das Modul ist PM-only – alle Interaktionen laufen im Privat-Chat, mit automatischer Weiterleitung von Gruppenchat-Anfragen.

Aktivierung

Das Tagebuch-Modul wird über die Gruppenverwaltung aktiviert: 1. Im Privat-Chat: /group 2. Gewünschte Gruppe auswählen 3. Im Menü: "Tagebuch" ein-/ausschalten Nach Aktivierung können Nutzer in der Gruppe /tb aufrufen und werden automatisch in den PM weitergeleitet.

Befehle

Direkte Eingabe (Kurzeingabe)

/tb add [Datum] [Zeit] [Linie/Kurs] [Wagennummer] [Freitext]

Beispiele:

/tb add 20.05.2026 07:30 M5/07 3124 Normalbetrieb
/tb add 20.05 M5/07 3124
/tb add M5/07 3124 Ausfallfahrt

Regeln:

Datum: TT.MM.YYYY oder TT.MM. (aktuelles Jahr). Ohne Datum = heute.

Zeit: HH:MM oder HH.MM. Optional.

Linie/Kurs: Pflichtfeld, frei formatierbar (z.B. M5, M5/07, 12, 12A)

Wagennummer: Pflichtfeld

Freitext: Optional, beliebige Länge

Menü-Interface

/tb
/tagebuch

Öffnet das Hauptmenü mit vier Optionen: #### ➕ Neuer Eintrag Interaktiver Eingabe-Dialog mit Schritten: 1. Datum: Auswahl zwischen "Heute" oder manueller Eingabe 2. Zeit: Eingabe in Format HH:MM (optional) 3. Linie/Kurs: Pflichtinput 4. Wagennummer: Pflichtinput 5. Freitext: Freitextinput (optional, kann übersprungen werden) Das System merkt sich die letzten Werte und schlägt diese beim nächsten Eintrag vor. #### 📖 Abrufen Zeigt die letzten 50 Einträge an:

/tb list

Mit Filter:

/tb list [Datum]           # Einträge für ein spezifisches Datum
/tb list [Linie/Kurs]      # Alle Einträge einer Linie
/tb list [Wagennummer]     # Alle Einträge einer Wagennummer

Beispiele:

/tb list 20.05.2026
/tb list M5/07
/tb list 3124

#### 🗑️ Löschen Startet den interaktiven Lösch-Dialog:

/tb del
/tb del [Datum]
/tb del [Linie/Kurs]
/tb del [Wagennummer]

Zeigt eine Auswahlliste, dann wird nach Bestätigung abgefragt:

Antworte mit: 1,2 (für Einträge 1 und 2)
            oder: alle

#### 🖨️ Drucken Startet den PDF-Export-Dialog:

/tb print

Zeigt Vorschau aller Einträge und ermöglicht PDF-Export.

Datensicherheit

Verschlüsselung

Alle Felder werden mit dem globalen AES-256 DB-Key verschlüsselt:

- Datum - Zeit - Linie/Kurs - Wagennummer - Freitext

Selbst der Bot-Admin sieht die Daten nicht im Klartext in der Datenbank

DSGVO & Datenlöschung

Mit /dsgvo können Nutzer:

🔍 Alle Tagebuch-Einträge exportieren (Art. 15 DSGVO - Auskunftsrecht)

🚮 Alle Tagebuch-Einträge löschen (Art. 17 DSGVO - Recht auf Vergessenwerden)

Bei der Löschung:

24h Bedenkfrist

Mit /dsgvo recover kann die Löschung innerhalb dieser Zeit abgebrochen werden

Nach 24h erfolgt die automatische endgültige Löschung

Caching & Vorbelegung

Das System merkt sich:

Letztes Datum

Letzte Linie/Kurs

Letzte Wagennummer

Diese werden beim nächsten Eintrag als Vorschlag angezeigt und können durch neue Eingaben überschrieben werden.

Ausgabeformat (List/Print)

Standard-Anzeige:

1. 20.05.2026 07:30  M5/07  3124
   Normalbetrieb…

PDF-Export zeigt:

📅 20.05.2026 07:30
🚃 M5/07 | 🚊 3124
📝 Normalbetrieb

Workflow-Beispiel

Neue Einträge erfassen

Nutzer: /tb add 20.05 07:30 M5/07 3124
Bot:   ✅ Eintrag gespeichert!

Nutzer: /tb add 20.05 14:00 M5/08 3125 Wartepause 30min
Bot:   ✅ Eintrag gespeichert!

Einträge abrufen

Nutzer: /tb list 20.05
Bot:   📖 Deine Tagebuch-Einträge für 20.05.2026:
       1. 20.05.2026 07:30  M5/07  3124
       2. 20.05.2026 14:00  M5/08  3125
          Wartepause 30min…

Einträge löschen

Nutzer: /tb del 20.05
Bot:   🗑️ Welche Einträge möchtest du löschen?
       1. 20.05.2026 07:30 | M5/07
       2. 20.05.2026 14:00 | M5/08
       Antworte mit: 1 oder 2 oder alle

Nutzer: 1
Bot:   ✅ 1 Eintrag gelöscht.

Group Feature Management

Aktivierung über `/group settings`

Nutzer: /group
Bot:   [Gruppen-Auswahl anzeigen]

Nutzer: [Gruppe wählen]
Bot:   [Feature-Toggle anzeigen]
       ☐ KK-Minuten
       ☐ Lehrfahrer (LF)
       ☐ Gewerkschaft (GW)
       ☐ Tagebuch (TB)
       ...

Nutzer: [Tagebuch Toggle]
Bot:   ✅ Tagebuch in dieser Gruppe aktiviert.

Verhalten in Gruppenchats

Wenn die Tagebuch-Funktion aktiviert ist und ein Nutzer /tb in der Gruppe aufruft: 1. Bot antwortet im Gruppenchat: "Ich antworte dir besser privat. 💌" 2. Bot sendet die Tagebuch-Menü-Nachricht im Privat-Chat des Nutzers 3. Nutzer kann dort mit dem Tagebuch-Flow fortfahren Ist Tagebuch nicht aktiviert oder der Bot nicht als Kontakt gespeichert: 1. Bot zeigt Aktivierungslink 2. Nutzer muss Bot zunächst im PM starten (/start)

Technische Details

Datenbank

Tabelle: tb_entries Spalte | Typ | Verschlüsselt | Beschreibung --------|-----|---------------|------------- id | INT | — | Primärschlüssel user_id | BIGINT | — | Telegram User-ID entry_date | TEXT | ✅ | Datum (TT.MM.YYYY) entry_time | TEXT | ✅ | Zeit (HH:MM) oder leer line_course | TEXT | ✅ | Linie/Kurs wagon_number | TEXT | ✅ | Wagennummer note_text | TEXT | ✅ | Freitext/Notiz created_at | TIMESTAMP | — | Erstellungszeit updated_at | TIMESTAMP | — | Änderungszeit Indizes:

idx_tb_entries_user: Schneller Zugriff nach User

idx_tb_entries_user_date: Schneller Zugriff nach User + Datum

State Management

Session-Keys:

tb_dialog_state: Aktueller Dialog-Status

tb_cache: Zwischengespeicherte Eingaben

Integration mit anderen Modulen

DSGVO-Auskunft (`/dsgvo`)

Tagebuch-Einträge sind Teil der DSGVO-Auskunft und werden exportiert.

Feature-Filter

Das Modul respektiert den tagebuch Feature-Filter aus der Gruppenverwaltung.

Troubleshooting

"Ich antworte dir besser privat" Nachricht in der Gruppe

Ursache: Tagebuch-Modul ist aktiviert, aber der Nutzer hat den Bot noch nicht im PM gestartet. Lösung: Bot im Privat-Chat mit /start starten.

Eintrag wird nicht gespeichert

Ursache: Datenbankfehler oder Verbindungsproblem. Lösung:

Überprüfen, ob alle erforderlichen Felder gefüllt sind

Neuen Versuch mit Wartezeit

Admin kontaktieren

Alte Einträge werden nicht angezeigt

Standard: /tb list zeigt die neuesten 50 Einträge. Lösung: Mit /dsgvo → Auskunft alle Einträge exportieren.

Best Practices

1. Regelmäßig eingeben: Tägliche Einträge sofort nach Schicht erfassen 2. Konsistente Formatierung: Liniennummern einheitlich eingeben (z.B. immer M5/07) 3. Aussagekräftige Notizen: Kurz aber aussagekräftig (z.B. "Betriebsstörung 30min" statt "Problem") 4. Backup: Regelmäßig mit /dsgvo → Auskunft alle Einträge exportieren

Kontakt & Support

Bei Fragen oder Problemen:

/help tagebuch — Hilfe im Chat

/dsgvo — DSGVO-Rechte & Datenlöschung