220 lines
6.3 KiB
Markdown
220 lines
6.3 KiB
Markdown
|
# 更新日志
|
|||
|
|
|
|||
|
|
本文档记录了身体平衡评估系统的所有重要更改。
|
|||
|
|
|
|||
|
|
格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
|
|||
|
|
并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
|||
|
|
|
|||
|
|
## [未发布]
|
|||
|
|
|
|||
|
|
### 计划新增
|
|||
|
|
- [ ] 多语言支持（英文、日文）
|
|||
|
|
- [ ] 云端数据同步功能
|
|||
|
|
- [ ] 移动端应用支持
|
|||
|
|
- [ ] AI辅助诊断建议
|
|||
|
|
- [ ] 3D姿态可视化
|
|||
|
|
- [ ] 报告模板自定义
|
|||
|
|
- [ ] 批量数据分析
|
|||
|
|
- [ ] 设备校准向导
|
|||
|
|
|
|||
|
|
### 计划改进
|
|||
|
|
- [ ] 优化实时数据处理性能
|
|||
|
|
- [ ] 增强数据可视化效果
|
|||
|
|
- [ ] 改进用户界面交互体验
|
|||
|
|
- [ ] 扩展设备兼容性
|
|||
|
|
|
|||
|
|
## [1.0.0] - 2024-01-15
|
|||
|
|
|
|||
|
|
### 新增
|
|||
|
|
- ✅ 完整的身体平衡评估系统架构
|
|||
|
|
- ✅ 基于Vue 3 + Electron的现代化前端界面
|
|||
|
|
- ✅ 基于Flask的RESTful API后端服务
|
|||
|
|
- ✅ 多传感器数据融合（摄像头、IMU、压力传感器）
|
|||
|
|
- ✅ 实时姿态检测和平衡分析
|
|||
|
|
- ✅ 患者信息管理系统
|
|||
|
|
- ✅ 检测会话管理和历史记录
|
|||
|
|
- ✅ 数据分析和可视化图表
|
|||
|
|
- ✅ PDF报告生成和导出功能
|
|||
|
|
- ✅ 系统设置和设备配置
|
|||
|
|
- ✅ 完整的日志记录系统
|
|||
|
|
- ✅ 数据备份和恢复功能
|
|||
|
|
|
|||
|
|
### 技术特性
|
|||
|
|
- ✅ 基于MediaPipe的实时姿态检测
|
|||
|
|
- ✅ WebSocket实时数据传输
|
|||
|
|
- ✅ SQLite数据库存储
|
|||
|
|
- ✅ 模块化架构设计
|
|||
|
|
- ✅ 跨平台支持（Windows、macOS、Linux）
|
|||
|
|
- ✅ 响应式UI设计
|
|||
|
|
- ✅ 国际化支持框架
|
|||
|
|
|
|||
|
|
### 核心功能模块
|
|||
|
|
|
|||
|
|
#### 前端界面
|
|||
|
|
- ✅ 现代化的用户界面设计
|
|||
|
|
- ✅ 实时数据可视化
|
|||
|
|
- ✅ 响应式布局适配
|
|||
|
|
- ✅ 深色/浅色主题切换
|
|||
|
|
- ✅ 多语言界面支持
|
|||
|
|
|
|||
|
|
#### 后端服务
|
|||
|
|
- ✅ RESTful API设计
|
|||
|
|
- ✅ 实时数据处理引擎
|
|||
|
|
- ✅ 设备管理和通信
|
|||
|
|
- ✅ 数据分析算法
|
|||
|
|
- ✅ 报告生成服务
|
|||
|
|
|
|||
|
|
#### 数据管理
|
|||
|
|
- ✅ 患者信息CRUD操作
|
|||
|
|
- ✅ 检测会话管理
|
|||
|
|
- ✅ 历史数据查询和分析
|
|||
|
|
- ✅ 数据导出和备份
|
|||
|
|
- ✅ 数据安全和隐私保护
|
|||
|
|
|
|||
|
|
#### 设备集成
|
|||
|
|
- ✅ 摄像头视频采集和处理
|
|||
|
|
- ✅ IMU传感器数据采集
|
|||
|
|
- ✅ 压力传感器数据采集
|
|||
|
|
- ✅ 设备状态监控
|
|||
|
|
- ✅ 设备校准功能
|
|||
|
|
|
|||
|
|
#### 分析算法
|
|||
|
|
- ✅ 重心轨迹分析
|
|||
|
|
- ✅ 姿态稳定性评估
|
|||
|
|
- ✅ 平衡能力评分
|
|||
|
|
- ✅ 异常检测和预警
|
|||
|
|
- ✅ 趋势分析和对比
|
|||
|
|
|
|||
|
|
### 文件结构
|
|||
|
|
```
|
|||
|
|
BodyBalanceEvaluation/
|
|||
|
|
├── backend/ # 后端服务
|
|||
|
|
│ ├── app.py # 主应用入口
|
|||
|
|
│ ├── database.py # 数据库管理
|
|||
|
|
│ ├── device_manager.py # 设备管理
|
|||
|
|
│ ├── detection_engine.py # 检测引擎
|
|||
|
|
│ ├── data_processor.py # 数据处理
|
|||
|
|
│ ├── utils.py # 工具函数
|
|||
|
|
│ ├── requirements.txt # Python依赖
|
|||
|
|
│ └── tests/ # 测试文件
|
|||
|
|
├── src/
|
|||
|
|
│ ├── main/ # Electron主进程
|
|||
|
|
│ └── renderer/ # Vue前端应用
|
|||
|
|
│ ├── src/
|
|||
|
|
│ │ ├── views/ # 页面组件
|
|||
|
|
│ │ ├── stores/ # 状态管理
|
|||
|
|
│ │ └── services/ # API服务
|
|||
|
|
│ └── package.json
|
|||
|
|
├── data/ # 数据目录
|
|||
|
|
├── logs/ # 日志目录
|
|||
|
|
├── temp/ # 临时文件
|
|||
|
|
├── main.py # 启动脚本
|
|||
|
|
├── config.json # 配置文件
|
|||
|
|
├── package.json # 项目配置
|
|||
|
|
├── README.md # 项目说明
|
|||
|
|
├── LICENSE # 许可证
|
|||
|
|
├── .gitignore # Git忽略规则
|
|||
|
|
├── install.bat # 安装脚本
|
|||
|
|
├── start_dev.bat # 开发环境启动
|
|||
|
|
├── start_prod.bat # 生产环境启动
|
|||
|
|
└── CHANGELOG.md # 更新日志
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 系统要求
|
|||
|
|
- **操作系统**: Windows 10/11, macOS 10.15+, Ubuntu 18.04+
|
|||
|
|
- **Python**: 3.8 或更高版本
|
|||
|
|
- **Node.js**: 16.0 或更高版本
|
|||
|
|
- **内存**: 最少 4GB RAM，推荐 8GB+
|
|||
|
|
- **存储**: 最少 2GB 可用空间
|
|||
|
|
- **摄像头**: USB摄像头或内置摄像头
|
|||
|
|
- **串口设备**: IMU和压力传感器（可选）
|
|||
|
|
|
|||
|
|
### 安装和使用
|
|||
|
|
1. 运行 `install.bat` 安装所有依赖
|
|||
|
|
2. 运行 `start_dev.bat` 启动开发环境
|
|||
|
|
3. 或运行 `start_prod.bat` 启动生产环境
|
|||
|
|
4. 访问 http://localhost:5173 使用应用
|
|||
|
|
|
|||
|
|
### 已知问题
|
|||
|
|
- 在某些低配置设备上可能出现实时处理延迟
|
|||
|
|
- 部分USB摄像头可能需要额外驱动
|
|||
|
|
- IMU传感器需要正确的串口配置
|
|||
|
|
|
|||
|
|
### 性能优化
|
|||
|
|
- 实时数据处理采用多线程架构
|
|||
|
|
- 图像处理使用GPU加速（如可用）
|
|||
|
|
- 数据库查询优化和索引
|
|||
|
|
- 前端虚拟滚动和懒加载
|
|||
|
|
|
|||
|
|
### 安全特性
|
|||
|
|
- 本地数据存储，保护隐私
|
|||
|
|
- 数据传输加密
|
|||
|
|
- 用户会话管理
|
|||
|
|
- 输入数据验证和清理
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 版本说明
|
|||
|
|
|
|||
|
|
### 版本号格式
|
|||
|
|
本项目使用语义化版本号：`主版本号.次版本号.修订号`
|
|||
|
|
|
|||
|
|
- **主版本号**: 不兼容的API修改
|
|||
|
|
- **次版本号**: 向下兼容的功能性新增
|
|||
|
|
- **修订号**: 向下兼容的问题修正
|
|||
|
|
|
|||
|
|
### 更新类型
|
|||
|
|
- **新增 (Added)**: 新功能
|
|||
|
|
- **更改 (Changed)**: 对现有功能的更改
|
|||
|
|
- **弃用 (Deprecated)**: 即将移除的功能
|
|||
|
|
- **移除 (Removed)**: 已移除的功能
|
|||
|
|
- **修复 (Fixed)**: 错误修复
|
|||
|
|
- **安全 (Security)**: 安全相关的修复
|
|||
|
|
|
|||
|
|
### 发布周期
|
|||
|
|
- **主版本**: 每年1-2次重大更新
|
|||
|
|
- **次版本**: 每季度功能更新
|
|||
|
|
- **修订版**: 每月bug修复和小改进
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 贡献指南
|
|||
|
|
|
|||
|
|
如果您想为本项目贡献代码，请：
|
|||
|
|
|
|||
|
|
1. Fork 本仓库
|
|||
|
|
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
|
|||
|
|
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
|||
|
|
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
|||
|
|
5. 创建 Pull Request
|
|||
|
|
|
|||
|
|
### 提交信息格式
|
|||
|
|
```
|
|||
|
|
type(scope): description
|
|||
|
|
|
|||
|
|
[optional body]
|
|||
|
|
|
|||
|
|
[optional footer]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
类型包括：
|
|||
|
|
- `feat`: 新功能
|
|||
|
|
- `fix`: 修复bug
|
|||
|
|
- `docs`: 文档更新
|
|||
|
|
- `style`: 代码格式化
|
|||
|
|
- `refactor`: 代码重构
|
|||
|
|
- `test`: 测试相关
|
|||
|
|
- `chore`: 构建过程或辅助工具的变动
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 支持和反馈
|
|||
|
|
|
|||
|
|
- **问题报告**: [GitHub Issues](https://github.com/example/body-balance-evaluation/issues)
|
|||
|
|
- **功能请求**: [GitHub Discussions](https://github.com/example/body-balance-evaluation/discussions)
|
|||
|
|
- **邮件支持**: dev@example.com
|
|||
|
|
- **文档**: [项目Wiki](https://github.com/example/body-balance-evaluation/wiki)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*最后更新: 2024-01-15*
|