Files
FamilyBook/app
laoyang 2e40133d8f 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…)。
2026-10-19 15:27:08 +08:00
..