antissoft / lvqianmeiye_ERP

  # 主任工资毛利计算逻辑梳理
  
  ## 📋 概述
  
  根据店长工资计算规则，主任工资也需要使用**毛利**来计算提成，而不是直接使用门店业绩（开单-退卡）。
  
  ## 💰 毛利计算公式
  
  ### 核心公式
  
  ```
  毛利 = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾
  ```
  
  其中：
  - **销售业绩** = 开单业绩 - 退款业绩
  - **产品物料** = 仓库领用金额合计（注意11月特殊规则：11月工资算10月数据）
  - **合作项目成本** = 合作成本表合计金额
  - **店内支出** = 店内支出表合计金额
  - **洗毛巾** = 送洗记录总费用（只统计送出的记录，F_FlowType = 0）
  
  ---
  
  ## 📊 数据来源
  
  ### 1. 销售业绩
  
  **计算公式**：
  ```
  销售业绩 = 开单业绩 - 退款业绩
  ```
  
  **数据来源**：
  
  1. **开单业绩**：
     - 表：`lq_kd_kdjlb`（开单记录表）
     - 字段：`sfyj`（实付业绩）
     - 条件：
       - `F_IsEffective = 1`（有效记录）
       - `Djmd = @StoreId`（门店ID）
       - `DATE_FORMAT(Kdrq, '%Y%m') = @Month`（月份，YYYYMM格式）
  
  2. **退款业绩**：
     - 表：`lq_hytk_hytk`（退卡记录表）
     - 字段：`F_ActualRefundAmount`（实际退款金额）
     - 条件：
       - `F_IsEffective = 1`（有效记录）
       - `md = @StoreId`（门店ID）
       - `DATE_FORMAT(tksj, '%Y%m') = @Month`（月份，YYYYMM格式）
  
  ---
  
  ### 2. 产品物料
  
  **计算公式**：
  ```
  产品物料 = 仓库领用金额合计
  ```
  
  **数据来源**：
  - 表：`lq_inventory_usage`（库存使用记录表）
  - 字段：`F_TotalAmount`（合计金额）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `F_StoreId = @StoreId`（门店ID）
    - **特殊规则**：核算11月工资时，算的是10月份的仓库领用
      - 如果计算月份是11月，则查询10月的数据
      - 其他月份正常查询当月数据
  
  **SQL示例**：
  ```sql
  -- 产品物料（特殊规则：11月工资算10月数据）
  SET @QueryMonth = @Month;
  IF @Month = '202411' THEN
      SET @QueryMonth = '202410';
  END IF;
  
  SELECT COALESCE(SUM(F_TotalAmount), 0) as MaterialCost
  FROM lq_inventory_usage
  WHERE F_StoreId = @StoreId
    AND DATE_FORMAT(F_UsageTime, '%Y%m') = @QueryMonth
    AND F_IsEffective = 1
  ```
  
  ---
  
  ### 3. 合作项目成本
  
  **计算公式**：
  ```
  合作项目成本 = 合作成本表合计金额
  ```
  
  **数据来源**：
  - 表：`lq_cooperation_cost`（合作成本表）
  - 字段：`F_TotalAmount`（合计金额）
  - 条件：
    - `F_StoreId = @StoreId`（门店ID）
    - `F_Year = @Year`（年份）
    - `F_Month = @Month`（月份，YYYYMM格式）
    - `F_IsEffective = 1`（有效记录）
  
  ---
  
  ### 4. 店内支出
  
  **计算公式**：
  ```
  店内支出 = 店内支出表合计金额
  ```
  
  **数据来源**：
  - 表：`lq_store_expense`（店内支出表）
  - 字段：`F_Amount`（金额）
  - 条件：
    - `F_StoreId = @StoreId`（门店ID）
    - `DATE_FORMAT(F_ExpenseDate, '%Y%m') = @Month`（月份，YYYYMM格式）
    - `F_IsEffective = 1`（有效记录）
  
  ---
  
  ### 5. 洗毛巾费用
  
  **计算公式**：
  ```
  洗毛巾 = 送洗记录总费用
  ```
  
  **数据来源**：
  - 表：`lq_laundry_flow`（洗毛巾流水表）
  - 字段：`F_TotalPrice`（总费用）
  - 条件：
    - `F_IsEffective = 1`（有效记录）
    - `F_StoreId = @StoreId`（门店ID）
    - `F_FlowType = 0`（只统计送出的记录）
    - `DATE_FORMAT(F_CreateTime, '%Y%m') = @Month`（月份，YYYYMM格式）
  
  ---
  
  ## 🔄 修改方案
  
  ### 1. 数据库字段调整
  
  #### 需要新增的字段
  
  在 `lq_director_salary_statistics` 表中新增以下字段：
  
  ```sql
  -- 销售业绩（开单业绩-退款业绩）
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_SalesPerformance DECIMAL(18,2) DEFAULT 0.00 COMMENT '销售业绩（开单业绩-退款业绩）' AFTER F_StoreRefundPerformance;
  
  -- 产品物料
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_ProductMaterial DECIMAL(18,2) DEFAULT 0.00 COMMENT '产品物料（仓库领用金额）' AFTER F_SalesPerformance;
  
  -- 合作项目成本
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_CooperationCost DECIMAL(18,2) DEFAULT 0.00 COMMENT '合作项目成本' AFTER F_ProductMaterial;
  
  -- 店内支出
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_StoreExpense DECIMAL(18,2) DEFAULT 0.00 COMMENT '店内支出' AFTER F_CooperationCost;
  
  -- 洗毛巾费用
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_LaundryCost DECIMAL(18,2) DEFAULT 0.00 COMMENT '洗毛巾费用' AFTER F_StoreExpense;
  
  -- 毛利
  ALTER TABLE lq_director_salary_statistics 
  ADD COLUMN F_GrossProfit DECIMAL(18,2) DEFAULT 0.00 COMMENT '毛利（销售业绩-产品物料-合作项目成本-店内支出-洗毛巾）' AFTER F_LaundryCost;
  ```
  
  #### 字段说明调整
  
  **F_StoreTotalPerformance** 字段的注释需要修改：
  - **修改前**：门店总业绩（门店开单业绩-门店退卡业绩）
  - **修改后**：门店总业绩（毛利，用于提成计算）
  
  **注意**：`F_StoreTotalPerformance` 字段的值应该存储**毛利**，而不是开单-退卡。
  
  ---
  
  ### 2. 代码逻辑调整
  
  #### 计算流程
  
  1. **计算销售业绩**（开单-退卡）
     ```csharp
     salary.SalesPerformance = billing - refund;
     ```
  
  2. **统计产品物料**（注意11月特殊规则）
     ```csharp
     var queryMonth = monthStr;
     if (month == 11)
     {
         queryMonth = $"{year}10"; // 11月工资算10月数据
     }
     salary.ProductMaterial = productMaterialDict.ContainsKey(storeId) ? productMaterialDict[storeId] : 0;
     ```
  
  3. **统计合作项目成本**
     ```csharp
     salary.CooperationCost = cooperationCostDict.ContainsKey(storeId) ? cooperationCostDict[storeId] : 0;
     ```
  
  4. **统计店内支出**
     ```csharp
     salary.StoreExpense = storeExpenseDict.ContainsKey(storeId) ? storeExpenseDict[storeId] : 0;
     ```
  
  5. **统计洗毛巾费用**（只统计送出的记录）
     ```csharp
     salary.LaundryCost = laundryCostDict.ContainsKey(storeId) ? laundryCostDict[storeId] : 0;
     ```
  
  6. **计算毛利**
     ```csharp
     salary.GrossProfit = salary.SalesPerformance - salary.ProductMaterial - salary.CooperationCost - salary.StoreExpense - salary.LaundryCost;
     ```
  
  7. **将毛利赋值给 F_StoreTotalPerformance**（用于提成计算）
     ```csharp
     salary.StoreTotalPerformance = salary.GrossProfit;
     ```
  
  8. **计算业绩完成率**（基于毛利与生命线比较）
     ```csharp
     if (salary.StoreLifeline > 0)
     {
         salary.PerformanceCompletionRate = salary.GrossProfit / salary.StoreLifeline;
     }
     ```
  
  9. **判断业绩是否达标**（基于毛利）
     ```csharp
     bool performanceReached = salary.GrossProfit >= salary.StoreLifeline;
     ```
  
  10. **计算提成**（基于毛利，使用阶梯提成）
      ```csharp
      CalculateCommission(salary, isNewStore); // 提成计算基于毛利
      ```
  
  ---
  
  ### 3. 提成计算调整
  
  **重要说明**：提成计算需要基于**毛利**，而不是销售业绩。
  
  当前提成计算逻辑（阶梯提成）：
  - ≤生命线部分：根据门店分类使用不同比例（A类2%，B类2.5%，C类3%）
  - >生命线部分：根据门店分类使用不同比例（A类2.5%，B类3%，C类3.5%）
  
  **修改后**：
  - 提成计算基于**毛利**（`salary.GrossProfit`）
  - 业绩完成率判断基于**毛利**与生命线比较
  - 业绩达标判断基于**毛利**是否≥生命线
  
  ---
  
  ## 📝 总结
  
  ### 关键变更点
  
  1. **F_StoreTotalPerformance 字段含义变更**：
     - 原来：开单业绩 - 退卡业绩
     - 现在：毛利（销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾）
  
  2. **需要新增字段**：
     - `F_SalesPerformance`：销售业绩（开单-退卡）
     - `F_ProductMaterial`：产品物料
     - `F_CooperationCost`：合作项目成本
     - `F_StoreExpense`：店内支出
     - `F_LaundryCost`：洗毛巾费用
     - `F_GrossProfit`：毛利
  
  3. **计算逻辑调整**：
     - 先计算销售业绩（开单-退卡）
     - 统计各项成本（产品物料、合作项目成本、店内支出、洗毛巾）
     - 计算毛利
     - 将毛利赋值给 `F_StoreTotalPerformance`（用于提成计算）
     - 基于毛利计算业绩完成率和判断业绩是否达标
     - 基于毛利计算提成
  
  4. **数据查询**：
     - 需要查询 `lq_inventory_usage`（产品物料）
     - 需要查询 `lq_cooperation_cost`（合作项目成本）
     - 需要查询 `lq_store_expense`（店内支出）
     - 需要查询 `lq_laundry_flow`（洗毛巾费用）
  
  ---
  
  ## ⚠️ 注意事项
  
  1. **11月特殊规则**：核算11月工资时，产品物料算的是10月份的数据
  2. **洗毛巾费用**：只统计送出的记录（`F_FlowType = 0`）
  3. **业绩完成率**：基于毛利与生命线比较，不是基于销售业绩
  4. **业绩达标判断**：基于毛利是否≥生命线
  5. **提成计算**：基于毛利，不是基于销售业绩