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/settings/me.php

@@ -313,149 +313,173 @@ $fbCityN = count(\App\Geo::CITIES);
   内置了 <b><?= (int)$fbCityN ?></b> 个城市（全国地级市 + 直辖市），一般常用的都在里面。
 </p>
 
-<!-- ==================== 我的分组 ==================== -->
+<?php /* 🔴 v52（用户 2026-10-15 第 6 条）：「原来个人设置那里的名册分组……
+         这样**个人设置中就不显示名册分组的内容**了。」
+       ⇒ 整块「我的分组」卡片**搬到了**「名册 → 设置 → 名册分组」
+          （`templates/people/settings.php` + `templates/_person_groups.php`）。
+       ⚠️ 是**真的搬走**，不是复制一份：两份一模一样的分组管理界面，
+          改一处忘一处是必然的。这里只留一句指路，免得老用户找不到。 */ ?>
 <div class="card card-pad" style="margin-top:20px">
-  <h2 class="section-title">
-    我的分组
-    <span class="hint">公共的 + 我自己加的</span>
-  </h2>
-  <p class="small muted" style="margin:0 0 16px">
-    名册是按「关系分组」分栏显示的。这里有两层：
-    <b>公共分组</b>由管理员在「系统设置」里维护（全家都能用）；
-    你要是觉得不够，就在下面<b>加只给自己看的分组</b>，别人看不到、也不受影响。
-    <br>
-    列表里 <b>{{ 公共 }}</b> 标的是大家共用的那几个。
-    哪一组排前面也是你自己的习惯，用 ▲ ▼ 调 —— 别人看到的顺序不变。
-    <br>
-    你的名册现在有 <b><?= (int)$rosterCount ?></b> 人。
+  <h2 class="section-title">名册分组</h2>
+  <p class="small muted" style="margin:0 0 12px">
+    分组改到**名册页**那边去了 —— 它本来就是"名册怎么分组"的事，与个人设置无关。
   </p>
-
-  <?php if (!$groups): ?>
-    <p class="small muted" style="margin:0 0 14px">还没有分组。加一个吧。</p>
-  <?php else: ?>
-    <ol class="order-list">
-      <?php foreach ($groups as $i => $g): $gid = (int)$g['id']; $own = (int)$g['owner_id']; ?>
-        <li class="order-row">
-          <span class="order-no"><?= $i + 1 ?></span>
-          <span class="order-name">
-            <?= e((string)$g['name']) ?>
-            <?php if ($own === 0): ?><span class="badge">公共</span><?php else: ?><span class="badge badge-open">我的</span><?php endif; ?>
-          </span>
-          <span class="order-count"><?= (int)($groupCounts[$gid] ?? 0) ?> 人</span>
-          <form method="post" action="<?= e(url('settings/groups/move')) ?>" class="order-move">
-            <?= csrf_field() ?>
-            <input type="hidden" name="id" value="<?= $gid ?>">
-            <input type="hidden" name="scope" value="me">
-            <button class="btn btn-ghost btn-sm" type="submit" name="dir" value="up"
-                    title="上移一组" <?= $i === 0 ? 'disabled' : '' ?>>▲</button>
-            <button class="btn btn-ghost btn-sm" type="submit" name="dir" value="down"
-                    title="下移一组" <?= $i === $groupTotal - 1 ? 'disabled' : '' ?>>▼</button>
-          </form>
-        </li>
-      <?php endforeach; ?>
-    </ol>
-  <?php endif; ?>
-
-  <form method="post" action="<?= e(url('settings/groups/add')) ?>" class="inline-form" style="margin-top:16px">
-    <?= csrf_field() ?>
-    <input type="hidden" name="scope" value="me">
-    <label class="sr-only" for="newMyGroup">新分组名</label>
-    <input class="input" id="newMyGroup" name="name" maxlength="20" placeholder="例如：球友、老同学">
-    <button class="btn btn-sm" type="submit">加一个我自己的分组</button>
-  </form>
-
-  <?php
-  // 只有我自己建的分组才给改名 / 删除 —— 公共分组要在系统设置里改（那是管理员的事），
-  // 免得有人在自己设置里把"家人"改成别的、影响全家。
-  $mineGroups = array_values(array_filter($groups, fn($g) => (int)$g['owner_id'] > 0));
-  ?>
-  <?php if ($mineGroups): ?>
-    <ul class="group-manage" style="margin-top:14px">
-      <?php foreach ($mineGroups as $g): $gid = (int)$g['id']; ?>
-        <li class="group-manage-row">
-          <form method="post" action="<?= e(url('settings/groups/rename')) ?>" class="group-rename">
-            <?= csrf_field() ?>
-            <input type="hidden" name="id" value="<?= $gid ?>">
-            <input type="hidden" name="scope" value="me">
-            <label class="sr-only" for="gname<?= $gid ?>">分组名</label>
-            <input class="input" id="gname<?= $gid ?>" name="name" maxlength="20"
-                   value="<?= e((string)$g['name']) ?>">
-            <button class="btn btn-ghost btn-sm" type="submit">改名</button>
-          </form>
-          <span class="group-count muted small"><?= (int)($groupCounts[$gid] ?? 0) ?> 人</span>
-          <?php /* 删除做成两步（<details>），不用 JS 也能防手滑 —— 一点就没了太容易出事 */ ?>
-          <details class="del-wrap">
-            <summary class="btn btn-ghost btn-sm">删除</summary>
-            <form method="post" action="<?= e(url('settings/groups/delete')) ?>" class="del-confirm">
-              <?= csrf_field() ?>
-              <input type="hidden" name="id" value="<?= $gid ?>">
-              <input type="hidden" name="scope" value="me">
-              <span class="small muted">这组的人会变成「未分类」，确定？</span>
-              <button class="btn btn-ghost btn-sm danger" type="submit">确认删除</button>
-            </form>
-          </details>
-        </li>
-      <?php endforeach; ?>
-    </ul>
-  <?php endif; ?>
-
-  <?php if (\App\Auth::isAdmin()): ?>
-    <p class="small muted" style="margin:16px 0 0">
-      公共分组在「<a href="<?= e(url('settings')) ?>#public-groups">系统设置</a>」里维护。
-    </p>
-  <?php endif; ?>
+  <div class="btn-row">
+    <a class="btn btn-ghost btn-sm" href="<?= e(url('people/settings')) ?>">去名册设置里改分组</a>
+  </div>
 </div>
 
-<!-- ==================== 首页上的模块（用户 2026-10-03 第 3 条）==================== -->
-<?php /* 与下面「导航条上的模块」是同一套交互（勾选 + 拖动/▲▼ 排序），
-         只是作用对象换成首页 dashboard 上那几张模块卡。
-         两块都要有：导航条管"能不能进"，这里管"首页上先看到什么"。 */ ?>
-<div class="card card-pad" id="home-mods" style="margin-top:20px">
+<!-- ==================== 模块：导航 / 首页 / 颜色 / 顺序（v52 用户第 7 条）==================== -->
+<?php /* 🔴🔴 v52（用户 2026-10-15 第 7 条）：「个人设置里面，模块相关的设置太多了，应该**整合**，
+         先列出来所有模块，中间有一列，让他勾选是否在导航显示，再给他一列，让他选择是否在首页显示，
+         再给他一列，让他选择颜色，最后给他一列，让他**调整顺序**，这样就把几个设置，整合到一起了，
+         更加简洁。」
+
+       ⇒ 原来是**三张卡、三个表单、三次保存**：
+           ① 首页上的模块（勾选 + 排序）
+           ② 导航条上的模块（勾选 + 排序）
+           ③ 模块主题色（改色）
+         同一串模块名出现两遍、颜色又另起一张 —— 用户看得累、改起来要点三次保存。
+       ⇒ 现在合成**一张表**：一行一个模块，四列 = 导航 / 首页 / 颜色 / 顺序。
+         提交走 `settings/modules_save`（它内部把三个 save 依次调一遍，见 index.php 的说明）。
+
+       ⚠️ 颜色那一列的权限**没有变**：它仍是家庭一份、只有管理员能改；
+          非管理员那一列显示成只读色块（看得到、改不了）。
+       ⚠️ 拖动排序仍搬整行（行自带 order[]），▲▼ 是没 JS 时的兜底 —— 两条路都在。 */
+$plMAll   = \App\Module::keys();
+$plMNav   = array_map('strval', (array)(\App\Module::navFor((int)\App\Auth::personId())));
+$plMHome  = array_map('strval', (array)(\App\HomeMods::forPerson((int)\App\Auth::personId())));
+$plMColor = \App\Module::colors((int)\App\Auth::familyId());
+$plMIsAdmin = \App\Auth::isAdmin();
+// 行的顺序：导航里显示的按导航顺序在前（那是用户最在意的），其余按默认顺序在后
+$plMOrder = [];
+foreach ($plMNav as $k) { if (in_array($k, $plMAll, true)) { $plMOrder[] = $k; } }
+foreach ($plMAll as $k) { if (!in_array($k, $plMOrder, true)) { $plMOrder[] = $k; } }
+?>
+<div class="card card-pad" id="modules" style="margin-top:20px">
   <h2 class="section-title">
-    首页上的模块
-    <span class="hint">勾上才会出现在首页，拖动可改顺序</span>
+    模块设置
+    <span class="hint">导航 / 首页 / 颜色 / 顺序，一页改完</span>
   </h2>
   <p class="small muted" style="margin:0 0 16px">
-    首页是"一眼看家里近况"的地方，模块太多会变成一面墙 —— 这里只挑你想每天看到的几个。
-    关掉的模块<b>照样能从顶部导航条进去</b>，只是不在首页上占位置。
+    模块越来越多，但每个人关心的不一样 —— 这里一行一个模块：
+    <b>导航</b>管"顶栏上有没有它"，<b>首页</b>管"打开首页看不看得到"，
+    <b>颜色</b>是进到那个模块后顶栏高亮的色（<b>全家共用一套</b>），
+    <b>顺序</b>用拖动手柄或 ▲▼ 调。
+    <br>关掉的模块<b>不会丢数据</b>，只是从顶栏 / 首页收起来，别处仍能进。
   </p>
 
-  <form method="post" action="<?= e(url('settings/home_save')) ?>" id="homeForm">
+  <form method="post" action="<?= e(url('settings/modules_save')) ?>" id="modulesForm">
     <?= csrf_field() ?>
-    <ol class="order-list mod-order" id="homeOrderList">
-      <?php
-      $hOn = array_map('strval', (array)($homeOn ?? []));
-      $hOrder = (array)($homeOrder ?? []);
-      ?>
-      <?php foreach ($hOrder as $i => $k): ?>
-        <li class="order-row mod-row" draggable="true" data-key="<?= e($k) ?>">
-          <span class="drag-handle" title="拖我排序" aria-hidden="true">⋮⋮</span>
-          <input type="hidden" name="order[]" value="<?= e($k) ?>">
-          <label class="mod-pick">
-            <input type="checkbox" name="on[]" value="<?= e($k) ?>"
-                   <?= in_array($k, $hOn, true) ? 'checked' : '' ?>>
-            <span class="color-preview"
-                  style="background: <?= e(\App\Module::color($k, (int)\App\Auth::familyId())) ?>;"></span>
-            <span class="order-name"><?= e(\App\Module::name($k)) ?></span>
-          </label>
-          <span class="order-move">
-            <button class="btn btn-ghost btn-sm" type="submit" name="move" value="up:<?= e($k) ?>"
-                    title="上移" <?= $i === 0 ? 'disabled' : '' ?>>▲</button>
-            <button class="btn btn-ghost btn-sm" type="submit" name="move" value="down:<?= e($k) ?>"
-                    title="下移" <?= $i === count($hOrder) - 1 ? 'disabled' : '' ?>>▼</button>
-          </span>
-        </li>
-      <?php endforeach; ?>
-    </ol>
-    <div class="btn-row">
-      <button class="btn" type="submit" name="save" value="1">保存首页显示</button>
+    <div class="mod-table-wrap">
+      <table class="mod-table">
+        <thead>
+          <tr>
+            <th class="mod-th-order">顺序</th>
+            <th class="mod-th-name">模块</th>
+            <th class="mod-th-on">导航</th>
+            <th class="mod-th-on">首页</th>
+            <th class="mod-th-color">颜色</th>
+          </tr>
+        </thead>
+        <tbody id="modRows">
+          <?php foreach ($plMOrder as $i => $k): ?>
+            <tr class="mod-row" draggable="true" data-key="<?= e($k) ?>">
+              <td class="mod-td-order">
+                <span class="drag-handle" title="拖我排序" aria-hidden="true">⋮⋮</span>
+                <?php /* ⚠️ 顺序就藏在 DOM 里：每行自带 order[] 隐藏域，拖动搬整行 ⇒
+                         提交上来的顺序天然就是屏幕上的顺序（与旧的两块同一手法）。 */ ?>
+                <input type="hidden" name="order[]" value="<?= e($k) ?>">
+                <span class="mod-move">
+                  <button class="btn btn-ghost btn-sm" type="submit" name="move" value="up:<?= e($k) ?>"
+                          title="上移" <?= $i === 0 ? 'disabled' : '' ?>>▲</button>
+                  <button class="btn btn-ghost btn-sm" type="submit" name="move" value="down:<?= e($k) ?>"
+                          title="下移" <?= $i === count($plMOrder) - 1 ? 'disabled' : '' ?>>▼</button>
+                </span>
+              </td>
+              <td class="mod-td-name">
+                <span class="color-preview" style="background: <?= e((string)($plMColor[$k] ?? '#888')) ?>;"></span>
+                <?= e(\App\Module::name($k)) ?>
+              </td>
+              <td class="mod-td-on">
+                <label class="mod-chk" title="显示在顶部导航条">
+                  <input type="checkbox" name="nav[]" value="<?= e($k) ?>"
+                         <?= in_array($k, $plMNav, true) ? 'checked' : '' ?>>
+                </label>
+              </td>
+              <td class="mod-td-on">
+                <label class="mod-chk" title="显示在首页">
+                  <input type="checkbox" name="home[]" value="<?= e($k) ?>"
+                         <?= in_array($k, $plMHome, true) ? 'checked' : '' ?>>
+                </label>
+              </td>
+              <td class="mod-td-color">
+                <?php if ($plMIsAdmin): ?>
+                  <input type="color" class="color-picker" name="c[<?= e($k) ?>]"
+                         value="<?= e((string)($plMColor[$k] ?? '#888888')) ?>"
+                         aria-label="<?= e(\App\Module::name($k)) ?>的颜色">
+                <?php else: ?>
+                  <?php /* 非管理员：看得到颜色、改不了（家庭一份，见本页说明） */ ?>
+                  <span class="color-preview mod-color-ro"
+                        style="background: <?= e((string)($plMColor[$k] ?? '#888')) ?>;"
+                        title="由管理员设置"></span>
+                <?php endif; ?>
+              </td>
+            </tr>
+          <?php endforeach; ?>
+        </tbody>
+      </table>
+    </div>
+    <div class="btn-row" style="margin-top:14px">
+      <button class="btn" type="submit" name="save" value="1">保存模块设置</button>
+      <?php if ($plMIsAdmin): ?>
+        <span class="small muted">颜色是全家共用的一套，改了对所有人都生效。</span>
+      <?php else: ?>
+        <span class="small muted">颜色由管理员设置，你这里只读。</span>
+      <?php endif; ?>
     </div>
   </form>
 </div>
 
-<!-- ==================== 模块：导航条上显示哪些、各自什么主题色 ==================== -->
-<?php
-$navKeys = \App\Module::navFor((int)\App\Auth::personId());
-$colors  = \App\Module::colors((int)\App\Auth::familyId());
-require __DIR__ . '/_modules.php';
-?>
+<script>
+(function () {
+  /* 拖动排序（▲▼ 是不用 JS 的兜底，两条路都能用）。
+     ⚠️ 搬的是整行 <tr> —— 它自带的 order[] 隐藏域跟着走，
+        所以提交上来的顺序 = 屏幕上的顺序，不用再同步一遍。 */
+  var list = document.getElementById('modRows');
+  if (!list) { return; }
+  var dragEl = null;
+  Array.prototype.forEach.call(list.querySelectorAll('.mod-row'), function (tr) {
+    tr.addEventListener('dragstart', function (ev) {
+      dragEl = tr;
+      tr.classList.add('is-dragged');
+      if (ev.dataTransfer) { ev.dataTransfer.effectAllowed = 'move'; }
+    });
+    tr.addEventListener('dragend', function () {
+      tr.classList.remove('is-dragged');
+      dragEl = null;
+      Array.prototype.forEach.call(list.querySelectorAll('.mod-row'), function (x) {
+        x.classList.remove('is-drop-before');
+      });
+    });
+    tr.addEventListener('dragover', function (ev) {
+      if (!dragEl || dragEl === tr) { return; }
+      ev.preventDefault();
+      var box = tr.getBoundingClientRect();
+      tr.classList.toggle('is-drop-before', ev.clientY < box.top + box.height / 2);
+    });
+    tr.addEventListener('dragleave', function () { tr.classList.remove('is-drop-before'); });
+    tr.addEventListener('drop', function (ev) {
+      if (!dragEl || dragEl === tr) { return; }
+      ev.preventDefault();
+      var box = tr.getBoundingClientRect();
+      if (ev.clientY < box.top + box.height / 2) {
+        list.insertBefore(dragEl, tr);
+      } else {
+        list.insertBefore(dragEl, tr.nextSibling);
+      }
+      tr.classList.remove('is-drop-before');
+    });
+  });
+})();
+</script>