antissoft / lvqianmeiye_ERP

  # 健康师薪酬计算规则梳理 - 额外数据与金三角战队业绩整合逻辑
  
  ## 一、核心问题
  
  健康师的额外数据（`lq_salary_extra_calculation` 表）会影响健康师的业绩计算，变动后的业绩需要整合到金三角战队业绩中。
  
  ## 二、数据流程梳理
  
  ### 2.1 数据来源
  
  #### 1. 基础业绩数据
  - **表名**: `lq_kd_jksyj` (健康师业绩表)
  - **字段**: 
    - `jkszh`: 健康师账号/ID
    - `jksyj`: 健康师业绩（字符串类型，需转换）
    - `PerformanceType`: 业绩类型（"基础业绩" 或 "合作业绩"）
    - `yjsj`: 业绩时间
    - `glkdbh`: 关联开单编号
  
  #### 2. 额外计算数据
  - **表名**: `lq_salary_extra_calculation` (健康师工资额外计算表)
  - **关键字段**:
    - `F_EmployeeId`: 健康师ID
    - `F_Year`: 年份
    - `F_Month`: 月份
    - `F_BaseRewardPerformance`: 基础奖励业绩（需从基础业绩中扣除）
    - `F_CooperationRewardPerformance`: 合作奖励业绩（需从合作业绩中扣除）
    - `F_OtherPerformanceAdd`: **其他业绩加**（需加到总业绩中）
    - `F_OtherPerformanceSubtract`: **其他业绩减**（需从总业绩中扣除）
    - `F_NewCustomerPerformance`: 新客业绩（可能被额外数据覆盖）
    - `F_UpgradePerformance`: 升单业绩（可能被额外数据覆盖）
  
  #### 3. 退款数据
  - **表名**: `lq_hytk_jksyj` (退款健康师业绩表)
  - **作用**: 从总业绩中扣除退款金额
  
  #### 4. 金三角战队数据
  - **表名**: `lq_jinsanjiao_user` (金三角用户表)
  - **表名**: `lq_ycsd_jsj` (金三角基础信息表)
  - **作用**: 确定健康师所属的战队
  
  ### 2.2 当前计算流程（代码位置：`LqSalaryService.cs` 的 `CalculateHealthCoachSalary` 方法）
  
  #### 步骤1: 计算基础业绩数据（第563-591行）
  
  ```csharp
  // 2.1 计算个人业绩
  var myPerf = performanceData.Where(x => x.Jks == empId).ToList();
  salary.BasePerformance = myPerf.Where(x => (x.PerformanceType ?? "").Trim() == "基础业绩")
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.CooperationPerformance = myPerf.Where(x => (x.PerformanceType ?? "").Trim() == "合作业绩")
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.TotalPerformance = myPerf.Sum(x => decimal.Parse(x.Jksyj ?? "0")); // 第567行
  
  // 扣除退款
  var myRefunds = refundList.Where(x => x.Jks == empId).ToList();
  if (myRefunds.Any())
  {
      decimal totalRefund = myRefunds.Sum(x => x.Jksyj ?? 0);
      salary.TotalPerformance -= totalRefund; // 第584行
      salary.BasePerformance -= baseRefund;
      salary.CooperationPerformance -= cooperationRefund;
  }
  
  // 新客与升单业绩（从开单记录中统计）
  salary.NewCustomerPerformance = myPerf.Where(x => string.Equals(x.Sfskdd, "是"))
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.UpgradePerformance = myPerf.Where(x => string.Equals(x.Sfskdd, "否"))
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  ```
  
  **当前问题**: 
  - `TotalPerformance` 只统计了开单业绩并扣除了退款
  - **没有加上 `OtherPerformanceAdd`**
  - **没有减去 `OtherPerformanceSubtract`**
  
  #### 步骤2: 填充额外计算数据（第593-605行）
  
  ```csharp
  // 2.1.1 填充额外计算数据
  if (extraCalculationDict.ContainsKey(empId))
  {
      var extraData = extraCalculationDict[empId];
      salary.BaseRewardPerformance = extraData.BaseRewardPerformance;
      salary.CooperationRewardPerformance = extraData.CooperationRewardPerformance;
      salary.OtherPerformanceAdd = extraData.OtherPerformanceAdd; // 第599行
      salary.OtherPerformanceSubtract = extraData.OtherPerformanceSubtract; // 第600行
      salary.UpgradeCustomerCount = extraData.UpgradeCustomerCount;
      salary.NewCustomerConversionRate = extraData.NewCustomerConversionRate;
      salary.NewCustomerPerformance = extraData.NewCustomerPerformance; // 可能覆盖之前的值
      salary.UpgradePerformance = extraData.UpgradePerformance; // 可能覆盖之前的值
  }
  ```
  
  **说明**: 
  - 额外数据被填充到工资统计对象中
  - `NewCustomerPerformance` 和 `UpgradePerformance` 可能被额外数据覆盖
  
  #### 步骤3: 计算实际基础业绩和实际合作业绩（第607-636行）
  
  ```csharp
  // 2.1.2 计算实际基础业绩和实际合作业绩
  // 实际基础业绩 = 基础业绩 - 基础奖励业绩 + 其他业绩加 - 其他业绩减
  decimal actualBasePerformance = salary.BasePerformance
      - salary.BaseRewardPerformance
      + salary.OtherPerformanceAdd  // 第615行：只影响实际基础业绩
      - salary.OtherPerformanceSubtract; // 第616行：只影响实际基础业绩
  
  // 新店额外调整：根据阶段扣除新客业绩或升单业绩
  if (isNewStore)
  {
      if (newStoreStage == 1)
      {
          actualBasePerformance -= salary.NewCustomerPerformance;
      }
      else if (newStoreStage == 2)
      {
          actualBasePerformance -= salary.UpgradePerformance;
      }
  }
  
  salary.ActualBasePerformance = actualBasePerformance;
  
  // 实际合作业绩 = 合作业绩 - 合作奖励业绩
  salary.ActualCooperationPerformance = salary.CooperationPerformance - salary.CooperationRewardPerformance;
  ```
  
  **当前问题**: 
  - `OtherPerformanceAdd` 和 `OtherPerformanceSubtract` **只用于计算 `ActualBasePerformance`**
  - **没有用于调整 `TotalPerformance`**
  
  #### 步骤4: 计算金三角战队业绩（第700-753行）
  
  ```csharp
  // 3. 处理战队逻辑 (考勤规则)
  // 规则：若出勤天数 < 20天，则该健康师不计入战队，按单人计算。
  
  // 按战队分组
  var teamGroups = employeeStats.Values
      .Where(x => !string.IsNullOrEmpty(x.GoldTriangleId))
      .GroupBy(x => x.GoldTriangleId)
      .ToList();
  
  foreach (var group in teamGroups)
  {
      var validMembers = new List<LqSalaryStatisticsEntity>();
      var invalidMembers = new List<LqSalaryStatisticsEntity>();
  
      foreach (var member in group)
      {
          if (member.WorkingDays >= 20)
          {
              validMembers.Add(member);
          }
          else
          {
              invalidMembers.Add(member);
          }
      }
  
      // 对于无效成员，移除战队标识，视为单人
      foreach (var member in invalidMembers)
      {
          member.GoldTriangleId = null;
          member.GoldTriangleTeam = "个人";
          member.Position = "健康师";
      }
  
      // 计算有效战队的总业绩和总消耗
      var teamTotalPerformance = validMembers.Sum(x => x.TotalPerformance); // 第735行
      var teamTotalConsumption = validMembers.Sum(x => x.Consumption);
  
      // 更新有效成员的战队业绩和战队总消耗
      foreach (var member in validMembers)
      {
          member.TeamPerformance = teamTotalPerformance; // 第741行
          member.TeamTotalConsumption = teamTotalConsumption;
      }
  }
  
  // 补充处理：对于没有战队ID的（个人，或被剔除的），战队业绩等于个人总业绩
  foreach (var salary in employeeStats.Values)
  {
      if (string.IsNullOrEmpty(salary.GoldTriangleId))
      {
          salary.TeamPerformance = salary.TotalPerformance; // 第751行
      }
  }
  ```
  
  **当前问题**: 
  - 第735行计算战队总业绩时，使用的是 `x.TotalPerformance`
  - 但 `TotalPerformance` **没有包含额外数据的调整**（`OtherPerformanceAdd` 和 `OtherPerformanceSubtract`）
  - 因此，**金三角战队业绩没有整合变动后的业绩**
  
  ## 三、问题分析
  
  ### 3.1 核心问题
  
  1. **总业绩未包含额外数据调整**
     - `TotalPerformance` 只统计了开单业绩并扣除了退款
     - 没有加上 `OtherPerformanceAdd`
     - 没有减去 `OtherPerformanceSubtract`
  
  2. **金三角战队业绩计算不准确**
     - 战队业绩 = 所有有效成员的总业绩之和
     - 但使用的是未调整的 `TotalPerformance`
     - 导致额外数据的变动没有反映到战队业绩中
  
  ### 3.2 影响范围
  
  1. **健康师个人总业绩**: 不准确（缺少额外数据调整）
  2. **金三角战队业绩**: 不准确（基于不准确的个人总业绩）
  3. **提成计算**: 可能受影响（如果提成计算依赖 `TotalPerformance`）
  4. **业绩占比**: 不准确（个人业绩占比 = 个人总业绩 / 战队总业绩）
  
  ## 四、解决方案建议
  
  ### 4.1 方案一：在计算总业绩时直接加上额外数据调整
  
  **修改位置**: `LqSalaryService.cs` 第567-605行
  
  **修改逻辑**:
  ```csharp
  // 2.1 计算个人业绩
  var myPerf = performanceData.Where(x => x.Jks == empId).ToList();
  salary.BasePerformance = myPerf.Where(x => (x.PerformanceType ?? "").Trim() == "基础业绩")
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.CooperationPerformance = myPerf.Where(x => (x.PerformanceType ?? "").Trim() == "合作业绩")
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.TotalPerformance = myPerf.Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  
  // 扣除退款
  var myRefunds = refundList.Where(x => x.Jks == empId).ToList();
  if (myRefunds.Any())
  {
      decimal totalRefund = myRefunds.Sum(x => x.Jksyj ?? 0);
      salary.TotalPerformance -= totalRefund;
      salary.BasePerformance -= baseRefund;
      salary.CooperationPerformance -= cooperationRefund;
  }
  
  // 新客与升单业绩（从开单记录中统计）
  salary.NewCustomerPerformance = myPerf.Where(x => string.Equals(x.Sfskdd, "是"))
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  salary.UpgradePerformance = myPerf.Where(x => string.Equals(x.Sfskdd, "否"))
      .Sum(x => decimal.Parse(x.Jksyj ?? "0"));
  
  // 2.1.1 填充额外计算数据
  if (extraCalculationDict.ContainsKey(empId))
  {
      var extraData = extraCalculationDict[empId];
      salary.BaseRewardPerformance = extraData.BaseRewardPerformance;
      salary.CooperationRewardPerformance = extraData.CooperationRewardPerformance;
      salary.OtherPerformanceAdd = extraData.OtherPerformanceAdd;
      salary.OtherPerformanceSubtract = extraData.OtherPerformanceSubtract;
      salary.UpgradeCustomerCount = extraData.UpgradeCustomerCount;
      salary.NewCustomerConversionRate = extraData.NewCustomerConversionRate;
      salary.NewCustomerPerformance = extraData.NewCustomerPerformance;
      salary.UpgradePerformance = extraData.UpgradePerformance;
      
      // 【新增】调整总业绩：加上其他业绩加，减去其他业绩减
      salary.TotalPerformance += salary.OtherPerformanceAdd;
      salary.TotalPerformance -= salary.OtherPerformanceSubtract;
  }
  ```
  
  **优点**:
  - 简单直接，在填充额外数据后立即调整总业绩
  - 确保后续所有使用 `TotalPerformance` 的地方都能获取到调整后的值
  
  **缺点**:
  - 需要确认 `OtherPerformanceAdd` 和 `OtherPerformanceSubtract` 是否应该影响总业绩
  - 需要确认是否应该影响基础业绩或合作业绩
  
  ### 4.2 方案二：在计算战队业绩前调整总业绩
  
  **修改位置**: `LqSalaryService.cs` 第700-753行
  
  **修改逻辑**:
  ```csharp
  // 3. 处理战队逻辑 (考勤规则)
  // 规则：若出勤天数 < 20天，则该健康师不计入战队，按单人计算。
  
  // 【新增】在计算战队业绩前，先调整所有健康师的总业绩（加上额外数据）
  foreach (var salary in employeeStats.Values)
  {
      salary.TotalPerformance += salary.OtherPerformanceAdd;
      salary.TotalPerformance -= salary.OtherPerformanceSubtract;
  }
  
  // 按战队分组
  var teamGroups = employeeStats.Values
      .Where(x => !string.IsNullOrEmpty(x.GoldTriangleId))
      .GroupBy(x => x.GoldTriangleId)
      .ToList();
  
  // ... 后续逻辑不变
  ```
  
  **优点**:
  - 集中处理，逻辑清晰
  - 确保在计算战队业绩前，所有成员的总业绩都已调整
  
  **缺点**:
  - 如果其他地方也使用 `TotalPerformance`，可能也需要调整
  
  ### 4.3 方案三：使用调整后的总业绩字段
  
  **修改逻辑**:
  - 保持 `TotalPerformance` 不变（原始总业绩）
  - 新增 `AdjustedTotalPerformance` 字段（调整后的总业绩）
  - 在计算战队业绩时使用 `AdjustedTotalPerformance`
  
  **优点**:
  - 保留原始数据，便于追溯
  - 明确区分原始业绩和调整后业绩
  
  **缺点**:
  - 需要修改数据库表结构
  - 需要修改所有使用总业绩的地方
  
  ## 五、推荐方案
  
  **推荐使用方案一**，原因：
  1. 逻辑简单，在填充额外数据后立即调整总业绩
  2. 确保后续所有使用 `TotalPerformance` 的地方都能获取到调整后的值
  3. 不需要修改数据库表结构
  4. 符合业务逻辑：额外数据应该影响总业绩
  
  ## 六、需要确认的问题
  
  1. **`OtherPerformanceAdd` 和 `OtherPerformanceSubtract` 是否应该影响总业绩？**
     - 当前代码中，这两个字段只影响 `ActualBasePerformance`
     - 需要确认业务规则：是否应该同时影响 `TotalPerformance`
  
  2. **额外数据中的 `NewCustomerPerformance` 和 `UpgradePerformance` 是否应该覆盖从开单记录中统计的值？**
     - 当前代码中，如果存在额外数据，会覆盖之前统计的值
     - 需要确认业务规则：是覆盖还是累加？
  
  3. **额外数据是否应该影响基础业绩或合作业绩？**
     - 当前代码中，`OtherPerformanceAdd` 和 `OtherPerformanceSubtract` 只影响 `ActualBasePerformance`
     - 需要确认：是否应该同时调整 `BasePerformance` 或 `CooperationPerformance`？
  
  4. **金三角战队业绩的计算时机**
     - 当前在计算战队业绩时，使用的是 `TotalPerformance`
     - 如果 `TotalPerformance` 没有包含额外数据调整，战队业绩就不准确
     - 需要确认：是否应该在计算战队业绩前，先调整所有成员的总业绩？
  
  ## 七、代码修改建议
  
  ### 7.1 修改位置
  
  **文件**: `netcore/src/Modularity/Extend/NCC.Extend/LqSalaryService.cs`  
  **方法**: `CalculateHealthCoachSalary`  
  **位置**: 第593-605行（填充额外计算数据后）
  
  ### 7.2 修改内容
  
  在填充额外计算数据后，立即调整总业绩：
  
  ```csharp
  // 2.1.1 填充额外计算数据
  if (extraCalculationDict.ContainsKey(empId))
  {
      var extraData = extraCalculationDict[empId];
      salary.BaseRewardPerformance = extraData.BaseRewardPerformance;
      salary.CooperationRewardPerformance = extraData.CooperationRewardPerformance;
      salary.OtherPerformanceAdd = extraData.OtherPerformanceAdd;
      salary.OtherPerformanceSubtract = extraData.OtherPerformanceSubtract;
      salary.UpgradeCustomerCount = extraData.UpgradeCustomerCount;
      salary.NewCustomerConversionRate = extraData.NewCustomerConversionRate;
      salary.NewCustomerPerformance = extraData.NewCustomerPerformance;
      salary.UpgradePerformance = extraData.UpgradePerformance;
      
      // 【新增】调整总业绩：加上其他业绩加，减去其他业绩减
      // 注意：这里调整的是总业绩，确保后续计算（包括战队业绩）使用的是调整后的值
      salary.TotalPerformance += salary.OtherPerformanceAdd;
      salary.TotalPerformance -= salary.OtherPerformanceSubtract;
  }
  ```
  
  ### 7.3 影响分析
  
  **修改后的影响**:
  1. ✅ 健康师个人总业绩包含额外数据调整
  2. ✅ 金三角战队业绩 = 所有有效成员的调整后总业绩之和
  3. ✅ 提成计算（如果依赖 `TotalPerformance`）会使用调整后的值
  4. ✅ 业绩占比计算会使用调整后的值
  
  **需要注意**:
  - 确保 `OtherPerformanceAdd` 和 `OtherPerformanceSubtract` 的值是正确的
  - 确保额外数据表（`lq_salary_extra_calculation`）的数据是准确的
  - 如果后续有其他地方也使用 `TotalPerformance`，需要确认是否应该使用调整后的值
  
  ## 八、测试建议
  
  1. **单元测试**:
     - 测试额外数据为0时，总业绩不变
     - 测试 `OtherPerformanceAdd > 0` 时，总业绩增加
     - 测试 `OtherPerformanceSubtract > 0` 时，总业绩减少
     - 测试两者同时存在时的计算
  
  2. **集成测试**:
     - 测试单个健康师的额外数据调整后，总业绩是否正确
     - 测试战队中多个成员都有额外数据时，战队总业绩是否正确
     - 测试战队中部分成员有额外数据时，战队总业绩是否正确
  
  3. **数据验证**:
     - 对比修改前后的计算结果
     - 验证金三角战队业绩是否包含额外数据调整
     - 验证业绩占比计算是否正确
  
  ---
  
  **文档版本**: v1.0  
  **创建日期**: 2026-01-09  
  **适用范围**: 健康师薪酬计算 - 额外数据与金三角战队业绩整合