GarminHealthLab

ericwyuan/GarminHealthLab

Fork 0

Commit Graph

Author	SHA1	Message	Date
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
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	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

Author

SHA1

Message

Date

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

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

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

3 Commits