# 店助工资表字段设计

## 📋 表名建议
`lq_assistant_salary_statistics`（店助工资统计表）

---

## 🔍 字段分类说明

根据店助工资计算规则，参考健康师工资表结构，店助工资表需要包含以下字段：

---

## 一、基础信息字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 主键ID | F_Id | VARCHAR(50) | 主键，使用YitIdHelper生成 | ✅ |
| 门店ID | F_StoreId | VARCHAR(50) | 关联门店信息表 | ✅ |
| 门店名称 | F_StoreName | VARCHAR(200) | 门店名称（冗余字段，便于查询） | ✅ |
| 核算岗位 | F_Position | VARCHAR(50) | 固定为"店助"或"店助主任" | ✅ |
| 员工姓名 | F_EmployeeName | VARCHAR(100) | 员工姓名 | ✅ |
| 员工ID | F_EmployeeId | VARCHAR(50) | 关联BASE_USER表 | ✅ |
| 统计月份 | F_StatisticsMonth | VARCHAR(20) | 格式：YYYYMM，如：202501 | ✅ |
| 门店类型 | F_StoreType | INT | 门店类型（200平/旗舰店） | ❌ |
| 门店类别 | F_StoreCategory | INT | 门店分类（1=A类，2=B类，3=C类） | ✅ |
| 是否新店 | F_IsNewStore | VARCHAR(10) | 是/否 | ❌ |
| 新店保护阶段 | F_NewStoreProtectionStage | INT | 新店保护阶段（0/1/2） | ❌ |

---

## 二、业绩相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 门店总业绩 | F_StoreTotalPerformance | DECIMAL(18,2) | 门店开单业绩 - 门店退卡业绩 | ✅ |
| 门店开单业绩 | F_StoreBillingPerformance | DECIMAL(18,2) | 门店开单业绩总和 | ✅ |
| 门店退卡业绩 | F_StoreRefundPerformance | DECIMAL(18,2) | 门店退卡业绩总和 | ✅ |
| 门店生命线 | F_StoreLifeline | DECIMAL(18,2) | 门店生命线（从lq_md_target获取） | ✅ |
| 业绩完成率 | F_PerformanceCompletionRate | DECIMAL(18,4) | 门店业绩 / 门店生命线 | ✅ |

---

## 三、提成相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 提成比例 | F_CommissionRate | DECIMAL(18,4) | 根据业绩与生命线比例确定（0%/0.4%/0.6%） | ✅ |
| 提成金额 | F_CommissionAmount | DECIMAL(18,2) | 门店业绩 × 提成比例 | ✅ |

---

## 四、阶段奖励相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 进店消耗人数 | F_HeadCount | INT | 有消费金额的，按门店按月去重客户数 | ✅ |
| 第一阶段目标人数 | F_Stage1TargetHeadCount | INT | 从lq_md_target获取 | ✅ |
| 第二阶段目标人数 | F_Stage2TargetHeadCount | INT | 从lq_md_target获取 | ✅ |
| 是否达到第一阶段 | F_ReachedStage1 | VARCHAR(10) | 是/否 | ✅ |
| 是否达到第二阶段 | F_ReachedStage2 | VARCHAR(10) | 是/否 | ✅ |
| 阶段奖励金额 | F_StageRewardAmount | DECIMAL(18,2) | 根据阶段达成情况计算（0/200/400元） | ✅ |
| 第一阶段奖励 | F_Stage1Reward | DECIMAL(18,2) | 第一阶段奖励金额（0或200元） | ✅ |
| 第二阶段奖励 | F_Stage2Reward | DECIMAL(18,2) | 第二阶段奖励金额（0或200元） | ✅ |

---

## 五、底薪相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 门店分类 | F_StoreCategory | INT | 门店分类（1=A类，2=B类，3=C类） | ✅ |
| 底薪金额 | F_BaseSalary | DECIMAL(18,2) | 根据门店分类确定（A类3000，B类3100，C类3200） | ✅ |

---

## 六、固定奖励字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 手机管理费 | F_PhoneManagementFee | DECIMAL(18,2) | 固定150元/月 | ✅ |

---

## 七、考勤相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 在店天数 | F_WorkingDays | INT | 在店工作天数 | ✅ |
| 请假天数 | F_LeaveDays | INT | 请假天数 | ✅ |

---

## 八、工资计算字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 应发工资 | F_GrossSalary | DECIMAL(18,2) | 底薪 + 提成 + 阶段奖励 + 固定奖励 | ✅ |
| 实发工资 | F_ActualSalary | DECIMAL(18,2) | 应发工资 - 扣款合计 + 补贴合计 + 奖金 | ✅ |

---

## 九、扣款相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 缺卡扣款 | F_MissingCard | DECIMAL(18,2) | 缺卡扣款金额 | ✅ |
| 迟到扣款 | F_LateArrival | DECIMAL(18,2) | 迟到扣款金额 | ✅ |
| 请假扣款 | F_LeaveDeduction | DECIMAL(18,2) | 请假扣款金额 | ✅ |
| 扣社保 | F_SocialInsuranceDeduction | DECIMAL(18,2) | 社保扣款金额 | ✅ |
| 扣除奖励 | F_RewardDeduction | DECIMAL(18,2) | 扣除奖励金额 | ✅ |
| 扣住宿费 | F_AccommodationDeduction | DECIMAL(18,2) | 住宿费扣款金额 | ✅ |
| 扣学习期费用 | F_StudyPeriodDeduction | DECIMAL(18,2) | 学习期费用扣款 | ✅ |
| 扣工作服费用 | F_WorkClothesDeduction | DECIMAL(18,2) | 工作服费用扣款 | ✅ |
| 扣款合计 | F_TotalDeduction | DECIMAL(18,2) | 所有扣款金额总和 | ✅ |

---

## 十、补贴相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 当月培训补贴 | F_MonthlyTrainingSubsidy | DECIMAL(18,2) | 当月培训补贴 | ✅ |
| 当月交通补贴 | F_MonthlyTransportSubsidy | DECIMAL(18,2) | 当月交通补贴 | ✅ |
| 上月培训补贴 | F_LastMonthTrainingSubsidy | DECIMAL(18,2) | 上月培训补贴 | ✅ |
| 上月交通补贴 | F_LastMonthTransportSubsidy | DECIMAL(18,2) | 上月交通补贴 | ✅ |
| 补贴合计 | F_TotalSubsidy | DECIMAL(18,2) | 所有补贴金额总和 | ✅ |

---

## 十一、奖金相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 发奖金 | F_Bonus | DECIMAL(18,2) | 奖金金额 | ✅ |
| 退手机押金 | F_ReturnPhoneDeposit | DECIMAL(18,2) | 退手机押金金额 | ✅ |
| 退住宿押金 | F_ReturnAccommodationDeposit | DECIMAL(18,2) | 退住宿押金金额 | ✅ |

---

## 十二、支付相关字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 当月是否发放 | F_MonthlyPaymentStatus | VARCHAR(20) | 已发放/未发放/部分发放 | ✅ |
| 支付金额 | F_PaidAmount | DECIMAL(18,2) | 已支付金额 | ✅ |
| 待支付金额 | F_PendingAmount | DECIMAL(18,2) | 待支付金额 | ✅ |
| 补发上月 | F_LastMonthSupplement | DECIMAL(18,2) | 补发上月金额 | ✅ |
| 当月支付总额 | F_MonthlyTotalPayment | DECIMAL(18,2) | 当月支付总额 | ✅ |

---

## 十三、系统字段

| 字段名 | 数据库字段 | 类型 | 说明 | 必填 |
|--------|-----------|------|------|------|
| 是否锁定 | F_IsLocked | INT | 0=未锁定，1=已锁定 | ✅ |
| 创建时间 | F_CreateTime | DATETIME | 创建时间 | ✅ |
| 更新时间 | F_UpdateTime | DATETIME | 更新时间 | ✅ |
| 创建人 | F_CreateUser | VARCHAR(50) | 创建人ID | ❌ |
| 更新人 | F_UpdateUser | VARCHAR(50) | 更新人ID | ❌ |

---

## 📊 字段统计

- **总字段数**：约 60+ 个字段
- **必填字段**：约 50+ 个（包含奖金、补贴、支付相关字段）
- **可选字段**：约 10 个（主要是系统字段中的创建人、更新人等）

---

## 🔑 索引建议

1. **主键索引**：`F_Id`（PRIMARY KEY）
2. **唯一索引**：`F_EmployeeId + F_StatisticsMonth`（确保同一员工同一月份只有一条记录）
3. **普通索引**：
   - `F_StoreId`（按门店查询）
   - `F_StatisticsMonth`（按月份查询）
   - `F_EmployeeId`（按员工查询）
   - `F_StoreCategory`（按门店分类查询）

---

## 📝 字段说明

### 1. 业绩完成率计算
```
业绩完成率 = 门店业绩 / 门店生命线 × 100%
```

### 2. 提成比例判断
```
if (门店业绩 < 门店生命线 × 70%)
    提成比例 = 0%
else if (门店业绩 < 门店生命线 × 100%)
    提成比例 = 0.4%
else
    提成比例 = 0.6%
```

### 3. 阶段奖励计算
```
if (进店消耗人数 >= 第二阶段目标)
    阶段奖励 = 400元（第一阶段200 + 第二阶段200）
else if (进店消耗人数 >= 第一阶段目标)
    阶段奖励 = 200元（第一阶段200）
else
    阶段奖励 = 0元
```

### 4. 应发工资计算
```
应发工资 = 底薪 + 提成金额 + 阶段奖励金额 + 手机管理费
```

### 5. 实发工资计算
```
实发工资 = 应发工资 - 扣款合计 + 补贴合计 + 奖金
```

---

## ⚠️ 注意事项

1. **数据校验**：
   - 门店分类必须设置，不允许为NULL
   - 门店生命线必须设置，未设置应报错
   - 阶段目标必须设置，未设置应报错

2. **数据一致性**：
   - 门店业绩的计算逻辑必须与门店总业绩统计保持一致
   - 进店消耗人数的统计逻辑必须与其他统计接口保持一致

3. **字段命名规范**：
   - 所有字段使用 `F_` 前缀
   - 金额字段使用 `DECIMAL(18,2)` 类型
   - 日期字段使用 `DATETIME` 类型
   - 月份字段使用 `VARCHAR(20)` 类型，格式为 YYYYMM

4. **与健康师工资表的差异**：
   - 店助工资表不需要：个人业绩、战队业绩、新客业绩、升单业绩等个人业绩相关字段
   - 店助工资表需要：门店业绩、门店生命线、进店消耗人数、阶段奖励等门店相关字段
   - 店助工资表不需要：顾问提成、门店T区提成等健康师特有字段
   - 店助工资表需要：手机管理费固定奖励字段

---

## 🔗 相关表关联

1. **BASE_USER**：通过 `F_EmployeeId` 关联员工信息
2. **lq_mdxx**：通过 `F_StoreId` 关联门店信息，获取门店分类
3. **lq_md_target**：通过 `F_StoreId + F_StatisticsMonth` 关联门店目标，获取门店生命线和阶段目标
4. **lq_kd_kdjlb**：用于计算门店开单业绩
5. **lq_hytk_hytk**：用于计算门店退卡业绩
6. **lq_xh_hyhk**：用于统计进店消耗人数
7. **lq_xh_jksyj**：用于判断是否有消费金额

---

## 📅 更新记录

- 2025-01-XX：初始版本，根据健康师工资表结构和店助工资计算规则梳理店助工资表字段