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 个后顶栏撑破视口）

app/helpers.php

@@ -62,6 +62,78 @@ function media_url(?string $key, array $extra = []): string
     return 'media.php?' . http_build_query(array_merge(['k' => ltrim($key, '/')], $extra));
 }
 
+// ---------------- 人：怎么称呼、什么颜色 ----------------
+
+/**
+ * 页面上「这个人叫什么」的**唯一出口**。
+ *
+ * 用户 2026-10-01 第 3 条：凡是出现人员的地方，默认显示「我」对他的昵称/称呼，
+ * 不要直接冒出姓名。所以这里先看 nicknames 里的 my_nickname，没有才退回姓名。
+ *
+ * @param array $p 至少要有 name；有 my_nickname 就优先用；`shown` 是某些查询
+ *                 已经算好的显示名（如观影表单的已选人），也认。
+ */
+function person_name(array $p): string
+{
+    $nick = trim((string)($p['my_nickname'] ?? ''));
+    if ($nick !== '') {
+        return $nick;
+    }
+    $shown = trim((string)($p['shown'] ?? ''));
+    if ($shown !== '') {
+        return $shown;
+    }
+    return (string)($p['name'] ?? '');
+}
+
+/**
+ * 这个人的底色（浅色底）与字色（深色字）—— 都由他自己的主色推出来。
+ *
+ * 主色来自头像（上传时算好存 persons.avatar_color），没头像或头像是灰片时
+ * 由姓名稳定地推一个。页面上一律走这两个函数，不要再自己写 '#eee'。
+ */
+function person_bg(array $p): string
+{
+    return \App\AvatarColor::bg(\App\AvatarColor::for($p));
+}
+
+function person_fg(array $p): string
+{
+    return \App\AvatarColor::fg(\App\AvatarColor::for($p));
+}
+
+function person_bd(array $p): string
+{
+    return \App\AvatarColor::bd(\App\AvatarColor::for($p));
+}
+
+/**
+ * 一个人的彩色标签（头像 + 称呼 + 他自己的底色）—— 全站唯一画法。
+ *
+ * ⚠️ `$href` 为空时输出 `<span>`：瀑布流里整张卡片已经是 `<a>` 了，
+ *    `<a>` 套 `<a>` 是非法 HTML，浏览器会把外层链接切开（卡片点不动）。
+ *    所以列表/瀑布一律传空，只有详情页那种独立标签才传链接。
+ */
+function person_chip(array $p, string $href = '', string $extraClass = ''): string
+{
+    $name  = person_name($p);
+    $style = 'background:' . person_bg($p) . ';color:' . person_fg($p)
+           . ';border-color:' . person_bd($p) . ';';
+    if (!empty($p['avatar'])) {
+        $av = '<img class="chip-av" src="' . e(media_url((string)$p['avatar'])) . '" alt="">';
+    } else {
+        $av = '<span class="chip-av chip-av-text">'
+            . e(mb_substr($name, 0, 1, 'UTF-8')) . '</span>';
+    }
+    $cls   = 'viewer-tag' . ($extraClass !== '' ? ' ' . $extraClass : '');
+    $inner = $av . '<span class="chip-name">' . e($name) . '</span>';
+    if ($href !== '') {
+        return '<a class="' . e($cls) . '" style="' . e($style) . '" href="' . e($href) . '">'
+             . $inner . '</a>';
+    }
+    return '<span class="' . e($cls) . '" style="' . e($style) . '">' . $inner . '</span>';
+}
+
 /**
  * 读「日期 + 24 小时制时:分:秒」组合控件（templates/_datetime.php 产出）。
  *