Updata2

etl_billiards/docs/补充更多信息.md

@@ -0,0 +1,167 @@
+# 补充更多信息：
+## 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 的客户是散客。不进入客户维度统计。
+
+门店/租户范围：现在只有一个门店，一个租户。