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/Movie.php

@@ -24,16 +24,17 @@ namespace App;
 final class Movie
 {
     /** @return array<int,array> 观影记录，按开场时刻倒序（瀑布流用）。
-     *  $keyword 非空时搜：片名 / 影院名 / 同行人名（LIKE）。 */
-    public static function all(int $familyId, string $keyword = ''): array
+     *  $keyword 非空时搜：片名 / 影院名 / 同行人名（LIKE）。
+     *
+     *  ⚠️ 列表上的「观影人」是**每人一个标签**（头像 + 底色 + 称呼），
+     *     不再拼成一串名字 —— 所以这里用 attachAttendees() 补出 `attendees`，
+     *     而不是 SQL 里 GROUP_CONCAT 出一个 attendee_names 字符串。 */
+    public static function all(int $familyId, string $keyword = '', int $viewerId = 0): array
     {
         $sql =
             'SELECT e.id, e.title, e.starts_at, e.ends_at, e.note,
                     d.poster_key, c.name AS cinema_name, c.color AS cinema_color,
-                    (SELECT COUNT(*) FROM event_attendees a WHERE a.event_id = e.id) AS attendee_count,
-                    (SELECT GROUP_CONCAT(p.name ORDER BY a.position, p.id SEPARATOR "、")
-                       FROM event_attendees a JOIN persons p ON p.id = a.person_id
-                      WHERE a.event_id = e.id) AS attendee_names
+                    (SELECT COUNT(*) FROM event_attendees a WHERE a.event_id = e.id) AS attendee_count
              FROM events e
              LEFT JOIN movie_details d ON d.event_id = e.id
              LEFT JOIN cinemas c ON c.id = d.cinema_id
@@ -52,11 +53,47 @@ final class Movie
         $st->execute($bind);
         $rows = $st->fetchAll();
         MovieReview::attachStats($rows);
+        self::attachAttendees($rows, $viewerId);
         return $rows;
     }
 
+    /**
+     * 给一批记录补上 `attendees`（每人一条：id / name / my_nickname / avatar /
+     * avatar_color）。**一次查询**补完，不逐条查 —— 瀑布流一页几十部电影，
+     * 逐条查就是几十次往返（N+1）。
+     */
+    public static function attachAttendees(array &$rows, int $viewerId = 0): void
+    {
+        if (!$rows) {
+            return;
+        }
+        $ids = [];
+        foreach ($rows as $r) {
+            $ids[] = (int)$r['id'];
+        }
+        $ids = array_values(array_unique($ids));
+        $in  = implode(',', array_fill(0, count($ids), '?'));
+        $st  = Database::get()->prepare(
+            "SELECT a.event_id, p.id, p.name, p.avatar, p.avatar_color,
+                    n.nickname AS my_nickname
+               FROM event_attendees a
+               JOIN persons p ON p.id = a.person_id
+               LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
+              WHERE a.event_id IN ($in)
+              ORDER BY a.position, p.id"
+        );
+        $st->execute(array_merge([$viewerId], $ids));
+        $map = [];
+        foreach ($st->fetchAll() as $r) {
+            $map[(int)$r['event_id']][] = $r;
+        }
+        foreach ($rows as $k => $r) {
+            $rows[$k]['attendees'] = $map[(int)$r['id']] ?? [];
+        }
+    }
+
     /** 一条完整记录（详情/编辑页用）：事件 + 卫星 + 影院 + 同行人 + 照片 */
-    public static function find(int $familyId, int $id): ?array
+    public static function find(int $familyId, int $id, int $viewerId = 0): ?array
     {
         $st = Database::get()->prepare(
             'SELECT e.*, d.info, d.poster_key, d.ticket_key, d.cinema_id, d.douban_meta,
@@ -72,21 +109,25 @@ final class Movie
         if (!$row) {
             return null;
         }
-        $row['attendees'] = self::attendees($id);
+        $row['attendees'] = self::attendees($id, $viewerId);
         $row['photos']    = self::photos($id);
         return $row;
     }
 
-    /** @return array<int,array{id:int,name:string,avatar:?string}> 同行的人 */
-    public static function attendees(int $eventId): array
+    /**
+     * 同行的人。带 `my_nickname` 与 `avatar_color` —— 页面上要按「我叫他什么」
+     * 显示、并用他自己的底色画出标签（见 helpers 的 person_name / person_bg）。
+     */
+    public static function attendees(int $eventId, int $viewerId = 0): array
     {
         $st = Database::get()->prepare(
-            'SELECT p.id, p.name, p.avatar
+            'SELECT p.id, p.name, p.avatar, p.avatar_color, n.nickname AS my_nickname
              FROM event_attendees a JOIN persons p ON p.id = a.person_id
+             LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
              WHERE a.event_id = ?
              ORDER BY a.position, p.id'
         );
-        $st->execute([$eventId]);
+        $st->execute([$viewerId, $eventId]);
         return $st->fetchAll();
     }