laoyang
ea6e42c27f
用户原话：「首页，近期任务，如果勾选了完成，应该刷新一下这个列表，把完成的删掉。」 ## 原来的行为 首页那段复选框脚本 AJAX 成功后只改徽章文字（`kb-st` → 「已完成」）， **没有任何"移除这一行"的逻辑**。而且 templates/home.php:160 那条注释还写着 这是**当年的刻意设计**： > ⚠️ 改完**不摘掉这一行**：用户点完正想看自己刚完成什么，立刻消失会让人怀疑 > "是不是点到删除了"。刷新时由服务端决定它还在不在。 用户现在明确推翻这条：完成的就该从列表里删掉。 ## 服务端本身是对的 首页路由只取 `doing` + `todo`（index.php:839），`done` 本来就不在列表里 ⇒ 手动刷新这一行确实会消失，问题纯粹在"AJAX 完成后前端没同步"。 所以这次一行服务端代码都不用改。 ## 改法 新增 `dropTaskRow(row, wasStatus)`，AJAX 成功后（**按服务端返回的 `d.status` 判断**， 不是拿点击前的 `next`）做三件事： 1. **删掉这一行**； 2. **同步「概述」卡右下的「N 件在做 / N 件待办」** —— 那两个数字与这份列表 **同源**（同一个 `$tasks`，见 _card_brief.php:53），只删行不减去数字 ⇒ 列表 2 条、概述说 3 件在做，自相矛盾； 3. **一条不剩时把空态提示露出来**（服务端渲染的 `[data-tk-empty]` 原来一直 hidden） —— 否则卡片变成一片空白，用户以为加载坏了。 配套的小改动： - `_card_tasks.php`：空态提示改成**一直渲染、靠 `hidden` 切换**，加 `data-tk-empty` 钩子（不靠匹配文案 —— 文案改一个字就失效）。外层加 `data-tk-home-host`。 - `_card_brief.php`：两个统计 `<a>` 加 `data-hbs="doing|todo"` 钩子， 同样**不靠中文文案定位**（这是 JS 要读的东西，不能把展示文案变成接口）。 - `app.css`：补 `.empty-hint[hidden] { display: none !important; }` —— 浏览器默认的 `[hidden]{display:none}` 优先级最低，哪天有人给它加 `display:flex` 这句提示就会在"有任务时"也冒出来（与 app.css:601 那条注释是同一约定）。 ## 几个判据上的讲究 - **按 `d.status` 判断而不是 `next`**：`tasks/status` 是幂等接口， 拿服务端返回的状态才不会"手快连点两下，第二下把行删了"。 - **`wasStatus` 要在改 `data-tk-status` 之前存**：删行时要靠它决定减「在做」还是「待办」。 第一版直接在删行时读 `data-tk-status`，读到的已经是 `done` —— 自己写的时候就踩了。 - **提示文案补一句"已从近期任务移出，去「全部」里能看到"**： 删行的原罪是"用户以为点到删除了"，所以必须**明说它去哪了**， 而不是沿用服务端那句「已标成「已完成」」（那会让人以为行还在，下一眼发现没了更慌）。 ## 验证 **主判据 `_tooling/_b37_home_task_drop.py` —— 20 通过 / 0 失败** 夹具：把库里历史 doing/todo 任务临时改状态腾空卡片（**不能靠 `deleted_at`** —— `Task::byStatus()` 的 SQL 里根本没有 `deleted_at IS NULL`，软删对首页无效，实测过）， 造 2 条 doing + 1 条 todo，跑完逐个恢复。 覆盖：勾「进行中」→ 行移除 + 「件在做」2→1 + 「件待办」不误减； 勾「待办」→ 行移除 + 「件待办」1→0 且链接藏起； 删到最后一条 → 0 行 + 空态露出；刷新后与服务端事实一致；库里状态真的是 done。 **注入反证 `_tooling/_b37_falsify.py` —— 三次独立注入，各自红在对应处** | 注入 | 结果 | 命中的判据 | |---|---|---| | ① 不删行（原始 bug） | 通过 12 / **失败 8** | ③④⑤⑪⑭⑮ | | ② 删行但不减概述卡计数 | 通过 17 / **失败 3** | ⑤⑫⑯ | | ③ 不限空态（删完一片空白） | 通过 19 / **失败 1** | ⑮ | 每次注入前断言锚点唯一（#474），恢复后回到 20/0。 **回归 `_tooling/_b37_regress.py` —— 11 通过 / 0 失败** 看板勾选仍能改状态且**不删行**（与首页行为不同是有意的）、 详情页子任务复选框仍能改状态、`[hidden]` 的 `display` 真的是 `none`、 `data-hbs` 钩子在、卡片「全部」入口仍指向 tasks。 ⚠️ 回归里踩了一个判据假设错：我一开始按"详情页也该有父任务复选框"写， 直接 FAIL。真实情况是详情页的复选框**只给子任务**（show.php:181 在子任务循环里）， 父任务没有 —— 是判据错了不是产品坏了（#429 同族）。 **内联 JS 校验 `_tooling/_b37_inline_js_check.py`**：把渲染后 HTML 的 `<script>` 抽出来逐个 `node --check`（`php -l` 不看 HTML 里的 JS）。 并做了反证：喂一段坏 JS，它确实报 1 块坏，不是恒绿。 工单 #20
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。