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.

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 端口

启动命令:

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 文件

# 确保以下文件存在
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:

# 使用绝对导入而非相对导入
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:

#!/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 - 紧急