# 开单表财务报表梳理

## 概述
基于 `lq_kd_kdjlb`（开单记录表）及相关关联表，梳理可以生成的财务报表类型和统计维度。

---

## 一、开单表核心字段

### 1.1 金额相关字段
- **`zdyj`** (整单业绩) - 订单总金额
- **`sfyj`** (实付业绩) - 实际收款金额（预收款）
- **`F_DeductAmount`** (储扣总金额) - 使用会员权益抵扣的金额
- **`qk`** (欠款) - 未付清金额
- **`F_PaidDebt`** (已缴欠款) - 已补缴的欠款金额
- **`F_SupplementAmount`** (补缴金额) - 补缴开单的金额

### 1.2 分类相关字段
- **`gjlx`** (顾客类型) - 新客/老客/会员等
- **`hgjg`** (合作机构) - 合作医院/机构ID
- **`fkfs`** (付款方式) - 现金/微信/支付宝/银行卡等
- **`fkyy`** (付款医院) - 付款医院ID（用于合作医院付款）
- **`fkpd`** (付款判断) - 付款状态判断
- **`khly`** (客户来源) - 客户获取渠道
- **`tjr`** (推荐人) - 推荐人ID

### 1.3 时间相关字段
- **`kdrq`** (开单日期) - 开单日期时间
- **`F_CreateTime`** (创建时间) - 记录创建时间

### 1.4 业务相关字段
- **`djmd`** (单据门店) - 开单门店ID
- **`jsj`** (金三角) - 金三角ID
- **`kdhy`** (开单会员) - 会员ID
- **`F_ActivityId`** (营销活动ID) - 关联的营销活动
- **`F_AppointmentId`** (预约记录ID) - 关联的预约记录
- **`sfskdd`** (是否首开订单) - 是否首次开单
- **`F_IsEffective`** (是否有效) - 是否有效记录
- **`F_UpgradeLifeBeauty`** (升生美) - 是否升级生美
- **`F_UpgradeTechBeauty`** (升科美) - 是否升级科美
- **`F_UpgradeMedicalBeauty`** (升医美) - 是否升级医美

### 1.5 关联表
- **`lq_kd_pxmx`** (开单品项明细表) - 品项详情、品项分类（生美/科美/医美/产品）、项目次数
- **`lq_kd_deductinfo`** (开单扣减信息表) - 储扣明细、扣减类型
- **`lq_kd_jksyj`** (健康师业绩表) - 健康师业绩分配
- **`lq_kd_kjbsyj`** (科技部业绩表) - 科技部老师业绩分配
- **`lq_hytk_hytk`** (退卡表) - 退款金额、实退金额

---

## 二、可生成的财务报表类型

### 2.1 收入类报表

#### 2.1.1 开单收入统计表
**统计维度**：按时间、门店、品项分类
- 整单业绩总额 (`zdyj`)
- 实付业绩总额 (`sfyj`) - **预收款**
- 储扣金额总额 (`F_DeductAmount`)
- 补缴金额总额 (`F_SupplementAmount`)
- 已缴欠款总额 (`F_PaidDebt`)
- 欠款总额 (`qk`)

**关联分析**：
- 按品项分类统计（生美/科美/医美/产品）
- 按门店统计
- 按时间周期统计（日/周/月/年）
- 按顾客类型统计
- 按付款方式统计

#### 2.1.2 应收款报表（合作医院）
**统计维度**：按合作机构、门店、时间
- 应收金额 = 实付业绩（`hgjg` 不为空 或 `fkyy` 不为空的开单）
- 已收金额 = 合作医院已支付的金额
- 未收金额 = 应收金额 - 已收金额

**数据来源**：
- `hgjg` (合作机构) - 标识合作机构
- `fkyy` (付款医院) - 标识付款医院
- `sfyj` (实付业绩) - 应收金额

#### 2.1.3 预收款报表（银行存款）
**统计维度**：按门店、时间
- 预收款总额 = 所有开单的实付业绩 (`sfyj`)
- 银行存款 = 预收款 - 应收（合作医院）
- 按付款方式分类（现金/微信/支付宝/银行卡等）

**计算公式**：
```
银行存款 = SUM(sfyj) - SUM(应收金额)
```

#### 2.1.4 品项分类收入报表
**统计维度**：按品项分类、门店、时间
- 生美收入（`ItemCategory = '生美'`）
- 科美收入（`ItemCategory = '科美'`）
- 医美收入（`ItemCategory = '医美'`）
- 产品收入（`ItemCategory = '产品'`）
- 其他收入

**数据来源**：`lq_kd_pxmx.F_ItemCategory` 关联 `lq_kd_kdjlb`

---

### 2.2 成本类报表

#### 2.2.1 储扣成本报表
**统计维度**：按门店、品项、时间
- 储扣金额统计（`F_DeductAmount`）
- 储扣明细分析（`lq_kd_deductinfo`）
- 按扣减类型分类
- 按品项分类统计储扣成本

**数据来源**：
- `lq_kd_kdjlb.F_DeductAmount` (储扣总金额)
- `lq_kd_deductinfo` (储扣明细表)

#### 2.2.2 欠款成本报表
**统计维度**：按门店、会员、时间
- 欠款总额 (`qk`)
- 已缴欠款 (`F_PaidDebt`)
- 未缴欠款 = 欠款总额 - 已缴欠款
- 欠款账龄分析
- 大额欠款客户清单

---

### 2.3 现金流报表

#### 2.3.1 现金流日报/月报
**统计维度**：按时间、门店
- **期初余额**：上期期末余额
- **本期收入**：
  - 实付业绩 (`sfyj`)
  - 补缴金额 (`F_SupplementAmount`)
  - 已缴欠款 (`F_PaidDebt`)
- **本期支出**：
  - 退款金额（关联 `lq_hytk_hytk.F_ActualRefundAmount`）
- **期末余额**：期初余额 + 本期收入 - 本期支出

#### 2.3.2 付款方式统计报表
**统计维度**：按付款方式、门店、时间
- 现金收款 (`fkfs = '现金'`)
- 微信收款 (`fkfs = '微信'`)
- 支付宝收款 (`fkfs = '支付宝'`)
- 银行卡收款 (`fkfs = '银行卡'`)
- 其他方式收款

---

### 2.4 应收应付报表

#### 2.4.1 应收账款明细表
**统计维度**：按合作机构、门店、时间
- 合作机构名称（关联 `hgjg`）
- 应收金额（该合作机构的开单实付业绩）
- 已收金额
- 未收金额
- 账龄分析

**数据来源**：
- `lq_kd_kdjlb.hgjg` (合作机构ID)
- `lq_kd_kdjlb.sfyj` (实付业绩)
- 关联合作机构表获取机构名称

#### 2.4.2 付款医院应收报表
**统计维度**：按付款医院、门店、时间
- 付款医院名称（关联 `fkyy`）
- 应收金额
- 已收金额
- 未收金额

---

### 2.5 利润分析报表

#### 2.5.1 开单利润分析表
**统计维度**：按门店、时间、品项分类
- **收入**：实付业绩 (`sfyj`)
- **成本**：
  - 储扣成本 (`F_DeductAmount`)
  - 退款成本（关联退款表）
  - 合作成本（科美业绩的30%，参考门店股份统计）
  - 管理费（业绩的9%，参考门店股份统计）
- **利润** = 收入 - 成本

**注意**：完整的利润计算需要关联其他成本表（人工工资、房租、库存成本等）

#### 2.5.2 净收益报表
**统计维度**：按门店、时间
- 实付业绩 (`sfyj`)
- 退款金额（`lq_hytk_hytk.F_ActualRefundAmount`）
- 净收益 = 实付业绩 - 退款金额

---

### 2.6 业务分析报表

#### 2.6.1 首单分析报表
**统计维度**：按门店、时间、顾客类型
- 首单订单数 (`sfskdd = '是'`)
- 首单金额
- 首单转化率
- 首单客户后续消费分析

#### 2.6.2 升单分析报表
**统计维度**：按门店、时间
- 升生美订单数 (`F_UpgradeLifeBeauty`)
- 升科美订单数 (`F_UpgradeTechBeauty`)
- 升医美订单数 (`F_UpgradeMedicalBeauty`)
- 升单金额
- 升单率分析

#### 2.6.3 客户来源分析报表
**统计维度**：按客户来源 (`khly`)、门店、时间
- 不同来源的开单数量
- 不同来源的开单金额
- 来源转化效果分析

#### 2.6.4 推荐人业绩报表
**统计维度**：按推荐人 (`tjr`)、门店、时间
- 推荐人推荐的开单数量
- 推荐人推荐的开单金额
- 推荐人排名
- 推荐转化率

#### 2.6.5 营销活动效果报表
**统计维度**：按营销活动 (`F_ActivityId`)、门店、时间
- 活动参与订单数
- 活动订单金额
- 活动ROI分析
- 活动转化率

---

### 2.7 分类统计报表

#### 2.7.1 品项分类统计报表
**统计维度**：按品项分类、门店、时间
- 生美/科美/医美/产品各分类的开单数量
- 各分类的开单金额
- 各分类的占比分析
- 各分类的趋势分析

**数据来源**：`lq_kd_pxmx.F_ItemCategory`

#### 2.7.2 顾客类型统计报表
**统计维度**：按顾客类型 (`gjlx`)、门店、时间
- 新客/老客/会员等类型的开单统计
- 各类型客户的平均订单金额
- 客户类型转化分析

#### 2.7.3 金三角业绩报表
**统计维度**：按金三角 (`jsj`)、门店、时间
- 各金三角的开单数量
- 各金三角的开单金额
- 金三角业绩排名
- 金三角转化率

---

### 2.8 趋势分析报表

#### 2.8.1 开单趋势报表
**统计维度**：按时间（日/周/月/年）、门店
- 开单数量趋势
- 开单金额趋势（整单业绩/实付业绩）
- 日均/月均开单分析
- 同比增长率

#### 2.8.2 欠款趋势报表
**统计维度**：按时间、门店
- 欠款总额趋势
- 已缴欠款趋势
- 未缴欠款趋势
- 欠款回收率

#### 2.8.3 储扣趋势报表
**统计维度**：按时间、门店
- 储扣金额趋势
- 储扣占比趋势（储扣/实付业绩）
- 储扣使用率

---

### 2.9 对比分析报表

#### 2.9.1 门店对比报表
**统计维度**：多门店对比、时间
- 各门店开单数量对比
- 各门店开单金额对比
- 各门店平均订单金额对比
- 各门店增长率对比

#### 2.9.2 时间周期对比报表
**统计维度**：同比/环比
- 去年同期对比
- 上月对比
- 环比增长率
- 同比增长率

---

### 2.10 明细报表

#### 2.10.1 开单明细报表
**统计维度**：按筛选条件
- 开单编号
- 开单日期
- 门店
- 会员信息
- 品项明细（关联 `lq_kd_pxmx`）
- 金额明细（整单业绩/实付业绩/储扣/欠款）
- 付款方式
- 合作机构
- 推荐人
- 营销活动

#### 2.10.2 储扣明细报表
**统计维度**：按门店、时间、品项
- 储扣记录明细（关联 `lq_kd_deductinfo`）
- 扣减类型
- 扣减金额
- 关联的开单信息

#### 2.10.3 补缴明细报表
**统计维度**：按门店、时间、会员
- 补缴开单记录（`F_SupplementBillingId` 不为空）
- 补缴金额 (`F_SupplementAmount`)
- 关联的原始开单
- 补缴时间

---

## 三、报表所需关联数据

### 3.1 必须关联的表
1. **`lq_kd_pxmx`** - 获取品项分类、品项明细
2. **`lq_mdxx`** - 获取门店名称
3. **`lq_khxx`** - 获取会员信息
4. **`BASE_USER`** - 获取推荐人姓名、健康师姓名
5. **`lq_hytk_hytk`** - 获取退款信息（计算净收益）
6. **`BASE_ORGANIZE`** - 获取合作机构名称

### 3.2 可选关联的表
1. **`lq_kd_deductinfo`** - 储扣明细
2. **`lq_kd_jksyj`** - 健康师业绩分配（用于成本分析）
3. **`lq_kd_kjbsyj`** - 科技部业绩分配（用于成本分析）
4. **`lq_event`** - 营销活动信息
5. **`lq_yyjl`** - 预约记录（用于转化率分析）
6. **`lq_jsj_user`** - 金三角信息

---

## 四、财务报表优先级建议

### 4.1 高优先级（核心财务报表）
1. **开单收入统计表** - 基础收入数据
2. **现金流报表** - 资金流动情况
3. **净收益报表** - 扣除退款后的净收入
4. **品项分类收入报表** - 业务结构分析
5. **门店对比报表** - 门店经营对比

### 4.2 中优先级（重要分析报表）
1. **应收款报表（合作医院）** - 应收账款管理
2. **欠款成本报表** - 资金风险管控
3. **首单/升单分析报表** - 业务增长分析
4. **营销活动效果报表** - 营销投入产出分析
5. **开单趋势报表** - 经营趋势分析

### 4.3 低优先级（辅助分析报表）
1. **付款方式统计报表** - 收款渠道分析
2. **客户来源分析报表** - 获客渠道分析
3. **推荐人业绩报表** - 推荐激励机制分析
4. **储扣成本报表** - 成本结构分析

---

## 五、报表统计规则

### 5.1 时间范围
- **日统计**：按 `kdrq` 日期
- **周统计**：按 `kdrq` 所在周
- **月统计**：按 `kdrq` 所在月份
- **年统计**：按 `kdrq` 所在年份
- **自定义周期**：按指定的开始和结束日期

### 5.2 数据过滤条件
- **有效记录**：`F_IsEffective = 1`
- **有金额记录**：`sfyj > 0` 或 `zdyj > 0`
- **门店筛选**：`djmd IN (门店ID列表)`
- **时间筛选**：`kdrq BETWEEN startTime AND endTime`

### 5.3 去重规则
- **开单数量**：COUNT(DISTINCT `F_Id`)
- **客户数量**：COUNT(DISTINCT `kdhy`)
- **品项数量**：COUNT(DISTINCT `lq_kd_pxmx.px`)

### 5.4 金额汇总规则
- **整单业绩**：SUM(`zdyj`) WHERE `F_IsEffective = 1`
- **实付业绩**：SUM(`sfyj`) WHERE `F_IsEffective = 1` AND `sfyj > 0`
- **储扣金额**：SUM(`F_DeductAmount`) WHERE `F_IsEffective = 1`
- **欠款金额**：SUM(`qk`) WHERE `F_IsEffective = 1` AND `qk > 0`
- **净收益**：SUM(`sfyj`) - SUM(退款金额)

---

## 六、注意事项

### 6.1 数据一致性
- 确保 `F_IsEffective = 1` 的记录才是有效开单
- 退款数据需要关联 `lq_hytk_hytk` 表，使用 `F_ActualRefundAmount`（实退金额）
- 储扣金额可以从主表 `F_DeductAmount` 获取，或从明细表 `lq_kd_deductinfo` 汇总

### 6.2 时间字段使用
- 统计时间以 `kdrq`（开单日期）为准
- `F_CreateTime` 仅作为记录创建时间，不用于业务统计

### 6.3 金额字段使用
- **预收款**：使用 `sfyj`（实付业绩）
- **订单总额**：使用 `zdyj`（整单业绩）
- **实际收款**：`sfyj`（已扣除储扣的金额）
- **储扣金额**：`F_DeductAmount`（会员权益抵扣）

### 6.4 关联数据获取
- 门店名称：关联 `lq_mdxx.dm`
- 会员信息：关联 `lq_khxx`
- 品项分类：关联 `lq_kd_pxmx.F_ItemCategory`
- 合作机构：关联合作机构表（通过 `hgjg`）

---

## 七、报表接口建议

### 7.1 统一查询参数
```csharp
public class FinancialReportQueryInput
{
    /// <summary>
    /// 开始时间
    /// </summary>
    public DateTime? StartTime { get; set; }
    
    /// <summary>
    /// 结束时间
    /// </summary>
    public DateTime? EndTime { get; set; }
    
    /// <summary>
    /// 门店ID列表
    /// </summary>
    public List<string> StoreIds { get; set; }
    
    /// <summary>
    /// 报表类型
    /// </summary>
    public string ReportType { get; set; }
    
    /// <summary>
    /// 统计维度（日/周/月/年）
    /// </summary>
    public string PeriodType { get; set; }
}
```

### 7.2 统一输出格式
- 包含统计周期信息
- 包含筛选条件信息
- 包含汇总数据
- 包含明细数据（如需）
- 包含同比/环比数据（如需）

---

## 八、扩展建议

### 8.1 报表缓存
- 对于历史月份的数据，可以预计算并缓存
- 减少实时查询压力

### 8.2 报表导出
- 支持 Excel 导出
- 支持 PDF 导出（可选）
- 支持自定义报表格式

### 8.3 报表权限
- 不同角色查看不同维度的报表
- 门店只能查看自己门店的报表
- 总部可以查看所有门店报表

---

## 九、总结

基于 `lq_kd_kdjlb` 开单表，可以生成以下类型的财务报表：

1. **收入类报表**（5种）：开单收入、应收款、预收款、品项分类收入等
2. **成本类报表**（2种）：储扣成本、欠款成本
3. **现金流报表**（2种）：现金流日报/月报、付款方式统计
4. **应收应付报表**（2种）：应收账款明细、付款医院应收
5. **利润分析报表**（2种）：开单利润分析、净收益
6. **业务分析报表**（5种）：首单分析、升单分析、客户来源、推荐人、营销活动
7. **分类统计报表**（3种）：品项分类、顾客类型、金三角
8. **趋势分析报表**（3种）：开单趋势、欠款趋势、储扣趋势
9. **对比分析报表**（2种）：门店对比、时间周期对比
10. **明细报表**（3种）：开单明细、储扣明细、补缴明细

**总计：约29种不同类型的财务报表**

这些报表可以满足财务分析、业务分析、经营决策等多种需求。