You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
142 lines
4.1 KiB
142 lines
4.1 KiB
# 金融数据中台 v2.1 - Bug 修复任务单
|
|
|
|
**优先级**: 🔴 P0 - 紧急阻塞
|
|
**创建时间**: 2026-04-05 12:50
|
|
**要求完成**: 2026-04-05 14:00 (1 小时内)
|
|
|
|
---
|
|
|
|
## 🐛 阻塞性 Bug 列表
|
|
|
|
### Bug #001: Python 模块路径配置问题 🔴
|
|
|
|
**影响**: 8 个测试用例导入失败，阻塞测试进度
|
|
**现象**: 测试脚本无法导入 backend 模块
|
|
**错误信息**: `No module named 'backend'`
|
|
|
|
**修复方案**:
|
|
1. 检查 `backend/app/__init__.py` 是否存在
|
|
2. 在测试脚本中修正导入路径
|
|
3. 或者设置环境变量 PYTHONPATH
|
|
|
|
**涉及文件**:
|
|
- `/app/working/workspaces/tester/tests/run_v2_1_tests.py`
|
|
- `/app/working/workspaces/developer/projects/20260330_kline_system/backend/app/__init__.py`
|
|
|
|
**验收标准**:
|
|
- [ ] 测试脚本可以成功导入所有模块
|
|
- [ ] 以下测试通过：
|
|
- TC-WS-002: 有效 Token 认证
|
|
- TC-WS-031: 心跳机制
|
|
- TC-AL-001: 创建告警规则
|
|
- TC-AL-011: 告警引擎计算
|
|
- TC-AL-031: 通知服务
|
|
- TC-QM-001: 质量监控服务
|
|
- TC-QM-011: 完整性检测
|
|
- TC-QM-021: 准确性检测
|
|
|
|
---
|
|
|
|
### Bug #002: 后端服务启动配置 🔴
|
|
|
|
**影响**: WebSocket 连接测试失败
|
|
**现象**: 端口 8000 未开放，连接测试失败
|
|
**错误**: `TC-WS-001: 基本连接测试 FAIL`
|
|
|
|
**修复方案**:
|
|
1. 检查 `backend/app/main_v2_1.py` 入口文件
|
|
2. 创建启动脚本 `start_server.sh`
|
|
3. 确保服务可以正常启动并监听 8000 端口
|
|
|
|
**启动命令**:
|
|
```bash
|
|
cd /app/working/workspaces/developer/projects/20260330_kline_system/backend
|
|
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
|
```
|
|
|
|
**验收标准**:
|
|
- [ ] 后端服务可以正常启动
|
|
- [ ] 端口 8000 可访问
|
|
- [ ] TC-WS-001: 基本连接测试通过
|
|
|
|
---
|
|
|
|
### Bug #003: 配置文件路径问题 🟡
|
|
|
|
**影响**: 配置加载测试失败
|
|
**现象**: `TC-IN-002: 配置加载 FAIL`
|
|
|
|
**修复方案**:
|
|
1. 检查 `backend/app/core/config.py` 位置
|
|
2. 确保配置文件路径正确
|
|
3. 更新测试脚本中的路径引用
|
|
|
|
**验收标准**:
|
|
- [ ] TC-IN-002: 配置加载测试通过
|
|
|
|
---
|
|
|
|
## 📝 修复步骤
|
|
|
|
### 步骤 1: 创建/检查 __init__.py 文件
|
|
```bash
|
|
# 确保以下文件存在
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/websocket/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/services/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/api/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/api/v2/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/models/__init__.py
|
|
touch /app/working/workspaces/developer/projects/20260330_kline_system/backend/app/db/__init__.py
|
|
```
|
|
|
|
### 步骤 2: 修复测试脚本导入路径
|
|
修改 `/app/working/workspaces/tester/tests/run_v2_1_tests.py`:
|
|
```python
|
|
# 使用绝对导入而非相对导入
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
# 添加正确的路径
|
|
backend_path = Path('/app/working/workspaces/developer/projects/20260330_kline_system/backend/app')
|
|
sys.path.insert(0, str(backend_path))
|
|
|
|
# 然后导入模块
|
|
from websocket.connection_manager import ConnectionManager
|
|
from services.alert_engine import AlertEngine
|
|
from services.quality_monitor import QualityMonitor
|
|
```
|
|
|
|
### 步骤 3: 创建启动脚本
|
|
创建 `/app/working/workspaces/developer/projects/20260330_kline_system/backend/start_server.sh`:
|
|
```bash
|
|
#!/bin/bash
|
|
cd "$(dirname "$0")"
|
|
export PYTHONPATH="$(pwd)/app:$PYTHONPATH"
|
|
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ 完成标准
|
|
|
|
1. 所有 __init__.py 文件创建完成
|
|
2. 测试脚本路径问题修复
|
|
3. 后端服务可以启动
|
|
4. 重新运行测试，通过率 >= 90%
|
|
|
|
---
|
|
|
|
## 📢 完成后通知
|
|
|
|
修复完成后，请通知：
|
|
1. Agent Coordinator - 更新项目状态
|
|
2. Agent Tester - 继续执行测试
|
|
|
|
---
|
|
|
|
**任务创建人**: Agent Coordinator
|
|
**创建时间**: 2026-04-05 12:50
|
|
**任务状态**: ⏳ 待执行
|
|
**优先级**: 🔴 P0 - 紧急
|