antissoft / lvqianmeiye_ERP

  # 主任工资计算逻辑完整梳理
  
  ## 📋 概述
  
  主任工资由以下几个部分组成：
  1. **底薪**：固定3500元，根据考核指标扣款
  2. **提成**：基于**毛利**计算，使用阶梯提成模式
  
  **重要说明**：
  - **业绩（StoreTotalPerformance）就是毛利**
  - **提成计算基于毛利**，而不是销售业绩（开单-退卡）
  
  ---
  
  ## 💰 核心计算公式
  
  ### 1. 销售业绩
  
  ```
  销售业绩 = 开单业绩 - 退款业绩
  ```
  
  ### 2. 毛利（核心指标）
  
  ```
  毛利 = 销售业绩 -  - 合作项目成本 - 店内支出 - 洗毛巾费用
  ```
  
  ### 3. 业绩（用于提成计算）
  
  ```
  业绩（StoreTotalPerformance）= 毛利（GrossProfit）
  ```
  
  **关键点**：`StoreTotalPerformance` 字段存储的是**毛利**，用于提成计算。
  
  ---
  
  ## 📊 数据来源详解
  
  ### 1. 开单业绩
  
  **数据来源**：
  - 表：`lq_kd_kdjlb`（开单记录表）
  - 字段：`sfyj`（实付业绩）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `Djmd = @StoreId`（门店ID）
    - `Kdrq >= @StartDate AND Kdrq <= @EndDate`（时间范围）
  
  **代码位置**：第185-192行
  
  ### 2. 退款业绩
  
  **数据来源**：
  - 表：`lq_hytk_hytk`（退卡记录表）
  - 字段：`F_ActualRefundAmount`（实际退款金额，如果没有则使用 `tkje`）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `md = @StoreId`（门店ID）
    - `Tksj >= @StartDate AND Tksj <= @EndDate`（时间范围）
  
  **代码位置**：第194-202行
  
  ### 3. 产品物料
  
  **数据来源**：
  - 表：`lq_inventory_usage`（库存使用记录表）
  - 字段：`F_TotalAmount`（合计金额）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `F_StoreId = @StoreId`（门店ID）
    - **特殊规则**：11月工资算10月数据
      - 如果计算月份是11月，则查询10月的数据
      - 其他月份正常查询当月数据
  
  **代码位置**：第252-271行
  
  ### 4. 合作项目成本
  
  **数据来源**：
  - 表：`lq_cooperation_cost`（合作成本表）
  - 字段：`F_TotalAmount`（合计金额）
  - 条件：
    - `F_Year = @Year`（年份）
    - `F_Month = @MonthStr`（月份，YYYYMM格式）
    - `F_StoreId = @StoreId`（门店ID）
    - `F_IsEffective = 1`（有效记录）
  
  **代码位置**：第273-281行
  
  ### 5. 店内支出
  
  **数据来源**：
  - 表：`lq_store_expense`（店内支出表）
  - 字段：`F_Amount`（金额）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `F_StoreId = @StoreId`（门店ID）
    - `DATE_FORMAT(F_ExpenseDate, '%Y%m') = @MonthStr`（月份，YYYYMM格式）
  
  **代码位置**：第283-296行
  
  ### 6. 洗毛巾费用
  
  **数据来源**：
  - 表：`lq_laundry_flow`（清洗流水表）
  - 字段：`F_TotalPrice`（总费用）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `F_FlowType = 0`（只统计送出的记录）
    - `F_StoreId = @StoreId`（门店ID）
    - 优先使用 `F_SendTime`，如果为空则使用 `F_CreateTime`
    - `DATE_FORMAT(COALESCE(F_SendTime, F_CreateTime), '%Y%m') = @MonthStr`（月份，YYYYMM格式）
  
  **代码位置**：第298-313行
  
  ---
  
  ## 🔄 计算流程
  
  ### 步骤1：计算销售业绩
  
  ```csharp
  // 2.4 计算销售业绩（开单业绩-退款业绩）
  decimal billing = storeBillingDict.ContainsKey(storeId) ? storeBillingDict[storeId] : 0;
  decimal refund = storeRefundDict.ContainsKey(storeId) ? storeRefundDict[storeId] : 0;
  salary.StoreBillingPerformance = billing;
  salary.StoreRefundPerformance = refund;
  salary.SalesPerformance = billing - refund;
  ```
  
  **代码位置**：第402-407行
  
  ### 步骤2：统计各项成本
  
  ```csharp
  // 2.5 统计各项成本
  salary.ProductMaterial = productMaterialDict.ContainsKey(storeId) ? productMaterialDict[storeId] : 0;
  salary.CooperationCost = cooperationCostDict.ContainsKey(storeId) ? cooperationCostDict[storeId] : 0;
  salary.StoreExpense = storeExpenseDict.ContainsKey(storeId) ? storeExpenseDict[storeId] : 0;
  salary.LaundryCost = laundryCostDict.ContainsKey(storeId) ? laundryCostDict[storeId] : 0;
  ```
  
  **代码位置**：第409-420行
  
  ### 步骤3：计算毛利
  
  ```csharp
  // 2.6 计算毛利
  // 毛利 = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾
  salary.GrossProfit = salary.SalesPerformance - salary.ProductMaterial - salary.CooperationCost - salary.StoreExpense - salary.LaundryCost;
  ```
  
  **代码位置**：第422-424行
  
  ### 步骤4：将毛利赋值给StoreTotalPerformance（用于提成计算）
  
  ```csharp
  // 2.7 将毛利赋值给StoreTotalPerformance（用于提成计算）
  salary.StoreTotalPerformance = salary.GrossProfit;
  ```
  
  **代码位置**：第426-427行
  
  **关键点**：`StoreTotalPerformance` 存储的是**毛利**，不是销售业绩。
  
  ### 步骤5：计算业绩完成率（基于毛利）
  
  ```csharp
  // 2.8 计算业绩完成率（基于毛利与生命线比较）
  if (salary.StoreLifeline > 0)
  {
      salary.PerformanceCompletionRate = salary.GrossProfit / salary.StoreLifeline;
  }
  ```
  
  **代码位置**：第429-437行
  
  ### 步骤6：判断业绩是否达标（基于毛利）
  
  ```csharp
  // 2.11 计算考核指标（业绩、人头、消耗是否达标）
  // 业绩达标判断基于毛利
  bool performanceReached = salary.GrossProfit >= salary.StoreLifeline;
  ```
  
  **代码位置**：第445-447行
  
  ### 步骤7：计算提成（基于毛利）
  
  ```csharp
  // 2.14 计算阶梯提成（先计算门店总提成，基于毛利）
  CalculateCommission(salary, isNewStore);
  ```
  
  **代码位置**：第495-496行
  
  **提成计算方法**：
  
  ```csharp
  // 提成计算基于毛利（StoreTotalPerformance存储的是毛利）
  decimal performance = salary.StoreTotalPerformance; // 这里已经是毛利了
  decimal lifeline = salary.StoreLifeline;
  
  // 计算阶梯提成
  if (performance <= lifeline)
  {
      // 业绩 ≤ 生命线：只计算≤生命线部分的提成
      salary.CommissionAmountBelowLifeline = performance * rateBelowLifeline;
      salary.CommissionAmountAboveLifeline = 0;
  }
  else
  {
      // 业绩 > 生命线：分别计算≤生命线部分和>生命线部分的提成
      salary.CommissionAmountBelowLifeline = lifeline * rateBelowLifeline;
      salary.CommissionAmountAboveLifeline = (performance - lifeline) * rateAboveLifeline;
  }
  ```
  
  **代码位置**：第567-640行
  
  ---
  
  ## 💰 提成规则详解
  
  ### 提成计算方式
  

  **重要说明**：
  - **提成基数**：使用**毛利**（GrossProfit），不是销售业绩（开单-退卡）
  - **分段计算**：根据毛利与生命线的比较，分段计算提成
  - **阶梯提成模式**：根据毛利是否超过生命线，使用不同的提成比例

  
  ### 老店主任提成规则
  

  根据门店分类（A、B、C类）和毛利是否超过生命线，使用不同的阶梯提成比例：

  | 门店分类 | 毛利 ≤ 生命线部分 | 毛利 > 生命线部分 |

  |---------|----------------|-----------------|
  | A类门店 | 2% | 2.5% |
  | B类门店 | 2.5% | 3% |
  | C类门店 | 3% | 3.5% |
  

  **计算公式（基于毛利分段计算）**：

  ```

  如果 毛利 ≤ 生命线：
      提成 = 毛利 × 对应提成比例（≤生命线部分）

  如果 毛利 > 生命线：
      提成 = 生命线 × 对应提成比例（≤生命线部分） + (毛利 - 生命线) × 对应提成比例（>生命线部分）

  ```
  

  **计算示例**：
  - 假设：门店生命线 = 100,000元，毛利 = 120,000元，门店分类 = B类（2.5% / 3%）
  - 计算：
    - ≤生命线部分：100,000元 × 2.5% = 2,500元
    - >生命线部分：(120,000 - 100,000)元 × 3% = 600元
    - 总提成：2,500元 + 600元 = 3,100元
  

  ### 新店主任提成规则
  
  **统一标准**，不区分门店分类：
  

  | 毛利范围 | 提成比例 |

  |---------|---------|

  | 毛利 ≤ 生命线部分 | 2% |
  | 毛利 > 生命线部分 | 2.5% |

  **计算公式（基于毛利分段计算）**：

  ```

  如果 毛利 ≤ 生命线：
      提成 = 毛利 × 2%

  如果 毛利 > 生命线：
      提成 = 生命线 × 2% + (毛利 - 生命线) × 2.5%

  ```
  

  **计算示例**：
  - 假设：门店生命线 = 100,000元，毛利 = 120,000元（新店）
  - 计算：
    - ≤生命线部分：100,000元 × 2% = 2,000元
    - >生命线部分：(120,000 - 100,000)元 × 2.5% = 500元
    - 总提成：2,000元 + 500元 = 2,500元
  

  ### 提成按在店天数比例计算
  
  ```csharp
  // 2.15 按在店天数比例计算提成金额
  if (daysInMonth > 0 && workingDays > 0)
  {
      // 提成金额按在店天数比例计算
      salary.CommissionAmountBelowLifeline = salary.CommissionAmountBelowLifeline / daysInMonth * workingDays;
      salary.CommissionAmountAboveLifeline = salary.CommissionAmountAboveLifeline / daysInMonth * workingDays;
      salary.TotalCommissionAmount = salary.CommissionAmountBelowLifeline + salary.CommissionAmountAboveLifeline;
  }
  ```
  
  **代码位置**：第498-512行
  
  ---
  
  ## 📝 关键字段说明
  
  ### StoreTotalPerformance（门店总业绩）
  
  **字段含义**：**毛利**
  
  **计算公式**：
  ```
  StoreTotalPerformance = GrossProfit = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾费用
  ```
  
  **用途**：
  - 用于提成计算
  - 用于业绩完成率计算
  - 用于业绩达标判断
  
  **重要说明**：此字段存储的是**毛利**，不是销售业绩（开单-退卡）。
  
  ### GrossProfit（毛利）
  
  **字段含义**：毛利
  
  **计算公式**：
  ```
  GrossProfit = SalesPerformance - ProductMaterial - CooperationCost - StoreExpense - LaundryCost
  ```
  
  ### SalesPerformance（销售业绩）
  
  **字段含义**：销售业绩（开单-退卡）
  
  **计算公式**：
  ```
  SalesPerformance = StoreBillingPerformance - StoreRefundPerformance
  ```
  
  ---
  
  ## ✅ 验证要点
  
  ### 1. 业绩就是毛利
  
  - ✅ `StoreTotalPerformance = GrossProfit`（第427行）
  - ✅ 提成计算使用 `StoreTotalPerformance`（第581行）
  - ✅ 业绩完成率使用 `GrossProfit`（第432行）
  - ✅ 业绩达标判断使用 `GrossProfit`（第447行）
  
  ### 2. 提成计算基于毛利
  
  - ✅ `CalculateCommission` 方法注释明确说明"基于毛利"（第563行）
  - ✅ 方法内部使用 `StoreTotalPerformance`（即毛利）进行计算（第581行）
  - ✅ 所有提成计算都基于 `performance`（即毛利）
  
  ---
  
  ## 📋 总结
  
  ### 核心结论
  
  1. **业绩（StoreTotalPerformance）就是毛利**
     - `StoreTotalPerformance = GrossProfit`
     - 不是销售业绩（开单-退卡）
  
  2. **提成计算基于毛利**
     - 提成计算使用 `StoreTotalPerformance`（即毛利）
     - 不是基于销售业绩
  
  3. **毛利计算公式**
     ```
     毛利 = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾费用
     ```
  
  4. **所有业绩相关的判断都基于毛利**
     - 业绩完成率 = 毛利 / 生命线
     - 业绩达标判断 = 毛利 >= 生命线
     - 提成计算 = 基于毛利使用阶梯提成
  
  ### 数据流向
  
  ```
  开单业绩 - 退款业绩
      ↓
  销售业绩（SalesPerformance）
      ↓
  销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾费用
      ↓
  毛利（GrossProfit）
      ↓
  StoreTotalPerformance（用于提成计算）
      ↓
  阶梯提成计算
  ```
  
  ---
  
  ## 🔍 代码关键位置
  
  | 功能 | 代码位置 | 说明 |
  |-----|---------|------|
  | 计算销售业绩 | 第402-407行 | 开单-退卡 |
  | 统计各项成本 | 第409-420行 | 产品物料、合作成本、店内支出、洗毛巾 |
  | 计算毛利 | 第422-424行 | 销售业绩 - 各项成本 |
  | 将毛利赋值给StoreTotalPerformance | 第426-427行 | **关键：业绩就是毛利** |
  | 计算业绩完成率 | 第429-437行 | 基于毛利 |
  | 判断业绩达标 | 第445-447行 | 基于毛利 |
  | 计算提成 | 第495-496行 | 调用CalculateCommission，基于毛利 |
  | 提成计算方法 | 第567-640行 | 使用StoreTotalPerformance（即毛利）计算 |
  
  ---
  
  **文档版本**：2025-01-20
  **最后更新**：确认业绩就是毛利，提成计算基于毛利