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、无升级告警。

app/Schema.php

@@ -32,8 +32,13 @@ final class Schema
      *   6 → **成员信息对齐 vCard**：person_contacts（多个电话 / 邮箱 / 地址 / 网址，
      *       对应 vCard 的 TEL / EMAIL / ADR / URL）+ persons.org / persons.title
      *       （工作单位 ORG / 职务职称 TITLE）。主手机号仍留在 persons（登录凭据）。
+     *   7 → **家谱树 ⇒ 名册自动同步**：以每个账号为中心上下三代的树里的人
+     *       自动进他名册（source=kin，归公共「家人」组），树外自动撤；
+     *       升级时按已有关系回填。起因：家谱/首页按关系推导可见，名册按分享推导
+     *       —— 同一个人三处口径打架（配偶能在家谱看到孩子、名册里却没有）。
+     *       用户拍板：树上的人三处都可见，没上树的都不可见。
      */
-    public const VERSION = '6';
+    public const VERSION = '7';
 
     /** @return string[] */
     public static function statements(): array
@@ -325,6 +330,22 @@ SQL,
         //    搬进 contacts 反而把「登录凭据」和「联系信息」搅在一起。
         //    contacts 里的 phone 是**额外的**电话，一样加密存。
 
+        // ---- 家谱树 ⇒ 名册自动同步（版本 7）----
+        // ⚠️ 先扩宽 source 枚举再回填：v6 老库的枚举只有 self/shared/seeded，
+        //    建表语句里的 IF NOT EXISTS **不会**更新已存在表的枚举 ——
+        //    不扩宽的话，回填插 source='kin' 会被严格模式整条拒掉，
+        //    而且 ensure() 的容错会把这条失败悄悄吞掉（线上表现＝功能像没生效）。
+        self::widenRosterSourceEnum($db);
+        // 已有的关系也要补出 kin 名册条目：升级完的当下口径就对齐，
+        // 而不是等用户哪天再点一次「保存关系」才生效。
+        // syncKinForFamily 幂等（只补缺、撤多余，用户改过的分组/顺序不动），
+        // 重复跑不插重；某条脏数据只影响它自己，容错跑，别挡住后面的步骤。
+        self::tryStep('按家谱回填名册（kin 与首页同一棵树）', static function () use ($db) {
+            foreach ($db->query('SELECT id FROM families')->fetchAll() as $fam) {
+                \App\PersonRoster::syncKinForFamily((int)$fam['id']);
+            }
+        });
+
         // 被容错跳过的数据步骤记进设置，系统设置页会把它显出来 ——
         // 不然「升级没跑完」这件事只活在日志里，跟没发生一样。
         if (self::$stepErrors) {
@@ -430,6 +451,24 @@ SQL,
         }
     }
 
+    /** person_roster.source 原本只有 self/shared/seeded，v7 起要加 kin（见 ensure 里的说明） */
+    private static function widenRosterSourceEnum(\PDO $db): void
+    {
+        $st = $db->prepare(
+            "SELECT COLUMN_TYPE FROM information_schema.COLUMNS
+             WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'person_roster' AND COLUMN_NAME = 'source'"
+        );
+        $st->execute();
+        $type = (string)$st->fetchColumn();
+        if ($type !== '' && strpos($type, 'kin') === false) {
+            $db->exec(
+                "ALTER TABLE `person_roster` MODIFY COLUMN `source`
+                 ENUM('self','shared','seeded','kin') NOT NULL DEFAULT 'self'
+                 COMMENT 'self=我自己加的 / shared=别人分享给我的 / seeded=升级时按当时可见范围补的 / kin=家谱树自动同步（v7）'"
+            );
+        }
+    }
+
     private static function hasIndex(\PDO $db, string $table, string $index): bool
     {
         $st = $db->prepare(