laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity
133 Commits 1 Branch 0 Tags
01d5bc262f9e0de349376ba79d8db02311b53ad4
Commit Graph
6 Commits
Author SHA1 Message Date
laoyang 8f80f3e835 v24 第 2 轮：19 条清单收尾（附件预览/CalDAV/任务分类看板/全局选人/家谱/纪念日/财务） 
用户 2026-10-02 提的 19 条需求，本轮完成剩下的 8 条 + CalDAV 服务端：

- ③ 附件：图片/视频给缩略图，PDF/Word/Excel 给**同尺寸**图标；可预览的在本页
     弹层里看（不再新开标签页），渲染不了的点了直接下载；预览层右上角恒有下载按钮。
- ⑦b CalDAV：把「我的日历本」按 RFC 4791 只读子集分享出去（OPTIONS/PROPFIND/
     REPORT/GET，写方法一律 403）。用**专用口令**（库里只存 sha256），不是登录口令。
- ⑨⑩ 任务：分类与看板都由用户自建；已完成的任务从看板消失，改在「已完成」页
     按分类查看/搜索；设置入口在「新建任务」旁的 ☰。
- ⑪ 全局人员选择器：一个片段铺到观影/旅程/资源/日历共享/任务共享/财务共享；
     修掉了老组件「名字和拼音都搜不动」的 bug —— .att-item 自己声明了 display:flex，
     压过了浏览器 [hidden]{display:none}，过滤根本没生效。
- ⑫ 家谱：头像改方形不再裁切；姻亲不在图上的卡片给「⇄ 姻亲」入口，
     以 TA 为中心重画 + 「返回我的家谱」。
- ⑬ 纪念日：阴历/阳历都能设且按对应历法重复；名册里每个人的生日默认可见
     （实时派生，不复制一份）；全部作为全天日程进日历。
- ⑮ 财务：账本可共享，双方都能记账、都能看全部账目，资产−负债=净资产；
     金额一律以「分」存，不用浮点。

验证：端到端 724 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 24、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
 2026-10-03 08:18:05 +08:00
laoyang 72dc6c0006 家谱关系推导：把「只记了一头」的边补成双向（修用户报的 4 处少人） 
用户指出 4 个具体错误，逐条核对线上真实数据后确认**全部是算法缺陷**：
  ① 杨永华只有一位家长（母亲那边整条线缺失）
  ② 洪博为的孩子是空的 —— 她是杨永全的配偶，杨永全的孩子就是她的
  ③ 洪勇、武竹芳的配偶都是空的 —— 两人明明是同一个孩子的父母
  ④ 杨景焕 / 杜浩洋 / 杜若桐 都只有一位家长

根因：本系统的设计是「只存相邻两代之间的边，其余全部推导」（见 Kinship 头注释），
但家人手工录入时只会填**最直接的那一条**：
  · 给几个孩子都填了「父亲 = 某人」，从没点过「母亲」→ 孩子只有一位家长；
  · 填了孩子父母两位，却忘了把这两位再标一次「夫妻」→ 两位家长各自孤零零。
而 graph() 只做了「parent 边反推 children」的**单向**推导，缺了两条互补推导。

修复（都在 graph() 里，内存视图，不动 relations 表）：
  推导① 同一个孩子的两位家长 ⇒ 认定他们是夫妻
  推导② 孩子只有一位家长、且该家长**恰好只有一位配偶** ⇒ 把配偶补成另一位家长
         （有多个配偶时不猜；迭代到稳定，最多 4 轮）

配套修复（实测发现的回归，必须一起上）：
  推导① 会把「已解除的配偶」凭共同孩子**配回去** —— 用户点"解除配偶"刷新又出现。
  解法：解除配偶时把这一对记进 settings 的 `kin_undone_pairs`（不动表结构），
       推导①跳过这些对；重新 addSpouse 时抹掉标记。
  验证：初始有配偶 → 解除后为空（不再被推回）→ 重新加回恢复。

验证：
· _fc_verify_derive.py（新）：用**线上真实那 10 条边**做夹具，逐条断言用户报的 4 处
  + 11 条「不许过度推导」守卫（祖父母不被推成夫妻、孩子家长不多不少、无自环…）
  全绿；反向验证 2 处注入（关推导①/关推导②）各变红 6/8 条且退出码非 0。
· e2e 549/0、家谱可视化 24/0、家谱版面 10/0、桌面几何 368/0、移动端 516/0、
  交互 97/0、升级专测 123/0。
· **线上真机验证**：修复后重新取线上 data-datum，4 处全部正确 ——
  洪博为子女=杨景焕、洪勇⇄武竹芳、杨景焕双亲=杨永全+洪博为、
  杜浩洋/杜若桐双亲=杨永华+杜元青、杨永华双亲=杨培振+刘巧莲。
· 部署脚本加 2 条断言锁住推导逻辑。
 2026-10-02 22:08:13 +08:00
laoyang 80f5c4f0fc v15: 家谱重写 —— 以我为中心检索全体亲属 + 自己排版画线 
用户 2026-10-02 的反馈（原话）：
  「显示不齐全，应该显示本人的上一代，这一代，和下一代的所有人…以本人为中心去搜索，
    只要有关系的，都检索出来进行展示」
  「夫妻之间有一条横线…这对夫妻下面所有的子女，都应该从夫妻之间的这个横线出来，
    而不是从这对夫妻的其中一个出来，这样可能会出现一个 bug，就是如果从一个出来，
    例如从父亲出来，母亲登录进去竟然看不到自己的孩子」
  「数据仍然不全，差很多」

根因（实测，不是猜）：第三方库 family-chart **只画了 20 人里的 9 人**。
  _tooling/_fb_kin_cover_probe.py 的硬数据：
    画出的：祖父/祖母/父亲/母亲/我/妻子/哥哥/儿子/女儿（9）
    没画的：伯父、伯母、岳父、岳母、嫂子、堂兄、堂嫂、舅子、侄子、堂侄、外甥（11）
  库的算法只画「树根的祖先链 + 后代 + 树根的兄弟姐妹 + 各人配偶」，
  **横向亲戚（伯父那一支）与姻亲旁支（妻子的兄弟）永远进不来** ——
  换树根也救不了（换到最高祖先，"妻子的兄弟"照样不在树里）。
  「母亲看不到孩子」还有第二层原因：孩子只登记了父亲时，母亲那一侧根本没有边。

改法（不再依赖库的树算法）：
  · app/Kinship::familyMap() —— 以「我」为中心的两轮贯穿检索，带 seen 防环：
      父母（-1 代）/ 子女（+1 代）/ 配偶（同代）/ 每一层的配偶
      / 配偶的父母与子女（姻亲旁支由此进来）/ 兄弟姐妹的子女（侄甥）
    → 上一代、这一代、下一代的**所有有关系的人**都在名单里。
  · app/Kinship::householdChildren() —— 子女按**父母所在的户**归堆，
    而不是按"某个人的 children"。于是孩子只登记了一位父母时，
    照样挂到这对夫妻的户上（语义：这孩子是我们俩的）。
  · templates/kin/tree.php —— 自己排版：每代一行、按「户」水平排开；
    夫妻两张卡之间画短横线；子女一律从**这条横线的中点**垂下来
    （x = (左卡中心 + 右卡中心) / 2，与"谁登录"无关）。
  · 拖拽/缩放保留（用户明确要），改用原生 d3.zoom；不再引 family-chart。

验证（只跑这一个模块，按用户要求）：
  · _tooling/_fb_kin_v15.py —— 22 项全过：
      ✔ 20/20 全员画出（== 从「我」出发可达的人数）
      ✔ 7 对夫妻都有横线；7 个有子女的户**下垂线全部落在横线中点**
      ✔ 用户点名的场景一：删掉「母亲→儿子」这条边（模拟只登记父亲）后，
        下垂线**仍然**从夫妻横线中点出来，孩子仍在图上
      ✔ 用户点名的场景二：给母亲开账号、**用她的手机号登录**，
        家谱里能看到自己的孩子，且与父亲视角画的是同一批人
      ✔ 截图存档（全图 / 母亲视角 / 窄屏）
  · _tooling/_fb_kin_v15_falsify.py —— 反向验证 2/2 抓住：
      注入「从其中一张卡出来」→「从横线中点出来」变红
      注入「只走直系血亲」→「每个人都被画出来」变红
  · e2e 550 条全过（家谱段改到 v15 的判据上）

顺带修的既有问题：
  · app/Kinship.php 老库升级回填按实际存在的列动态拼（缺列不再 1054 炸断升级）
  · _fb_e2e.py 家谱断言改到 kin_v15_nodes（旧解析器在新页面上只会解析出空）
 2026-10-02 10:26:14 +08:00
laoyang 71a7ec35a0 v14: 观影/家谱/日程/旅程/资源/任务六模块统一，首页改 dashboard 
用户 14 条需求一次交付（1-13 功能 + 14 工作方式）。

观影（1-4）
- 返回文案全模块统一为「返回观影」（不再有「返回列表」「返回观影记录」三种叫法）
- 观影人一律用彩色人物标签 person_chip：底色由头像主色算出来（上传时存库），
  瀑布流卡片也按人显示；五处观影模板全部改用它
- 人员显示统一走 person_name()（shown → 我给他起的称呼 → 姓名）
- 影院管理页与年度报告页的上下两块用 .card + .card 统一给间距（原来紧贴成一整块）

家谱（5）
- 树根从「我」换成**辈分最高的祖先**：库画的是"树根的祖先链+后代+树根的兄弟姐妹"，
  根=我 时伯父/堂兄/嫂子/侄子一个都不画（12 人夹具只画出 8 人）
- focusMap 按**代数**圈定三代（不再按步数），normalizeLinks 把子女对称挂到父母双方
  —— 修掉"母亲登录看不到孩子"
- 新增「看全部 / 回到我」两个按钮，放在画布外（画布整块被库接管了手势）

统一事件原语（6-9）
- 旅程：TripLog 全量迁入（3 趟旅程 / 21 段行程 / 72 张照片 / 5 个人）。
  复用 events(kind='trip') + trip_details + trip_nodes（计划/执行双轨保留）
- 日程：每人可建日历本（自定义色）+ 共享只读/可写；观影与旅行是每人默认两本，
  内容是**从各模块实时派生**的（不复制，所以改了观影日期日历立刻跟着变）；
  没有具体时分 = 全天；月视图参照群晖 Calendar
- 资源：挂在某人名下的附属信息（标题+正文+多附件），可共享给多人并设只读/读写，
  默认折叠、可搜标题与正文
- 任务：看板三列 + 两级子任务 + 评论@人 + 共享 + 循环（完成时按原截止日推下一期）
- 统一附件表：四个模块的附件共用一张，下载地址不落库、一律由 media.php 现算

模块化（10-11）
- App\Module 是模块的唯一来源（加一行 = 导航条/主题色/个人设置三处自动出现）
- 个人设置里可勾选要显示哪些模块、拖动排序（关掉的模块**不会**被兜底补回来）
- 每个模块一套主题色（家庭级），只覆盖 --brand 三兄弟，不碰纸墨底色

其他（12-13）
- 新增成员表单可选所属分组（编辑表单没有：分组是"我和他的关系"，只归我自己）
- 首页改 dashboard：接下来的日子 / 未来七天 / 手头在做 / 往年今日。
  家人卡片从首页撤走（看人去名册）

验证（全部通过）
- e2e 542 条（新增 4 模块端到端 60+ 条）
- 桌面几何 368 / 移动端几何 520 / 家谱 12 / 交互 97 / 老库升级 123
- SQL 列名静态校验 0 处可疑（对着真实表结构）
- 反向验证 18 条新注入全部抓住

顺带修掉的既有问题
- 老库升级回填 SQL 按实际存在的列动态拼（缺列不再 1054 炸断升级）
- 全新安装时 Schema::ensure 跑在"人还没建"之前 → 补建日历本三处齐备
- 窄屏导航横向溢出（模块从 4 个加到 8 个后顶栏撑破视口）
 2026-10-02 09:28:07 +08:00
laoyang e9b3b8666b v11: 家谱按户排布（夫妻并排/长幼排序/父母括号/姻亲）；观影设置下拉收拢影院·搜索·统计·年度报告；观影人头像 
家谱（用户第 2 点，重写模板与 Kinship::tree）：
- 同代聚成「夫妻单元」（户）：血亲当主位、配偶并排在其右，兄弟_姐妹按长幼（长子左）
- 血亲可达性判「姻亲」：只走 parent/child 边从「我」可达者为本家血亲，妻子的父母
  走不到 → 标「姻亲」并排到本代末尾（旧判据「上无父母且下无子女」对岳父母恒为假，是真 bug）
- 父母括号连线：横杆盖住父母列到其子女各列，竖线落父母列中心、每子女列一道下线
- 称呼按长幼定死：姐夫/妹夫、嫂子/弟媳、大/小舅子、大/小姨子、大伯子/小叔子、
  大姑子/小姑子、侄子/侄女、外甥/外甥女、堂/表
- 列宽地板 minmax(min-content,1fr)：原 minmax(0,1fr) 在窄屏+户数多时把列压到卡片
  （96px）以下 → 同代卡片互相重叠；.tnode 加 flex:0 0 auto 防被 flex 压扁

观影（用户第 3~5 点）：
- 顶栏删「影院」入口（影院是观影模块的子功能）；观影列表右侧加「⚙ 设置」下拉，
  内含 影院管理 / 高级搜索 / 统计 / 年度报告（后三者从 MovieLog 迁入，
  app/MovieStats.php + 三个只读路由，MySQL 方言；图表全用纯 CSS，不引 CDN）
- 评价区删除「我」的长条徽标（被 flex column stretch 拉成整行宽的丑色带）
- 观影人弹窗列表与已选 chips 带头像；syncChips 点名取 .att-name/.att-av
  （旧写法取「第一个 span」，v11 起那是隐藏占位，chip 上会没名字）

验证：e2e 432/0、桌面几何 268/0、移动几何 464/0、交互几何 97/0、
静态空跑 199/0、反向验证 v11 十条 10抓/0漏。本轮无 DB 变更（Schema 仍 v10）。
移动几何抓出两个真溢出并已修：高级搜索页 select 长选项撑破 .field、
原生 date 输入撑破 .date-range（360/375px）。
 2026-10-01 12:11:43 +08:00
laoyang 1669ab48d0 五项家庭化改造：以个人为中心 · 家谱 · 三种角色 · 附件存储可配置 · 独立页样式 
1. 独立页（登录/安装/错误）套上 HTML 骨架 —— 修「首页为什么没有样式」：
   新增 templates/layout-bare.php，View::render 对独立页也走完整 <head> + CSS。
2. 以个人为中心：Kinship::label() 现算称呼、Auth::homeTitle() 出「X的家书」；
   同一批人在不同登录者眼里自动变成公公婆婆 / 岳父岳母（不存一次性称谓）。
3. 附件存储可配置：Storage 门面（local / 阿里云 OSS），库里只存相对键，
   云端失败自动回退本地；设置页可选驱动并填 OSS 参数（照 MovieLog 的方案）。
4. 三种角色：admin / member / guest，访客只读、写操作一律 403；
   accounts.role 枚举扩容，老库靠 Schema::ensure() 自动升级。
5. 家谱：只存相邻两代的边（parent / spouse），其余称呼全部推导 ——
   兄弟姐妹不存边（共同父母 + birth_rank 排行推长子/次女、哥哥/妹妹），
   认不清的人用虚拟人物 is_placeholder 占位，关系天然双向。

顺带修掉本地 e2e 挖出的 8 个线上级 bug（性别写死、长幼方向反、关系方向静默写反、
birth_rank 不从表单取回、隐式可空参数致响应头失效、无文件字段被误判为上传失败、
layout 变量撞车覆盖 $me、世代 0 显示成「下 0 代」）。

验证：kinship 单测 37/0 · HTTP e2e 81/0 · 老库升级专测 14/0 ·
反向验证 11/11（把每个修复改回旧写法，对应断言都会变红）。
 2026-09-30 08:13:07 +08:00