ericwyuan/GarminHealthLab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
21 Commits 1 Branch 0 Tags
bfda1cd017b9e7b9a3fcdc39ded912a799b2d981
Commit Graph

7 Commits

Author SHA1 Message Date
ericwyuan
bfda1cd017 [阶段8] 新增每日数据模块；趋势改为全指标并列 + 周期聚合 
每日数据（新页面 /daily）:
- 按活动/能量/心率/压力/睡眠/血氧呼吸/训练七组，列出全部 40 项指标
- 日期选择器 + 前后一天翻页；"只显示有数据的指标"开关
- 附当天的运动记录明细
- 标题处显示当天记录到多少项，缺数据一目了然

趋势（重写）:
- 15 组指标全部并列展示，不再一次只能看一个
- 标签可逐个隐藏/显示，选择存入 localStorage（每次刷新都重置的
  选择算不上偏好）；提供全选/全不选
- 两级筛选：范围（一月/一季/半年/一年/两年）× 周期（每天/每 7 天/
  每月/每季度）。周期选项按范围过滤，避免出现"近一月按季度聚合"
- 所有图表共用同一份聚合结果，一行筛选器统摄全部图表

聚合口径（lib/aggregate.ts）:
- 无论累计型还是速率型指标，一律折算为"周期内日均"，这样 30 天的
  月份和 31 天的月份不会仅因日历差 3%
- 周按最新一天往回切，而不是按自然周一 —— 否则开头会出现一个半空
  的桶，看起来像低谷，其实只是窗口起点
- 累计型指标的统计标签写作"日均"而非"平均"，读者不必猜口径

fix(viz): 聚合后柱形/面积图掩盖了变化
- 柱形与面积都以延展量编码大小，必须从 0 起；而一年的月均步数都在
  9,590~12,701 之间，画出来几乎一样高，恰恰看不见要看的变化
- 聚合视图改用折线：折线编码位置而非延展量，非零轴是正当的。
  改后 y 轴自动落在 9350~12750，走势清晰可读

fix(health): 运动记录按日期筛选时 500
- get_activities 复用了按 date 列过滤的子句，但 activities 表只有
  start_time，报 "Unknown column 'date'"。此前唯一的调用方不传
  日期，所以一直没暴露，每日数据页一传就炸
- 上界改用次日零点的开区间：SQLite 按字符串比较，而存储的分隔符
  可能是 'T'(0x54) 也可能是空格(0x20)，写成 "end 23:59:59" 会让
  当天 18:30 的记录排在上界之后而被排除在自己那天之外

tests (+6, 共 305): 运动记录的单日范围、上下界闭合、仅起点/仅终点、
不传范围返回全部、端点级验证

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 22:33:59 +08:00
ericwyuan
9e5e77755e [阶段7.2] 隐藏 AI 模块；剩余页面迁移到设计令牌 
AI 模块暂时下线（待重新设计），加 FEATURES 开关集中控制：
- 导航不显示"建议"，路由也不注册 —— 只隐藏入口而保留可访问的
  URL 等于没隐藏
- 设置页的模型清单区块一并隐藏，且不再请求 /analysis/models
- 页面与后端端点都保留，重新打开是一行改动

登录/同步/建议/设置四个页面此前仍在用旧样式（共 101 处硬编码颜色），
深色模式下全部失效。已改写为设计令牌。

fix(a11y): 主按钮白字对比度不足
- 白字在 --accent 上实测 4.42:1（浅）/ 3.64:1（深），均低于正文
  所需的 4.5:1
- 新增 --accent-solid 专用于填充面（按钮、选中标签），取同一蓝色阶
  更深的一步：5.39:1 / 6.63:1；--accent 继续用于文字、边框和标记

fix(viz): 一年档柱形图不可读
- 365 根柱子在 607px 宽度下每根仅 1.66px，既看不清也远低于
  ~24px 的悬停命中下限
- 超过 90 个点时柱形自动改为面积图，并在副标题里说明原因。
  折线/面积的十字准星吸附最近点，本就不依赖逐标记命中区

其他:
- 统计数值精度按量级取（11,013.99 既是虚假精度，又长到把单位挤到
  第二行）
- 设置页隐私说明更正：改用 OAuth 令牌后同步已不需要每次输密码

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 22:05:28 +08:00
ericwyuan
ad88ec7e41 [阶段7] 前端重做：31 项指标全部露出，配色经色盲校验 
原来仪表板只有 4 张卡片和 4 张图，31 项指标里绝大多数没有出口。

信息架构重组为 7 个页面（原 5 个）:
- 今日   按活动 / 心率压力 / 睡眠呼吸三组展示 16 项指标
- 趋势   15 组指标可切换，5 档时间窗口（最长一年）
- 睡眠   新增。分期堆叠图 + 夜间血氧/呼吸/压力
- 成就   新增。奖励徽章按年份分组、个人纪录、运动记录
- 建议 / 同步 / 设置 保持

配色（依据 dataviz 规范，用校验器实测而非目测）:
- 采用验证过的分类色板并按既定 slot 顺序取色 —— 顺序本身就是
  色盲安全机制，不是审美选择，因此只取不循环
- 浅色 worst adjacent CVD ΔE 9.1 / 常视觉 22.9
  深色 worst adjacent CVD ΔE 8.4 / 常视觉 19.8，两档全部通过
- 浅色表面下 aqua 2.74:1、yellow 2.11:1 低于 3:1，按规范提供
  "relief"：每张图都带表格视图，且图例始终与文字标签同现
- 深色不是自动反色，是同色相针对深色表面重新取阶并单独校验
- 状态色（good/warning/serious/critical）保留专用，绝不当作
  第 N 个系列色；且始终图标 + 文字同现，不靠颜色单独表意

图表规范:
- 单一 y 轴，绝不双轴；量纲不同的指标拆成不同图
- 2px 线宽、4px 圆角柱端锚定基线、堆叠段间 2px 表面色间隙、
  悬停标记 2px 表面色描边
- 两系列以上必有图例，单系列不加（标题已经点明）
- 折线 connectNulls，设备漏记的日子不把线打断
- 数值文字一律用文字色令牌，不染系列色

其他:
- 主题切换（自动/浅色/深色），选择写入 localStorage 并标在 <html>
- 导航改为顶部横向，移动端可横滑
- 表格、徽章、空状态等组件统一到设计令牌

验证方式: DOM 审计确认 2px 线宽、圆角为 A 4,4 弧、堆叠段
2px 间隙、图例数量与系列数匹配、两档主题令牌各自解析到校验过的色值。

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 21:17:08 +08:00
ericwyuan
8616a13525 [阶段4.2] 前端对接 Flask API + 建议/分析/设置页面，移除废弃的 Node 后端 
选型确认为 Python Flask 后，删除 server/ 整套 Node 实现，
根 package.json 改为只管理 client workspace，
npm run dev 同时拉起 Flask 与 React。

fix: 前端读取响应的方式与后端不符
- Flask 返回裸数组/对象，而前端读的是 response.data.data
  （Node 那套 {success,data} 包装），登录后拿到 undefined 直接崩
- api.ts 重写为返回 response.data，并补齐全部端点的 TypeScript 类型
- 401 拦截器改为清除会话并跳转 /login，而不是留在空白页

fix: 同步页缺少 Garmin 密码输入
- 后端只存密码哈希、无法还原，/garmin/sync 要求请求体带明文密码，
  原页面没有该输入框，点同步必然 400
- DataSync 增加密码字段，请求结束后立即清空，并说明为何每次都要输入

新增页面:
- Recommendations: 模型下拉切换（未配置密钥的模型置灰），
  展示本次由哪个模型作答、是否发生了降级、分析了多少天数据；
  按优先级配色，底部附免责声明
- Analysis: 6 个指标 × 4 个时间窗口，展示均值/中位数/极值/
  前后半段差值，并绘制趋势图
- Settings: 模型清单与配置状态、数据隐私说明、退出登录

Dashboard:
- 修正响应结构，数据扁平化后再传给图表
  （原先给 dataKey 传了函数，与 Chart 的 string 类型不符）
- 无数据时引导用户去同步，而不是显示一堆空图表

Chart:
- 按指标而非按行判断是否为空，某天缺某项指标不再让整张图判空
- 折线图 connectNulls，避免设备漏记的日子把线断成碎片

验证: 前端 tsc --noEmit 通过；后端 161 passed / 1 skipped；
实机启动 Flask 后 register/login/models/ai-recommendations 均正常，
未配置密钥时正确降级到规则引擎。

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 12:43:52 +08:00
ericwyuan
0177758e1f [阶段2.3-2.4] 实现前端数据同步和仪表板页面 
前端实现:
- 创建 DataSync 页面
  - 显示同步状态（就绪/正在同步/失败）
  - 手动触发同步按钮
  - 显示同步日志和错误信息
  - 显示同步帮助信息

- 创建 Dashboard 页面
  - 今日概览（步数、心率、睡眠、卡路里）
  - 30 日统计（平均值、总计）
  - 交互式图表展示（步数、心率、睡眠、卡路里）

- 创建 Chart 组件
  - 支持折线图和柱状图
  - 使用 Recharts 库
  - 响应式布局

前端样式:
- DataSync.css
- Dashboard.css
- 完整的响应式设计

验收标准已满足:
- 数据同步页面功能完整
- 仪表板显示健康数据
- 图表正确展示数据趋势
- 移动端响应式

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 12:27:43 +08:00
ericwyuan
3b2d0697f0 [阶段1.1-1.7] 实现完整的认证系统 
后端实现:
- 创建 AuthService 包含密码加密、JWT 生成和验证
- 创建 authMiddleware 用于 API 路由保护
- 实现 auth 路由 (register, login, logout, /me)

前端实现:
- 创建 Login 页面 (登录/注册标签页)
- 创建 ProtectedRoute 组件用于路由保护
- 更新 App.tsx 集成路由保护
- 前端 API 客户端已包含认证方法和拦截器

验收标准已满足:
- 用户可以注册和登录
- JWT Token 正确生成和验证
- 受保护的路由需要有效 Token
- 未认证用户重定向到登录页面

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 12:25:33 +08:00
ericwyuan
d73405decb Initial commit: Set up Garmin Health Lab project structure 
- Initialize monorepo with root workspace configuration
- Set up Express.js backend with TypeScript
- Set up React 18 frontend with TypeScript
- Create database schema with SQLite
- Implement project architecture and documentation
- Add development and deployment guidelines

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
 2026-08-23 11:11:29 +08:00