隐私优先的中文健康与健身数据追踪平台，提供营养、运动、饮水、睡眠、情绪和身体指标的本地预览工作台。
SparkyFitness 是一个自托管健康数据追踪项目，原始系统包含 Web、服务端和移动端。当前交付在 Web 前端增加了无需数据库和外部凭据即可运行的中文本地预览，围绕今日概览、趋势报告、饮食记录、运动计划、每日打卡、目标管理和偏好设置提供连续的操作路径。演示数据会明确标注并保存在当前浏览器中；认证、云端持久化、健康平台同步和营养数据库服务仍需在 API 模式下自行配置。
真实界面
共 7 张
Capabilities
希望研究自托管健康数据产品、搭建个人健康记录工具，或学习 React 与 Express 全栈应用的开发者和小型团队。
用于社群学习与研究健康数据追踪、自托管隐私边界和中文产品界面；真实部署、外部服务接入和后续维护由使用者按上游许可与自身需求负责。
前端与服务端均通过类型检查、ESLint 和 Prettier 校验；前端 Vite 生产构建通过。使用固定浏览器运行器验证 7 条中文路由，HTTP 全部为 200，截图尺寸为 1440×900，交互覆盖饮水记录、趋势周期、食品搜索、训练开始、每日打卡、资料编辑，控制台错误、破图、404、登录页、横向溢出和语义阻断均为 0。
本地预览使用明确标注的演示数据，数据保存在当前浏览器；不连接真实数据库、健康平台、AI 或营养服务。原始 API 模式的 OpenFoodFacts 接入需要显式设置 SPARKYFITNESS_OPENFOODFACTS_URL；商业使用或再分发前必须取得 LICENSE 要求的原作者书面许可。
部署难度
中等
最低配置
本地预览需要 Node.js 22、pnpm 和现代浏览器；Web 前端可独立启动。完整 API 模式还需要 PostgreSQL、服务端环境变量及按需配置的外部健康与营养服务。
开源许可证
自定义非商业许可证（以仓库 LICENSE 为准）
最后验证
2026-09-03
技术栈
授权说明
源码包保留上游 LICENSE 和版权声明。许可证允许个人、教育和非营利的非商业使用、修改与分发；商业使用、商业优势或产生金钱补偿的用途需要先取得原作者书面许可。本交付仅作学习研究收录，不扩大上游授权范围。
Release notes
1 个已发布版本
新增无需数据库的中文本地预览工作台，覆盖今日概览、趋势、饮食、运动、打卡、目标和偏好设置，并保留原始 API 模式入口；移除产品界面的赞助推广入口，将 OpenFoodFacts 改为显式环境配置。
部署要求：Node.js 22、pnpm 和现代浏览器；完整 API 模式另需 PostgreSQL、认证配置及按需配置的外部服务。
已知问题：本次运行证据覆盖本地预览 UI 和浏览器交互，不代表数据库、认证、健康平台同步、AI 或外部营养服务已经接入。许可证为非商业条款，超出学习研究范围需先取得原作者书面许可。
