Files
FamilyBook/app
laoyang 97e963e2ee v59 服务端:标语(个人→家庭→默认)/ 最近纪念日 / 真实头像
配合端上「界面六条」,服务端只补三样数据:

① Family::slogan(fam, pid) —— 三层优先级
   用户:「如果这个用户自己有标语,他可以写一句自己的标语;如果他有自己的标语,
   这个地方就是用户自己自定义的标语。如果他没有标语,就用我们给他的这个标语。」
   优先级:persons.slogan → families.motto → Family::DEFAULT_SLOGAN。
   DEFAULT_SLOGAN = '一家人用岁月写成的一本书'(用户明确指定,别再改)。
   与网页端 templates/home.php 的 heroSlogan 同一套规则,两边永远一致。
   /login 与 /me 都返回 slogan —— 每次启动都会打 /me,所以网页端改了 slogan
   手机下次启动就跟上,不必为此另加接口。

② /home 新增 recent_days —— 首页「最近纪念日」
   用户:「未来最近的三个纪念日,包括每个人的生日,以及手动填写的各个纪念日。」
   = Anniversary::upcoming(fam, pid, 370) 取前 3。
   · 为什么是 370 天而不是网页端概述卡那样的 30 天:只取 30 天时,
     一个"刚过完生日"的家庭会**一个都取不到**,模块直接空着 ——
     而用户要的是一个永远的倒计时。取满一年保证"接下来的三个"一定有。
   · 数据源 all() = 派生生日 + 自建纪念日(正好覆盖用户说的两样,
     不必再去 Birthday:: 那套单独取一遍,否则迟早口径不一)。
   · 每条带 days(倒计天数)、source(custom / birthday_solar / birthday_lunar),
     顺序由服务端排好(最近的在前),端上不再排一遍。

③ 真实头像
   用户:「右上角的头像应该是真实的。」
   · /home 新增 me_avatar(当前登录者的 avatar_url());
   · /login 的 person 增加 avatar_url。
   avatar_url() 负责按线上存储驱动决定走 /uploads 还是 OSS 直链 ——
   端上不自己拼路径(拼错了就是永远破图)。

验证:_fb_home_api.py 60/0(新增 16 条:recent_days 真数据/天数/排序/≤3 条、
me_avatar、slogan 三层优先级实测 —— 给 persons#1 写一句个人 slogan,
必须优先返回他那句);php -l 通过;部署脚本增「第59批形态」9 条。
真机实测:抽屉显示「修身,齐家」= 杨永全自己的 slogan(个人优先生效)。
2026-10-18 20:14:50 +08:00
..