家谱 v22：改按 family-chart 官方用法接，并放开代数上限

用户指出「只需要按照 json 格式，把以我为中心的关联数据全部取出来，
全都封装进去就行了，id 用用户表的 id，性别名字生日头像都是现成的，
只需要把配偶、父母和孩子放进去用 id 关联」——并强调「之前一定是你
调用的方法不对」。

== 验证结论（先量再改）==
用**官方示例自己的数据**（donatso 的 data.json，13 人，格式完全官方）
跑了一遍：库画出 11 人，**配偶 Andrea 的父母 Zadro/Zadra 一个都没画**。
那两位就在数据里、rels.parents 也指向他们、格式与官方示例一字不差。
→ 说明「按格式全塞进去就能画全」在**姻亲**这一项上不成立：
  库的算法只走「树根的祖先链 + 后代 + 树根的兄弟姐妹 + 各人配偶」，
  **不会从配偶继续向上/向下 walk**。这是库的算法边界，不是格式/关联问题。

== 但用户的批评有一半是对的：调用方式确实有我没做足的地方 ==
官方示例是：<div id="FamilyChart" class="f3"> + 引 family-chart.css。
我之前**既没加 f3 类、也没引库 CSS**，而是自己在 app.css 里手补
`.kin-chart svg.main_svg{width:100%;height:100%}` 去绕开 300×150 那个坑 ——
属于"用歪门邪道达到同样效果"。现在按官方来：
  · 容器加 `f3` 类（库的 CSS 全部以 .f3 作用域）
  · 引入官方 family-chart.css（新增 vendor 文件）
  · 在 app.css 里把库的深色主题变量覆盖成家书宣纸色
    （--male-color / --background-color / --text-color 等）
  · 自己的 svg 撑满那条规则删掉（官方 CSS 已提供）

== 放开代数上限（用户要求「全部取出来」）==
官方示例**不调** setAncestryDepth / setProgenyDepth —— 库在"未设置"时
会跳过深度截断，等于不限代数。我之前写死了 2/3，真实家庭一超过就被砍。
现在不设这两个值。服务端 familyMap 的 up/down 也从 (2,2) 放到 (9,9)
（这两个参数只影响**代数标号**，超出会压到边界档导致曾祖辈与祖辈混层；
遍历本身是走遍整个连通图的，人员收录数不受影响）。

== 工具同步 ==
- familybook_deploy.sh：新增 v22 三条契约（vendor CSS 在 / 模板引了它 /
  容器有 f3 类），并加**反向断言**「不许再出现 setAncestryDepth|setProgenyDepth」；
  旧的"卡片尺寸/间距"断言同步。
- _fb_kin_geom_falsify.py：注入②的原锚点（setProgenyDepth）已随本次删除，
  换成「禁掉上溯循环」——树根退回「我」，伯父/堂兄/堂嫂/堂侄/侄子那批旁支
  会离开画面，J 项必须红。3/3 全抓住。
- ⚠️ 又踩一次「注释撞断言字面量」：新写的注释里提到 setProgenyDepth 函数名，
  把「不许再设代数上限」这条反向断言直接打红。改注释避开字面量后恢复。

== 战绩 ==
e2e 549/0 · 桌面几何 368/0 · 移动端 516/0 · 交互 97/0 · 升级专测 123/0
家谱可视化 24/0 · 家谱版面 10/0 · 反向验证 3/3 · 静态断言空跑 RC=0
部署 + 线上自检全过。

templates/kin/tree.php

@@ -15,8 +15,12 @@
 $graph  = $graph ?? \App\Kinship::graph((int)\App\Auth::familyId());
 $people = $people ?? [];
 
-// ---- ① 以我为中心，检索上一代 / 这一代 / 下一代的**所有人** ----
-$map    = \App\Kinship::familyMap((int)\App\Auth::familyId(), (int)$meId, $people, 2, 2);
+// ---- ① 以我为中心，检索**所有有关系的人**（不设代数上限）----
+// ⚠️ 用户明确要求「把以我为中心的关联数据全部取出来」。
+//    familyMap 的 $up/$down 只影响**代数标号**（超出就压到边界那一档），
+//    遍历本身是走遍整个连通图的 —— 所以这两个值不放宽的话，
+//    曾祖辈与祖辈会被压成同一代，排序就乱了。给足余量。
+$map    = \App\Kinship::familyMap((int)\App\Auth::familyId(), (int)$meId, $people, 9, 9);
 $gen    = $map['gen'];
 $units  = $map['units'];
 $unitOf = $map['unit_of'];
@@ -143,7 +147,12 @@ $datumJson = json_encode(
     <button type="button" class="btn btn-ghost btn-sm" id="kinMe">回到我</button>
   </div>
 
-  <div class="kin-chart" id="kinChart" data-datum="<?= e($datumJson) ?>" data-me="<?= e((string)$meId) ?>"></div>
+  <!-- ⚠️ `f3` 这个类名是**库的 CSS 作用域**，不是我们起的名字。
+       官方示例就是 `<div id="FamilyChart" class="f3">` + 引 family-chart.css；
+       少了它，库里 `.f3 svg.main_svg{width:100%;height:100%}` 这条撑满规则不生效，
+       SVG 会退化成浏览器默认的 300×150（连线全被裁掉，而 HTML 卡片层不受影响 →
+       表现为「卡在、线没了」）。 -->
+  <div class="kin-chart f3" id="kinChart" data-datum="<?= e($datumJson) ?>" data-me="<?= e((string)$meId) ?>"></div>
 
   <p class="tree-legend">
     每代一行；<b>一对夫妻之间有一条短横线</b>，
@@ -154,6 +163,11 @@ $datumJson = json_encode(
     妻子那侧的岳父母、舅子等姻亲不在图内（在名册与成员详情页仍可看到）。</span>
   </p>
 
+  <!-- 官方用法是「容器带 class="f3" + 引 family-chart.css」（见 family-chart 官方示例）。
+       之前没引这份 CSS，靠自己在 app.css 里手补 `.kin-chart svg.main_svg{width/height:100%}`
+       绕过去 —— 属于"调用方法不对"。现在按官方来。
+       库的深色主题（--male-color / --background-color…）在 app.css 里覆盖成家书的宣纸色。 -->
+  <link rel="stylesheet" href="<?= e(asset('/assets/vendor/family-chart/family-chart.css')) ?>">
   <script src="<?= e(asset('/assets/vendor/family-chart/d3.min.js')) ?>"></script>
   <script src="<?= e(asset('/assets/vendor/family-chart/family-chart.min.js')) ?>"></script>
   <script>
@@ -179,10 +193,10 @@ $datumJson = json_encode(
       .setTransitionTime(600)
       .setOrientationVertical()
       .setShowSiblingsOfMain(true)
-      .setAncestryDepth(2)
-      // 树根是最高祖先；progeny_depth 要覆盖 "儿子 / 女儿" 这一代，
-      // 所以要比 "我" 到树根的世代再多一代。
-      .setProgenyDepth(3)
+      // ⚠️ 官方示例**不设**祖先/后代的代数上限 —— 库在"未设置"时
+      //    会跳过深度截断，等于**不限代数**，有多少画多少。
+      //    之前写死了具体代数，真实家庭一超过就被砍掉。
+      //    用户要求「全部取出来」，所以这里也不设。
       .setCardXSpacing(180)
       .setCardYSpacing(180);