健康助手 (Health Assistant)

一个简洁美观的血压记录与管理系统，包含 Web 端和 Android 客户端，支持数据录入、历史查看、趋势分析及多用户管理。全部使用 Google Antigravity 完成开发。

• 现代化设计：基于 Jetpack Compose 和 Material Design 3 构建，界面美观、交互流畅。
• 便捷录入：
  • 支持收缩压、舒张压、心率及备注录入。
  • 滚轮式时间选择器：采用 iOS 风格的滚轮选择，操作直观。
  • 录入完成后自动跳转至历史记录。
• 强大的历史记录：
  • 无限滚动：支持分页加载，滑动到底部自动加载更多。
  • 下拉刷新：随时获取最新数据。
  • 高级筛选：支持按用户、日期范围（快捷选择近 7 天/30 天/90 天）筛选记录。
  • 智能统计：实时显示筛选范围内的血压均值。
  • 趋势对比：每条记录显示与上次记录及均值的对比（上升/下降/持平）。
• 可视化趋势图：
  • 自定义绘制的折线图，直观展示血压变化趋势。
  • 支持与历史记录同步的筛选条件。
• 灵活配置：
  • 支持在设置页面动态修改后端 API 地址，即时生效，无需重启应用。

• 响应式布局：适配桌面及移动端浏览器。
• 核心功能：完整的数据录入、列表查看及图表分析功能。
• 极简风格：使用 React 构建，界面简洁高效。
• 统一认证：与 Android 端使用相同的授权码机制，确保数据安全。

• 高性能 API：基于 .NET 8 构建的 RESTful API。
• 数据存储：使用 SQLite 数据库，轻量且易于迁移。
• Swagger 文档：内置 Swagger UI，方便 API 调试。

为了保护数据安全，系统引入了多层安全机制：

1. 授权码机制：在 appsettings.json 中设置 AuthSettings:Code（默认为 123456，建议修改为强密码）。
2. JWT Token：登录成功后颁发 Token，有效期为 24 小时，自动刷新。
3. 速率限制：
   • 登录接口：每分钟最多 5 次尝试，防止暴力破解
   • 其他接口：每分钟最多 100 次请求，防止滥用
4. 客户端支持：
   • Android 端和 Web 端均支持 Token 自动刷新
   • Token 过期时无感刷新，提升用户体验

• Android: Kotlin, Jetpack Compose, Retrofit, Material3, Vico Charts
• Server: .NET 8, ASP.NET Core Web API, Entity Framework Core, SQLite
• Web: HTML5, CSS3, Vanilla JavaScript
• DevOps: GitHub Actions (自动构建 Android APK)

1. 确保安装了 .NET 8 SDK。
2. 进入 server-dotnet 目录：

   cd server-dotnet

3. 运行服务：

   dotnet run --project Health.Api

   服务默认监听 http://localhost:3000。

1. 下载最新发布的 APK 文件（可在 GitHub Releases 中找到）。
2. 安装并打开应用。
3. 在“设置”页面输入服务端地址（例如 http://192.168.1.100:3000）。
4. 开始使用！

1. 直接在浏览器中打开 index.html。
2. 默认连接本地服务，如需修改 API 地址，请编辑 script.js 中的 API_BASE_URL。

(此处可添加应用截图)

本项目使用 GitHub Actions 实现自动化构建和发布。发布新版本的步骤如下：

1. 修改版本号： 打开 android-app/app/build.gradle.kts，修改 versionName：

   defaultConfig {
       // ...
       versionName = "1.1.0" // 修改为你想要的版本号
   }

2. 提交代码： 提交版本号修改：

   git add .
   git commit -m "chore: bump version to 1.1.0"
   git push

3. 创建 Release Tag： 打上以 v 开头的 Tag 并推送到远程仓库：

   git tag v1.1.0
   git push origin v1.1.0

4. 自动发布：

   • GitHub Actions 会自动检测到 Tag 推送。
   • 自动构建 APK，文件名为 health-v1.1.0.apk。
   • 自动在 GitHub Releases 页面创建新版本，并附带 APK 下载链接。

MIT License