203 lines
3.2 KiB
Markdown
203 lines
3.2 KiB
Markdown
# 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）
|
||
- [ ] 开发中
|
||
- [ ] 已修复
|
||
- [ ] 已验证
|
||
- [ ] 已关闭
|