# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

CALENDAR - Termin- und Kalenderverwaltung
==========================================

BESCHREIBUNG
------------
Termin- und Kalenderverwaltung mit Datenbankunterstützung. Zeigt kommende Termine
aus assistant_calendar kombiniert mit fälligen Haushaltsroutinen (household_routines).
Unterstützt Termine mit Ort, Typ, Status und optionalen Beschreibungen.

OPERATIONEN
-----------
  bach calendar today                         Heute anzeigen
  bach calendar week                          Diese Woche (KW)
  bach calendar month                         Dieser Monat
  bach calendar list [TAGE]                   Nächste N Tage (default 30)
  bach calendar add "TITEL" [OPTIONEN]        Termin anlegen
  bach calendar show <ID>                     Termin-Details
  bach calendar done <ID>                     Termin als erledigt
  bach calendar delete <ID>                   Termin löschen
  bach calendar help                          Diese Hilfe

ADD-OPTIONEN
------------
  -d, --date <DATUM>      YYYY-MM-DD oder DD.MM.YYYY (default: heute)
  -t, --time <UHRZEIT>    HH:MM (default: 09:00)
  --end <UHRZEIT>         End-Uhrzeit (HH:MM)
  --location <ORT>        Termin-Ort
  --type <TYP>            termin|erinnerung|aufgabe (default: termin)
  --note <TEXT>           Beschreibung

BEISPIELE
---------
  bach calendar today
  bach calendar week
  bach calendar list 60
  bach calendar add "Zahnarzt" -d 15.02.2026 -t 10:30 --location "Praxis"
  bach calendar add "Treffen" -d 2026-03-10 -t 14:00 --end 15:30 --note "Besprechung"
  bach calendar show 5
  bach calendar done 5
  bach calendar delete 5

AUSGABE-FORMAT
---------------
[KALENDER] Zeitbereich - N Einträge

  --- WD DD.MM. ---
    [ID>3] HH:MM Titel @ Ort [Status]
    [RID>2] ---- Routine-Name (Frequenz, Kategorie)

DATENBANK
---------
  Datei:      data/bach.db
  Tabellen:   assistant_calendar (id, title, event_type, start_datetime,
                                   end_datetime, location, description, status)
              household_routines (id, name, frequency, category, next_due)

DATEIEN
-------
  Handler:    hub/calendar_handler.py
  Doku:       docs/help/calendar_handler.txt

SIEHE AUCH
----------
  DB_004_TERMINDATENBANK_ANALYSE.md (Datenbank-Schema)
  hub/base.py (BaseHandler-Implementierung)
