laoyang
13a5d08696
🔴 为什么现在才提交（这是「补录」，代码早已上线并验证）： v45 第三/第四批当时，同一工作区里有**并行的鸿蒙端工作流**正在改这个文件 （手机号登录换令牌、media.php 的 ?token=）。按「绝不把别人正在写的裹进 自己的提交」的纪律，那次只提交了自己的 5 个文件，本文件被**故意留下**。 此后文件静止约 25 小时、端上工作流也已收尾 ⇒ 现在补录，让仓库与线上一致 （线上 md5 = 本地 md5，deploy 是从工作树打包的，所以线上一直是这份）。 ① `POST /api/v1/login` —— 手机号 + 密码 → API 令牌 原先 App 只能「先去网页签发令牌、再手动粘贴」，能用但没法给别人用。 与网页登录有意不同：不建会话（API 无状态）；限流落**文件** （`sys_get_temp_dir()/fb_login_<sha256(ip|phone)>.json`，60s 窗口 / 5 次） 而不进 $_SESSION；失败**统一**提示（不区分「没这个人」与「密码错」， 否则接口成了手机号是否已注册的探测器）；有效期用**服务端时间**算。 成功时顺带 `Calendar::seedDefaults()`（全新安装的兜底）。 ② `GET /api/v1/roster` —— 「**我**名册里的人」（我加的 + 别人分享的） 与 `/people`（全家 801 人 = 通讯录底账）区分开：App 名册页要用这个， 否则一屏 800 人且是「别人的通讯录」。组装**照抄 Web 端 index.php 的 people 分支**（同一套类/判据）：Person::roster → Kinship::label / Nickname::display / PersonQuery::phonePlain / PersonQuery::birthdaysOf / PersonTag::mapFor / Pinyin::initials，外加标签云与标签词表。 ⚠️ 复用这些类而非另写，否则会「网页搜得到、App 搜不到」。 ③ `GET /api/v1/kin` —— 家谱（以我为中心的关系图） 用 `Kinship::familyMap($fam,$pid,$people,2,2)`，与 Web 端 kin/tree.php 同一套 ⇒ 端上与网页的亲属关系必然一致。按代数排序，拍平直接关系字段。 ④ 🔴 信息泄露修复：`stripSensitivePerson()` `Person::all()` / `Person::roster()` 都是 `SELECT p.*`，把 `phone_hash` / `phone_encrypted` / `id_card_encrypted` / `birthday_id_card` / `birthday_lunar*` 一路吐给 App。前两个是 AES 密文（离线爆破材料）， `phone_hash` 是「手机号是否属于这个家」的判定键。 ⇒ 在 **API 出口层**脱敏（列表 / 详情 / 新建 / PATCH 四个出口都套）。 ⚠️ **不能改 `Person::all()` 本身**：网页端确实在用（ContactImporter 靠 phone_hash 去重、PersonQuery 靠 phone_encrypted 按手机号搜） ⇒ 网页要、App 不要 ⇒ 差异落在出口层。 线上验证（全绿）：GET login→405 / 缺参→422 / 错密码→401「手机号或密码不对」 / 不存在的手机号→**同样的** 401 与提示 / 连续错→第 6 次起 429 / 名册 800 人 / 标签云 15 个 / 称谓正确（爸爸→父亲…）/ 手机号解密正确 / 生日阴阳历 / 首字母 ypzbb / 6 个敏感字段全去除（列表与详情都验）。
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/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。