# Bug报告模板

**使用说明：** 每发现一个Bug，复制下面的模板填写

---

## Bug #[编号]

**标题：** [一句话描述问题]

**严重程度：**
- [ ] P0 - 阻塞性（系统崩溃/无法启动/核心功能不可用）
- [ ] P1 - 严重（主要功能异常/数据错误）
- [ ] P2 - 一般（界面问题/提示不清晰/性能问题）
- [ ] P3 - 建议（优化建议/文档问题）

**发现时间：** 2026-01-XX XX:XX

**发现人：** [你的名字]

**影响范围：**
- [ ] 云端
- [ ] 边缘端
- [ ] 端到端联调
- [ ] 其他：__________

---

### 问题描述

[清晰描述问题是什么，用户会看到什么]

---

### 复现步骤

**前置条件：**
- [例如：云端服务正在运行]
- [例如：已安装所有依赖]

**复现步骤：**
1. [第一步]
2. [第二步]
3. [第三步]

---

### 预期结果

[应该发生什么]

---

### 实际结果

[实际发生了什么]

---

### 环境信息

**操作系统：** Windows 10 / macOS XX / Linux  
**Python版本：** 3.x.x  
**关键依赖版本：**
- Flask: x.x.x
- numpy: x.x.x

**配置信息：**
- device_id: xxxx
- API Key: xxxx（前4位）
- 云端地址: xxxx

---

### 日志与截图

**错误日志：**
```
[粘贴关键错误日志，至少前后20行]
```

**完整日志文件：**
- `artifacts/xxx/error.log`

**截图：**
- `artifacts/xxx/screenshot.png`

---

### 建议解决方案

[如果你有想法，写下来；没有也可以留空]

---

### 状态跟踪

- [ ] 已报告
- [ ] 开发中
- [ ] 已修复
- [ ] 已验证
- [ ] 已关闭

**修复责任人：** __________  
**预计修复时间：** __________

---
---

## Bug示例（参考）

### Bug #001

**标题：** 云端启动时数据库连接失败

**严重程度：** P0 - 阻塞性

**发现时间：** 2026-01-12 10:15

**发现人：** 测试成员A

**影响范围：** ✅ 云端

---

### 问题描述

运行 `python cloud_hypertension_system.py` 后，系统报错退出，提示数据库连接失败。

---

### 复现步骤

**前置条件：**
- Python 3.8已安装
- 已执行 `pip install -r requirements.txt`

**复现步骤：**
1. 打开PowerShell
2. 导航到项目目录
3. 执行 `python cloud_hypertension_system.py`

---

### 预期结果

云端服务正常启动，显示：
```
✓ 数据库初始化成功
Running on http://127.0.0.1:5000
```

---

### 实际结果

程序报错退出：
```
sqlite3.OperationalError: unable to open database file
```

---

### 环境信息

**操作系统：** Windows 10  
**Python版本：** 3.9.7  
**SQLite版本：** 3.35.5

---

### 日志与截图

**错误日志：**
```
Traceback (most recent call last):
  File "cloud_hypertension_system.py", line 850, in init_database
    self.db_manager = DatabaseManager(self.config.database_config)
  File "cloud_hypertension_system.py", line 125, in __init__
    self.engine = create_engine(...)
sqlite3.OperationalError: unable to open database file
```

**完整日志：** `artifacts/cloud/startup_error.log`

---

### 建议解决方案

检查数据库文件路径是否存在写权限。可能需要：
1. 手动创建数据库目录
2. 或者修改数据库路径到用户目录

---

### 状态跟踪

- [x] 已报告（2026-01-12）
- [ ] 开发中
- [ ] 已修复
- [ ] 已验证
- [ ] 已关闭