Blame view

项目文档相关/docs/科技部驾驶舱接口清单.md 3.31 KB
8479baab   “wangming”   优化统计卡片样式和布局,调整卡片间...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
  # 科技部驾驶舱接口清单
  
  根据 `科技部驾驶舱数据分析梳理.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