# 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个月前到当前数据。
- 第四层：全量数据。
- 需要有配套的机制及时添加删除整理数据。

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

## 业务需求
### 系统设置
- 助教绩效与工资结算方案需落库并标记生效时间（按月取生效规则）。

**旧方案（2025年7月生效，历史口径）**
- 球房统一抽成：18元/小时
- 保底奖励机制：

| 保底线等级 | 对应完成小时数 | 保底收入 |
|-----------|----------------|----------|
| 初级 | 130 | 12000 |
| 中级 | 150 | 16000 |
| 高级 | 160 | 18000 |
| 星级 | 170 | 23000 |

- 保底与助教分成（客户支付减去球房抽成）取最大值发放
  - 注：旧方案为保底制，DWS档位表不直接建模保底，历史回溯需另行补录/修正

**新方案（2026-03-01起，现行口径）**

| 档位 | 总业绩小时数阈值 | 专业课抽成（元/小时） | 打赏课抽成 | 次月休假（天） |
|------|------------------|----------------------|------------|----------------|
| 0档 淘汰压力 | H < 120 | 28 | 50% | 3 |
| 1档 及格档 | 120 ≤ H < 150 | 18 | 40% | 4 |
| 2档 良好档 | 150 ≤ H < 180 | 13 | 35% | 5 |
| 3档 优秀档 | 180 ≤ H < 210 | 10 | 30% | 6 |
| 4档 销冠竞争 | H ≥ 210 | 8 | 25% | 休假自由 |

*课程类型（dwd_assistant_service_log 表的 skill_name）*
- 基础课：又名专业课/上桌/上钟，按分钟计时
- 附加课：又名超休/激励/打赏，按整小时计时
- 包厢课：归入基础课口径，客户支付统一 138 元/小时
- 总业绩小时数阈值 = 基础课 + 附加课

*客户支付价格*
- 基础课：初级 98 元/小时，中级 108 元/小时，高级 118 元/小时，星级 138 元/小时
- 附加课：统一 190 元/小时
- 包厢课（基础课）：统一 138 元/小时

*Top3 销冠奖（2026-03-01起）*
- 第1名：1000 元
- 第2名：600 元
- 第3名：400 元

规则：
1、过档后，所有时长按新档位进行计算。  
举例：当前某中级助教已完成185小时，基础课170小时，附加课15小时：  
170 × (108 - 10) + 15 × 190 × (1 - 0.30)

2、本月新入职助教定档：  
按日均 × 30 的总业绩小时数定档。  
在当月25日后入职的新助教，最高定档至2档（T2）。  
该折算仅用于定档，不适用于 Top3 奖的计算口径。

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

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


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