# DWS 数据层需求
## 简介
项目路径：C:\dev\LLTQ\ETL\feiqiu-ETL

本文档描述在ETL已完成的DWD层数据基础上对DWS层的数据处理：
- 完成对DWS层数据库的处理，即数据库设计，成果为DDL的SQL语句。
- 数据读取处理到落库，即DWD读取，Python处理，SQL写入。
- 在动手之前，先出一个任务计划文档，写明事实的具体技术方案细节。

文档更多聚焦业务描述，你需要使用专业技能，使用面向对象编程OOP思想，完成程序设计直至代码完成：
- 参考.\README.md 了解现在项目现状。
- 参考.\etl_billiards\docs 了解 DWD的schema的表和字段。
- SQL和Python代码需要详尽的，高密度的中文注释。
- 完成内容，需要详尽高密度的补充至.\README.md，以方便后续维护。
- DWS的表与表的字段 参考.\etl_billiards\docs\dwd_main_tables_dictionary.md 完成类似的数据库文档，方便后续维护。
- 注意中文编码需求。

## 通用需求
### 数据分层 
我希望使用互联网软件的业内通用方法，将数据按照更新时间分为4层，以符合业务层面的查询效率速度。
- 第一层：回溯两天前到当前数据。
- 第二层：回溯1个月前到当前数据。
- 第三层：回溯3个月前到当前数据。
- 第四层：全量数据。
- 需要有配套的机制及时添加删除整理数据。

### 统计注意
当统计一些数据时，注意口径，数据有效性标识。举例：
- 计算助教业绩/工资时，需要参考助教废除表，相关业务数据的影响。
- 计算助教业绩/工资时，注意辨别 助教课 附加课影响。

## 业务需求
### 系统设置
- 助教新的绩效考核和工资结算方式更新为以下算法，影响工资结算和财务账务方面的统计核算，相关内容需要落库，以方便后续调整。还要标记执行时间（如哪个月执行哪个标准等），执行相关结算和计算逻辑。：
档位原因考虑	总业绩小时数阈值	专业课抽成（元/小时）	打赏课抽成	次月休假（天）
0档 淘汰压力	H <100	28	50% 	3
1档 及格档（重点激励）	100≤ H <130	18	40%	4
2档 良好档（重点激励）	130≤ H <160	15	38%	4
3档 优秀档	160≤ H <190	13	35%	5
4档 卓越加速档（高端人才倾斜）	190≤ H <220	10	33%	6
5档 冠军加速档（高端人才倾斜）	H ≥220	8	30%	休假自由

*课程分为2种（dwd_assistant_service_log表的skill_name）：
基础课：又名 专业课 上桌 上钟，是为客户提供台球助教陪练的课程，按时长统计。精确到分钟。
附加课：又名 超休 激励 打赏，是客户支付较为高昂的价格，买断整小时与助教外出。
总业绩小时数阈值指基础课和附加课总和。

各级别助教（dim_assistant表的level）基础课，对客户收费：初级 98元/小时；中级 108元/小时；高级 118元/小时；星级 138元/小时；
附加课对客户收费统一为190元/小时。

充值提成：




冲刺奖 达成奖金
当月 H ≥ 190：300 元
当月 H ≥ 220：800 元（与上条不叠加，取高）

额外奖金：
冲刺奖 达成奖金
当月 H ≥ 190：300 元
当月 H ≥ 220：800 元（与上条不叠加，取高）

Top3 奖金：
第1名：1000 元
第2名：600 元
第3名：400 元

规则：
1、过档后，所有时长按新档位进行计算。
举例，当前某中级助教已完成185小时，基础课占170小时，附加课15小时。则该月工资计算方法：
170*（108-13）+15*（1-0.35）

2、本月新入职助教，定档方案： 
 按照日均*30的总业绩小时数定档。
 在该25日之后入职的新助教，最高定档至3档。
 该折算仅用于定档，不适用于“冲刺奖”和“Top3奖”的计算口径。

### 助教维度
以每个助教个体的视角
- 我要知道我的业绩档位，历史月份与本月档位进度，档位影响的收入单价。及相邻月份的变化。
- 我要知道我的有效业绩：历史月份与本月的 基础课课时，激励课课时，全部课课时。相邻月份的变化。
- 我要知道我的收入：历史月份与本月的收入（注意助教等级，业绩档位，课程种类等因素的总和计算）。相邻月份的变化。
- 我要知道我的客户情况：过去7天、10天、15天、30天、60天、90天 的跨度进行统计，我服务过（基础课+附加课）的客户数据，并关联每次服务的 时间 时长 台桌 分类 等详细信息。

### 客户维度
统计每个客户的信息
- 我要知道每个客户：过去7天、10天、15天、30天、60天、90天 的跨度进行统计，来店消费情况，并关联每次服务的 时间 食品饮品 时长 台桌 分类 助教服务 等详细信息。


### 财务维度
财务维度的需求（已经落到原型图需求级别了），见财务页面需求.md