ericwyuan
|
f1319a6171
|
feat: 补齐 Garmin 未同步的数据，并各自配上界面
审计 57 个接口后，把账号里真有数据却从未入库的部分补上。全部走同步模块，
界面只读本地库。
新增数据
- 体重与身体成分（体脂率/肌肉量/体水分/骨量/内脏脂肪/代谢年龄）
- 血压（接口通，账号暂无记录）
- 跑步成绩预测（5 公里 / 10 公里 / 半马 / 全马）
- 爬坡分、饮水量、出汗量 → health_data 新增七列
- 全天曲线：心率 / 压力 / 身体电量 / 呼吸 / 血氧
- 挑战赛（徽章挑战与好友挑战，与一次性的徽章不同，有周期和进度）
- 已配对设备
新增界面
- /body/ 身体成分：体重大数字 + BMI 分级 + 体脂肌肉曲线 + 血压表格
- /race/ 成绩预测：四个距离的预测成绩与配速，以及预测随时间的变化
- /challenges/ 挑战赛：按类型筛选，有目标的显示进度条
- /devices/ 已配对设备
- 每日页新增「全天曲线」，这是存日内采样的主要目的
- 健康页新增「身体成分」分组与「更多」入口，运动页加挑战赛与成绩预测入口
同步开销
- 日内曲线每天五个请求，14 天以内的同步顺带拉，更长的历史交给后台
「补齐详细数据」，否则一年的同步会多出约 1800 个请求
- 原来的「补齐运动详情」扩展为统一的补齐任务，分阶段上报进度
日内采样抽稀到每天 240 点：手机图表分辨不出更多，只会把行撑大。
全量 446 项测试通过。
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-24 04:16:33 +08:00 |
|
ericwyuan
|
fa865ca8a6
|
fix: 实机验证发现的七个缺陷
部署与时区
- client/.env.production 写死 REACT_APP_API_URL=/api。之前没有这个文件，
构建靠命令行临时传参，一旦忘了就把开发默认值 localhost:5000 打进包里，
部署后整站 Network Error。
- 新增 lib/day.ts，所有日期改用本地日历日。原先用 toISOString() 取的是 UTC 日期，
在 UTC+8 每天前 8 小时都会少查一天——当天的数据佳明已经有了，应用却够不到。
界面
- 覆盖 Framework7 9 给 .navbar .left/.right 加的 frosted pill，
就是各页右上角和返回键旁边那个半透明椭圆。
- .metric-tab 显式 width:auto。F7 把每个 button 渲染成整宽块元素，
运动详情的四个 Tab 因此竖着堆成四行。
- 主要收益为 UNKNOWN 时不显示该区块，那是「没有结论」的哨兵值。
正确性
- 心率区间百分比改用整次运动时长作分母。原先除以「落在区间内的总时长」，
把低于区间 1 的时间挤掉了：44:06 的登山里区间 1 占 23:03，
手表显示 52%，我算成了 90%。现在对上了。
性能
- 按进程缓存已认证的 Garmin 会话（15 分钟 TTL）。实测 _connect 单次 11 秒，
而七个数据接口加起来才 4 秒——瓶颈全在每次重新认证。
冷启 16s → 热 7s → 命中缓存 0.8s，不再撞客户端超时。
- get_activity_details 的 maxchart 由 2000 降到 500，反正写入时抽稀到 300。
- 重新绑定账号时丢弃缓存会话。
删除前端重做前遗留的 5 个无引用页面文件。
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-24 01:16:44 +08:00 |
|
ericwyuan
|
b0e0799a97
|
feat(ui): 卡片可点进详情 + 身体年龄 + 运动详情 + 指标选择弹窗
需求 3.5 / 3.6 / 4.4 / 4.5 / 4.8 / 4.9
- 删掉导航栏右上角那两个 Link，就是它们渲染成半透明椭圆的。
睡眠入口改为点健康页的睡眠卡片，每日入口移进趋势页内容里。
- 新增 lib/metrics.ts 作为唯一的指标注册表。label/unit/取值函数原本在
今日、健康、趋势各写一份，改一处要改三处，也就有三次写不一致的机会。
- /metric/:id/ 指标详情：大数值 + 参考区间 + 7/30/90/365 趋势图 +
平均最高最低达标天数 + 这个指标是什么 + 评分依据（取自后端，不在前端另写一份）
- /activity/:id/ 运动详情：概览/数据/分段/图表，数据分组照搬手表的排法，
心率区间用单色顺序色阶（区间是有序刻度，不是分类，不能用分类色）
- /body-age/ 身体年龄：逐步展示 VO₂max 基准与各项修正，以及每步的出处
- 趋势页 15 个 chip 占满一屏且像张表单，改成弹窗选择，页面上只留一行摘要
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-24 00:39:33 +08:00 |
|
ericwyuan
|
fd9b610810
|
[阶段10.1] Tab 改为 今日/健康/趋势/运动/设置
按指定结构调整导航：每日归入趋势、睡眠归入健康、同步归入设置，
它们是各自 Tab 的详情视图而非独立目的地。新增「运动」Tab。
运动页（新）:
- 近 30 天运动时长/距离/消耗，以及今日强度分钟
- 项目分布：按累计时长排序，横条表示占比。只用一个色相 —— 每个项目
一种颜色会让人以为分类另有含义
- 强度分钟趋势图，附 WHO 每周 150 分钟的参考
- 记录 / 个人纪录 / 奖励三个分页，运动记录 174 条
fix(nav): 五个 Tab 全部加载了同一个页面
- browserHistory 开在每个 View 上，导致它们都去读浏览器地址栏（当时是
"/"）而不是各自的 url，五个 Tab 渲染出五份「今日」
- 浏览器历史只绑定主 View，其余 Tab 用自己的 url 独立加载
fix(nav): 导航栏右侧对所有页面塞同一组图标
- 睡眠/同步/设置三个图标出现在每个页面上，其中两个在多数页面无意义。
改为按页面声明：趋势 → 每日，健康 → 睡眠，设置 → 同步
fix(viz): 图表标题在窄栏里竖排
- 标题与「看数据」按钮争抢宽度，短标题被压成竖排字符。
标题允许收缩省略，按钮不收缩
fix: 未映射的运动类型直接暴露 snake_case
- 补充登山/划船/椭圆机等映射；仍未覆盖的转为空格分词并首字母大写，
而不是把 Garmin 的原始 key 摆给用户看
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-23 23:52:18 +08:00 |
|
ericwyuan
|
7ab150537d
|
[阶段10] 前端以 Framework7 重建，采用 iOS 原生形态
按要求废弃手写外壳，改用 Framework7 React（theme=ios）。参照 PeakWatch
的信息架构与卡片语言。
保留（这些是资产，不该重来）:
- 数据层 services/api.ts、聚合 lib/aggregate.ts、参考区间 lib/ranges.ts
- 图表组件 Chart / Ring / Sparkline / BandBar / MetricCard / MetricStrip
- 经校验的配色令牌（色盲安全 + 对比度，浅深两档）
替换:
- 路由与外壳交给 F7：五个 Tab 各自独立导航栈，推入详情页不影响其他 Tab
- 页面转场、橡皮筋滚动、大标题折叠、半透明栏 —— 这些正是换框架的理由，
手写做不像
- 底部标签栏改用 F7 Toolbar，触控目标与安全区由框架处理
配色接入:
- 新增 f7theme.css 把我们的令牌映射到 F7 的 CSS 变量，让它的导航栏/
列表/面板与我们的图表同属一套设计，而不是两种视觉打架
- F7 的深色靠 .dark 类，我们的靠 data-theme，两者在 App 里同步切换
fix: 图标显示为原始名称（squ/hea/cale…）
- iconIos/iconMd 引用的是 framework7-icons 字体，没装就只会渲染出名字
其他:
- tsconfig moduleResolution 改为 bundler —— F7 用 exports 映射，
node 解析方式找不到它的类型
- 登录页不套 Tab 外壳，未登录时不该出现导航
桌面与手机都要好看：内容在宽屏收进 1100px 居中列并加密卡片列数，
窄屏走底部标签栏；两档都已实机核对。
bundle 190KB -> 399KB，是换取原生手感的代价。
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-23 23:38:21 +08:00 |
|