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 与本地一致、错误日志无新增。
2026-10-03 19:27:14 +08:00
parent 218cdf74fc
commit b5725b449a
14 changed files with 1639 additions and 81 deletions
@@ -55,14 +55,11 @@ $shortKind    = \App\Birthday::KINDS;
        <?= $isSelf ? '编辑我的资料' : '编辑资料' ?>
      </a>
    <?php endif; ?>
-    <?php if ($admin): ?>
-      <form method="post" action="<?= e(url('people/destroy')) ?>" style="display:inline"
-            onsubmit="return confirm('确定要从名册里移除 <?= e($p['name']) ?> 吗？相关的账号与亲属关系也会一起删掉。')">
-        <?= csrf_field() ?>
-        <input type="hidden" name="id" value="<?= $pid ?>">
-        <button class="btn btn-danger btn-sm" type="submit">移除</button>
-      </form>
-    <?php endif; ?>
+    <?php /* 用户 2026-10-03 第 2 条：右上角那个「移除」换成**返回**（回名册列表）。
+             理由：详情页最常做的事是"看完回去"，而"移除"是低频且危险的破坏性操作，
+             不该占着右上角最顺手的位置。
+             「删除」已移到页面最下方、放在「开通登录账号」下面（见文件末尾）。 */ ?>
+    <a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">返回</a>
  </div>
 </div>

@@ -177,7 +174,36 @@ $shortKind    = \App\Birthday::KINDS;
            <dd><?= e((string)$r['value']) ?></dd>
          </div>
        <?php endforeach; ?>
-        <?php if (!empty($p['org']) || !empty($p['title'])): ?>
+        <?php /* 用户 2026-10-03 第 4 条：工作单位/职务/职称**可以有多段** —— 所以这里列出
+             完整的"工作经历"（当前那段标「现在」），而不是只显示一个"当前单位"。
+             ⚠️ 老数据（只有 persons.org/title、没有经历行）也要照常显示：
+                那样的情况下退回显示原来那一行（见下面的 $jobs 为空分支）。 */ ?>
+        <?php if ($jobs): ?>
+          <div class="kv-row">
+            <dt>工作</dt>
+            <dd>
+              <ul class="job-history">
+                <?php foreach ($jobs as $j): ?>
+                  <?php $isNow = ($j['end_ym'] === null || $j['end_ym'] === ''); ?>
+                  <li class="job-history-item">
+                    <?php if ($isNow): ?><span class="node-badge">现在</span><?php endif; ?>
+                    <span class="job-org"><?= e((string)($j['org'] ?? '')) ?></span>
+                    <?php $jt = \App\PersonJob::joinTitle($j['title'] ?? '', $j['rank_name'] ?? ''); ?>
+                    <?php if ($jt !== null): ?><span class="job-title"><?= e($jt) ?></span><?php endif; ?>
+                    <?php if (($j['start_ym'] ?? '') !== '' || ($j['end_ym'] ?? '') !== ''): ?>
+                      <span class="small muted job-span">
+                        <?= e((string)($j['start_ym'] ?? '')) ?> ~ <?= $isNow ? '现在' : e((string)($j['end_ym'] ?? '')) ?>
+                      </span>
+                    <?php endif; ?>
+                    <?php if (($j['note'] ?? '') !== ''): ?>
+                      <span class="small muted">（<?= e((string)$j['note']) ?>）</span>
+                    <?php endif; ?>
+                  </li>
+                <?php endforeach; ?>
+              </ul>
+            </dd>
+          </div>
+        <?php elseif (!empty($p['org']) || !empty($p['title'])): ?>
          <div class="kv-row">
            <dt>工作</dt>
            <dd><?= e(trim((string)$p['org'] . (($p['org'] ?? '') !== '' && ($p['title'] ?? '') !== '' ? ' · ' : '') . (string)$p['title'])) ?></dd>
@@ -198,8 +224,11 @@ $shortKind    = \App\Birthday::KINDS;
            <dd class="mono"><?= e((string)$r['value']) ?></dd>
          </div>
        <?php endforeach; ?>
+        <?php /* 用户 2026-10-03 第 5 条：备注分两种 ——
+             ① 他本人写的「自我介绍」（谁都能看，就是他愿意公开说的那句）；
+             ② 我对他的私人备注（**只有我自己看得到**，见下面单独一块）。 */ ?>
        <?php if (!empty($p['note'])): ?>
-          <div class="kv-row"><dt>备注</dt><dd><?= nl2br(e($p['note'])) ?></dd></div>
+          <div class="kv-row"><dt>自我介绍</dt><dd><?= nl2br(e($p['note'])) ?></dd></div>
        <?php endif; ?>
        <div class="kv-row">
          <dt>最近登录</dt>
@@ -208,6 +237,31 @@ $shortKind    = \App\Birthday::KINDS;
      </dl>
    </div>

+    <?php /* ============ 我对他的私人备注（用户 2026-10-03 第 5 条）============
+         只有**写的人自己**看得到（存在 person_notes，按 viewer 区分）。
+         ⚠️ 不是 person.note —— 那是"他愿意公开说的自我介绍"。
+            这一块属于"我和他之间的事"（怎么认识的、要注意什么），
+            所以它只出现在我的视角里，而且别人（包括他本人）看不到。 */ ?>
+    <?php if (!$isSelf): ?>
+      <div class="card card-pad my-note-card" style="margin-top:16px">
+        <h2 class="section-title">
+          我对 <?= e($pShown) ?> 的备注
+          <span class="hint">只有我自己看得到</span>
+        </h2>
+        <form method="post" action="<?= e(url('people/note')) ?>">
+          <?= csrf_field() ?>
+          <input type="hidden" name="id" value="<?= $pid ?>">
+          <label class="sr-only" for="pn-note">我对他的备注</label>
+          <textarea class="input" id="pn-note" name="note" rows="2"
+                    placeholder="怎么认识的、要注意什么、上次见面聊了什么……"><?= e((string)$myNote) ?></textarea>
+          <div class="btn-row" style="margin-top:8px">
+            <button class="btn btn-sm" type="submit">保存备注</button>
+            <span class="small muted">别人看不到这一栏（包括他本人）</span>
+          </div>
+        </form>
+      </div>
+    <?php endif; ?>
+
    <!-- ============ 我叫他/她什么（视角属性，只有我自己能改） ============ -->
    <?php if (!$isSelf): ?>
      <div class="card card-pad" style="margin-top:16px">
@@ -507,6 +561,32 @@ $shortKind    = \App\Birthday::KINDS;
  </div>
 </div>

+<?php /* ==================== 危险操作：删除（用户 2026-10-03 第 2 条）====================
+     「删除」从右上角搬到了页面**最下方**、「开通登录账号」下面。
+     放在最后 + 用 <details> 两步确认：破坏性操作不该一眼就看到、更不该一键完成。
+     ⚠️ 措辞改成了「从名册中删除」并写明会连带删掉什么 ——
+       原来那句"从名册里移除"听着像"只是从我的名册里移走"，
+       实际会删账号与亲属关系，说法与后果不符。 */ ?>
+<?php if ($admin): ?>
+  <div class="danger-zone">
+    <details class="del-wrap">
+      <summary class="link-quiet">删除这个人…</summary>
+      <div class="del-confirm">
+        <p class="small muted" style="margin:0 0 8px;flex:1 1 100%">
+          会把他从名册中删除，**并且**删掉他的登录账号与全部亲属关系连线（不可恢复）。
+          如果你只是想让他从<b>你的</b>名册里消失，用名册列表上的「⋯ → 从我的名册移走」。
+        </p>
+        <form method="post" action="<?= e(url('people/destroy')) ?>"
+              onsubmit="return confirm('确定要删除 <?= e($p['name']) ?> 吗？账号与亲属关系会一起删掉，无法恢复。')">
+          <?= csrf_field() ?>
+          <input type="hidden" name="id" value="<?= $pid ?>">
+          <button class="btn btn-danger btn-sm" type="submit">确认删除</button>
+        </form>
+      </div>
+    </details>
+  </div>
+<?php endif; ?>
+
 <script>
 // 关系表单的「是哪一位」下拉有**两种含义**：
 //   kind=parent → 对方是父亲/母亲（填的是对方）