变更审计记录：绩效页数据正确性修复
| 字段 |
值 |
| 日期 |
2026-03-24 18:19:34 |
| Prompt-ID |
P20260324-180413 |
| Session-ID |
02057e57 |
| Session 路径 |
docs/audit/session_logs/2026-03/24/56_df6dc5a7_123842 |
操作摘要
修复绩效页（PERF-1）多个字段数据不正确的问题：当前档位费率显示客户收费标准而非助教到手单价、下一阶段费率/小时数/奖金全为 0、收入明细缺少激励课和 Top3 销冠奖项。涉及 fdw_queries.py SQL 查询扩展和 performance_service.py 业务逻辑重写。
变更文件
| 文件 |
变更类型 |
apps/backend/app/services/fdw_queries.py |
修改 |
apps/backend/app/services/performance_service.py |
修改 |
本次对话文件变更
新增文件
docs/audit/prompt_logs/prompt_log_20260324_180413.mddocs/audit/session_logs/2026-03/24/56_df6dc5a7_123842/main_01_02057e57.mddocs/audit/session_logs/2026-03/24/56_df6dc5a7_123842/sub_01_02057e57.mddocs/audit/session_logs/2026-03/24/57_5d61a787_175819/main_01_b8040cd9.mddocs/audit/session_logs/2026-03/24/57_5d61a787_175819/sub_01_02057e57.md
改动注解
apps/backend/app/services/fdw_queries.py
- 变更类型：修改
- 原始原因：绩效页收入明细需要奖金拆分（top_rank_bonus、recharge_commission、other_bonus）和当前档位抽成参数（base_deduction、bonus_deduction_ratio），原
get_salary_calc() 未查询这些字段
- 思路分析：在
get_salary_calc() 的 SQL SELECT 中追加 5 个字段（top_rank_bonus、recharge_commission、other_bonus、base_deduction、bonus_deduction_ratio），均来自 app.v_dws_assistant_salary_calc 视图已有列。返回 dict 增加对应键值，保持与现有字段相同的 float 转换 + None 默认值模式
- 修改结果：
performance_service.py 可获取奖金拆分数据和抽成参数，用于计算助教到手单价和收入明细展示。影响范围：仅 get_salary_calc() 的调用方（performance_service.get_overview() 和 task_manager）
apps/backend/app/services/performance_service.py
- 变更类型：修改
- 原始原因：绩效页 6 个数据错误——(1) currentTier 费率显示客户收费标准而非助教到手单价 (2) nextTier 费率全为 0 (3) upgradeHoursNeeded 为 0 (4) upgradeBonus 为 0 (5) 收入明细只显示有数据项，缺少激励课和 Top3 销冠奖 (6) total_bonus=600 未在明细中展示
- 思路分析：
- 到手单价计算：基础课到手 = 客户价 - base_deduction（球房提成固定额）；激励课到手 = 客户价 × (1 - bonus_deduction_ratio)（球房提成比例）。从
get_salary_calc() 新增的 base_deduction/bonus_deduction_ratio 字段获取
- 档位进度：新增调用
fdw_queries.get_performance_tiers() 读取 cfg_performance_tier 配置表，遍历找到当前档和下一档，计算 upgradeHoursNeeded = next_tier.min_hours - total_hours，upgradeBonus = 升档后抽成降低的节省额。逻辑复用自 task_manager._build_performance_summary
- 收入明细：
_build_income_items() 改为始终显示 3 项（基础课、激励课、Top3 销冠奖），即使金额为 0。Top3 销冠奖为 0 时 desc 显示"继续努力"。新增 top_rank_bonus 参数
- 修改结果：绩效页所有字段数据正确——currentTier basicRate=80/incentiveRate=95，nextTier basicRate=90/incentiveRate=114，upgradeHoursNeeded=12.91，upgradeBonus=1200，incomeItems 含 3 项（基础课¥8,567.20 + 激励课¥0.00 + Top3 销冠奖¥600.00）。影响范围：仅 PERF-1 概览接口
GET /api/xcx/performance
合规检查
| 检查项 |
状态 |
| 新增迁移 SQL |
无 |
| DDL 基线更新 |
不适用 |
| OpenAPI Spec 同步 |
不适用（接口签名未变，仅响应数据值修正） |
| BD 手册更新 |
不适用（未新增表/字段） |
| 文档同步 |
✅ 已更新 AI_CHANGELOG |
Neo
14a12342b5