初始提交：飞球 ETL 系统全量代码

docs/requirements/DWS 数据库处理需求.md

@@ -0,0 +1,101 @@
+# 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
+
+