# Portability: USER
# Last validated: 2026-05-17
# Next review: 2027-05-17
# 资源：[household_routines table, hub/routine.py]

ROUTINE - 家庭日常管理
--------------------------------------

状态：2026-02-08

日常系统（第 3 层）管理家庭中的重复任务
和带有自动间隔计算的私人区域。

核心概念
------------
- 频率：从每天到每年（自动重新安排）。
- 状态：过期任务标有“!!!”。
- 集中化：所有例程都在 `bach.db` 中。

CLI 命令（bach 例程）
--------------------------
  列表 [--all] [-c <类别>]
                所有活动例程的概述。
                --all 还显示不活动的，-c 按类别过滤。
                示例： bach 例程列表 -c Kueche

  show <ID> 显示单个例程的详细信息。
                示例：巴赫例程表演 3

  due [days] 显示所选期间的到期任务。
                默认值：7 天。示例：巴赫例行程序到期 14

  完成 <ID> [ID2...] [--注意“文本”]
                将例程标记为已完成并设置新日期。
                可以有多个 ID，可以选择带有注释。
                示例：巴赫例程已完成 3 5 --note“基本清洁”

  添加“名称”[--freq/-f <频率>] [--cat/-c <Cat>] [--dur/-d <分钟>] [--note <文本>] [--schedule <时间>]
                使用可选参数创建新例程：
                --freq/-f 频率（每日、每周、每月、每年等）
                --cat/-c类别（厨房、浴室、客厅等）
                --dur/-d 持续时间（以分钟为单位）
                --注意注意事项
                --schedule 日程详情
                示例：巴赫例行程序添加“吸尘”--freq 每周 --cat 客厅 --dur 30

  help 显示此帮助。

FREQUENCIES（完整列表）
-------------------------------
--freq 支持的频率值：
  每日，每日，每日
  每周，每周，每周
  每两周一次，每两周一次，每两周一次
  每月，每月
  季度，季度
  半年一次，半年一次
  每年、每年、每年

ABM 语法
----------
标记：
  !!!  = 逾期
  + = 活跃
  - = 非活动

数据库（第 1 层）
---------------------
- 表：“household_routines”（在“bach.db”中）。
- 字段：id、名称、频率、时间表、类别、持续时间分钟、
          Last_done、next_due、is_active、notes、created_at。
- 统计数据：可变数量（取决于数据库内容）。

GUI 和集成
-----------------
GUI 中的**家庭仪表板**直观地显示例程的状态。
例程也集成到全局“日历”处理程序中。

另请参见
----------
  bach calendar         组合预约和例程视图
  bach --help gesundheit  其他家庭工具（库存）
  docs/help/maintain.txt 数据库重定位历史记录（用户->巴赫）
