laoyang
f92a98a3a3
用户问：「任务是带有子任务功能的，能否通过 caldav，把任务的子任务也同步给客户端？」
## 答案：能，但实测发现父子被分到了不同本
改前数据：
父 #12「轻舟的幼儿园发票」 category_id = 1（家庭事务）→ tasks-1.ics
子 #29「送财务报销」 category_id = NULL（收件箱） → tasks-inbox.ics
客户端渲染「家庭事务」时看不到子任务，渲染「收件箱」时又找不到父任务，
⇒ 不可能显示成层级，只能两条并列。
## 改法
### 1. 子任务跟随父分类（TaskDav::effectiveCat）
有效分类 = 自己的 category_id
↓ 为空且是子任务时
父任务的 category_id
⚠️ **不改数据库**，只在视图层算。
改库等于篡改用户数据，而且单向不可逆。
边界：
| 情况 | 有效分类 |
|---|---|
| 自己无分类 + 父有分类 | 跟父（父子同本） |
| 自己无分类 + 父也无分类 | 都进收件箱（父子同本） |
| 自己有分类 | 用自己的（尊重用户明确设定） |
`tasksIn()` 改为 SQL 联查 `p.category_id`（一次到位，避免 N+1），
再在内存里按有效分类过滤。
### 2. SUMMARY 去掉硬加的「└ 」前缀
原来给子任务 SUMMARY 加「└ 」。这会**污染用户数据** ——
客户端把标题写回来（PUT）时前缀被存进库，用户的标题就多了一坨。
层级改由标准属性表达：
- `RELATED-TO:task-12` —— RFC 5545 §3.8.4.5 标准父子
- `X-FAMILYBOOK-PARENT:轻舟的幼儿园发票` —— 展示用补充，不支持的客户端无视
### 3. 跨本时的降级提示
用户明确给子任务设了别的分类时（尊重其选择），父子仍会跨本。
那种情况在 DESCRIPTION 尾部补一句人话说明，避免客户端把
「有 RELATED-TO 但找不到父」当成数据损坏而不显示这条。
## 验证
改后分布：
| 本 | 总数 | 父 | 子 |
|---|---|---|---|
| 家庭事务 | 7 | 6 | 1（#29） |
| 工作相关 | 19 | 19 | 0 |
| 个人事务 | 2 | 2 | 0 |
| 党支部工作 | 1 | 1 | 0 |
| 轻舟相关 | 1 | 1 | 0 |
| 收件箱 | 2 | 2 | 0 |
- 总数仍 32 条，没丢没重
- **所有父子都在同一本里**
- HTTP 端到端 39 项全过（含跨本隔离、鉴权、日历本回归）
## 客户端支持度说明（服务端无法改变）
| 客户端 | 层级显示 |
|---|---|
| DAVx⁵ + Tasks.org | 认 RELATED-TO，显示缩进子项 |
| 苹果提醒事项 | 有原生子任务 UI，对 RELATED-TO 支持有限 |
| Thunderbird | 不显示层级，两条并列 |
数据是正确的，显示成什么样取决于客户端能力。
想在所有客户端都看到层级，只能靠前端自己渲染 —— 那是网页端的事。
FamilyBook
家书，记录家庭的全部生活，一本用岁月写成的家谱。
把一个家的「人」「日子」「去过的地方、看过的电影」收进同一本书里。
它是什么
一个自托管的家庭生活系统。它不是又一个待办清单，而是这个家的长期档案 —— 十年之后还能翻出孩子第一次观影的票根、那年暑假走过的路线。
围绕三个圈展开：
- 人：家庭成员、亲友通讯录，以及他们之间的共享关系
- 时间：日历、日程、提醒，以及任务的期限
- 事件：观影、旅行、其他活动 —— 一切都落在同一条时间轴上
它在做什么
| 阶段 | 主题 | 内容 |
|---|---|---|
| 0 | 地基 | 名册、账号、登录、权限模型、安装向导 |
| 1 | 通信 | 通讯录、共享给某个成员、CardDAV 服务端 |
| 2 | 时间 | 日历本、重复日程、提醒、CalDAV 服务端 |
| 3 | 归一 | 观影与旅行迁入统一事件模型 |
| 4 | 任务 | 任务管理，期限自动映射成日历事件 |
| 5 | 回看 | 统计、年度家书、时间轴 |
当前进度：阶段 0 起步，仓库里只有图标与脚手架。
技术选型
- PHP 7.4+（无框架、无 Composer，上传到站点目录即可运行）
- MySQL 5.7+ / 8.0（
utf8mb4） - 前端为原生 HTML / CSS / JavaScript，无构建步骤
⚠️ 注意 CalDAV / CardDAV 是双向协议，和单纯的 .ics 文件导出不是一个量级的东西。
部署
- 把代码放到站点根目录；
- 复制
config.example.php为config.php，填写数据库与app_key； - 访问站点根，按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。
config.php 不入库（已在 .gitignore 中忽略），其中包含数据库口令与加密密钥。
⚠️ app_key 一旦开始记录数据就不能再改（换掉即解不开已有数据），
并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。
隐私
身份证号、手机号属于敏感个人信息，一律加密存储。 （就家庭自用而言，身份证号其实没有多少必须存的场景，启用前请三思。）
图标
见 assets/icons/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。