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

4.8 KiB Raw Permalink Blame History Unescape Escape