laoyang
252812ed93
用户 2026-10-14 四条。
① 旅程详情点点「编辑」，里面的图片改不了、拖入/选中都不弹裁剪框
用户原话：「应该弹出来一个让我裁剪的那个框。但是现在却没有那个裁剪的框。」
**真根因**（assets/js/app.js）：裁剪那段 IIFE 是**首屏一次性**的 ——
`var inputs = querySelectorAll('[data-crop-ratio]'); if (!inputs.length) return;`
在脚本加载那一刻扫一遍，扫不到就整段放弃。而「编辑旅程」是 **AJAX 取片段、
innerHTML 塞进弹框**的（templates/trips/show.php 的 loadInto）⇒ 详情页首屏
**没有**题图框 ⇒ 当场 return ⇒ 片段里的框**从来没有 change 监听**
⇒ 拖入/选中什么都不发生。
修法：拆成 `bindOne(input)`（幂等，打 `data-crop-bound` 标记）+ `scan(scope)`；
首屏调一次 + **MutationObserver 补挂**；库的按需加载改成"首次真要用时才拉"。
⚠️ 与「拖动上传」那段（bindInput/scan/MutationObserver）**同一手法** ——
它早就解决了"动态插进来的文件框也要接得住"，裁剪这段当年漏了这层。
② 旅程「修正」表单（templates/trips/_revise_form.php）
用户三条：「开始和结束时间…应该改成我们最新的控件样式」「上面记录实际执行情况
那一段话说明也不要了」「记录这次修正的按钮应该放在右边，另外应该加一个取消」。
· 起止换 `$dtPlugin = 'antd'`（与 node_form.php 同款；当年 v41 刻意没换，现按用户要求统一）
· 删 show.php 里 `.rev-tip` 整段
· 按钮行 `rev-foot` 靠右 + 新增 `[data-rev-cancel]`；取消由 show.php 的**事件委托**
处理（`details.rev-open` 收起）—— 不用内联脚本（片段会被 AJAX 换进来）
③ 名册打标签误报「这个人不在你的名册里」
用户原话：「我搜索出来一个人…给他打标签，它会显示说这个人不在我的名册里，
其实他是在我的名册里的。」
**真根因**（index.php 的 people/tags）：`isset(PersonRoster::visibleIds(...)[$pid])`，
而 `visibleIds()` 返回的是 **id 值列表** `[2,3,4,5]`（键是 0,1,2,3）——
把值列表当 id→值 映射用。只有 `$pid` 恰好等于数组下标时才为真：名册里人少时
（下标<pid）**谁都判"不在名册"**；一般情况只有"第 pid+1 个"碰巧过。
修法：改用 `in_array(..., true)`（与同文件 `inMyRoster` 写法一致）。
⚠️ **没改 `visibleIds()` 的返回形状** —— 另一处调用已是正确的 in_array，改形状会
静默弄坏它。陷阱：`PersonGroup::visibleIds()` 是集合、`PersonRoster::visibleIds()`
是值列表，**同名不同形状**，已在两处注释里写明。
（附带确认：不在名册的人本来就不出现在列表里，用户"不在名册就该搜不出来"本就成立。）
④ 名册列表按钮：编辑蓝底、删除红底
用**作用域类** `.person-edit`(var(--blue)) / `.person-del`(var(--red)) 三处形态都写，
不动全局 .btn-edit/.btn-danger 的语义（v41 踩过"裸类改色波及影院管理页"）。
hover 在这里补 `filter: brightness(.92)`（文末"全站悬停统一"段是白名单写的）。
验证（新增 2 套件 + 更新 1 处旧断言）：
· _fb_v50_ui.py（22 条真机断言：题图绑定/选中与拖入都弹裁剪框 16:9、修正 antd+无说明+
靠右+取消能收起、名册内 3 人打标签均成功且不误报、编辑蓝删除红）
· _b50_falsify.py（**10 注入 / 21 断言全抓**）
· _fb_e2e.py 的 ★第28-6条断言随 v50-4 升级（原查 var(--brand-soft)，现查蓝+红作用域类）
· familybook_deploy.sh 加 v50 静态断言段（含两条"旧写法必须已不在"的反向断言）
· e2e 1511/0、几何、各批反向验证全绿；**v50 四条 22/0**、**v50 反向验证 21/0**；
全流水线 **PUSH_RC=0**，部署脚本 0 FAIL（含"第50批形态"）；线上 6 文件 md5 逐字节一致；
线上门禁诊断 16 项全 YES，临时页已删并复验 404
⚠️ 收尾时发现并修掉一个**自设陷阱**：我在 show.php 的删除说明里**整句引用了**用户点名要删的
那句原话 ⇒ 朴素 strpos 判"已删"时会命中我自己的注释（线上诊断 C8=NO）。
部署断言用 `_code_has`（剥注释）所以是对的，但这类字串留在注释里迟早坑到别的检查
⇒ 已改成不整句照抄。**改注释也改了文件哈希 ⇒ 又重跑一次全量部署**。
⚠️ 流水线末段唯一"失败"同 v49：沙箱安全删除门禁（按轮次累计删满 50 就终止进程）；
单独重跑 _fb_v46_carddav.py = 29/0 ⇒ 环境护栏，与本次改动无关。
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。