laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity
122 Commits 1 Branch 0 Tags
4941e9db9c28e3169368e30c451b1b0b1a64f764
Commit Graph
20 Commits
Author SHA1 Message Date
laoyang a7fc7dcb0e 日程表单的日历本下拉只列可写 custom 本（#4） 
用户原话（2026-10-26）：「网页端，添加日程，如果日历本是只读的，例如别人
共享给我只读，或者系统自带日历、观影、纪念日等，就不要出现在日历本选框中，
只出现那些可写的。」

三条判据缺一不可（只做一条都修不好）：
  ① canWrite()         —— 挡「别人共享给我且只读」。
     实测：只有这一类能被 canWrite 拦住。
  ② !isReadonlyKind()  —— 挡系统只读本（农历/节假日/传统节日/二十四节气）。
     它们的 owner_id 就是我 ⇒ canWrite() 恒真，光靠 ① 一本也拦不住。
  ③ kind === 'custom'  —— 挡观影/旅行的派生本。
     这两本**确实可写**（往里加一条 = 建一条观影/旅程记录），
     但不是"放日程的地方"，放在新建日程下拉里只会让人建出别的东西。

- app/Calendar.php：新增 writableForEvent() / filterWritableForEvent()，
  作为**唯一口径**（日历页、首页卡片、API 都走它），
  避免 v82 那种"两个入口的下拉内容可以不一样"的老毛病。
  判据用 READONLY_KINDS 常量而不是 kind 白名单：新增系统本只要登记就自动生效。
- templates/calendar/index.php、index.php：改用上面的口径。
- templates/calendar/_add_modal.php：清掉恒假的 disabled 与「（自动生成）」
  死代码（前端已过滤，留着只会误导）；保留 data-kind 给探针当锚点；
  按钮色点与文案改成**服务端就带出来**（无 JS 时也看得见颜色和本名）。

验证：
- 浏览器探针 28/0：含自建夹具（只读共享 / 可写共享 / 自己的）三类，
  与 PHP 侧独立重算的期望集逐项比对，真保存一次，
  以及**绕过前端直接 POST** —— 只读共享回「这本日历你没有写权限。」且库无新增；
  观影/旅行回 ok:true 且真的落 events 表（不进 calendar_events）。
- 反向验证 6/6 全抓住：退回 canWrite / 只看 kind / 不管 custom / 全滤空 /
  只读共享漏进下拉 / 拆掉 event_add 的 canWrite 闸门。
  最后一条注入时**只有 ⑪ 变红**，证明它测的是服务端拦截而非前端下拉。
- 全量流水线（--all）退出码 0，已部署并确认线上 4 个文件 php -l 全通过。

工单：#4
 2026-10-26 14:59:57 +08:00
laoyang b45cf671d1 v71c：首页「通知消息」改成正规卡片，样式直接复用通知页 
用户 2026-10-21：
「先把web端的首页修一下，通知消息这个，也是首页的卡片，可以调整顺序和大小。
 另外，这个样式也不好看，我看个人头像点击后，通知消息那个页面的样式就不错，
 直接复用就可以了。」

① 卡片化（HomeCards 注册表 + 默认布局 + 取数）
   · TYPES 新增 'notif'（w4/h4，route=notifications，more=全部通知）
   · DEFAULT_LAYOUT 钉在 brief 之后，与 days 并一行（宽 4）——
     若插在 brief 与 agenda 之间，agenda/tasks 会被挤成一上一下（实测 C13 顶边 407 vs 751）
   · data() 加 case 'notif' → 新增 notifData()：最新 10 条 + 未读数，
     与原来的取数口径一字不差；关掉卡片就不查这两条 SQL
   · templates/home.php 删掉网格前那块写死区块（v30 第 5 条「必须在往年的今天前面」
     这条约束作废 —— 那时还没有卡片体系）；index.php 不再单独传 notifs/notifUnread

② 样式复用 templates/notifications/index.php
   · 结构与通知页完全一致：头像在前 → 正文 → kind 图标在右（带 ntf-kind-{kind}）
     （旧首页那块是"图标在前、头像第二"，正是用户说不好看的那一版）
   · 新增 .hc-ntf 作用域只补"卡片比整页小"的三条差异：正文允许折两行（宽 2 时
     单行省略会把正文全吃掉）、时间挪到正文下一行、未读数做小注脚
   · 不带每条右侧「删除」按钮（4×4 的卡里塞两个按钮会把正文挤成两三个字），
     删除在通知页做，卡片右上角有「全部通知」

③ 顺带修掉 v63 A1 抓住的一处：'notif' 的 mod 给 'home' 而不是空串
   （通知不在 Module::LIST，但它是首页自己的卡片；空串会让「全部通知」成为
   一排同色模块按钮里唯一白底 ghost 的那个）
   ⇒ TYPES docstring 立规矩：route 非空就必须有 mod，认不出归哪个模块就归 home

验证（familybook_push.sh 第 6 轮全绿，PUSH_RC=0，2h11m）
   v62 首页卡片 56/0 · v62 反向验证 14/0（新增 M8–M12 五条注入）
   b30 通知 16/0 · b30 反向验证 18/0
   v63 40/0 · v63 反向验证 51/0 · e2e 1523/0 · 部署静态断言空跑 RC=0

同批带上上一轮 v70/v71 的日历修复（已单独验过，本轮流水线一并回归）：
   · v70 日历导入后条目不显示：+N 条从纯文本 span 改成真按钮，点开是当天全部
     条目浮层；AJAX 新建后就地插入与服务端同形（回 entry，不让前端自己拼）
   · v71 ICS 导入顺序：主事件 → 覆盖行 → EXDATE 由 Calendar::importIcs() 统一保证
 2026-10-21 13:22:37 +08:00
laoyang 9a66068c33 v62：纪念日列表修正 / 分类图标与设置菜单 / 首页卡片体系 
- 纪念日列表：display:flex 从 td 移到内层 div（写在 td 上会破坏表格列算法，
  表现为关联人列与其它列高度不一致）；行内列序按表头对齐；
  改完再点「新建」不再带出上次修改的数据；文案改为「与我相关」「来自名册」；
  别人记的、把我挂成关联人的条目一并显示（split() 返回 hiddenIds，
  路由层据此过滤「接下来的日子」，与两张表同一套可见性）
- 分类图标：新增 app/AnnivIcon.php（17 个行内 SVG 图标 + 同 key 的 emoji
  供日历纯文本处使用，内网无 CDN 不用 FontAwesome）；去掉「看日历」按钮；
  设置按钮改为菜单，第一项进 days/settings 独立页；分类可自选图标，
  列表徽标与日历条目都按分类显示
- 首页卡片：新增 app/HomeCards.php 与 templates/home_cards.php；
  8 格宽 × 高 2/4/6/8；首页拆成 templates/home/_card_*.php 共 8 个片段；
  home/cards 可改尺寸、调顺序、开关
 2026-10-19 12:51:17 +08:00
laoyang ef574d82a4 v51b DAV 例外：时区换算 + RECURRENCE-ID/EXDATE/多 VEVENT 不再被丢 
根因三处（此前一个资源只能有一个 VEVENT、只认前 9 个字段）：
 · Ics::normalizeVevent() 固定 9 字段，没有 recurrence_id/exdate；
 · dav.php 只取 $list[0]（覆盖行全丢）；
 · calendar_events 没有对应列。

修法：
 · 时区 —— 带 Z / TZID 的值按 zone 换算成本地墙钟，浮动值不动；
   UNTIL 一起归一（必须与 DTSTART 同值类型/同基准）；DTSTAMP/CREATED/
   LAST-MODIFIED 仍按 RFC 保留 UTC。
 · 例外 —— 新增 calendar_event_overrides 卫星表（uk(event_id,recurrence_id)，
   FK CASCADE）存覆盖行；EXDATE 落既有的 calendar_event_skips（与网页端
   「只删这一次」共用）；PUT 的例外语义 = 权威替换。
 · 未建模属性（X-* 等）落 calendar_events.extra 原样回吐，
   表单保存不认识时不动它（防网页编辑抹掉客户端的 X-*）。
 · 「RECURRENCE-ID + STATUS:CANCELLED」折算成 EXDATE（RFC 5545 §3.8.4.4
   与 EXDATE 等价），并保留"正文里只有覆盖行"的退化路径。
 · ETag / ctag 必须含例外，否则只改「某一次」别的设备永远拉不到。
 · 网页月历 month() 认覆盖行（按新时间画、原时间不留影、不被 EXDATE 那天画）。

Schema 33 → 34（VERSION 人读 + fingerprint() 才是真正判据）。

验证：Ics 离线单测 30/30；端到端 DAV 例外探针 56/56；v45 既有回归 24/24。
反证：退回旧行为 → 6 条断言变红（网页上"已取消"的那次仍被画出来）。
 2026-10-15 20:19:09 +08:00
laoyang 1bf56b114b v49：条目浮层的「详情/编辑/删除」按**来源**分形态（三颗靠右 + 就地展开/编辑 + AJAX 删除） 
用户 2026-10-14 第 2 条。用户原话：
  「下面三个按钮，都放在下面的右侧…分别是详情、编辑和删除。详细用蓝色，编辑用黄色，删除用红色。
    点击详细的时候，**如果这是一个日程**（正常日程里的事件、不是来自观影/旅程等模块）
    → 就**在当前页面让模态框变大**、显示更多信息。
    点击编辑，也是**在当前的界面**弹出编辑日程的框，就地编辑；编辑完之后下面两个按钮：取消和保存。
    点击删除，就直接把这个日程给删除。
    如果当前这个日程**来自其他模块**（观影 / 旅程 / 其它）→ 点击详情就**进入那些模块**展示它。
    **这种情况下，下面就没有编辑、也没有删除，就只有一个详情。**」
拍板：① 应用范围 = 首页日程 + 日程页条目（首页近期任务保持 v43 现状）；
      ② 重复日程删除 → 弹三档范围（这一次 / 这一次及以后 / 全部）。

实现（7 个文件）：
 · app/helpers.php  fb_entry_json() 扩契约：source('event'/'derived') / ref / del / info /
   repeat / occ。判据 `kind==='custom' && ref_id>0`（**不是**"有没有 edit"）。
 · app/Calendar.php  month() 给自定义条目带 _can_write（供 del 判定）。
 · templates/_entry_popup.php  底栏重构成「右侧按钮组 + 7 颗」：详情态三颗、
   编辑态两颗（取消/保存）、删除范围态两颗（取消/确认删除）；另加一颗
   **遮罩层里的 CSRF**（正文会被整块换掉，放正文会丢）。
 · assets/js/entry_popup.js  四态状态机（detail/info/edit/delscope），按 source 决定显哪几颗。
 · assets/css/app.css  .fb-entry-acts（margin-left:auto 靠右）+ fb-a-detail/edit/del 三色
   + .is-wide（620→860px）。⚠️ 全是**作用域类**，不动全局 .btn-edit/.btn-danger 的语义。
 · index.php  新增 calendar/event?embed=detail（只吐只读详情块）；
   calendar/event_del **认 X-Requested-With 回 JSON**（$done() 收口，失败也回原因）。
 · templates/calendar/event.php  支持 $evDetail（只吐 kv 只读块，与可写与否无关）。

本轮修掉两个真 bug（都是"藏不掉"）：
 ① `.btn{display:inline-flex}` 是作者样式，**盖过 [hidden] 的浏览器默认**
    ⇒ 底栏四态切换时前面的按钮收不起来、全挤在一条上（派生条目本该只有「详情」，
      实测三颗都露着）。⇒ 显式写 `.fb-entry-acts .btn[hidden]{display:none!important}`。
      本项目文件前部已有同款注释（.pick-row[hidden] 等），属第 N 次同类。
 ② `footShow('detail')` 把三颗无条件点亮，**盖掉** paintDetail 按来源设的 hidden。
    ⇒ detail 组只列「详情」，且 paintDetail 里**先 footShow 再设 edit/del**（顺序写进注释）。

验证（新增 2 个套件）：
 · _fb_v49_entry.py（33 条真机断言：三颗靠右/配色/派生只有详情/详情就地变宽/编辑就地/
   删除落库/日程页入口/重复弹范围）
 · _b49_falsify.py（**10 注入 / 21 断言全抓**）
 · 更新 _fb_b43_ui.py 旧断言（「详细信息」→「详情」；自定义日程的详情语义从"跳页"改"就地展开"）
 · familybook_deploy.sh 加 v49 静态断言段
 · 全量 e2e / vCard / 几何 / 各批反向验证全绿；部署脚本 0 FAIL（含"第49批形态"）；
   线上 7 个文件 md5 与本地逐字节一致；线上门禁诊断 13 项全 YES，临时页已删并复验 404

⚠️ 反向验证抓到一条**假绿**（值得记下来）：注入「给派生条目也塞 del」时探针**没变红** ——
   因为按钮显隐是 `source` **且** `del` 的多条件"与"，只塞 del 在界面上显不出来。
   ⇒ 补一条**数据层**断言（直接读 data-fb-entry 的 del 必须为空），两层判据都在。

⚠️ 末段唯一"失败"是沙箱的安全删除门禁（SAFE_DELETE_BULK_CONFIRM_REQUIRED，按轮次累计、
   本轮流水线删超 50 个文件）：单独重跑 _fb_v46_carddav.py 是 **29/0**，与环境有关，与本次改动无关。
 2026-10-14 19:05:13 +08:00
laoyang 32e9e9ab84 v47：地址联想三处接入 / 读书页慢的真根因（会话锁）/ 笔记两处 / 日程状态下线 
用户 2026-10-13 七条。拍板：影院只记地址、不存经纬度（后续用高德反查）；
日程状态只删界面与展示、数据库列保留（「后续会有一个整体清理的工作」）。

①🔴 读书页慢 —— 真根因是**会话锁**，不是封面（我先判断错了方向）
  用户原话：「读书现在还是非常慢，就是进入读书这个页面，刚开始还是非常的慢。」
  线上实测（真公网、同一会话连打 3 次）：
      第 1 次 TTFB 0.08s  ← 触发微信读书同步
      第 2 次 TTFB **8.73s**  ← 用户说的"刚开始非常慢"
      第 3 次 TTFB 0.07s
  插桩拿到的服务端时间线把因果钉死：
      21:18:05.483 QUEUED        ← 第 1 个请求排队
      21:18:05.501 FINISH  2ms   ← 响应确实提前发出去了（这步是好的）
      21:18:14.674 SYNC    9.2s  ← 但它仍占着这个人的会话文件锁跑完 9.2 秒
      21:18:14.682 QUEUED        ← 第 2 个请求此刻才真正开始执行
  ⇒ **`fastcgi_finish_request()` 只断开客户端连接、不释放 PHP 文件会话锁。**
    后台同步要 9.2 秒（真打微信读书接口），同一个人的下一个请求一路等到它跑完。
  修法（缺一不可）：
    · `WeRead::queueBackgroundSync()` 回调里 **先 `session_write_close()`、
      再 `fastcgi_finish_request()`**（顺序不能反）；
    · `index.php` 两处"渲染前排同步"的入口排完**立刻放锁**
      （shutdown 回调不一定执行：客户端中断/服务器超时才不放过）；
    · 顺带修 **`Holiday::queueBackgroundFetch()` 的同型问题**（联网 12 秒）。
  为什么以前没发现：v29 引入"后台化"时只验证了"响应是不是提前发出去"，
  **单次请求测量永远看不到这个 bug** —— 必须同一会话连打两次才现形。
  线上复验：修复后连打 4 次 = 0.15 / 0.15 / 0.09 / 0.15 秒（修复前第 2 次 8.73s）；
  后台同步仍正常（`weread_sync_at` 已更新）。

② 封面：顺手也修了（但这不是用户说的那个问题）
  · `media.php` 读 OSS 前先放会话锁（原来从不放，35 张封面串行）；
  · 新增 `Storage::cacheLocally()` 磁盘二级缓存（原来 `read()` 只读不写回）；
  · 让 304 不再先拉整张图（原来先取回 body、再判 `If-None-Match`）。
  线上实测：冷取 149ms（走 OSS）→ 热取 35ms（本地缓存、字节一致）
  → 带 `If-None-Match` 返回 **304 / 19.8ms / 空体**；35 张封面 103ms → 20ms（5 倍）。

③ 地址联想：抽成全站共用一份（`assets/js/addr_suggest.js`）+ 接入三处
  · 影院管理页、观影新增页的「新建影院」弹框、日程地点、行程出发/到达；
  · `layout.php` 按需加载（`[data-addr]` 出现才拉 SDK + 我们的脚本），
    并暴露 `fbLoadAddr(scope)` 给 AJAX 片段（v42 踩过"内联 script 不执行"）；
  · 安全密钥在 SDK 之前设置；回填支持 `data-addr-fill` / `data-addr-for`、
    **只补空白字段**（不覆盖用户手写）、直辖市 `province==city` 去重；
  · 字段名有两套（影院 `address`/`place`，行程 `from_addr`/`to_addr` 缩写 `_addr`），
    `fieldFor()` 带同义词表 + 后缀匹配；
  · 影院**只存地址、不存经纬度**（按用户要求）。

④ 笔记两条
  · 「点保存没反应」真因：附件区是个 `<form>` **套在保存表单里** ——
    HTML 不允许 form 套 form，浏览器丢掉内层标签、保留它的 `</form>`，
    于是**保存按钮成了孤儿**（`button.form === null`），点了不提交也不报错。
    真浏览器实测：修前 `btnInsideForm:false` / 点后 POST=0；修后 true / POST=1。
    改法：附件区改 `<div id="noteAttForm">`，上传按钮用 `formaction`。
  · 详情页宽度：`.note-read { max-width: 820px }` → `none`
    （内容卡 820px vs 下方共享卡 1032px；修后两者都是 1032px）。

⑤ 日程状态下线
  · 删表单里的「状态」下拉、`Calendar::statusWord()`、浮层 JSON 的 `status_word`；
  · **保留** `events.status` 列与 `Calendar::statusOf()`（契约不动，等整体清理）。

验证（新增 5 个套件）：
  · `_fb_v47_addr.py`（接线 24 条）/ `_fb_v47_addr_sim.py`（真浏览器 + 假高德，16 条）
  · `_fb_v47_readperf.py`（缓存与会话锁，23 条）
  · `_fb_v47_notes.py`（真浏览器，9 条）
  · `_b47_readperf_falsify.py`（反向验证 9 个注入）—— **9/9 全抓住**
  · 全量 e2e **1510/0**；vCard 规格+往返 40/0；TB 探针 44/0；
    v44 反向验证 17/0；全流水线 **PUSH_RC=0**（含"第47批形态"静态断言）
  · **线上终验**：读书页整页 81ms、封面 103→20ms、media 冷 149→热 35→304 19.8ms、
    修复前第 2 次请求 8.73s → 修复后 0.15s、地址联想 meta[fb-addr] 带真高德 key

顺带修掉三处**探针自身**的假红/假绿（详见 pitfalls.md）：
  · `_b44_falsify.py` 的"整小时"注入在**整点**与正确实现等价 ⇒ 换成恒错值；
  · `_fb_b44_ui.py` 3b 的并发计时断言在单进程 `php -S` 下必然假红 ⇒ 改断言确定事实；
  · 多处探针的"清理删除"撞沙箱删除门禁 ⇒ 探针**中途死掉**看起来像产品坏了
    ⇒ 统一改成 `_safe_rm()` / 不删。
 2026-10-14 01:20:40 +08:00
laoyang 8c651b43eb v43 第 43 批：六条反馈（界面 5 + 条目详情浮层） 
用户 2026-10-11 反馈六条，逐条定位真根因后修复：

① 纪念日「日期」多出一个控件 —— 只保留最新的那个
   两层根因：（a）原生 `input[type=date]` 当初没包在 `.dt-native` 里，
   v42 那条"AntD 挂上后收起原生框"的选择器根本不命中；（b）更要命的是
   `.dt-native` 基类写着 `display: contents` —— 该元素**没有盒子**，
   给它 position/width 完全无效 ⇒ 必须把 display 显式改回 block 才收得起来。

② 编辑纪念日把底层列表页弄没 —— 「修改」原来是整页跳 `days/edit`
   （套 layout = 一张只有弹框的空白页）。改为 `?embed=1` 只吐弹框那一块，
   列表页 JS 取回来替换 `#anNewCard` 并打开 —— 与「新建」同一观感。
   内嵌形态标 `$anModalOnly` 以免打 standalone 标记（关闭时不再跳页）。

③ 拖图裁剪的层被弹框盖住 —— `.crop-overlay` 是 z-index:100 而 `.cal-modal`
   是 200 ⇒ 裁剪层被整块盖住。提到 260（与 v41 的 .cn-modal 同一处理）。

④ 行程弹框里"参与的人"弹不出选人框 —— person_picker.js 只绑定一次，
   而弹框表单是 AJAX 片段 ⇒ 里面的 `.pp` 从未被 init。三件事一起：
   暴露 `window.fbInitPickers()`（幂等）+ layout 暴露 `window.fbLoadPicker()`
   （脚本是按需加载的）+ 塞完片段后补调初始化。

⑤ 日程新建排版/控件/文案 —— 改走观影式 `.mv-grid`（标签对齐 + 冒号）；
   起止补上 `$dtPlugin='antd'`（试点正式推广到日程）；标签「时间范围」→「开始 / 结束」；
   删三句提示（结束留空 / 多选提醒 / 全天）。

⑥ 条目详情浮层（首页日程 / 首页近期任务 / 日程页条目）——
   点条目不再直接跳页，弹浮层显示详情；「详细信息」跳该来源详情页；
   「编辑」就地换成该来源的编辑表单（四处 `?embed=1` 片段）。
   新增 `templates/_entry_popup.php` + `assets/js/entry_popup.js` +
   `fb_entry_json()`（三个入口共用一个编码函数）。

验证：php -l 157 文件全过；div 深度 33 组合全配平；片段体检 20 片段无越界；
本地 e2e 1510/0；v43 真机 33/0；v43 反向验证 8/0；v38 36/0；v42 33/0；
b31/b32 反向验证 8/0 与 5/0；部署断言本地空跑 RC=0；完整流水线 PUSH_RC=0。
 2026-10-12 00:24:20 +08:00
laoyang df6fe894d0 v32 第 32 批（4 条）：资源共享弹框真落库 / 消息通知覆盖全部共享入口 / 浏览器通知（站内消息+日程到期提醒） / 首页任务随看板色 
用户原话：
①「资源共享功能有问题，弹框中，点击共享给某个人后，弹框消失，但是并没有共享成功。」
②「消息通知，在所有引用自己的地方，都通知，包括别人分享了日历本给自己，
   分享了笔记给自己，分享了资源给自己等等。」
③「当有消息通知时，还有日历中日程到期提醒时，比如一个日程，设置了10点开始，
   提前十分钟提醒，则需要在 9:50 时浏览器中发提醒通知。」
④「首页，近期任务，任务的文字和前面的圆点，颜色并没有跟看板颜色一致，这个需要修正。」

四条真根因：
① v28 把资源编辑改成三页签后，每个页签各有自己的 form 与 <input name=id>，
   而设 id 的代码是 panel.querySelector() → 只命中文档序第一个（info 的 update），
   ⇒ share/att 表单的 id 恒空 ⇒ 提交 id=0 ⇒ Resource::find(familyId,0,me) 返回 null
   ⇒ 静默不共享。修：表单打 data-res-idform 标记 + querySelectorAll 逐个填。
② v30 只在 saveAttendees 后调 syncForTarget，6 个共享入口一个都没接。
   新增 Notification::syncShares(家庭,类型,宿主id,动作人) —— 照共享表现状重建差额
   （写表后调用；漏调只会没通知，不会状态不一致）。SHARE_KINDS 抽常量。
③ 完全没有浏览器通知。新增 Calendar::remindersBetween()（窗口留 -2 分钟防后台节流）
   + ?r=notifications/poll JSON 路由 + assets/js/notify.js（轮询 + Notification API
   + id@at 去重）+ 顶栏铃铛（权限只能用户点一下才要，自动申请会被 Chrome 静默拒绝）。
④ v30 把用户那句和主题颜色一样理解成了**任务模块主题色**，用户要的是**看板色**。
   新增 Task::boardColorById(家庭,看板id)（没设色按看板名派生稳定色），home.php 两处改 $tkColor。

验证：诊断探针 18/0、真机 25/0（真点共享→库里真的多一行；三类共享真发通知；
9:50 窗口真算出 10:00 那条；首页每条任务色 == 其看板色）、反向 5/0、
e2e 1502/0、升级 153/0、几何 428+680+92、城市 32/0。
部署脚本静态断言段本地空跑通过；线上站点自检 19 条全过，notifications/poll 未登录 302。
 2026-10-09 07:25:08 +08:00
laoyang be582569dd v31 第 31 批：DAV（CalDAV/CardDAV）同步修复 —— 发现链缺失 + ETag 潮汐 + 资源重复 
用户原话：「carddav 和 caldav 好像都不好用，没有任何数据被同步出来。
同步的客户端，在 D:/Yongquan/code/SyncCalendar 中有，你可以用这个里面的代码试试同步一下。」

三处真根因**全部靠实测**拿到（不是"看代码猜"）：写了 _fb_dav_diag.py，
逐字复刻 SyncCalendar 的 DavClient 请求序列（PROPFIND/REPORT/GET + 它那几个 XML 体），
打线上一次就复现出用户症状（15 条失败），修完线上 28/0。

1. 发现链（discovery）**整段缺失** ← 这就是"没有任何数据"的根因
   标准客户端（DAVx⁵ / iOS / SyncCalendar）建账号按 RFC 6764 走：
     GET /.well-known/caldav → 302 到 /dav/        ← 原来 404（落到 index.php 去登录页）
     PROPFIND <上下文路径> → current-user-principal ← 原来回的是"日历本清单"，没有 principal
     PROPFIND <principal> → calendar-home-set       ← 原来没这个属性
     PROPFIND <home> Depth:1 / <book> / REPORT      ← 这两步一直是通的
   ① 就断 ⇒ 客户端**在填完账号点保存那一刻**就失败，一条数据都拉不到。
   为什么历次验收全绿：上批只验了 PROPFIND /dav/ 与 /carddav/ —— 恰好是**一直通**的那两步，
   断点在其**前面**，从来没被测过。
   改：两个入口补 PRINCIPAL_PATH/HOME_PATH + /.well-known/* 301（**在鉴权之前**）+
   根/principal/列表三处都给 current-user-principal。.htaccess 用**独立标记块**追加
   well-known 重写规则（本仓库第 4 次"独立入口必须独立块"）。

2. DTSTAMP 取 time() → ETag 潮汐（增量同步**永远不收敛**）
   App\Ics::stampOf() 原为"没给时间就 time()"，而**派生条目**（观影/行程/生日/农历/
   节假日/节气）没有 updated_at/created_at ⇒ 每生成一次 ICS 就写一个新"现在" ⇒ 正文变
   ⇒ ETag 变。线上实测：同一本连续两次 REPORT **每一条 ETag 都不同**，整本 GET 的 ETag
   也在变 ⇒ 客户端把"增量同步"退化成"每轮全量重拉"，且拉回来的对不上、永远不收敛。
   改：缺时间写固定值 19700101T000000Z（确定优先于"诚实的当前时间"）。

3. 派生本把"日历视图条目"当"CalDAV 资源"
   Calendar::exportRows() 对派生本按**日历视图**取数（重复日程展开 N 次、跨天逐日、
   生日/农历逐日派生）。线上 /dav/1.ics/ 实测 **2981 个 response / 只有 196 个不同 href**
   （anniv-0_familybook.ics 自己重复 **2399** 次）。CalDAV 的资源是**一个 .ics 文件** ⇒
   客户端要么把同一条反复入库，要么判定服务器异常而中止本轮同步。
   改：CalDav::resources() 按 **UID 去重**（资源名本就是 UID）。

4. 连带两个真 bug（同一段代码顺出来的）
   · exportRows() 派生分支**没按本过滤**：month() 里"任务""纪念日"两段不带 kind 判断
     （它们 cal=0）⇒ 取"观影本"会把全家所有生日一起带出来（2981 条里绝大多数是 anniv）。
   · CalDav::parsePath() 的 $event=(int)$evSeg：派生资源名（movie-100_familybook）
     (int) 后全是 0 ⇒ 单条资源请求被当"整本"，GET /dav/4.ics/lunar-...ics 实测回 **400 条**。

5. 顺带补全：系统日历本（农历/节假日/传统节日/节气）原来**导出是空的**
   它们只走派生、没有 calendar_events 行，而 exportRows 只认 custom/movie/trip ⇒
   手机上订阅这几个本一条都没有。改：按 [今年-1, 今年+5] 派生（**封顶**，农历每天一条，
   130 年会有 4.7 万条）。实测耗时 lunarRange 31ms / traditional 51ms / Anniversary 30ms。

改：.htaccess、router.php、dav.php、carddav.php、app/CalDav.php、app/CardDav.php、
app/Calendar.php、app/Ics.php、templates/settings/me.php（补"或只填服务器地址"的提示）。

验证（全部 0 失败）：DAV 探针 28/0（**线上修前 15 失败 → 修后 28/0**，同一套探针两处都跑）、
DAV 反向验证 8/0（7 处修复各自改回旧行为，断言全变红）、e2e 1478/0、升级 153/0、
城市 32/0、几何 428/0 + 移动 680/0 + 交互 92/0、b24 41/0、b27 34/0、b28 39/0、b29 38/0、
b30_import 26/0、b30_ui2 16/0、b30_notify 23/0；部署静态断言新增 12 条守卫并逐条证伪通过。
线上 7 个文件 SHA256 与本地一致；/.well-known/caldav→301 到 /dav/ 实测生效。

⚠️ 本轮在部署脚本上真踩到并修掉两个坑（已写进 pitfalls.md）：
   · router.php **不发到线上**，把它写进部署断言 → grep "No such file" → 部署中止在
     "改了一半"的状态（迁到 push.sh 第 1 段）。
   · `set -euo pipefail` 下 `X=$(... | grep -c ...)` 在 **0 匹配**时退出码 1 ⇒
     **整个脚本静默退出**（不打 FAIL，日志停在上一行）。已给全部 7 处补 `|| true`。
 2026-10-08 20:05:01 +08:00
laoyang 2a10df2557 v30 后半（5 条）：导入框选中反馈+单选 / 首页日程改色块 / 近期任务主题色 / 时间冲突错开 / 通知消息模块 
用户 2026-10-08 第二批 5 条。

1. 导入日程选中文件后没有任何反应 + 不允许多选
   `_stage_drop.php` 现在有两种模式：暂存型（附件，拖进来即刻上传）与导入型
   （`$sdStage=false`，写回 input.files、随表单提交、PHP 读完即弃）。
   暂存型框靠 queueDrop 画缩略图，而**导入型框选中文件后什么都不显示** ——
   框里那句「点击或拖动进行上传」从头到尾不变，用户看不出"到底选上没有"。
   改：app.js 新增 bindFileEcho()，只给**非暂存框**补 change 监听，
   选中后框里的话换成文件名 + 图标变 ✓ + `.upbox.is-picked` 稳定态；
   取消选择则还原原始文案（不是空字符串）。单选由 `$sdMultiple=false` 保证。

2. 首页「今天的日程」用色块表示，和日程保持一致
   原来那套是"白底卡片 + 左边一条 3px 色线"，色只占一条线，看不出是哪个日历本。
   改：与日历页 `.tg-block` 同款实心色块（底色=日历本色，白字，圆角，无阴影），
   left/width/top/height 全部由内联给出（冲突分列 + 真实时长）。
   ⚠️ `.ag-ev` 的 CSS 里去掉 `right` —— 绝对定位下 left+right+width 三者同时存在是
      过约束，内联 width 会失效（冲突就不会错开了）。

3. 首页「近期任务」名称与圆点走任务模块主题色
   原来用 `var(--brand)` —— 那是**当前页面**（首页）的主题色，不是任务模块的；
   用户改过模块配色时两者不一致（首页砖红、任务别的色），正是他看到的"不一致"。
   改：两处都走 `--tk-c`（= Module::color('tasks')），与右上角「全部任务」按钮同源。
   逾期仍用红色（状态语义，不能被主题色盖掉）。

4. 日程时间冲突错开（算法借鉴 SyncCalendar）
   用户指定去读 SyncCalendar 的算法。落地自
   `entry/src/main/ets/common/TimelineUtil.ets` 的 build()/groupsOf()：
   ① 划分冲突组（与组内最晚结束仍重叠就并入）；② 组内贪心分列（区间图着色），
   列数 = **每组各自的最大同时重叠数**（sync 原注释点名的反例：传递性重叠但
   B/C 不重叠 → 只该 2 列）。落成 `App\Calendar::conflictLanes()`（PHP，判据一字未改）。
   ⚠️ 两处比原算法更细，都有单测钉住：
     · 列数按**组**算 —— 否则一个孤立日程会被别处的三方冲突连累成 1/3 宽；
     · "缺结束时间"不能一律按 30 分钟参与冲突（会与后面所有日程假冲突），
       改为优先拿**同列下一条的起点**当它的视觉结束 → 因此必须**先分列再算高度**。
   首页与日历页共用同一套（用户第 2 条要求"和日程保持一致"）。

5. 通知消息模块（Schema v30 → v31）
   不在导航显示，入口在头像下拉里、**排在个人设置之前**，名字「通知消息」；
   有人在观影/旅程加我时发通知；通知出现在首页、**往年今天之前**。
   新增：app/Notification.php + notifications 表（唯一键
   (person_id,target_type,target_id) —— 参与人是整组替换，没有它改三次标题就收三条）+
   ?r=notifications{,/del,/clear} + templates/notifications/index.php + 头像下拉未读角标 +
   app/helpers.php 的 fb_time_ago()。
   ⚠️ 三条设计判断：不进 Module::LIST（进去就会被顶栏渲染、被"模块显示与排序"当开关）；
      只在 person_id !== actor_id 时发（不给自己发，"通知"≠流水账）；
      移出参与人**撤销未读**、**保留已读**（未读是没送达的提醒，已读是看过的历史）。

验证（全部 0 失败）：e2e 1478/0（+14 条新断言）、升级 153/0、vCard 40 项、城市 32/0、
几何 428/0 + 移动 680/0 + 交互 92/0、b24/b27/b28/b29 真机全绿；
冲突分列算法单测 12/0（含 SyncCalendar 点名的反例）、
新探针 _b30_ui2 16/0 + _b30_notify 16/0 + _b30_import 26/0、
反向验证 18/0（五条各自改回旧行为 → 断言全红）、
部署脚本新增 9 条守卫 + 守卫证伪 11/0。线上 11 文件 SHA256 一致，Schema v31 已升级。
 2026-10-08 17:41:30 +08:00
laoyang 41572b77e7 第 21 批收尾：按需补「我的日程」本（老库也能拿到） 
线上实测发现第一版没覆盖到的情况：把 'custom' => 「我的日程」加进
`Calendar::DEFAULT_KINDS` **是不够的** —— `seedDefaults()` 只在
**安装**与**结构升级**两条路径上被调用，而线上这套库早就升完级了，
于是老用户永远拿不到那一本。线上实测：owner=1 可写的普通本 0 本
（唯一那本 custom「工作」是用户自己建的）。

后果不只是"少一本"：新建日程的"放在哪本"里全是派生本、默认还选中排最前的
**观影** → 用户直接打字点「加上」，建出来的是一条**观影记录**（建错东西，
事后极难发现：日历里看着是多了条日程，观影列表里莫名多一条）。

修法：
- 新增 `Calendar::ensurePersonalBook()` —— 按需补，幂等判据是
  `owner_id + kind='custom'`（**刻意不看名字**，否则用户把自己的本子改名之后
  会又冒出一本「我的日程」）。
- 由 `calendar` 路由在打开日历时顺手调一次（一次请求只多一条 SELECT）。
- 模板里再兜一道：默认选中的不是可写普通本时显式提示
  "你还没有自己的日程本，上面选的是一本派生本（加进去会变成观影/旅程记录）"。

验证：e2e **1064/0**（新增 5 条：删本 → 打开日历自己补回来 → 名字对 → 幂等 →
改名后也不会又冒一本）；线上以 Web 用户(www)身份实测 before=1 after=1
（正确幂等，不动用户自己那本）；真机探针 75/0 · 桌面几何 428/0 · 部署自检 0 失败。

⚠️ 测试侧顺带记一个坑：夹具删"有日程的本子"时 `calendar_events.calendar_id`
外键是 **RESTRICT**，而用**多语句** `mysql -e "SET FOREIGN_KEY_CHECKS=0; DELETE...;"`
时一旦有一句被挡下，**整个 -e 静默失败**（返回码 0、无 stderr），
症状是夹具自检报"还有 2 本"、后面断言一路红，单独手跑同样语句却是通的。
改成**一条一条发并检查返回码**后就好了。
 2026-10-06 13:44:24 +08:00
laoyang f0437e6c93 v24 第 21 批：无刷新删除与新建日程 / 实际行程不回退 / 行程按时间排 / 统一上传框 / 时间范围控件修复（用户 8 条） 
用户 8 条原话要点：
  ①「名册页面，删除一个联系人后，能否不刷新页面，删除成功后，直接把这个人，
     从当前页面的 dom 中删除，页面保持不动。」
  ②「观影模块，海报和票根以及照片都带进来了，但是没有缩放，把页面撑破了，
     应该缩放成缩略图。」
  ③「个人设置页面，天气设置那里，把：只影响你自己首页上的那一格 / 填个城市名就行
     （如「青岛」）… 这些提示，都删除。把城市单独放一行，精度维度放在一行。」
  ④「旅程模块，实际行程编辑后，点击保存，竟然又变成计划行程了，这个不合理，
     实际行程永远是实际行程，不会再变回计划行程了。」
  ⑤「旅程模块，旅程列表，行程列表，都是按照行程的开始时间排序的，最新的在最上面，
     而不是按照编辑修改时间。」
  ⑥「旅程的详情页面，右上角的按钮，设置在最右侧，和其他模块保持统一。」
  ⑦「所有上传图片等附件的地方，都不再放按钮，而是放一个框，点击这个框实现点击上传
     按钮的功能，拖动图片进这个框里，实现拖动多个上传功能。框里面写一句话：
     点击或拖动进行上传，其他的功能和现在保持一致。」
  ⑧「日历中新建日程，无论是点击按钮还是点击日历中间，都是采用弹框的形式进行添加，
     这样不影响当前日历的显示，添加完成后，动态修改当前视图，不要刷新。添加日历日程，
     开始时间和结束时间那里，用我们统一的时间范围选择器重做，现在功能无法使用。
     选择日历本，带上颜色。」

🔴 五个真根因（全都不像 bug）：

 ① 🔴 **④「实际行程变回计划」= 表单字段同名合并**（本批最要紧的一条）
    暂存上传的令牌字段原叫 `stage[]`，与行程表单里那个隐藏的 `stage`（plan/actual）
    **同名**。PHP 解析表单时同名会**合并进同一个键**：
        `stage=actual` + `stage[]=tok` → `$_POST['stage'] = ['actual','tok']`
    （`[]` 只是"往同一个键追加"的记号，**不构成另一个键名**。）
    于是路由里 `(string)($_POST['stage'] ?? 'plan')` 得到 `"Array"` →
    `in_array('Array', ['plan','actual'])` 为假 → **静默回落成 'plan'**。
    ⚠️ 只有"拖过图片的行程"会犯（没拖就没有 `stage[]`）→ 症状是"时好时坏"。
    修法：令牌字段改名成 `stage_token[]`（改的是**字段名本身**，不是"是数组就取第一个"
    绕过去 —— 同名合并是 PHP 的表单语义，绕过去只会把坑留给下一次加字段）。
    **另加一道语义保险**：编辑路径**一律沿用库里那条自己的 stage**，不读表单 ——
    编辑表单里根本没有改阶段的控件（改阶段走详情页那几个显式动作）。
    这样即便将来又冒出某个字段名冲突，也不可能把「实际」悄悄变回「计划」。

 ② 🔴 **⑧「时间范围选择器无法使用」= 三道门叠在一起**
    ① `_event_fields.php` 的**结束端默认带 `hidden`**（要点「+ 添加结束时间」才出现）；
    ② `app.js` 的 `upgradeRange()` 有「**两端都得可见**才升级」的判断 → 永远不成立
       （实测 `data-semi-range-done` 恒为 `null`）；
    ③ CSS `html.js .dt-range:not(.is-semi-range) .dt-input { visibility: hidden }` →
       未升级时原生控件**也是不可见的** ⇒ 屏幕上一片空白、点哪儿都没反应。
    修法：两端**始终可见**（"没有结束"由清空后半段表达，不再靠开关）；
    并把旧的「+ 添加结束时间 / 去掉结束时间」开关整套删掉。
    ⚠️ 顺带挖出：`upgradeRange()` 里 `group.insertBefore(host, a)` 在"两端各自被
    `.field` 包着"时 `a` 不是 `group` 的子节点 → 直接抛
    `Failed to execute 'insertBefore' on 'Node'`。这个异常**以前从没触发过**
    （被 ② 的提前 return 挡住了）—— 一旦放出来就炸。修成插在"端点最外层包装"之前。
    ⚠️ 观察器加了 `attributes: true, attributeFilter: ['hidden']`（并把 childList
    分支的 `return` 去掉）：弹框/折叠面板/tab 里"稍后才露出来"的日期控件从此都能自动升级。

 ③ 🔴 **⑧「新建日程默认建出观影记录」= 产品缺口，不只是显示问题**
    `Calendar::DEFAULT_KINDS` 原来只有 6 本**派生**本（观影/旅行/农历/节假日/传统节日/
    节气），**一本可写的普通本都没有**。于是"放在哪本"里全是派生本、默认选中排最前的
    **观影** → 用户直接打字点「加上」，建出来的是一条**观影记录**
    （日历里看着是多了条日程，观影列表里莫名多一条）。这是"建错东西"，事后极难发现。
    → ① 默认本补成「我的日程」(kind='custom')，模板里默认选中也改成**优先 custom 本**；
      ② 选择器里把**纯派生只读本**禁用并标「（自动生成）」
         （直接不列会让人以为本子丢了；列为可选又会白选一次再吃错误）。
    ⚠️ 顺带发现 `Calendar::READONLY_KINDS` 把 `movie`/`trip` 也算进去了，而
    `event_add` 里**紧跟着**就有两段专门处理它们的分支（「已加进观影」/「已加进旅程」）
    —— 那两段**永远走不到**（校验先一步把请求打回去了）。判据要按**能不能写**分，
    不是按"是不是派生"。

 ④ 🔴 **②「观影编辑页图片撑破」= `.mv-slot` 这个类在样式表里根本不存在**
    第 21 批加模板时只写了结构没写样式 → `<img>` 按**原始像素**渲染：600×900 的海报
    在 236px 宽的格子里撑出 942px 高，还把整页横向顶破（实测 docW 1297 > vw 1280）。
    → 补 `.mv-slot` 规格：固定 108×162 缩略图 + `object-fit: cover`。
    ⚠️ **高度必须写死** —— 不写死就又会由原图比例决定，等于没修。

 ⑤ **⑤行程列表排序 = `category, position` 主导**
    `position` 默认同一个数（旧迁移给的多是 0/100），于是顺序被 position 挤乱。
    实测线上 #222 渲染成「返回青岛(10-5) → 出发去菏泽(9-30) → 去姥姥家(10-2)」。
    → 改成 `ORDER BY (starts_at IS NULL), starts_at, id`。
    ⚠️ 方向是**正序**（早的在前，已跟用户确认）；旅程列表仍是 DESC（最新在最上）。
       两者方向不同是**刻意的**：一个是"挑哪趟旅行"，一个是"读这趟旅行的行程"。
    ⚠️ 详情页**按阶段分三组**渲染（计划/实际/未成行），排序只需在**组内**有序。

本批新增能力：
- **统一上传框**（⑦）：`templates/_stage_drop.php` 现在**同时**负责
  「sr-only 的真文件框 + 看得见的上传框 + 暂存清单」，调用方只 require 一行。
  框是 `role="button" tabindex="0"`，JS 转发 `input.click()`（键盘 Enter/Space 也通），
  拖文件进框走既有的暂存上传（拖一个立刻传、可续拖、失败标红、未传完拦住保存）。
  ⚠️ 框用 `<div>` 不是 `<button>`：里面要放暂存清单（含「撤掉这张」按钮），
     按钮里嵌按钮是非法 HTML（第 21 批刚在 `<form>` 嵌套上栽过同一个跟头）。
  ⚠️ 文件框用 `.sr-only` 不是 `display:none`：后者不可聚焦，带 `required` 时
     Chrome 会报 "An invalid form control is not focusable" —— 点了什么都不发生。
  落了 11 处：行程照片 / 观影海报·票根·合影 / 资源 / 任务 / 日程附件 / 书籍 /
  联系人导入 / ics 导入 / 观影补传 / 资源补传。
  ⚠️ 清单与提示行移到框**外面**（放框内会变成"一个大框套五张图"），
     所以 app.js 改从 `.upfield` 容器里找它们。
- **无刷新删除（①）与无刷新新建日程（⑧）**：路由按 `X-Requested-With`
  （或 `Accept: application/json`）区分调用者 —— 带它回 JSON、不带照旧 302
  （无 JS 的兜底**不变**，两边的反向都写了断言）。
  · 名册删除：成功 → 摘卡片 + 就地改「共 N 人」与分组人数 + 派发 `input` 让
    filter.js 自己重算（**不抄它的判据**）；失败 → 把原因说出来（不刷页）；
    拿不到 JSON → **退回原生提交**（绝不静默失败）。
  · 日历新建：JSON 带齐前端插入当前视图要用的字段（时间/颜色/链接/是否全天/cal）。
    月视图**按时间插入**（不能 append —— 服务端只渲染前 3 条、按时间序取，
    append 会让"新加的早间日程"掉进「+N 条」里看不见，刷新后又跑到第一位）；
    周/日视图按"24h = 100%"算 top/height 插块。
  · 观影 / 旅行本是**可写派生本**：AJAX 时不再跳详情页（跳走就离开了日历），
    改在提示行给一个「去看详情 →」链接。
- **⑧日历本带颜色**：原生 `<option>` 画不出色块（浏览器不允许在 option 里放元素），
  所以做成「色块 + 下拉」并排，色块跟着当前选中的本子变色。
- **③天气卡片**：三句提示全删；城市单独一行、纬度/经度同一行（`.loc-row`）。
  删的只是说明文字，三个输入框 + 保存 + 状态回显都保留。
- **⑥设置按钮贴最右**：原来顺序是「… → 设置 ☰ → 删除 🗑」，设置被删除键挤到**倒数第二**；
  改成删除在前、设置恒为最后一个（与观影/日程/任务/资源同一个手势）。

验证（本地全套）：
- e2e **1059/0**（本批新增约 40 条断言）· 结构升级 149/0 · 桌面几何 428/0
- **真机探针 75/0**（`_fb_b21_ui.py`）：AJAX 删除真的没导航 / 卡片真被摘掉 /
  滚动位置保持；缩略图几何（108×162，不再溢出）；上传框（框在、原生框不可见、
  点框真打开文件选择框、连拖两张都上去且清单可见）；日历弹框（打开时网格一动不动、
  范围控件真的挂上且可见、能弹面板、色块跟着换、无刷新提交后当前视图里立刻出现、
  周视图也能插时间块、全程无 JS 报错）。
- **反向验证 12 条**（`_fb_b21_falsify.py`）：逐条把修复改回旧行为看断言是否变红 ——
  令牌字段改回 stage[] / 编辑读表单 stage / 排序改回 position / 设置按钮挪走 /
  框不转发点击 / 文件框不再 sr-only / 删缩略图规格 / 删除不回 JSON /
  结束端改回 hidden / 日历本默认改回第一个 / 天气提示加回 / 弹框改回内联。
- 部署脚本静态断言段本地空跑 **307/0**。
 2026-10-06 12:08:40 +08:00
laoyang c3d00ad66a v24 第 20 批：拖动即时上传 / 观影图片带出 / 行程保存修复 / 日程红线与删除范围与多提醒 / 悬停统一（用户 9 条） 
用户 9 条原话要点：
  ①「观影模块，编辑观影，已经保存的海报和票根、合影，都没带进来。」
  ②「个人设置页面，"只影响你自己看到的样子"这个提示删除，不要了。我怎么称呼家人，
     这个卡片，不要了。我的资料这个卡片，不要了。」
  ③「旅程模块，编辑行程，点击保存没有反应。」
  ④「所有上传图片视频和附件的模块，都允许多次拖动添加文件上传，拖动一个进去，
     就开始上传，还可以继续拖动，继续上传，最后统一保存即可。」
  ⑤「添加行程，线路名、承运方，都不要了。车辆，只在出行方式选择自驾时才出现，
     其他情况下默认不出现。出发地和到达地，应该在同一行。」
  ⑥「日程模块，周视图和日视图，应该在视图中间显示一条红线，用来表示当前进行的时间…
     用一个不断从上到下的红线，来表示当前时间在视图上的刻度和位置。」
  ⑦「对于重复的日程，当点击删除的时候，应该提示是删除这一次，还是全部都删除，
     还是删除这一次及以后的。」
  ⑧「日程的提醒，是可以多选的，就是说，一个日程，我可以选择让它 5 分钟提醒，
     10 分钟提醒等等。」
  ⑨「很多按钮的悬停效果非常奇怪，感觉纯粹是换了一个背景色…应该调整所有按钮的悬停效果，
     保持统一，但是不要单纯的换一个不协调的背景色。」

🔴 三个真根因（都是"看着不像 bug"的地方）：
  1. **③ 点保存没反应 = `<form>` 嵌套**（HTML 非法）：`trips/node_form.php` 的照片缩略图上
     套了 `<form action=photo_del>`，而整块在**外层行程表单内部**。浏览器解析到内层
     `</form>` 时**把外层表单提前关掉** → 「保存」按钮**掉出表单**（真机实测
     `button.form === null`）。源码里完全看不出，**只有真浏览器量 `btn.form` 才现形**；
     且**只有这段行程已经有照片时才触发** —— 所以表现为"有时候好、有时候坏"。
     → 按钮留在原位（布局不动），用 HTML5 `form="id"` 关联到**表单外**的独立表单。
  2. **⑤ 车辆藏不住（第 17 批就写过、一直没生效）**：`.field` 自己声明 `display:flex`，
     作者样式压过浏览器默认的 `[hidden]{display:none}` → `hidden` 形同虚设。
     **本项目第 4 次栽同一个坑**（.att-item / .pv / .pp-item 各一次）→ 补 `.field[hidden]`。
  3. **④ 拖动即时上传的卡片"看不见"**：模板给 `.stage-list` 加了 `hidden`（没人上传时
     不留空边框），JS 建卡片时忘了 `list.hidden = false` → 卡片在 DOM 里但整条清单
     `display:none`、尺寸 0×0。**HTTP 层断言全绿**（HTML 里确实有卡片），
     **只有真机量尺寸才发现** —— 由新写的真机探针抓到。

本批新增能力：
- **拖动即时上传**（第 4 条）：新增 `upload_stage.php` + `app/StagedUpload.php` +
  `templates/_stage_drop.php`。拖进来 → **立刻** POST 到暂存目录 → 回 `stoken` →
  放进隐藏字段 `stage[]` → 保存时在 `attach_save_files()` 里**认领**（移文件 + 建附件行）。
  `media.php` 加 `?stage=` 预览（拖完立刻看得见缩略图）。
  ⚠️ 三个必须踩准：**串行队列**（并发会让缩略图顺序乱跳）、**提交守卫**
  （还有没传完就 preventDefault，否则"拖了但没保存上"必然发生）、**卡片清单要 un-hide**。
  ⚠️ 海报/票根走**独立字段名** `stage_poster`/`stage_ticket`（各自单槽位、要按比例重裁）。
  ⚠️ 落点**就近取**（`input.closest('.field')`）：一个表单里多个上传区不能串到第一个去。
- **观影编辑带出已存图片**（第 1 条）：编辑页显示海报 / 票根 / 合影 + 各自的删除入口；
  新增 `movies/media_del`（只删不换也能删，槽位走白名单）；`movies/update` 收编辑页
  新选的照片时**合并**而不是替换（否则一编辑就把已有合影冲掉）。
- **行程表单**（第 5 条）：去掉线路名 / 承运方（**库里的值保留**：UPDATE 时不参与，
  与 seat_info/gate 同一套）；出发地/到达地包进 `.loc-row` 真同一行；车辆按自驾显隐。
- **当前时间红线**（第 6 条）：位置在服务端算（与 `.tg-block` 同一套"24h = 100%"坐标），
  前端每分钟自己挪（对齐到下一分钟整再起定时器），跨午夜 reload；只画在**今天那一列**。
- **重复日程删除三档**（第 7 条）：与「编辑」那三档同名同序（全部 / 这一次及以后 /
  只这一次）。「只删这一次」→ `skipOnce`（**绝不删整条系列**）；「这一次及以后」→
  老系列截 UNTIL，**必须清掉 COUNT**（两者并存时 COUNT 优先，不清就截不断）。
- **提醒多选**（第 8 条）：同列存逗号串（`5,15,60`）；Schema 把它从 **INT 改 VARCHAR**
  （INT 存逗号串会被隐式转换，多档会静默只剩第一档）；ICS 导出吐**多个 VALARM**。
- **悬停统一**（第 9 条）：原来 14 种互不相干的 hover 底色 → 统一成**两套手法**：
  有底色 `filter: brightness(.92)` 同色系加深 + 轻抬升；描边白底 `--hov-veil` 中性薄雾
  + 边框微显。放在 CSS **最末**用一条兜底收口（新按钮自动继承），并把十几条旧规则
  清成"交给统一段"。`person_picker.js` 同时改为按需加载。

验证（本地全套）：
- e2e **1004/0**（+21 条本批断言）· 升级 149/0 · 桌面几何 428/0 ·
  **真机探针 25/0**（连续拖两次 / 红线位置与颜色与几何 / 车辆显隐 / 出发到达同行）。
- **反向验证 5/5**：①删除按钮改回嵌套 form ②卡片清单不 un-hide ③观影编辑不渲染海报
  ④车辆隐藏失效 ⑤「只删这一次」做成删全部 —— 五种坏法全部被抓住，还原后复绿 1004/0。
  过程中还**抓到两条弱断言**（只查 DOM 有无、不查可见性/是否真渲染），已一并加强。
- 部署脚本静态断言段本地空跑 **305 条全过**。
 2026-10-06 03:14:18 +08:00
laoyang 89b956205d v24 第 13 批：旅程模块重构（双轨 → 一条记录 + 状态机） 
用户原话：「旅程这个模块，我准备大改…如果按照计划行程和实际行程来分别管理，
会变的很复杂…根据我的想法，重构这个模块。」
—— 这不是加需求，是把「双轨」架构换成「一条记录 + 状态机」。

## 用户确认的三个决定
1. 两层：**活动**（顶层容器）→ **行程**（挂其下，字段沿用原节点）
2. **修正不立即转实际**：修正只是记录，行程仍标"计划（已修正 N 次）"，
   要再点一次「标记为实际」才转实际
3. 老数据**按现有轨道自动迁移**（category=reality → stage=actual）

## 状态机（本次重构的心脏）
trip_nodes.stage：
  · plan    计划行程 —— 唯一以「计划时间」上日程的状态，三个动作都能用
  · actual  实际行程 —— 上日程（实际时间）+ 进「往年今日」
  · skipped 未成行   —— **不上日程、不进往年今日**，但旅程里仍显示并标注
                          （用户："还是要显示，只不过要标记上"）
旧的 category(plan/reality) 保留作兼容，业务一律看 stage（saveNode 同步维护两者）。

## 三个动作（Trip.php）
· reviseNode —— 记一次修正。🔴 **第一次修正前先把原计划存成 seq=1 快照**，
  否则用户要的"之前的计划行程数据要保留，为了以后做对比"就落空。**不动 stage**。
  可无限次（seq 递增）。
· completeNode —— 实际＝计划，直接转 actual，**不产生修正历史**（没有变化就没有历史）。
· markActual —— 把（已修正过的）计划正式转 actual。
· skipNode —— **不是真删**，只置 stage='skipped'（用户明确"不要真的删除，只是做一个标记"）。
· restoreNode —— 撤销未成行（点错了能改回来）。
界面上的「彻底删除」与「标记未成行」是两个并列动作，弹窗文案里写明区别。

## 修正历史（Schema v19，新表 trip_node_revisions）
每次修正一行：实际起止 / 实际地点 / 说明 / 参与人快照。
第 1 条 = 原计划快照，第 2..n 条 = 各次修正 —— 详情页用表格展示，可直接对比。

## 日历与往年今日（用户点名的联动）
· 日历：`n.stage IN ('plan','actual')` —— 去掉旧的 `status<>'cancelled'`
  （那是双轨口径；现在"未成行"是 stage）。实际行程标题加 ✓ 前缀便于区分。
· **活动本身绝不上日程**（用户："活动因为可能跨越的时间比较长"）。
· 往年今日：旅程部分从「整趟 events」改成**实际行程**（stage='actual'），
  标题带活动名前缀；未成行的不出现。

## 验证
新增 _trip_e2e12.py **30/0**：建活动 → 加行程（可选计划/实际）→ 修正（仍计划 /
历史保留原计划 09:00 / 可无限次）→ 标记为实际 → 完成（无历史）→ 标记未成行（未真删）
→ 日历四种情形（已转实际✓ 新建实际✓ 完成✓ 未成行✗ 活动✗）→ 往年今日只看实际。
回归：e2e 787/0、升级 129/0（含 v19 路径）、batch_e 91/0、batch10 46/0、batch9 38/0、
picker 28/0 + 11/0、crop 17/0、formbloat 9/0、semi 27/0、geom 5/5、mobile 688/0、
interact 92/0、drag 5/0。
e2e 两条旧断言（"双轨两块/两轨各一条"）按重构语义更新为"三组渲染 / stage 各一条
+ category 与 stage 同步"。
部署断言新增 1 大组，含**反退化防线**：skipNode 若被改成 DELETE 立即变红。
线上自检 19/19；线上真实账号验收 16/0。
线上老数据迁移实测：#222 计划3+实际1、#221 实际4、#220 实际13 —— 一条没丢。
 2026-10-04 20:57:40 +08:00
laoyang ecf121772f v24 第 12 批：5 条（删除按钮位置/日期控件三修/日历跳转/节气节日/财务图） 
用户 2026-10-05 的 5 条。第 11 批交付后用户追问"确定这些需求都做完了？"—— 没有，
这 5 条是进一步要求。实现过程中查出 4 个真 bug。

#1 详情页删除按钮紧贴「开通账号」
   上一版放在页面最下方独立区块（danger-zone），用户要「就放在开通账号按钮下面，
   紧挨着，长度大小和开通账号一样，颜色改成红色」。→ 搬进「登录账号」卡片内
   （.del-inline + 细分隔线 + .btn-block-lg）。
   线上几何实测：同一张卡片、左边缘对齐 255==255、宽度一致 990==990、红色 rgb(192,83,63)。

#2 日期控件三修（两个真 bug + 一次闪烁）
   · 灰底：Semi **外层** .semi-datepicker-input 自带 rgba(46,50,56,.05)、高 32px；
     内层 wrapper 白底 40px → 灰的露在外面。实测「灰底元素」= 1 个 → 修后 0 个。
   · 不垂直居中：外层 32px < 内层 40px，实测 gapTop=1 / **gapBottom=17**（文字贴顶）
     → 修后 gapTop=1 / gapBottom=1。
   · 闪烁：实测首 **200ms** 原生输入框可见（要等 3.4MB React 解析）。
     用 no-js/js 二态：<html class="no-js"> + head 内联脚本立刻换 js +
     CSS `html.js .dt-input:not(.is-semi) .dt-native { visibility:hidden }`
     （配同高骨架 ::after 防布局跳动）。实测「出现过原生可见」= False。

#3 日历跳转保留视图 + 下拉日历
   原来写死 view=day（在月视图点跳转会被踢进日视图）。→ 表单带当前 $view（月还带 ym）；
   选择器从"居中弹窗"改成**按钮下方下拉** .cal-jump-drop。
   实测：月视图跳 8/15 仍在月视图且是 8 月；周视图跳 8/15 → 落 8/10 那一周；
   日视图跳 8/15 → 显示 8/15。

#4 传统节日 + 二十四节气两个系统本（Schema v18）
   Holiday::SOLAR_TERMS（24 项 C 常数近似公式 + 例外表）+ traditionalRange
   （农历推导；除夕用"次日是否正月初一"反推，写死腊月廿九会有一半年份错）。
   实测 2026：节气 24 条全对（清明 4/5、冬至 12/22）；春节 2/17、除夕 2/16、中秋 9/25。
   ⚠️ ENUM 必须显式 ALTER（对已存在的表不生效）——同一坑第二次踩，VERSION 17→18。

#5 财务（一个真 bug + 一个假起点 + 一个真 bug）
   · chart_line 读 `cents` 而 timeline() 返回 `net` → 键名不匹配，**总资产图每点读成 0**
     （正是用户说的"图上是 0"）。修：兼容 cents ?? net ?? asset。
     实测 timeline net=800000（8000 元），线上 polyline 有真实起伏。
   · 去掉 timeline 人为插的"前一天=0"假起点（用户："总资产不应该是 0，
     应该是所有账目创建时的金额的总数"）。
   · ppSetSelected 只用 document.querySelector 按名字找，而财务页有**两个** person_id
     组件（「记一笔」+ 修改弹框）→ 永远灌到第一个。加 root 参数、调用方传 panel。

验证：e2e 786/0、交互 92/0、升级 129/0（+3 条 v18 断言）、batch_e 91/0、batch10 46/0、
batch9 38/0、picker_unify 28/0、picker_lazy 11/0、crop 17/0、formbloat 9/0、semi 27/0、
mobile 688/0、drag 5/0、geom 5/5；第 12 批专项：财务 7/0、日历 19/0。
部署静态断言新增 5 组（含反向验证：注入回退 → FAIL=1）。
线上自检 19/19；线上真实账号验收 **30/0**（含真实浏览器几何量删除按钮位置）。
 2026-10-04 19:43:00 +08:00
laoyang b2ca4f336e v24 第 10 批：名册真性能（根因是每卡内联表单）等九条 
- #6 名册线上真实数据（1184 人）卡顿：根因是**每张卡片内联一整份分组弹层**——
  全页 2369 个 form / 27234 个 input / 22496 个 radio / 98100 DOM 节点，
  密码管理器（Bitwarden 等）逐个扫描 form 把主线程占死（用户报的就是这个冲突）。
  改为卡片只带 data 属性 + 全页**唯一一份**共享浮层 #rosterMenus。
  实测：form 2369→3、input 27234→25、DOM 98100→17659、解压 7694→2306 KB、
  长任务 1/52ms → 0。新增哨兵 _fb_formbloat_check.py（含反向验证）。
- #5 日视图翻页失效：day_columns() 无条件吸到周一，天视图只有 1 列 → 永远显示那周周一。
  改为仅 span>1 时吸附（周视图行为不变）。
- #2 财务「欠款」类别（负债）；并修一个真 bug：负债填负数会让净资产**反向变大**。
  写入口 normalizeAmount 归一化 + summary/timeline 侧 abs 防御 + Schema v17 纠正老数据。
- #3 账目行「盘点」「修改」两个并列按钮（各自就地弹面板）；图移到账目上方，
  总金额图跨整行 + 每个账目一条线 + 类别筛选条；charts() 改为覆盖全部账目。
- #4 日程新增「农历」「节假日」两本不可删除只读日历（app/Holiday.php）：
  两级自动更新 —— 内置规则（公历固定 + 清明节气 + 农历节日）保证断网也有；
  官方 JSON 镜像自动抓取补齐调休。抓取**不在渲染路径联网**（响应后 fastcgi_finish_request
  + 频率闸门），缓存落 storage/cache。仅派生本不可写日程。
- #6 日程页设置按钮前加「跳到某一天」（选中即跳）。
- #7 起止范围改用一个 Semi dateTimeRange 控件（观影/旅程/节点/日程共 4 处）；
  新增 window.fbSetDT / fbUpgradeRange；修范围重挂（React 非受控组件须 unmount 再 createRoot）
  与范围里 required 未摘除导致表单无法提交两个真实问题。

验证：e2e 786/0、batch10 44/0、batch9 38/0、batch_e 91/0、upgrade 126/0、picker 28/0、
semi_integrate 27/0、formbloat 5/0（+反向 3 红）、mobile 688/0、interact 97/0、drag 5/0、geom 5/5；
线上自检 19/19 + 线上真实账号巡检 28/0（含 Firefox 实测）。
 2026-10-04 10:46:50 +08:00
laoyang e0562b8627 v24 第 5 轮：十条清单（天气填城市 / 输入即筛选 / 看板列＝看板 / 账本盘点折线图 / 纪念日分类） 
用户 2026-10-03 的十条，逐条落点：

1. 天气改为**个人设置里填城市**（每人一份）：新增 app/Geo.php，内置 197 个
   地级市坐标（离线、逐条核对，生成脚本 _tooling/_fb_geo_gen.py）。填坐标仍
   作为内置表没有时的出口；老的家庭级坐标保留为兜底，升级当天天气不会凭空消失。
2. 所有"找个人"的地方**输入即筛选**：新增 assets/js/filter.js（纯前端显隐，
   不发请求、回车不刷新）+ app/PersonQuery.php 把服务端判据收敛成一份
   （名册 / 挑人 / 高级搜索共用，避免三处实现漂移）。
3. 名册列表：有昵称就不重复显示本名、行变矮、补齐手机/阴历阳历生日(带年份)/
   邮箱/工作单位；「清除」与「搜索」同款同尺寸。
4/5. 日程：撤掉左侧日历本栏改满宽，功能（显隐/颜色/导入/默认视图）全收进
   右侧 ☰；**色块高度改为按起止时长**（旧实现一律 30 分钟，三小时的会跟
   十五分钟的同高）；点日历空白处即建日程，开始时间＝点的那一格。
6/10. 资源：搜索提到最上；按"最近改动/最新新增"排序，默认只显示最新 10 条并
   给「显示全部」出口。
7. 任务：看板的**列＝用户自定义的看板**（不再是写死的待办/进行中），
   拖动/左右键＝换看板（改 board_id，不动 status）。
8. 财务：概览在上账目在下、记一笔改右侧按钮、账本设置（共享/改名/新建/删除）
   收进 ☰、默认账本名「xxx的账本」、"挂在谁名下"默认自己且用标准选人框；
   **新增盘点**（新增 ledger_entry_snapshots 只增不改的历史表，旧值不被清空）
   + 上面画金额变化折线图（app/chart.php 服务端画 SVG，零依赖）。
9. 纪念日：手动添加的与名册生日派生的**分两块**、手动的在上；右侧设置可增删
   分类（家庭级，删分类不强改已用的历史）。

本轮另外修掉/加固的四类问题（都由新增的静态或运行时守卫兜住）：
- index.php 少写 2 个 use 导入（Pinyin / UserSetting）→ 名册与个人设置
  返回 200 但正文是 Fatal；顺带修了一处早已存在的 Attachment 未导入。
  → 新增 _fb_import_check.py（1f 段）。
- 一次不精确替换弄丢了 app/Calendar.php 开头的 `<?php`，整份源码被当 HTML
  吐给浏览器，而 `php -l` 报"无语法错误"（纯文本输出确实合法）。
  → 新增 _fb_php_open_check.py（1e 段）。
- 模板片段 unset 了宿主模板的变量（账本片段 unset($canWrite)）→ 正文里一片
  Undefined variable 而 HTTP 仍 200。同 _datetime.php 早年 $t 的坑。
  → 新增 _fb_fragment_scope_check.py（1g 段）+ _fb_batch_e.py 的 26 页无告警巡检。
- 窄屏下页头动作区不换行 → 周视图横向溢出且按钮被挤成三种高度（用户提过三次
  "按钮要同高"）→ .page-head .actions 加 flex-wrap。

验证战绩（全绿）：
  e2e 773/0 · 第 5 轮专项 91/0 · 结构升级 126/0 · 几何 428/0 · 移动端 684/0 ·
  交互 97/0 · 家谱 26/0 · 按钮 60/0；三轮反向验证各 3/3 抓到，还原后复绿。
线上：schema v14、指纹一致（9df6c9fccc6796db）、snapshots 表已建、197 城、
  8 个关键文件 md5 与本地逐字节一致、app/ 403 无源码泄漏、错误日志无新增。
 2026-10-03 15:01:38 +08:00
laoyang 02f5d072a4 家谱卡片重做 / 首页控制台 / 名册改列表 / 重复日程与旅程公开 
用户 2026-10-03 提的四条：

① 家谱卡片重做
   · 去掉「⇄ 姻亲」按钮，改成**每个人**卡片右下角都有「以 TA 为中心」
     （点了以他重画一张家谱，涵盖原来的姻亲场景）。
   · 头像外框改**长方形**（96×72，宽度贴合头像），object-fit: contain 不裁切，
     姓名/称呼在头像下方。
   · 修「点右下角按钮误进成员页」：卡片不再整张是 <a>，
     只有姓名是链接，右下角是独立的 <button>（物理上分开，不抢点击）。

② 家谱文案与按钮清理
   · 去掉副标题与下方图例说明；整块去掉「看全部 / 回到我 / 回到我的家谱」
     （顺带消掉"出现两个回到我的家谱"）。镜头由库自动 fit，拖拽/滚轮即可。

③ 首页控制台
   · 标题下显示个人 slogan；去掉右侧三个统计；「我的资料/我的家谱」换成图标按钮；
     去掉与导航条重复的「名册」按钮。
   · 去掉「接下来的日子」（生日归到"未来七天"里，不再重复）。
   · 新增统计信息块：按时段随机问候 + 今日天气（Open-Meteo，免 key，可留空不显示）
     + 近七天日程/待办/逾期数。
   · 新增各模块小结卡（任务/日程/纪念日/观影/旅程/财务/名册/家谱/资源）。
   · 个人设置新增「首页上的模块」：可勾选与拖动排序（每人一份，存 user_settings）。
   · 保留「往年的今天」。

④ 名册改列表
   · 卡片网格 → **竖向列表**：左头像、中间姓名+与我的关系+手机号+生日。
   · 修拖动「只能往后不能往前」：落点改为显式记录"插到谁前面/后面"，
     并排除被拖元素自身。
   · 去掉那句拖动提示（能力保留）。
   · 搜索新增**姓名首字母**检索（y / yy / yyq 都命中「杨永全」）：
     新 app/Pinyin.php，intl 优先 + 内置常用字表兜底（本地无 intl 也能测）；
     纯字母/数字查询词不走 SQL LIKE（拼音与加密手机号在库里都比不了）。

附带上两轮的收尾：
   · 菜单点外部自动关闭（全局事件委托，覆盖所有 details.menu）。
   · 旅程 is_public：列表与日历只显示公开的；详情页不拦（不丢数据）。
   · 重复日程：新 app/Repeat.php（RRULE 解析/生成/展开，含"工作日"），
     新表 calendar_event_skips（RFC 的 EXDATE）；日历按规则展开；
     编辑支持三档「全部 / 这一次及以后 / 仅此一次」。
   · 结束时间可添加/去掉，并随开始时间联动。

验证：端到端 772 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 26、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
 2026-10-03 11:30:48 +08:00
laoyang 8f80f3e835 v24 第 2 轮：19 条清单收尾（附件预览/CalDAV/任务分类看板/全局选人/家谱/纪念日/财务） 
用户 2026-10-02 提的 19 条需求，本轮完成剩下的 8 条 + CalDAV 服务端：

- ③ 附件：图片/视频给缩略图，PDF/Word/Excel 给**同尺寸**图标；可预览的在本页
     弹层里看（不再新开标签页），渲染不了的点了直接下载；预览层右上角恒有下载按钮。
- ⑦b CalDAV：把「我的日历本」按 RFC 4791 只读子集分享出去（OPTIONS/PROPFIND/
     REPORT/GET，写方法一律 403）。用**专用口令**（库里只存 sha256），不是登录口令。
- ⑨⑩ 任务：分类与看板都由用户自建；已完成的任务从看板消失，改在「已完成」页
     按分类查看/搜索；设置入口在「新建任务」旁的 ☰。
- ⑪ 全局人员选择器：一个片段铺到观影/旅程/资源/日历共享/任务共享/财务共享；
     修掉了老组件「名字和拼音都搜不动」的 bug —— .att-item 自己声明了 display:flex，
     压过了浏览器 [hidden]{display:none}，过滤根本没生效。
- ⑫ 家谱：头像改方形不再裁切；姻亲不在图上的卡片给「⇄ 姻亲」入口，
     以 TA 为中心重画 + 「返回我的家谱」。
- ⑬ 纪念日：阴历/阳历都能设且按对应历法重复；名册里每个人的生日默认可见
     （实时派生，不复制一份）；全部作为全天日程进日历。
- ⑮ 财务：账本可共享，双方都能记账、都能看全部账目，资产−负债=净资产；
     金额一律以「分」存，不用浮点。

验证：端到端 724 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 24、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
 2026-10-03 08:18:05 +08:00
laoyang 71a7ec35a0 v14: 观影/家谱/日程/旅程/资源/任务六模块统一，首页改 dashboard 
用户 14 条需求一次交付（1-13 功能 + 14 工作方式）。

观影（1-4）
- 返回文案全模块统一为「返回观影」（不再有「返回列表」「返回观影记录」三种叫法）
- 观影人一律用彩色人物标签 person_chip：底色由头像主色算出来（上传时存库），
  瀑布流卡片也按人显示；五处观影模板全部改用它
- 人员显示统一走 person_name()（shown → 我给他起的称呼 → 姓名）
- 影院管理页与年度报告页的上下两块用 .card + .card 统一给间距（原来紧贴成一整块）

家谱（5）
- 树根从「我」换成**辈分最高的祖先**：库画的是"树根的祖先链+后代+树根的兄弟姐妹"，
  根=我 时伯父/堂兄/嫂子/侄子一个都不画（12 人夹具只画出 8 人）
- focusMap 按**代数**圈定三代（不再按步数），normalizeLinks 把子女对称挂到父母双方
  —— 修掉"母亲登录看不到孩子"
- 新增「看全部 / 回到我」两个按钮，放在画布外（画布整块被库接管了手势）

统一事件原语（6-9）
- 旅程：TripLog 全量迁入（3 趟旅程 / 21 段行程 / 72 张照片 / 5 个人）。
  复用 events(kind='trip') + trip_details + trip_nodes（计划/执行双轨保留）
- 日程：每人可建日历本（自定义色）+ 共享只读/可写；观影与旅行是每人默认两本，
  内容是**从各模块实时派生**的（不复制，所以改了观影日期日历立刻跟着变）；
  没有具体时分 = 全天；月视图参照群晖 Calendar
- 资源：挂在某人名下的附属信息（标题+正文+多附件），可共享给多人并设只读/读写，
  默认折叠、可搜标题与正文
- 任务：看板三列 + 两级子任务 + 评论@人 + 共享 + 循环（完成时按原截止日推下一期）
- 统一附件表：四个模块的附件共用一张，下载地址不落库、一律由 media.php 现算

模块化（10-11）
- App\Module 是模块的唯一来源（加一行 = 导航条/主题色/个人设置三处自动出现）
- 个人设置里可勾选要显示哪些模块、拖动排序（关掉的模块**不会**被兜底补回来）
- 每个模块一套主题色（家庭级），只覆盖 --brand 三兄弟，不碰纸墨底色

其他（12-13）
- 新增成员表单可选所属分组（编辑表单没有：分组是"我和他的关系"，只归我自己）
- 首页改 dashboard：接下来的日子 / 未来七天 / 手头在做 / 往年今日。
  家人卡片从首页撤走（看人去名册）

验证（全部通过）
- e2e 542 条（新增 4 模块端到端 60+ 条）
- 桌面几何 368 / 移动端几何 520 / 家谱 12 / 交互 97 / 老库升级 123
- SQL 列名静态校验 0 处可疑（对着真实表结构）
- 反向验证 18 条新注入全部抓住

顺带修掉的既有问题
- 老库升级回填 SQL 按实际存在的列动态拼（缺列不再 1054 炸断升级）
- 全新安装时 Schema::ensure 跑在"人还没建"之前 → 补建日历本三处齐备
- 窄屏导航横向溢出（模块从 4 个加到 8 个后顶栏撑破视口）
 2026-10-02 09:28:07 +08:00