laoyang
7f00d3e553
家谱（v13）： - 自研布局是死结，不是样式问题：连线的横杆是网格项，只能横跨「父母列→子女列」 整段区间，中间夹着与血缘无关的人（如媳妇那侧的岳父母）时必然从卡片上穿过。 换成 family-chart（D3 生态，MIT）后，排布只走本家血脉 + 配偶，姻亲不进画布， 这个死结在构造上就不存在了。 - 接入踩到并修掉的坑：main_id = data[0].id（「我」必须排最前）； 卡片回调里自定义字段在 d.data.data（双层）；库的 family-chart.css 是死文件 （全挂在 .f3 作用域，运行时没有 .f3 元素）；库的 svg 撑满选择器永不命中 （必须自己补 .kin-chart svg.main_svg）；setCanAdd/setOnCardClick 不在 chart 上 （写错会抛异常，把 updateTree 一起带走 → 整张图空白，页面照样 200）。 - 关掉 setSingleParentEmptyCard：库默认给孩子只登记一位父母的人自动补一张无名 配偶卡，看着像「凭空多出一个配偶」。 - 卡片用原生 <a> 链成员页，不依赖库的点击回调。 观影按钮（用户本轮原话）： - 「记一场电影」与「设置」高度仍不一致 —— 根因是文字按钮高度由 padding+line-height 自然推出（43.8px），而 .btn-icon 写死了 40px。抽出 --act-* / --act-h 变量，两边同源。 - 设置按钮去掉「设置」二字，只留图标，图标换成三条横线（☰）。 - 设置按钮在所有页面排最右（.movie-set 用 margin-left:auto 顶到行尾）。 - 除设置外其他按钮都有颜色，与设置区分（主按钮实心 / 次要浅底 / 危险淡红）。 顺带修掉一个特异性 bug：删除按钮被 .btn 品牌底盖成实心红，与「编辑」难分辨。 - 设置下拉四个条目文字前都加图标（行内 SVG，不引外部字体）。 测试与部署： - 新增 _fb_kin_check.py（桌面，12 条）+ _fb_kin_falsify.py（6/6）证明 「整张家谱空白」这类只靠通用几何抓不到的坏法能被抓住。 - _fb_geom_mobile.py 家谱段重写为窄屏语义（库按容器 fit 缩放是正常行为， 改为断「比例没被压扁 / 缩放不至于看不清」），并加 _fb_kin_mobile_falsify.py（4/4）。 - _fb_btn_check.py（59 条）+ _fb_btn_falsify.py（3/3）覆盖观影页头按钮五条需求。 - familybook_deploy.sh / familybook_smoke.sh 的家谱断言改为第三方库形态， 设置按钮断言改为 btn-icon 纯图标 + 三条横线 + 条目图标。 - 新增 .gitattributes：vendor 库与 .min.js 标 -text，原样入库不被改写行尾。
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。