antissoft / lvqianmeiye_ERP

  # 开单升单逻辑说明文档
  
  ## 概述
  升单是指已经开过会员再次消费的情况。系统会根据当前开单的品项类型和会员历史开单记录，自动判断是否为升单，并标记升单类型。
  
  ## 升单类型字段
  - `F_UpgradeLifeBeauty`：升生美（再次开单时，包含生美品项的订单）
  - `F_UpgradeTechBeauty`：升科美（再次开单时，包含科美品项的订单）
  - `F_UpgradeMedicalBeauty`：升医美（再次开单时，包含医美品项的订单）
  
  ---
  
  ## 升单判断逻辑
  
  ### 1. 升医美（UpgradeMedicalBeauty）
  
  **判断条件**（需同时满足）：
  1. ✅ **当前开单包含医美品项**
     - 检查当前开单的品项明细中，是否有品项分类（`lq_xmzl.qt2`）为"医美"的记录
     
  2. ✅ **之前有医美类型的开单记录**
     - 查询该会员（`kdhy`）在**当前开单之前**的所有有效开单品项明细
     - 筛选条件：
       - `F_IsEffective = 1`（品项明细有效）
       - `ItemCategory = "医美"`（品项分类为医美）
       - `ActualPrice > 0`（实际价格大于0）
       - `Px != "61"`（排除女神卡）
     
  3. ✅ **当前开单的医美品项实付业绩 >= 1000元**
     - 计算当前开单中所有医美品项的 `actualPrice` 总和
     - 必须 >= 1000元
  
  **代码位置**：`LqKdKdjlbService.cs` 第856-864行
  
  **代码逻辑**：
  ```csharp
  //判断升医美：当前开单包含医美品项 + 之前有医美类型的开单记录 + 实付业绩>=1000
  if (hasMedicalItemInCurrentBilling && hasPreviousMedicalBilling && MedicalItemInCurrentBillingAmount >= 1000)
  {
      entity.UpgradeMedicalBeauty = "是";
  }
  else
  {
      entity.UpgradeMedicalBeauty = "否";
  }
  ```
  
  ---
  
  ### 2. 升科美（UpgradeTechBeauty）
  
  **判断条件**（需同时满足）：
  1. ✅ **当前开单包含科美品项**
     - 检查当前开单的品项明细中，是否有品项分类为"科美"的记录
     
  2. ✅ **之前有科美类型的开单记录**
     - 查询该会员在当前开单之前的所有有效开单品项明细
     - 筛选条件：
       - `F_IsEffective = 1`
       - `ItemCategory = "科美"`
       - `ActualPrice > 0`
       - `Px != "61"`（排除女神卡）
  
  **代码位置**：`LqKdKdjlbService.cs` 第866-874行
  
  **代码逻辑**：
  ```csharp
  //判断升科美：当前开单包含科美品项 + 之前有科美类型的开单记录
  if (hasTechItemInCurrentBilling && hasPreviousTechBilling)
  {
      entity.UpgradeTechBeauty = "是";
  }
  else
  {
      entity.UpgradeTechBeauty = "否";
  }
  ```
  
  ---
  
  ### 3. 升生美（UpgradeLifeBeauty）
  
  **判断条件**（需同时满足）：
  1. ✅ **当前开单包含生美品项**
     - 检查当前开单的品项明细中，是否有品项分类为"生美"的记录
     
  2. ✅ **之前有生美类型的开单记录**
     - 查询该会员在当前开单之前的所有有效开单品项明细
     - 筛选条件：
       - `F_IsEffective = 1`
       - `ItemCategory = "生美"`
       - `ActualPrice > 0`
       - `Px != "61"`（排除女神卡）
  
  **代码位置**：`LqKdKdjlbService.cs` 第876-884行
  
  **代码逻辑**：
  ```csharp
  //判断升生美：当前开单包含生美品项 + 之前有生美类型的开单记录
  if (hasLifeItemInCurrentBilling && hasPreviousLifeBilling)
  {
      entity.UpgradeLifeBeauty = "是";
  }
  else
  {
      entity.UpgradeLifeBeauty = "否";
  }
  ```
  
  ---
  
  ## 关键代码位置
  
  ### 新增开单（Create方法）
  - **文件**：`netcore/src/Modularity/Extend/NCC.Extend/LqKdKdjlbService.cs`
  - **方法**：`Create`（第799-884行）
  - **逻辑**：在创建新开单时，自动判断并设置升单类型字段
  
  ### 更新开单（Update方法）
  - **文件**：`netcore/src/Modularity/Extend/NCC.Extend/LqKdKdjlbService.cs`
  - **方法**：`Update`（第1190-1220行）
  - **⚠️ 注意**：Update方法中的升单判断逻辑**存在Bug**（见下方说明）
  
  ### 批量处理历史数据
  - **文件**：`netcore/src/Modularity/Extend/NCC.Extend/LqKdKdjlbService.cs`
  - **方法**：`BatchProcessHistoricalUpgradeTypes`（第4220-4398行）
  - **逻辑**：批量更新历史开单记录的升单类型字段
  
  ---
  
  ## ⚠️ 发现的Bug
  
  ### Update方法中的字段赋值错误
  
  **位置**：`LqKdKdjlbService.cs` 第1192-1220行
  
  **问题**：
  1. **第1195行**：判断升医美，但赋值给了 `UpgradeLifeBeauty`（应该是 `UpgradeMedicalBeauty`）
  2. **第1215行**：判断升生美，但赋值给了 `UpgradeMedicalBeauty`（应该是 `UpgradeLifeBeauty`）
  
  **错误代码**：
  ```csharp
  // 第1192-1200行：判断升医美，但赋值错误
  var isMedicalProject = hasMedicalItemInCurrentBilling && await _db.Queryable<LqKdPxmxEntity>()...
  if (isMedicalProject && MedicalItemInCurrentBillingAmount >= 1000)
  {
      entity.UpgradeLifeBeauty = "是";  // ❌ 错误：应该是 UpgradeMedicalBeauty
  }
  
  // 第1212-1220行：判断升生美，但赋值错误
  var isLifeProject = hasLifeItemInCurrentBilling && await _db.Queryable<LqKdPxmxEntity>()...
  if (isLifeProject)
  {
      entity.UpgradeMedicalBeauty = "是";  // ❌ 错误：应该是 UpgradeLifeBeauty
  }
  ```
  
  **正确代码应该是**：
  ```csharp
  // 升医美
  if (isMedicalProject && MedicalItemInCurrentBillingAmount >= 1000)
  {
      entity.UpgradeMedicalBeauty = "是";  // ✅ 正确
  }
  
  // 升生美
  if (isLifeProject)
  {
      entity.UpgradeLifeBeauty = "是";  // ✅ 正确
  }
  ```
  
  ---
  
  ## 数据来源说明
  
  ### 品项分类获取
  - **表**：`lq_xmzl`（项目资料表）
  - **字段**：`qt2`（品项分类：生美/科美/医美）
  - **关联**：通过 `lq_kd_pxmx.px = lq_xmzl.F_Id` 关联
  
  ### 历史开单记录查询
  - **表**：`lq_kd_pxmx`（开单品项明细表）
  - **筛选条件**：
    - `MemberId = 当前会员ID`
    - `F_IsEffective = 1`（有效）
    - `ItemCategory = 对应类型`（生美/科美/医美）
    - `ActualPrice > 0`（实际价格大于0）
    - `Px != "61"`（排除女神卡）
    - `Glkdbh != 当前开单ID`（排除当前开单本身，仅查询历史记录）
  
  ---
  
  ## 升单判断流程图
  
  ### 升医美流程
  ```
  开始
    ↓
  当前开单是否包含医美品项？
    ↓ 是
  之前是否有医美类型的开单记录？
    ↓ 是
  当前开单医美品项实付业绩 >= 1000元？
    ↓ 是
  标记为：升医美 = "是"
    ↓
  结束
  ```
  
  ### 升科美流程
  ```
  开始
    ↓
  当前开单是否包含科美品项？
    ↓ 是
  之前是否有科美类型的开单记录？
    ↓ 是
  标记为：升科美 = "是"
    ↓
  结束
  ```
  
  ### 升生美流程
  ```
  开始
    ↓
  当前开单是否包含生美品项？
    ↓ 是
  之前是否有生美类型的开单记录？
    ↓ 是
  标记为：升生美 = "是"
    ↓
  结束
  ```
  
  ---
  
  ## 注意事项
  
  1. **升单判断是独立的**：一个开单可以同时标记为升医美、升科美、升生美（如果同时满足条件）
  
  2. **时间顺序很重要**：判断"之前是否有开单记录"时，是基于开单日期（`kdrq`）来判断的，必须是当前开单日期之前的记录
  
  3. **排除女神卡**：所有升单判断都排除品项ID为"61"的女神卡
  
  4. **有效记录**：只统计有效的开单记录和品项明细（`F_IsEffective = 1`）
  
  5. **医美升单特殊要求**：升医美除了需要满足前两个条件外，还需要当前开单的医美品项实付业绩 >= 1000元
  
  ---
  
  ## 修复建议
  
  建议修复 `Update` 方法中的字段赋值错误，确保：
  - 升医美 → 赋值给 `UpgradeMedicalBeauty`
  - 升科美 → 赋值给 `UpgradeTechBeauty`
  - 升生美 → 赋值给 `UpgradeLifeBeauty`