FamilyBook

55 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
laoyang	a5e559b2b3	v25 第 25 批（9 条）：名册分组不刷页 / 纪念日多人 / 首页等高 / 移出不回流 / 名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 / 导航线上数据与图标用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）： 1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。 2. 纪念日：关联人改多选（复用 _person_picker，字段 person_ids[]）；自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；列表新增「关联人」列并给人名前加头像。 3. 首页：日程/任务两块完全等高（align-items:stretch + 固定总高 + flex 子项 min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。 4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons() 每次 Schema::ensure() 都无条件重灌（线上实测每跑一次 +1 行）。修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的老库才跑）。 5. 名册：点击=看详情、只有拖 ⠿ 手柄才是排序（原来整行既能点又能拖，语义混乱）。 6. 任务：所有任务前加复选框，任何位置点勾即完成；状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。 7. 财务：类别标签改多选非互斥（再点一次取消该类别），上下两图 + 图例 + 表格全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。 8. 微信读书：新增懒同步（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、封面图拉下来存本站存储（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。 9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因： · 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()； · 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）； · Nav::iconKey() 与 SimpleNav 的 icon_key() 算法不一致（少一次 md5 归一化） → 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。新增两个免登录公开出口 nav_icon.php / nav_avatar.php。顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）： app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是按字节匹配的 —— 「。」= E3 80 82 → 字节 82 进了可剥集合 → 「层」= E5 B1 82 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报 `1366 Incorrect string value` → 地址拆分升级从上线起一直在失败被跳过（每请求报一次）。改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。验证战绩： - e2e 1289/0（新增 Region 字节级用例等） - 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 · 第23批 52/0 - 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0 - 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」） - 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住 - 线上 26 个文件与本地逐字节一致；展示页 200、图标 66/66 200、登录 200、越权/不存在均 404、签发短语后 ensure() 不再报错。	2026-10-07 11:35:31 +08:00
laoyang	809443d429	v7：家谱树与名册三处口径统一（树上的人自动互相可见）用户反馈：我把一个人设成配偶、又设了我们的孩子，配偶登录后首页能看到孩子、家谱也能看到，名册里却看不到——没分享的人却在家谱上看得到，口径打架。口径由用户拍板：以每个人为中心上下三代那棵家谱树（= 首页「我的家人」同一棵）里的人，自动进他名册（source=kin，默认归公共「家人」组）；树外的人三处都不可见。 - PersonRoster::syncKinForFamily()：整树同步（补缺、撤多余；已存在的 self/shared/seeded 行绝不碰，用户改过的分组/顺序保留）。幂等。 - 同步挂在事件上：建边 / 解边 / 开通账号 / 结构升级回填。 - Relations::addParent/addSpouse 建边后同步；remove/detach 解边后同步。 - 名册不许单独移走 kin 来源的人（服务端拦截 + 人话提示 + 卡片隐藏移走按钮改提示语）：他在首页/家谱照样看得见，单藏名册只会回到口径打架；想不再看到他，解除关系即自动移出。 - 名册卡片给 kin 来源标「家谱」徽标（来历可辨）。 - Schema v7：widenRosterSourceEnum（⚠️ CREATE TABLE IF NOT EXISTS 不会更新已存在表的枚举，v6 老库不扩宽则 strict 模式下插 kin 整条被拒、且被容错吞掉——e2e 的 v6 旧库当场抓出）+ 按已有关系回填 kin 条目。验证：e2e 309/0、升级专测 82/0、部署静态空跑 78/0、桌面几何 0 失败、交互 97/0、移动几何 180/0；线上探针 ver=7、enum 含 kin、无升级告警。	2026-09-30 16:12:28 +08:00
laoyang	ed38a40c08	名册每人一份 · 分组两层 · 拖动排序 · 表单合一 · 裁剪可缩放按用户十点反馈逐条落地（v5，Schema::VERSION = 5）： - 名册改成每人一份：新表 person_roster(owner_id, person_id, group_id, sort_order, source)。默认只看「我添加的 + 别人分享给我的」； source='seeded' 是升级时从老 persons.group_id 播进来的（先播数据再删列）。 - 排序不再手填：名册页直接拖动卡片（整版提交，一次 applyLayout 落库），无 JS 时卡片上的「调整分组」表单照旧可用。 - 分组分两层：管理员在「系统设置」维护公共分组（owner_id=0），用户在「个人设置」加自己的分组；显示顺序各人各定、互不影响。 - 名册可共享：把名片分享给别的用户（people/share）；添加成员时若系统里已有这个人，可直接复用（people/pick），不必重复录入。 - 「编辑成员」与「改我自己的资料」合并为同一张表（templates/people/form.php），两个入口 href 完全相同，h1 按改谁切换文案；个人设置页只留资料入口 + 称呼 + 我的分组三块，删除 templates/settings/_profile.php。 - 系统设置收进头像下拉，顶栏只剩首页/家谱/名册。 - 裁剪器加缩放（滑块 1-4x、Ctrl+滚轮、还原）：缩放只改视图大小，落库的归一化矩形保持不变。 - 权限：管理员可以改任何人的权限（含自己），只拦「最后一位管理员」被降级。 - 去掉首页「我的一句话」后的链接、家谱说明段、以及「还没归到任何分组」提示。迁移安全：数据回填（PersonRoster::seedFromPersons）先于删列执行、且不进 tryStep 容错；失败步骤记入 settings.schema_upgrade_warning 并在系统设置页提示。线上已验证：schema_upgrade_warning 为空，person_roster/person_groups.owner_id 就位，persons.group_id / sort_order 已删。验证：php -l 48 文件；本地 e2e 277/0、老库升级 81/0、桌面几何 108/0、移动端几何 180/0、交互 96/0；反向验证 38 条注入 + 2 条缩放注入全部命中；部署静态断言 53/0，站点自检 7/7（--resolve 锁本机走 443，探针真的进 PHP）。	2026-09-30 13:24:26 +08:00

Author

SHA1

Message

Date

laoyang

a5e559b2b3

v25 第 25 批（9 条）：名册分组不刷页 / 纪念日多人 / 首页等高 / 移出不回流 /

名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 /
导航线上数据与图标

用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）：

1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。
2. 纪念日：关联人改**多选**（复用 _person_picker，字段 person_ids[]）；
   自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；
   列表新增「关联人」列并给人名前加头像。
3. 首页：日程/任务两块**完全等高**（align-items:stretch + 固定总高 + flex 子项
   min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。
4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons()
   **每次 Schema::ensure() 都无条件重灌**（线上实测每跑一次 +1 行）。
   修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的**老库**才跑）。
5. 名册：点击=看详情、**只有拖 ⠿ 手柄**才是排序（原来整行既能点又能拖，语义混乱）。
6. 任务：所有任务前加复选框，任何位置点勾即完成；
   状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。
7. 财务：类别标签改**多选非互斥**（再点一次取消该类别），上下两图 + 图例 + 表格
   全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。
8. 微信读书：新增**懒同步**（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、
   封面图**拉下来存本站存储**（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。
9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、
   展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因：
   · 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()；
   · 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）；
   · Nav::iconKey() 与 SimpleNav 的 icon_key() **算法不一致**（少一次 md5 归一化）
     → 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。
   新增两个**免登录公开出口** nav_icon.php / nav_avatar.php。

顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）：
app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是
**按字节**匹配的 —— 「。」= E3 80 **82** → 字节 82 进了可剥集合 →
「层」= E5 B1 **82** 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报
`1366 Incorrect string value` → **地址拆分升级从上线起一直在失败被跳过**（每请求报一次）。
改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。

验证战绩：
- e2e 1289/0（新增 Region 字节级用例等）
- 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 ·
  第23批 52/0
- 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0
- 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」）
- 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住
- 线上 26 个文件与本地**逐字节一致**；展示页 200、图标 66/66 200、登录 200、
  越权/不存在均 404、签发短语后 ensure() 不再报错。

2026-10-07 11:35:31 +08:00

laoyang

809443d429

v7：家谱树与名册三处口径统一（树上的人自动互相可见）

用户反馈：我把一个人设成配偶、又设了我们的孩子，配偶登录后首页能看到
孩子、家谱也能看到，名册里却看不到——没分享的人却在家谱上看得到，
口径打架。

口径由用户拍板：**以每个人为中心上下三代那棵家谱树（= 首页「我的家人」
同一棵）里的人，自动进他名册（source=kin，默认归公共「家人」组）；
树外的人三处都不可见。**

- PersonRoster::syncKinForFamily()：整树同步（补缺、撤多余；已存在的
  self/shared/seeded 行绝不碰，用户改过的分组/顺序保留）。幂等。
- 同步挂在事件上：建边 / 解边 / 开通账号 / 结构升级回填。
- Relations::addParent/addSpouse 建边后同步；remove/detach 解边后同步。
- 名册不许单独移走 kin 来源的人（服务端拦截 + 人话提示 + 卡片隐藏
  移走按钮改提示语）：他在首页/家谱照样看得见，单藏名册只会回到口径
  打架；想不再看到他，解除关系即自动移出。
- 名册卡片给 kin 来源标「家谱」徽标（来历可辨）。
- Schema v7：widenRosterSourceEnum（⚠️ CREATE TABLE IF NOT EXISTS 不会
  更新已存在表的枚举，v6 老库不扩宽则 strict 模式下插 kin 整条被拒、
  且被容错吞掉——e2e 的 v6 旧库当场抓出）+ 按已有关系回填 kin 条目。

验证：e2e 309/0、升级专测 82/0、部署静态空跑 78/0、桌面几何 0 失败、
交互 97/0、移动几何 180/0；线上探针 ver=7、enum 含 kin、无升级告警。

2026-09-30 16:12:28 +08:00

laoyang

ed38a40c08

名册每人一份 · 分组两层 · 拖动排序 · 表单合一 · 裁剪可缩放

按用户十点反馈逐条落地（v5，Schema::VERSION = 5）：

- 名册改成每人一份：新表 person_roster(owner_id, person_id, group_id,
  sort_order, source)。默认只看「我添加的 + 别人分享给我的」；
  source='seeded' 是升级时从老 persons.group_id 播进来的（先播数据再删列）。
- 排序不再手填：名册页直接拖动卡片（整版提交，一次 applyLayout 落库），
  无 JS 时卡片上的「调整分组」表单照旧可用。
- 分组分两层：管理员在「系统设置」维护公共分组（owner_id=0），
  用户在「个人设置」加自己的分组；显示顺序各人各定、互不影响。
- 名册可共享：把名片分享给别的用户（people/share）；添加成员时若系统里
  已有这个人，可直接复用（people/pick），不必重复录入。
- 「编辑成员」与「改我自己的资料」合并为同一张表（templates/people/form.php），
  两个入口 href 完全相同，h1 按改谁切换文案；个人设置页只留
  资料入口 + 称呼 + 我的分组三块，删除 templates/settings/_profile.php。
- 系统设置收进头像下拉，顶栏只剩 首页/家谱/名册。
- 裁剪器加缩放（滑块 1-4x、Ctrl+滚轮、还原）：缩放只改视图大小，
  落库的归一化矩形保持不变。
- 权限：管理员可以改任何人的权限（含自己），只拦「最后一位管理员」被降级。
- 去掉首页「我的一句话」后的链接、家谱说明段、以及「还没归到任何分组」提示。

迁移安全：数据回填（PersonRoster::seedFromPersons）先于删列执行、且不进
tryStep 容错；失败步骤记入 settings.schema_upgrade_warning 并在系统设置页提示。
线上已验证：schema_upgrade_warning 为空，person_roster/person_groups.owner_id
就位，persons.group_id / sort_order 已删。

验证：php -l 48 文件；本地 e2e 277/0、老库升级 81/0、桌面几何 108/0、
移动端几何 180/0、交互 96/0；反向验证 38 条注入 + 2 条缩放注入全部命中；
部署静态断言 53/0，站点自检 7/7（--resolve 锁本机走 443，探针真的进 PHP）。

2026-09-30 13:24:26 +08:00