# 消耗功能加班需求分析与设计方案

## 一、需求分析

### 核心需求
1. **加班标识**：标识消耗单是否是加班单
2. **加班系数**：记录加班系数（如 0.5、1、1.5 等）
3. **数据计算**：消耗单的项目数和手工费需要加上对应的系数
4. **数据保留**：保留原始数据、加班数据、最终数据

### 影响范围
- **项目数**：影响 `lq_xh_pxmx.F_ProjectNumber`（品项明细项目次数）
- **手工费**：影响 `lq_xh_hyhk.sgfy`（耗卡主表手工费用）和 `lq_xh_jksyj.F_LaborCost`（健康师业绩手工费）、`lq_xh_kjbsyj.F_LaborCost`（科技部老师业绩手工费）

## 二、当前表结构分析

### 1. lq_xh_hyhk（耗卡主表）
- `xfje` - 消费金额（decimal）
- `sgfy` - 手工费用（decimal）**← 需要记录原始值、加班计算值、最终值**
- `hksj` - 耗卡时间

### 2. lq_xh_pxmx（耗卡品项明细表）
- `F_ProjectNumber` - 项目次数（int）**← 需要记录原始值、加班计算值、最终值**
- `F_TotalPrice` - 合计金额（decimal）
- `pxjg` - 品项价格（decimal）

### 3. lq_xh_jksyj（耗卡健康师业绩表）
- `F_kdpxNumber` - 耗卡品项次数（decimal）**← 需要记录原始值、加班计算值、最终值**
- `F_LaborCost` - 手工费（decimal）**← 需要记录原始值、加班计算值、最终值**
- `jksyj` - 健康师业绩（decimal）

### 4. lq_xh_kjbsyj（耗卡科技部老师业绩表）
- `F_hdpxNumber` - 耗卡品相次数（decimal）**← 需要记录原始值、加班计算值、最终值**
- `F_LaborCost` - 手工费（decimal）**← 需要记录原始值、加班计算值、最终值**
- `kjblsyj` - 科技部老师业绩（decimal）

## 三、设计方案

### 方案概述
采用 **主表标识 + 明细表计算** 的设计模式：
- 加班标识和加班系数存储在 **耗卡主表**（`lq_xh_hyhk`）
- 原始数据、加班计算后的数据、最终数据分别存储在相关表中

### 字段设计

#### 3.1 lq_xh_hyhk（耗卡主表）- 新增字段
```
F_OvertimeCoefficient DECIMAL(18,2) 加班系数（NULL或0表示非加班单，大于0表示加班单，如 0.5、1、1.5）
F_OriginalSgfy      DECIMAL(18,2) 原始手工费（用户输入的原始值）
F_OvertimeSgfy      DECIMAL(18,2) 加班手工费（加班计算后的增量值）
```

**说明：**
- `F_OvertimeCoefficient` 存储加班系数，用于判断是否为加班单：
  - `NULL` 或 `0` → 非加班单
  - 大于 `0`（如 0.5、1、1.5）→ 加班单，系数值表示加倍的倍数
- `F_OriginalSgfy` 存储用户输入的原始手工费
- `F_OvertimeSgfy = F_OriginalSgfy * F_OvertimeCoefficient`（加班计算后的增量，仅当系数大于0时计算）
- `sgfy`（最终手工费）= `F_OriginalSgfy + F_OvertimeSgfy`（原始值 + 加班增量）

#### 3.2 lq_xh_pxmx（耗卡品项明细表）- 新增字段
```
F_OriginalProjectNumber   INT         原始项目次数（用户输入的原始值）
F_OvertimeProjectNumber   DECIMAL(18,2) 加班项目次数（加班计算后的增量值）
```

**说明：**
- `F_OriginalProjectNumber` 存储用户输入的原始项目次数
- `F_OvertimeProjectNumber = F_OriginalProjectNumber * F_OvertimeCoefficient`（从主表获取系数计算）
- `F_ProjectNumber`（最终项目次数）= `F_OriginalProjectNumber + F_OvertimeProjectNumber`（原始值 + 加班增量）

#### 3.3 lq_xh_jksyj（耗卡健康师业绩表）- 新增字段
```
F_OriginalKdpxNumber  DECIMAL(18,2) 原始耗卡品项次数（原始值）
F_OvertimeKdpxNumber  DECIMAL(18,2) 加班耗卡品项次数（加班计算后的增量值）
F_OriginalLaborCost   DECIMAL(18,2) 原始手工费（原始值）
F_OvertimeLaborCost   DECIMAL(18,2) 加班手工费（加班计算后的增量值）
```

**说明：**
- `F_OriginalKdpxNumber` 存储原始耗卡品项次数
- `F_OvertimeKdpxNumber = F_OriginalKdpxNumber * F_OvertimeCoefficient`（从主表获取系数计算）
- `F_kdpxNumber`（最终耗卡品项次数）= `F_OriginalKdpxNumber + F_OvertimeKdpxNumber`
- `F_OriginalLaborCost` 存储原始手工费
- `F_OvertimeLaborCost = F_OriginalLaborCost * F_OvertimeCoefficient`（从主表获取系数计算）
- `F_LaborCost`（最终手工费）= `F_OriginalLaborCost + F_OvertimeLaborCost`

#### 3.4 lq_xh_kjbsyj（耗卡科技部老师业绩表）- 新增字段
```
F_OriginalHdpxNumber  DECIMAL(18,2) 原始耗卡品相次数（原始值）
F_OvertimeHdpxNumber  DECIMAL(18,2) 加班耗卡品相次数（加班计算后的增量值）
F_OriginalLaborCost   DECIMAL(18,2) 原始手工费（原始值）
F_OvertimeLaborCost   DECIMAL(18,2) 加班手工费（加班计算后的增量值）
```

**说明：**
- `F_OriginalHdpxNumber` 存储原始耗卡品相次数
- `F_OvertimeHdpxNumber = F_OriginalHdpxNumber * F_OvertimeCoefficient`（从主表获取系数计算）
- `F_hdpxNumber`（最终耗卡品相次数）= `F_OriginalHdpxNumber + F_OvertimeHdpxNumber`
- `F_OriginalLaborCost` 存储原始手工费
- `F_OvertimeLaborCost = F_OriginalLaborCost * F_OvertimeCoefficient`（从主表获取系数计算）
- `F_LaborCost`（最终手工费）= `F_OriginalLaborCost + F_OvertimeLaborCost`

## 四、数据计算逻辑

### 4.1 创建消耗单时的计算流程

**前提条件：**
- 如果用户输入加班系数（`F_OvertimeCoefficient`），且值大于 0，则视为加班单
- 加班系数可以为 `NULL`、`0`（非加班单）或大于 `0` 的值（如 0.5、1、1.5）

**计算步骤：**

1. **耗卡主表（lq_xh_hyhk）**
   ```
   原始手工费（F_OriginalSgfy）= 用户输入的手工费
   加班手工费（F_OvertimeSgfy）= F_OriginalSgfy * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终手工费（sgfy）= F_OriginalSgfy + F_OvertimeSgfy
   ```

2. **耗卡品项明细表（lq_xh_pxmx）**
   ```
   原始项目次数（F_OriginalProjectNumber）= 用户输入的项目次数
   加班项目次数（F_OvertimeProjectNumber）= F_OriginalProjectNumber * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终项目次数（F_ProjectNumber）= F_OriginalProjectNumber + F_OvertimeProjectNumber
   ```

3. **健康师业绩表（lq_xh_jksyj）**
   ```
   原始耗卡品项次数（F_OriginalKdpxNumber）= 原始项目次数
   加班耗卡品项次数（F_OvertimeKdpxNumber）= F_OriginalKdpxNumber * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终耗卡品项次数（F_kdpxNumber）= F_OriginalKdpxNumber + F_OvertimeKdpxNumber
   
   原始手工费（F_OriginalLaborCost）= 该健康师的原始手工费
   加班手工费（F_OvertimeLaborCost）= F_OriginalLaborCost * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终手工费（F_LaborCost）= F_OriginalLaborCost + F_OvertimeLaborCost
   ```

4. **科技部老师业绩表（lq_xh_kjbsyj）**
   ```
   原始耗卡品相次数（F_OriginalHdpxNumber）= 原始项目次数
   加班耗卡品相次数（F_OvertimeHdpxNumber）= F_OriginalHdpxNumber * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终耗卡品相次数（F_hdpxNumber）= F_OriginalHdpxNumber + F_OvertimeHdpxNumber
   
   原始手工费（F_OriginalLaborCost）= 该科技部老师的原始手工费
   加班手工费（F_OvertimeLaborCost）= F_OriginalLaborCost * F_OvertimeCoefficient（如果 F_OvertimeCoefficient > 0）
   最终手工费（F_LaborCost）= F_OriginalLaborCost + F_OvertimeLaborCost
   ```

### 4.2 特殊情况处理

- **非加班单（F_OvertimeCoefficient IS NULL 或 F_OvertimeCoefficient = 0）**：
  - 所有加班字段（`F_Overtime*`）都等于 `0` 或 `NULL`
  - 最终值 = 原始值

- **加班系数为 0**：
  - 加班增量 = 0，最终值 = 原始值（等同于非加班单）

- **加班系数为 NULL**：
  - 视为非加班单，不进行任何加班计算

## 五、数据查询与展示

### 5.1 查询时展示的数据
- **原始数据**：所有 `F_Original*` 字段
- **加班数据**：所有 `F_Overtime*` 字段 + `F_OvertimeCoefficient`
- **最终数据**：所有最终字段（`sgfy`、`F_ProjectNumber`、`F_kdpxNumber`、`F_LaborCost` 等）

### 5.2 统计计算
- 统计时可以分别统计：
  - 原始数据总和
  - 加班数据总和（筛选条件：`F_OvertimeCoefficient > 0`）
  - 最终数据总和
- 查询加班单：`WHERE F_OvertimeCoefficient > 0`
- 查询非加班单：`WHERE F_OvertimeCoefficient IS NULL OR F_OvertimeCoefficient = 0`

## 六、实施建议

### 6.1 数据库变更
1. 执行 SQL 脚本添加所有新字段
2. 为现有数据设置默认值：
   - `F_OvertimeCoefficient = NULL`（所有现有数据默认为非加班）
   - `F_OriginalSgfy = sgfy`（现有手工费作为原始值）
   - `F_OvertimeSgfy = 0`（现有数据无加班增量）
   - 类似处理其他原始值字段

### 6.2 代码变更
1. **实体类（Entity）**：添加所有新字段属性
2. **DTO 类**：
   - `LqXhHyhkCrInput` - 添加 `F_OvertimeCoefficient`（加班系数）输入字段
   - `LqXhHyhkInfoOutput` - 添加加班相关输出字段（系数、原始值、加班值）
   - `LqXhPxmxInfoOutput` - 添加加班相关输出字段（原始值、加班值）
   - `LqXhJksyjInfoOutput` - 添加加班相关输出字段（原始值、加班值）
   - `LqXhKjbsyjInfoOutput` - 添加加班相关输出字段（原始值、加班值）
3. **Service 层**：
   - `Create` 方法：添加加班计算逻辑
   - `Update` 方法：添加加班计算逻辑
   - `GetInfo` 方法：返回加班相关字段

## 七、总结

本设计方案实现了：
✅ **原始数据保留**：所有原始值存储在 `F_Original*` 字段
✅ **加班数据保留**：所有加班计算值存储在 `F_Overtime*` 字段
✅ **最终数据展示**：最终值 = 原始值 + 加班增量
✅ **数据可追溯**：可以查看任意时刻的原始值、加班值、最终值
✅ **灵活扩展**：加班系数可配置，支持不同场景（0.5、1、1.5 等）
✅ **简化设计**：通过 `F_OvertimeCoefficient` 一个字段即可判断是否为加班单（NULL/0=非加班，>0=加班）