Files
feiqiu-ETL/etl_billiards/docs/补充更多信息.md
2026-02-04 21:39:01 +08:00

167 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 补充更多信息:
## DWD数据库更新
DWD的数据库若干表中新增了若干表可能会对整个DWS层设计有影响/优化,重新思考可用的字段。
## 支出/成本数据缺失
财务页需要房租、水电、物业、工资、报销、平台服务费等现金支出与“支出结构”DWD 里只有商品成本 dwd_store_goods_sale.cost_money但价格也不对。缺少费用/薪酬/平台服务费等表,导致“现金支出/现金结余/结余率/支出结构”无法落地。
### 更新:
- 这些内容先在数据库结构中预留后期会通过Excel等方式手动导入。
## 平台回款与团购差价口径不足
需求有“平台回款”“团购差价”DWD 只有团购核销/验券记录dwd_groupbuy_redemption/dwd_platform_coupon_redemption没有平台结算/回款/佣金/服务费明细,无法算“平台回款”与“平台服务费”。
### 更新:
- 确认的平台服务费与回款金额先在数据库结构中预留后期会通过Excel等方式手动导入。
## 优惠分类无法分拆
财务页要区分“团购优惠/大客户优惠/赠送卡抵扣/其他优惠”DWD 仅有 member_discount_amount / coupon_amount / adjust_amount / rounding_amount / gift_card_amount / recharge_card_amount 等汇总字段,且没有“大客户”标识或优惠原因维表,无法稳定拆分口径。
### 更新:
- 赠送卡抵扣 指的就是 酒水卡+台费卡+活动抵用券 结账 抵扣的。
- 团购优惠: ledger_amount + assistant_promotion_money - ledger_unit_price
- 大客户优惠和其他优惠就是手动调账产生的优惠订单中的折扣、台桌折扣、商品折扣、手动优惠这几项关系需要确认下找100个样本进行分析
## “发生额/正价”口径不清
- 结账记录中的正价: tableChargeMoney台费正价goodsMoney商品正价assistantPdMoney助教基础课正价assistantCxMoney助教激励课正价
- 团购中的正价ledger_amount(台桌正价) + assistant_promotion_money(助教正价)
- 团购中的核销价ledger_unit_price
## 区域/房型维度不规范
筛选要“大厅A/B/C、麻将房、团建房/包厢”DWD 只有 site_table_area_name 等自由文本,没有规范维表映射,容易导致前端筛选不可控。
### 更新
BD_manual_dim_table.md 中,有台区分布的对应关系
## 充值与赠送卡口径缺口
需求中“储值卡充值实收(首充/续费、不含赠送)”与“赠送卡新增/消费/余额”细分酒水卡/台费卡/抵用券。DWD 里 dwd_recharge_order 没有明确“赠送金额”字段dim_member_card_account / dwd_member_balance_change 仅有卡类型名称,缺少“是否赠送”“卡类别标准枚举”,需要补充规则/维表。
### 更新
- 酒水卡,台费卡活动抵用券,台费卡 是赠送卡 分类在dim_member_card_account 的card_type_id对应的数据库说明书中有介绍。
- 储值卡是充值的“现金卡”
## 助教薪酬规则未闭合
DWS 需求里“充值提成”空缺,且“冲刺奖/额外奖金”重复;没有助教工资/结算流水表,财务页“助教分成/奖惩”无法核算。
### 更新
- 充值提成数据库结构中预留后期会通过Excel等方式手动导入。会记录时间充值金额储值卡卡关联充值提成金额。
- “冲刺奖/额外奖金”重复:按照薪资说明进行相应调整。
- 没有助教工资/结算流水表:为我增加相应的表。满足业务逻辑。
## 时间分层与筛选不匹配
### 更新
- UI 需要“最近半年不含本月、上季度”等时间维度并且满足上葛周期的环比。DWS 分层仅到 3 个月,可能导致查询性能或需要额外聚合层。财务方面需要特殊处理。
## 缺失 DDL
方案里列出的表没有全部给出结构定义,包括 cfg_tier_effective_period、dws_assistant_salary_calc、dws_member_visit_detail、dws_finance_discount_detail、dws_finance_recharge_summary、dws_finance_expense_summary。这些在 DWS_任务计划_v1.md 中仅出现在清单里,但没有 DDL会导致实施阶段卡住。
### 更新
- 补全DLL。
## SCD2 维度取数口径
助教等级在 dws_assistant_monthly_summary 用了 SCD2_is_current=1这是否会把“当前等级”套到历史月份能否满足需求中的“历史月份”统计是否要加一些数据筛选条件是否需按业务时间点做 as-of join基于有效期
## 附加课/基础课口径
方案中用 skill_name 判断“超休/激励/打赏”为附加课但我希望换成skill_id进行枚举避免漏记或误记落在库中可以使用名称。
## 财务指标可追溯口径
dws_finance_daily_summary 已覆盖“发生额/优惠/确认收入/现金流/充值”等字段但缺少“数据来源矩阵”字段→DWD表→公式。财务需求对“发生额(正价)”和“优惠”拆分非常细,需明确“正价”来源(台费价、助教等级价、商品原价)与“优惠”拆分口径(团购差价、大客户折扣、赠送卡抵扣、免单/抹零、手动调整)。
### 更新
- 增加 数据来源矩阵,记录数据的来龙去脉
我觉得还不够全,给你一些我整理的内容。
# 1.2 DWD 核心表与关键字段
还差好多,举例:
## 助教服务相关:
dwd_assistant_service_log
| `order_assistant_type` | 服务类型 | 1=基础课或包厢课, 2=附加课/激励课 | 这个不重要用skill_id判断就好。
另外服务时keh长服务的助教ID与花名客户关联台桌号台桌分类关联等也很重要。
## 客户相关:
客户姓名手机号生日以及关联的会员卡。
## 财务:
还有从结账记录出发关联的台桌流水助教流水
结算路径
充值流水等。
以上是否要补充?
---------------
## 订单获取的字段更新
### 订单各项正价小计
- 台费正价table_charge_money
- 商品正价goods_money
- 助教基础课/陪打正价assistant_pd_money
- 助教激励课/超休正价assistant_cx_money
### 支付信息
- 会员卡支付金额recharge_card_amount。卡类型还要从dwd_settlement_head的order_settle_id 去dwd_member_balance_change表找到卡的类型。
- 收银实付pay_amount。
- 团购抵消的台费coupon_amount。
- 团购支付的金额2条路径若pl_coupon_sale_amount非0 则使用pl_coupon_sale_amount。若pl_coupon_sale_amount为0且coupon_amount不为0那么需要到dwd_groupbuy_redemption找到对应的订单的ledger_unit_price。
### 订单优惠与打折
- 台费打折adjust_amount
- 团购券优惠:团购抵消的台费 - 团购支付的金额
-----------------
单独任务:
大客户优惠;抹零;其他优惠 需要抽样分析,当作一个单独任务为我分析执行。
| **会员折扣** | dwd_settlement_head | `member_discount_amount` | 会员身份折扣 | 这个貌似没有启用过,也为我作为单独任务分析处理吧。。
---------------
时间分层机制需求明确“四层时间分层近2天/近1月/近3月/全量)”,方案只写了更新频率,需补齐具体实现(分区策略/分层表或物化汇总层/定期归档与清理作业)。
DDL 完整性:补充说明中提到缺失的表(如 cfg_tier_effective_period、dws_assistant_salary_calc、dws_member_visit_detail、dws_finance_discount_detail、dws_finance_recharge_summary、dws_finance_expense_summary需要在 schema_dws.sql 里落全方案里写了“更新DDL”但应明确完整DDL清单与字段级定义。
薪酬规则与生效期:档位、奖金、规则有“按月/按时间生效”的要求,方案目前只有 cfg_performance_tier/cfg_bonus_rules需要补充生效期字段或独立“规则生效期配置表”否则历史月份口径会错。
SCD2 / as-of 口径助教等级是SCD2维度历史月份不能直接用“当前等级”。方案需明确“按有效期 as-of join”的取数规则。
技能枚举规范:需求要求用 skill_id 判断基础课/附加课;方案应明确 skill_id→课程类型映射可用配置表避免 skill_name 漏记。
滚动区间统计:需求中明确 7/10/15/30/60/90 天窗口,方案未明确存储方式(建议在 dws_assistant_customer_stats、dws_member_consumption_summary 中直接落多窗口字段,或新增滚动汇总表)。
财务口径矩阵需全覆盖:方案已有“数据来源矩阵”,但需扩展至财务页面每一项指标(发生额/优惠拆分/确认收入/现金流/充值/平台回款/支出结构),确保每一项都有明确字段+公式+来源表。
手工导入表规范:支出/平台回款/充值提成的Excel导入要补“字段定义、时间粒度、门店维度、去重与校验规则”否则实现阶段会反复返工。
区域/房型维表:方案已有 cfg_area_category但需落地“具体映射规则 + 默认兜底 + 异常值处理”,并与 BD_manual_dim_table.md 一致。
# 更新
时间口径定义:本周/上周/本季度/上季度/最近半年不含本月 等窗口的“起止边界”为月第一天0点。周起始日为周一。
环比规则:开启对比时,是“对比上一个等长区间”相比。
有效业绩的排除规则:仅对“助教废除表”的记录进行处理排除。其影响绩效。
新入职定档规则月1日0点之后入住的计算为新入职。入职日以助教表入职时间为准。
Top3 奖金排名口径按绩效总小时数。如遇并列则都算比如2个第一则记为2个第一一个第三。
充值提成规则:比例/阶梯/时间口径缺失:通过手动导入表格,表格中会明确月份,提成关联充值订单金额和助教获得的提成金额。
大客户优惠/其他优惠划分规则:目前需要抽样分析。
平台回款/服务费口径:明确导入数据字段包含:回款金额、佣金、服务费、回款日期、平台类型、订单关联键。
散客处理member_id=0 的客户是散客。不进入客户维度统计。
门店/租户范围:现在只有一个门店,一个租户。