laoyang
2e40133d8f
用户 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…）。
FamilyBook
家书，记录家庭的全部生活，一本用岁月写成的家谱。
把一个家的「人」「日子」「去过的地方、看过的电影」收进同一本书里。
它是什么
一个自托管的家庭生活系统。它不是又一个待办清单，而是这个家的长期档案 —— 十年之后还能翻出孩子第一次观影的票根、那年暑假走过的路线。
围绕三个圈展开：
- 人：家庭成员、亲友通讯录，以及他们之间的共享关系
- 时间：日历、日程、提醒，以及任务的期限
- 事件：观影、旅行、其他活动 —— 一切都落在同一条时间轴上
它在做什么
| 阶段 | 主题 | 内容 |
|---|---|---|
| 0 | 地基 | 名册、账号、登录、权限模型、安装向导 |
| 1 | 通信 | 通讯录、共享给某个成员、CardDAV 服务端 |
| 2 | 时间 | 日历本、重复日程、提醒、CalDAV 服务端 |
| 3 | 归一 | 观影与旅行迁入统一事件模型 |
| 4 | 任务 | 任务管理，期限自动映射成日历事件 |
| 5 | 回看 | 统计、年度家书、时间轴 |
当前进度：阶段 0 起步，仓库里只有图标与脚手架。
技术选型
- PHP 7.4+（无框架、无 Composer，上传到站点目录即可运行）
- MySQL 5.7+ / 8.0（
utf8mb4） - 前端为原生 HTML / CSS / JavaScript，无构建步骤
⚠️ 注意 CalDAV / CardDAV 是双向协议，和单纯的 .ics 文件导出不是一个量级的东西。
部署
- 把代码放到站点根目录；
- 复制
config.example.php为config.php，填写数据库与app_key； - 访问站点根，按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。
config.php 不入库（已在 .gitignore 中忽略），其中包含数据库口令与加密密钥。
⚠️ app_key 一旦开始记录数据就不能再改（换掉即解不开已有数据），
并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。
隐私
身份证号、手机号属于敏感个人信息，一律加密存储。 （就家庭自用而言，身份证号其实没有多少必须存的场景，启用前请三思。）
图标
见 assets/icons/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。