v52：旅程 CalDAV 结束时间 / 笔记（标题·段落下加段加图·逐段就地编辑）/ 名册自动匹配与设置页 / 模块设置整合表

用户 2026-10-15 七条。

① 旅程行程经 CalDAV 同步后「结束时间 = 开始时间」
   **真根因**（app/Calendar.php 的 exportRows()）：对**派生条目**（观影/旅程）写死
     'ends_at' => null，而 Ics::vevent() 遇到空结束会退化成「DTEND = DTSTART」
     ⇒ 手机上每条行程的结束时间都等于开始。
   **附带第二个 bug**：分组键含日期（kind-ref_id-date），而 month() 把**跨天条目逐天**
     铺出来 ⇒ 跨天节点被拆成 N 条（UID 相同），resources() 按 UID 去重后**只留第一天**，
     而第一天那条没有结束时刻 ⇒ 又回到 DTEND=DTSTART。
   修法：键改成 `kind-ref_id`，先收集同节点的各天，再用**首末天**拼一条真实跨度
     （末天那条才带 end_time）。实测单日 DTEND=12:30、跨天 DTEND=第3天11:00，
     每节点恰好 1 条 VEVENT。
   ⚠️ 副作用（已处理）：v31 DAV 去重的反向验证原来靠「跨天节点逐天出、UID 全同」造重复，
     本修把那条素材**修没了** ⇒ 给夹具换成「同一份 .ics 导两次」（两条 UID 相同的
     自定义日程），守卫仍能被证伪（见 _fb_dav_diag.py 与 pitfalls 的同族条目）。

② 笔记详情页标题是"看笔记"而不是笔记名
   阅读态 h1 改用笔记自己的 $noteTitle；**编辑态仍用「改笔记/写笔记」**
   （编辑时标题就在下面第一个输入框，两处重名看着像重复）。浏览器 <title> 同步。

③ 加段落/加图片要在**输入框下面**
   note_editor.js 的 makeBlock() 里每块下方加一排 .note-block-add（＋段落/＋图片），
   点了插在**这一块后面**；顶部那组**保留**（用户明确"上面和下面都保留"）。
   ⚠️ 挂在 body 里而不是 wrap 上 —— .note-block 是 display:flex 横排，
      挂 wrap 会变成"输入框右边的第三列"，不是"下面"。
   ⚠️ 用 data-add-below（不是 data-add）：顶部是"追加到末尾"、块内是"插在本块后"。

④ 笔记详情页「逐段就地编辑」（分块多时不用跳编辑页找那一块）
   模板给每块包 .note-read-item[data-block][data-kind][data-raw] + 右上角「编辑」按钮；
   新增 assets/js/note_inline.js（按需加载）：划过出现 → 点编辑就地变 textarea →
   保存 POST notes/block → 只换这一块。
   服务端 Note::updateBlock()：**按块主键改一行**（不是整组替换）——
   ⚠️ 整组替换会换掉每个块的 id（前端手里的 data-block 当场失效）+ 并发互相覆盖；
   ⚠️ SQL 必须带 `AND note_id = ?`（块 id 全局自增，少了它就能改别人笔记里的块）。
   权限与整条编辑同一把尺（find() + canWrite()）。

⑤ 删掉「从已有家里人中挑选」，改成「新增/导入时自动匹配」
   新增 Person::matchExisting()：手机号（有 phone_hash，一条 SQL 精确命中）→
   身份证（无哈希，整表解密比）→ 姓名（**先记下不立刻返回**，等精确命中看完再退到它）。
   people/create：校验通过后先 matchExisting，命中就在**同一张表单里**出确认条
   （#personConfirm）。⚠️ **不做成单独确认页**：单独页要把整张表（含工作经历/补充联系
   方式这些**数组字段**）原样回传，漏一类就静默丢数据；同表单里字段天然全在。
   ⚠️ 判"是不是第一次提交"用 array_key_exists('confirm_existing')（0=不是、1=是、无=首次）。
   导入那条路的缺口（本轮补）：ContactImporter 命中已有的人时只补字段、**不挂进导入者的
   名册** ⇒ "文件里有他、系统里也有他，但导完我的名册里看不到他"。已在命中分支加
   PersonRoster::ensure(..., $meId, ...)。
   顺手加 PersonRoster::has()（避免调用方又踩"visibleIds 是值列表不是集合"那个坑）。

⑥ 名册页只剩「添加成员 + 设置」；分组搬到名册设置
   templates/people/_settings_menu.php（新）：☰ 下拉两行 = 导入联系人 / 名册分组。
   templates/people/settings.php（新，路由 people/settings）：require 从个人设置**整块搬出来**
   的 templates/_person_groups.php。
   ⚠️ 是**真搬**不是复制（两份一模一样的分组界面，改一处忘一处是必然的）；
   ⚠️ 片段变量一律加 pg 前缀 —— 模板片段与宿主 require 是**共享作用域**，
      用 $groups 这种通名会覆盖宿主同名变量（本轮真踩到，已改）。
   ⚠️ 表单 action 仍指 settings/groups/*（一个字段没改）。

⑦ 个人设置：模块设置整合成一张表
   原来是**三张卡三个表单**（首页模块 / 导航模块 / 主题色），同一串模块名出现两遍。
   现在一张表五列：顺序 | 模块 | 导航 | 首页 | 颜色，一次保存。
   新增 settings/modules_save 路由：**底层存储一个没改**（仍是 nav_modules /
   home_modules / module_colors），只是把三个 save 依次调一遍 ⇒ 老数据天然兼容。
   ⚠️ 权限**没有**因为"合并"被放宽：颜色仍是家庭一份、只有管理员能改
      （非管理员那列是只读色块；提交时服务端静默忽略 c[]）。
   窄屏：表格 min-width:560px + 外层 overflow-x:auto（375px 实测横向溢出 0）。

验证（新增 5 套件 + 更新若干旧断言）：
 · _fb_v52_ics.py（3）/ _fb_v52_note.py（19）/ _fb_v52_roster.py（12）/ _fb_v52_mods.py（13）
 · _b52_falsify.py（**12 注入 / 31 断言全抓**）
 · _fb_import_test.py 补 ⑯（命中的人也要回到导入者名册）；_fb_dav_diag.py 换去重素材
 · e2e 1516/0；_fb_batch_e.py / _fb_e2e.py / familybook_deploy.sh 里随 #6/#7 搬家或改形的
   旧断言（分组在个人设置、模块行 li→tr、show_present、RRULE 前缀）意图一字不改
 · 全流水线 **PUSH_RC=0**、部署 0 FAIL（含"第52批形态"）；线上 16 文件 md5 逐字节一致

⚠️ 工程纪律（已写进 pitfalls.md / 工作日志）：
 · 探针自起的 PHP 服务**一律随机空闲端口**（写死 + "连上就复用" 会静默测到别的目录/库）；
 · **同一工具链目录 + 同一库名不支持两个会话并发** —— 本轮最后一个多小时的"诡异全红"
   全是**另一个会话**在同时跑 _fb_e2e.py、共享 fb_test 与 _fb_site 造成的；
 · 并发下**连 git stash 都不能用**（会把别人的半成品一起藏起来），基线对照用 git worktree；
 · 修好业务可能让"守着它的反向验证"空转（素材被修没了）⇒ 换一处等价素材，别删守卫；
 · 断言盯**形态**而非具体数值（分栏那次写死 50% 在别的批次数据上假红）。

templates/people/index.php

@@ -243,19 +243,20 @@ $renderGrid = function (array $list) use ($meId, $canMove): void {
     共 <b data-roster-total><?= $total ?></b> 人<?= $tagCloud && $q === '' ? '，有 ' . count($tagCloud) . ' 个标签' : '' ?>
   </span>
   <div class="actions">
-    <?php if ($canMove && $pickable > 0): ?>
-      <a class="btn btn-ghost btn-sm" href="<?= e(url('people/pick')) ?>">
-        从家里已有的人里挑（<?= $pickable ?>）
-      </a>
-    <?php endif; ?>
     <?php if ($canMove): ?>
-      <?php /* 用户 2026-10-03 第 1 条：名册导入入口。
-               ⚠️ 放在「添加成员」**左边**（次要动作在左、主要动作在右）——
-                  日常还是一个个加，导入是换手机/换号时的一次性动作。 */ ?>
-      <a class="btn btn-ghost btn-sm" href="<?= e(url('people/import')) ?>">导入联系人</a>
-    <?php endif; ?>
-    <?php if (\App\Auth::isAdmin()): ?>
+      <?php /* 🔴🔴 v52（用户 2026-10-15 第 6 条）：「名册右侧，**只保留一个添加成员按钮**，
+           右侧再加一个设置按钮，点击后下拉设置，第一个就是导入联系人，
+           第二个就是原来个人设置那里的名册分组，这样个人设置中就不显示名册分组的内容了。」
+           ⇒ 右上角只剩两颗：**添加成员** + **☰ 设置**（设置恒在最右，全站统一）。
+           ⚠️ 原来那两颗去哪了：
+              · 「从家里已有的人里挑」→ **整颗删掉**（用户第 5 条：不再让人手动挑，
+                改由"新增/导入时自动按姓名/手机号/身份证匹配并问一句"来替代）；
+              · 「导入联系人」→ 收进 ☰ 设置里（第一行）。 */ ?>
       <a class="btn btn-sm" href="<?= e(url('people/new')) ?>">添加成员</a>
+      <?php $plSetCurrent = ''; require __DIR__ . '/_settings_menu.php'; ?>
+    <?php elseif (\App\Auth::isAdmin()): ?>
+      <a class="btn btn-sm" href="<?= e(url('people/new')) ?>">添加成员</a>
+      <?php $plSetCurrent = ''; require __DIR__ . '/_settings_menu.php'; ?>
     <?php endif; ?>
   </div>
 </div>
@@ -285,21 +286,18 @@ $renderGrid = function (array $list) use ($meId, $canMove): void {
     <?php if ($q !== ''): ?>
       <b>没有匹配的人</b>
       换个词试试。
-    <?php elseif ($pickable > 0): ?>
-      <b>你的名册还是空的</b>
-      家里已经有 <?= (int)$pickable ?> 个人了 —— 直接挑过来就行，不用重新录一遍。
-      <div class="btn-row" style="justify-content:center;margin-top:14px">
-        <a class="btn" href="<?= e(url('people/pick')) ?>">从家里已有的人里挑</a>
-        <?php if (\App\Auth::isAdmin()): ?>
-          <a class="btn btn-ghost" href="<?= e(url('people/new')) ?>">添加一个新人</a>
-        <?php endif; ?>
-      </div>
     <?php else: ?>
       <b>名册还是空的</b>
       <?php if (\App\Auth::isAdmin()): ?>
+        <?php /* 🔴 v52（用户第 6 条）：这里原来挂着「从家里已有的人里挑」按钮 ——
+             那条入口已按用户第 5 条的要求**整颗删掉**（改成"新增/导入时自动匹配"）。
+             现在只留"添加成员"，以及一句说明：家里已有的人会被自动认出来。 */ ?>
         把家里人加进来，之后观影、旅行的同行人就可以直接从名册里选。
+        <br>家里已经有的人（别人先录的）不用重录 —— 录入时填上姓名或手机号，
+        系统会认出来并问你要不要直接加进你的名册。
         <div class="btn-row" style="justify-content:center;margin-top:14px">
           <a class="btn" href="<?= e(url('people/new')) ?>">添加成员</a>
+          <a class="btn btn-ghost" href="<?= e(url('people/import')) ?>">导入联系人</a>
         </div>
       <?php else: ?>
         等家里人把你加进来，或者让管理员给你开个账号。