FamilyBook

laoyang/FamilyBook

Fork 0

Commit Graph

Author	SHA1	Message	Date
laoyang	ed122c034b	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% 在别的批次数据上假红）。	2026-10-15 23:04:25 +08:00
laoyang	52cc1ecccb	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 路由）。	2026-10-04 08:56:40 +08:00
laoyang	b5725b449a	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

Author

SHA1

Message

Date

laoyang

ed122c034b

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% 在别的批次数据上假红）。

2026-10-15 23:04:25 +08:00

laoyang

52cc1ecccb

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 路由）。

2026-10-04 08:56:40 +08:00

laoyang

b5725b449a

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