v62：影院管理补齐接口（统计 / 年度报告 / 高级搜索）+ 名册带工作经历

用户 2026-10-19：「设置里面的影院管理，这些功能都还没有，应该补充，
就是增加影院呢、修改影院呢、高级搜索、统计、年度报告，这些全部都应该补充进去。」

一、三个新子路由（都是**家族级**，必须在 `$id > 0` 分支之前处理）

  GET /api/v1/movies/stats   总览 + 按影院 / 按人 / 按月 / 按年
  GET /api/v1/movies/report  年度报告（以登录者为中心，?year= 可切年）
  GET /api/v1/movies/search  片名 / 影院 / 人 / 起止日期的组合搜索

⚠️ 全部复用**网页端那一份 `MovieStats`**（overview/byCinema/byPerson/byMonth/
   byYear/annual/years/search）—— 统计数字两边必须一致，否则用户会发现
   "网页 124 部、App 121 部"。
⚠️ 三个路由都做了 **`$id === 0` 守卫**：`/movies/stats` 不能被当成"id=0 的详情"。
⚠️ `search` 在条件全空时**不查全库**（返回 has_cond=0），与网页 `hasCond` 同行为 —
   否则"搜索"等于"列出全部观影"。

二、features 声明 movies_stats / movies_report / movies_search
    老端上据此隐藏入口（新端上不用探测，但让能力可发现是这套约定的一部分）。

三、名册带 `jobs`（用户：「名册的列表太空了，应该显示更多内容，例如工作单位、职务」）
    新增 `PersonJob::mapFor(array $personIds)` —— **一次 `IN (…)` 批量取回**。
    ⚠️ 不能在装饰循环里逐人 `PersonJob::list()`：名册上千人就是上千次查询（N+1）。
    ⚠️ 排序与 `list()` 逐字一致（当前段在前 → 开始时间倒序 → id 倒序），
       否则"列表显示的单位"和"详情里第一段"会是两个不同的单位。
    ⚠️ 端上列表实际用的是 `persons.org` / `persons.title`（本地库有那两列），
       `jobs` 是给"接口直出"的场景预备的 —— 两条链路都保留。

验证：_fb_v62_cinema_api.py 45/0（独立副本 + 真 MariaDB）；
      覆盖影院 CRUD 10 条 + 统计 8 + 年报 7 + 搜索 7 + 名册带 jobs 4；
      php -l 全量通过。
线上：本提交对应的代码**已在线上**（13:17 那次部署带上去的，非本次操作），
      真机实测统计页显示的是真实数据（横店电影城 4 / 上影影城 3…）。

app/PersonJob.php

@@ -39,6 +39,45 @@ final class PersonJob
         return $st->fetchAll();
     }
 
+    /**
+     * **批量**取一批人的工作经历（一个人的当前段在前，其余按开始时间倒序）。
+     *
+     * 🔴 v62（用户 2026-10-19）：「现在名册的列表太空了，应该显示更多内容，
+     *    例如**工作单位、职务**。」
+     *    ⇒ 名册列表（上千人）要显示单位/职务，**不能**对每个人各调一次
+     *      `list()` —— 那是 N+1 查询（1000 人 = 1000 次 SQL）。
+     *      这里一次 `IN (...)` 取回来，再按 person_id 分桶。
+     *
+     * ⚠️ 返回的是**每个 id 的完整经历数组**（不是只给第一段）：
+     *    端上列表只显示第一段（当前/最近的那段），但详情页要全部 ——
+     *    同一份数据一次给足，省得端上为详情再打一次接口。
+     * ⚠️ 排序与 `list()` **逐字一致**（当前段在前 → 开始时间倒序 → id 倒序）：
+     *    否则"列表显示的单位"和"详情里第一段"会是两个不同的单位。
+     *
+     * @param int[] $personIds
+     * @return array<int,array> person_id => [经历, …]（没有经历的人**不出现**在结果里）
+     */
+    public static function mapFor(array $personIds): array
+    {
+        $ids = array_values(array_unique(array_filter(
+            array_map('intval', $personIds), static fn(int $v): bool => $v > 0)));
+        if (count($ids) === 0) {
+            return [];
+        }
+        // ⚠️ `IN (?,?,…)` 的占位符按实际个数生成 —— 不能直接把数组塞进去
+        $ph = implode(',', array_fill(0, count($ids), '?'));
+        $st = Database::get()->prepare(
+            "SELECT * FROM person_jobs WHERE person_id IN ({$ph})
+              ORDER BY person_id, (end_ym IS NULL) DESC, COALESCE(start_ym, \"\") DESC, id DESC"
+        );
+        $st->execute($ids);
+        $out = [];
+        foreach ($st->fetchAll() as $r) {
+            $out[(int)$r['person_id']][] = $r;
+        }
+        return $out;
+    }
+
     /**
      * 整组替换（与 Person::replaceContacts 同一套做法：表单里就是一组行，
      * 删行/改行/加行一起提交，最省心 —— 逐行增删要额外的行 id 体系）。