FamilyBook

laoyang/FamilyBook

Fork 0

Commit Graph

Author	SHA1	Message	Date
laoyang	91c55038c9	v30 第 30 批（3 条）：ICS 导入读完即弃 / 导航联想词根因修复 / 导航设置改纯图标三条都是「静态检查与 e2e 恒绿、只有真机才现形」的，每条先写真机诊断探针拿到真根因再改，并逐条反向验证（改回旧行为必须被抓住）。 1. 日程 ICS 导入：文件已上传仍提示「请选择一个文本」真根因：_stage_drop.php 是"拖进来即刻上传到暂存区"的唯一形态—— 拖放时文件走 upload_stage.php 落到 uploads/_staging/，而 <input>.files 始终是空的；两个导入框（ics/通讯录）都带 required → 浏览器原生校验把提交拦下，弹它自己的文案。就算绕过校验，路由只读 $_FILES['ics']、从不看 stage_token[]，暂存文件永远没人认领。改：片段新增 $sdStage（默认 true）。导入型传 false → 框上不带 data-drop-stage → app.js 走"写回 input.files、随表单提交"的老路，文件走 PHP 临时文件，路由读完即弃；不落存储、不建附件行、不进 OSS。同时把 app.js 找框的选择器从 [data-drop-stage][data-sd-for=…] 放宽成 [data-sd-for=…]——否则这些框点不开也接不住拖动。 2. 导航联想词"还是不好用" 真根因：nav_show.php 给出的 suggest 地址已带 ?p=<短语>，而 nav-show.js 又硬拼 '?slug=…' → 实际是 …?p=abc?slug=bing&q=…；PHP 认为第一个 ? 之后整串都是查询值 → p 匹配不上短语 → 403 → 下拉永远空。服务端一直是对的（直连 200 + 10 条词），e2e 探针自己拼对了参数，所以 HTTP 层恒绿、只有真页面能抓。改：nav-show.js 新增 withQuery()，按 base 里有没有 ? 决定分隔符； nav_suggest.php 加短语容错（切掉第一个 ?/& 之后的内容，救缓存里的旧 JS）。 3. 导航设置按钮改纯图标 ☰ v29 只改成了下拉菜单，summary 仍是 btn-ghost btn-sm + 文字「设置」+ 一个向下箭头。改：换成与其他七个模块逐字节相同的 btn-icon + 三条横线。验证：e2e 1464/0（新增 2 条）、升级 153/0、vCard 40 项、城市 32/0、桌面几何全过、移动 680/0、交互 92/0、窄屏 30/0、b24_nav 41/0、b24_ui 26/0、 b28 39/0、b29 38/0、b27 34/0；新真机探针 _b30 22/0、反向验证 11/0；部署静态断言新增 8 条守卫并逐条证伪通过（本轮抓到 2 条恒真守卫 + 1 处 _code_only 的 locale 差异）。线上 7 个文件 SHA256 与本地一致。	2026-10-08 14:46:16 +08:00
laoyang	f0437e6c93	v24 第 21 批：无刷新删除与新建日程 / 实际行程不回退 / 行程按时间排 / 统一上传框 / 时间范围控件修复（用户 8 条）用户 8 条原话要点： ①「名册页面，删除一个联系人后，能否不刷新页面，删除成功后，直接把这个人，从当前页面的 dom 中删除，页面保持不动。」 ②「观影模块，海报和票根以及照片都带进来了，但是没有缩放，把页面撑破了，应该缩放成缩略图。」 ③「个人设置页面，天气设置那里，把：只影响你自己首页上的那一格 / 填个城市名就行（如「青岛」）… 这些提示，都删除。把城市单独放一行，精度维度放在一行。」 ④「旅程模块，实际行程编辑后，点击保存，竟然又变成计划行程了，这个不合理，实际行程永远是实际行程，不会再变回计划行程了。」 ⑤「旅程模块，旅程列表，行程列表，都是按照行程的开始时间排序的，最新的在最上面，而不是按照编辑修改时间。」 ⑥「旅程的详情页面，右上角的按钮，设置在最右侧，和其他模块保持统一。」 ⑦「所有上传图片等附件的地方，都不再放按钮，而是放一个框，点击这个框实现点击上传按钮的功能，拖动图片进这个框里，实现拖动多个上传功能。框里面写一句话：点击或拖动进行上传，其他的功能和现在保持一致。」 ⑧「日历中新建日程，无论是点击按钮还是点击日历中间，都是采用弹框的形式进行添加，这样不影响当前日历的显示，添加完成后，动态修改当前视图，不要刷新。添加日历日程，开始时间和结束时间那里，用我们统一的时间范围选择器重做，现在功能无法使用。选择日历本，带上颜色。」 🔴 五个真根因（全都不像 bug）： ① 🔴 ④「实际行程变回计划」= 表单字段同名合并（本批最要紧的一条）暂存上传的令牌字段原叫 `stage[]`，与行程表单里那个隐藏的 `stage`（plan/actual）同名。PHP 解析表单时同名会合并进同一个键： `stage=actual` + `stage[]=tok` → `$_POST['stage'] = ['actual','tok']` （`[]` 只是"往同一个键追加"的记号，不构成另一个键名。）于是路由里 `(string)($_POST['stage'] ?? 'plan')` 得到 `"Array"` → `in_array('Array', ['plan','actual'])` 为假 → 静默回落成 'plan'。 ⚠️ 只有"拖过图片的行程"会犯（没拖就没有 `stage[]`）→ 症状是"时好时坏"。修法：令牌字段改名成 `stage_token[]`（改的是字段名本身，不是"是数组就取第一个" 绕过去 —— 同名合并是 PHP 的表单语义，绕过去只会把坑留给下一次加字段）。另加一道语义保险：编辑路径一律沿用库里那条自己的 stage，不读表单 —— 编辑表单里根本没有改阶段的控件（改阶段走详情页那几个显式动作）。这样即便将来又冒出某个字段名冲突，也不可能把「实际」悄悄变回「计划」。 ② 🔴 ⑧「时间范围选择器无法使用」= 三道门叠在一起 ① `_event_fields.php` 的结束端默认带 `hidden`（要点「+ 添加结束时间」才出现）； ② `app.js` 的 `upgradeRange()` 有「两端都得可见才升级」的判断 → 永远不成立（实测 `data-semi-range-done` 恒为 `null`）； ③ CSS `html.js .dt-range:not(.is-semi-range) .dt-input { visibility: hidden }` → 未升级时原生控件也是不可见的 ⇒ 屏幕上一片空白、点哪儿都没反应。修法：两端始终可见（"没有结束"由清空后半段表达，不再靠开关）；并把旧的「+ 添加结束时间 / 去掉结束时间」开关整套删掉。 ⚠️ 顺带挖出：`upgradeRange()` 里 `group.insertBefore(host, a)` 在"两端各自被 `.field` 包着"时 `a` 不是 `group` 的子节点 → 直接抛 `Failed to execute 'insertBefore' on 'Node'`。这个异常以前从没触发过（被 ② 的提前 return 挡住了）—— 一旦放出来就炸。修成插在"端点最外层包装"之前。 ⚠️ 观察器加了 `attributes: true, attributeFilter: ['hidden']`（并把 childList 分支的 `return` 去掉）：弹框/折叠面板/tab 里"稍后才露出来"的日期控件从此都能自动升级。 ③ 🔴 ⑧「新建日程默认建出观影记录」= 产品缺口，不只是显示问题 `Calendar::DEFAULT_KINDS` 原来只有 6 本派生本（观影/旅行/农历/节假日/传统节日/ 节气），一本可写的普通本都没有。于是"放在哪本"里全是派生本、默认选中排最前的观影 → 用户直接打字点「加上」，建出来的是一条观影记录（日历里看着是多了条日程，观影列表里莫名多一条）。这是"建错东西"，事后极难发现。 → ① 默认本补成「我的日程」(kind='custom')，模板里默认选中也改成优先 custom 本； ② 选择器里把纯派生只读本禁用并标「（自动生成）」（直接不列会让人以为本子丢了；列为可选又会白选一次再吃错误）。 ⚠️ 顺带发现 `Calendar::READONLY_KINDS` 把 `movie`/`trip` 也算进去了，而 `event_add` 里紧跟着就有两段专门处理它们的分支（「已加进观影」/「已加进旅程」） —— 那两段永远走不到（校验先一步把请求打回去了）。判据要按能不能写分，不是按"是不是派生"。 ④ 🔴 ②「观影编辑页图片撑破」= `.mv-slot` 这个类在样式表里根本不存在第 21 批加模板时只写了结构没写样式 → `<img>` 按原始像素渲染：600×900 的海报在 236px 宽的格子里撑出 942px 高，还把整页横向顶破（实测 docW 1297 > vw 1280）。 → 补 `.mv-slot` 规格：固定 108×162 缩略图 + `object-fit: cover`。 ⚠️ 高度必须写死 —— 不写死就又会由原图比例决定，等于没修。 ⑤ ⑤行程列表排序 = `category, position` 主导 `position` 默认同一个数（旧迁移给的多是 0/100），于是顺序被 position 挤乱。实测线上 #222 渲染成「返回青岛(10-5) → 出发去菏泽(9-30) → 去姥姥家(10-2)」。 → 改成 `ORDER BY (starts_at IS NULL), starts_at, id`。 ⚠️ 方向是正序（早的在前，已跟用户确认）；旅程列表仍是 DESC（最新在最上）。两者方向不同是刻意的：一个是"挑哪趟旅行"，一个是"读这趟旅行的行程"。 ⚠️ 详情页按阶段分三组渲染（计划/实际/未成行），排序只需在组内有序。本批新增能力： - 统一上传框（⑦）：`templates/_stage_drop.php` 现在同时负责「sr-only 的真文件框 + 看得见的上传框 + 暂存清单」，调用方只 require 一行。框是 `role="button" tabindex="0"`，JS 转发 `input.click()`（键盘 Enter/Space 也通），拖文件进框走既有的暂存上传（拖一个立刻传、可续拖、失败标红、未传完拦住保存）。 ⚠️ 框用 `<div>` 不是 `<button>`：里面要放暂存清单（含「撤掉这张」按钮），按钮里嵌按钮是非法 HTML（第 21 批刚在 `<form>` 嵌套上栽过同一个跟头）。 ⚠️ 文件框用 `.sr-only` 不是 `display:none`：后者不可聚焦，带 `required` 时 Chrome 会报 "An invalid form control is not focusable" —— 点了什么都不发生。落了 11 处：行程照片 / 观影海报·票根·合影 / 资源 / 任务 / 日程附件 / 书籍 / 联系人导入 / ics 导入 / 观影补传 / 资源补传。 ⚠️ 清单与提示行移到框外面（放框内会变成"一个大框套五张图"），所以 app.js 改从 `.upfield` 容器里找它们。 - 无刷新删除（①）与无刷新新建日程（⑧）：路由按 `X-Requested-With` （或 `Accept: application/json`）区分调用者 —— 带它回 JSON、不带照旧 302 （无 JS 的兜底不变，两边的反向都写了断言）。 · 名册删除：成功 → 摘卡片 + 就地改「共 N 人」与分组人数 + 派发 `input` 让 filter.js 自己重算（不抄它的判据）；失败 → 把原因说出来（不刷页）；拿不到 JSON → 退回原生提交（绝不静默失败）。 · 日历新建：JSON 带齐前端插入当前视图要用的字段（时间/颜色/链接/是否全天/cal）。月视图按时间插入（不能 append —— 服务端只渲染前 3 条、按时间序取， append 会让"新加的早间日程"掉进「+N 条」里看不见，刷新后又跑到第一位）；周/日视图按"24h = 100%"算 top/height 插块。 · 观影 / 旅行本是可写派生本：AJAX 时不再跳详情页（跳走就离开了日历），改在提示行给一个「去看详情 →」链接。 - ⑧日历本带颜色：原生 `<option>` 画不出色块（浏览器不允许在 option 里放元素），所以做成「色块 + 下拉」并排，色块跟着当前选中的本子变色。 - ③天气卡片：三句提示全删；城市单独一行、纬度/经度同一行（`.loc-row`）。删的只是说明文字，三个输入框 + 保存 + 状态回显都保留。 - ⑥设置按钮贴最右：原来顺序是「… → 设置 ☰ → 删除 🗑」，设置被删除键挤到倒数第二；改成删除在前、设置恒为最后一个（与观影/日程/任务/资源同一个手势）。验证（本地全套）： - e2e 1059/0（本批新增约 40 条断言）· 结构升级 149/0 · 桌面几何 428/0 - 真机探针 75/0（`_fb_b21_ui.py`）：AJAX 删除真的没导航 / 卡片真被摘掉 / 滚动位置保持；缩略图几何（108×162，不再溢出）；上传框（框在、原生框不可见、点框真打开文件选择框、连拖两张都上去且清单可见）；日历弹框（打开时网格一动不动、范围控件真的挂上且可见、能弹面板、色块跟着换、无刷新提交后当前视图里立刻出现、周视图也能插时间块、全程无 JS 报错）。 - 反向验证 12 条（`_fb_b21_falsify.py`）：逐条把修复改回旧行为看断言是否变红 —— 令牌字段改回 stage[] / 编辑读表单 stage / 排序改回 position / 设置按钮挪走 / 框不转发点击 / 文件框不再 sr-only / 删缩略图规格 / 删除不回 JSON / 结束端改回 hidden / 日历本默认改回第一个 / 天气提示加回 / 弹框改回内联。 - 部署脚本静态断言段本地空跑 307/0。	2026-10-06 12:08: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

91c55038c9

v30 第 30 批（3 条）：ICS 导入读完即弃 / 导航联想词根因修复 / 导航设置改纯图标

三条都是「静态检查与 e2e 恒绿、只有真机才现形」的，每条先写真机诊断探针
拿到真根因再改，并逐条反向验证（改回旧行为必须被抓住）。

1. 日程 ICS 导入：文件已上传仍提示「请选择一个文本」
   真根因：_stage_drop.php 是"拖进来即刻上传到暂存区"的唯一形态——
   拖放时文件走 upload_stage.php 落到 uploads/_staging/，而 <input>.files
   始终是空的；两个导入框（ics/通讯录）都带 required → 浏览器原生校验把提交
   拦下，弹它自己的文案。就算绕过校验，路由只读 $_FILES['ics']、从不看
   stage_token[]，暂存文件永远没人认领。
   改：片段新增 $sdStage（默认 true）。导入型传 false → 框上不带
   data-drop-stage → app.js 走"写回 input.files、随表单提交"的老路，文件走
   PHP 临时文件，路由读完即弃；不落存储、不建附件行、不进 OSS。
   同时把 app.js 找框的选择器从 [data-drop-stage][data-sd-for=…] 放宽成
   [data-sd-for=…]——否则这些框点不开也接不住拖动。

2. 导航联想词"还是不好用"
   真根因：nav_show.php 给出的 suggest 地址已带 ?p=<短语>，而 nav-show.js 又
   硬拼 '?slug=…' → 实际是 …?p=abc?slug=bing&q=…；PHP 认为第一个 ? 之后整串
   都是查询值 → p 匹配不上短语 → 403 → 下拉永远空。服务端一直是对的（直连
   200 + 10 条词），e2e 探针自己拼对了参数，所以 HTTP 层恒绿、只有真页面能抓。
   改：nav-show.js 新增 withQuery()，按 base 里有没有 ? 决定分隔符；
   nav_suggest.php 加短语容错（切掉第一个 ?/& 之后的内容，救缓存里的旧 JS）。

3. 导航设置按钮改纯图标 ☰
   v29 只改成了下拉菜单，summary 仍是 btn-ghost btn-sm + 文字「设置」+ 一个
   向下箭头。改：换成与其他七个模块逐字节相同的 btn-icon + 三条横线。

验证：e2e 1464/0（新增 2 条）、升级 153/0、vCard 40 项、城市 32/0、
桌面几何全过、移动 680/0、交互 92/0、窄屏 30/0、b24_nav 41/0、b24_ui 26/0、
b28 39/0、b29 38/0、b27 34/0；新真机探针 _b30 22/0、反向验证 11/0；
部署静态断言新增 8 条守卫并逐条证伪通过（本轮抓到 2 条恒真守卫 + 1 处
_code_only 的 locale 差异）。线上 7 个文件 SHA256 与本地一致。

2026-10-08 14:46:16 +08:00

laoyang

f0437e6c93

v24 第 21 批：无刷新删除与新建日程 / 实际行程不回退 / 行程按时间排 / 统一上传框 / 时间范围控件修复（用户 8 条）

用户 8 条原话要点：
  ①「名册页面，删除一个联系人后，能否不刷新页面，删除成功后，直接把这个人，
     从当前页面的 dom 中删除，页面保持不动。」
  ②「观影模块，海报和票根以及照片都带进来了，但是没有缩放，把页面撑破了，
     应该缩放成缩略图。」
  ③「个人设置页面，天气设置那里，把：只影响你自己首页上的那一格 / 填个城市名就行
     （如「青岛」）… 这些提示，都删除。把城市单独放一行，精度维度放在一行。」
  ④「旅程模块，实际行程编辑后，点击保存，竟然又变成计划行程了，这个不合理，
     实际行程永远是实际行程，不会再变回计划行程了。」
  ⑤「旅程模块，旅程列表，行程列表，都是按照行程的开始时间排序的，最新的在最上面，
     而不是按照编辑修改时间。」
  ⑥「旅程的详情页面，右上角的按钮，设置在最右侧，和其他模块保持统一。」
  ⑦「所有上传图片等附件的地方，都不再放按钮，而是放一个框，点击这个框实现点击上传
     按钮的功能，拖动图片进这个框里，实现拖动多个上传功能。框里面写一句话：
     点击或拖动进行上传，其他的功能和现在保持一致。」
  ⑧「日历中新建日程，无论是点击按钮还是点击日历中间，都是采用弹框的形式进行添加，
     这样不影响当前日历的显示，添加完成后，动态修改当前视图，不要刷新。添加日历日程，
     开始时间和结束时间那里，用我们统一的时间范围选择器重做，现在功能无法使用。
     选择日历本，带上颜色。」

🔴 五个真根因（全都不像 bug）：

 ① 🔴 **④「实际行程变回计划」= 表单字段同名合并**（本批最要紧的一条）
    暂存上传的令牌字段原叫 `stage[]`，与行程表单里那个隐藏的 `stage`（plan/actual）
    **同名**。PHP 解析表单时同名会**合并进同一个键**：
        `stage=actual` + `stage[]=tok` → `$_POST['stage'] = ['actual','tok']`
    （`[]` 只是"往同一个键追加"的记号，**不构成另一个键名**。）
    于是路由里 `(string)($_POST['stage'] ?? 'plan')` 得到 `"Array"` →
    `in_array('Array', ['plan','actual'])` 为假 → **静默回落成 'plan'**。
    ⚠️ 只有"拖过图片的行程"会犯（没拖就没有 `stage[]`）→ 症状是"时好时坏"。
    修法：令牌字段改名成 `stage_token[]`（改的是**字段名本身**，不是"是数组就取第一个"
    绕过去 —— 同名合并是 PHP 的表单语义，绕过去只会把坑留给下一次加字段）。
    **另加一道语义保险**：编辑路径**一律沿用库里那条自己的 stage**，不读表单 ——
    编辑表单里根本没有改阶段的控件（改阶段走详情页那几个显式动作）。
    这样即便将来又冒出某个字段名冲突，也不可能把「实际」悄悄变回「计划」。

 ② 🔴 **⑧「时间范围选择器无法使用」= 三道门叠在一起**
    ① `_event_fields.php` 的**结束端默认带 `hidden`**（要点「+ 添加结束时间」才出现）；
    ② `app.js` 的 `upgradeRange()` 有「**两端都得可见**才升级」的判断 → 永远不成立
       （实测 `data-semi-range-done` 恒为 `null`）；
    ③ CSS `html.js .dt-range:not(.is-semi-range) .dt-input { visibility: hidden }` →
       未升级时原生控件**也是不可见的** ⇒ 屏幕上一片空白、点哪儿都没反应。
    修法：两端**始终可见**（"没有结束"由清空后半段表达，不再靠开关）；
    并把旧的「+ 添加结束时间 / 去掉结束时间」开关整套删掉。
    ⚠️ 顺带挖出：`upgradeRange()` 里 `group.insertBefore(host, a)` 在"两端各自被
    `.field` 包着"时 `a` 不是 `group` 的子节点 → 直接抛
    `Failed to execute 'insertBefore' on 'Node'`。这个异常**以前从没触发过**
    （被 ② 的提前 return 挡住了）—— 一旦放出来就炸。修成插在"端点最外层包装"之前。
    ⚠️ 观察器加了 `attributes: true, attributeFilter: ['hidden']`（并把 childList
    分支的 `return` 去掉）：弹框/折叠面板/tab 里"稍后才露出来"的日期控件从此都能自动升级。

 ③ 🔴 **⑧「新建日程默认建出观影记录」= 产品缺口，不只是显示问题**
    `Calendar::DEFAULT_KINDS` 原来只有 6 本**派生**本（观影/旅行/农历/节假日/传统节日/
    节气），**一本可写的普通本都没有**。于是"放在哪本"里全是派生本、默认选中排最前的
    **观影** → 用户直接打字点「加上」，建出来的是一条**观影记录**
    （日历里看着是多了条日程，观影列表里莫名多一条）。这是"建错东西"，事后极难发现。
    → ① 默认本补成「我的日程」(kind='custom')，模板里默认选中也改成**优先 custom 本**；
      ② 选择器里把**纯派生只读本**禁用并标「（自动生成）」
         （直接不列会让人以为本子丢了；列为可选又会白选一次再吃错误）。
    ⚠️ 顺带发现 `Calendar::READONLY_KINDS` 把 `movie`/`trip` 也算进去了，而
    `event_add` 里**紧跟着**就有两段专门处理它们的分支（「已加进观影」/「已加进旅程」）
    —— 那两段**永远走不到**（校验先一步把请求打回去了）。判据要按**能不能写**分，
    不是按"是不是派生"。

 ④ 🔴 **②「观影编辑页图片撑破」= `.mv-slot` 这个类在样式表里根本不存在**
    第 21 批加模板时只写了结构没写样式 → `<img>` 按**原始像素**渲染：600×900 的海报
    在 236px 宽的格子里撑出 942px 高，还把整页横向顶破（实测 docW 1297 > vw 1280）。
    → 补 `.mv-slot` 规格：固定 108×162 缩略图 + `object-fit: cover`。
    ⚠️ **高度必须写死** —— 不写死就又会由原图比例决定，等于没修。

 ⑤ **⑤行程列表排序 = `category, position` 主导**
    `position` 默认同一个数（旧迁移给的多是 0/100），于是顺序被 position 挤乱。
    实测线上 #222 渲染成「返回青岛(10-5) → 出发去菏泽(9-30) → 去姥姥家(10-2)」。
    → 改成 `ORDER BY (starts_at IS NULL), starts_at, id`。
    ⚠️ 方向是**正序**（早的在前，已跟用户确认）；旅程列表仍是 DESC（最新在最上）。
       两者方向不同是**刻意的**：一个是"挑哪趟旅行"，一个是"读这趟旅行的行程"。
    ⚠️ 详情页**按阶段分三组**渲染（计划/实际/未成行），排序只需在**组内**有序。

本批新增能力：
- **统一上传框**（⑦）：`templates/_stage_drop.php` 现在**同时**负责
  「sr-only 的真文件框 + 看得见的上传框 + 暂存清单」，调用方只 require 一行。
  框是 `role="button" tabindex="0"`，JS 转发 `input.click()`（键盘 Enter/Space 也通），
  拖文件进框走既有的暂存上传（拖一个立刻传、可续拖、失败标红、未传完拦住保存）。
  ⚠️ 框用 `<div>` 不是 `<button>`：里面要放暂存清单（含「撤掉这张」按钮），
     按钮里嵌按钮是非法 HTML（第 21 批刚在 `<form>` 嵌套上栽过同一个跟头）。
  ⚠️ 文件框用 `.sr-only` 不是 `display:none`：后者不可聚焦，带 `required` 时
     Chrome 会报 "An invalid form control is not focusable" —— 点了什么都不发生。
  落了 11 处：行程照片 / 观影海报·票根·合影 / 资源 / 任务 / 日程附件 / 书籍 /
  联系人导入 / ics 导入 / 观影补传 / 资源补传。
  ⚠️ 清单与提示行移到框**外面**（放框内会变成"一个大框套五张图"），
     所以 app.js 改从 `.upfield` 容器里找它们。
- **无刷新删除（①）与无刷新新建日程（⑧）**：路由按 `X-Requested-With`
  （或 `Accept: application/json`）区分调用者 —— 带它回 JSON、不带照旧 302
  （无 JS 的兜底**不变**，两边的反向都写了断言）。
  · 名册删除：成功 → 摘卡片 + 就地改「共 N 人」与分组人数 + 派发 `input` 让
    filter.js 自己重算（**不抄它的判据**）；失败 → 把原因说出来（不刷页）；
    拿不到 JSON → **退回原生提交**（绝不静默失败）。
  · 日历新建：JSON 带齐前端插入当前视图要用的字段（时间/颜色/链接/是否全天/cal）。
    月视图**按时间插入**（不能 append —— 服务端只渲染前 3 条、按时间序取，
    append 会让"新加的早间日程"掉进「+N 条」里看不见，刷新后又跑到第一位）；
    周/日视图按"24h = 100%"算 top/height 插块。
  · 观影 / 旅行本是**可写派生本**：AJAX 时不再跳详情页（跳走就离开了日历），
    改在提示行给一个「去看详情 →」链接。
- **⑧日历本带颜色**：原生 `<option>` 画不出色块（浏览器不允许在 option 里放元素），
  所以做成「色块 + 下拉」并排，色块跟着当前选中的本子变色。
- **③天气卡片**：三句提示全删；城市单独一行、纬度/经度同一行（`.loc-row`）。
  删的只是说明文字，三个输入框 + 保存 + 状态回显都保留。
- **⑥设置按钮贴最右**：原来顺序是「… → 设置 ☰ → 删除 🗑」，设置被删除键挤到**倒数第二**；
  改成删除在前、设置恒为最后一个（与观影/日程/任务/资源同一个手势）。

验证（本地全套）：
- e2e **1059/0**（本批新增约 40 条断言）· 结构升级 149/0 · 桌面几何 428/0
- **真机探针 75/0**（`_fb_b21_ui.py`）：AJAX 删除真的没导航 / 卡片真被摘掉 /
  滚动位置保持；缩略图几何（108×162，不再溢出）；上传框（框在、原生框不可见、
  点框真打开文件选择框、连拖两张都上去且清单可见）；日历弹框（打开时网格一动不动、
  范围控件真的挂上且可见、能弹面板、色块跟着换、无刷新提交后当前视图里立刻出现、
  周视图也能插时间块、全程无 JS 报错）。
- **反向验证 12 条**（`_fb_b21_falsify.py`）：逐条把修复改回旧行为看断言是否变红 ——
  令牌字段改回 stage[] / 编辑读表单 stage / 排序改回 position / 设置按钮挪走 /
  框不转发点击 / 文件框不再 sr-only / 删缩略图规格 / 删除不回 JSON /
  结束端改回 hidden / 日历本默认改回第一个 / 天气提示加回 / 弹框改回内联。
- 部署脚本静态断言段本地空跑 **307/0**。

2026-10-06 12:08: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