# 店长工资计算 - 前置条件检查清单

## 📋 检查时间
2025-01-XX

---

## ✅ 一、数据表检查

### 1. 核心业务表

| 表名 | 用途 | 状态 | 说明 |
|------|------|------|------|
| `lq_kd_kdjlb` | 开单记录表（获取开单业绩） | ✅ 已存在 | 字段：`sfyj`（实付业绩）、`Djmd`（门店ID）、`Kdrq`（开单日期） |
| `lq_hytk_hytk` | 退卡记录表（获取退款业绩） | ✅ 已存在 | 字段：`F_ActualRefundAmount`（实际退款金额）、`md`（门店ID）、`tksj`（退卡时间） |
| `lq_inventory_usage` | 库存使用记录表（获取产品物料） | ✅ 已存在 | 字段：`F_TotalAmount`（合计金额）、`F_StoreId`（门店ID）、`F_UsageTime`（使用时间） |
| `lq_cooperation_cost` | 合作成本表 | ✅ 已创建 | 字段：`F_TotalAmount`（合计金额）、`F_StoreId`（门店ID）、`F_Year`（年份）、`F_Month`（月份） |
| `lq_store_expense` | 店内支出表 | ✅ 已创建 | 字段：`F_Amount`（金额）、`F_StoreId`（门店ID）、`F_ExpenseDate`（支出日期） |
| `lq_laundry_flow` | 清洗流水表（获取洗毛巾费用） | ✅ 已存在 | 字段：`F_TotalPrice`（总费用）、`F_StoreId`（门店ID）、`F_FlowType`（流水类型，0=送出） |
| `lq_md_target` | 门店目标表 | ✅ 已存在 | 字段：`F_StoreId`（门店ID）、`F_Month`（月份）、`F_StoreLifeline`（门店生命线）、`F_HeadcountTarget`（目标人头数）、`F_ConsumeTarget`（目标消耗） |
| `lq_xh_hyhk` | 耗卡记录表（统计进店消耗人数） | ✅ 已存在 | 用于统计进店消耗人数 |
| `lq_md_xdbhsj` | 新店保护时间表 | ⚠️ 需确认 | 用于判断是否为新店 |
| `lq_mdxx` | 门店信息表 | ✅ 已存在 | 字段：`F_Id`（门店ID）、`F_StoreType`（门店类型，判断旗舰店）、`F_StoreCategory`（门店分类，A/B/C类） |
| `BASE_USER` | 系统用户表 | ✅ 已存在 | 字段：`F_Id`（员工ID）、`F_RealName`（姓名）、`F_GW`（岗位，店长）、`F_MDID`（门店ID） |

---

## ✅ 二、实体类检查

### 1. 核心实体类

| 实体类 | 对应表 | 状态 | 说明 |
|--------|--------|------|------|
| `LqKdKdjlbEntity` | `lq_kd_kdjlb` | ✅ 已存在 | 开单记录实体 |
| `LqHytkHytkEntity` | `lq_hytk_hytk` | ✅ 已存在 | 退卡记录实体 |
| `LqInventoryUsageEntity` | `lq_inventory_usage` | ✅ 已存在 | 库存使用记录实体 |
| `LqCooperationCostEntity` | `lq_cooperation_cost` | ✅ 已创建 | 合作成本实体 |
| `LqStoreExpenseEntity` | `lq_store_expense` | ✅ 已创建 | 店内支出实体 |
| `LqLaundryFlowEntity` | `lq_laundry_flow` | ✅ 已存在 | 清洗流水实体 |
| `LqMdTargetEntity` | `lq_md_target` | ✅ 已存在 | 门店目标实体 |
| `LqXhHyhkEntity` | `lq_xh_hyhk` | ✅ 已存在 | 耗卡记录实体 |
| `LqMdxxEntity` | `lq_mdxx` | ✅ 已存在 | 门店信息实体 |

---

## ✅ 三、服务类检查

### 1. 数据查询服务

| 服务类 | 功能 | 状态 | 说明 |
|--------|------|------|------|
| `LqCooperationCostService` | 合作成本管理 | ✅ 已实现 | CRUD、导入、导出 |
| `LqStoreExpenseService` | 店内支出管理 | ✅ 已实现 | CRUD、导入、导出 |
| `LqReimbursementApplicationService` | 报销申请管理 | ✅ 已实现 | 已实现导出本月已审核通过的报销表明细 |
| `LqInventoryUsageService` | 库存使用管理 | ✅ 已存在 | 可查询仓库领用金额 |
| `LqLaundryFlowService` | 清洗流水管理 | ⚠️ 需确认 | 需确认是否有查询送洗记录的服务 |
| `LqKdKdjlbService` | 开单记录管理 | ✅ 已存在 | 可查询开单业绩 |
| `LqHytkHytkService` | 退卡记录管理 | ⚠️ 需确认 | 需确认是否有查询退卡记录的服务 |
| `LqMdTargetService` | 门店目标管理 | ⚠️ 需确认 | 需确认是否有查询门店目标的服务 |
| `LqMdxxService` | 门店信息管理 | ✅ 已存在 | 可查询门店信息、分类、类型 |

---

## ⚠️ 四、待实现功能检查

### 1. 毛利计算接口

| 功能 | 状态 | 优先级 |
|------|------|--------|
| 销售业绩查询（开单业绩 - 退款业绩） | ❌ 未实现 | 高 |
| 产品物料查询（仓库领用金额，特殊规则：11月算10月） | ❌ 未实现 | 高 |
| 合作项目成本查询 | ✅ 已实现 | - |
| 店内支出查询 | ✅ 已实现 | - |
| 洗毛巾查询 | ❌ 未实现 | 高 |
| 毛利汇总计算接口 | ❌ 未实现 | 高 |

### 2. 工资计算接口

| 功能 | 状态 | 优先级 |
|------|------|--------|
| 底薪计算（老店/新店，旗舰店特殊规则） | ❌ 未实现 | 中 |
| 提成计算（基于毛利，老店/新店不同规则） | ❌ 未实现 | 中 |
| 考核指标判断（业绩、人头、消耗） | ❌ 未实现 | 中 |
| 新店判断逻辑 | ❌ 未实现 | 中 |
| 旗舰店判断逻辑 | ⚠️ 需确认 | 中 |
| 完整工资计算接口 | ❌ 未实现 | 中 |

---

## 📊 五、数据查询能力检查

### 1. 销售业绩查询

**需求**：
- 开单业绩：从 `lq_kd_kdjlb` 表查询 `sfyj` 字段，按门店ID和月份统计
- 退款业绩：从 `lq_hytk_hytk` 表查询 `F_ActualRefundAmount` 字段，按门店ID和月份统计
- 销售业绩 = 开单业绩 - 退款业绩

**状态**：❌ 需要实现查询接口

---

### 2. 产品物料查询

**需求**：
- 从 `lq_inventory_usage` 表查询 `F_TotalAmount` 字段
- 按门店ID和月份统计
- **特殊规则**：核算11月工资时，算的是10月份的仓库领用

**状态**：❌ 需要实现查询接口（注意11月特殊规则）

---

### 3. 合作项目成本查询

**需求**：
- 从 `lq_cooperation_cost` 表查询 `F_TotalAmount` 字段
- 按门店ID、年份、月份查询

**状态**：✅ 已实现（`LqCooperationCostService.GetList`）

---

### 4. 店内支出查询

**需求**：
- 从 `lq_store_expense` 表查询 `F_Amount` 字段
- 按门店ID和月份统计

**状态**：✅ 已实现（`LqStoreExpenseService.GetList`）

---

### 5. 洗毛巾查询

**需求**：
- 从 `lq_laundry_flow` 表查询 `F_TotalPrice` 字段
- 条件：`F_FlowType = 0`（送出）
- 按门店ID和月份统计

**状态**：❌ 需要实现查询接口

---

### 6. 门店目标查询

**需求**：
- 从 `lq_md_target` 表查询门店生命线、目标人头数、目标消耗
- 按门店ID和月份查询

**状态**：⚠️ 需确认是否有查询接口

---

### 7. 新店判断

**需求**：
- 从 `lq_md_xdbhsj` 表查询新店保护信息
- 判断统计月份的第一天是否在保护期内

**状态**：❌ 需要实现新店判断逻辑

---

### 8. 进店消耗人数统计

**需求**：
- 从 `lq_xh_hyhk` 表统计有消费金额的客户数
- 按门店按月去重

**状态**：❌ 需要实现统计接口

---

### 9. 门店消耗统计

**需求**：
- 从 `lq_xh_jksyj` 表统计门店当月总消耗金额
- 按门店和月份统计

**状态**：❌ 需要实现统计接口

---

## ✅ 六、已完成功能

### 1. 数据表创建
- ✅ `lq_cooperation_cost` 表已创建
- ✅ `lq_store_expense` 表已创建

### 2. 实体类创建
- ✅ `LqCooperationCostEntity` 已创建
- ✅ `LqStoreExpenseEntity` 已创建

### 3. 服务类实现
- ✅ `LqCooperationCostService` 已实现（CRUD、导入、导出）
- ✅ `LqStoreExpenseService` 已实现（CRUD、导入、导出）
- ✅ `LqReimbursementApplicationService.ExportApprovedDetails` 已实现（导出报销表明细）

---

## ❌ 七、待实现功能

### 1. 毛利计算接口（高优先级）

需要实现以下接口：

1. **销售业绩查询接口**
   - 查询开单业绩（`lq_kd_kdjlb`）
   - 查询退款业绩（`lq_hytk_hytk`）
   - 计算销售业绩 = 开单业绩 - 退款业绩

2. **产品物料查询接口**
   - 查询仓库领用金额（`lq_inventory_usage`）
   - 特殊规则：11月工资算10月数据

3. **洗毛巾查询接口**
   - 查询送洗记录总费用（`lq_laundry_flow`，`F_FlowType = 0`）

4. **毛利汇总计算接口**
   - 汇总所有组成部分
   - 计算：毛利 = 销售业绩 - 产品物料 - 合作项目成本 - 店内支出 - 洗毛巾

### 2. 工资计算接口（中优先级）

需要实现以下接口：

1. **门店目标查询接口**
   - 查询门店生命线、目标人头数、目标消耗（`lq_md_target`）

2. **新店判断接口**
   - 判断门店是否为新店（`lq_md_xdbhsj`）

3. **进店消耗人数统计接口**
   - 统计有消费金额的客户数（`lq_xh_hyhk`）

4. **门店消耗统计接口**
   - 统计门店当月总消耗金额（`lq_xh_jksyj`）

5. **底薪计算接口**
   - 老店：3个考核指标（业绩、人头、消耗）
   - 新店：2个考核指标（业绩、人头）
   - 旗舰店：额外扣除800元

6. **提成计算接口**
   - 老店：根据门店分类（A/B/C）和业绩是否达标
   - 新店：不区分分类，统一比例

7. **完整工资计算接口**
   - 整合底薪和提成
   - 返回完整工资计算结果

---

## 📝 八、总结

### ✅ 已完成
1. 合作成本表和店内支出表已创建并实现CRUD、导入、导出功能
2. 报销表导出功能已实现
3. 所有核心数据表都已存在
4. 所有核心实体类都已存在

### ❌ 待实现
1. **毛利计算接口**（高优先级）
   - 销售业绩查询
   - 产品物料查询（注意11月特殊规则）
   - 洗毛巾查询
   - 毛利汇总计算

2. **工资计算接口**（中优先级）
   - 门店目标查询
   - 新店判断
   - 进店消耗人数统计
   - 门店消耗统计
   - 底薪计算
   - 提成计算
   - 完整工资计算

### ⚠️ 需确认
1. 新店保护时间表（`lq_md_xdbhsj`）是否存在
2. 是否有查询门店目标的服务
3. 是否有查询送洗记录的服务
4. 是否有查询退卡记录的服务

---

## 🚀 下一步行动

### 第一步：实现毛利计算接口
1. 实现销售业绩查询接口
2. 实现产品物料查询接口（注意11月特殊规则）
3. 实现洗毛巾查询接口
4. 实现毛利汇总计算接口

### 第二步：实现工资计算接口
1. 实现门店目标查询接口
2. 实现新店判断逻辑
3. 实现进店消耗人数统计接口
4. 实现门店消耗统计接口
5. 实现底薪计算接口
6. 实现提成计算接口
7. 实现完整工资计算接口

### 第三步：测试验证
1. 测试毛利计算准确性
2. 测试工资计算准确性
3. 测试各种边界情况（新店、老店、旗舰店、业绩达标/未达标等）