FamilyBook

Files

T

laoyang 190dc56301 v55：笔记详情不重复标题 / 任务状态选完即改（去按钮）/ 编辑任务弹框 / 子任务截止时间换最新控件

用户 2026-10-17 四条。

① 笔记详情：正文里不再重复显示标题
   用户原话：「笔记详情里面的标题已经变成这个日笔记的题目了，那**下面那个里面
   就不用再显示这个题目**了。」
   背景：v52 已把**页头**改成笔记自己的标题（并参与 <title>），
   而**正文区里又写了一遍**同一个标题 ⇒ 同一页同一个名字出现两次。
   ⇒ 删正文里那个 `<h1 class="note-read-title">`；**页头那份保留**。
   连带删掉已无使用者的 `.note-read-title` CSS 规则
   （留一条没有使用者的规则，只会让下一个人以为"正文里还该有个标题"）。

② 任务详情：状态**选一下就改**（去掉「改」按钮）
   用户原话：「任务详情里边，状态后面**不用加按钮**了。不是说选了之后再点一下才改，
   而是**只要一选就让它改**：选一下，状态就发生改变就行了。」
   ⇒ `<select>` 的 `change` 直接 fetch 提交到**既有的** `tasks/status`
      （它本来就认 `X-Requested-With` 并回 JSON —— 不新开路由、不加新契约）。
   成功后**就地**同步三处（不刷页、不丢滚动位置）：
     · 下拉本身；
     · 页头副标题的状态词；
     · 页头那颗「标记完成 ↔ 重新打开」按钮的文案与 hidden 值
       （改了状态而按钮还写"标记完成"就自相矛盾）。
   反馈：一条**浮在顶部**的轻提示 `.tk-flash`（`position:fixed` 不占文档流 ⇒
   改状态不会让页面跳动）。循环任务那句"下一次也排上了"（`d.msg`）照旧显示 ——
   不能因为改交互把 v24 定下的行为丢掉。
   ⚠️ **无 JS 兜底**：`<noscript>` 里那颗「改」按钮
      （规范：脚本开启时 noscript **整块不渲染**）。不要用 `<button hidden>`+JS
      去"显示"它（会闪、脚本报错时永远不出现）。
   🔴🔴 **踩坑（本轮最值钱）**：第一版写成"先 `sel.disabled = true`、再
      `new FormData(form)`" ⇒ **HTML 规范：禁用的控件不参与表单数据构造** ⇒
      字段丢了 ⇒ 服务端收到空 status ⇒ 落回 `todo`。
      症状是"请求成功、回包 ok、页面还给了提示，唯独值不对" —— 极具误导性。
      ⇒ **先构建、后禁用**。

③ 编辑任务 = 弹框
   用户原话：「**编辑任务，弹框处理**。」
   原来详情页是个 `<details>` 就地展开表单（展开会把下面的子任务/附件/评论整段往下推）；
   现在点「编辑这项任务」**浮起弹框**（`.cal-modal`，与「新建任务 / 新建日程 /
   编辑观影记录」同一套类名）。
   ⚠️ **表单一个字没改** —— 仍 require 同一份 `_edit_form.php`
      （条目浮层 `tasks/edit?embed=1` 也用它，两处永远同一张）。
      这次只加了个 `$tkEditModal` 开关：true 时套 `.cal-modal` 壳 +
      「保存」挪到底栏（与新建任务一致：主要动作在右下角）。
   ⚠️ 打开那一刻才 `fbBootAntd()` / `fbUpgradeRange()` 升级里面的日期控件
      （hidden 时也能挂上，但 antd 弹层定位需要元素有实际尺寸）。
   ⚠️ 事件委托挂 `document`（与观影详情页同一理由：校验失败若重画这块，委托仍有效）。

④ 子任务截止时间：换最新控件
   用户原话：「**子任务的截止时间，使用最新的时间控件**。」
   **真根因**：`tasks/show.php` 子任务那块 require `_datetime.php` 时
   **漏传 `$dtPlugin`** ⇒ 空值时走**旧的三下拉（年/月/日）**
   ⇒ 与「新建任务」「任务编辑」里的 antd 控件**不一样**。
   ⇒ 补 `$dtPlugin = 'antd-single'`（截止时间是**单个时刻**，不是范围）。
   ⚠️ 全仓这一族的调用点**逐处核对过**：只有子任务这一处漏了；其余
      （日程起止 / 观影起止 / 任务新建 / 任务编辑 / 行程起止 / 修正起止）
      都已有 `'antd'` 或 `'antd-single'`。
   ⚠️ `people/form.php`（生日）**有意不传** —— 生日是"日期"，年份要能下拉到 1900，
      与"截止时间"不是一回事，别顺手改。

验证（新增 2 套件 + 更新 deploy 断言）：
 · _fb_v55_ui.py（**30 条**真机断言）
 · _b55_falsify.py（**8 注入 / 8 全抓**，基线 30/0）
 · e2e **1518/0**；familybook_deploy.sh 加「第55批形态」段（**13 条**）
 · 部署 **0 FAIL**；线上 4 文件 md5 逐字节一致；
   线上剥注释核实：笔记模板/`app.css` 里已无 `note-read-title`（反向）、
   任务模板有 `data-st-select` / `fd=FormData` / `noscript` 兜底 / `antd-single`、
   编辑表单有 `tkEditCard`/`tkEditSubmit`、`app.css` 有 `.tk-flash`；
   诊断页已删复验 404

⚠️ 本轮踩坑（已写进 pitfalls.md）：
 · 🔴🔴 **先 `disabled=true` 再 `new FormData(form)` ⇒ 字段会丢**（表单数据不含禁用控件）；
 · 连带印证：**用裸 `strpos`/`grep` 做反向断言会命中注释**（我的线上诊断脚本
   就因为这个连报两次"还有"，剥注释后才对）—— 反向断言一律走"剥注释"。

⚠️ 另：工作树里 `app/ApiHandler.php` / `app/PersonQuery.php` / `app/Home.php` /
   `app/Api.php` / `app/ApiToken.php` / `app/Schema.php` / `index.php` /
   `templates/settings/me.php` 是**另一个会话**正在做的 App 端 / 设备管理改动，
   一字未碰、也未提交。