# 变更审计记录：绩效页数据正确性修复

| 字段 | 值 |
|------|-----|
| 日期 | 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.md`
- `docs/audit/session_logs/2026-03/24/56_df6dc5a7_123842/main_01_02057e57.md`
- `docs/audit/session_logs/2026-03/24/56_df6dc5a7_123842/sub_01_02057e57.md`
- `docs/audit/session_logs/2026-03/24/57_5d61a787_175819/main_01_b8040cd9.md`
- `docs/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 |
