v24 第 9 批：名册九条（分组按钮/加入名册/生日月日/地址四级/千人性能/拖动修复/删除人员/返回名册/Semi DatePicker）

- #131 名册卡片加「分组」按钮（details+radio，显示当前分组，选中即改）
- #132 修复「从已有人里加入名册」无反应
- #133 生日只显示月和日（阳历 MM-DD / 农历中文名），PersonQuery::birthdaysOf 取代 birthdayOf
- #134 地址结构化为 国家/省/市/区+详细：regions 表（3429 行全国区划）+ Region.php +
  ?r=regions 级联接口 + 表单 .addr-grid + 老地址回填（Schema v16）
- #135 千人名册性能：.person content-visibility:auto + 名册页 ob_gzhandler
  （实测 服务端 1.15s/3.8MB → 0.17s/87KB；客户端导航→load 1.35s → 0.37s）
- #136 拖动排序改 Pointer Events（Chrome 下 HTML5 DnD 在 DOM 变动时断）
- #137 个人详情页底部「删除人员」
- #138 编辑资料页加「返回名册」
- #139 所有日期选择换 Semi Design DatePicker（渐进增强：原生四字段保 POST 契约，
  懒加载 vendor semi UMD，值回写原字段；工作经历 type=month 一并升级；宣纸主题对齐）

验证：e2e 785/0、batch9 37/0、upgrade 126/0、picker 28/0、mobile 688/0、interact 97/0、
batch_e 91/0、import 21/0、douban 22/0、drag 5/0、semi-integrate 28/0、semi-probe 17/0、
geom 5/5；部署后线上自检 16/16（含 4 个 semi 资源 200 + regions 路由）。

templates/_datetime.php

@@ -36,13 +36,23 @@ $dtHour = $dtTs ? (int)date('G', $dtTs) : 0;   // G = 0..23，天然 24 小时
 $dtMin  = $dtTs ? (int)date('i', $dtTs) : 0;
 $dtSec  = $dtTs ? (int)date('s', $dtTs) : 0;
 ?>
-<div class="dt-input">
-  <input type="date" class="dt-date" name="<?= e($dtName) ?>_date"
-         <?= $dtId !== '' ? 'id="' . e($dtId) . '"' : '' ?>
-         value="<?= e($dtDate) ?>"<?= $dtRequired ? ' required' : '' ?>
-         aria-label="日期">
-  <span class="dt-time">
-    <select class="dt-hour" name="<?= e($dtName) ?>_hour" aria-label="时（24 小时制）">
+<?php /* v24 第 9 批 #9：所有日期选择换 Semi Design DatePicker（用户点名，样式与宣纸主题统一）。
+   策略是**渐进增强**，原生四字段原样保留：
+   · 表单契约（*_date/_hour/_minute/_second → read_dt_input()）不变，服务端零改动；
+   · Semi 资源（3.4 MB JS）只有页面真出现 .dt-input 才由 app.js 懒加载；
+   · 加载成功 → 隐藏 .dt-native、在 .dt-semi 里挂 DatePicker，值回写原字段；
+   · 加载失败/断网 → 原生控件原样可见可用，页面不会坏。 */
+$dtCfg = ['name' => $dtName, 'seconds' => $dtSeconds, 'required' => $dtRequired, 'id' => $dtId];
+?>
+<div class="dt-input" data-dt="<?= e(json_encode($dtCfg, JSON_UNESCAPED_UNICODE | JSON_HEX_APOS | JSON_HEX_QUOT)) ?>">
+  <span class="dt-semi" aria-hidden="true"></span>
+  <span class="dt-native">
+    <input type="date" class="dt-date" name="<?= e($dtName) ?>_date"
+           <?= $dtId !== '' ? 'id="' . e($dtId) . '"' : '' ?>
+           value="<?= e($dtDate) ?>"<?= $dtRequired ? ' required' : '' ?>
+           aria-label="日期">
+    <span class="dt-time">
+      <select class="dt-hour" name="<?= e($dtName) ?>_hour" aria-label="时（24 小时制）">
       <?php for ($dtH = 0; $dtH < 24; $dtH++): $hv = sprintf('%02d', $dtH); ?>
         <option value="<?= $hv ?>"<?= $dtH === $dtHour ? ' selected' : '' ?>><?= $hv ?></option>
       <?php endfor; ?>
@@ -64,10 +74,11 @@ $dtSec  = $dtTs ? (int)date('s', $dtTs) : 0;
         <?php endfor; ?>
       </select>
     <?php endif; ?>
+    </span>
   </span>
 </div>
 <?php /* 用完即清，避免残留变量影响下一次 include */ unset(
-    $dtName, $dtValue, $dtRequired, $dtId, $dtSeconds,
+    $dtName, $dtValue, $dtRequired, $dtId, $dtSeconds, $dtCfg,
     $dtTs, $dtTsTmp, $dtDate, $dtHour, $dtMin, $dtSec,
     $dtH, $dtM, $dtS, $hv, $mv, $sv
 ); ?>

templates/layout.php

@@ -38,6 +38,16 @@ $isLoggedIn = \App\Auth::check();
 <link rel="manifest" href="/site.webmanifest">
 <meta name="theme-color" content="#A84A28">
 <link rel="stylesheet" href="<?= e(asset('/assets/css/app.css')) ?>">
+<?php /* v24 第 9 批 #9：Semi Design DatePicker 懒加载清单（用户点名 semi.design）。
+       这里只登记带版本号的资源地址，**不加载** —— app.js 只有在页面上真出现
+       .dt-input（templates/_datetime.php）时才去下这 4 个文件（合计约 4 MB，
+       绝不能让没有日期控件的页面白拉）。 */ ?>
+<meta name="fb-semi" content="<?= e(json_encode([
+    'css'   => asset('/assets/vendor/semi/semi.min.css'),
+    'react' => asset('/assets/vendor/semi/react.min.js'),
+    'dom'   => asset('/assets/vendor/semi/react-dom.min.js'),
+    'ui'    => asset('/assets/vendor/semi/semi-ui.min.js'),
+], JSON_UNESCAPED_UNICODE | JSON_HEX_APOS | JSON_HEX_QUOT)) ?>">
 </head>
 <?php /* 主题色：把 --brand / --brand-2 / --brand-ink 三个变量在 <body> 上换成本模块的色，
          下面所有用到品牌色的地方（按钮、链接、页头高亮…）自动跟着变。

templates/people/form.php

@@ -54,6 +54,12 @@ $ctHints = [
 <div class="page-head">
   <h1><?= $isEdit ? ($isSelf ? '我的资料' : '编辑成员') : '添加成员' ?></h1>
   <span class="sub"><?= $isEdit ? e($person['name']) : '填姓名就行，其他都可以以后再补' ?></span>
+  <?php /* 用户 2026-10-04 第 8 条：编辑资料的页面也要能**回到名册**。
+           编辑时是从名册点进来的，改完最常做的下一件事就是回名册找下一个人 ——
+           没有这个按钮就只能靠浏览器后退（而提交保存之后后退会退到旧页面上）。 */ ?>
+  <div class="actions">
+    <a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">返回名册</a>
+  </div>
 </div>
 
 <form method="post" enctype="multipart/form-data"
@@ -249,10 +255,69 @@ $ctHints = [
       </div>
       <?php endif; ?>
 
+      <?php /* 用户 2026-10-04 第 4 条：地址拆成**国家 / 省 / 市 / 区 / 详细地址**五级。
+               前四级是级联下拉（数据在 regions 表里，全国 3429 条），
+               最后一级 `address` 就是原来的自由文本 —— 没那么详细时**只填到区**即可，
+               四个下拉里没选的那些存 NULL，不会留下一堆空串。
+               ⚠️ 没有 JS 也能用：省/市/区三个下拉在服务端就把**当前这一条链**的选项渲染好了，
+                  JS 只负责"换了省就把市和区跟着换"（见 assets/js/app.js 的 addr 段）。 */ ?>
       <div class="field full">
-        <label for="address">住址</label>
-        <input class="input" id="address" name="address"
-               value="<?= e(old('address', $person['address'] ?? '')) ?>" placeholder="可留空">
+        <label for="addr_province">住址</label>
+        <div class="addr-grid" data-addr
+             data-src="<?= e(url('regions')) ?>">
+          <span class="addr-cell">
+            <span class="addr-k">国家</span>
+            <input class="input" id="addr_country" name="addr_country"
+                   value="<?= e(old('addr_country', $person['addr_country'] ?? '')) ?>"
+                   placeholder="中国" autocomplete="country-name">
+          </span>
+          <span class="addr-cell">
+            <span class="addr-k">省 / 自治区</span>
+            <select class="select" id="addr_province" name="addr_province" data-addr-lvl="1">
+              <option value="">（不填）</option>
+              <?php foreach (\App\Region::provinces() as $rg): ?>
+                <option value="<?= e($rg['name']) ?>" data-code="<?= e($rg['code']) ?>"
+                  <?= old('addr_province', $person['addr_province'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
+                  <?= e($rg['name']) ?></option>
+              <?php endforeach; ?>
+            </select>
+          </span>
+          <span class="addr-cell">
+            <span class="addr-k">市</span>
+            <?php $cityCode = \App\Region::codeOfName(old('addr_province', $person['addr_province'] ?? ''), 1); ?>
+            <select class="select" id="addr_city" name="addr_city" data-addr-lvl="2"
+                    data-code="<?= e($cityCode) ?>">
+              <option value="">（不填）</option>
+              <?php foreach (\App\Region::childrenOf($cityCode) as $rg): ?>
+                <option value="<?= e($rg['name']) ?>" data-code="<?= e($rg['code']) ?>"
+                  <?= old('addr_city', $person['addr_city'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
+                  <?= e($rg['name']) ?></option>
+              <?php endforeach; ?>
+            </select>
+          </span>
+          <span class="addr-cell">
+            <span class="addr-k">区 / 县</span>
+            <?php $distCode = \App\Region::codeOfName(old('addr_city', $person['addr_city'] ?? ''), 2); ?>
+            <select class="select" id="addr_district" name="addr_district" data-addr-lvl="3"
+                    data-code="<?= e($distCode) ?>">
+              <option value="">（不填）</option>
+              <?php foreach (\App\Region::childrenOf($distCode) as $rg): ?>
+                <option value="<?= e($rg['name']) ?>"
+                  <?= old('addr_district', $person['addr_district'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
+                  <?= e($rg['name']) ?></option>
+              <?php endforeach; ?>
+            </select>
+          </span>
+          <span class="addr-cell addr-cell-wide">
+            <span class="addr-k">详细地址</span>
+            <input class="input" id="address" name="address"
+                   value="<?= e(old('address', $person['address'] ?? '')) ?>"
+                   placeholder="街道门牌、小区楼号……没有就留空" autocomplete="street-address">
+          </span>
+        </div>
+        <span class="tip">
+          没有详细地址时只填到「区 / 县」就行 —— 四级里没选的那些不会显示。
+        </span>
       </div>
 
       <?php /* 用户 2026-10-03 第 5 条：备注分两种 ——

templates/people/index.php

@@ -65,8 +65,16 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
             $metaBits[] = ['家谱', '他在你的家谱树上（配偶/父母/子女/祖孙…），自动加入你的名册'];
         }
         if (!empty($p['is_placeholder'])) { $metaBits[] = ['待确认', '']; }
+        // 当前分组：行上那个「分组」按钮要**显示它**（用户 2026-10-04 第 1 条）。
+        // ⚠️ 只认「我能用的分组」里那几个 —— 挂在一个别人家的私自分组上时，
+        //    这里取不到名字，就按"未分类"显示（按钮照样能改成一个正常的分组）。
+        $curGid   = (int)($p['group_id'] ?? 0);
+        $grpName  = '';
+        foreach ($groups as $g) {
+            if ((int)$g['id'] === $curGid) { $grpName = (string)$g['name']; break; }
+        }
         ?>
-        <div class="person" data-person="<?= $pid ?>" <?= $canMove ? 'draggable="true"' : '' ?>
+        <div class="person" data-person="<?= $pid ?>"
              data-search="<?= e($pshow . ' ' . $pReal . ' ' . (string)($p['email'] ?? '') . ' ' . (string)($p['org'] ?? '') . ' ' . (string)($p['phone_plain'] ?? '')) ?>"
              <?php /* ⚠️ 首字母**分字段**、用空格隔开（前端逐段独立判子序列）。
                       把"姓名+称呼"拼成一串会造出跨字段巧合：用户实测「输 yy 搜出岳父」
@@ -79,7 +87,12 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
           <?php /* draggable="false" 很重要：链接与图片浏览器默认就是可拖的，
                    不关掉的话拖起来会变成"拖一个网址"，父卡片反而拿不到这次拖动。 */ ?>
           <a class="person-main" href="<?= e(url('people/show', ['id' => $pid])) ?>" draggable="false">
-            <div class="ph"><img src="<?= e(avatar_url($p['avatar'])) ?>" alt="" draggable="false"></div>
+            <?php /* ⚠️ loading="lazy" 是名册加载一千人还不卡的**关键**：
+                     头像全部走 media.php（每个都要启一次 PHP、查一次库、读一次存储），
+                     一千个并发拉下来页面就是"点了没反应"。懒加载之后只拉视口里那十几个。
+                     ⚠️ 别写成 JS 的 data-src 懒加载：那样没有 JS 就一张头像都没有。 */ ?>
+            <div class="ph"><img src="<?= e(avatar_url($p['avatar'])) ?>" alt="" draggable="false"
+                                 loading="lazy" decoding="async" width="52" height="52"></div>
             <div class="pb">
               <div class="pname">
                 <?php /* ⚠️ 姓名必须是 .pname 里的**第一段裸文本**，不要包 <span>。
@@ -100,15 +113,15 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
                 <?php endforeach; ?>
               </div>
               <?php
-              // 用户第 3 条：一行放齐「手机号 / 阴历+阳历生日（带年份）/ 邮箱 / 工作单位」。
+              // 用户第 3 条：一行放齐「手机号 / 生日 / 邮箱 / 工作单位」。
               // 没填的项**整个 <span> 都不画** —— 留一个空标签只会让每行都长一截。
-              // 生日优先阳历、其次农历，用 [阳历]/[农历] 小字标明是哪一个。
+              // 用户 2026-10-04 第 3 条：生日**阴历阳历都列**，且只显示月和日（不显示年）。
               $facts = [];
               if (($p['phone_plain'] ?? '') !== '') {
                   $facts[] = ['手机', (string)$p['phone_plain']];
               }
-              if (($p['birthday_show'] ?? '') !== '') {
-                  $facts[] = [(string)$p['birthday_kind'], (string)$p['birthday_show']];
+              foreach ((array)($p['birthdays'] ?? []) as [$bk, $bv]) {
+                  $facts[] = [(string)$bk, (string)$bv];
               }
               if (trim((string)($p['email'] ?? '')) !== '') {
                   $facts[] = ['邮箱', (string)$p['email']];
@@ -131,38 +144,59 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
                    藏进 ⋯ 里要点两下；而 ⋯ 里放的是"调整分组/移出名册"这类低频动作。
                    ⚠️ 它是 <a>，且必须在 person-main 这个 <a> **外面**
                       —— a 套 a 是非法 HTML，浏览器会把 DOM 拆开。 */ ?>
-          <a class="btn btn-ghost btn-sm person-edit" data-no-drag
-             href="<?= e(url('people/edit', ['id' => $pid])) ?>"
-             title="编辑 <?= e($pshow) ?> 的资料">编辑</a>
-          <?php if ($canMove): ?>
-            <details class="person-more" data-no-drag>
-              <summary aria-label="调整分组">⋯</summary>
-              <form method="post" action="<?= e(url('people/group')) ?>" class="person-move">
-                <?= csrf_field() ?>
-                <input type="hidden" name="person_id" value="<?= $pid ?>">
-                <label class="sr-only" for="pg<?= $pid ?>">分组</label>
-                <select class="select" id="pg<?= $pid ?>" name="group_id" data-no-drag>
-                  <option value="">未分类</option>
-                  <?php foreach ($groups as $g): $gid = (int)$g['id']; ?>
-                    <option value="<?= $gid ?>"
-                      <?= (int)($p['group_id'] ?? 0) === $gid ? 'selected' : '' ?>>
-                      <?= e((string)$g['name']) ?>
-                    </option>
-                  <?php endforeach; ?>
-                </select>
-                <button class="btn btn-ghost btn-sm" type="submit" data-no-drag>移动</button>
-              </form>
-              <?php if (($p['roster_source'] ?? '') === 'kin'): ?>
-                <p class="small muted person-move" style="margin:4px 0 0">因家谱关系自动加入；解除关系后自动移出。</p>
-              <?php else: ?>
-                <form method="post" action="<?= e(url('people/forget')) ?>" class="person-move">
+          <?php /* ⚠️ 行右侧三个动作收在一个 flex 容器里，**不再各自绝对定位**：
+                   原来「编辑」写死 right:46px、「⋯」写死 right:8px，再来第三个按钮
+                   就得继续猜偏移；而且「分组」按钮的宽度随分组名变化，写死必然重叠。
+                   容器贴右、内部自然排开，.person-main 也就不用再靠 padding 让位。 */ ?>
+          <div class="person-actions">
+            <?php if ($canMove): ?>
+              <?php /* 用户 2026-10-04 第 1 条：名册没有地方改分组了 → 加一个按钮，
+                       **直接显示当前分组**，点开就是分组列表，选中即改。
+                       ⚠️ 用 <details> 而不是新写一套弹窗 JS：没有 JS 时它照样能开、
+                       照样能提交（里面的「保存」按钮），开了 JS 只是"选中即提交"。
+                       ⚠️ 值是原生 radio，**提交的是 form** —— 与名册页原来的
+                       「移动」是同一个路由（people/group），服务端不用改。 */ ?>
+              <details class="person-group menu" data-no-drag>
+                <summary class="btn btn-ghost btn-sm person-group-btn<?= $grpName === '' ? ' is-none' : '' ?>"
+                         title="改 <?= e($pshow) ?> 的分组"><?= e($grpName !== '' ? $grpName : '分组') ?></summary>
+                <form method="post" action="<?= e(url('people/group')) ?>" class="pg-menu">
                   <?= csrf_field() ?>
                   <input type="hidden" name="person_id" value="<?= $pid ?>">
-                  <button class="btn btn-ghost btn-sm" type="submit" data-no-drag>从我的名册移走</button>
+                  <p class="pg-title">把「<?= e($pshow) ?>」分到</p>
+                  <label class="pg-item">
+                    <input type="radio" name="group_id" value=""<?= $curGid === 0 ? ' checked' : '' ?>>
+                    <span>未分类</span>
+                  </label>
+                  <?php foreach ($groups as $g): $gid = (int)$g['id']; ?>
+                    <label class="pg-item">
+                      <input type="radio" name="group_id" value="<?= $gid ?>"<?= $curGid === $gid ? ' checked' : '' ?>>
+                      <span><?= e((string)$g['name']) ?></span>
+                    </label>
+                  <?php endforeach; ?>
+                  <button class="btn btn-sm pg-save" type="submit">保存</button>
                 </form>
-              <?php endif; ?>
-            </details>
-          <?php endif; ?>
+              </details>
+            <?php endif; ?>
+            <a class="btn btn-ghost btn-sm person-edit" data-no-drag
+               href="<?= e(url('people/edit', ['id' => $pid])) ?>"
+               title="编辑 <?= e($pshow) ?> 的资料">编辑</a>
+            <?php if ($canMove): ?>
+              <details class="person-more menu" data-no-drag>
+                <summary aria-label="更多操作">⋯</summary>
+                <?php /* 「调整分组」那个下拉已经搬到上面的「分组」按钮里 —— 同一件事
+                         不做两处（留着反而会让人以为改了这边、那边没跟上）。 */ ?>
+                <?php if (($p['roster_source'] ?? '') === 'kin'): ?>
+                  <p class="small muted person-move" style="margin:0">因家谱关系自动加入；解除关系后自动移出。</p>
+                <?php else: ?>
+                  <form method="post" action="<?= e(url('people/forget')) ?>" class="person-move">
+                    <?= csrf_field() ?>
+                    <input type="hidden" name="person_id" value="<?= $pid ?>">
+                    <button class="btn btn-ghost btn-sm" type="submit" data-no-drag>从我的名册移走</button>
+                  </form>
+                <?php endif; ?>
+              </details>
+            <?php endif; ?>
+          </div>
         </div>
       <?php endforeach; ?>
     </div>

templates/people/show.php

@@ -209,8 +209,22 @@ $shortKind    = \App\Birthday::KINDS;
             <dd><?= e(trim((string)$p['org'] . (($p['org'] ?? '') !== '' && ($p['title'] ?? '') !== '' ? ' · ' : '') . (string)$p['title'])) ?></dd>
           </div>
         <?php endif; ?>
-        <?php if (!empty($p['address'])): ?>
-          <div class="kv-row"><dt>住址</dt><dd><?= e($p['address']) ?></dd></div>
+        <?php /* 用户 2026-10-04 第 4 条：地址是**结构化的**五级。
+                 显示时把「国家 + 省 + 市 + 区」拼成一行前缀、详细地址接在后面；
+                 一级都没填就退化成原来那一整串（老数据/只填了详细地址的情况）。
+                 ⚠️ 没有详细地址时**只显示到区**（不再跟着一个空的「·」）。 */ ?>
+        <?php
+        $addrHead = implode(' ', array_filter([
+            (string)($p['addr_country'] ?? ''),
+            (string)($p['addr_province'] ?? ''),
+            (string)($p['addr_city'] ?? ''),
+            (string)($p['addr_district'] ?? ''),
+        ], static fn($s) => trim($s) !== ''));
+        $addrTail = trim((string)($p['address'] ?? ''));
+        $addrFull = $addrHead !== '' ? $addrHead . ($addrTail !== '' ? ' ' . $addrTail : '') : $addrTail;
+        ?>
+        <?php if ($addrFull !== ''): ?>
+          <div class="kv-row"><dt>住址</dt><dd><?= e($addrFull) ?></dd></div>
         <?php endif; ?>
         <?php foreach (($contacts['address'] ?? []) as $r): ?>
           <div class="kv-row">