v24 第 6 轮：名册导入 / 两种备注 / 多段工作经历 / 家谱卡片与首字母检索修正

用户 2026-10-03 第二批（8 条）。逐条落点：

1. **名册导入**（新）：支持 **vCard 3.0/4.0（.vcf）** 与 **CSV/TSV**（中英文表头都认）。
   新增 `app/ContactImport.php`（纯解析）+ `app/ContactImporter.php`（判重+落库）。
   判重按 **手机号（哈希，精确）→ 姓名（大小写无关）**；命中已有的人**只补空字段，
   绝不覆盖**（批量覆盖没法回退）。
   解析上要处理的三件事都处理了：**折行接回**（长名字/地址会被按字节折断）、
   转义还原（`\,` `\;` `\n`）、多值收全（TEL/EMAIL/ADR 可能出现多次）。
   UTF-16/GBK 的 vcf 也认（手机导出的常见编码）。
2. 成员详情页：右上角「移除」→ **「返回」**（回名册）；「删除」移到页面**最下方**
   （在「开通登录账号」下面），并改成 `<details>` 两步确认 + 写清会连带删掉什么。
3. 编辑资料里的「这个人的一句话」**去掉** —— 那句话只能**本人**改。
   ⚠️ 落法是「这一栏只在改自己时出现」：用户要的是"别人不能替他写"，
   而不是"这句没人能填"；服务端也只在 `$isSelf` 时读表单，否则管理员一编辑就把它清空。
4. **工作单位 / 职务 / 职称可以有多段**（新表 `person_jobs`）：表单是一组"经历行"
   （单位/职务/职称/起止年月/备注，可 ＋/×），详情页按"现在 + 历史"列出。
   `persons.org/title` 保留，语义变成"当前那段的快照"（列表页等只要"现在在哪儿"），
   升级时把老的 org/title 回填成一段经历。
5/备注分两种：「自我介绍」（`persons.note`，他本人写的、别人看得到）与
   **「我对他的私人备注」**（新表 `person_notes`，每人每对象一条，**只有写的人自己看得到**）。
   详情页有独立的一块；表单里只在"编辑别人"时出现。
6. 成员表单：**头像放到最前**、去掉「选择文件」按钮（点那张默认头像即选文件）；
   表单标签统一 15px/600（原来 13–14px，和 12px 的灰字提示分不出层级）。
7. 名册列表：⋯ 前面加**「编辑」**按钮（改资料是高频动作，藏进 ⋯ 要点两下）。
8. 家谱：
   · **首字母检索 bug**：输入 `yy` 会搜出「岳父/洪勇」。根因是前端把
     **姓名与称呼的首字母拼成一串**再判子序列 —— 洪勇的称呼是"岳父" → `hy`+`yf`=`hyyf`
     → `yy` 跨字段命中。改成**逐字段独立判**（服务端本来就是逐字段判的，两边现在同口径）。
   · **卡片仍比头像宽**：头像是 **1:1（正方形）** 槽位，卡片里却写成 96×72 的长方形 +
     `object-fit: contain` → 照片被缩到 72 宽、左右各留 12px 白 → 看着"框比头像宽"。
     改成**正方形头像区 + `object-fit: cover`**（90×128 卡片，88×88 头像区）。
   · 右上角加**「我的家谱」**按钮（只在看别人的家谱时出现 —— 看自己的时候点它没意义）。

**测试新增**（都能变红，且做过反向验证）：
- `_fb_import_test.py` 21 条：新人新建 / 手机号命中不重复建人 / **已有字段一个都不被覆盖** /
  缺的字段被补上 / 反复导入幂等 / 只给姓名也能命中 / 认不出的文件被明确拒绝，
  外加 ⑱ **"有单位但没有经历行"的人**（最容易漏的覆盖路径）。
- `_fb_roster_filter_test.js`（jsdom，用真实渲染出的 HTML）8 条：直击
  「输 yy 不该命中 岳父/洪勇」；反向验证时把实现改回拼接写法 → ① 立刻红。
- 改动过程中被测试抓出**两个真 bug**并已修：
  ① 导入时给"已有单位的人"也插经历 → `PersonJob::syncCurrent()` 回写把这人的单位**覆盖**了；
  ② `syncCurrent()` 在经历表为空时会把 `persons.org/title` **清空** ——
     而它被"编辑资料"这类常规路径调用一次就触发，属于**随手一保存就丢数据**。
     现在空表直接 return（"经历表不是唯一的一份"）。

**战绩**：e2e **775/0** · 导入 21/0 · 第 5 轮专项 91/0 · 家谱 34/0 · 几何 428/0 ·
移动端 688/0 · 交互 97/0 · 升级 126/0。
线上：schema **v15**、指纹一致、`person_jobs`/`person_notes` 已建、
6 条老的"工作单位"全部回填成经历、13 个文件 md5 与本地一致、错误日志无新增。

templates/people/index.php

@@ -68,7 +68,11 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
         ?>
         <div class="person" data-person="<?= $pid ?>" <?= $canMove ? 'draggable="true"' : '' ?>
              data-search="<?= e($pshow . ' ' . $pReal . ' ' . (string)($p['email'] ?? '') . ' ' . (string)($p['org'] ?? '') . ' ' . (string)($p['phone_plain'] ?? '')) ?>"
-             data-initials="<?= e(\App\Pinyin::initials($pReal . ' ' . $pNick)) ?>">
+             <?php /* ⚠️ 首字母**分字段**、用空格隔开（前端逐段独立判子序列）。
+                      把"姓名+称呼"拼成一串会造出跨字段巧合：用户实测「输 yy 搜出岳父」
+                      —— 洪勇的称呼是"岳父" → hy + yf = hyyf → yy 跨边界命中。
+                      服务端 Pinyin::matches 本来就是逐字段判的，这样两边口径一致。 */ ?>
+             data-initials="<?= e(trim(\App\Pinyin::initials($pReal) . ' ' . \App\Pinyin::initials($pNick))) ?>">
           <?php if ($canMove): ?>
             <span class="drag-handle" title="拖到我想要的位置 / 那一栏" aria-hidden="true">⠿</span>
           <?php endif; ?>
@@ -122,6 +126,14 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
               <?php endif; ?>
             </div>
           </a>
+          <?php /* 用户 2026-10-03 第 7 条：在 ⋯ 前面加一个「编辑」按钮，快速进这个人的编辑页。
+                   为什么不做进 ⋯ 菜单里：改资料是**高频**操作（补生日、补电话），
+                   藏进 ⋯ 里要点两下；而 ⋯ 里放的是"调整分组/移出名册"这类低频动作。
+                   ⚠️ 它是 <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>
@@ -183,6 +195,12 @@ $renderBlock = function (int $gid, string $name, array $list) use ($renderGrid):
         从家里已有的人里挑（<?= $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()): ?>
       <a class="btn btn-sm" href="<?= e(url('people/new')) ?>">添加成员</a>
     <?php endif; ?>