# 科技部驾驶舱接口清单

根据 `科技部驾驶舱数据分析梳理.md` 文档，需要实现的接口清单：

## 一、核心业务指标接口

### ✅ 1. GetStatistics（已完成）
- 整体业绩指标：溯源金额、Cell金额、科美总收入、管理的门店数、活跃门店数

### ⏳ 2. GetShareStatistics（待实现）
- 股份相关指标：收入、成本-报销、成本-人工（各项明细）、利润

## 二、趋势分析接口

### ⏳ 3. GetPerformanceTrend（待实现）
- 业绩趋势：溯源金额趋势、Cell金额趋势、科美总收入趋势、溯源与Cell对比趋势
- 时间维度：近12个月、近6个月、近3个月、当月

### ⏳ 4. GetShareTrend（待实现）
- 股份趋势：收入趋势、成本趋势、利润趋势
- 时间维度：近12个月、近6个月、近3个月、当月

## 三、门店分析接口

### ⏳ 5. GetStoreRanking（待实现）
- 门店业绩排行：门店溯源金额排行、门店Cell金额排行、门店科美总收入排行

### ⏳ 6. GetStoreDistribution（待实现）
- 门店业绩分布：门店业绩分布、门店业绩对比

## 四、人员分析接口

### ⏳ 7. GetTeacherRanking（待实现）
- 老师业绩排行：科技部老师业绩排行

### ⏳ 8. GetTeacherDistribution（待实现）
- 老师业绩分布

### ⏳ 9. GetTeacherTrend（待实现）
- 老师业绩趋势：指定老师的近12个月业绩趋势

## 五、运营分析接口

### ⏳ 10. GetOperationStatistics（待实现）
- 开单分析：开单次数、平均开单金额、开单门店分布
- 消耗分析：消耗次数、消耗金额、消耗率
- 退卡分析：退卡次数、退卡金额、退卡率

## 六、对比分析接口

### ⏳ 11. GetComparisonAnalysis（待实现）
- 时间对比：环比对比、同比对比
- 部门对比：科技一部 vs 科技二部
- 门店类型对比：按门店类型分组统计

## 七、明细数据列表接口

### ⏳ 12. GetStoreDetailList（待实现）
- 管理的门店列表（支持分页、排序、筛选）

### ⏳ 13. GetTeacherDetailList（待实现）
- 科技部老师列表（支持分页、排序、筛选）

### ⏳ 14. GetBillingDetailList（待实现）
- 科美开单明细列表（支持分页、排序、筛选）

### ⏳ 15. GetConsumeDetailList（待实现）
- 科美消耗明细列表（支持分页、排序、筛选）

---

## 接口实现优先级

**第一批（核心接口）**：
1. ✅ GetStatistics（已完成）
2. ⏳ GetShareStatistics（股份指标）
3. ⏳ GetPerformanceTrend（业绩趋势）
4. ⏳ GetStoreRanking（门店排行）

**第二批（分析接口）**：
5. ⏳ GetOperationStatistics（运营分析）
6. ⏳ GetTeacherRanking（老师排行）
7. ⏳ GetComparisonAnalysis（对比分析）

**第三批（明细接口）**：
8. ⏳ GetStoreDetailList（门店明细）
9. ⏳ GetTeacherDetailList（老师明细）
10. ⏳ GetBillingDetailList（开单明细）
11. ⏳ GetConsumeDetailList（消耗明细）

---

## 接口参数规范

所有接口都使用 `TechDepartmentDashboardStatisticsInput` 作为基础输入参数：
- `techDepartmentId`（可选）：科技部ID（BASE_ORGANIZE表的组织ID）
- `storeIds`（可选）：门店ID列表
- `statisticsMonth`（必填）：统计月份（YYYYMM格式）

**两者必填其一**：techDepartmentId 或 storeIds