laoyang
2e51d3f5e4
用户十条，逐条落地：
1. 「题图应该按照 16:9 显示，因为添加的时候是按这个比例裁剪的，现在的显示比例不对。」
→ 详情页题图容器从 4:3 改成 16:9，与 ImageSlot 的 cover 槽位同一个数字
（部署断言比对这两处，避免哪天改一处漏一处）。
2. 「题图的右侧，显示的是参与人都有谁、去了几个城市、一共去了几天、一共几段行程，
一共花了多少钱，这些信息，都从该活动下的所有行程统计总结，简介那一段话保留。」
→ 新增 Trip::summary()：参与人（各段并集）/ 城市（去重）/ 天数 / 段数 / 总花销，
全部读时算（与"时间城市派生"同一条原则，不存冗余）。
天数按**日历天**含首尾（8/1→8/3 = 3 天，不是 24 小时整除的 2 天）。
城市与时间从标题旁挪进信息区，简介保留。
3. 「活动页面，不需要上传图片，图片视频，都是针对一次具体的行程的。」
→ 删掉旅程页的照片上传板块与照片墙；照片一律挂在**行程**上
（行程表单里有上传，附件 target_type='trip_node'）。
4. 「计划行程、未成行的行程，都不要显示……只要是没有就是 0 条，那个类型就不显示了，
现在显示的是 0 条，这样没意义。」
→ 空分组直接跳过不渲染；全空时给一句引导（否则新建旅程页面一片空白）。
有内容的分组照常显示（计划 / 实际 / 未成行三种）。
5. 「行程的编辑功能，点击后会把页面撑破。编辑行程，打开新的页面进行编辑。」
→ 行程的新增与编辑改成**独立页面**（trips/node_new / trips/node_edit）。
原来内联在详情页：N 份表单互相撞元素 id、密码管理器逐个扫描变卡，
正是"把页面撑破"的成因。
6. 「添加计划行程和实际行程的按钮，都放在右上角。点击后打开新的页面进行添加。」
→ 详情页右上角两个按钮（+ 计划行程 / + 实际行程），指向独立新增页。
顺带：标题旁边不再放时间（时间移到题图右侧信息区）。
7. 「添加和编辑行程的内容，你去找 triplog 里面的添加节点功能，跟那个一样。」
→ 字段全量照搬 TripLog 的 nodes/form.php：
类型 / 标题 / 起止时间 / 出行方式 + 车辆 / 线路名 / 承运方 / 车次航班号 /
座位 / 登机口 / 出发地 / 到达地 / 内容 / 参与人（含角色）/ 照片 / 花销。
交通字段不做条件列（先填高铁车次、后来改成自驾，填过的东西不该丢）。
8. 「右上角的按钮，需要增加一个设置按钮，用来设置车辆管理、出行方式、节点类型。
注意，我们在财务中，已经把车辆添加进去了，所以这里不用重复添加那里面的车辆，
直接读取就可以，但是可以添加其他的车辆，比如租的车，借别人的车。」
→ 新增旅程设置菜单（三页）：车辆管理 / 出行方式 / 节点类型。
车辆**两个来源刻意不合并**：财务里 kind='car' 的账目（那是资产，没有车牌车型）
由 Vehicle::fromLedger() 只读列出，选车下拉里标「来自财务」；
自家 / 租的 / 借的车录进 vehicles 表。不复制财务的车（避免同一台车两处维护）。
节点类型做成**可自定义**的表（TripLog 同款），内置 5 种不可删；
行程里存类型**名字**，所以改类型名会级联更新已用它的行程。
9. 「活动都改名吧，改成旅程，新建旅程，旅程包含行程，这个名字就固定下来。」
→ 术语固定：**旅程**（容器）包含**行程**（单元）。
顶层按钮「新建旅程」、详情页三组叫「计划的行程 / 实际行程 / 未成行」、
列表「N 段行程」、设置菜单「旅程设置」。上一批的"活动"叫法全部换掉。
10. 「新建旅程里面，怎么还有备注啊，同行的人啊，这些都不要了，这些都是从行程里面
总结出来的。在新建旅程和编辑旅程的时候，都不要了。」
→ 旅程表单只剩：标题 → 题图 → 简介 + 公开开关。
备注与同行的人全部移除（参与人 = 各段行程参与人的合集）。
⚠️ 但**老数据里活动级那份参与人名单不能被清空**（那时还没有行程级参与人），
所以路由"没传这个键就不动"，并加了断言钉住这一点。
数据结构（Schema v21，老库自动升级）：
· 新表 vehicles（自家/租的/借的）、node_types（可自定义）、trip_expenses（行程级花销）
· trip_nodes 补 9 列：出行方式 / 车辆 / 线路名 / 承运方 / 车次 / 座位 / 登机口 / 起终点
· trip_node_members 补 role_tag（司机 / 摄影担当这类角色）
· 花销金额存**分**，解析走字符串拆小数点（128.55*100 在浮点下会差一分）
验证：e2e 891/0（+46 条本批断言）· 升级 134/0 · 桌面几何 428/0 · 交互 92/0 ·
窄屏溢出 30/0（扩到行程表单 + 设置三页 + 详情页）· 题图点击 4/0 · 静态体检全绿。
**反向验证 6/6**：题图退回 4:3、标题旁加回时间、空分组照旧渲染、编辑退回非独立页、
车辆不读财务、总花销不汇总 —— 六种坏法全部被断言抓住。
部署静态断言新增第 16 批一组（含"空分组不许渲染""行程页不许有照片上传"
"旅程表单不许有备注与同行的人""题图必须 16:9"等反退化防线）。
部署后服务器自检 19/19，六个关键文件 md5 与线上逐一核对一致。
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。