1.1 业务背景
助理指导员存在跨城市授课场景，当前系统在基本档变更和课酬统计时存在两处城市过滤缺失的BUG：
BUG 1：变更基本档时误结束其他城市的基本档
变更助理指导员基本档时，查询当月生效基本档未关联城市。
→ 会把其他城市正在生效的基本档结束掉（误伤）
→ 但同城市如果有多个生效记录反而没结束（漏处理）
BUG 2：课酬统计报表跨城市重复
薪酬报表关联 tb_business_teacher_base_files_log 查询所有 end_time=null 的基本档，没有限制城市。
→ 跨城市授课时，同一课时匹配到多个城市的基本档，数据膨胀（实测出现3次）
SQL查询截图：同一 teacher_id 出现多条广州 end_time=null 记录（数据BUG现象）
1.2 核心前提
| 规则 | 说明 |
|---|
| 基本档生效维度 | 城市 + 月份，一个助理指导员在一个城市一个月只有一个基本档生效 |
| 新增/修改触发场景 | ① 新增指导员所属城市 ② 修改指导员所属城市 ③ 助理指导员补充档设置 |
1.3 核心目标
| 目标 | 说明 |
|---|
| 修复变更BUG | 变更基本档时加城市过滤，只影响当前城市的基本档 |
| 修复统计重复 | 课酬报表关联补充档时加城市限制，消除跨城市重复 |
精准修复
两处查询加城市过滤
存量数据清洗
无UI改动
❶ 点击「修改」
❷ 更多 →「助理指导员补充档设置」
指导员管理页面 — 红框标注触发基本档变更的两个入口：「修改」按钮和「更多 → 助理指导员补充档设置」
⭕ 「所属城市」字段 — 修改城市时触发基本档变更
指导员修改弹窗 — 红框标注「所属城市」字段，修改城市时触发基本档变更查询
⭕ 「档位」字段 — 设置补充档时触发基本档变更
助理指导员补充档设置弹窗 — 红框标注「档位」字段，选择档位时触发基本档变更查询
变更基本档查询修复
1. 现状（有BUG）
变更基本档时查询当月生效记录，
未关联城市：
-- 当前：未加城市过滤
SELECT * FROM tb_business_teacher_base_files_log
WHERE teacher_id = ? AND is_del = 0
AND end_time IS NULL
-- ⚠ 命中所有城市，误结束其他城市记录
2. 修复后
✓ 加城市过滤条件
-- 修复后：加城市过滤
SELECT * FROM tb_business_teacher_base_files_log
WHERE teacher_id = ? AND is_del = 0
AND end_time IS NULL
AND base_file_id IN (
SELECT base_file_id FROM tb_base_file_ref_city
WHERE city_id = ?)
-- ✓ 只命中当前城市的基本档
3. 完整变更逻辑
| 场景 | 处理逻辑 |
|---|
| 新增指导员所属城市 | 关联城市查询（tb_base_file_ref_city），检查是否有生效基本档，没有则直接新增 |
| 修改指导员所属城市 | 关联目标城市查询 → 有：结束原档，再新增；无：走新增 |
| 补充档设置 | 关联当前城市查询 → 有：结束原档，再新增；无：走新增 |
4. 关于 tb_base_file_ref_city
该表仍在使用，被新增指导员时的自动分配最低档逻辑引用。仅在补充档设置的「可设置范围查询」中被注掉，该场景当前使用 %城市% 匹配 tb_base_file.name。
5. 广州硬编码默认一档
广州城市在自动分配基本档时存在硬编码逻辑，默认直接给一档（不取最低档）。历史遗留，本次不涉及调整。
6. 不涉及改动清单
- 基本档设置页面
- 基本档的"设置价格"功能
- 指导员管理列表页（筛选/列表/分页）
- 助理指导员补充档设置弹窗（UI交互/表单字段）
- 补充档可设置范围查询逻辑
- 新增指导员自动分配最低档逻辑
