laoyang 6930191ac6 家谱:修「鼠标移上去卡片会跳」+ 卡片拆成「头像进资料 / 姓名换中心」两处点击区
用户 2026-10-03 反馈两条。

一、「鼠标放在某个人的头像上,那个框会移动一下位置」——**根因是库的 CSS**:
    库的 family-chart.css:517 有一条
      `.f3 div.card:hover > div { transform: translate(0, -2px); }`
    而我们的 .kin-card 正是 `div.card` 的**直接子 div**。卡片当时用
    `transform: translate(-50%,-50%)` 居中 —— 于是鼠标一进卡片,这条规则就把
    居中 transform **整份覆盖**成 translate(0,-2px)。
    实测(1600×1000 视口、库缩放 0.9):
      卡片 translate(-59px,-66px)  →  translate(0,-2px)
      整张卡向右下跳 **53.1 × 57.6 屏幕像素**(正好半张卡),并带 0.2s 过渡,
      所以看起来就是"框移动了一下"。
    修法两条:
      ① 居中不再依赖 transform,改用 `inset: 0` + `margin: auto`
         (绝对定位 + inset 全 0 + margin auto = 在包含块里居中);
      ② 把库那条 :hover 位移归零(`.kin-chart.f3 div.card:hover > div { transform: none }`)——
         2px 的"上浮"仍在,实测 dy=-1.8px。在 app.css 里覆盖(它加载在库 CSS 之后,
         同特异性后写的赢,不需要 !important),**不改 vendor 里那份文件**
         (升级库会整份覆盖、改动静默消失)。
    ⚠️ 660 别改回 translate(-50%,-50%) 居中 —— 那正是这次的 bug。

二、「以他为中心」按钮不要了,改成把卡片分成两处点击区:
     · 头像 .kin-ph  → 进这个人的资料页(people/show&id=)
     · 姓名 .kin-nm  → 以他为中心重画家谱(?r=kin&focus=)
    两个都是 <a>(而不是一个 a + 一个 button):点名字换中心本质就是"换个 URL
    重新渲染"。换成 <a> 之后,原来那段"给按钮绑 click + keydown +
    mousedown/pointerdown/touchstart 三处阻止冒泡"的代码**整段删掉** ——
    那是"用按钮干链接的活"才需要的补丁;顺带键盘 / 中键新窗口打开都天然可用。
    两张悬停提示("资料" / "以他为中心")分挂到头像、姓名下面,只在指针悬停时显形。
    服务端那份"谁有姻亲在图外"的 branch 计算也一并删掉(渲染没了,留着是死代码)。

验证:
  · 家谱可视化检查 26 → **29** 条全过,其中新增两条正是本次的守卫:
    ⑬ 卡片不靠 transform 居中;⑭ 鼠标移到卡片上**不位移**(原来是 53×58px)。
  · 反向验证:把 CSS 改回旧写法 → ⑬⑭ 立刻变红且实测 dx=53.1 dy=57.6;
    还原后回到全绿(断言不是永远绿的)。
  · 点击区实测:点姓名 → /index.php?r=kin&focus=9;点头像 → /index.php?r=people/show&id=9。
  · e2e 773/0(四条家谱断言跟着新口径更新)· 第 5 轮专项 91/0 · 几何 428/0 ·
    移动端 684/0 · 交互 97/0 · 升级 126/0 · 部署反向验证 3/3。
  · 部署脚本新增三条静态断言(不许 transform 居中 / 必须有 inset:0 /
    必须把库的 :hover 位移归零),防止以后被改回去。
  · 线上 templates/kin/tree.php 与 assets/css/app.css 的 md5 与本地一致;
    kin-focus 已清零、r=kin&focus= 在位、CSS 里 'inset: 0' 8 处。
2026-10-03 15:57:56 +08:00
2026-09-29 15:08:42 +00:00

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 文件导出不是一个量级的东西。

部署

  1. 把代码放到站点根目录;
  2. 复制 config.example.php 为 config.php,填写数据库与 app_key;
  3. 访问站点根,按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。

config.php 不入库(已在 .gitignore 中忽略),其中包含数据库口令与加密密钥。

⚠️ app_key 一旦开始记录数据就不能再改(换掉即解不开已有数据), 并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。

隐私

身份证号、手机号属于敏感个人信息,一律加密存储。 (就家庭自用而言,身份证号其实没有多少必须存的场景,启用前请三思。)

图标

见 assets/icons/。概念是「这本书就是家」:屋顶即一本摊开的书, 屋顶下纸做的墙上,三行横线是这个家写下的日子。

开源协议

Apache License 2.0

S
Description
家书,记录家庭的全部生活,一个家庭用岁月写成的书。
Readme Apache-2.0
8.5 MiB
Languages
PHP 81.6%
JavaScript 9.3%
CSS 9.1%