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元
  - 判断方式：`lq_mdxx.F_StoreType = 2`（StoreTypeEnum.旗舰店）
  
  ---
  
  ### 2. 提成规则
  
  **提成计算方式**：根据门店分类和业绩是否达标，使用不同的提成比例
  
  **重要说明**：提成计算基于**毛利**，不是门店业绩
  
  #### 老店店长提成规则
  
  根据门店分类（A、B、C类）和业绩是否达标，使用不同的提成比例：
  
  | 门店分类 | 业绩未达标 | 业绩达标 |
  |---------|----------|---------|
  | A类门店 | 3% | 3.5% |
  | B类门店 | 3.5% | 4% |
  | C类门店 | 4% | 4.5% |
  
  **业绩达标判断**：
  - 业绩达标：门店业绩 ≥ 门店生命线
  - 业绩未达标：门店业绩 < 门店生命线
  
  **计算公式**：
  ```
  如果 业绩 ≥ 生命线（业绩达标）：
      提成 = 毛利 × 对应提成比例（业绩达标）
  
  如果 业绩 < 生命线（业绩未达标）：
      提成 = 毛利 × 对应提成比例（业绩未达标）
  ```
  
  #### 新店店长提成规则
  
  **提成比例**（不区分门店分类）：
  - 业绩未达标：3%
  - 业绩达标：3.5%
  
  **计算公式**：
  ```
  如果 业绩 ≥ 生命线（业绩达标）：
      提成 = 毛利 × 3.5%
  
  如果 业绩 < 生命线（业绩未达标）：
      提成 = 毛利 × 3%
  ```
  
  ---
  
  ## 📊 毛利计算公式
  
  **核心公式**：
  ```
  毛利 = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾
  ```
  
  ### 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格式）
  
  **SQL示例**：
  ```sql
  -- 开单业绩
  SELECT COALESCE(SUM(sfyj), 0) as BillingPerformance
  FROM lq_kd_kdjlb
  WHERE Djmd = @StoreId
    AND DATE_FORMAT(Kdrq, '%Y%m') = @Month
    AND F_IsEffective = 1
  
  -- 退款业绩
  SELECT COALESCE(SUM(F_ActualRefundAmount), 0) as RefundPerformance
  FROM lq_hytk_hytk
  WHERE md = @StoreId
    AND DATE_FORMAT(tksj, '%Y%m') = @Month
    AND F_IsEffective = 1
  
  -- 销售业绩
  销售业绩 = 开单业绩 - 退款业绩
  ```
  
  ---
  
  ### 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格式）
  
  **表结构设计**：
  ```sql
  CREATE TABLE IF NOT EXISTS `lq_cooperation_cost` (
    `F_Id` VARCHAR(50) NOT NULL COMMENT '主键ID',
    `F_StoreId` VARCHAR(50) NOT NULL COMMENT '门店ID（关联lq_mdxx.F_Id）',
    `F_StoreName` VARCHAR(200) NULL COMMENT '门店名称',
    `F_Year` INT NOT NULL COMMENT '年份',
    `F_Month` VARCHAR(6) NOT NULL COMMENT '月份（YYYYMM格式）',
    `F_TotalAmount` DECIMAL(18,2) DEFAULT 0.00 COMMENT '合计金额',
    `F_Remarks` VARCHAR(1000) NULL COMMENT '备注说明',
    `F_IsEffective` INT DEFAULT 1 COMMENT '是否有效（1:有效 0:无效）',
    `F_CreateUser` VARCHAR(50) NULL COMMENT '创建人ID',
    `F_CreateTime` DATETIME NULL COMMENT '创建时间',
    `F_UpdateUser` VARCHAR(50) NULL COMMENT '更新人ID',
    `F_UpdateTime` DATETIME NULL COMMENT '更新时间',
    PRIMARY KEY (`F_Id`),
    KEY `idx_store_month` (`F_StoreId`, `F_Year`, `F_Month`),
    KEY `idx_month` (`F_Year`, `F_Month`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='合作成本表';
  ```
  
  **功能要求**：
  - 支持按门店、年份、月份查询
  - 支持导入功能（Excel导入）
  - 支持增删改查操作
  
  ---
  
  ### 4. 店内支出
  
  **计算公式**：
  ```
  店内支出 = 店内支出表合计金额
  ```
  
  **数据来源**：
  - 表：`lq_store_expense`（店内支出表）**需要新建**
  - 字段：`F_Amount`（金额）
  - 条件：
    - `F_StoreId = @StoreId`（门店ID）
    - `DATE_FORMAT(F_ExpenseDate, '%Y%m') = @Month`（月份，YYYYMM格式）
    - `F_IsEffective = 1`（有效记录）
  
  **业务流程**：
  1. 从报销表导出本月审核通过的报销表明细
     - 表：`lq_reimbursement_application`（报销申请表）
     - 关联表：`lq_purchase_records`（购买记录表）
     - 条件：
       - `F_ApprovalStatus = '已通过'`（审批状态）
       - `F_ApplicationStoreId = @StoreId`（门店ID）
       - `DATE_FORMAT(F_ApplicationTime, '%Y%m') = @Month`（月份）
  2. 线下重新整理明细（可能调整金额、分类等）
  3. 导入到店内支出表 `lq_store_expense`
  
  **表结构设计**（参考购买记录表结构）：
  ```sql
  CREATE TABLE IF NOT EXISTS `lq_store_expense` (
    `F_Id` VARCHAR(50) NOT NULL COMMENT '主键ID',
    `F_StoreId` VARCHAR(50) NOT NULL COMMENT '门店ID（关联lq_mdxx.F_Id）',
    `F_StoreName` VARCHAR(200) NULL COMMENT '门店名称',
    `F_ExpenseCategoryId` VARCHAR(50) NULL COMMENT '支出分类ID（关联lq_reimbursement_category.F_Id）',
    `F_ExpenseCategoryName` VARCHAR(200) NULL COMMENT '支出分类名称',
    `F_ExpenseDate` DATETIME NOT NULL COMMENT '支出日期',
    `F_UnitPrice` DECIMAL(18,2) DEFAULT 0.00 COMMENT '单价',
    `F_Quantity` INT DEFAULT 0 COMMENT '数量',
    `F_Amount` DECIMAL(18,2) DEFAULT 0.00 COMMENT '金额',
    `F_Memo` VARCHAR(1000) NULL COMMENT '备注说明',
    `F_Attachment` TEXT NULL COMMENT '附件（JSON格式）',
    `F_RelatedReimbursementId` VARCHAR(50) NULL COMMENT '关联报销申请ID（可选）',
    `F_RelatedPurchaseRecordId` VARCHAR(50) NULL COMMENT '关联购买记录ID（可选）',
    `F_IsEffective` INT DEFAULT 1 COMMENT '是否有效（1:有效 0:无效）',
    `F_CreateUser` VARCHAR(50) NULL COMMENT '创建人ID',
    `F_CreateTime` DATETIME NULL COMMENT '创建时间',
    `F_UpdateUser` VARCHAR(50) NULL COMMENT '更新人ID',
    `F_UpdateTime` DATETIME NULL COMMENT '更新时间',
    PRIMARY KEY (`F_Id`),
    KEY `idx_store_date` (`F_StoreId`, `F_ExpenseDate`),
    KEY `idx_expense_date` (`F_ExpenseDate`),
    KEY `idx_category` (`F_ExpenseCategoryId`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='店内支出表';
  ```
  
  **功能要求**：
  - 支持按门店、月份查询
  - 支持导出报销表明细（用于线下整理）
  - 支持导入功能（Excel导入）
  - 支持增删改查操作
  
  ---
  
  ### 5. 洗毛巾
  
  **计算公式**：
  ```
  洗毛巾 = 送洗记录总费用
  ```
  
  **数据来源**：
  - 表：`lq_laundry_flow`（清洗流水表）
  - 字段：`F_TotalPrice`（总费用）
  - 条件：
    - `F_FlowType = 0`（流水类型：送出）
    - `F_StoreId = @StoreId`（门店ID）
    - `DATE_FORMAT(F_CreateTime, '%Y%m') = @Month`（月份，YYYYMM格式）
    - `F_IsEffective = 1`（有效记录）
  
  **重要说明**：
  - 只要送出就产生金额（不管是否送回）
  - 只统计 `F_FlowType = 0`（送出）的记录
  
  **SQL示例**：
  ```sql
  SELECT COALESCE(SUM(F_TotalPrice), 0) as LaundryCost
  FROM lq_laundry_flow
  WHERE F_StoreId = @StoreId
    AND F_FlowType = 0
    AND DATE_FORMAT(F_CreateTime, '%Y%m') = @Month
    AND F_IsEffective = 1
  ```
  
  ---
  
  ## 🔍 其他重要规则
  
  ### 1. 旗舰店判断
  
  **判断方式**：
  - 表：`lq_mdxx`（门店信息表）
  - 字段：`F_StoreType`（门店类型）
  - 枚举值：
    - `1` = 门店200平（StoreTypeEnum.门店200平）
    - `2` = 旗舰店（StoreTypeEnum.旗舰店）
  
  **代码实现**：
  ```csharp
  // 判断是否为旗舰店
  bool isFlagshipStore = store.StoreType == (int)StoreTypeEnum.旗舰店;
  ```
  
  **特殊规则**：
  - 旗舰店类型门店需要扣除负奖励800元
  
  ---
  
  ### 2. 新店店长
  
  **重要说明**：
  - 新店店长所有阶段都有负奖励
  - 新店判断逻辑：需要根据门店开业时间或新店保护期判断（参考其他工资计算服务）
  
  ---
  
  ### 3. 店长岗位名称
  
  **系统标识**：
  - 岗位名称：`"店长"`
  - 查询条件：`BASE_USER.F_ZW = "店长"` 或 `BASE_USER.F_GW = "店长"`
  
  ---
  
  ## 📋 数据来源总结
  
  ### 核心数据表
  
  1. **门店信息表** (`lq_mdxx`)
     - `F_Id`：门店ID
     - `F_StoreType`：门店类型（判断旗舰店）
     - `F_StoreCategory`：门店分类（A、B、C类）
  
  2. **门店目标表** (`lq_md_target`)
     - `F_StoreId`：门店ID
     - `F_Month`：月份（YYYYMM格式）
     - `F_StoreLifeline`：门店生命线
     - `F_HeadcountTarget`：目标人头数
     - `F_ConsumeTarget`：目标消耗
  
  3. **开单记录表** (`lq_kd_kdjlb`)
     - `sfyj`：实付业绩（开单业绩）
     - `Djmd`：门店ID
     - `Kdrq`：开单日期
  
  4. **退卡记录表** (`lq_hytk_hytk`)
     - `F_ActualRefundAmount`：实际退款金额（退款业绩）
     - `md`：门店ID
     - `tksj`：退卡时间
  
  5. **库存使用记录表** (`lq_inventory_usage`)
     - `F_TotalAmount`：合计金额（产品物料）
     - `F_StoreId`：门店ID
     - `F_UsageTime`：使用时间
  
  6. **合作成本表** (`lq_cooperation_cost`) **需要新建**
     - `F_TotalAmount`：合计金额
     - `F_StoreId`：门店ID
     - `F_Year`：年份
     - `F_Month`：月份
  
  7. **店内支出表** (`lq_store_expense`) **需要新建**
     - `F_Amount`：金额
     - `F_StoreId`：门店ID
     - `F_ExpenseDate`：支出日期
  
  8. **清洗流水表** (`lq_laundry_flow`)
     - `F_TotalPrice`：总费用（洗毛巾）
     - `F_StoreId`：门店ID
     - `F_FlowType`：流水类型（0=送出）
  
  9. **耗卡记录表** (`lq_xh_hyhk`)
     - 用于统计进店消耗人数
  
  10. **系统用户表** (`BASE_USER`)
      - `F_REALNAME`：姓名
      - `F_ZW`：职位（店长）
      - `F_MDID`：门店ID
  
  ---
  
  ## 🚀 需要先实现的功能
  
  ### 第一阶段：基础数据表
  
  #### 1. 合作成本表 (`lq_cooperation_cost`)
  
  **功能清单**：
  - [ ] 创建表结构（SQL）
  - [ ] 创建实体类 (`LqCooperationCostEntity`)
  - [ ] 创建DTO类（输入/输出）
  - [ ] 创建Service类 (`LqCooperationCostService`)
  - [ ] 实现CRUD接口
  - [ ] 实现导入功能（Excel导入）
  - [ ] 实现查询接口（按门店、年份、月份）
  
  **优先级**：高（毛利计算必需）
  
  ---
  
  #### 2. 店内支出表 (`lq_store_expense`)
  
  **功能清单**：
  - [ ] 创建表结构（SQL）
  - [ ] 创建实体类 (`LqStoreExpenseEntity`)
  - [ ] 创建DTO类（输入/输出）
  - [ ] 创建Service类 (`LqStoreExpenseService`)
  - [ ] 实现CRUD接口
  - [ ] 实现导出功能（导出报销表明细）
  - [ ] 实现导入功能（Excel导入）
  - [ ] 实现查询接口（按门店、月份）
  
  **优先级**：高（毛利计算必需）
  
  ---
  
  ### 第二阶段：数据查询接口
  
  #### 3. 毛利计算接口
  
  **功能清单**：
  - [ ] 实现销售业绩查询（开单业绩 - 退款业绩）
  - [ ] 实现产品物料查询（仓库领用金额，特殊规则：11月算10月）
  - [ ] 实现合作项目成本查询
  - [ ] 实现店内支出查询
  - [ ] 实现洗毛巾查询
  - [ ] 实现毛利汇总计算接口
  
  **优先级**：高（工资计算必需）
  
  ---
  
  ### 第三阶段：工资计算
  
  #### 4. 店长工资计算服务
  
  **功能清单**：
  - [ ] 实现底薪计算（老店/新店，旗舰店特殊规则）
  - [ ] 实现提成计算（基于毛利，老店/新店不同规则）
  - [ ] 实现考核指标判断（业绩、人头、消耗）
  - [ ] 实现新店判断逻辑
  - [ ] 实现旗舰店判断逻辑
  - [ ] 实现完整工资计算接口
  
  **优先级**：中（依赖第一阶段和第二阶段）
  
  ---
  
  ## 📝 实现顺序建议
  
  ### 步骤1：创建合作成本表
  1. 编写SQL创建表结构
  2. 创建实体类、DTO、Service
  3. 实现CRUD接口
  4. 实现导入功能
  
  ### 步骤2：创建店内支出表
  1. 编写SQL创建表结构
  2. 创建实体类、DTO、Service
  3. 实现CRUD接口
  4. 实现导出报销表明细功能
  5. 实现导入功能
  
  ### 步骤3：实现毛利计算接口
  1. 实现销售业绩查询
  2. 实现产品物料查询（注意11月特殊规则）
  3. 实现合作项目成本查询
  4. 实现店内支出查询
  5. 实现洗毛巾查询
  6. 实现毛利汇总计算
  
  ### 步骤4：实现店长工资计算
  1. 实现底薪计算逻辑
  2. 实现提成计算逻辑
  3. 实现考核指标判断
  4. 实现完整工资计算接口
  5. 编写测试用例验证
  
  ---
  
  ## ⚠️ 注意事项
  
  1. **产品物料特殊规则**：
     - 核算11月工资时，算的是10月份的仓库领用
     - 需要在查询时特殊处理
  
  2. **店内支出流程**：
     - 必须先导出报销表明细
     - 线下整理后再导入
     - 不是直接从报销表计算
  
  3. **洗毛巾计算**：
     - 只要送出就产生金额
     - 只统计 `F_FlowType = 0`（送出）的记录
  
  4. **旗舰店判断**：
     - 使用 `F_StoreType = 2` 判断
     - 需要扣除负奖励800元
  
  5. **新店店长**：
     - 所有阶段都有负奖励
     - 需要确认新店判断逻辑
  
  6. **数据一致性**：
     - 所有金额计算保留2位小数
     - 确保月份格式统一（YYYYMM）
  
  ---
  
  ## 📌 待确认问题
  
  1. **新店判断逻辑**：
     - 如何判断门店是否为新店？
     - 是否有新店保护期字段？
     - 参考其他工资计算服务的实现
  
  2. **合作成本导入格式**：
     - Excel导入的字段格式要求
     - 是否需要校验门店ID、年份、月份
  
  3. **店内支出导入格式**：
     - Excel导入的字段格式要求
     - 是否需要关联报销申请ID
  
  4. **毛利计算精度**：
     - 各组成部分的精度要求
     - 最终毛利的精度要求
  
  ---
  
  ## 🔗 相关代码位置
  
  - **门店信息查询**：`LqMdxxService.cs`
  - **门店分类枚举**：`StoreCategoryEnum.cs`
  - **门店类型枚举**：`StoreTypeEnum.cs`
  - **门店实体类**：`LqMdxxEntity.cs`
  - **库存使用服务**：`LqInventoryUsageService.cs`
  - **清洗流水服务**：`LqLaundryFlowService.cs`
  - **报销申请服务**：`LqReimbursementApplicationService.cs`
  - **购买记录服务**：`LqPurchaseRecordsService.cs`
  - **其他工资计算服务**：`LqAssistantSalaryService.cs`、`LqDirectorSalaryService.cs`（参考新店判断逻辑）