# 更新日志

本文档记录了身体平衡评估系统的所有重要更改。

格式基于 [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*