# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

日历 - 约会和日历管理
==========================================

描述
------------
具有数据库支持的约会和日历管理。显示即将到来的日期
来自 Assistant_calendar 与适当的家庭例程 (household_routines) 相结合。
支持带有位置、类型、状态和可选描述的约会。

操作
-----------
  bach calendar today                         今天显示
  bach calendar week                          本周
  bach calendar month                         本月
  bach calendar list [TAGE]                   接下来的N天（默认30）
  bach calendar add "TITEL" [OPTIONEN]        创建约会
  bach calendar show <ID>                     约会详细信息
  bach calendar done <ID>                     约会已完成
  bach calendar delete <ID>                   删除约会
  bach calendar help                          此帮助

添加选项
------------
  -d, --date <日期> YYYY-MM-DD 或 DD.MM.YYYY（默认值：今天）
  -t, --time <时间> HH:MM（默认值：09:00）
  --end <TIME> 结束时间 (HH:MM)
  --location <LOCATION> 预约地点
  --type <TYPE> 约会|提醒|任务（默认：约会）
  --note <TEXT> 描述

示例
---------
  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

输出格式
---------------
[日历] 时间范围 - N 个条目

  --- WD DD.MM。 ---
    [ID>3] HH:MM 标题 @ 位置 [状态]
    [RID>2] ---- 例程名称（频率、类别）

数据库
---------
  文件：数据/bach.db
  表：assistant_calendar（id、标题、event_type、start_datetime、
                                   结束日期时间、位置、描述、状态）
              family_routines（id、姓名、频率、类别、next_due）

文件
-------
  处理程序：hub/calendar_handler.py
  文档：docs/help/calendar_handler.txt

另请参阅
----------
  DB_004_TERMINDATENBANK_ANALYSE.md（数据库架构）
  hub/base.py（BaseHandler 实现）
