3459eea8f3267a2d997f99aac4c357a6f7a0d30d
端上「记一场」要与网页端同步实现(用户 2026-10-19 六条), 服务端这一半只加**移动端入口**,网页端(index.php 那条路由)一行没动。 - ApiHandler:新增 `/movies/douban` 子路由(action=suggest / action=thumb / 默认抓详情+海报落盘),逻辑与网页端 `movies/douban` 逐条对齐; 新增 `/movies/<id>/poster` 与 `/movies/<id>/photos`(multipart 上传), 字段名与端上一致(poster / photo); 新增 `normalizeFiles()` 把 `photo[]` 的多文件从"按字段竖切"转成"一行一个"; `movieData()` 认 `poster_key` 并**校验形态**(只接受 posters/xxx 形式); features 声明 movies_douban / movie_media(端上可探测老服务端)。 - Douban:新增 `apiThumbUrl()` —— 端上打不到 `index.php?r=...`, 把豆瓣图片代理换成 `/api/v1/...` 形式(拼法只此一处); 联想候选带上**过白名单后**的原始图片地址(未过白名单给空串,不下发 SSRF 跳板)。 - Movie:新增 `setPoster()`(单字段更新 —— 端上是"先建记录再传图"两段式, 用 update() 要拼一份完整草稿,漏一个字段就静默覆盖用户刚填的内容)与 `addPhotos()`(**追加**语义,与网页表单用的 savePhotos() 替换语义并存不混用)。 验证:接口 e2e 57/0(自带豆瓣 mock,离线可跑)· 反向验证 18/0 · 本地全量 e2e 1521/0 · 线上部署 + 站点自检 19 条全过 + `/api/v1/movies/douban` 401(路由通)· ping.features 已含两条新能力
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/。概念是「这本书就是家」:屋顶即一本摊开的书,
屋顶下纸做的墙上,三行横线是这个家写下的日子。
开源协议
Languages
PHP
81.6%
JavaScript
9.3%
CSS
9.1%