laoyang
190dc56301
用户 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 端 / 设备管理改动，
一字未碰、也未提交。
FamilyBook
家书，记录家庭的全部生活，一本用岁月写成的家谱。
把一个家的「人」「日子」「去过的地方、看过的电影」收进同一本书里。
它是什么
一个自托管的家庭生活系统。它不是又一个待办清单，而是这个家的长期档案 —— 十年之后还能翻出孩子第一次观影的票根、那年暑假走过的路线。
围绕三个圈展开：
- 人：家庭成员、亲友通讯录，以及他们之间的共享关系
- 时间：日历、日程、提醒，以及任务的期限
- 事件：观影、旅行、其他活动 —— 一切都落在同一条时间轴上
它在做什么
| 阶段 | 主题 | 内容 |
|---|---|---|
| 0 | 地基 | 名册、账号、登录、权限模型、安装向导 |
| 1 | 通信 | 通讯录、共享给某个成员、CardDAV 服务端 |
| 2 | 时间 | 日历本、重复日程、提醒、CalDAV 服务端 |
| 3 | 归一 | 观影与旅行迁入统一事件模型 |
| 4 | 任务 | 任务管理，期限自动映射成日历事件 |
| 5 | 回看 | 统计、年度家书、时间轴 |
当前进度：阶段 0 起步，仓库里只有图标与脚手架。
技术选型
- PHP 7.4+（无框架、无 Composer，上传到站点目录即可运行）
- MySQL 5.7+ / 8.0（
utf8mb4） - 前端为原生 HTML / CSS / JavaScript，无构建步骤
⚠️ 注意 CalDAV / CardDAV 是双向协议，和单纯的 .ics 文件导出不是一个量级的东西。
部署
- 把代码放到站点根目录；
- 复制
config.example.php为config.php，填写数据库与app_key； - 访问站点根，按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。
config.php 不入库（已在 .gitignore 中忽略），其中包含数据库口令与加密密钥。
⚠️ app_key 一旦开始记录数据就不能再改（换掉即解不开已有数据），
并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。
隐私
身份证号、手机号属于敏感个人信息，一律加密存储。 （就家庭自用而言，身份证号其实没有多少必须存的场景，启用前请三思。）
图标
见 assets/icons/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。