Hypertension_Risk_Assessment/0112-2026 - Test_Package/3-docs/Bug-Report-Template.md

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. 或者修改数据库路径到用户目录

---

状态跟踪

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