科技部驾驶舱接口清单.md
3.31 KB
科技部驾驶舱接口清单
根据 科技部驾驶舱数据分析梳理.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（待实现）
- 科美消耗明细列表（支持分页、排序、筛选）
接口实现优先级
第一批（核心接口）：
- ✅ GetStatistics（已完成）
- ⏳ GetShareStatistics（股份指标）
- ⏳ GetPerformanceTrend（业绩趋势）
- ⏳ GetStoreRanking（门店排行）
第二批（分析接口）：
- ⏳ GetOperationStatistics（运营分析）
- ⏳ GetTeacherRanking（老师排行）
- ⏳ GetComparisonAnalysis（对比分析）
第三批（明细接口）：
- ⏳ GetStoreDetailList（门店明细）
- ⏳ GetTeacherDetailList（老师明细）
- ⏳ GetBillingDetailList（开单明细）
- ⏳ GetConsumeDetailList（消耗明细）
接口参数规范
所有接口都使用 TechDepartmentDashboardStatisticsInput 作为基础输入参数：
techDepartmentId（可选）：科技部ID（BASE_ORGANIZE表的组织ID）storeIds（可选）：门店ID列表statisticsMonth（必填）：统计月份（YYYYMM格式）
两者必填其一：techDepartmentId 或 storeIds