antissoft / lvqianmeiye_ERP

  # 店长工资计算规则梳理
  
  ## 📋 概述
  
  店长工资由以下几个部分组成：
  1. **底薪**：固定4000元，根据考核指标扣款
  2. **提成**：根据门店分类和业绩是否达标，使用不同的提成比例计算（基于毛利）
  
  ---
  
  ## 💰 工资组成规则
  
  ### 1. 底薪规则
  
  **固定底薪**：4000元
  
  #### 老店店长底薪考核
  
  **考核指标**（3个）：
  1. **业绩考核**：门店业绩是否达到门店生命线
  2. **人头考核**：进店消耗人数是否达到目标人头数
  3. **消耗考核**：门店消耗是否达到目标消耗
  
  **扣款规则**：
  - 每个指标未达到：扣除500元
  - 如果3个指标都未达到：扣除1500元（500 × 3）
  
  **计算公式**：
  ```
  底薪 = 4000 - (未达标指标数 × 500)
  ```
  
  #### 新店店长底薪考核
  
  **重要说明**：新店店长涉及全部阶段，都有负奖励机制
  
  **考核指标**（2个）：
  1. **业绩考核**：门店业绩是否达到门店生命线
  2. **人头考核**：进店消耗人数是否达到目标人头数
  
  **扣款规则**：
  - 每个指标未达到：扣除800元
  - 如果2个指标都未达到：扣除1600元（800 × 2）
  
  **计算公式**：
  ```
  底薪 = 4000 - (未达标指标数 × 800)
  ```
  
  **注意**：新店不考核消耗指标
  
  **旗舰店特殊规则**：
  - 旗舰店类型门店需要扣除负奖励800元
  
  ---
  
  ### 2. 提成规则
  
  **提成计算方式**：根据门店分类和业绩是否达标，使用不同的提成比例
  
  **重要说明**：提成计算基于**毛利**，不是门店业绩
  
  #### 老店店长提成规则
  
  根据门店分类（A、B、C类）和业绩是否达标，使用不同的提成比例：
  
  | 门店分类 | 业绩未达标 | 业绩达标 |
  |---------|----------|---------|
  | A类门店 | 3% | 3.5% |
  | B类门店 | 3.5% | 4% |
  | C类门店 | 4% | 4.5% |
  
  **业绩达标判断**：
  - 业绩达标：门店业绩 ≥ 门店生命线
  - 业绩未达标：门店业绩 < 门店生命线
  
  **计算公式**：
  ```
  如果 业绩 ≥ 生命线（业绩达标）：
      提成 = 毛利 × 对应提成比例（业绩达标）
  
  如果 业绩 < 生命线（业绩未达标）：
      提成 = 毛利 × 对应提成比例（业绩未达标）
  ```
  
  **计算示例**：
  
  **示例1：A类门店，业绩未达标**
  - 门店生命线：100,000元
  - 门店业绩：80,000元（未达标）
  - 门店毛利：50,000元
  - 提成比例：3%（业绩未达标）
  - 提成金额 = 50,000 × 3% = 1,500元
  
  **示例2：B类门店，业绩达标**
  - 门店生命线：100,000元
  - 门店业绩：120,000元（达标）
  - 门店毛利：70,000元
  - 提成比例：4%（业绩达标）
  - 提成金额 = 70,000 × 4% = 2,800元
  
  **示例3：C类门店，业绩达标**
  - 门店生命线：100,000元
  - 门店业绩：150,000元（达标）
  - 门店毛利：90,000元
  - 提成比例：4.5%（业绩达标）
  - 提成金额 = 90,000 × 4.5% = 4,050元
  
  #### 新店店长提成规则
  
  **统一标准**（不区分A、B、C类门店）：
  
  | 业绩状态 | 提成比例 |
  |---------|---------|
  | 业绩未达标 | 3% |
  | 业绩达标 | 3.5% |
  
  **计算公式**：
  ```
  如果 业绩 ≥ 生命线（业绩达标）：
      提成 = 毛利 × 3.5%
  
  如果 业绩 < 生命线（业绩未达标）：
      提成 = 毛利 × 3%
  ```
  
  **计算示例**：
  
  **示例1：新店，业绩未达标**
  - 门店生命线：100,000元
  - 门店业绩：80,000元（未达标）
  - 门店毛利：50,000元
  - 提成比例：3%
  - 提成金额 = 50,000 × 3% = 1,500元
  
  **示例2：新店，业绩达标**
  - 门店生命线：100,000元
  - 门店业绩：120,000元（达标）
  - 门店毛利：70,000元
  - 提成比例：3.5%
  - 提成金额 = 70,000 × 3.5% = 2,450元
  
  ---
  
  ## 🔍 数据来源说明
  
  ### 1. 门店业绩
  
  **数据来源**：
  - 开单业绩：`lq_kd_kdjlb` 表
    - 字段：`Djmd`（门店ID）、`Sfyj`（实付业绩）、`Kdrq`（开单日期）
    - 条件：`F_IsEffective = 1`（有效记录）
  - 退卡业绩：`lq_hytk_hytk` 表
    - 字段：`Md`（门店ID）、`F_ActualRefundAmount`（实际退卡金额，优先使用，如果没有则用`Tkje`）、`Tksj`（退卡时间）
    - 条件：`F_IsEffective = 1`（有效记录）
  
  **计算公式**：
  ```
  门店业绩 = SUM(开单实付) - SUM(退卡金额)
  ```
  
  ### 2. 门店毛利
  
  **数据来源**：需要根据业务规则计算门店毛利
  
  **计算公式**：
  ```
  门店毛利 = 门店业绩 - 成本费用
  ```
  
  **注意**：毛利的计算方式需要根据实际业务规则确定，可能包括：
  - 产品成本
  - 其他成本费用
  - 具体计算方式需要确认
  
  ### 3. 门店生命线
  
  **数据来源**：`lq_md_target` 表
  - 字段：`F_StoreLifeline`（门店生命线）
  - 查询条件：`F_StoreId` = 门店ID，`F_Month` = 统计月份（YYYYMM格式）
  
  ### 4. 门店分类
  
  **数据来源**：`lq_mdxx` 表
  - 字段：`F_StoreCategory`（门店分类）
    - `1` = A类门店
    - `2` = B类门店
    - `3` = C类门店
  
  ### 5. 人头数据（进店消耗人数）
  
  **数据来源**：
  - 主表：`lq_xh_hyhk`（耗卡记录表）
  - 关联表：`lq_xh_jksyj`（健康师业绩表，用于判断是否有消费金额）
  
  **统计规则**：
  - 有消费金额的，按门店按月去重客户数
  - 只统计有效记录（`F_IsEffective = 1`）
  - 只统计有消费金额的记录（`jksyj > 0`）
  
  **目标人头数**：
  - 数据来源：`lq_md_target` 表
  - 字段：`F_StoreHeadcountTarget`（门店人头目标）
  
  ### 6. 消耗数据
  
  **数据来源**：`lq_xh_jksyj` 表
  - 字段：`jksyj`（健康师业绩，即消耗金额）
  - 关联：通过 `glkdbh` 关联到 `lq_xh_hyhk.F_Id`
  - 条件：`F_IsEffective = 1`（有效记录）
  
  **统计规则**：
  - 按门店统计当月总消耗金额
  
  **目标消耗**：
  - 数据来源：`lq_md_target` 表
  - 字段：`F_StoreConsumeTarget`（门店消耗目标）
  
  ### 7. 新店信息
  
  **数据来源**：`lq_md_xdbhsj` 表
  - 字段：
    - `Mdid`（门店ID）
    - `Bhkssj`（保护开始时间）
    - `Bhjssj`（保护结束时间）
    - `Sfqy`（是否启用，1=启用）
    - `Stage`（新店保护阶段）
  
  **判断逻辑**：
  - 如果统计月份的第一天在保护期内（`Bhkssj <= startDate && Bhjssj >= startDate`），则为新店
  - 否则为老店
  
  ### 8. 店长员工信息
  
  **数据来源**：`BASE_USER` 表
  - 字段：
    - `F_Id`（员工ID）
    - `F_RealName`（员工姓名）
    - `F_Gw`（岗位，应为"店长"）
    - `F_Mdid`（门店ID）
  
  **查询条件**：
  - `F_Gw = "店长"`
  - `F_DeleteMark = null`（未删除）
  - `F_EnabledMark = 1`（启用）
  
  ### 9. 门店类型（旗舰店）
  
  **数据来源**：`lq_mdxx` 表
  - 字段：`F_StoreType`（门店类型）
  - 判断：如果为旗舰店类型，需要扣除负奖励800元
  
  ---
  
  ## 📝 计算流程
  
  ### 1. 获取基础数据
  
  - 从 `BASE_USER` 获取店长员工列表（岗位为"店长"）
  - 获取门店信息（`lq_mdxx`）
  - 获取门店目标信息（`lq_md_target`）
  - 获取新店保护信息（`lq_md_xdbhsj`）
  
  ### 2. 计算门店业绩
  
  - 统计开单业绩（`lq_kd_kdjlb`）
  - 统计退卡业绩（`lq_hytk_hytk`）
  - 计算门店总业绩 = 开单业绩 - 退卡业绩
  
  ### 3. 计算门店毛利
  
  - 根据业务规则计算门店毛利
  - 毛利 = 门店业绩 - 成本费用
  
  ### 4. 计算门店消耗
  
  - 统计门店当月总消耗金额（`lq_xh_jksyj`）
  
  ### 5. 统计进店消耗人数
  
  - 统计有消费金额的，按门店按月去重客户数
  
  ### 6. 判断新店/老店
  
  - 根据新店保护信息判断是否为新店
  
  ### 7. 判断门店类型
  
  - 判断是否为旗舰店类型（需要扣除负奖励）
  
  ### 8. 计算底薪
  
  - 判断业绩是否达标（业绩 ≥ 生命线）
  - 判断人头是否达标（实际人头 ≥ 目标人头）
  - 判断消耗是否达标（实际消耗 ≥ 目标消耗，仅老店考核）
  - 根据未达标指标数量计算扣款
  - **老店**：底薪 = 4000 - (未达标指标数 × 500)
  - **新店**：底薪 = 4000 - (未达标指标数 × 800)
  - **旗舰店**：底薪 = 底薪 - 800（负奖励）
  
  ### 9. 计算提成
  
  - 判断新店/老店
  - 判断业绩是否达标（业绩 ≥ 生命线）
  - 根据门店分类（老店）和业绩是否达标，确定提成比例
  - 计算提成金额 = 毛利 × 提成比例
  
  ### 10. 计算最终工资
  
  - 最终工资 = 底薪 + 提成
  
  ---
  
  ## ⚠️ 注意事项
  
  ### 1. 数据校验
  
  - 门店分类必须设置（老店），未设置应报错
  - 门店生命线必须设置，未设置应报错
  - 门店人头目标必须设置（用于考核）
  - 门店消耗目标必须设置（老店考核用）
  - 门店毛利必须能够计算，如果无法计算应报错
  
  ### 2. 数据一致性
  
  - 门店业绩计算逻辑必须与其他统计接口保持一致
  - 人头统计逻辑必须与其他统计接口保持一致
  - 消耗统计逻辑必须与其他统计接口保持一致
  - 毛利计算逻辑需要确认
  
  ### 3. 边界情况
  
  - 如果门店没有业绩数据，业绩为0
  - 如果门店没有人头数据，人头为0
  - 如果门店没有消耗数据，消耗为0
  - 如果门店没有毛利数据，毛利为0
  - 新店不考核消耗，只考核业绩和人头
  - 旗舰店需要扣除负奖励800元
  
  ### 4. 提成计算注意事项
  
  - **提成基于毛利**：提成计算必须使用毛利，不是门店业绩
  - **业绩达标判断**：业绩达标是指门店业绩 ≥ 门店生命线
  - **提成比例选择**：根据门店分类（老店）和业绩是否达标，选择对应的提成比例
  
  ### 5. 新店特殊规则
  
  - 新店店长涉及全部阶段，都有负奖励机制
  - 新店不区分门店分类，统一使用相同的提成比例
  - 新店考核扣款金额更高（每个指标800元）
  
  ### 6. 旗舰店特殊规则
  
  - 旗舰店类型门店需要扣除负奖励800元
  - 负奖励在底薪计算后扣除
  
  ---
  
  ## 📋 关键计算公式总结
  
  ### 底薪计算公式
  
  #### 老店店长
  ```
  底薪 = 4000 - (未达标指标数 × 500)
  ```
  
  其中：
  - 未达标指标数 = 未达标的指标数量（业绩、人头、消耗，最多3个）
  
  #### 新店店长
  ```
  底薪 = 4000 - (未达标指标数 × 800)
  ```
  
  其中：
  - 未达标指标数 = 未达标的指标数量（业绩、人头，最多2个）
  
  #### 旗舰店
  ```
  底薪 = 底薪 - 800（负奖励）
  ```
  
  ### 提成计算公式
  
  #### 老店店长提成
  
  **A类门店**：
  ```
  如果 业绩 ≥ 生命线：
      提成 = 毛利 × 3.5%
  否则：
      提成 = 毛利 × 3%
  ```
  
  **B类门店**：
  ```
  如果 业绩 ≥ 生命线：
      提成 = 毛利 × 4%
  否则：
      提成 = 毛利 × 3.5%
  ```
  
  **C类门店**：
  ```
  如果 业绩 ≥ 生命线：
      提成 = 毛利 × 4.5%
  否则：
      提成 = 毛利 × 4%
  ```
  
  #### 新店店长提成
  
  ```
  如果 业绩 ≥ 生命线：
      提成 = 毛利 × 3.5%
  否则：
      提成 = 毛利 × 3%
  ```
  
  ### 最终工资计算公式
  
  ```
  最终工资 = 底薪 + 提成
  ```
  
  ---
  
  ## 📊 完整计算示例
  
  ### 示例1：老店A类店长，业绩达标
  
  **基础数据**：
  - 门店生命线：100,000元
  - 门店业绩：120,000元
  - 门店毛利：80,000元
  - 实际人头：120人
  - 目标人头：100人
  - 实际消耗：60,000元
  - 目标消耗：50,000元
  - 门店分类：A类
  
  **计算过程**：
  
  1. **底薪计算**：
     - 业绩考核：120,000 ≥ 100,000 ✓（达标）
     - 人头考核：120 ≥ 100 ✓（达标）
     - 消耗考核：60,000 ≥ 50,000 ✓（达标）
     - 未达标指标数：0
     - 底薪 = 4000 - (0 × 500) = 4000元
  
  2. **提成计算**：
     - 业绩（120,000）≥ 生命线（100,000），业绩达标
     - A类门店，业绩达标，提成比例：3.5%
     - 提成金额 = 80,000 × 3.5% = 2,800元
  
  3. **最终工资**：
     - 最终工资 = 4000 + 2800 = 6,800元
  
  ### 示例2：老店B类店长，业绩未达标，两个指标未达标
  
  **基础数据**：
  - 门店生命线：100,000元
  - 门店业绩：80,000元
  - 门店毛利：50,000元
  - 实际人头：80人
  - 目标人头：100人
  - 实际消耗：40,000元
  - 目标消耗：50,000元
  - 门店分类：B类
  
  **计算过程**：
  
  1. **底薪计算**：
     - 业绩考核：80,000 < 100,000 ✗（未达标）
     - 人头考核：80 < 100 ✗（未达标）
     - 消耗考核：40,000 < 50,000 ✗（未达标）
     - 未达标指标数：3
     - 底薪 = 4000 - (3 × 500) = 4000 - 1500 = 2,500元
  
  2. **提成计算**：
     - 业绩（80,000）< 生命线（100,000），业绩未达标
     - B类门店，业绩未达标，提成比例：3.5%
     - 提成金额 = 50,000 × 3.5% = 1,750元
  
  3. **最终工资**：
     - 最终工资 = 2500 + 1750 = 4,250元
  
  ### 示例3：新店店长，业绩达标，一个指标未达标
  
  **基础数据**：
  - 门店生命线：100,000元
  - 门店业绩：120,000元
  - 门店毛利：80,000元
  - 实际人头：80人
  - 目标人头：100人
  - 是否新店：是
  
  **计算过程**：
  
  1. **底薪计算**：
     - 业绩考核：120,000 ≥ 100,000 ✓（达标）
     - 人头考核：80 < 100 ✗（未达标）
     - 新店不考核消耗
     - 未达标指标数：1
     - 底薪 = 4000 - (1 × 800) = 4000 - 800 = 3,200元
  
  2. **提成计算**：
     - 业绩（120,000）≥ 生命线（100,000），业绩达标
     - 新店，业绩达标，提成比例：3.5%
     - 提成金额 = 80,000 × 3.5% = 2,800元
  
  3. **最终工资**：
     - 最终工资 = 3200 + 2800 = 6,000元
  
  ### 示例4：新店旗舰店店长，两个指标未达标
  
  **基础数据**：
  - 门店生命线：100,000元
  - 门店业绩：80,000元
  - 门店毛利：50,000元
  - 实际人头：80人
  - 目标人头：100人
  - 是否新店：是
  - 门店类型：旗舰店
  
  **计算过程**：
  
  1. **底薪计算**：
     - 业绩考核：80,000 < 100,000 ✗（未达标）
     - 人头考核：80 < 100 ✗（未达标）
     - 新店不考核消耗
     - 未达标指标数：2
     - 底薪 = 4000 - (2 × 800) = 4000 - 1600 = 2,400元
     - 旗舰店负奖励：2400 - 800 = 1,600元
  
  2. **提成计算**：
     - 业绩（80,000）< 生命线（100,000），业绩未达标
     - 新店，业绩未达标，提成比例：3%
     - 提成金额 = 50,000 × 3% = 1,500元
  
  3. **最终工资**：
     - 最终工资 = 1600 + 1500 = 3,100元
  
  ---
  
  ## 🔄 与主任工资计算的区别
  
  ### 主要区别
  
  | 项目 | 店长 | 主任 |
  |------|------|------|
  | 底薪 | 4000元 | 3500元 |
  | 新店考核扣款 | 每个指标800元 | 每个指标500元 |
  | 老店考核扣款 | 每个指标500元 | 每个指标500元 |
  | 提成计算基础 | 毛利 | 门店业绩 |
  | 提成计算方式 | 单一比例（根据业绩是否达标） | 阶梯提成（根据业绩是否超过生命线） |
  | 老店A类提成比例 | 未达标3%，达标3.5% | ≤生命线2%，>生命线2.5% |
  | 老店B类提成比例 | 未达标3.5%，达标4% | ≤生命线2.5%，>生命线3% |
  | 老店C类提成比例 | 未达标4%，达标4.5% | ≤生命线3%，>生命线3.5% |
  | 新店提成比例 | 未达标3%，达标3.5% | ≤生命线2%，>生命线2.5% |
  | 旗舰店特殊规则 | 扣除负奖励800元 | 无 |
  
  ---
  
  ## ⚠️ 待确认问题
  
  1. **毛利计算方式**：
     - 门店毛利的具体计算方式需要确认
     - 是否包含产品成本、其他成本费用等
     - 是否有现成的毛利数据表或计算逻辑
  
  2. **旗舰店判断**：
     - 如何判断门店是否为旗舰店类型
     - 是否需要从门店表或其他表获取门店类型信息
  
  3. **新店保护阶段**：
     - 新店店长涉及全部阶段，都有负奖励机制
     - 不同阶段的负奖励机制是否需要区分
  
  4. **岗位名称**：
     - 系统中店长岗位的实际名称（可能是"店长"或"主任"）
     - 需要确认代码中使用的岗位名称