Files
ZQYY.FQ-ETL/docs/开发笔记/补充更多信息.md

10 KiB
Raw Blame History

补充更多信息:

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 的客户是散客。不进入客户维度统计。

门店/租户范围:现在只有一个门店,一个租户。