52946e9c35123b3a470bc174419df0700b330034
5
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 laoyang
|
ebaed21920 |
v57：令牌升级为「设备会话」（24h 滑动续期 / 每账号 10 台 / 网页端远程退出）
用户 2026-10-17 定的模型：
· 一次登录 = 一台设备一条会话；同一台设备重登，旧令牌立即作废
· 24 小时滑动续期（一直联网就不用每天输密码）；离线超 24h 只锁界面、不删数据
· 网页端「个人设置 → 设备管理」能看见都有谁在登录，并能把丢了的那台踢掉
· 每账号最多 10 台，超了让用户先踢旧的
服务端配套：
· api_tokens 加 device_id / device_name / platform / app_version / last_ip
+ idx_api_device；历史令牌回填 legacy-<id>（不回填 = 踢不掉的幽灵会话）
· ApiToken：issueDevice / listDevices / revokeDevice / revokeOthers / revokeCurrent
+ 滑动续期（剩余不足 4h 才写库）；verify 同时返回数字键与关联键（三处调用方在用）
· 新增 /api/v1/logout、/api/v1/devices；ping 报 features.device_session
· 登录不再读 days（0 = 永不过期会绕过 24h 这条线）；超限回 409 且**不动任何一行**
· 老客户端兜底固定槽位 auto-unknown（随机设备号会撞满 10 台把账号锁死）
· Schema 34 → 35
顺带：首页近期任务/往年的今天（Home::memories）、名册派生字段口径统一。
验证：设备会话探针 56/0、设备管理渲染 22/0、登录全链路 30/0、反向验证 12/0、
e2e 1519/0、静态断言本地空跑 357/0、线上 /api/v1/{ping,devices,logout} 复核通过。
|
||
|
laoyang
|
09e30d27d4 |
v24 第 24 批：选人冲掉已有成员 / 首页改版 / 个人导航 / 微信读书 / 财务图
用户 6 条原话（要点）：
①「选择名册里面人员的那个弹出框有个问题，就是会把页面里面已有的人员给冲掉。
比方说电影里面的观影人或者是旅程里面的参与人…这是一个 bug 应该通篇检查。」
并按「输入拼音 → 空格选中第一个 → 输入框清空回焦 → 再输下一个 → 回车=确定」重做交互。
② 首页简要信息改成：问候 + 姓名 + 日期 + 星期 + 农历 + 节气/节日/纪念日/生日，
下面「今天几条日程 / 几件待办」，天气**彩色图标**放**最右侧**，温度风力，最下面地址。
③「家里的镜框这里呃全部不要了」→ 删模块卡片墙 + 未来七天；日程与任务**左右各半**、
高度固定、内部滚动且**不显滚动条**；日程**掐头去尾** + 当前时刻**红线**；
任务显示标题+状态+**所在看板名**；最下面往年的今天。
④「把个人导航项目完整搬过来，放在读书后面」；免登录展示页 `/nav/?<短语>`；
右上角给**登录**入口；展示页头像用**用户自己的头像**。
⑤ 读书加笔记 + 导入微信读书笔记（用户明确「**用微信读书 api key**」）。
⑥ 财务页第二张多线图不随类别标签筛选。
用户拍板（AskUserQuestion）：① 首页删「模块卡片墙 + 未来七天」两块；
② 微信读书用官方 API Key；③ 导航短语「自己起名 + 可一键换随机码」都做；
④ 6 条一次做完再上线。
════ 一、 🔴 第 1 条：复现出的真 bug（全站性）════
**根因**：选人清单是**打开弹框时才建 DOM**（懒建，为性能），而承载"已选"的
checkbox 就在那份清单里 → **没打开过弹框就提交**时表单里一个值都没有 →
后端把"表单里没有 attendees"理解成"用户要把人全删掉" → **静默清空**。
实测复现：库里同行人 `2,3,4` → 只改标题保存后变成 **NULL**。
修法：模板加**承运字段**（`.pp-carry` 隐藏 input，承载当前已选）；
JS 建清单时**撤掉**它（否则同一个 name 会带两份值）。
⚠️ 裸 POST（完全不带 attendees）**本来就该清空** —— 那是显式地"不选任何人"，
所以断言也必须照着"浏览器实际提交的样子"（带承运字段）来测。
**键盘流程**（用户第 1 条后半）：空格 = 选**当前可见列表里第一个还没选的**
（⚠️ 必须跳过已选中的 —— 否则会把它**取消**，与"我要选人"正好相反，本轮真机跑出来的缺陷）；
选中后清空输入框 + 光标回输入框；回车 = 确定。空格必须 `preventDefault`
（否则输入框里多一个空格字符）。
覆盖范围：4 个多选（`attendees[]` / `members[]` / `shares[]` / 修订 `members[]`）
+ 全部单选（归属人 / 负责人 / 纪念日人等）。
════ 二、 首页改版（第 2、3 条）════
自上而下只有三块：
① 信息面板：问候（早/中/晚 + 姓名）→ 日期 / 星期 / 农历 → 日子标记
（法定节假日 / 节气 / 传统节日 / 纪念日 / 生日，各一色）
→ 今日数字（今天几条日程、几件待办）｜ **最右**：彩色天气图标 + 温度 + 风力 + 地址
② 日程 / 任务 **左右各半**（各 360px 固定高、内部滚动、**不显滚动条**三套写法）
日程是**日视图形式的刻度**、**掐头去尾**（首末日程前后各 1h）、**当前时刻红线**
任务是标题 + **状态** + **看板名** + 截止
③ 往年的今天
新增 `Home::todayMarks()`（把五类来源合成一句话："今天是国庆节 · 大暑"）与
天气的 `tone` 色调档（彩色图标靠 CSS 上色，**不用 emoji** —— 避免旧系统豆腐块）。
删掉：`mod-cards` 模块卡片墙、`未来七天`。
════ 三、 个人导航（第 4 条，SimpleNav 完整搬运）════
`app/Nav.php`（4 张 `nav_*` 表 + 稀疏排序 + 短语）· `app/NavFetch.php`
（抓取与图标生成，27KB，从原项目 functions.php 机械搬运，**原文那批"线上实测"注释全部保留**）
· `nav_show.php`（**全站唯一免登录页**）· `nav_suggest.php`（联想代理，凭短语门禁）
· `templates/nav/index.php`（管理页：板块/站点/引擎/设置 + 拖拽排序）。
搬运只改两处（不改会坏）：① 独立 SQLite → 家书的 MySQL；② **所有查询加 `person_id`**
（原项目是单用户系统，不加这一维全家人会共用同一份导航）。
免登录展示页：`/nav/?<短语>`（也认 `/nav/?<短语>` 不带参数名）；
短语用户自起名（4~32 位字母数字`_-`，全局唯一、保留词拦截）或一键换随机码；
右上角**登录**入口（进家书登录页）；头像用**他自己**的头像；空态给一句话。
路由三处同步（`router.php` / `.htaccess` / 部署脚本 5c **独立标记块**）——
这是本仓库第三次复用这条规律：**每加一个"站根上的独立入口"，就必须是自己的标记块**。
⚠️ 线上重写规则**顺序有语义**：`^nav/suggest\.php$` 必须在 `^nav/?$` 之前
（后者会把前者吞掉）。
════ 四、 微信读书（第 5 条）════
用户提示「用微信读书 api key」是对的 —— **我的知识过时了**：2026 年官方已开放
（网关 `POST https://i.weread.qq.com/api/agent/gateway`、`Bearer wrk-` 认证、
接口 `/user/notebooks`（游标 lastSort 分页）、`/book/bookmarklist`、
`/review/list/mine`、`/book/chapterinfo`）。
`app/WeRead.php`：Key 用 `Crypto::encrypt` **加密落库**、界面只回显掩码
（官方原话：这串 Key 等价于账号凭据）；导入走「拉预览 → 勾选 → 导入」，
落 `book_notes`（去重 = kind + 内容 + 位置）。
⚠️ 业务参数必须**平铺在顶层**，不能包进 `params`（官方文档专门列了这个反例）。
另一条路「手动粘贴」保留（`books/notes_import`，早已有）。
════ 五、 财务第二张图（第 6 条，**上一批我引入的 bug**）════
`g.hidden = true` 对 **SVG 的 `<g>` 无效**（它没有 `hidden` 属性）→ 线条一条都没被藏；
**而我的探针也读同一个属性** → 两边一起绿（假绿）。
改为 `style.display`（恢复用 `''` 而不是 `'block'`）；探针改读
`getComputedStyle(el).display !== 'none'`（落在**渲染结果**上）。
⚠️ "探针与实现读同一个属性"是**互相掩盖**的典型，比单纯写错断言更危险。
════ 六、 验证 ════
e2e **1218/0**（本批新增 102 条）· 真机探针 **19/0**（选人）+ **24/0**（首页/导航）
+ **34/0**（导航模块）· 桌面几何 0 失败 · 移动端几何 674/0 · 老库升级 149/0
· 部署静态断言空跑 **310/0** · **反向验证 13/13**（逐条改回旧行为，点名断言都变红）
· 线上验收：9 个新文件全在、4 张 nav 表建好（schema_version=24）、
三条重写规则顺序正确、免登录页 / 空短语 / 错短语 / 联想门禁 全部响应正确。
════ 七、 本批的"夹具与断言"教训（都写进注释了）════
· `calendar_events.all_day` **默认值是 1** → 插夹具不写它就成了全天事件 →
`time` 被抹成 `''` → "刻度掐头去尾"看着像没做（白查三轮）。
· 日历本要挑 `kind='custom'`（我原以为"普通本没有 kind"，实际**普通本就是 custom**）。
· 量"同高/同排"要拿**内容区**（去 padding）比，不能拿 border-box（`.topline` 有 14px 上内边距）。
· 判据不能把**边界上的正确行为**当 bug（22 点有日程时末刻度**就是** 23:00）。
· 「HTML 写了、CSS 没写」e2e 永远查不出来 —— 导航展示页的登录按钮就落到了左边
（实测按钮右 116px / 整行右 1210px），只有真机量几何才抓得到。
· 反向验证里 e2e 会**重铺副本**把注入覆盖掉 → 给 e2e 加了 `FB_PATCH_FILE` 钩子
（重铺完自动打补丁），13 例里 8 例"没牙齿"其实是这个假象。
════ 八、 新增/改动文件 ════
新增：`app/Nav.php` · `app/NavFetch.php` · `app/WeRead.php` · `nav_show.php` ·
`nav_suggest.php` · `templates/nav/index.php` · `templates/books/weread.php` ·
`assets/css/nav-show.css` · `assets/js/nav-show.js`
改动：`app/Schema.php`（v24 + 4 张 nav 表）· `app/Module.php`（+nav）· `app/Home.php` ·
`index.php` · `templates/_person_picker.php` · `assets/js/person_picker.js` ·
`templates/home.php` · `templates/ledger/index.php` · `templates/books/_settings_menu.php` ·
`assets/css/app.css` · `router.php` · `.htaccess`
|
||
|
laoyang
|
7138314dc7 |
v24 第 15 批：活动 / 旅程两级语义（术语 · 派生时间城市 · 表单三项 · 题图可点）
用户原话四条，逐条落地：
1. 「旅程模块，按钮是记一次活动，而不是记一趟旅程。旅程是活动里面的概念。」
→ 顶层一律改称**活动**：按钮「记一次活动」、页标题「活动」、`N 次` / `N 段旅程`；
活动详情三组改叫「计划的旅程 / 走过的旅程 / 没成行的」；
节点表单「这段旅程叫什么」「阶段」；flash 文案 17 处同步。
（导航条仍叫「旅程」——用户就是这么称呼这个模块，列表页加副标题说清两级关系。）
2. 「活动不需要开始和结束时间，是根据活动中的旅程，最早的旅程开始时间，和最晚的
旅程结束时间，计算出来的。目的地也不需要…去的城市，也是根据旅程，得到的。」
→ 活动**不再存**这三样，全部**读时算出来**：
· Trip::derived() 最早开始 / 最晚结束 / 城市去重
· Trip::cities() 按最早出现时间排（先后顺序本身是信息，不是字母序）
· Trip::attachDerived() 列表页批量补（避免 N+1）
· Trip::activitySpan() 没有旅程时说「还没有旅程」，不用「日期待补」
create/update 不再写 events 的起止与地点（老值保留不动，页面不读）。
列表排序/搜索、首页「最近去了」改走子查询。
3. 「题图那里，没有办法上传图片，点击哪里都没反应。」——**真 bug**
「点图 = 开文件框」那句 JS 只写在 people/form.php 的内页脚本里（头像专用）；
第 14 批加的旅程题图与图书封面照抄了同一套 DOM 却没有对应的 JS，
于是图块有 cursor:pointer 与 hover 高亮（看着能点），点下去毫无反应。
→ 做成声明式通用绑定：图上写 data-pick-input="#fileInputId"，
app.js 统一接管（一个页面多个也各绑各的），并删掉旧的那份专用实现。
三处（头像 / 题图 / 图书封面）全挂上。
4. 「添加活动的页面，顺序是这样的：添加标题，上传并裁剪题图，然后一段简介，就可以了。」
→ 主区就这三项，顺序照原话；时间/城市不做输入项（只留一句说明它们从哪来，
不说清用户会满页找"怎么没地方填时间"）。
备注 / 公开 / 同行的人收进「更多设置」折叠区——功能一个没丢。
顺带修掉两处会炸的实现问题：
· ORDER BY 引用聚合别名（first_at）在 MariaDB/MySQL 报 1247，且只在运行时炸、
php -l 看不出 → 改成 ORDER BY MIN(starts_at)，否则整个旅程模块 Fatal。
· e2e 里"详情页显示了派生时间"原本写成整页查找，下面每段旅程自己也渲染日期，
于是把派生值塞成 null 也照样绿（借光假绿）→ 判据收进页头那一段。
验证：e2e 845/0（+15 条本批断言）· 升级 134/0 · 桌面几何 428/0 · 移动几何 688/0 ·
交互 92/0 · 题图真机点击 4/0 · 读书窄屏 15/0 · 家谱 34/0 + 10/0 + 反向 3/3 ·
观影按钮 60/0 + 反向 3/3 · 本批反向验证 4/4（题图绑定抽掉→红、派生值不挂→红、
城市退回读 location→红、时间字段加回表单→红）· 部署静态断言新增两组（含"活动不许
再写起止时间/目的地"与"ORDER BY 不许引用聚合别名"的反退化防线）。
部署后服务器自检 19/19，五个关键文件 md5 与线上逐一核对一致。
|
||
|
laoyang
|
e0562b8627 |
v24 第 5 轮：十条清单（天气填城市 / 输入即筛选 / 看板列＝看板 / 账本盘点折线图 / 纪念日分类）
用户 2026-10-03 的十条，逐条落点： 1. 天气改为**个人设置里填城市**（每人一份）：新增 app/Geo.php，内置 197 个 地级市坐标（离线、逐条核对，生成脚本 _tooling/_fb_geo_gen.py）。填坐标仍 作为内置表没有时的出口；老的家庭级坐标保留为兜底，升级当天天气不会凭空消失。 2. 所有"找个人"的地方**输入即筛选**：新增 assets/js/filter.js（纯前端显隐， 不发请求、回车不刷新）+ app/PersonQuery.php 把服务端判据收敛成一份 （名册 / 挑人 / 高级搜索共用，避免三处实现漂移）。 3. 名册列表：有昵称就不重复显示本名、行变矮、补齐手机/阴历阳历生日(带年份)/ 邮箱/工作单位；「清除」与「搜索」同款同尺寸。 4/5. 日程：撤掉左侧日历本栏改满宽，功能（显隐/颜色/导入/默认视图）全收进 右侧 ☰；**色块高度改为按起止时长**（旧实现一律 30 分钟，三小时的会跟 十五分钟的同高）；点日历空白处即建日程，开始时间＝点的那一格。 6/10. 资源：搜索提到最上；按"最近改动/最新新增"排序，默认只显示最新 10 条并 给「显示全部」出口。 7. 任务：看板的**列＝用户自定义的看板**（不再是写死的待办/进行中）， 拖动/左右键＝换看板（改 board_id，不动 status）。 8. 财务：概览在上账目在下、记一笔改右侧按钮、账本设置（共享/改名/新建/删除） 收进 ☰、默认账本名「xxx的账本」、"挂在谁名下"默认自己且用标准选人框； **新增盘点**（新增 ledger_entry_snapshots 只增不改的历史表，旧值不被清空） + 上面画金额变化折线图（app/chart.php 服务端画 SVG，零依赖）。 9. 纪念日：手动添加的与名册生日派生的**分两块**、手动的在上；右侧设置可增删 分类（家庭级，删分类不强改已用的历史）。 本轮另外修掉/加固的四类问题（都由新增的静态或运行时守卫兜住）： - index.php 少写 2 个 use 导入（Pinyin / UserSetting）→ 名册与个人设置 返回 200 但正文是 Fatal；顺带修了一处早已存在的 Attachment 未导入。 → 新增 _fb_import_check.py（1f 段）。 - 一次不精确替换弄丢了 app/Calendar.php 开头的 `<?php`，整份源码被当 HTML 吐给浏览器，而 `php -l` 报"无语法错误"（纯文本输出确实合法）。 → 新增 _fb_php_open_check.py（1e 段）。 - 模板片段 unset 了宿主模板的变量（账本片段 unset($canWrite)）→ 正文里一片 Undefined variable 而 HTTP 仍 200。同 _datetime.php 早年 $t 的坑。 → 新增 _fb_fragment_scope_check.py（1g 段）+ _fb_batch_e.py 的 26 页无告警巡检。 - 窄屏下页头动作区不换行 → 周视图横向溢出且按钮被挤成三种高度（用户提过三次 "按钮要同高"）→ .page-head .actions 加 flex-wrap。 验证战绩（全绿）： e2e 773/0 · 第 5 轮专项 91/0 · 结构升级 126/0 · 几何 428/0 · 移动端 684/0 · 交互 97/0 · 家谱 26/0 · 按钮 60/0；三轮反向验证各 3/3 抓到，还原后复绿。 线上：schema v14、指纹一致（9df6c9fccc6796db）、snapshots 表已建、197 城、 8 个关键文件 md5 与本地逐字节一致、app/ 403 无源码泄漏、错误日志无新增。 |
||
|
laoyang
|
02f5d072a4 |
家谱卡片重做 / 首页控制台 / 名册改列表 / 重复日程与旅程公开
用户 2026-10-03 提的四条：
① 家谱卡片重做
· 去掉「⇄ 姻亲」按钮，改成**每个人**卡片右下角都有「以 TA 为中心」
（点了以他重画一张家谱，涵盖原来的姻亲场景）。
· 头像外框改**长方形**（96×72，宽度贴合头像），object-fit: contain 不裁切，
姓名/称呼在头像下方。
· 修「点右下角按钮误进成员页」：卡片不再整张是 <a>，
只有姓名是链接，右下角是独立的 <button>（物理上分开，不抢点击）。
② 家谱文案与按钮清理
· 去掉副标题与下方图例说明；整块去掉「看全部 / 回到我 / 回到我的家谱」
（顺带消掉"出现两个回到我的家谱"）。镜头由库自动 fit，拖拽/滚轮即可。
③ 首页控制台
· 标题下显示个人 slogan；去掉右侧三个统计；「我的资料/我的家谱」换成图标按钮；
去掉与导航条重复的「名册」按钮。
· 去掉「接下来的日子」（生日归到"未来七天"里，不再重复）。
· 新增统计信息块：按时段随机问候 + 今日天气（Open-Meteo，免 key，可留空不显示）
+ 近七天日程/待办/逾期数。
· 新增各模块小结卡（任务/日程/纪念日/观影/旅程/财务/名册/家谱/资源）。
· 个人设置新增「首页上的模块」：可勾选与拖动排序（每人一份，存 user_settings）。
· 保留「往年的今天」。
④ 名册改列表
· 卡片网格 → **竖向列表**：左头像、中间姓名+与我的关系+手机号+生日。
· 修拖动「只能往后不能往前」：落点改为显式记录"插到谁前面/后面"，
并排除被拖元素自身。
· 去掉那句拖动提示（能力保留）。
· 搜索新增**姓名首字母**检索（y / yy / yyq 都命中「杨永全」）：
新 app/Pinyin.php，intl 优先 + 内置常用字表兜底（本地无 intl 也能测）；
纯字母/数字查询词不走 SQL LIKE（拼音与加密手机号在库里都比不了）。
附带上两轮的收尾：
· 菜单点外部自动关闭（全局事件委托，覆盖所有 details.menu）。
· 旅程 is_public：列表与日历只显示公开的；详情页不拦（不丢数据）。
· 重复日程：新 app/Repeat.php（RRULE 解析/生成/展开，含"工作日"），
新表 calendar_event_skips（RFC 的 EXDATE）；日历按规则展开；
编辑支持三档「全部 / 这一次及以后 / 仅此一次」。
· 结束时间可添加/去掉，并随开始时间联动。
验证：端到端 772 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 26、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
|