antissoft / lvqianmeiye_ERP

  # 仓库费用计算时间字段修改梳理 - 从使用时间改为领取时间
  
  ## 📋 修改目标
  
  将所有使用**使用时间（UsageTime）**进行仓库费用计算的地方，改为使用**领取时间（ReceiveTime）**，并且只统计**已领取（IsReceived = 1）**的记录。
  
  ---
  
  ## 🔍 需要修改的地方
  
  ### 一、薪酬计算相关
  
  #### 1.1 店长工资计算（LqStoreManagerSalaryService.cs）
  
  **文件位置**: `netcore/src/Modularity/Extend/NCC.Extend/LqStoreManagerSalaryService.cs`  
  **方法**: `CalculateStoreManagerSalary`  
  **行数**: 第317-342行
  
  **当前逻辑**:
  ```csharp
  // 1.9 产品物料统计（仓库领用金额，使用上月数据）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          F_StoreId as StoreId,
          COALESCE(SUM(F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage
      WHERE F_IsEffective = 1
          AND DATE_FORMAT(F_UsageTime, '%Y%m') = @queryMonth
      GROUP BY F_StoreId";
  ```
  
  **需要修改为**:
  ```csharp
  // 1.9 产品物料统计（仓库领用金额，使用上月数据，基于领取时间）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          u.F_StoreId as StoreId,
          COALESCE(SUM(u.F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage u
      INNER JOIN lq_inventory_usage_application a ON u.F_UsageBatchId = a.F_UsageBatchId
      WHERE u.F_IsEffective = 1
          AND a.F_IsEffective = 1
          AND a.F_ApprovalStatus = '已通过'
          AND a.F_IsReceived = 1
          AND a.F_ReceiveTime IS NOT NULL
          AND DATE_FORMAT(a.F_ReceiveTime, '%Y%m') = @queryMonth
      GROUP BY u.F_StoreId";
  ```
  
  **影响**: 店长工资计算中的产品物料（用于毛利计算）
  
  ---
  
  #### 1.2 主任工资计算（LqDirectorSalaryService.cs）
  
  **文件位置**: `netcore/src/Modularity/Extend/NCC.Extend/LqDirectorSalaryService.cs`  
  **方法**: `CalculateDirectorSalary`  
  **行数**: 第363-388行
  
  **当前逻辑**:
  ```csharp
  // 1.9 产品物料统计（仓库领用金额，使用上月数据）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          F_StoreId as StoreId,
          COALESCE(SUM(F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage
      WHERE F_IsEffective = 1
          AND DATE_FORMAT(F_UsageTime, '%Y%m') = @queryMonth
      GROUP BY F_StoreId";
  ```
  
  **需要修改为**:
  ```csharp
  // 1.9 产品物料统计（仓库领用金额，使用上月数据，基于领取时间）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          u.F_StoreId as StoreId,
          COALESCE(SUM(u.F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage u
      INNER JOIN lq_inventory_usage_application a ON u.F_UsageBatchId = a.F_UsageBatchId
      WHERE u.F_IsEffective = 1
          AND a.F_IsEffective = 1
          AND a.F_ApprovalStatus = '已通过'
          AND a.F_IsReceived = 1
          AND a.F_ReceiveTime IS NOT NULL
          AND DATE_FORMAT(a.F_ReceiveTime, '%Y%m') = @queryMonth
      GROUP BY u.F_StoreId";
  ```
  
  **影响**: 主任工资计算中的产品物料（用于毛利计算）
  
  ---
  
  #### 1.3 事业部总经理/经理工资计算（LqBusinessUnitManagerSalaryService.cs）
  
  **文件位置**: `netcore/src/Modularity/Extend/NCC.Extend/LqBusinessUnitManagerSalaryService.cs`  
  **方法**: `CalculateBusinessUnitManagerSalary`  
  **行数**: 第275-300行
  
  **当前逻辑**:
  ```csharp
  // 1.7 产品物料统计（仓库领用金额，使用上月数据）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          F_StoreId as StoreId,
          COALESCE(SUM(F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage
      WHERE F_IsEffective = 1
          AND DATE_FORMAT(F_UsageTime, '%Y%m') = @queryMonth
      GROUP BY F_StoreId";
  ```
  
  **需要修改为**:
  ```csharp
  // 1.7 产品物料统计（仓库领用金额，使用上月数据，基于领取时间）
  var queryMonth = monthStr;
  if (month == 1)
  {
      queryMonth = $"{year - 1}12";
  }
  else
  {
      queryMonth = $"{year}{(month - 1):D2}";
  }
  var productMaterialSql = $@"
      SELECT 
          u.F_StoreId as StoreId,
          COALESCE(SUM(u.F_TotalAmount), 0) as MaterialAmount
      FROM lq_inventory_usage u
      INNER JOIN lq_inventory_usage_application a ON u.F_UsageBatchId = a.F_UsageBatchId
      WHERE u.F_IsEffective = 1
          AND a.F_IsEffective = 1
          AND a.F_ApprovalStatus = '已通过'
          AND a.F_IsReceived = 1
          AND a.F_ReceiveTime IS NOT NULL
          AND DATE_FORMAT(a.F_ReceiveTime, '%Y%m') = @queryMonth
      GROUP BY u.F_StoreId";
  ```
  
  **影响**: 事业部总经理/经理工资计算中的产品物料（用于毛利计算）
  
  ---
  
  ### 二、股份统计相关
  
  #### 2.1 门店股份统计 - 产品成本（LqShareStatisticsStoreService.cs）
  
  **文件位置**: `netcore/src/Modularity/Extend/NCC.Extend/LqShareStatisticsStoreService.cs`  
  **方法**: `CalculateCost`  
  **行数**: 第323-326行
  
  **当前逻辑**:
  ```csharp
  // 1. 产品成本 = 仓库领用金额
  entity.CostProduct = await _db.Queryable<LqInventoryUsageEntity>()
      .Where(x => x.StoreId == entity.StoreId 
          && x.UsageTime >= startDate 
          && x.UsageTime <= endDate 
          && x.IsEffective == 1)
      .SumAsync(x => x.TotalAmount);
  ```
  
  **需要修改为**:
  ```csharp
  // 1. 产品成本 = 仓库领用金额（基于领取时间，只统计已领取的记录）
  entity.CostProduct = await _db.Queryable<LqInventoryUsageEntity, LqInventoryUsageApplicationEntity>(
          (u, a) => u.UsageBatchId == a.UsageBatchId)
      .Where((u, a) => u.StoreId == entity.StoreId
          && u.IsEffective == 1
          && a.IsEffective == 1
          && a.ApprovalStatus == "已通过"
          && a.IsReceived == 1
          && a.ReceiveTime.HasValue
          && a.ReceiveTime.Value >= startDate
          && a.ReceiveTime.Value <= endDate)
      .SumAsync((u, a) => u.TotalAmount);
  ```
  
  **影响**: 门店股份统计中的产品成本
  
  ---
  
  #### 2.2 门店股份统计 - 福田成本（LqShareStatisticsStoreService.cs）
  
  **文件位置**: `netcore/src/Modularity/Extend/NCC.Extend/LqShareStatisticsStoreService.cs`  
  **方法**: `CalculateCost`  
  **行数**: 第328-344行
  
  **当前逻辑**:
  ```csharp
  // 2. 福田成本 = 福田仓库领用（上一个月的成本）
  var prevMonthStart = startDate.AddMonths(-1);
  var prevMonthEnd = startDate.AddDays(-1);
  
  entity.CostFutian = await _db.Queryable<LqInventoryUsageEntity, LqProductEntity, LqInventoryUsageApplicationEntity>(
          (u, p, a) => new JoinQueryInfos(
              JoinType.Inner, u.ProductId == p.Id,
              JoinType.Inner, u.UsageBatchId == a.UsageBatchId))
      .Where((u, p, a) => p.Warehouse == "福田仓库"
          && u.StoreId == entity.StoreId
          && u.UsageTime >= prevMonthStart && u.UsageTime <= prevMonthEnd
          && u.IsEffective == 1
          && a.IsEffective == 1
          && a.ApprovalStatus == "已通过"
          && a.IsReceived == 1)
      .SumAsync((u, p, a) => u.TotalAmount);
  ```
  
  **需要修改为**:
  ```csharp
  // 2. 福田成本 = 福田仓库领用（上一个月的成本，基于领取时间）
  var prevMonthStart = startDate.AddMonths(-1);
  var prevMonthEnd = startDate.AddDays(-1);
  
  entity.CostFutian = await _db.Queryable<LqInventoryUsageEntity, LqProductEntity, LqInventoryUsageApplicationEntity>(
          (u, p, a) => new JoinQueryInfos(
              JoinType.Inner, u.ProductId == p.Id,
              JoinType.Inner, u.UsageBatchId == a.UsageBatchId))
      .Where((u, p, a) => p.Warehouse == "福田仓库"
          && u.StoreId == entity.StoreId
          && u.IsEffective == 1
          && a.IsEffective == 1
          && a.ApprovalStatus == "已通过"
          && a.IsReceived == 1
          && a.ReceiveTime.HasValue
          && a.ReceiveTime.Value >= prevMonthStart 
          && a.ReceiveTime.Value <= prevMonthEnd)
      .SumAsync((u, p, a) => u.TotalAmount);
  ```
  
  **影响**: 门店股份统计中的福田成本
  
  **注意**: 这个已经关联了申请表，但使用的是 `UsageTime`，需要改为 `ReceiveTime`
  
  ---
  
  ## 📊 数据关联关系
  
  ### 表结构关系
  
  ```
  lq_inventory_usage (使用记录表)
  ├── F_UsageBatchId (使用批次ID)
  └── F_TotalAmount (合计金额)
  
  lq_inventory_usage_application (申请表)
  ├── F_UsageBatchId (使用批次ID) ← 关联字段
  ├── F_IsReceived (是否已领取: 1-已领取, 0-未领取)
  ├── F_ReceiveTime (领取时间)
  └── F_ApprovalStatus (审批状态: "已通过")
  ```
  
  ### 关联逻辑
  
  - **使用记录表** (`lq_inventory_usage`) 通过 `F_UsageBatchId` 关联 **申请表** (`lq_inventory_usage_application`)
  - **领取时间** (`F_ReceiveTime`) 在申请表中
  - **是否已领取** (`F_IsReceived`) 在申请表中
  
  ---
  
  ## 🔧 修改要点
  
  ### 1. SQL查询修改要点
  
  **原查询**:
  ```sql
  FROM lq_inventory_usage
  WHERE F_IsEffective = 1
      AND DATE_FORMAT(F_UsageTime, '%Y%m') = @queryMonth
  ```
  
  **新查询**:
  ```sql
  FROM lq_inventory_usage u
  INNER JOIN lq_inventory_usage_application a ON u.F_UsageBatchId = a.F_UsageBatchId
  WHERE u.F_IsEffective = 1
      AND a.F_IsEffective = 1
      AND a.F_ApprovalStatus = '已通过'
      AND a.F_IsReceived = 1
      AND a.F_ReceiveTime IS NOT NULL
      AND DATE_FORMAT(a.F_ReceiveTime, '%Y%m') = @queryMonth
  ```
  
  ### 2. ORM查询修改要点
  
  **原查询**:
  ```csharp
  await _db.Queryable<LqInventoryUsageEntity>()
      .Where(x => x.StoreId == storeId 
          && x.UsageTime >= startDate 
          && x.UsageTime <= endDate 
          && x.IsEffective == 1)
      .SumAsync(x => x.TotalAmount);
  ```
  
  **新查询**:
  ```csharp
  await _db.Queryable<LqInventoryUsageEntity, LqInventoryUsageApplicationEntity>(
          (u, a) => u.UsageBatchId == a.UsageBatchId)
      .Where((u, a) => u.StoreId == storeId
          && u.IsEffective == 1
          && a.IsEffective == 1
          && a.ApprovalStatus == "已通过"
          && a.IsReceived == 1
          && a.ReceiveTime.HasValue
          && a.ReceiveTime.Value >= startDate
          && a.ReceiveTime.Value <= endDate)
      .SumAsync((u, a) => u.TotalAmount);
  ```
  
  ---
  
  ## 📝 修改清单
  
  ### 薪酬计算（3处）
  
  | 序号 | 文件 | 方法 | 行数 | 说明 |
  |------|------|------|------|------|
  | 1 | `LqStoreManagerSalaryService.cs` | `CalculateStoreManagerSalary` | 330-337 | 店长工资 - 产品物料计算 |
  | 2 | `LqDirectorSalaryService.cs` | `CalculateDirectorSalary` | 376-383 | 主任工资 - 产品物料计算 |
  | 3 | `LqBusinessUnitManagerSalaryService.cs` | `CalculateBusinessUnitManagerSalary` | 288-295 | 事业部总经理/经理工资 - 产品物料计算 |
  
  ### 股份统计（2处）
  
  | 序号 | 文件 | 方法 | 行数 | 说明 |
  |------|------|------|------|------|
  | 4 | `LqShareStatisticsStoreService.cs` | `CalculateCost` | 324-326 | 门店股份统计 - 产品成本 |
  | 5 | `LqShareStatisticsStoreService.cs` | `CalculateCost` | 334-344 | 门店股份统计 - 福田成本 |
  
  ---
  
  ## ⚠️ 注意事项
  
  ### 1. 数据完整性
  
  - 确保所有使用记录都有对应的申请记录（通过 `UsageBatchId` 关联）
  - 如果使用记录没有对应的申请记录，这些记录将不会被统计（符合"未领取不计算"的要求）
  
  ### 2. 时间规则保持不变
  
  - **薪酬计算**: 仍然使用上月数据（计算12月工资，使用11月的领取时间数据）
  - **股份统计**: 
    - 产品成本：使用当月数据（基于领取时间）
    - 福田成本：使用上月数据（基于领取时间）
  
  ### 3. 筛选条件
  
  必须同时满足以下条件：
  - ✅ 使用记录有效 (`u.F_IsEffective = 1`)
  - ✅ 申请记录有效 (`a.F_IsEffective = 1`)
  - ✅ 审批状态为"已通过" (`a.F_ApprovalStatus = '已通过'`)
  - ✅ 已领取 (`a.F_IsReceived = 1`)
  - ✅ 领取时间不为空 (`a.F_ReceiveTime IS NOT NULL`)
  - ✅ 领取时间在指定月份范围内
  
  ### 4. 旧数据处理
  
  - 对于没有申请记录的历史数据（旧数据），将不会被统计
  - 这是符合业务逻辑的：如果没有领取，就不应该计入成本
  
  ---
  
  ## 🧪 测试建议
  
  ### 1. 单元测试
  
  - 测试已领取的记录是否被正确统计
  - 测试未领取的记录是否被排除
  - 测试审批未通过的记录是否被排除
  - 测试领取时间为空的记录是否被排除
  - 测试时间范围筛选是否正确
  
  ### 2. 集成测试
  
  - 测试店长工资计算：产品物料是否正确
  - 测试主任工资计算：产品物料是否正确
  - 测试事业部总经理/经理工资计算：产品物料是否正确
  - 测试门店股份统计：产品成本和福田成本是否正确
  
  ### 3. 数据验证
  
  - 对比修改前后的计算结果
  - 验证只有已领取的记录被统计
  - 验证时间筛选基于领取时间而不是使用时间
  
  ---
  
  ## 📋 修改步骤
  
  1. **修改店长工资计算** (`LqStoreManagerSalaryService.cs`)
  2. **修改主任工资计算** (`LqDirectorSalaryService.cs`)
  3. **修改事业部总经理/经理工资计算** (`LqBusinessUnitManagerSalaryService.cs`)
  4. **修改门店股份统计 - 产品成本** (`LqShareStatisticsStoreService.cs`)
  5. **修改门店股份统计 - 福田成本** (`LqShareStatisticsStoreService.cs`)
  6. **测试验证**
  7. **更新相关文档**
  
  ---
  
  **文档版本**: v1.0  
  **创建日期**: 2026-01-09  
  **适用范围**: 仓库费用计算时间字段修改