# 金融数据中台 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 - 紧急