laoyang
1bf56b114b
用户 2026-10-14 第 2 条。用户原话：
「下面三个按钮，都放在下面的右侧…分别是详情、编辑和删除。详细用蓝色，编辑用黄色，删除用红色。
点击详细的时候，**如果这是一个日程**（正常日程里的事件、不是来自观影/旅程等模块）
→ 就**在当前页面让模态框变大**、显示更多信息。
点击编辑，也是**在当前的界面**弹出编辑日程的框，就地编辑；编辑完之后下面两个按钮：取消和保存。
点击删除，就直接把这个日程给删除。
如果当前这个日程**来自其他模块**（观影 / 旅程 / 其它）→ 点击详情就**进入那些模块**展示它。
**这种情况下，下面就没有编辑、也没有删除，就只有一个详情。**」
拍板：① 应用范围 = 首页日程 + 日程页条目（首页近期任务保持 v43 现状）；
② 重复日程删除 → 弹三档范围（这一次 / 这一次及以后 / 全部）。
实现（7 个文件）：
· app/helpers.php fb_entry_json() 扩契约：source('event'/'derived') / ref / del / info /
repeat / occ。判据 `kind==='custom' && ref_id>0`（**不是**"有没有 edit"）。
· app/Calendar.php month() 给自定义条目带 _can_write（供 del 判定）。
· templates/_entry_popup.php 底栏重构成「右侧按钮组 + 7 颗」：详情态三颗、
编辑态两颗（取消/保存）、删除范围态两颗（取消/确认删除）；另加一颗
**遮罩层里的 CSRF**（正文会被整块换掉，放正文会丢）。
· assets/js/entry_popup.js 四态状态机（detail/info/edit/delscope），按 source 决定显哪几颗。
· assets/css/app.css .fb-entry-acts（margin-left:auto 靠右）+ fb-a-detail/edit/del 三色
+ .is-wide（620→860px）。⚠️ 全是**作用域类**，不动全局 .btn-edit/.btn-danger 的语义。
· index.php 新增 calendar/event?embed=detail（只吐只读详情块）；
calendar/event_del **认 X-Requested-With 回 JSON**（$done() 收口，失败也回原因）。
· templates/calendar/event.php 支持 $evDetail（只吐 kv 只读块，与可写与否无关）。
本轮修掉两个真 bug（都是"藏不掉"）：
① `.btn{display:inline-flex}` 是作者样式，**盖过 [hidden] 的浏览器默认**
⇒ 底栏四态切换时前面的按钮收不起来、全挤在一条上（派生条目本该只有「详情」，
实测三颗都露着）。⇒ 显式写 `.fb-entry-acts .btn[hidden]{display:none!important}`。
本项目文件前部已有同款注释（.pick-row[hidden] 等），属第 N 次同类。
② `footShow('detail')` 把三颗无条件点亮，**盖掉** paintDetail 按来源设的 hidden。
⇒ detail 组只列「详情」，且 paintDetail 里**先 footShow 再设 edit/del**（顺序写进注释）。
验证（新增 2 个套件）：
· _fb_v49_entry.py（33 条真机断言：三颗靠右/配色/派生只有详情/详情就地变宽/编辑就地/
删除落库/日程页入口/重复弹范围）
· _b49_falsify.py（**10 注入 / 21 断言全抓**）
· 更新 _fb_b43_ui.py 旧断言（「详细信息」→「详情」；自定义日程的详情语义从"跳页"改"就地展开"）
· familybook_deploy.sh 加 v49 静态断言段
· 全量 e2e / vCard / 几何 / 各批反向验证全绿；部署脚本 0 FAIL（含"第49批形态"）；
线上 7 个文件 md5 与本地逐字节一致；线上门禁诊断 13 项全 YES，临时页已删并复验 404
⚠️ 反向验证抓到一条**假绿**（值得记下来）：注入「给派生条目也塞 del」时探针**没变红** ——
因为按钮显隐是 `source` **且** `del` 的多条件"与"，只塞 del 在界面上显不出来。
⇒ 补一条**数据层**断言（直接读 data-fb-entry 的 del 必须为空），两层判据都在。
⚠️ 末段唯一"失败"是沙箱的安全删除门禁（SAFE_DELETE_BULK_CONFIRM_REQUIRED，按轮次累计、
本轮流水线删超 50 个文件）：单独重跑 _fb_v46_carddav.py 是 **29/0**，与环境有关，与本次改动无关。
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。