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
@@ -0,0 +1,82 @@
+<?php
+/**
+ * 「我对某个人的私人备注」（v24 用户 2026-10-03 第 5 条）。
+ *
+ * 用户原话：「名册中，每个人的备注，都有两个，一个是他自己填写的，就好像他自己的
+ *            一个格言或者自我介绍；如果其他人打开这个人的信息，编辑备注，
+ *            是这个人对他的独有的备注，例如记录怎么跟这个人认识的等等。」
+ *
+ * 所以名册里有**两种**备注，别混：
+ *
+ *   · `persons.note`     —— **本人写的**自我介绍/格言（每人一份，本人可改）。
+ *                           别人打开他的资料**看得到**（那是他愿意公开说的）。
+ *   · `person_notes`     —— **"我"对他写的**私人备注（怎么认识的、要注意什么…）。
+ *                           ⚠️ **只有写的人自己看得到** —— 它属于"我和他的关系"，
+ *                           不是这个人的属性。所以它不落 persons，
+ *                           否则我写一句"这人借钱不还"全家都能看见。
+ *
+ * 这也正是为什么不复用 persons.note：一个字段存不下"两种语义 + 两种可见性"。
+ */
+
+declare(strict_types=1);
+
+namespace App;
+
+final class PersonNote
+{
+    /** 我对这个人的私人备注（没写过返回 ''） */
+    public static function get(int $personId, int $viewerId): string
+    {
+        if ($personId <= 0 || $viewerId <= 0) {
+            return '';
+        }
+        $st = Database::get()->prepare(
+            'SELECT note FROM person_notes WHERE person_id = ? AND viewer_id = ?'
+        );
+        $st->execute([$personId, $viewerId]);
+        $v = $st->fetchColumn();
+        return $v === false ? '' : (string)$v;
+    }
+
+    /**
+     * 写入/清空。**空串等于删除这条备注** —— 不留一行空记录，
+     * 否则"我写过又删掉"会留下一条 forever 的空行，日后分不清"没写过"与"删掉了"。
+     */
+    public static function set(int $personId, int $viewerId, string $note): void
+    {
+        if ($personId <= 0 || $viewerId <= 0) {
+            return;
+        }
+        $note = trim($note);
+        if ($note === '') {
+            Database::get()->prepare(
+                'DELETE FROM person_notes WHERE person_id = ? AND viewer_id = ?'
+            )->execute([$personId, $viewerId]);
+            return;
+        }
+        Database::get()->prepare(
+            'INSERT INTO person_notes (person_id, viewer_id, note) VALUES (?,?,?)
+             ON DUPLICATE KEY UPDATE note = VALUES(note)'
+        )->execute([$personId, $viewerId, mb_substr($note, 0, 4000, 'UTF-8')]);
+    }
+
+    /**
+     * 一批人的私人备注（列表页要一次取完，别逐行查 —— N+1 在名册几十人时很明显）。
+     * @return array<int,string> person_id => note
+     */
+    public static function mapFor(int $viewerId): array
+    {
+        if ($viewerId <= 0) {
+            return [];
+        }
+        $st = Database::get()->prepare(
+            'SELECT person_id, note FROM person_notes WHERE viewer_id = ? AND note IS NOT NULL AND note <> ""'
+        );
+        $st->execute([$viewerId]);
+        $out = [];
+        foreach ($st->fetchAll() as $r) {
+            $out[(int)$r['person_id']] = (string)$r['note'];
+        }
+        return $out;
+    }
+}