102 lines
4.8 KiB
Markdown
102 lines
4.8 KiB
Markdown
# 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
|
||
|
||
|