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/_settings_menu.php

@@ -0,0 +1,45 @@
+<?php
+/**
+ * 名册模块的「设置」下拉（v52 用户 2026-10-15 第 6 条）。
+ *
+ * 用户原话：「名册右侧，**只保留一个添加成员按钮**，右侧再加一个设置按钮，
+ *            点击后下拉设置，第一个就是**导入联系人**，第二个就是原来个人设置那里的
+ *            **名册分组**，这样个人设置中就不显示名册分组的内容了。」
+ *
+ * ⇒ 名册页右上角从此只有两颗：**添加成员** + **☰ 设置**（设置恒在最右，全站统一）。
+ *   原来散着的那几颗（从已有家里人里挑 / 导入联系人 / …）全部收进这个下拉。
+ *
+ * 两行（顺序是用户点名的）：
+ *   ① 导入联系人 → `people/import`
+ *   ② 名册分组   → `people/settings`（从个人设置搬过来的那一块）
+ *
+ * 用法（require 前 set 好）：
+ *   $plSetCurrent  当前页 key（'import'|'groups'）用来高亮；'' 也行
+ */
+$plSetCurrent = (string)($plSetCurrent ?? '');
+$plSetOn = static function (string $key) use ($plSetCurrent): string {
+    return $plSetCurrent === $key ? ' class="on"' : '';
+};
+$plSetIcon = static function (string $name): string {
+    $paths = [
+        'import' => '<path d="M8 2.6v7.2M5 6.8l3 3 3-3M3.2 13.4h9.6"/>',
+        'groups' => '<rect x="2" y="2.6" width="5" height="5" rx="1"/><rect x="9" y="2.6" width="5" height="5" rx="1"/>'
+                  . '<rect x="2" y="8.6" width="5" height="5" rx="1"/><rect x="9" y="8.6" width="5" height="5" rx="1"/>',
+    ];
+    $d = $paths[$name] ?? '';
+    if ($d === '') {
+        return '';
+    }
+    return '<svg class="mi" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"'
+         . ' fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"'
+         . ' stroke-linejoin="round">' . $d . '</svg>';
+};
+?>
+<details class="movie-set menu">
+  <summary class="btn btn-icon" title="名册设置" aria-label="名册设置"><svg viewBox="0 0 16 16" width="18" height="18" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round"><path d="M2.5 4.5h11M2.5 8h11M2.5 11.5h11"/></svg></summary>
+  <div class="menu-list">
+    <a href="<?= e(url('people/import')) ?>"<?= $plSetOn('import') ?>><?= $plSetIcon('import') ?><span>导入联系人</span></a>
+    <a href="<?= e(url('people/settings')) ?>"<?= $plSetOn('groups') ?>><?= $plSetIcon('groups') ?><span>名册分组</span></a>
+  </div>
+</details>
+<?php unset($plSetCurrent, $plSetOn, $plSetIcon); ?>

templates/people/form.php

@@ -69,6 +69,66 @@ $ctHints = [
     <input type="hidden" name="id" value="<?= (int)$person['id'] ?>">
   <?php endif; ?>
 
+  <?php /* 🔴🔴 v52（用户 2026-10-15 第 5 条）：「是不是这个人？」
+       新增成员时，若按 姓名 / 手机号 / 身份证号 在家里找到匹配的人，
+       **就在这张表里问一句** —— 而不是跳到一个单独的确认页。
+       ⚠️ 关键理由：单独一页要把用户刚填的一整张表（含工作经历、补充联系方式
+          这些**数组字段**）原样回传；漏传任何一类都会**静默丢数据**。
+          在同一张表里问，字段天然全在。
+       ⚠️ 两个按钮提交的就是**这张表**，靠 `confirm_existing` 的值分流：
+            1 = 就是这个人（不新建，直接加进我的名册）；0 = 不是，另建一条。 */ ?>
+  <?php if (!empty($confirmHit)): ?>
+    <?php
+      $cfWhy = [
+          'phone'   => '手机号一样',
+          'id_card' => '身份证号一样',
+          'name'    => '姓名一样',
+      ][(string)($confirmWhy ?? 'name')] ?? '信息很像';
+      $cfPid = (int)($confirmHit['id'] ?? 0);
+      $cfInMine = \App\PersonRoster::has((int)\App\Auth::familyId(), (int)\App\Auth::personId(), $cfPid);
+    ?>
+    <div class="card card-pad person-confirm" id="personConfirm">
+      <h2 class="section-title">
+        家里已经有这个人了 —— 是他吗？
+        <span class="hint"><?= e($cfWhy) ?></span>
+      </h2>
+      <p class="small muted" style="margin:0 0 12px">
+        如果是他，直接加进你的名册就行 —— <b>资料共用同一份</b>，不用再录一遍，
+        以后你们改的也是同一个人。
+        <br>如果不是（只是重名），点「不是，是另一个人」，我就按你填的当新人建一条。
+      </p>
+
+      <div class="person-hit">
+        <span class="person-hit-av">
+          <?php if (!empty($confirmHit['avatar'])): ?>
+            <img src="<?= e(media_url((string)$confirmHit['avatar'])) ?>" alt="">
+          <?php else: ?>
+            <span class="avatar-fallback"><?= e(mb_substr((string)($confirmHit['name'] ?? ''), 0, 1, 'UTF-8')) ?></span>
+          <?php endif; ?>
+        </span>
+        <span class="person-hit-info">
+          <b><?= e((string)($confirmHit['name'] ?? '')) ?></b>
+          <?php if (!empty($confirmHit['is_placeholder'])): ?><span class="node-badge">虚拟人物</span><?php endif; ?>
+          <?php if ($cfInMine): ?><span class="node-badge badge-open">已在你的名册</span><?php endif; ?>
+          <span class="small muted">
+            <?php if ((string)($confirmHit['org'] ?? '') !== ''): ?><?= e((string)$confirmHit['org']) ?> · <?php endif; ?>
+            <?php if ((string)($confirmHit['title'] ?? '') !== ''): ?><?= e((string)$confirmHit['title']) ?><?php endif; ?>
+          </span>
+        </span>
+        <span class="person-hit-ops">
+          <a class="btn btn-ghost btn-sm" href="<?= e(url('people/show', ['id' => $cfPid])) ?>"
+             target="_blank" rel="noopener">先看看他的资料</a>
+        </span>
+      </div>
+
+      <div class="btn-row" style="margin-top:16px">
+        <button class="btn" type="submit" name="confirm_existing" value="1">就是这个人，加进我的名册</button>
+        <button class="btn btn-ghost" type="submit" name="confirm_existing" value="0">不是，是另一个人</button>
+        <input type="hidden" name="existing_id" value="<?= $cfPid ?>">
+      </div>
+    </div>
+  <?php endif; ?>
+
   <div class="card card-pad">
     <div class="form-grid">
 

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: ?>
         等家里人把你加进来，或者让管理员给你开个账号。

templates/people/settings.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * 名册设置（v52 用户 2026-10-15 第 6 条）。
+ *
+ * 用户原话：「名册右侧，只保留一个添加成员按钮，右侧再加一个设置按钮，
+ *            点击后下拉设置，第一个就是导入联系人，第二个就是**原来个人设置那里的名册分组**，
+ *            这样**个人设置中就不显示名册分组的内容**了。」
+ *
+ * ⇒ 这一页 = 「设置 → 名册分组」进去的那一页，内容就是从个人设置**整块搬**过来的
+ *   `_person_groups.php`（表单 action 一个字段没改，仍指向 settings/groups/*）。
+ *
+ * ⚠️ 为什么不做成"个人设置那一块的副本"：两份一模一样的分组管理界面，
+ *    改一处忘一处是必然的（本项目在"设置页"上已经踩过这个）。
+ *    所以是**真的搬走** —— 个人设置里那一块删掉了，这里 require 同一个片段。
+ *
+ * 变量：
+ *   $groups / $groupCounts / $rosterCount  见 _person_groups.php 的说明
+ */
+?>
+<div class="page-head">
+  <h1>名册设置</h1>
+  <span class="sub">分组</span>
+  <div class="actions">
+    <a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">返回名册</a>
+    <?php $plSetCurrent = 'groups'; require __DIR__ . '/_settings_menu.php'; ?>
+  </div>
+</div>
+
+<?php require __DIR__ . '/../_person_groups.php'; ?>