From 6f1d163a997d4ef2ba3efd1a8e8c110dfecfc301 Mon Sep 17 00:00:00 2001 From: Neo Date: Fri, 5 Dec 2025 18:57:20 +0800 Subject: [PATCH] =?UTF-8?q?DWD=E6=96=87=E6=A1=A3=E7=A1=AE=E8=AE=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DWD层设计草稿.md | 1373 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1373 insertions(+) create mode 100644 DWD层设计草稿.md diff --git a/DWD层设计草稿.md b/DWD层设计草稿.md new file mode 100644 index 0000000..e5603e0 --- /dev/null +++ b/DWD层设计草稿.md @@ -0,0 +1,1373 @@ +# 台球厅数仓 DWD 层数据库说明书 +本说明书详细列出了台球厅经营系统的 DWD 层表结构。 +每张表都包含字段名称、数据类型、来源、含义、是否属于主键/外键、以及枚举值解释。说明书依据《*-Analysis.md》中提供的字段说明整理完成，未出现省略号，确保字段信息完整可追溯。 +因业务需求，将一个表拆成主数据表和扩展数据表（Ex为后缀），如：维度表的门店数据表分为主表dim_site 和扩展表dim_site_Ex，主键相同，作为唯一关联标识。在业务代码处理的读和写时，使用统一处理方式，将数据视为一个表格。注意，极少数表，没有扩展表。 +**注意：考虑到后期分布式部署，以及测试的便利性。所有的“外键”的处理，使用业务处理，不在数据库中强制约束。** + + +## 维度表（DIM） + +### 门店维度表 +提取自各 ODS 中的 siteProfile 对象，如table_fee_transactions。记录门店的基本信息和配置，是其他事实表的外键。 + +**dim_site** +|数据库字段名|字段类型|来源字段（table_fee_transactions.siteProfile）|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|site_id|bigint|id|门店主键 ID。与各事实表中的 site_id 一致，用于唯一标识一个门店。|主键| +|org_id|bigint|org_id|组织 ID，例如品牌总部或上级组织标识。后续可关联组织维度，用于按组织层级统计。|外键| +|tenant_id|bigint|tenant_id|租户 ID（品牌商户 ID）。在多租户部署时区分不同品牌或老板。|外键| +|shop_name|varchar(255)|shop_name|门店名称，例如“朗朗桌球”。用于展示和按门店统计。|-| +|site_label|varchar(20)|site_label|门店标签，例如“A”。通常用于内部分类或标记门店类型/版本，具体含义需业务确认。|-| +|full_address|varchar(500)|full_address|门店详细地址，包含省市区及街道门牌号，用于地理展示与导航。|-| +|address|varchar(255)|address|简化地址描述，例如门店简称地址或商圈描述。便于在列表或报表中展示。|-| +|longitude|decimal(10,6)|longitude|门店经度坐标。可与 latitude 一起用于地图展示和地理分析。|-| +|latitude|decimal(10,6)|latitude|门店纬度坐标。与 longitude 配对使用。|-| +|tenant_site_region_id|bigint|tenant_site_region_id|区域行政编码或租户定义的区域编码，用于区域分组（如城市、商圈）。具体编码体系需业务确认。|外键| +|business_tel|varchar(50)|business_tel|门店联系电话，用于展示和客服联系。|-| +|site_type|tinyint|site_type|门店类型枚举字段，例如直营店、加盟店、体验店等。具体取值含义在样本中未给出，但对按门店类型分层分析可能重要。|-| +|shop_status|tinyint|shop_status|门店营业状态。当前样本中取值为 1 表示营业；其他取值（如 0）可能代表停业或关店，具体编码需业务确认。对分析是否纳入门店统计非常重要。|-| + + +**dim_site_Ex** +|数据库字段名|字段类型|来源字段（table_fee_transactions.siteProfile）|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|site_id|bigint|id|门店主键 ID。与各事实表中的 site_id 一致，用于唯一标识一个门店。|主键| +|auto_light|tinyint|auto_light|是否启用自动控灯。取值：0 表示不自动控灯；1 表示自动控灯。主要用于门店设备控制，不直接影响经营分析。|-| +|attendance_enabled|tinyint|attendance_enabled|是否启用考勤功能。取值：0 表示未启用考勤；1 表示启用考勤（助教/员工需在门店打卡）。可用于人力管理分析。|-| +|attendance_distance|int|attendance_distance|考勤打卡允许范围（单位通常为米），控制员工在多大范围内可以完成打卡。当前样本中多为 0，具体阈值含义需业务确认。|-| +|prod_env|tinyint|prod_env|环境标记字段，用于区分测试环境与生产环境。样本中仅出现 1，表示生产环境，其他取值含义需与业务系统确认。|-| +|light_status|tinyint|light_status|灯控状态标记，由门店灯控系统使用。具体枚举取值和业务含义未在文档中说明，例如是否表示“已接入/未接入”“开灯/关灯”等。|-| +|light_type|tinyint|light_type|灯控类型配置，用于区分不同灯控设备或协议。具体枚举值及含义未在样本中说明。|-| +|light_token|varchar(255)|light_token|灯控系统访问令牌或密钥，用于设备控制鉴权。对数据分析无直接作用。|-| +|avatar_url|varchar(500)|avatar|门店头像图片 URL，用于前端展示门店图片或 logo。|-| +|wifi_name|varchar(100)|wifi_name|门店 WiFi 名称，用于对外展示或员工内部查看。|-| +|wifi_password|varchar(100)|wifi_password|门店 WiFi 密码，仅用于员工或顾客上网便利配置。|-| +|customer_service_qrcode|varchar(500)|customer_service_qrcode|客服二维码图片 URL，例如微信客服或服务号二维码。便于前端展示。|-| +|customer_service_wechat|varchar(100)|customer_service_wechat|客服微信号或客服联系方式，用于展示与沟通。|-| +|fixed_pay_qrcode|varchar(500)|fixed_pay_qrCode|固定收款码二维码图片 URL（如收款静态码）。用于前端展示，不参与折扣或经营计算。|-| + + +**dim_site 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|site_id|主键|-|-|主键字段| +|org_id|外键|dim_organization|org_id|组织 ID，用于关联组织维度。| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID，用于区分不同品牌或老板。| +|tenant_site_region_id|外键|dim_region|region_id|区域 ID，用于区域分组。| + + + +### 台桌维度表 +来自 site_tables_master。每行代表一张球台或包厢，包含区域和业务角色信息。 + +**dim_table** +|数据库字段名|字段类型|来源字段|说明（含枚举值与取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|table_id|bigint|id|台桌主键 ID，全局唯一，用于关联所有与台相关的流水（台费、助教、台费打折等）。|主键| +|site_id|bigint|site_id|门店 ID，对应门店维表 dim_site.site_id。本样本中全部为同一门店，但结构上支持多门店。|外键| +|site_table_area_id|bigint|site_table_area_id|台桌所属区域 ID。与同一门店下的 area_name 一一对应，用于区分 A区/B区/包厢等业务区域。后续可抽象为区域维表主键。|-| +|area_name|varchar(64)|areaName|区域名称。样例枚举：A区、B区、补时长、C区、麻将房、VIP包厢、斯诺克区、K包、666、M7、k包活动区、TV台、M8、发财 等。用于前台展示与区域分析。|-| +|table_name|varchar(64)|table_name|台号/台名称。样例：A1~A18，B1~B6，S1~S4，VIP1、VIP2、VIP3、VIP5，TV台，M7，M8，666，888，发财，常乐，幸会(纯k)，董事办，补时长*，大包、小包 等。|-| +|table_status|tinyint|table_status|台当前状态（运行状态）。枚举：1=空闲中，2=使用中，3=暂停中。用于实时/历史台位利用率分析。|-| +|table_status_name|varchar(32)|tableStatusName|台状态的中文名称。当前枚举：空闲中、使用中、暂停中。为 table_status 的冗余展示字段。|-| +|show_status|tinyint|show_status|台在前台列表中的展示控制（推测）。样例分布：1=在普通开台列表中展示（大多数台），2=不在普通列表展示，多用于特殊房间（如“大包”“小包”）。一般与 is_online_reservation 组合使用来区分“线下台/线上预约房”。|-| +|create_time|datetime|create_time|台配置的创建时间（或最近一次复制/创建时间）。可用于分析门店台桌配置变更历史。本样本多集中在某几个日期批量创建。|-| + +**dim_table_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值与取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|table_id|bigint|id|台桌主键 ID，全局唯一，用于关联所有与台相关的流水（台费、助教、台费打折等）。|主键| +|table_price|decimal(10,2)|table_price|台基础单价字段（理论上用于按台配置单价）。本门店样本全部为 0.00，实际计费来自其他计价策略表或规则。暂不参与真实计费逻辑。|-| +|virtual_table|tinyint|virtual_table|虚拟台标记（推测）。枚举推测：0=物理台（实体球台/包厢），1=虚拟台（如合台、补钟虚拟台等）。样本数据全部为 0，系统实际是通过“特殊台名+计费逻辑”实现补时等功能，本字段当前未实际使用。|-| +|self_table|tinyint|self_table|自有台标记（推测）。枚举推测：1=本门店自有台，0=非自有/联营等场景。样本数据全部为 1，暂未体现非自营台。当前对分析影响有限。|-| +|is_rest_area|tinyint|is_rest_area|休息区标记（推测）。枚举推测：0=普通计费区域，1=休息区（可能不计费或计费逻辑不同）。样本数据全部为 0，未实际使用。|-| +|light_status|tinyint|light_status|灯光状态（推测）。结合命名和取值：1=开灯/可用，2=关灯/关闭。本样本大部分为 2（灯关），少数为 1。主要用于与智能灯控硬件联动，对经营分析一般不直接使用。|-| +|delay_lights_time|int|delay_lights_time|灯光延迟关闭时间（推测，单位秒或分钟）。当前全部为 0，说明未启用“结账后延迟关灯”功能。具体单位需与业务确认。|-| +|temporary_light_second|int|temporary_light_second|临时点灯时长（推测，单位秒）。例如前台手动开启临时灯光一段时间。本样本全部为 0，功能未启用。|-| +|audit_status|tinyint|audit_status|台配置审核状态。枚举（结合命名惯例）：2=已审核/已生效；其他值可能表示待审核/驳回（样本未出现）。样本所有台均为 2。在分析时通常过滤 audit_status != 2 的台。|-| +|charge_free|tinyint|charge_free|免单台标记（推测）。枚举推测：0=正常计费台，1=免单/不计费台。样本数据全部为 0，门店未配置免单台。含义未在其它文档中完全确认。|-| +|order_delay_time|int|order_delay_time|订单层面允许的自动延时时长（推测，单位秒或分钟），例如到点后自动延长计费。样本全部为 0，未启用此功能，具体业务规则待确认。|-| +|table_cloth_use_time|int|table_cloth_use_time|台呢累计使用时长。结合数值特征，极大概率单位为秒（例如 1,863,727 ≈ 517 小时）。用于维护/更换台呢的寿命统计。|-| +|table_cloth_use_cycle|int|table_cloth_use_Cycle|台呢使用周期阈值（推测，单位秒或小时），例如达到一定秒数后提醒更换。当前样本全部为 0，表示未设置阈值。实际规则未确认。|-| +|is_online_reservation|tinyint|is_online_reservation|是否允许线上预约。样例分布：1=允许线上预约（如“大包”“小包”），2=不允许线上预约（普通台）。通常与 show_status 组合决定台的业务角色（线下散客台 vs 线上预约房）。|-| +|only_allow_groupon|tinyint|only_allow_groupon|是否仅允许团购券使用（推测）。枚举推测：1=仅团购使用，2=不限（团购/非团购均可）。样本全部为 2，表示未设置“团购专用台”。规则未完全确认。|-| +|applet_qrcode_url|varchar(512)|appletQrCodeUrl|小程序二维码 URL，每张台一条，用于打印二维码贴在台上，支持顾客扫码呼叫服务、查看账单、发起线上预约等。对数仓分析一般不需要，仅在精细化运营或运维排查时偶尔使用。|-| +|site_name|varchar(128)|siteName|门店名称快照，样本为 "朗朗桌球"。冗余字段，展示用，门店名称应以 dim_site 为准。|-| + + +**dim_table 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|table_id|主键|-|-|主键字段| +|site_id|外键|dim_site|site_id|门店 ID，关联到 dim_site 表的 site_id。| +|site_table_area_id|外键|dim_area|area_id|台桌区域 ID，关联到 dim_area 表的 area_id。| + + + +### 助教档案维表 +对应 assistant_accounts_master。每行代表一位助教账号及其人事/账号状态。 + +**dim_assistant** +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|assistant_id|bigint|id|助教账号 ID，关联助教服务流水表。|主键| +|user_id|bigint|user_id|系统用户 ID，用于统一跨模块身份。|外键| +|assistant_no|varchar|assistant_no|助教工号/编号，业务识别用。|-| +|real_name|varchar|real_name|助教真实姓名。|-| +|nickname|varchar|nickname|前台展示昵称。|-| +|mobile|varchar|mobile|手机号码。|-| +|tenant_id|bigint|tenant_id|租户 ID。|外键| +|site_id|bigint|site_id|门店 ID。|外键| +|team_id|bigint|team_id|助教团队 ID。|外键| +|team_name|varchar|team_name|团队名称。|-| +|level|int|level|助教等级：8=管理员、10=初级、20=中级、30=高级、40=专家。|-| +|entry_time|datetime|entry_time|入职时间。|-| +|resign_time|datetime|resign_time|离职时间；远未来日期表示在职。|-| +|leave_status|int|leave_status|在职状态：0=在职，1=已离职。|-| +|assistant_status|int|assistant_status|账号启用状态：1=启用，2=停用/冻结。|-| + + +**dim_assistant_Ex** +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|assistant_id|bigint|id|助教账号 ID，关联助教服务流水表。|主键| +|gender|int|gender|性别枚举：0=未填/保密，1=男，2=女。|-| +|birth_date|datetime|birth_date|出生日期，默认为 0001-01-01 表示未设置。|-| +|avatar|varchar|avatar|头像 URL。|-| +|introduce|varchar|introduce|个人简介文案（目前为空）。|-| +|video_introduction_url|varchar|video_introduction_url|视频介绍 URL。|-| +|height|float|height|身高（厘米），0 表示未填。|-| +|weight|float|weight|体重（公斤），0 表示未填。|-| +|shop_name|varchar|shop_name|门店名称。|-| +|group_id|bigint|group_id|上级分组 ID，未使用。|-| +|group_name|varchar|group_name|上级分组名称，空。|-| +|person_org_id|bigint|person_org_id|人事组织 ID，用于权限和报表分组。|-| +|staff_id|bigint|staff_id|预留员工 ID（全部为0）。|-| +|staff_profile_id|bigint|staff_profile_id|外部人事档案 ID（全部为0）。|-| +|assistant_grade|float|assistant_grade|平均评分（0 表示暂无）。|-| +|sum_grade|float|sum_grade|总评分累加值。|-| +|get_grade_times|int|get_grade_times|累计评分次数。|-| +|charge_way|int|charge_way|计费方式：2=计时，其他未出现。|-| +|allow_cx|int|allow_cx|是否允许促销计费：1=允许。|-| +|is_guaranteed|int|is_guaranteed|是否有保底：1=是。|-| +|salary_grant_enabled|int|salary_grant_enabled|薪资发放开关（值2，具体含义未知）。|-| +|entry_type|int|entry_type|入职类型：1=正式；其他未出现。|-| +|entry_sign_status|int|entry_sign_status|入职签约状态：0=未签约，1=已签约（未出现）。|-| +|resign_sign_status|int|resign_sign_status|离职签约状态，未出现非 0。|-| +|work_status|int|work_status|工作状态：1=在岗，2=离岗。与 leave_status 呼应。|-| +|show_status|int|show_status|前台展示状态：1=显示；其他值未出现。|-| +|show_sort|int|show_sort|前端排序序号。|-| +|online_status|int|online_status|在线状态：1=在线。|-| +|is_delete|int|is_delete|逻辑删除标记：0=未删除，1=已删除。|-| +|criticism_status|int|criticism_status|投诉状态：1=正常，2=有投诉。|-| +|create_time|datetime|create_time|账号创建时间。|-| +|update_time|datetime|update_time|账号最近修改时间。|-| +|start_time|datetime|start_time|配置生效开始时间。|-| +|end_time|datetime|end_time|配置生效结束时间。|-| +|last_table_id|bigint|last_table_id|最近服务的台桌 ID（未必存在）。|-| +|last_table_name|varchar|last_table_name|最近服务球台名称。|-| +|last_update_name|varchar|last_update_name|最近更新该账号的管理员。|-| +|order_trade_no|bigint|order_trade_no|最近关联的订单号（非外键，仅做展示）。|-| +|ding_talk_synced|int|ding_talk_synced|是否同步钉钉：1=已同步。|-| +|site_light_cfg_id|bigint|site_light_cfg_id|灯控配置 ID（未启用）。|-| +|light_equipment_id|varchar|light_equipment_id|灯控设备 ID（未启用）。|-| +|light_status|int|light_status|灯控状态（值2，具体含义未知）。|-| +|is_team_leader|int|is_team_leader|是否团队长：0=否，1=是。|-| +|serial_number|bigint|serial_number|系统内部生成的序列号/排序标识，用于全局排序或历史迁移。| | +|system_role_id|INT|system_role_id|系统角色 ID。观测值全为 10，具体角色含义未在文档中给出，无法判断业务含义。| | +|pd_unit_price|DECIMAL(10,2)|pd_unit_price|标准单价（例如普通时段单价）配置。当前全部为 0，本门店未在账号层面定义单价，实际单价可能在商品/套餐配置中。|-| +|cx_unit_price|DECIMAL(10,2)|cx_unit_price|促销时段单价，当前全部为 0，未在账号维度启用。|-| +|job_num|VARCHAR(50)|job_num|备用工号字段。本数据中全部为空，当前门店未启用此工号体系。| | + + +**dim_assistant 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|assistant_id|主键|-|-|主键字段| +|user_id|外键|dim_user|user_id|系统用户 ID，用于统一跨模块身份。| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID，用于区分不同品牌或老板。| +|site_id|外键|dim_site|site_id|门店 ID，关联到 dim_site 表的 site_id。| +|team_id|外键|dim_team|team_id|助教团队 ID。| + +------------------------------------------------------------ + +### 会员档案维表 +对应 member_profiles。每行记录租户内某会员的主档信息，包括等级、状态、注册信息等。 + +**dim_member** +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|member_id|bigint|id|租户内会员主键。|主键| +|system_member_id|bigint|system_member_id|跨租户全局会员 ID。|外键| +|tenant_id|bigint|tenant_id|租户 ID。|外键| +|register_site_id|bigint|register_site_id|注册门店 ID。|外键| +|mobile|varchar|mobile|会员手机号。|-| +|nickname|varchar|nickname|昵称（未必是真实姓名）。|-| +|member_card_grade_code|int|member_card_grade_code|会员等级代码：1=金卡？2=银卡？3=钻石卡？4=黑卡？（按照 MD 文档枚举）。|-| +|member_card_grade_name|varchar|member_card_grade_name|等级名称，中文描述。|-| +|create_time|datetime|create_time|会员档案创建时间。|-| +| | | | | | + + + +**dim_member_Ex** + +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|member_id|bigint|id|租户内会员主键。|主键| +|referrer_member_id|bigint|referrer_member_id|推荐人会员 ID，营销分析用。|-| +|point|decimal|point|积分余额（暂未启用）。|-| +|register_site_name|varchar|site_name|注册门店名称。|-| +|growth_value|decimal|growth_value|成长值，暂未启用。|-| +|user_status|int|user_status|会员状态枚举：1=正常，其它值未出现。|-| +|status|int|status|帐户状态：1=正常；其它值未出现。|-| + + +**dim_member 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|member_id|主键|-|-|主键字段| +|system_member_id|外键|dim_system_member|system_member_id|跨租户全局会员 ID。| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID。| +|register_site_id|外键|dim_site|site_id|注册门店 ID。| + +### 已开通的会员卡账户视图 + +来自 member_stored_value_cards。每行代表一张会员卡账户的快照，记录卡种、持卡人、余额、有效期及各种折扣/扣款配置。 +重要说明：本视图不仅包含储值卡，还囊括活动抵用券、台费卡、酒水卡、月卡等多种卡种。 +大多数折扣/扣款字段在当前数据中保持默认值（如 10.0 表示不打折、100.0 表示全额抵扣、0 表示不启用），业务上暂未使用，但为系统预留能力。 + +**dim_member_card_account** +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|member_card_id|bigint|id|会员卡账户主键，唯一标识一张具体卡。|主键| +|tenant_id|bigint|tenant_id|租户/品牌 ID，用于分隔不同业务主体。|外键| +|register_site_id|bigint|register_site_id|开卡门店 ID，对应 dim_site.site_id。|外键| +|tenant_member_id|bigint|tenant_member_id|对应会员档案中的 member_id（本租户内）。0 表示未绑定会员。|外键| +|system_member_id|bigint|system_member_id|全局会员 ID，用于跨租户统一会员身份。0 表示未绑定会员。|外键| +|card_type_id|bigint|card_type_id|卡种 ID，指向卡种配置表。与下面的 grade_code 共同定义卡类别。|外键| +|member_card_grade_code|bigint|member_card_grade_code|卡等级/卡类代码，区别不同类别卡。2790683528022853=储值卡，2790683528022856=活动抵用券，2790683528022855=台费卡，2790683528022858=酒水卡，2790683528022857=月卡|-| +|member_card_grade_code_name|varchar|member_card_grade_code_name|卡等级中文名称，与 member_card_grade_code 一一对应。|-| +|member_card_type_name|varchar|member_card_type_name|卡类型名称，通常与 grade_code_name 相同，纯展示字段。|-| +|member_name|varchar|member_name|持卡会员姓名快照，部分为空表示未绑定。|-| +|member_mobile|varchar|member_mobile|持卡会员手机号快照。|-| +|balance|decimal|balance|当前余额或额度。对储值卡表示余额，对其他卡表示剩余金额或次数。|-| +|start_time|datetime|start_time|卡片有效期开始时间。|-| +|end_time|datetime|end_time|卡片有效期结束时间。|-| +|last_consume_time|datetime|last_consume_time|最近一次消费时间；若为 "1970-01-01" 表示未消费过。|-| +|status|int|status|卡状态：1=正常可用；4=过期/停用。其他值在数据中未出现。|-| +|is_delete|int|is_delete|逻辑删除标记：0=未删除；1=已删除。|-| + + + +**dim_member_card_account_Ex** + +|数据库字段名|字段类型|来源字段|说明|关键角色| +|---|---|---|---|---| +|member_card_id|bigint|id|会员卡账户主键，唯一标识一张具体卡。|主键| +|site_name|varchar|site_name|门店名称展示字段（全部相同）。|-| +|tenant_name|varchar|tenantName|租户名称（当前导出为空）。|-| +|tenant_avatar|varchar|tenantAvatar|租户头像 URL（当前导出为空）。|-| +|effect_site_id|bigint|effect_site_id|卡片限定生效门店 ID。0 表示不限门店，配合 able_cross_site=1 表示全店通用。|-| +|able_cross_site|int|able_cross_site|是否允许跨门店使用该卡：1=允许跨店；0=仅限开卡门店。|-| +|card_physics_type|int|card_physics_type|物理卡类型：1=实体/标准卡；其他值未出现，含义未知。|-| +|card_no|varchar|card_no|物理卡号或条码（当前全部为空）。|-| +|bind_password|varchar|bind_password|卡绑定密码（未启用）。|-| +|use_scene|varchar|use_scene|使用场景说明（当前为空）。|-| +|denomination|decimal|denomination|面额或初始储值额度（当前均为0.0，未启用）。|-| +|create_time|datetime|create_time|卡片创建时间。|-| +|disable_start_time|datetime|disable_start_time|卡片禁用开始时间，当前为默认值表示未禁用。|-| +|disable_end_time|datetime|disable_end_time|卡片禁用结束时间，当前为默认值表示未禁用。|-| +|is_allow_give|int|is_allow_give|是否允许转赠给他人：0=不允许；1=允许。|-| +|is_allow_order_deduct|int|is_allow_order_deduct|是否允许在订单层面统一扣款：0=不允许；1=允许。|-| +|sort|int|sort|前端排序序号。|-| +|table_discount|float|table_discount|台费折扣率（折扣百分比，10.0=不打折，9.0=九折等）。当前全部 10.0。|-| +|goods_discount|float|goods_discount|商品折扣率，当前为 10.0 表示无折扣。|-| +|assistant_discount|float|assistant_discount|助教服务折扣率，当前为 10.0。|-| +|assistant_reward_discount|float|assistant_reward_discount|助教奖励折扣率，当前为 10.0（未启用）。|-| +|table_service_discount|float|table_service_discount|台费服务类折扣率，当前为 10.0。|-| +|goods_service_discount|float|goods_service_discount|商品服务折扣率，当前为 10.0。|-| +|assistant_service_discount|float|assistant_service_discount|助教服务类折扣率，当前为 10.0。|-| +|coupon_discount|float|coupon_discount|使用券的折扣比例（全部 10.0，未使用）。|-| +|table_discount_sub_switch|int|table_discount_sub_switch|台费折扣叠加开关：1=叠加其他折扣；2=不叠加，仅用卡折扣。|-| +|goods_discount_sub_switch|int|goods_discount_sub_switch|商品折扣叠加开关，意义同上。|-| +|assistant_discount_sub_switch|int|assistant_discount_sub_switch|助教折扣叠加开关，意义同上。|-| +|assistant_reward_discount_sub_switch|int|assistant_reward_discount_sub_switch|助教奖励折扣叠加开关（未启用）。|-| +|goods_discount_range_type|int|goods_discount_range_type|商品折扣范围类型，未在文档说明具体含义。|-| +|table_deduct_radio|float|table_deduct_radio|台费抵扣比例（百分比）。100.0 表示允许全额抵扣；0=不允许。|-| +|goods_deduct_radio|float|goods_deduct_radio|商品抵扣比例，意义同上。|-| +|assistant_deduct_radio|float|assistant_deduct_radio|助教抵扣比例，意义同上。|-| +|table_service_deduct_radio|float|table_service_deduct_radio|台费服务金抵扣比例。|-| +|goods_service_deduct_radio|float|goods_service_deduct_radio|商品服务金抵扣比例。|-| +|assistant_service_deduct_radio|float|assistant_service_deduct_radio|助教服务金抵扣比例。|-| +|assistant_reward_deduct_radio|float|assistant_reward_deduct_radio|助教奖励金抵扣比例（未启用）。|-| +|coupon_deduct_radio|float|coupon_deduct_radio|券抵扣比例（未启用）。|-| +|card_settle_deduct|float|cardSettleDeduct|结算时统一扣卡金额配置（当前为 0.0，未使用）。|-| +|table_card_deduct|float|tableCardDeduct|台费扣卡金额配置，当前 0.0。|-| +|table_service_card_deduct|float|tableServiceCardDeduct|台费服务金扣卡金额配置。|-| +|goods_card_deduct|float|goodsCarDeduct|商品扣卡金额配置。|-| +|goods_service_card_deduct|float|goodsServiceCardDeduct|商品服务金扣卡金额配置。|-| +|assistant_card_deduct|float|assistantCardDeduct|助教扣卡金额配置。|-| +|assistant_service_card_deduct|float|assistantServiceCardDeduct|助教服务金扣卡金额配置。|-| +|assistant_reward_card_deduct|float|assistantRewardCardDeduct|助教奖励金扣卡金额配置（未启用）。|-| +|coupon_card_deduct|float|couponCardDeduct|使用券扣卡金额配置。|-| +|delivery_fee_deduct|float|deliveryFeeDeduct|配送费扣卡金额配置（未启用）。|-| +|table_area_id|jsonb|tableAreaId|可用台区 ID 列表，空表示不限台区。|-| +|goods_category_id|jsonb|goodsCategoryId|可用商品分类 ID 列表，空表示不限制商品类别。|-| +|pd_assistant_level|jsonb|pdAssistantLevel|允许的陪打助教等级列表，空表示不限。|-| +|cx_assistant_level|jsonb|cxAssistantLevel|允许的促销助教等级列表，空表示不限。|-| + + +**dim_member_card_account 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|member_card_id|主键|-|-|主键字段| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID。| +|register_site_id|外键|dim_site|site_id|开卡门店 ID。| +|tenant_member_id|外键|dim_member|member_id|会员档案中的会员 ID。| +|system_member_id|外键|dim_system_member|system_member_id|全局会员 ID。| +|card_type_id|外键|dim_card_type|card_type_id|卡种 ID。| +------------------------------------------------------------ +### 租户级商品档案 +来自 tenant_goods_master。每行代表一款商品标准定义。 + +**dim_tenant_goods** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|tenant_goods_id|BIGINT|id|租户级商品档案主键 ID，唯一标识一条商品档案。所有业务事实表（销售、库存等）中引用租户级商品时应指向此字段。|主键| +|tenant_id|BIGINT|tenant_id|租户/品牌 ID，用于区分不同商户。当前样本中全表同一值，但模型上应作为维表外键，用于关联租户维度。|外键| +|supplier_id|BIGINT|supplier_id|供应商 ID，用于关联供应商档案维度。当前样本全部为 0，说明门店尚未维护供应商信息或导出视图未包含真实供应商关联，但字段含义明确。|外键| +|category_name|VARCHAR(64)|categoryName|商品一级分类名称（可读名称），例如：零食、饮料、香烟、雪糕、小吃、酒水、面、槟榔等。真实分类关联通过 goods_category_id 与 goods_second_category_id 实现，此字段主要用于展示和直观分析。|-| +|goods_category_id|BIGINT|goods_category_id|商品一级分类 ID。与分类维表（例如 dim_goods_category）关联，构成商品分类的第一层。一个 goods_category_id 对应一个 category_name。|外键| +|goods_second_category_id|BIGINT|goods_second_category_id|商品二级分类 ID。与分类维表的二级节点关联，用于更细粒度的品类统计。取值数目约十四种，每个值属于某个一级分类之下。|外键| +|goods_name|VARCHAR(128)|goods_name|商品名称（前台展示名），如 “东方树叶”“红烧牛肉面”“百威 235 毫升”等。当前样本中基本唯一。作为用户认知的主显示名称，用于报表、前台展示、小票打印。|-| +|goods_number|VARCHAR(64)|goods_number|商品内部编号或自定义货号。当前样本中各记录不重复，如 “1”“2”“10”“11” 等。可用于与其他系统对接或人工查找，有一定对账和排错价值。|-| +|unit|VARCHAR(16)|unit|商品计量单位，例如：瓶、包、个、份、根、盒、杯、桶、盘、支等。用于解释数量含义，是销售数量与库存数量的度量单位。|-| +|market_price|DECIMAL(18,2)|market_price|商品标价或标准销售单价。例如 2、5、6、8、10、12、15、18、20、28 元。POS 默认销售价格，结算时的基础金额字段。|-| +|goods_state|INT|goods_state|商品状态枚举。当前样本全部为 1，推测含义为“正常”“已上架”或“有效”。其他值（数据中未出现）通常表示下架、停用或草稿状态。用于控制商品是否可销售。|-| +|create_time|DATETIME|create_time|商品档案创建时间，格式为 “YYYY-MM-DD HH:MM:SS”。每条记录唯一。用于增量抽取和审计，也可用于分析商品生命周期。|-| +|update_time|DATETIME|update_time|商品档案最近一次修改时间，可为空（表示自创建后未修改）。用于增量同步、变化跟踪和审计分析。|-| +|is_delete|INT|is_delete|逻辑删除标志。枚举：0 表示未删除（有效商品）；1 表示已逻辑删除（在前台不再展示）。当前样本全部为 0。用于软删除控制和历史数据保留。|-| + + +**dim_tenant_goods_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|tenant_goods_id|BIGINT|id|租户级商品档案主键 ID，唯一标识一条商品档案。所有业务事实表（销售、库存等）中引用租户级商品时应指向此字段。|主键| +|remark_name|VARCHAR(128)|remark_name|商品备注名或别名，目前样本中均为空。设计用途为简写名、特殊展示名或内部备注，在当前门店尚未启用。|-| +|pinyin_initial|VARCHAR(128)|pinyin_initial|商品拼音首字母或助记码，用于前台按拼音检索，如 “DFSY,DFSX”“HSNRM,GSNRM”“SP” 等。主要为操作便利，对经营分析影响较小。|-| +|goods_cover|VARCHAR(512)|goods_cover|商品封面图片 URL，用于前端展示商品图片。多个商品可能共用同一图片。对经营和结算逻辑无直接影响。|-| +|goods_bar_code|VARCHAR(64)|goods_bar_code|商品条码（如 EAN 码）。当前样本全部为空。含义明确但尚未使用，未来可用于扫码收银或与第三方商品库对接。|-| +|commodity_code|VARCHAR(64)|commodity_code|对外商品编码或系列编码，用于与外部系统或其他内部模块对接。例如 “10000”“100000”“10000028”等。一个编码在多条商品上复用，说明它不是主键而是“系列标识”或“外部编码”。具体业务含义依赖上游系统定义。|-| +|commodity_code_list|VARCHAR(256)|commodityCode|商品编码列表的序列化形式，对应源 JSON 的数组字段（当前每条记录仅一个元素）。设计上支持 “一个商品多个编码” 场景，目前仅为 commodity_code 的冗余表现形式。|-| +|min_discount_price|DECIMAL(18,2)|min_discount_price|商品可售最低价（底价）。部分记录为 0.00，表示未设置底价或沿用系统默认规则。用于限制打折或手动改价的下限，防止亏损销售。|-| +|cost_price|DECIMAL(18,2)|cost_price|商品成本价，当前大多数为 0.00，仅少数录入 2.0、2.5、3.0 等。用于成本核算与毛利分析。虽当前门店未完整维护，但字段含义清晰，属于成本分析必备结构。|-| +|cost_price_type|INT|cost_price_type|成本价格类型枚举，用于标识成本价的来源或计算方式。已知取值：1 和 2。常见推测：1 表示手工录入成本；2 表示按最近进货价或加权平均价生成。具体含义需结合系统枚举字典确认。|-| +|able_discount|INT|able_discount|是否允许该商品参与折扣的标志。已知取值：1。按命名推断枚举约定为：1 表示允许参与打折；0 表示不允许参与打折（当前样本未出现）。配合活动、整单折扣等控制哪些商品可享优惠。|-| +|sale_channel|INT|sale_channel|销售渠道类型枚举。当前样本全部为 1，推测为“线下门店正常销售渠道”。理论上可扩展为不同渠道值，例如外卖、小程序、电商等，用于渠道维度分析。具体枚举说明依赖系统配置。|-| +|is_warehousing|INT|is_warehousing|是否纳入库存管理的标志。已知取值：1，表示纳入库存管理；0 则表示不纳入库存管理（虚拟商品等，当前未出现）。本门店所有商品均启用库存管理。|-| +|is_in_site|boolean|isInSite|是否在当前门店启用或上架。当前样本全部为 false。由于该文件是租户级商品档案视图，且 isInSite 全为 false，该字段在本视图的实际含义存在不确定性，可能仅在门店级商品表中才有明确业务意义。|-| +|able_site_transfer|INT|able_site_transfer|是否允许门店间调拨或门店级操作的枚举。已知取值：2 为绝大多数，0 为少数一条。按命名推测大致含义为：2 表示允许调拨或默认允许；0 表示禁止调拨。实际枚举定义需查阅系统配置，当前无法完全确定具体业务规则。|-| +|common_sale_royalty|INT|common_sale_royalty|普通销售提成或佣金配置字段，单位和含义需结合上游系统（可能为金额或比例）。当前样本全部为 0，说明未启用商品级提成配置。|-| +|point_sale_royalty|INT|point_sale_royalty|积分销售相关的提成或赠送规则配置字段。当前样本全部为 0，同样未启用该功能。具体数值含义（百分比或固定值）需结合系统定义。|-| +|out_goods_id|BIGINT|out_goods_id|外部系统商品 ID，用于对接第三方平台或统一商品库时作为映射主键。目前样本全部为 0，说明尚未配置外部商品映射，具体对接规则依赖上游系统。|-| + + +**dim_tenant_goods 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|tenant_goods_id|主键|-|-|主键字段| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID。| +|supplier_id|外键|dim_supplier|supplier_id|供应商 ID。| +|goods_category_id|外键|dim_goods_category|category_id|商品一级分类 ID。| +|goods_second_category_id|外键|dim_goods_category|category_id|商品二级分类 ID。| + + + +------------------------------------------------------------ + +### 门店级商品档案 +来自 store_goods_master.json。每行代表门店自定义的商品 SKU，包括售价和折扣。关联到 dim_tenant_goods 和分类维度。 + +**dim_store_goods** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|site_goods_id|bigint|id|门店级商品 ID，本表主键；其它业务表中的 site_goods_id 与此对应，用于库存、销售等关联。|主键| +|tenant_id|bigint|tenant_id|租户/品牌 ID，同一品牌下多个门店共享，用于跨门店汇总分析。|外键| +|site_id|bigint|site_id|门店 ID，对应门店维度表主键。|外键| +|tenant_goods_id|bigint|tenant_goods_id|租户级（品牌级）商品 ID，用于关联 dim_tenant_goods，实现跨门店统一商品档案。|外键| +|goods_name|varchar|goods_name|商品名称，例如“合味道泡面”“地道肠”“茶位费”。|-| +|goods_category_id|bigint|goods_category_id|商品一级分类 ID，对应商品分类维表主键，与 category_level1_name 一一对应。|外键| +|goods_second_category_id|bigint|goods_second_category_id|商品二级分类 ID，其父分类为 goods_category_id。|外键| +|category_level1_name|varchar|oneCategoryName|一级分类名称，如“零食”“酒水”“服务费”，用于报表维度展示。|-| +|category_level2_name|varchar|twoCategoryName|二级分类名称，如“面”“洋酒”“纸巾”，用于更细粒度分类分析。|-| +|batch_stock_qty|int|batch_stock_quantity|当前成本批次的库存数量，用于按 cost_price 估算库存价值。|-| +|sale_qty|int|sale_num|截至导出时的销售数量（件），当前数据中与 total_sales_qty 相同。|-| +|total_sales_qty|int|total_sales|累计销售数量；当前导出周期下与 sale_qty 一致，为历史全量口径。|-| +|sale_price|decimal(18,2)|sale_price|商品标准销售价（挂牌价），单位为元。实际结算可能有折扣或券抵扣。|-| +|created_at|datetime|create_time|门店商品档案创建时间（在门店建立该商品档案时的时间点）。|-| +|updated_at|datetime|update_time|最近一次修改商品档案的时间（包括价格调整、状态变更等）。|-| +|avg_monthly_sales|decimal(18,4)|average_monthly_sales|平均月销量（件/月），由某个统计周期内销售数据折算而来，用于补货和品类管理分析。|-| +|goods_state|tinyint|goods_state|商品基础状态枚举：1=正常状态（主流值），2=特殊状态（如新建未完全启用或停售但未彻底下架，通常伴随 stock=0、days_on_shelf=0）。|-| +|enable_status|tinyint|enable_status|档案启用状态：1=启用；2=停用（推测，样本中未出现）；控制商品档案是否参与业务处理。|-| +|send_state|tinyint|send_state|销售端可售状态：1=可销售/可下单；其他值可能代表停售或仅内部使用（当前样本全部为 1）。|-| +|is_deleted|tinyint|is_delete|逻辑删除标志：0=未删除（有效档案）；1=已删除（逻辑删除，不再参与业务但保留历史引用）。|-| + + +**dim_store_goods_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|site_goods_id|bigint|id|门店级商品 ID，本表主键；其它业务表中的 site_goods_id 与此对应，用于库存、销售等关联。|主键| +|site_name|varchar|siteName|门店名称，例如“朗朗桌球”，是对 site_id 的冗余展示，方便直接阅读。|-| +|unit|varchar|unit|销售计量单位，如“包”“瓶”“个”“份”“杯”等。|-| +|goods_barcode|varchar|goods_bar_code|商品条形码，用于扫码销售；当前样本多为空。|-| +|goods_cover_url|varchar|goods_cover|商品图片 URL，用于前端展示商品图片。|-| +|pinyin_initial|varchar|pinyin_initial|商品名称拼音首字母缩写，有时多个别名用逗号分隔，用于按字母快速检索和排序。|-| +|stock_qty|int|stock|当前主单位可用库存数量，以 unit 为单位。|-| +|stock_secondary_qty|int|stock_A|副单位库存数量；若商品存在双单位（如箱/瓶），用于记录副单位库存；当前门店未启用双单位库存，样本中为 0。|-| +|safety_stock_qty|int|safe_stock|安全库存阈值，低于该值时系统可提示补货；当前门店尚未配置，样本中为 0。|-| +|cost_price|decimal(18,4)|cost_price|商品单件成本价，单位元；部分商品为 0，表示未录入或由其它模块结转成本。|-| +|cost_price_type|tinyint|cost_price_type|成本类型枚举：1=固定成本价（按 cost_price 计），2=动态成本价（按采购单等方式结转，当前多数仍为暂估）。|-| +|provisional_total_cost|decimal(18,2)|provisional_total_cost|当前库存暂估总成本，单位元；通常约等于 batch_stock_qty × cost_price。|-| +|total_purchase_cost|decimal(18,2)|total_purchase_cost|当前库存总采购成本，单位元；当前样本中与 provisional_total_cost 相等，为后续精算成本预留。|-| +|min_discount_price|decimal(18,2)|min_discount_price|最低允许成交价（限价），单位元；收银改价时需保证成交价 ≥ 此值，为 0 时表示未设置限价或由其它规则控制。|-| +|is_discountable|tinyint|able_discount|是否允许参与折扣的标志：1=允许参与折扣；0=不参与任何折扣策略。当前样本全部为 1。|-| +|days_on_shelf|int|days_available|商品在架天数或可售天数，大致等于当前时间减去首次上架时间；0 通常表示刚建档或刚启用。|-| +|audit_status|tinyint|audit_status|审核状态枚举：2=审核通过（当前唯一值）；其他值可能代表待提交、待审核、审核不通过等。|-| +|sale_channel|tinyint|sale_channel|销售渠道枚举：当前样本全部为 1 表示线下门店渠道；其他值可用于区分外卖、线上商城等渠道。|-| +|is_warehousing|tinyint|is_warehousing|是否纳入库存管理：1=参与库存管理（有出入库流水）；0 或其他值可能表示不计库存（样本中全部为 1）。|-| +|freeze_status|tinyint|freeze|冻结状态：0=未冻结；非 0 可能表示锁定库存或禁止出库，具体业务规则需系统确认。|-| +|forbid_sell_status|tinyint|forbid_sell_status|禁止销售状态：1=未禁止，允许销售；2=被禁止销售，即使上架也不能卖（含义基于命名和行业惯例推测）。|-| +|able_site_transfer|tinyint|able_site_transfer|是否允许跨门店调拨或跨站点共享库存：2=不允许跨店调拨（当前主流值）；0=未配置（个别记录），含义为是否参与跨店调拨功能。|-| +|custom_label_type|tinyint|custom_label_type|自定义标签类型（基于字段名和取值推测）：2=使用自定义标签；1 可能表示使用系统默认标签。具体影响哪些标签功能需业务确认。|-| +|option_required|tinyint|option_required|是否需要额外选项或规格（基于字段名和取值推测）：1=不需要额外选项，按单规格销售；其他值可能表示必须选择配料或口味。当前样本全部为 1。|-| +|remark|varchar|remark|商品备注，可填写口味说明、供应商信息、注意事项等；当前样本全部为空。|-| +|sort_order|int|sort|前端展示排序权重，控制商品在列表中的显示顺序，具体规则（数值越大还是越小排前）由业务配置决定。|-| + + +**dim_store_goods 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|site_goods_id|主键|-|-|主键字段| +|tenant_id|外键|dim_tenant|tenant_id|租户 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|tenant_goods_id|外键|dim_tenant_goods|tenant_goods_id|租户级商品 ID。| +|goods_category_id|外键|dim_goods_category|category_id|商品一级分类 ID。| +|goods_second_category_id|外键|dim_goods_category|category_id|商品二级分类 ID。| + + +------------------------------------------------------------ + +### 商品分类索引树 +来自 stock_goods_category_tree.json。要点与建模建议： +- 仅两级：根节点 pid=0，子节点 pid=父 id，无孙节点；categoryBoxes 只是子节点数组。 +- 原始 JSON 分页重复两次，去重后只有 26 个节点（9 个根 + 17 个子）。 +- DWD 存储：打平一行一节点，保留 id/pid/category_name/alias_name/tenant_goods_business_id/sort/is_warehousing 等字段，categoryBoxes 不必存；以 id 为主键，pid 作为同表父级外键。 + +**dim_goods_category** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|category_id|bigint|id|分类节点主键。来自分类树节点的 id，在整个商品分类维度内唯一。用于在事实表中作为商品分类外键引用。|主键| +|tenant_id|bigint|tenant_id|租户 ID（商户/品牌 ID）。当前所有节点取值相同，表示同一个租户下的分类树。事实表可通过该字段与租户维度或门店维度间接关联。|外键| +|category_name|varchar(50)|category_name|分类名称。一级大类示例：槟榔、器材、酒水、水果、零食、雪糕、香烟、其他、小吃。二级子类示例：槟榔、皮头、球杆、其他、饮料、酒水、茶水、咖啡、加料、洋酒、果盘、面、小吃等。用于前台展示和报表按细分类统计。|-| +|alias_name|varchar(50)|alias_name|分类别名。当前样例数据全部为空字符串，预留给业务方做简称或别名展示。对现阶段经营分析无影响。|-| +|parent_category_id|bigint|pid|父级分类 ID。根节点取值为 0，表示没有父分类；子节点取值为父分类的 id。与 category_id 共同形成树形层级关系。|外键| +|business_name|varchar(50)|business_name|业务大类名称。将多个细分类归入同一业务线。观测值与一级大类相同：槟榔、器材、酒水、水果、零食、雪糕、香烟、其他、小吃。子类的 business_name 继承所属根节点的大类名称。用于按业务线汇总库存和销售。|-| +|tenant_goods_business_id|bigint|tenant_goods_business_id|业务大类 ID。每个 business_name 对应唯一一个 tenant_goods_business_id，根节点和其下所有子节点共享同一取值。例如“酒水”大类及其子类饮料、茶水、咖啡、加料、洋酒拥有相同的业务 ID。可作为外键连接“业务线维度表”。|外键| +|category_level|tinyint|由 pid 推导|分类层级：1 表示一级大类（pid = 0），2 表示二级子类（pid ≠ 0）。方便在报表中区分大类与子类进行分组和展示层级控制。|-| +|is_leaf|tinyint|由 categoryBoxes 推导|是否叶子节点：1 表示叶子分类（categoryBoxes 为空列表），0 表示非叶子分类（存在子分类）。当前样例数据中，一级大类是非叶子节点，二级分类是叶子节点。用于树状导航或限制只能在叶子分类建商品。|-| +|open_salesman|tinyint|open_salesman|营业员开关控制。枚举含义根据业务系统定义，一般设计为：1 表示启用营业员/导购相关功能，2 表示关闭或不启用。当前样例所有分类取值为 2，说明这一套分类在库存模块中统一未启用营业员逻辑。对目前的经营分析影响较小。|-| +|sort_order|int|sort|分类排序序号。来自 sort 字段，用于前端展示顺序控制，数值越小越靠前。当前大部分分类为 0，仅少数为 1，说明排序配置较为粗略。对指标统计无实质影响。|-| +|is_warehousing|tinyint|is_warehousing|是否参与库存管理。枚举：1 表示参与库存管理，0 表示不参与（如服务类商品、手工费用）。当前文件中所有分类取值为 1，表示这一份分类树只包含“走库存”的商品分类。可在库存报表中用作过滤条件。|-| + + + +------------------------------------------------------------ + +### 团购套餐定义 +来自 group_buy_packages。每行代表一种团购套餐及其使用规则。 + +**dim_groupbuy_package** +|数据库字段名|字段类型|来源字段|说明（含枚举与取值说明）|角色| +|---|---|---|---|---| +|groupbuy_package_id|bigint|id|门店侧团购套餐主键。每条记录一个套餐定义，供团购券核销记录指向。平台验券记录中的 group_package_id 通常指向这里。|主键| +|tenant_id|bigint|tenant_id|租户（品牌/商户）ID。本数据集中全表相同，表示同一品牌。|外键（指向租户维）| +|site_id|bigint|site_id|门店 ID，本表所有记录属于同一门店。与其他 JSON 的 site_id 一致。|外键（指向门店维）| +|package_name|varchar(200)|package_name|团购套餐名称，用于前台展示及核销界面，例如“早场特惠一小时”“KTV欢唱四小时”等。|-| +|package_template_id|bigint|package_id|上层套餐 ID 或总部/系统级套餐 ID。多个 groupbuy_package_id 可能共享同一个 package_template_id，表示同一业务套餐在不同门店或不同版本下的配置。|外键（指向套餐模板维，后续可建）| +|selling_price|decimal(10,2)|selling_price|团购售卖价，面向顾客在外部平台的成交价格。当前样本全部为 0，实际平台售价可能在外部系统，不在本地落地。|-| +|coupon_face_value|decimal(10,2)|coupon_money|券面值或内部结算面值。表示此套餐在门店侧可以抵扣的金额，用于验券或套餐流水时记账。例如“早场特惠一小时”可配置为 40.00，“KTV欢唱四小时”可配置为 200.00。当前样本为 0 但字段设计上非常关键。|-| +|duration_seconds|int|duration|套餐包含的时长，单位为秒。常见取值：3600 表示 1 小时，7200 表示 2 小时，14400 表示 4 小时。核销时可用于换算可用台费时长。|-| +|start_time|datetime|start_time|套餐整体生效开始时间。例如“2025-07-20 00:00:00”。通常从某日零点开始。|-| +|end_time|datetime|end_time|套餐整体生效结束时间。在该时间点之后不可使用。极大日期（如 9999-12-31 23:59:59）可视为长期有效。|-| +|table_area_name|varchar(100)|table_area_name|套餐适用的门店台区名称，例如“A区中八”“B区中八”“斯诺克”“包厢”“KTV”等。主要用于展示和过滤，配合区域 ID 列实现人类可读的说明。|-| +|is_enabled|int|is_enabled|启用状态枚举。1 表示启用或上架；2 表示停用或下架。侧重表示“配置是否上架”，与 effective_status 区分。|-| +|is_deleted|int|is_delete|逻辑删除标志。0 表示正常；1 表示逻辑删除（数据仍保留但不再使用）。当前样本全部为 0。|-| +|create_time|datetime|create_time|套餐配置在系统中的创建时间，用于审计和版本追踪。|-| +|tenant_table_area_id_list|varchar(512)|tenant_table_area_id_list|租户级台区分组 ID 列表。当前每条记录为一个大整数（例如 2791960001957765）字符串，表示“台区分组”主键。系统通过此分组再关联到具体多个台区。|外键（指向台区分组维，后续可建）| +|card_type_ids|varchar(255)|card_type_ids|允许使用本套餐的会员卡类型 ID 列表。当前样本统一为字符串“0”，表示未限制卡种，任意顾客或任意会员卡都可使用。若未来启用，将以分隔的 ID 列表形式记录限定卡种。|外键（潜在指向卡种维）| + + + +**dim_groupbuy_package_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举与取值说明）|角色| +|---|---|---|---|---| +|groupbuy_package_id|bigint|id|门店侧团购套餐主键。每条记录一个套餐定义，供团购券核销记录指向。平台验券记录中的 group_package_id 通常指向这里。|主键| +|site_name|varchar(100)|site_name|门店名称，当前均为“朗朗桌球”。属于冗余展示字段，可用于报表标题。|-| +|usable_count|int|usable_count|可使用次数上限。当前全部为 9999999，用作“无限次使用”的哨兵值。若未来限制次数，只需配置为具体次数。|-| +|date_type|int|date_type|日期限制类型枚举。当前样本全部为 1。推测常见含义：1 表示“全部日期可用”；其他值可用于区分工作日、周末或指定日期等模式。|-| +|usable_range|varchar(255)|usable_range|日期范围说明的文本，例如“周一至周五”等。当前全部为空字符串，实际规则由 date_type 与时间段字段控制。|-| +|date_info|varchar(255)|date_info|更细粒度的日期信息，可能用于存储具体日期列表或节假日规则，形式可能是编码或 JSON 字符串。当前几乎全部为空，仅有极少记录为“0”。|-| +|start_clock|varchar(16)|start_clock|每日可用时间段的起始时间（第一段），字符串格式 HH:MM:SS，例如“10:00:00”“00:00:00”。与 end_clock 组合定义日内时段。|-| +|end_clock|varchar(16)|end_clock|每日可用时间段的结束时间（第一段），字符串格式 HH:MM:SS。与 start_clock 共同描述第一段可用时段。|-| +|add_start_clock|varchar(16)|add_start_clock|附加可用时段的起始时间（第二段），格式 HH:MM:SS。当前样本常见值为“00:00:00”或“10:00:00”。用于配置早场加夜场等双时段场景。|-| +|add_end_clock|varchar(16)|add_end_clock|附加可用时段的结束时间（第二段）。常见值如“1.00:00:00”“18:00:00”“23:59:00”。其中“1.00:00:00”表示跨至次日零点，用于表示“可用到第二天凌晨”的场景。|-| +|area_tag_type|int|area_tag_type|区域标记类型枚举。当前样本全部为 1。推测 1 表示“按台区标签限制”（如 A 区、B 区、中八、斯诺克、包厢、KTV 等）。其他取值可能对应按具体台桌或其它规则限用。|-| +|table_area_id|bigint|table_area_id|单一台区 ID。当前样本全部为 0。原始设计用于限定只能在一个具体区域使用，但由于已引入多选逻辑，实际使用已迁移到 tenant_table_area_id_list。|-| +|tenant_table_area_id|bigint|tenant_table_area_id|租户级台区 ID，单值版本。当前样本全部为 0。与 table_area_id 类似，已被多选列表字段取代。|-| +|table_area_id_list|varchar(512)|table_area_id_list|门店级台区 ID 列表。当前样本全部为空字符串。根据命名推测原本用于存储多个 table_area_id，实际实现已转向租户维度列表字段。|-| +|group_type|int|group_type|团购类型枚举。当前样本全部为 1。推测 1 表示“计时类/台费类套餐”。其他取值可能用于商品类套餐、代金券类等，需结合系统配置进一步确认。|-| +|system_group_type|int|system_group_type|系统级团购类型枚举。当前样本全部为 1。推测 1 表示“券码类团购”，即通过券码核销。其他取值可能为卡内套餐、内部套餐等，具体含义有待业务确认。|-| +|package_type|int|type|内部业务子类型枚举。样本中取值有 1 与 2，各占比不同。具体含义不明，可能区分不同产品线或套餐来源，例如“平台合作套餐”与“自定义套餐”等，需要参考业务文档。|-| +|effective_status|int|effective_status|当前有效状态枚举，由系统根据时间及配置动态计算。观测值：1 表示当前有效，可正常核销；3 表示失效或已过期（即使 is_enabled 仍为 1，也不可使用）。可用于分析时过滤失效套餐。|-| +|max_selectable_categories|int|max_selectable_categories|最大可选择分类数或子项数，具体含义未在样本和说明中体现，当前值全部为 0。可能用于“组合型套餐”中限制可选项目数量。|-| +|creator_name|varchar(100)|creator_name|创建人名称，例如“店长:郑丽珊”。主要用于审计追踪和后台展示。|-| + + + +**dim_groupbuy_package 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|groupbuy_package_id|主键|-|-|主键字段| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|package_template_id|外键|dim_groupbuy_package_template|package_template_id|总部/模板套餐主键（预留外键）。| +|tenant_table_area_id_list|外键|dim_table_area_group|tenant_table_area_group_id|多值字段，关联租户级台区分组。| +|card_type_ids|外键|dim_card_type|card_type_id|多值字段，限定可用卡种。| + + + +------------------------------------------------------------ +------------------------------------------------------------ +事实表（DWD） +以下事实表均以“业务事件”为粒度，不做聚合。字段来源包括原始 JSON(或ODS) 中的明细数组以及对象属性。时间单位均统一为秒，并保留原始字段以备检查。金额按照源系统保持符号规则，不做符号转换。 + + +### 结账记录 +来自 settlement_records的内层 settleList 对象，每行代表一次结账。该表在业务上是其他明细事实表的汇总头，用于串联台费、商品、助教、券等明细。 + +**dwd_settlement_head** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色|业务重要性| +|---|---|---|---|---|---| +|order_settle_id|BIGINT|settleList.id|结账记录主键 ID（订单结算 ID），全系统统一的结账单号，用于关联台费流水、助教流水、小票等明细表。|主键| | +|tenant_id|BIGINT|settleList.tenantId|租户/商户 ID（品牌维度），与各业务 JSON 中的 tenantId 一致。|外键|重要| +|site_id|BIGINT|settleList.siteId|门店 ID，用于关联门店维表 dim_site。|外键|重要| +|site_name|VARCHAR(100)|settleList.siteName|门店名称快照，冗余展示字段，推荐通过 site_id 关联维表获取标准名称。|-|重要| +|table_id|BIGINT|settleList.tableId|结账关联的桌台 ID，对应台桌维表 dim_site_table 的主键。|外键|重要| +|settle_name|VARCHAR(100)|settleList.settleName|结账对象名称，一般为 “区域 + 桌号”，如 “A区 A17”，便于报表展示。|-|重要| +|order_trade_no|BIGINT|settleList.settleRelateId|交易号 / 订单流水号，与台费、助教等明细中的 order_trade_no 一致，用于按“交易维度”串联各业务明细。|-|重要| +|create_time|DATETIME|settleList.createTime|结账创建时间（收银端点击“确认结账”的时间），格式：YYYY-MM-DD HH:MM:SS。|-|重要| +|pay_time|DATETIME|settleList.payTime|实际支付完成时间，通常晚于 create_time，用于资金结算及对账分析。|-|重要| +|settle_type|TINYINT|settleList.settleType|结账类型枚举。样本中主要有：1=正常结账；3=特殊类型结账（如挂账、补单、调整单等，具体需业务确认）。|-|重要| +|revoke_order_id|BIGINT|settleList.revokeOrderId|若当前记录属于撤销链路，记录对应的撤销单或原单的结账 ID，形成自关联关系。样本中为 0。|外键|重要| +|member_id|BIGINT|settleList.memberId|会员主键 ID，一般对应租户维度的会员 ID，用于关联 dim_member。|外键|重要| +|member_name|VARCHAR(100)|settleList.memberName|会员姓名快照，冗余展示字段；当前样本多为空，推荐通过关联会员维表获取标准姓名。|-|重要| +|member_phone|VARCHAR(50)|settleList.memberPhone|会员手机号快照，冗余展示字段，通常通过会员维表获取更可靠。|-|重要| +|member_card_account_id|BIGINT|settleList.tenantMemberCardId|会员卡账户 ID，对应 dim_member_card_account 主键；当前样本多为 0，但结构上是“结账 → 具体卡账户”的外键。|外键|重要| +|member_card_type_name|VARCHAR(100)|settleList.memberCardTypeName|会员卡类型名称快照，如“储值卡”“次卡”等，便于前端展示和报表查看。|-|重要| +|is_bind_member|TINYINT(1)|settleList.isBindMember|本单是否绑定会员。0=否（散客）；1=是（存在 member_id）。样本中多为 0。|-|重要| +|member_discount_amount|DECIMAL(18,2)|settleList.memberDiscountAmount|会员折扣产生的优惠金额（元），例如会员卡折扣减免的台费/商品金额，参与整单优惠拆分。|-|重要| +|consume_money|DECIMAL(18,2)|settleList.consumeMoney|本次结账消费总额（原价小计），约等于台费 + 商品 + 助教 + 服务等项目原价金额之和，未扣除任何优惠。|-|重要| +|table_charge_money|DECIMAL(18,2)|settleList.tableChargeMoney|本单台费（桌台计费部分）的金额（原价侧）。|-|重要| +|goods_money|DECIMAL(18,2)|settleList.goodsMoney|本单商品销售原价金额，对应酒水、小吃等商品类消费。|-|重要| +|real_goods_money|DECIMAL(18,2)|settleList.realGoodsMoney|商品实际计入金额，通常为 goods_money 扣除部分促销/折扣之后的金额。|-|重要| +|assistant_pd_money|DECIMAL(18,2)|settleList.assistantPdMoney|助教“排钟 / 点钟 / 按时长服务”等项目的应计金额（原价侧），与助教流水中的 ledger_amount 汇总对应。|-|重要| +|assistant_cx_money|DECIMAL(18,2)|settleList.assistantCxMoney|助教“超休”类助教项目金额（原价侧），是对助教收入的补充拆分维度，具体业务定义需结合助教模块确认。|-|重要| +|adjust_amount|DECIMAL(18,2)|settleList.adjustAmount|手动减免，人工调价金额汇总（整单减免或特殊价格调整），通常正值表示减免额度。|-|重要| +|pay_amount|DECIMAL(18,2)|settleList.payAmount|本单顾客“实付金额”（不含券面值这类虚拟抵扣），等于各支付渠道金额之和减去退款等调整。|-|重要| +|balance_amount|DECIMAL(18,2)|settleList.balanceAmount|从会员储值余额账户中扣除的金额（储值卡消费部分）。|-|重要| +|recharge_card_amount|DECIMAL(18,2)|settleList.rechargeCardAmount|充值卡支付金额（使用充值类卡片余额支付的金额），与储值/充值型卡资金来源相关。|-|重要| +|gift_card_amount|DECIMAL(18,2)|settleList.giftCardAmount|礼品卡或代金卡支付金额。|-|重要| +|coupon_amount|DECIMAL(18,2)|settleList.couponAmount|本单由优惠券（团购券、代金券等）实际抵扣的金额。|-|重要| +|rounding_amount|DECIMAL(18,2)|settleList.roundingAmount|抹零 / 四舍五入产生的金额差值，例如按角、分抹零。|-|重要| +|point_amount|DECIMAL(18,2)|settleList.pointAmount|积分相关金额或数量。根据系统配置可能表示“使用积分抵扣的金额”或“本单获得的积分折算金额”，文档未给出唯一定义。|-|重要| + + + +**dwd_settlement_head_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色|业务重要性| +|---|---|---|---|---|---| +|order_settle_id|BIGINT|settleList.id|结账记录主键 ID（订单结算 ID），全系统统一的结账单号，用于关联台费流水、助教流水、小票等明细表。|主键| | +|serial_number|INT|settleList.serialNumber|结账序列号或打印序号，当前样本全部为 0，具体业务用途未在文档中明确。|-|不重要| +|settle_status|TINYINT|settleList.settleStatus|结账状态枚举。当前样本值均为 2，表示“已结算/已完成”；其他取值及含义未在样本和文档中出现，需后续补充。|-|不重要| +|can_be_revoked|TINYINT(1)|settleList.canBeRevoked|本单是否仍允许撤销/冲正。0=否；1=是。样本中均为 0。主要用于运维控制，分析价值有限。|-|不重要| +|revoke_order_name|VARCHAR(100)|settleList.revokeOrderName|撤销单名称/标识，用于人工识别撤销关系；当前样本为空。|-|不重要| +|revoke_time|DATETIME|settleList.revokeTime|撤销时间。无撤销时通常为系统默认值（如 0001-01-01 00:00:00）。|-|不重要| +|is_first_order|TINYINT(1)|settleList.isFirst|是否首单（新客首单）标记。0=否；1=是。当前样本全部为 0，且文档中说明为“推测用途”，具体业务定义需确认。|-|不重要| +|service_money|DECIMAL(18,2)|settleList.serviceMoney|其他服务费金额（如包间服务费等），用于与台费、商品、助教金额区分。|-|不重要| +|cash_amount|DECIMAL(18,2)|settleList.cashAmount|现金支付金额。|-|不重要| +|card_amount|DECIMAL(18,2)|settleList.cardAmount|刷卡类支付金额（如银行卡/信用卡等），具体包含哪些通道需结合支付模块确认。|-|不重要| +|online_amount|DECIMAL(18,2)|settleList.onlineAmount|线上支付金额汇总（如微信、支付宝、云闪付等），不区分具体通道。|-|不重要| +|refund_amount|DECIMAL(18,2)|settleList.refundAmount|本单涉及的退款金额（元）。普通正常结账为 0，退单或部分退款时为正数。|-|不重要| +|prepay_money|DECIMAL(18,2)|settleList.prepayMoney|本单使用的预付金/定金金额。|-|不重要| +|payment_method|TINYINT|settleList.paymentMethod|支付方式整体标记（枚举）。当前样本值统一为 0，具体各枚举值对应的支付方式未在文档中说明，需业务确认。|-|不重要| +|coupon_sale_amount|DECIMAL(18,2)|settleList.couponSaleAmount|优惠券本身的售卖金额/成本金额（例如顾客为购买套餐券支付的金额），当前样本多为 0。|-|不重要| +|all_coupon_discount|DECIMAL(18,2)|settleList.allCouponDiscount|所有券类优惠折扣的汇总金额，用于统计“券优惠总额”。|-|不重要| +|goods_promotion_money|DECIMAL(18,2)|settleList.goodsPromotionMoney|商品促销产生的优惠金额（如满减、买赠均摊到商品部分）。|-|不重要| +|assistant_promotion_money|DECIMAL(18,2)|settleList.assistantPromotionMoney|助教项目参与活动/促销产生的优惠金额。|-|不重要| +|activity_discount|DECIMAL(18,2)|settleList.activityDiscount|整单活动折扣金额（如整单打折、满减活动产生的优惠），不区分具体项目类别。|-|不重要| +|assistant_manual_discount|DECIMAL(18,2)|settleList.assistantManualDiscount|针对助教服务的人工减免金额，与一般商品/台费折扣区分开。|-|不重要| +|point_discount_price|DECIMAL(18,2)|settleList.pointDiscountPrice|积分抵扣对应的金额（售价侧），记录因积分使用而减少的应收金额。|-|不重要| +|point_discount_cost|DECIMAL(18,2)|settleList.pointDiscountCost|积分抵扣对应的成本金额（成本侧），用于毛利和利润分析。|-|不重要| +|is_use_coupon|TINYINT(1)|settleList.isUseCoupon|是否使用优惠券。0=未使用；1=使用。当前样本均为 0。|-|不重要| +|is_use_discount|TINYINT(1)|settleList.isUseDiscount|是否使用折扣（包括会员折扣或其他整单折扣）。0=未使用；1=使用。当前样本多为 0。|-|不重要| +|is_activity|TINYINT(1)|settleList.isActivity|是否参与营销活动。0=未参与；1=参与。|-|不重要| +|operator_name|VARCHAR(100)|settleList.operatorName|结账操作员名称快照（通常带角色前缀，如“收银员:张三”），用于报表展示。|-|不重要| +|salesman_name|VARCHAR(100)|settleList.salesManName|营业员/业务员名称，用于业绩归属及提成分析；样本中多为空。|-|不重要| +|order_remark|VARCHAR(255)|settleList.orderRemark|订单备注，由收银员手工填写的文字说明，如特殊情况、赠送原因等，主要用于人工复盘。|-|不重要| +|operator_id|BIGINT|settleList.operatorId|结账操作员用户 ID，用于关联员工/账号维度（如 dim_staff）。|外键|不重要| +|salesman_user_id|BIGINT|settleList.salesManUserId|营业员用户 ID，可关联员工维度，用于业绩分析和提成计算。|外键|不重要| + +**dwd_settlement_head 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|order_settle_id|主键|-|-|结账记录主键；Ex 表复用此键一一对应。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|table_id|外键|dim_table|table_id|结账关联的台桌。| +|member_id|外键|dim_member|member_id|绑定会员。| +|member_card_account_id|外键|dim_member_card_account|member_card_id|绑定会员卡账户。| +|revoke_order_id|外键|dwd_settlement_head|order_settle_id|撤销链路自关联。| +|order_trade_no|业务键|dwd_table_fee_log / dwd_store_goods_sale / dwd_assistant_service_log|order_trade_no|跨明细表的订单号，用于事实表串联。| + + + + + +------------------------------------------------------------ + +### 台费流水 +来自 table_fee_transactions的 siteTableUseDetailsList，忽略siteProfile（已在dim_site实现）。粒度为一次台费使用记录（包括包厢）。该表连结订单结账头、桌台、会员等维度。 + +**dwd_table_fee_log** +|数据库字段名|字段类型|来源字段|说明（含枚举值、取值说明）|角色| +|---|---|---|---|---| +|table_fee_log_id|BIGINT|id|台费流水记录主键。每一条台费使用记录唯一一条。对应一次“台费计费单元”。|主键| +|order_trade_no|BIGINT|order_trade_no|订单交易号。整笔订单的主编号，用于把同一订单下的台费、商品、助教等多种明细串联在一起。可与支付记录中的交易号对应。|外键| +|order_settle_id|BIGINT|order_settle_id|结算单号 / 结账 ID。对应一次完整的结账操作。与 dwd_settlement_head 的主键关联。|外键| +|order_pay_id|BIGINT|order_pay_id|订单支付记录 ID。对应支付记录中的 id 或 relate_id（视具体模型）。用于追踪这条台费最终对应哪一条支付流水。|外键| +|tenant_id|BIGINT|tenant_id|租户 / 品牌 ID。本文件内所有记录属于同一租户。与其他表的 tenant_id 一致，用于品牌级过滤。|外键| +|site_id|BIGINT|site_id|门店 ID。当前样本为同一门店。与嵌套的 siteProfile.id 以及其他 JSON 中的 site_id 对应，用于门店维度关联。|外键| +|site_table_id|BIGINT|site_table_id|桌台 ID。对应“台桌基础表”的主键。用于确定具体哪一张台或包厢。|外键| +|site_table_area_id|BIGINT|site_table_area_id|门店内“台桌区域” ID（门店视角的区域，如 A 区、B 区、斯诺克区、包厢区）。与门店内部的区域维度对应。|外键| +|site_table_area_name|VARCHAR(64)|site_table_area_name|台桌区域名称，如 “A区”“B区”“斯诺克区”“VIP包厢” 等。主要用于报表展示和人工阅读。|无| +|tenant_table_area_id|BIGINT|tenant_table_area_id|租户层面的台桌区域 ID。用于品牌层统一定义的区域配置（一个区域可在多门店复用）。对应租户级区域维度。|外键| +|member_id|BIGINT|member_id|会员 ID。多数为 0 表示散客。非 0 时表示关联会员：0 表示散客或未使用会员；>0 对应会员档案中的 id。用于将台费流水关联到 dim_member。|外键| +|ledger_name|VARCHAR(64)|ledger_name|台号名称，例如 “A1”“A2”“S1”“VIP包厢” 等。等价于桌台维表中的展示名称，冗余在流水中作为快照。|无| +|ledger_unit_price|DECIMAL(18,2)|ledger_unit_price|台费结算时的计费单价（元/小时或元/单位时长）。与 ledger_count 配合计算原始应收台费。常见值如 48.0、58.0、68.0、88.0、98.0、116.0 等。|无| +|ledger_count|INT|ledger_count|计费时长单位数。与 ledger_unit_price 共同决定原始应收额。可与 real_table_use_seconds 换算关系约为：时长秒数 ≈ ledger_count × 计费粒度（例如 30 分钟、60 分钟）。|无| +|ledger_amount|DECIMAL(18,2)|ledger_amount|原始应收台费金额，按单价与计费时长计算出来的台费金额，尚未考虑会员、券、调账等各类优惠拆分。|无| +|real_table_charge_money|DECIMAL(18,2)|real_table_charge_money|实际向顾客收取的台费金额（现金 / 实付维度），不含券方承担、会员承担和内部调账部分。若为 0，则该笔台费完全由券、会员或内部调账承担。|无| +|coupon_promotion_amount|DECIMAL(18,2)|coupon_promotion_amount|由优惠券、活动、团购等促销承担的优惠金额，直接抵扣在台费上。常见值为与单价或整倍数相同，例如 48.0、96.0、136.0、144.0 等。若 real_table_charge_money 为 0 且该字段等于 ledger_amount，说明台费完全由促销承担。|无| +|member_discount_amount|DECIMAL(18,2)|member_discount_amount|由会员权益产生的优惠金额，例如会员折扣、会员免费台等。若 ledger_amount = real_table_charge_money = member_discount_amount，表示这笔台费由会员权益承担，但仍作为台费收入进行记录。|无| +|adjust_amount|DECIMAL(18,2)|adjust_amount|手动减免，调整金额 / 调账金额。用于将台费金额转移或冲减到其他项目（例如套餐、包厢统一计费）或做手工调整。若 ledger_amount 完全被 adjust_amount 抵消，则说明该笔台费被整体调出当前台费科目。|无| +|real_table_use_seconds|INT|real_table_use_seconds|台费实际计费时长（秒）。用于计算台费单价与费率分析。内部统一以秒为单位。|无| +|add_clock_seconds|INT|add_clock_seconds|加钟时长（秒）。在原有使用基础上追加的累计加钟时长，常见为 2400、4200 等 60 的倍数（对应 40 分钟、70 分钟等）。|无| +|start_use_time|DATETIME|start_use_time|台开始使用时间，即实际开台时间。与 ledger_start_time 相同，表示计费起算点。|无| +|ledger_end_time|DATETIME|ledger_end_time|台账计费结束时间。通常与 last_use_time 相差 1 秒。可理解为系统为计费进行的截断时刻。|无| +|create_time|DATETIME|create_time|台费流水记录创建时间，通常接近结账时间。用于区分计费期间与结账时间。|无| +|ledger_status|INT|ledger_status|台费状态。样本中全部为 1。含义：1 表示正常已结算台费。按命名推断，0 可能表示未结算，2 可能表示作废或撤销，需要结合后续数据确认。|无| +|is_single_order|INT|is_single_order|是否独立计费单元。枚举：1 表示该记录是独立结算的桌费；0 表示非独立结算条目（可能是合并结账、转台过程中的占位记录）。is_single_order = 0 的记录通常 ledger_count 与 real_table_use_seconds 为 0。|无| +|is_delete|INT|is_delete|逻辑删除标志。0 表示未删除（有效记录）；1 表示已逻辑删除（一般不参与统计）。当前样本全部为 0。|无| + + + +**dwd_table_fee_log_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值、取值说明）|角色| +|---|---|---|---|---| +|table_fee_log_id|BIGINT|id|台费流水记录主键。每一条台费使用记录唯一一条。对应一次“台费计费单元”。|主键| +|operator_name|VARCHAR(64)|operator_name|操作员姓名。为冗余展示字段，便于直接阅读而不必联表员工档案。|无| +|salesman_name|VARCHAR(64)|salesman_name|营业员姓名。当前样本为空。用于需要对营业员维度做业绩统计时作为冗余展示。|无| +|used_card_amount|DECIMAL(18,2)|used_card_amount|由储值卡、次卡等“卡内余额”直接抵扣到台费的金额。当前样本为 0，但语义明确，用于区分“卡扣款”与“现金收款”。|无| +|service_money|DECIMAL(18,2)|service_money|服务费 / 成本 /分成金额字段，类似助教流水里的 service_money。当前样本全为 0，门店未启用该字段，未来可能用于台费附加服务费或分成计算。|无| +|mgmt_fee|DECIMAL(18,2)|mgmt_fee|管理费字段。当前样本为 0。推测用于未来支持“台费附加管理费”功能。尚未实际启用。|无| +|fee_total|DECIMAL(18,2)|fee_total|附加费用合计值字段。当前样本为 0。设计上用于汇总管理费、服务费等附加费用。尚未实际启用。|无| +|ledger_start_time|DATETIME|ledger_start_time|台账计费起始时间。当前样本与 start_use_time 相同，表示计费与开台同时开始。|无| +|last_use_time|DATETIME|last_use_time|最后使用 / 操作时间，通常略晚于 ledger_end_time。可视为客人最后一次用台或最后一次加钟/操作的时间点。|无| +|operator_id|BIGINT|operator_id|操作员 ID。负责开台 / 结账的员工账号 ID。与员工 / 账号体系中的用户 ID 对应。|外键| +|salesman_user_id|BIGINT|salesman_user_id|营业员用户 ID。目前样本值为 0，表示门店暂未使用此字段做提成员工归属，但语义清晰。|外键| +|salesman_org_id|BIGINT|salesman_org_id|营业员所属机构 / 部门 ID。目前样本为 0。用于员工组织结构统计时的归属。|外键| + +**dwd_table_fee_log 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|table_fee_log_id|主键|-|-|主键字段；Ex 表一一对应。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|site_table_id|外键|dim_table|table_id|球台/包厢 ID。| +|site_table_area_id|外键|dim_area|area_id|门店维度台区。| +|tenant_table_area_id|外键|dim_table_area_group|tenant_table_area_group_id|租户级台区分组。| +|member_id|外键|dim_member|member_id|关联会员。| +|order_settle_id|外键|dwd_settlement_head|order_settle_id|对应结账主单。| +|order_pay_id|外键|dwd_payment|payment_id|对应支付流水（若存在）。| +|order_trade_no|业务键|dwd_store_goods_sale / dwd_assistant_service_log|order_trade_no|与同单的商品、助教、台费明细串联。| +|operator_id|外键|dim_staff|staff_id|开台/结账操作员（Ex 表字段）。| +|salesman_user_id|外键|dim_staff|staff_id|营业员（Ex 表字段）。| +|salesman_org_id|外键|dim_org|org_id|营业员所属组织（Ex 表字段）。| + +------------------------------------------------------------ + +### 台费折扣/调整 +来自 table_fee_discount_records的table_fee_discount_records.data.taiFeeAdjustInfos. 路径下字段路径。每行代表一次台费打折或减免操作。由于结构相对简单，字段说明如下： + +**dwd_table_fee_adjust** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|table_fee_adjust_id|bigint|id|台费折扣 / 调整流水主键；一条台费打折或调账操作对应一条记录。|主键| +|order_trade_no|bigint|order_trade_no|订单交易号；与台费流水、结账记录等表中的同名字段一致，用于把本次台费调整挂到具体订单上。|外键| +|order_settle_id|bigint|order_settle_id|结算单 / 小票 ID；与小票、结账头表中的 order_settle_id 对应，用于关联同一次结账。|外键| +|tenant_id|bigint|tenant_id|租户 / 品牌 ID；标识该记录属于哪一个商户。|外键| +|site_id|bigint|site_id|门店 ID；与 dim_site、其它业务事实表中的 site_id 一致。|外键| +|table_id|bigint|site_table_id|台桌 ID；与 dim_table（site_tables_master.id）以及各类台费、助教流水中的 site_table_id 对应，标识哪一张台发生了折扣/调账。|外键| +|table_area_id|bigint|tableProfile.site_table_area_id|门店维度的台桌区域 ID；与 dim_table 中的 site_table_area_id 对应，例如 “斯诺克区”“VIP包厢”等区域。|外键| +|table_area_name|varchar(64)|tableProfile.site_table_area_name|台桌区域名称快照，例如 “斯诺克区”“A区”“VIP包厢”；冗余展示字段，可从 dim_table 通过 table_area_id 获取。|-| +|tenant_table_area_id|bigint|tenant_table_area_id|租户维度的“台桌区域 ID”；同一租户下跨门店复用的区域标识，用于在租户级别统计各区域的折扣分布。|外键| +|ledger_amount|decimal(18,2)|ledger_amount|台费调整金额；等于台费流水中对应记录的 adjust_amount。正数表示被减免/调账掉的台费金额（本批数据全部为正）；是衡量台费折扣规模的核心度量。|-| +|ledger_status|int|ledger_status|调整记录状态（枚举）。1：生效调整（当前有效的折扣/调账记录）；0：失效/被覆盖的历史记录（同一订单有多次调整时，旧记录会标记为 0，仅最新一条为 1）。|-| +|is_delete|int|is_delete|逻辑删除标记（枚举）。0：未删除（有效记录）；1：已逻辑删除（后台标记删除，不再参与业务统计）。当前数据全部为 0，但字段需保留以适配长期数据。|-| +|adjust_time|datetime|create_time|台费调整记录创建时间，即打折/调账操作被系统写入的时间戳，用于时间分析和与结账时间对比（判断是事前折扣还是事后调账）。|-| + + + + +**dwd_table_fee_adjust_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|table_fee_adjust_id|bigint|id|台费折扣 / 调整流水主键；一条台费打折或调账操作对应一条记录。|主键| +|adjust_type|int|adjust_type|调整类型（枚举）。当前数据全部为 1。取值示例：1：台费打折 / 台费减免（本门店实际使用的唯一类型）；其他值：预留给台费转移、误操作恢复等其他类型（当前未出现，仅推测）。|-| +|ledger_count|int|ledger_count|调整次数计数，本数据中恒为 1，表示“一次调整事件”；与台费流水中的 ledger_count（计时长）含义不同。|-| +|ledger_name|varchar(128)|ledger_name|调账项目名称或打折原因名称（设计意图）；当前门店所有记录值为空字符串，未实际使用。作用暂不明确，保留以备后续业务启用。|-| +|applicant_name|varchar(64)|applicant_name|申请人姓名快照，通常包含角色前缀（如 “收银员:张三”）；是 applicant_id 的冗余展示字段，实际名称应以员工维表为准。|-| +|operator_name|varchar(64)|operator_name|操作员姓名快照；与 operator_id 对应的姓名冗余字段。|-| +|applicant_id|bigint|applicant_id|申请人 ID；发起本次台费折扣/调账的员工账号 ID，用于按员工维度统计折扣行为。|外键| +|operator_id|bigint|operator_id|实际执行调账操作的操作员 ID；当前样本中与 applicant_id 相同，但模型上允许“申请人 ≠ 操作人”。|外键| + + +**dwd_table_fee_adjust 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|table_fee_adjust_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|table_id|外键|dim_table|table_id|发生折扣的台桌。| +|table_area_id|外键|dim_area|area_id|门店台区。| +|tenant_table_area_id|外键|dim_table_area_group|tenant_table_area_group_id|租户级台区分组。| +|order_settle_id|外键|dwd_settlement_head|order_settle_id|结账单主键。| +|order_trade_no|业务键|dwd_table_fee_log / dwd_store_goods_sale|order_trade_no|同订单的其他明细业务键。| +|applicant_id|外键|dim_staff|staff_id|折扣申请人（Ex 表字段）。| +|operator_id|外键|dim_staff|staff_id|折扣执行人（Ex 表字段）。| + + +------------------------------------------------------------ + +### 商品销售明细 +来自 store_goods_sales_records的 orderGoodsLedgers。每行代表订单中的一条商品销售明细。字段较多，以下列出关键字段及其作用。 + +**dwd_store_goods_sale** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色|业务重要性| +|---|---|---|---|---|---| +|store_goods_sale_id|bigint|id|商品销售明细主键；每条记录代表一次订单中的一个商品行流水。|主键|-| +|order_trade_no|bigint|order_trade_no|订单交易号（业务单号）；与台费、助教、团购等表的 order_trade_no 一致，用于把同一订单下各类消费串联起来。|外键|重要| +|order_settle_id|bigint|order_settle_id|结账记录主键 ID；连接结账记录 / 结算头事实表。|外键|重要| +|order_pay_id|bigint|order_pay_id|支付记录 ID；连接支付流水事实表，用于还原本条销售对应的收款信息。|外键|重要| +|order_goods_id|bigint|order_goods_id|当前版本的订单内商品明细 ID；可在订单范围内唯一定位该商品行，用于与小票明细等做行级关联。|外键|重要| +|site_id|bigint|site_id|门店 ID（系统主键）；与其它流水表中的 site_id 一致。|外键|重要| +|tenant_id|bigint|tenant_id|租户/品牌 ID；同一品牌下多门店共享同一个 tenant_id。|外键|重要| +|site_goods_id|bigint|site_goods_id|门店级商品 ID；连接门店商品档案 dim_store_goods，与库存变动记录中的 siteGoodsId 一致。|外键|重要| +|tenant_goods_id|bigint|tenant_goods_id|租户级（品牌级）商品 ID；连接租户级商品档案维度表，一个 tenant_goods_id 在不同门店可对应多个 site_goods_id。|外键|重要| +|tenant_goods_category_id|bigint|tenant_goods_category_id|租户级商品一级分类 ID；连接商品分类维度（如酒水、零食等）。|外键|重要| +|tenant_goods_business_id|bigint|tenant_goods_business_id|租户级商品业务大类 ID（更高一层的业务分类，如“零食类”“酒水类”等）。|外键|重要| +|site_table_id|bigint|site_table_id|球台 ID；非 0 表示该商品在某张台桌上点单，0 表示前台售卖或与台桌无关。连接台桌维度 dim_table。|外键|重要| +|ledger_name|varchar(200)|ledger_name|销售项目名称（商品名），如“哇哈哈矿泉水”“地道肠”等；为当时销售时刻的名称快照。|-|重要| +|ledger_group_name|varchar(100)|ledger_group_name|门店前台菜单分组名称，如“酒水”“零食”“小吃”等；与品牌统一分类是两套维度。|-|重要| +|ledger_unit_price|decimal(18,2)|ledger_unit_price|结算单价（元/单位）；本次销售实际使用的单价。|-|重要| +|ledger_count|int|ledger_count|销售数量（以商品单位计），如 1、2、6、36 等。|-|重要| +|ledger_amount|decimal(18,2)|ledger_amount|原始应收金额（未考虑任何折扣/抵扣），通常接近 ledger_unit_price × ledger_count。|-|重要| +|discount_price|decimal(18,2)|discount_price|折后单价（元/单位）；无折扣时等于 ledger_unit_price，有折扣时小于 ledger_unit_price。|-|重要| +|real_goods_money|decimal(18,2)|real_goods_money|本行商品实际入账金额（已考虑折扣及其他抵扣后，实际计入营业额的金额）；一定不大于 ledger_amount。|-|重要| +|cost_money|decimal(18,2)|cost_money|本行商品对应的成本金额，用于毛利和利润分析；源自商品档案成本价及成本核算逻辑。|-|重要| +|ledger_status|tinyint|ledger_status|销售流水状态：1=正常有效；其他数值（当前数据未出现）一般表示“待结算”“作废”等。|-|重要| +|is_delete|tinyint|is_delete|逻辑删除标志：0=正常有效；1=已删除（仅保留历史，不再参与前端展示及统计）（本批数据全部为 0）。|-|重要| +|create_time|datetime|create_time|销售记录创建时间，通常为结账时间或录入时间；用于时间维度分析，与订单层时间字段对齐。|-|重要| + + + + +**dwd_store_goods_sale_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|store_goods_sale_id|bigint|id|商品销售明细主键；每条记录代表一次订单中的一个商品行流水。|主键| +|legacy_order_goods_id|bigint|orderGoodsId|旧版订单商品明细 ID，兼容字段；当前接口已统一使用 order_goods_id，本批数据全部为 0。|-| +|site_name|varchar(100)|siteName|门店名称，对 site_id 的冗余文本（例如“朗朗桌球”），用于展示。|-| +|legacy_site_id|bigint|siteId|历史兼容门店 ID；当前接口统一使用 site_id，本批数据 siteId 全部为 0。|-| +|goods_remark|varchar(255)|goods_remark|商品备注/口味说明/特殊说明；部分记录为空，部分与商品名相同。|-| +|option_value_name|varchar(200)|option_value_name|商品选项名称（规格/口味，如大杯/小杯、不加冰等）；当前门店未启用多规格，样本中全部为空。|-| +|operator_name|varchar(100)|operator_name|操作员姓名冗余，如“收银员:郑丽珊”；用于展示，不作为关联键。|-| +|open_salesman_flag|tinyint|openSalesman|是否启用营业员机制标志：1=启用营业员/提成体系（需指定 salesman_* 字段）；2=未启用营业员体系（本批数据全部为 2）。|-| +|salesman_user_id|bigint|salesman_user_id|营业员用户 ID（系统账号 ID）；当前样本全部为 0，说明门店未启用营业员业绩统计。|外键| +|salesman_name|varchar(100)|salesman_name|营业员姓名；当前样本全部为空字符串。|-| +|salesman_role_id|bigint|salesman_role_id|营业员角色 ID（例如某角色代码对应“销售员”角色）；当前样本全部为 0。|外键| +|sales_man_org_id|bigint|sales_man_org_id|营业员所属组织/部门 ID；当前样本全部为 0，未启用按组织分组统计。|外键| +|discount_money|decimal(18,2)|discount_money|本行商品的直接价格优惠金额（打折让利部分）；在简单场景下满足：ledger_amount - discount_money ≈ real_goods_money（不含积分、券抵扣）。|-| +|returns_number|int|returns_number|退货数量；当前样本全部为 0，如发生退货则记录退回的件数。|-| +|coupon_deduct_money|decimal(18,2)|coupon_deduct_money|优惠券/团购券直接抵扣到本条商品明细上的金额；当前样本为 0，说明券更多在订单级处理。|-| +|member_discount_amount|decimal(18,2)|member_discount_amount|由会员折扣针对本行商品产生的优惠金额；当前样本全部为 0，折扣通常体现在 discount_money 中。|-| +|point_discount_money|decimal(18,2)|point_discount_money|由积分抵扣的金额（顾客用积分兑换的抵现金额）。|-| +|point_discount_money_cost|decimal(18,2)|point_discount_money_cost|积分抵扣对应的成本金额（积分成本、营销费用等核算用）。|-| +|package_coupon_id|bigint|package_coupon_id|套餐券 ID；当商品来自套餐拆分或与套餐券关联时，用于追溯对应的套餐业务（当前样本为 0）。|-| +|order_coupon_id|bigint|order_coupon_id|订单级优惠券 ID；整单使用某张券时，可用于记录该券对本行商品的分摊关系（当前样本为 0）。|-| +|member_coupon_id|bigint|member_coupon_id|会员券 ID（如会员专享优惠券）；当前样本为 0，为会员权益预留字段。|-| +|option_price|decimal(18,2)|option_price|商品选项（规格/加料等）的附加价格；当前门店未启用此功能，样本为 0。|-| +|option_member_discount_money|decimal(18,2)|option_member_discount_money|由会员折扣作用在“选项价格”上的优惠金额；当前样本为 0。|-| +|option_coupon_deduct_money|decimal(18,2)|option_coupon_deduct_money|由优惠券抵扣“选项价格”的金额；当前样本为 0。|-| +|push_money|decimal(18,2)|push_money|本行商品对应的提成金额（营业员/业务员提成）；当前样本为 0，说明提成体系未启用。|-| +|is_single_order|tinyint|is_single_order|是否作为独立明细参与订单结算：1=作为独立明细参与订单；0=在特殊业务中可能合并为打包项目（当前样本全部为 1）。|-| +|sales_type|tinyint|sales_type|销售类型：1=正常销售（当前样本全部为 1）；常见扩展用法：2=赠品；3=内部消耗；4=盘点调整等。|-| +|operator_id|bigint|operator_id|操作员 ID（录入本条销售的员工）；与其它流水中的 operator_id 一致，可统一做员工维度分析。|外键| + +**dwd_store_goods_sale 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|store_goods_sale_id|主键|-|-|主键字段；Ex 表一一对应。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|site_goods_id|外键|dim_store_goods|site_goods_id|门店级商品。| +|tenant_goods_id|外键|dim_tenant_goods|tenant_goods_id|租户级商品。| +|tenant_goods_category_id|外键|dim_goods_category|category_id|商品一级分类。| +|tenant_goods_business_id|外键|dim_goods_business|business_id|商品业务大类。| +|site_table_id|外键|dim_table|table_id|点单关联的台桌。| +|order_settle_id|外键|dwd_settlement_head|order_settle_id|结账主单。| +|order_pay_id|外键|dwd_payment|payment_id|支付流水。| +|order_trade_no|业务键|dwd_table_fee_log / dwd_assistant_service_log|order_trade_no|跨明细表订单号。| +|order_goods_id|业务键|ods.order_goods|order_goods_id|订单内部商品行标识（用于软关联）。| +|salesman_user_id|外键|dim_staff|staff_id|营业员（Ex 表字段）。| +|salesman_role_id|外键|dim_role|role_id|营业员角色（Ex 表字段）。| +|sales_man_org_id|外键|dim_org|org_id|营业员组织（Ex 表字段）。| +|operator_id|外键|dim_staff|staff_id|录单操作员（Ex 表字段）。| + +------------------------------------------------------------ + +### 助教服务流水 +来自 assistant_service_records的 assistant_service_records.data.orderAssistantDetails.。每行表示一次助教提供服务的记录，包括服务时长、金额、助教与会员关联等。 + +**dwd_assistant_service_log** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|assistant_service_id|bigint|id|助教服务流水主键，系统内唯一标识一次助教服务记录。|主键| +|order_trade_no|bigint|order_trade_no|订单交易号，用于与台费、商品、支付等同一订单下的其他明细串联。|外键| +|order_settle_id|bigint|order_settle_id|结算单号，对应结账记录、小票中的结算主键。|外键| +|order_pay_id|bigint|order_pay_id|支付记录主键 ID，用于关联支付流水。|外键| +|order_assistant_id|bigint|order_assistant_id|订单中“助教项目明细”的内部 ID，一笔订单中多段助教服务时用于区分。|外键| +|order_assistant_type|int|order_assistant_type|助教服务类型枚举：1 表示常规助教服务（如基础课）；2 表示附加类助教服务（如附加课）；其他值预留。|-| +|tenant_id|bigint|tenant_id|租户/品牌 ID，用于区分商户。|外键| +|site_id|bigint|site_id|门店 ID，对应门店维表中的门店主键。|外键| +|site_table_id|bigint|site_table_id|球台/包厢 ID，对应台桌维表主键。|外键| +|tenant_member_id|bigint|tenant_member_id|商户维度会员 ID，对应会员档案主键；0 表示非会员或散客。|外键| +|system_member_id|bigint|system_member_id|系统级会员 ID，用于跨门店识别同一会员。|外键| +|assistant_no|varchar(64)|assistantNo|助教编号/工号，如 “27”；与助教档案中的工号一致。|-| +|nickname|varchar(64)|nickname|助教对外昵称，如“佳怡”“周周”；用于展示，不参与业务逻辑。|-| +|site_assistant_id|bigint|site_assistant_id|门店维度助教 ID，对应助教账号维表主键。|外键| +|user_id|bigint|user_id|助教对应的系统用户 ID，对应账号体系中的 user_id。|外键| +|assistant_team_id|bigint|assistant_team_id|助教团队 ID，用于分组统计团队业绩。|外键| +|person_org_id|bigint|person_org_id|助教所属人事组织/部门 ID，如“助教部”；用于组织维度分析。|外键| +|assistant_level|int|assistant_level|助教等级编码：8=助教管理；10=初级；20=中级；30=高级；用于薪酬/评价分层。|外键| +|level_name|varchar(64)|levelName|助教等级名称，与 assistant_level 对应，如“初级”“中级”“高级”“助教管理”。|-| +|skill_id|bigint|skill_id|助教服务课程/技能 ID，应对应课程/技能配置表。|外键| +|skill_name|varchar(64)|skillName|助教服务课程/技能名称，如“基础课”“附加课”。|-| +|ledger_unit_price|decimal(10,2)|ledger_unit_price|助教服务标准单价（原价），例如按小时或按节课的标价。|-| +|ledger_amount|decimal(10,2)|ledger_amount|按标准单价计算的应收金额，近似等于 ledger_unit_price×计费时长换算后的金额。|-| +|projected_income|decimal(10,2)|projected_income|实际计入门店收入的金额，已经考虑会员权益、券抵扣等后的结果。|-| +|coupon_deduct_money|decimal(10,2)|coupon_deduct_money|由优惠券、团购券等直接抵扣到本次助教服务上的金额；0 表示未使用券。|-| +|income_seconds|int|income_seconds|计费秒数（用于计算应收收入的时间长度），通常为按分钟取整的秒数。|-| +|real_use_seconds|int|real_use_seconds|实际服务时长（秒），真实消耗的时间，用于分析助教工作量。|-| +|add_clock|int|add_clock|加钟秒数，在原有预约基础上临时增加的服务时间，数值为 60 的倍数。|-| +|create_time|datetime|create_time|助教流水记录创建时间，接近下单/结算时间。|-| +|start_use_time|datetime|start_use_time|助教实际开始服务时间，通常与 ledger_start_time 一致。|-| +|last_use_time|datetime|last_use_time|助教最后一次服务时间，通常与 ledger_end_time 一致。|-| +|is_delete|int|is_delete|逻辑删除标志：0 未删除；1 已逻辑删除，用于保留历史数据。|-| + + + +**dwd_assistant_service_log_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|assistant_service_id|bigint|id|助教服务流水主键，系统内唯一标识一次助教服务记录。|主键| +|table_name|varchar(64)|tableName|球台名称，如 “A17”“S1”，与 site_table_id 冗余，用于展示。|-| +|assistant_name|varchar(64)|assistantName|助教姓名，如“何海婷”；与助教档案中的真实姓名一致。|-| +|ledger_name|varchar(128)|ledger_name|助教计费项目名称，如“2-佳怡”等，通常为展示用组合字段。|-| +|ledger_group_name|varchar(128)|ledger_group_name|助教项目所属的计费分组/套餐分组名称，目前导出数据中为空，未看到实际使用场景。|-| +|ledger_count|int|ledger_count|台账计费时长（秒），通常与 real_use_seconds 接近或相等。 +取income_seconds|-| +|member_discount_amount|decimal(10,2)|member_discount_amount|由会员卡折扣产生的优惠金额，当前样本中为 0，但字段语义明确。|-| +|manual_discount_amount|decimal(10,2)|manual_discount_amount|收银员手动减免金额（人工改价）；当前导出数据中为 0。|-| +|service_money|decimal(10,2)|service_money|与助教结算的金额或服务成本金额，当前数据全部为 0，具体结算规则未见启用。|-| +|returns_clock|int|returns_clock|退钟秒数（取消加钟或提前结束退回的时间），当前样本中全部为 0，未见业务使用。|-| +|ledger_start_time|datetime|ledger_start_time|台账计费起始时间。|-| +|ledger_end_time|datetime|ledger_end_time|台账计费结束时间，可作为本次服务结束时间。|-| +|ledger_status|int|ledger_status|助教流水状态：当前数据为 1，表示正常有效；其他值预留给已作废、未结算等状态。|-| +|is_confirm|int|is_confirm|确认状态：当前样本为 2，一般含义为 1=待确认，2=已确认/已完成（含义基于字段名和现有值推断）。|-| +|is_single_order|int|is_single_order|是否单独订单：1 表示助教服务作为单独订单结算；0 表示与其他项目合单结算。当前样本全部为 1。|-| +|is_not_responding|int|is_not_responding|是否存在“未响应/爽约”等异常：0 表示正常；1 表示未响应或爽约（基于字段名推断，当前数据均为 0）。|-| +|is_trash|int|is_trash|是否已废除：0 表示正常有效；1 表示已废除，与助教废除记录表（assistant_cancellation_records）对应。|-| +|trash_applicant_id|bigint|trash_applicant_id|提出废除申请的员工 ID，用于追溯谁发起了废除操作。|外键| +|trash_applicant_name|varchar(64)|trash_applicant_name|废除申请人姓名，仅用于展示，与 trash_applicant_id 冗余。|-| +|trash_reason|varchar(255)|trash_reason|废除原因文案，如“顾客取消”“录入错误”，便于分析异常原因。|-| +|salesman_user_id|bigint|salesman_user_id|营业员/销售员用户 ID，大多为 0，当前门店未明显使用此维度。|外键| +|salesman_name|varchar(64)|salesman_name|营业员/销售员姓名，多数为空字符串。|-| +|salesman_org_id|bigint|salesman_org_id|营业员所属组织/部门 ID，多数为 0，尚未看到实际业务使用。|外键| +|skill_grade|int|skill_grade|课程技能评分（整数），当前样本全为 0，评价功能尚未启用。|-| +|service_grade|int|service_grade|服务态度评分（整数），当前样本全为 0。|-| +|composite_grade|decimal(5,2)|composite_grade|综合评分（技能+服务等加权结果），当前样本为 0。|-| +|sum_grade|decimal(10,2)|sum_grade|累计评分总和，用于计算平均分，当前样本为 0。|-| +|get_grade_times|int|get_grade_times|获得评价的次数，当前样本为 0。|-| +|grade_status|int|grade_status|评价状态枚举：当前样本为 1，一般含义为“未评价/正常”，其他状态未见实际值。|-| +|composite_grade_time|datetime|composite_grade_time|最近一次综合评分时间或评价更新时间，当前为默认时间 “0001-01-01 00:00:00”。|-| + +**dwd_assistant_service_log 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|assistant_service_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|site_table_id|外键|dim_table|table_id|服务所在台桌。| +|tenant_member_id|外键|dim_member|member_id|租户内会员。| +|system_member_id|外键|dim_system_member|system_member_id|全局会员。| +|site_assistant_id|外键|dim_assistant|assistant_id|助教档案。| +|user_id|外键|dim_user|user_id|系统用户。| +|assistant_team_id|外键|dim_team|team_id|助教团队。| +|person_org_id|外键|dim_org|org_id|人事组织。| +|assistant_level|外键|dim_assistant_level|assistant_level|助教等级枚举。| +|skill_id|外键|dim_skill|skill_id|课程/技能配置。| +|order_settle_id|外键|dwd_settlement_head|order_settle_id|结账主单。| +|order_pay_id|外键|dwd_payment|payment_id|支付流水。| +|order_trade_no|业务键|dwd_table_fee_log / dwd_store_goods_sale|order_trade_no|跨明细表的订单号。| +|order_assistant_id|业务键|ods.order_assistant|order_assistant_id|订单中助教明细标识。| +|trash_applicant_id|外键|dim_staff|staff_id|废除申请人（Ex 表字段）。| +|salesman_user_id|外键|dim_staff|staff_id|营业员（Ex 表字段）。| +|salesman_org_id|外键|dim_org|org_id|营业员组织（Ex 表字段）。| + +------------------------------------------------------------ + +### 助教废除事件 +来自 assistant_cancellation_records 的 abolitionAssistants。每行代表一次助教服务被废除的事件，无法直接与结算记录或助教流水关联，只能通过门店+台桌+助教+时间窗口软关联。 + +**dwd_assistant_trash_event** +|数据库字段名|字段类型|来源字段（JSON 路径）|说明（含枚举与取值）|角色（主键/外键/-）| +|---|---|---|---|---| +|assistant_trash_event_id|bigint|id|助教废除事件主键。与源 JSON 中 id 一一对应，单表内唯一。没有业务含义，只作为技术主键使用。|主键| +|site_id|bigint|siteId|门店 ID。与其他 JSON 中的 siteId / site_id 含义一致。用来关联 dim_site。当前样例全部为同一门店（朗朗桌球），但设计上支持多门店。|外键（指向 dim_site）| +|table_id|bigint|tableId|台桌 ID。对应 site_tables_master.json 中的 id。用于定位哪一张球台发生了助教废除，用于后续软关联台费流水、助教流水时的重要条件。|外键（指向 dim_table）| +|table_area_id|bigint|tableAreaId|台桌区域 ID。应与台桌维或区域维中的 area_id 一致，用于按区域统计（A 区/B 区/VIP 包厢等）。|外键（潜在指向 dim_table_area）| +|assistant_no|varchar(32)|assistantOn|助教编号（工号/序号），如 '2'、'4'、'27' 等。与助教档案表 assistant_accounts_master.assistant_no、助教流水中的 assistantNo 一致，用于标识哪位助教。枚举：在门店内是有限编号集合，但并非硬编码含义。|外键（指向 dim_assistant）| +|assistant_name|varchar(64)|assistantName|助教姓名/昵称，如 “泡芙”“佳怡”等。为冗余展示字段，真实姓名以助教档案为准。当前数据中与档案一致。|-| +|charge_minutes_raw|int|pdChargeMinutes|助教被废除前“已计费时长（分钟）”的原始值。单位为分钟。示例：214、3600、10800 等。0 表示尚未发生有效计费就被废除。当前数据中存在异常大值（例如 10800），这一业务含义需结合实际规则理解，但本字段原样保留。枚举：数值型，无固定枚举。|-| +|abolish_amount|decimal(18,2)|assistantAbolishAmount|与本次助教废除操作关联的金额，单位元。字面含义为“助教废除金额”。当前样例均为非负数，如 5.83、570.00、0.00 等。正负方向：按照 ODS/JSON 原样保留，暂不在数仓层赋予“收入/支出”的方向含义，后续在 DWS 层按业务规则解释（例如是退还顾客、扣除收益等）。|-| +|trash_reason|varchar(255)|trashReason|废除原因的文本说明，例如可以写“顾客临时取消”“误操作”等。当前样例中全部为空字符串，说明前台并未使用该字段。但从结构上看，是一个自由文本字段，不是枚举。|-| +|create_time|datetime|createTime|这条废除记录创建的时间，格式 YYYY-MM-DD HH:MM:SS。代表系统正式记录“废除操作”的时刻，用于和助教服务流水按时间窗口做软关联（结合 site、table、assistant 等条件）。|-| + + +**dwd_assistant_trash_event_Ex** +|数据库字段名|字段类型|来源字段（JSON 路径）|说明（含枚举与取值）|角色（主键/外键/-）| +|---|---|---|---|---| +|assistant_trash_event_id|bigint|id|助教废除事件主键。与源 JSON 中 id 一一对应，单表内唯一。没有业务含义，只作为技术主键使用。|主键| +|table_name|varchar(64)|tableName|台桌名称/编号，便于直观看报表，如 “C1”“B9”“VIP1”等。文案冗余自台桌维度。枚举：在门店范围内是有限集合，但不是固定编码表。|-| +|table_area_name|varchar(64)|tableArea|台桌区域名称（中文），如 “A区”“B区”“C区”“VIP包厢”“补时长”等。展示用文本，具体层级信息由区域维表提供。|-| + +**dwd_assistant_trash_event 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|assistant_trash_event_id|主键|-|-|主键字段；Ex 表复用此键。| +|site_id|外键|dim_site|site_id|门店 ID。| +|table_id|外键|dim_table|table_id|发生废除的台桌。| +|table_area_id|外键|dim_area|area_id|台桌区域。| +|assistant_no|外键|dim_assistant|assistant_no|助教编号（按工号关联）。| + +------------------------------------------------------------ + +### 会员余额变动 +来自 member_balance_changes.json，粒度为一次储值卡账户余额变动。此表是分析会员资金往来的核心事实表。 + +**dwd_member_balance_change** +|数据库字段名|字段类型|来源字段（member_balance_changes.json）|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|balance_change_id|BIGINT|id|余额变动记录主键 ID，来源于源系统的余额变更流水 ID，唯一标识一条余额变动事件。|主键| +|tenant_id|BIGINT|tenant_id|租户/品牌 ID，在整体系统中唯一标识一家商户。当前样本中为同一值。|外键| +|site_id|BIGINT|site_id|本次余额变动发生的门店 ID。通常对应具体门店；样本中：非 0 为“朗朗桌球”，0 代表平台级/虚拟门店场景（如活动抵用券结算）。|外键| +|register_site_id|BIGINT|register_site_id|办卡门店 ID（卡注册门店）。与 site_id 区分：register_site_id=当初办卡门店，site_id=本次余额变动实际发生门店。当前样本中全部相同。|外键| +|tenant_member_id|BIGINT|tenant_member_id|租户维度会员 ID（同一租户内的会员主键），用于关联会员档案。|外键| +|system_member_id|BIGINT|system_member_id|系统全局会员 ID（跨租户统一的会员标识）。当前只有一个门店，但结构上允许同一人跨租户共享该 ID。|外键| +|tenant_member_card_id|BIGINT|tenant_member_card_id|会员卡账户 ID（租户内唯一的一张具体卡，例如某人的储值卡/酒水卡/台费卡/活动抵用券等）。本次余额变动作用于这张卡。|外键| +|card_type_id|BIGINT|card_type_id|卡种类型 ID。与 card_type_name 一一对应，用于区分不同卡种（储值卡/活动抵用券/酒水卡/台费卡）。|外键| +|card_type_name|VARCHAR(32)|memberCardTypeName|卡种名称（中文）：• 储值卡：通用储值卡；• 活动抵用券：活动送券型卡；• 酒水卡：指定用于酒水类消费；• 台费卡：指定用于台费消费。|-| +|member_name|VARCHAR(64)|memberName|会员姓名/称呼（如“曾丹烨”“葛先生”“胡先生”），主要用于运营、客服和人工识别。|-| +|member_mobile|VARCHAR(20)|memberMobile|会员手机号（完整号码字符串），是会员识别、营销触达的重要字段。|-| +|balance_before|DECIMAL(18,2)|before|本次变动前的卡内余额，单位：元。可为 0、数百、数千等。|-| +|change_amount|DECIMAL(18,2)|account_data|本次余额变动金额，单位：元：• 正数：余额增加（充值、赠送、调整加款等）；• 负数：余额减少（消费扣款、退款冲减、活动抵扣等）。所有记录严格满足：balance_after = balance_before + change_amount（浮点精度内）。|-| +|balance_after|DECIMAL(18,2)|after|本次变动后的卡内余额，单位：元。由 before + account_data 计算而得，在源数据中已给出。|-| +|from_type|INT|from_type|余额变动来源类型枚举（控制业务含义与方向）：• 1：日常消费扣款 —— change_amount 为负数，payment_method=0，表示用卡支付消费被扣余额；• 3：充值增加 —— change_amount 为正数，payment_method=4，表示顾客通过外部支付为卡充值（扫码、银行卡等）；• 4：调整/赠送增加 —— change_amount 为正数，payment_method=3，通常为后台赠送或手工加款；• 7：充值退款 —— change_amount 为负数，remark='充值退款'，表示对历史充值做退款，以减少卡内余额方式体现；• 9：活动抵用券相关余额冲减 —— change_amount 为负数，卡种为“活动抵用券”，site_id=0，表示活动券额度被扣回或结算；• 2：其他增加 —— 当前仅 1 条正数样本（+1865.80），具体业务类型不明，但可确定为余额增加类。总体上：1/7/9 为减余额类，2/3/4 为加余额类。|-| +|payment_method|INT|payment_method|支付/变动渠道枚举（与源系统支付方式枚举一致）：• 0：内部结算/无外部支付 —— 日常消费扣款、内部扣减、退款冲减等场景，新资金流不在本记录中产生；• 3：赠送/后台调整渠道 —— 与 from_type=4 搭配出现，表示此余额增加不是顾客付钱，而是后台发放或内部调账；• 4：充值外部支付渠道 —— 与 from_type=3 搭配出现，代表顾客通过某外部渠道完成充值（具体是微信/支付宝/银行卡等需要结合支付枚举表进一步映射）。|-| +|change_time|DATETIME|create_time|余额变动时间（记录创建时间），格式 YYYY-MM-DD HH:MM:SS。通常紧邻实际交易发生时间，用于按时间线分析资金变动。|-| +|is_delete|TINYINT|is_delete|逻辑删除标记：• 0：正常记录（当前样本全部为 0）；• 1：逻辑删除（标记为删除但数据库保留，用于追溯）。分析时通常需要过滤掉 is_delete=1 的记录。|-| +|remark|VARCHAR(255)|remark|余额变动备注信息。当前样本中主要为：• 空字符串：无额外说明；• 充值退款：明确标记该条记录为“充值退款”业务，与 from_type=7 完全对应。后续可能出现其他业务备注。|-| + + + +**dwd_member_balance_change_Ex** +|数据库字段名|字段类型|来源字段（member_balance_changes.json）|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|balance_change_id|BIGINT|id|余额变动记录主键 ID，来源于源系统的余额变更流水 ID，唯一标识一条余额变动事件。|主键| +|pay_site_name|VARCHAR(64)|paySiteName|余额变动发生门店名称，对应 site_id 的中文名。示例：朗朗桌球；当 site_id = 0 时通常为空字符串。纯展示冗余。|-| +|register_site_name|VARCHAR(64)|registerSiteName|办卡门店名称，对应 register_site_id 的中文名。当前样本全部为 朗朗桌球，属于冗余展示。|-| +|refund_amount|DECIMAL(18,2)|refund_amount|退款金额字段。在当前样本数据中全部为 0.00，推测用于区分“退回卡内余额”和“原路退回”等更细的退款模式，但目前未启用。|-| +|operator_id|BIGINT|operator_id|操作员 ID，执行本次余额变动操作的员工账号主键。可关联员工/账号维度。|外键| +|operator_name|VARCHAR(64)|operator_name|操作员名称及职位说明，例如：收银员:郑丽珊、店长:谢晓洪 等，是对 operator_id 的可读冗余。|-| + +**dwd_member_balance_change 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|balance_change_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|发生变动的门店。| +|register_site_id|外键|dim_site|site_id|办卡门店。| +|tenant_member_id|外键|dim_member|member_id|租户内会员。| +|system_member_id|外键|dim_system_member|system_member_id|全局会员。| +|tenant_member_card_id|外键|dim_member_card_account|member_card_id|对应的会员卡账户。| +|card_type_id|外键|dim_card_type|card_type_id|卡种。| +|payment_method|外键|dim_payment_method|payment_method_id|支付/变动渠道。| +|operator_id|外键|dim_staff|staff_id|操作员（Ex 表字段）。| + +------------------------------------------------------------ + +### 团购券核销 +来自 group_buy_redemption_records.json 中各条记录。每行代表一次团购券使用/核销事件。 + +**dwd_groupbuy_redemption** +|数据库字段名|字段类型|来源字段（group_buy_redemption_records.json）|说明（含枚举与取值说明）|角色（主键/外键/-）|业务重要性| +|---|---|---|---|---|---| +|redemption_id|bigint|id|团购券核销流水主键。一条记录代表一次团购券使用在某次台费上的一条核销明细。|主键| | +|tenant_id|bigint|tenant_id|租户/品牌 ID。与其他表统一的租户标识，用于品牌维度聚合。|外键|重要| +|site_id|bigint|site_id|门店 ID。与门店维度及其他业务事实中的 site_id 一致。|外键|重要| +|table_id|bigint|table_id|球台 ID。与台桌维度表中的 id 对应，用于确定具体哪一张球台。|外键|重要| +|tenant_table_area_id|bigint|tenant_table_area_id|租户级台区组合 ID。与团购套餐定义中的 tenant_table_area_id_list 元素对应，表示该券实际使用时所在的台区组合。用于校验券的适用台区是否匹配实际台桌。|外键|重要| +|table_charge_seconds|int|table_charge_seconds|本次结算中该球台总计计费的秒数（整台计费时间）。当台上除了券覆盖时长之外还有额外计费时间时，该值会大于券核销时长。|-|重要| +|order_trade_no|bigint|order_trade_no|订单交易号。与台费流水、商品销售、助教服务、小票详情等表的 order_trade_no 一致，用于将同一笔结账中的所有明细串联起来。|外键|重要| +|order_settle_id|bigint|order_settle_id|结算单 ID。与结账记录和小票详情中的结算主键对应，用于从团购券核销记录跳转到整单结算。|外键|重要| +|order_coupon_id|bigint|order_coupon_id|订单中的“券使用记录 ID”。与平台或内部券核销表中的主键一致，用于在订单内部定位这条券使用记录。当前与 coupon_origin_id 数值相等。|外键|重要| +|coupon_origin_id|bigint|coupon_origin_id|上游系统或第三方平台中该券记录的主键 ID。可在平台验券记录中查到券的来源平台、原订单等。当前与 order_coupon_id 数值一致，但语义是“券来源 ID”。|外键|重要| +|promotion_activity_id|bigint|promotion_activity_id|促销活动 ID。每条记录对应一个活动主键，用于识别券所属的促销活动或团购活动。|外键|重要| +|promotion_coupon_id|bigint|promotion_coupon_id|团购套餐定义 ID。与 group_buy_packages.json 中的 id 一一对应，表示当前使用的是哪一种团购套餐（例如某款“一小时套餐”“两小时套餐”）。|外键|重要| +|order_coupon_channel|tinyint|order_coupon_channel|券渠道类型枚举。观测值：1（大量记录）、2（少量记录）。用于区分券的来源渠道，例如不同团购平台或内部券。具体数值与渠道名称的映射由业务配置决定。|外键|重要| +|ledger_unit_price|decimal(18,2)|ledger_unit_price|本次券在台费侧对应的标准单价，单位元/小时。典型值如 29.9、39.9、59.9、69.9 等。与门店台费计费规则中的单价相对应，用于计算券对应的金额。|-|重要| +|ledger_count|int|ledger_count|本次券实际核销的计费秒数。大部分记录等于 promotion_seconds，少数略小于标准时长，表示这张券只覆盖了本次台费的一部分时长。|-|重要| +|ledger_amount|decimal(18,2)|ledger_amount|本次团购券实际冲抵台费的金额。大部分记录中该值与 coupon_money 相等，少数存在小数差异，来源于按单价与秒数换算的结果。|-|重要| +|coupon_money|decimal(18,2)|coupon_money|本次核销时，团购券在门店侧对应的金额额度（可抵扣金额）。同一种 promotion_coupon_id 下，该值固定，例如某套餐固定为 48.00 元、某套餐固定为 96.00 元等。|-|重要| +|promotion_seconds|int|promotion_seconds|团购套餐定义的标准时长权益，单位秒。观测枚举值为 3600、7200、14400，分别对应 1 小时、2 小时、4 小时。与团购套餐定义表中的 duration 字段一致。|-|重要| +|coupon_code|varchar(64)|coupon_code|团购券券码字符串。每条记录一个唯一券码，例如“0107892475999”。用于与平台验券记录、券购买记录等做一一对应，追踪券的全生命周期。|外键|重要| +|is_single_order|tinyint|is_single_order|是否作为单独订单行。观测值：1 为主，表示以独立条目方式结算；0 为个别记录，表示嵌入某种组合结算结构。具体业务含义依赖上层订单结构设计。|-|重要| +|is_delete|tinyint|is_delete|逻辑删除标记。0 表示正常记录，1 表示逻辑删除但数据仍保留用于追溯。当前样本全部为 0，用于过滤有效记录。|-|重要| +|ledger_name|varchar(128)|ledger_name|团购项目记账名称，如“全天A区中八一小时”“B区桌球一小时”“中八、斯诺克包厢两小时”等。通常与团购套餐名称相近，用于报表展示和套餐维度分析。|-|重要| +|create_time|datetime|create_time|本条团购券核销流水的创建时间，通常即核销时间，格式为“YYYY-MM-DD HH:MM:SS”。用于时间维度分析和数据分区。|-|重要| + + + +**dwd_groupbuy_redemption_Ex** +来自 group_buy_redemption_records.json 中各条记录。每行代表一次团购券使用/核销事件。 + +|数据库字段名|字段类型|来源字段（group_buy_redemption_records.json）|说明（含枚举与取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|redemption_id|bigint|id|团购券核销流水主键。一条记录代表一次团购券使用在某次台费上的一条核销明细。|主键| +|site_name|varchar(64)|siteName|门店名称。当前样本全部为同一门店，仅作冗余展示。|-| +|table_name|varchar(64)|tableName|球台名称或台号。如 A7、A11、B1 等。用于业务报表展示与人工识别。|-| +|table_area_name|varchar(64)|tableAreaName|台区名称。观测枚举值包括 A区、B区、斯诺克区、麻将房。实际取值随门店台区配置变化。|-| +|order_pay_id|bigint|order_pay_id|支付流水 ID。部分记录为 0，表示未在当前导出范围内关联到具体支付记录。真实含义为“指向支付记录表中的支付流水”。|外键| +|goods_option_price|decimal(18,2)|goodsOptionPrice|商品规格价格，用于商品类促销分摊时使用。当前在团购券核销场景中全部为 0，仅作为结构预留。|-| +|goods_promotion_money|decimal(18,2)|goods_promotion_money|本次券使用中分摊到“商品”部分的促销金额。当前所有记录为 0，说明本门店的团购券未用于商品抵扣。|-| +|table_service_promotion_money|decimal(18,2)|table_service_promotion_money|本次券使用中分摊到“台费服务费”部分的促销金额。当前样本全部为 0，结构上用于支持更细粒度的费用拆分。|-| +|assistant_promotion_money|decimal(18,2)|assistant_promotion_money|本次券使用中分摊到“助教服务”的促销金额。当前全部为 0，说明团购券尚未用于助教服务的抵扣。|-| +|assistant_service_promotion_money|decimal(18,2)|assistant_service_promotion_money|进一步细分助教服务对应的促销金额。当前为 0，仅预留结构以支持复杂场景。|-| +|reward_promotion_money|decimal(18,2)|reward_promotion_money|本次促销中属于“奖励金、积分”等来源的促销金额分摊。当前为 0，预留用于积分或奖励金同时参与活动时的金额拆分。|-| +|recharge_promotion_money|decimal(18,2)|recharge_promotion_money|来自“充值赠送”等储值优惠的促销金额分摊。当前为 0，预留用于将来区分“券优惠”和“充值赠送优惠”的场景。|-| +|offer_type|tinyint|offer_type|优惠类型枚举。当前样本值全部为 1，表示本门店使用的团购券均为同一类型（例如“套餐券”）。其他取值可能对应满减、折扣、代金券等优惠类型，在本数据中未出现。|-| +|ledger_status|tinyint|ledger_status|流水状态。观测值全部为 1。常规含义为：1 表示正常有效记录；其他值预留用于表示作废、撤销、未生效等状态。当前导出仅包含正常状态记录。|-| +|operator_id|bigint|operator_id|执行本次券核销操作的操作员 ID。可与员工维度表对接，用于分析不同操作员的核销行为与绩效。|外键| +|operator_name|varchar(64)|operator_name|操作员名称及角色说明，例如“收银员:郑丽珊”。与 operator_id 冗余，对报表展示友好，但不参与模型关联。|-| +|salesman_user_id|bigint|salesman_user_id|营业员用户 ID。当前全部为 0，表示本门店在团购券场景未单独记录营业员信息。|外键| +|salesman_name|varchar(64)|salesman_name|营业员姓名。当前为空字符串。结构上用于记录拉单或促销的业务员信息。|-| +|salesman_role_id|bigint|salesman_role_id|营业员角色 ID。当前为 0，预留用于标识营业员在组织中的角色类型。|-| +|salesman_org_id|bigint|sales_man_org_id|营业员所属组织 ID。来源字段为 sales_man_org_id，DWD 层统一命名为 salesman_org_id。当前为 0，用于将来对接组织架构维度。|-| +|ledger_group_name|varchar(128)|ledger_group_name|团购项目的记账分组名称。当前全部为空，预留给将来按团购项目大类分组（例如“团购台费”“团购包厢”）使用。|-| + +**dwd_groupbuy_redemption 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|redemption_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|table_id|外键|dim_table|table_id|核销所在台桌。| +|tenant_table_area_id|外键|dim_table_area_group|tenant_table_area_group_id|租户级台区分组。| +|promotion_coupon_id|外键|dim_groupbuy_package|groupbuy_package_id|对应的团购套餐定义。| +|promotion_activity_id|外键|dim_promotion_activity|promotion_activity_id|所属促销活动。| +|order_coupon_channel|外键|dim_coupon_channel|coupon_channel_id|券来源渠道。| +|order_settle_id|外键|dwd_settlement_head|order_settle_id|结账主单。| +|order_trade_no|业务键|dwd_table_fee_log / dwd_payment|order_trade_no|订单级串联键。| +|order_pay_id|外键|dwd_payment|payment_id|支付流水（Ex 表字段）。| +|coupon_code|业务键|dwd_platform_coupon_redemption|coupon_code|与平台券核销记录按券码对齐。| +|operator_id|外键|dim_staff|staff_id|核销操作员（Ex 表字段）。| +|salesman_user_id|外键|dim_staff|staff_id|营业员（Ex 表字段）。| + + +------------------------------------------------------------ + +### 第三方平台券核销 +来自 platform_coupon_redemption_records.json。每条记录代表一次第三方团购券的核销，用于追踪渠道引流和兑换。 + +**dwd_platform_coupon_redemption** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|platform_coupon_redemption_id|bigint|id|平台券核销记录在本系统内的主键 ID。长整型分布式 ID，用于唯一标识本次核销流水。|主键| +|tenant_id|bigint|tenant_id|租户 ID，品牌级别标识。例如整套系统中的“朗朗桌球”品牌。与其他表的 tenant_id 一致，用于划分租户数据域。|外键| +|site_id|bigint|site_id|门店 ID。与门店维度 dim_site.site_id 对应，用于区分不同门店。siteProfile.id 与此字段相同，本表不再冗余门店快照。|外键| +|coupon_code|varchar(64)|coupon_code|第三方团购券券码，顾客出示的核销码。当前样本中全表唯一，可视为业务自然主键，用于验券、对账、查询。|-| +|coupon_channel|tinyint|coupon_channel|券来源渠道枚举，表示第三方平台渠道编号。观测值：1，2。具体含义需结合系统配置，一般可理解为：1 表示平台渠道 1（主平台），2 表示平台渠道 2（其他入口或子平台）。|-| +|coupon_name|varchar(200)|coupon_name|第三方团购券产品名称，例如“【全天可用】中八桌球一小时（A区）”“1小时中八台球【11月特惠】（A区）”等。用于报表展示和区分不同团购产品。| | +|sale_price|decimal(10,2)|sale_price|顾客在第三方平台实际支付的团购售价，例如 11.11、29.90、39.90 等。始终小于 coupon_money，体现“折后价”。|-| +|coupon_money|decimal(10,2)|coupon_money|券面值或套餐价值，即系统认为该券可抵扣的金额，例如 48.00、58.00、68.00、96.00、116.00、288.00。与 coupon_name 有固定对应关系。|-| +|coupon_free_time|int|coupon_free_time|券附带的赠送时长，单位：秒。当前样本全部为 0，表示无独立赠送时长。若未来有赠送时间型券，则该字段存储赠送的秒数。|-| +|channel_deal_id|bigint|channel_deal_id|渠道侧团购商品 ID（第三方平台 dealId）。值域有限（约 9 个值），与 coupon_name 一一对应。用于对接第三方接口和按平台商品维度统计。|- 或 外键（预留）| +|deal_id|bigint|deal_id|平台/系统侧团购商品 ID。多数记录为非 0 整数，也有部分为 0。与 coupon_name 存在稳定对应关系，0 表示内部未配置或未同步。未来可作为内部团购商品维度外键。|外键（预留）| +|group_package_id|bigint|group_package_id|内部“团购套餐”定义表主键 ID。当前样本中全部为 0，表示平台券尚未映射到自有团购套餐；从设计上是预留的外键字段。|外键| +|site_order_id|bigint|site_order_id|门店内部订单 ID。本次平台券核销所挂靠的店内订单号。用于与结账记录、台费流水、商品销售等事实表通过订单维度关联。|外键| +|table_id|bigint|table_id|使用团购券的球台 ID。与 dim_site_table.table_id 对应，用于统计每张球台的第三方平台引流情况。|外键| +|certificate_id|varchar(64)|certificate_id|第三方平台侧券实例 ID（凭证 ID），通常为 16–19 位数字字符串。用于与外部平台对账与查询核销结果。存在重复值，不能单独作为唯一键。|-| +|verify_id|varchar(64)|verify_id|第三方平台核销记录 ID。大部分记录为空，少量有值。存在时可用于精确反查平台侧核销记录。|-| +|use_status|tinyint|use_status|券使用状态枚举。观测值：1、2。1 表示已使用/已核销（正常消耗）；2 表示已退款/已撤销或使用后反冲的状态。是判断券生命周期状态的核心字段。|-| +|is_delete|tinyint|is_delete|逻辑删除标志。0 表示未删除；1 表示已逻辑删除。与 use_status 独立：即便业务状态异常（如 use_status=2），也可能 is_delete 仍为 0 以保留记录。|-| +|create_time|datetime|create_time|系统记录创建时间，即核销记录写入本系统的时间。格式为 YYYY-MM-DD HH:MM:SS。通常与 consume_time 相差约 1 秒。|-| +|consume_time|datetime|consume_time|券被核销/使用的业务时间，代表实际团购券使用发生的时间点。后续按核销日期统计核销量时以该字段为准。|-| + + +**dwd_platform_coupon_redemption_Ex** + +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色| +|---|---|---|---|---| +|platform_coupon_redemption_id|bigint|id|平台券核销记录在本系统内的主键 ID。长整型分布式 ID，用于唯一标识本次核销流水。|主键| +|coupon_cover|varchar(255)|coupon_cover|券封面图片地址 URL，用于前端展示团购券图片。对经营分析和结算逻辑无影响。|-| +|coupon_remark|varchar(255)|coupon_remark|券描述或备注信息，用于展示券规则、说明文字。未参与计算和关联逻辑。|-| +|groupon_type|tinyint|groupon_type|团购券类型枚举。当前样本全部为 1。推断含义：1 表示标准团购券，其他值预留为次卡、套餐券、权益券等类型。|-| +|operator_id|bigint|operator_id|执行验券操作的员工/收银员账号 ID。当前样本中多数为同一值。可与员工/账号维度表关联。|外键| +|operator_name|varchar(50)|operator_name|操作员姓名或显示名，例如“收银员:郑丽珊”。是 operator_id 的冗余展示字段，用于报表展示。|-| + + + +**dwd_platform_coupon_redemption 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|platform_coupon_redemption_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|table_id|外键|dim_table|table_id|核销所在台桌。| +|coupon_channel|外键|dim_coupon_channel|coupon_channel_id|第三方渠道。| +|deal_id|外键|dim_platform_deal|deal_id|平台商品/项目。| +|group_package_id|外键|dim_groupbuy_package|groupbuy_package_id|内部映射的团购套餐。| +|site_order_id|外键|dwd_settlement_head|order_settle_id|挂靠的店内订单。| +|coupon_code|业务键|dwd_groupbuy_redemption|coupon_code|可与内部团购核销按券码对齐。| +|operator_id|外键|dim_staff|staff_id|核销操作员（Ex 表字段）。| + + + +------------------------------------------------------------ + +### 充值结算 +来自 recharge_settlements.json的settleList.settleList.。每行是一条充值订单，记录充值金额、赠送金额及是否首充。 + +**dwd_recharge_order** +|数据库字段名|字段类型|来源字段（JSON 路径）|说明（含枚举/取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|recharge_order_id|bigint|id|充值结算记录主键；唯一标识一条充值/撤销记录。|主键| +|tenant_id|int|tenantId|租户/品牌 ID；与其他 JSON 中 tenantId 含义一致。|外键（dim_tenant）| +|site_id|int|siteId|门店 ID；与 siteProfile.id 一致，用于关联门店维度。|外键（dim_site）| +|member_id|bigint|memberId|会员 ID；对应会员档案中的 tenantMemberInfos.id。标识给哪个会员充值。|外键（dim_member）| +|member_name_snapshot|varchar|memberName|会员姓名/昵称快照，可能是名称或手机号字符串。|-| +|member_phone_snapshot|varchar|memberPhone|会员手机号快照。|-| +|tenant_member_card_id|bigint|tenantMemberCardId|会员卡实例 ID（某张具体卡）；可关联 dim_member_card_account。|外键（dim_member_card_account）| +|member_card_type_name|varchar|memberCardTypeName|会员卡类型名称；当前样例主要有：“储值卡”、“月卡”。|-| +|settle_relate_id|bigint|settleRelateId|结算关联 ID；用于与支付记录等跨表关联（类似业务单 ID）。|外键（与支付/结算域软关联）| +|settle_type|tinyint|settleType|结算类型枚举：5=“充值订单”（正常充值）；7=“充值撤销”（冲销记录）。|-| +|settle_name|varchar|settleName|结算类型名称："充值订单"、"充值撤销"；前端展示用。|-| +|is_first|tinyint|isFirst|是否首充标记。取值：1 或 2。理论含义类似“是否首充”，但 1/2 的精确定义需系统字典确认。|-| +|pay_amount|decimal(18,2)|payAmount|本条记录的充值金额（可为正/负）：正数=实际充值金额；负数=撤销流水金额（settleType=7）。|-| +|refund_amount|decimal(18,2)|refundAmount|对该充值订单的退款金额（通常为正数）；原始充值单上为已退款金额，对应会有一条负数的“充值撤销”记录。|-| +|point_amount|decimal(18,2)|pointAmount|计入会员账户的储值/积分金额；多数情况下等于 pay_amount 的绝对值；撤销记录一般为 0。|-| +|cash_amount|decimal(18,2)|cashAmount|现金收款金额；样本中少数为 3000/5000，其余为 0。|-| +|payment_method|tinyint|paymentMethod|支付方式编码。样本取值：1、2、4；具体对应渠道（现金/微信/支付宝/银行卡等）需系统“支付方式字典”确认。|-| +|create_time|datetime|createTime|充值记录创建时间（收银完成时间）；用于时间分区、统计。|-| +|pay_time|datetime|payTime|支付完成时间；通常与 create_time 接近或相同。|-| + + + +**dwd_recharge_order_Ex** +|数据库字段名|字段类型|来源字段（JSON 路径）|说明（含枚举/取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|recharge_order_id|bigint|id|充值结算记录主键；唯一标识一条充值/撤销记录。|主键| +|site_name_snapshot|varchar|siteName|门店名称快照，如“朗朗桌球”；仅用于展示，门店改名后本字段不变。|-| +|settle_status|tinyint|settleStatus|结算状态；当前数据全部为 2，推测 2=已完成。其它状态未出现在样本中。|-| +|is_bind_member|boolean|isBindMember|是否绑定为会员/其他绑定标记；当前所有记录为 False，而又都有 memberId，实际业务含义不清。|-| +|is_activity|boolean|isActivity|是否关联营销活动；当前全部为 False，表示样本周期内充值未绑定活动。|-| +|is_use_coupon|boolean|isUseCoupon|本次充值是否使用优惠券；当前样本全部为 False。结构上预留“充值用券”的能力。|-| +|is_use_discount|boolean|isUseDiscount|是否使用折扣（如充值折扣）；样本中全为 False。|-| +|can_be_revoked|boolean|canBeRevoked|当前记录是否仍可撤销；样本中全为 False（导出时均不可撤销）。|-| +|online_amount|decimal(18,2)|onlineAmount|线上支付金额（如微信、支付宝等）；当前样本为 0，但字段为支付渠道拆分预留。|-| +|balance_amount|decimal(18,2)|balanceAmount|从账户余额中支付的金额；充值场景通常为 0（用余额充值没有实际意义）。|-| +|card_amount|decimal(18,2)|cardAmount|从其他储值卡或某种卡余额支付的金额；当前样本全为 0。|-| +|coupon_amount|decimal(18,2)|couponAmount|使用券直接支付的金额（如储值券）；当前样本为 0。|-| +|recharge_card_amount|decimal(18,2)|rechargeCardAmount|充值到卡上的金额（与 point_amount 区分不同资金属性）；样本为 0，结构预留。|-| +|gift_card_amount|decimal(18,2)|giftCardAmount|赠送卡金额（如买 1000 送 100 的赠送部分）；当前样本为 0。|-| +|prepay_money|decimal(18,2)|prepayMoney|预付款金额（订金）；当前样本为 0，充值未启用此场景。|-| +|consume_money|decimal(18,2)|consumeMoney|消费总金额；在充值文件中全部为 0，实际用于消费场景（台费/商品）的结算模型复用字段。|-| +|goods_money|decimal(18,2)|goodsMoney|商品消费金额（充值记录中为 0）。|-| +|real_goods_money|decimal(18,2)|realGoodsMoney|实际应计商品金额（扣除折扣后）；充值记录中为 0。|-| +|table_charge_money|decimal(18,2)|tableChargeMoney|台费金额；充值记录中为 0，来自通用结算模型。|-| +|service_money|decimal(18,2)|serviceMoney|服务项目金额（如助教、其他服务）；充值中为 0。|-| +|activity_discount|decimal(18,2)|activityDiscount|营销活动折扣金额；当前样本为 0。|-| +|all_coupon_discount|decimal(18,2)|allCouponDiscount|各类优惠券、团购券综合折扣金额；样本为 0。|-| +|goods_promotion_money|decimal(18,2)|goodsPromotionMoney|商品促销优惠金额；样本为 0。|-| +|assistant_promotion_money|decimal(18,2)|assistantPromotionMoney|助教相关促销优惠金额；样本为 0。|-| +|assistant_pd_money|decimal(18,2)|assistantPdMoney|助教配单金额/相关费用；样本为 0。|-| +|assistant_cx_money|decimal(18,2)|assistantCxMoney|助教冲销/促销相关金额；样本为 0。|-| +|assistant_manual_discount|decimal(18,2)|assistantManualDiscount|助教手工减免金额；样本为 0。|-| +|coupon_sale_amount|decimal(18,2)|couponSaleAmount|券/套餐销售金额（售卖券时使用）；充值场景中为 0。|-| +|member_discount_amount|decimal(18,2)|memberDiscountAmount|因会员折扣产生的优惠金额；在充值样本中为 0。|-| +|point_discount_price|decimal(18,2)|pointDiscountPrice|积分抵扣产生的价差（价格部分）；样本为 0。|-| +|point_discount_cost|decimal(18,2)|pointDiscountCost|积分抵扣对应的成本金额；样本为 0。|-| +|adjust_amount|decimal(18,2)|adjustAmount|手工调整金额（非抹零）；样本为 0。|-| +|rounding_amount|decimal(18,2)|roundingAmount|抹零金额（四舍五入产生的差额）；样本为 0。|-| +|operator_id|bigint|operatorId|操作该笔充值的收银员/员工 ID。|外键（将来可关联 dim_staff）| +|operator_name_snapshot|varchar|operatorName|操作员姓名快照，便于直接阅读；与 operator_id 对应。|-| +|salesman_user_id|bigint|salesManUserId|营业员用户 ID；当前样本全部为 0。|外键（潜在 dim_staff）| +|salesman_name|varchar|salesManName|营业员/销售员姓名；样本为空字符串。|-| +|order_remark|varchar|orderRemark|充值订单备注，如手工说明；当前样本为空。|-| +|table_id|int|tableId|台桌 ID；充值场景下全部是 0，表示该订单不挂具体球台。|-| +|serial_number|int|serialNumber|流水/小票序号；当前样本全部为 0，本门店未启用。|-| +|revoke_order_id|bigint|revokeOrderId|撤销相关订单 ID（被撤销原单或撤销单指针）；样本中存在值但逻辑未完全启用。|-| +|revoke_order_name|varchar|revokeOrderName|撤销单名称/说明；样本全为空。|-| +|revoke_time|datetime|revokeTime|撤销时间；当前样本为空，撤销信息主要通过负数流水与 refund_amount 表达。|-| + + + + +**dwd_recharge_order 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|recharge_order_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|member_id|外键|dim_member|member_id|会员。| +|tenant_member_card_id|外键|dim_member_card_account|member_card_id|会员卡账户。| +|payment_method|外键|dim_payment_method|payment_method_id|支付方式。| +|settle_relate_id|外键|dwd_payment|relate_id|对应支付/业务单关联键。| +|operator_id|外键|dim_staff|staff_id|收银员/操作员（Ex 表）。| +|salesman_user_id|外键|dim_staff|staff_id|营业员（Ex 表）。| + + + +------------------------------------------------------------ + +### 支付流水 +来自 payment_transactions.json。每行代表一笔支付或收款流水，与结算单、充值单等关联。只有 pay_status=2 的支付成功记录被导出。 + +**dwd_payment** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|payment_id|bigint|payment_transactions.id|支付流水主键ID。与源系统 id 一致。每条支付流水唯一标识一条支付行为（包括金额为 0 的记录）。|主键| +|site_id|bigint|payment_transactions.site_id|门店ID。当前样本中全部为同一门店 2790685415443269。在数仓中外键关联 dim_site.site_id。|外键| +|relate_type|int|payment_transactions.relate_type|业务关联类型枚举，用来区分这条支付流水对应哪一类业务单据：• 2：结账单支付，对应结账记录 settlement_records 中的结账单；• 5：会员卡充值/账户变动类支付，对应会员余额/充值业务单号，在会员余额变更或充值结算中复用；• 1：其他业务类型，目前样本中仅有 1 条记录，具体业务含义待业务侧补充。|-| +|relate_id|bigint|payment_transactions.relate_id|关联业务记录ID，配合 relate_type 使用，是一个“多态外键”：• 当 relate_type = 2 时：relate_id = settlement_records.settleList.id（结账记录主键，对应 dwd_settlement_head_di.order_settle_id）；• 当 relate_type = 5 时：relate_id = 会员卡余额变动/充值业务单号，在会员余额变更流水中同名字段使用；• 当 relate_type = 1 时：关联具体业务尚未确认，仅可视为预留类型。|外键（多业务类型）| +|pay_amount|decimal(18,2)|payment_transactions.pay_amount|本次支付金额，单位元。为收入类字段，当前样本全部为非负数：• 正数：实际通过该支付方式收取的金额；• 0：仍生成支付流水，但实收金额为 0（例如整单由会员优惠、团购券、余额等抵扣），当前样本中有 140 条记录金额为 0。|-| +|pay_status|int|payment_transactions.pay_status|支付状态枚举。当前样本中仅出现：• 2：支付成功。其它可能的状态（未支付、支付中、失败、已退款等）在本次导出中未出现，需以后按系统支付状态配置补充。由于本 JSON 仅导出成功记录，可以视作“成功支付流水视图”。|-| +|payment_method|int|payment_transactions.payment_method|支付方式枚举。当前样本中出现的取值：• 2：共 140 条记录；• 4：共 60 条记录。具体取值与“支付方式配置表”对应，例如可能代表现金、扫码支付、银行卡等。由于配置表未导出，在数仓中应作为枚举码字段，通过后续 dim_payment_method 进行解码。不要在数仓层擅自写死“2=微信、4=支付宝”等含义。|外键（预期关联支付方式维度）| +|online_pay_channel|int|payment_transactions.online_pay_channel|线上支付通道枚举。用于进一步细分线上渠道，例如：• 0：无线上通道/线下，或未区分具体线上通道（当前样本全部为 0）；• 1：微信（推测，未在样本中出现）；• 2：支付宝（推测，未在样本中出现）。目前门店在当前时间段内尚未使用该字段进行实际区分，业务含义需结合正式配置确认。|-| +|create_time|datetime|payment_transactions.create_time|支付流水创建时间，格式 YYYY-MM-DD HH:MM:SS。通常是发起支付请求的时间。当前样本中 create_time 与 pay_time 多数相同，但模型上允许两者不同（例如异步支付）。|-| +|pay_time|datetime|payment_transactions.pay_time|支付完成时间（支付成功时间戳），格式 YYYY-MM-DD HH:MM:SS。用于统计资金实际入账时间，以及与结账时间进行对齐分析。|-| +|pay_date|date|由 payment_transactions.pay_time 派生|支付日期分区字段，从 pay_time 截取 YYYY-MM-DD 得到。例如 pay_time = '2025-11-09 23:35:57' 时，pay_date = '2025-11-09'。用于 DWD 表按天分区和日粒度汇总。|-| + +**dwd_payment 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|payment_id|主键|-|-|主键字段；支付流水唯一键，Ex 表复用。| +|site_id|外键|dim_site|site_id|门店 ID。| +|payment_method|外键|dim_payment_method|payment_method_id|支付方式枚举。| +|online_pay_channel|外键|dim_online_pay_channel|online_pay_channel_id|线上子渠道（预留维度）。| +|relate_type|-|业务字典|-|区分业务主单类型。| +|relate_id|外键（多态）|dwd_settlement_head / dwd_recharge_order / dwd_member_balance_change|order_settle_id / recharge_order_id / balance_change_id|随 relate_type 变化的业务主单 ID。| +|pay_date|分区键|-|-|日分区字段。| + +------------------------------------------------------------ + +### 退款流水 +来自 refund_transactions.json。每行代表一笔退款，对应原支付流水。退款金额以负数存储在 pay_amount 字段；字段 refund_amount 全部为 0，实际退款金额需取 pay_amount 的绝对值。 + +**dwd_refund** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|refund_id|bigint|id|退款流水主键。每条退款记录唯一 ID（雪花ID风格长整型）。|主键| +|tenant_id|bigint|tenant_id|租户/品牌 ID，标识所属商户。与其他表中的 tenant_id 一致。|外键| +|site_id|bigint|site_id|门店 ID。与门店维度 dim_site.site_id 对应，用于分门店分析。|外键| +|relate_type|int|relate_type|业务类型枚举，指示本退款对应哪类业务主单：当前样本值 {2, 5}：2=消费/结账类业务；5=充值/储值类业务（根据分析文档推断，具体定义需以业务字典为准）。与 relate_id 组合使用。|-| +|relate_id|bigint|relate_id|关联的业务主键 ID。含义依赖 relate_type：relate_type=2 时通常指结账主单 ID；relate_type=5 时通常指充值/储值业务单 ID。同一个 relate_id 可能有多笔退款（分批退款）。|外键| +|pay_amount|decimal(18,2)|pay_amount|本次退款的资金金额，统一为负数。绝对值即退款金额。例如 -5000.00 表示退款 5000 元。是后续退款金额统计的主字段。|-| +|channel_fee|decimal(18,2)|channel_fee|第三方支付渠道对本次退款收取的手续费。当前样本全部为 0.00，但从设计看用于“通道成本核算”。|-| +|pay_time|datetime|pay_time|退款在支付渠道/系统中发生的时间（退款完成时间）。用于对账及按时间统计退款。当前样本中等于 create_time。|-| +|create_time|datetime|create_time|本条退款流水在系统内创建时间。与 pay_time 区分“记录生成时间 vs. 渠道时间”，当前样本中两者相同。|-| +|payment_method|int|payment_method|支付方式枚举，指本次退款对应的原支付方式（如哪种通道）。样本中仅出现值 4；在支付记录中曾出现 {2,4} 两种值。含义：区分不同支付方式（如微信、支付宝、银行卡、现金、储值卡等），具体值与含义需参照支付方式配置表。|-| +|member_id|bigint|member_id|关联的会员 ID，对应会员档案表主键。当前样本全部为 0，表示这些退款未绑定到具体会员。|外键| +|member_card_id|bigint|member_card_id|关联的会员卡账户 ID，对应会员卡账户/储值卡维度主键。样本全部为 0，当前没有“退到会员卡”的记录。|外键| + + +**dwd_refund_Ex** +|数据库字段名|字段类型|来源字段|说明（含枚举值和取值说明）|角色（主键/外键/-）| +|---|---|---|---|---| +|refund_id|bigint|id|退款流水主键。每条退款记录唯一 ID（雪花ID风格长整型）。|主键| +|tenant_name|varchar(64)|tenantName|租户名称，例如“朗朗桌球”。与租户维度中的名称冗余。|-| +|pay_sn|bigint|pay_sn|支付流水内部序号。退款记录中样本全部为 0，未看到实际使用场景，含义未从文档中说明。|-| +|refund_amount|decimal(18,2)|refund_amount|设计上应为“本次退款金额（正数）”。当前样本全部为 0.00，系统实际使用的是 pay_amount 记录金额，此字段暂未启用。|-| +|round_amount|decimal(18,2)|round_amount|退款过程中的舍入/抹零金额（例如因四舍五入产生的差额）。当前样本全部为 0.00。|-| +|balance_frozen_amount|decimal(18,2)|balance_frozen_amount|与会员余额相关的“冻结金额”，如先冻结再退款的流程。当前样本全部为 0.00，且 member_id/member_card_id 为 0，说明本批退款没有涉及会员余额冻结。|-| +|card_frozen_amount|decimal(18,2)|card_frozen_amount|与某张会员卡余额相关的冻结金额。样本全部为 0.00，未实际使用。|-| +|pay_status|int|pay_status|退款状态枚举。样本中全部为 2。结合支付记录：2 表示“成功/已完成”。其他可能值（0=未处理，1=处理中等）未在样本中出现，具体以系统枚举为准。|-| +|action_type|int|action_type|资金动作类型枚举。样本全部为 2。根据分析：1=支付，2=退款。退款流水恒为 2，用于与支付流水区分。|-| +|is_revoke|int|is_revoke|是否为“撤销型”退款。枚举：0=正常退款；1=撤销原支付（撤销而非普通退货）。当前样本全部为 0。|-| +|is_delete|int|is_delete|逻辑删除标志。枚举：0=未删除；1=已逻辑删除（保留记录，仅标记）。当前样本全部为 0。|-| +|check_status|int|check_status|审核状态。样本全部为 1。推断：1=已审核/通过；其他值可能表示“待审核”“审核拒绝”等，具体需以系统字典为准。|-| +|online_pay_channel|int|online_pay_channel|线上支付渠道枚举。样本中全部为 0。推断：0=线下或默认渠道；其他值（若有）可能代表微信、支付宝等子渠道。目前门店未实际使用该拆分。|-| +|online_pay_type|int|online_pay_type|在线退款类型。样本全部为 0。推断：0=原路退回；其他值（若有）可能表示“退到余额”“退到其他银行卡”等。当前数据仅有默认策略。|-| +|pay_terminal|int|pay_terminal|退款终端类型枚举。样本全部为 1。推断：1=前台收银端；其他值可能为小程序、自助机、后台等。用于区分退款来源终端。|-| +|pay_config_id|int|pay_config_id|支付配置 ID，例如某个具体支付通道（微信商户号、银联通道等）的配置主键。样本全部为 0，说明当前未按此粒度区分或未导出。|外键| +|cashier_point_id|int|cashier_point_id|收银点编号，例如前台1、前台2、自助机等。样本全部为 0，未实际区分收银点。|-| +|operator_id|bigint|operator_id|执行退款操作的操作员 ID。样本全部为 0，说明导出中未包含操作员信息。若填充，对内部风控与员工考核很重要。|外键| +|channel_payer_id|varchar(128)|channel_payer_id|支付渠道侧的付款人标识，如微信 openid、银行卡号掩码等。样本全部为空字符串，未使用。|-| +|channel_pay_no|varchar(128)|channel_pay_no|第三方支付平台交易号（如微信支付单号、支付宝交易号等）。当前样本全部为空。若将来填充，对资金对账非常关键。|-| + +**dwd_refund 主外键关系** +|键|属性|关联|被关联|说明| +|---|---|---|---|---| +|refund_id|主键|-|-|主键字段；Ex 表复用此键。| +|tenant_id|外键|dim_tenant|tenant_id|租户/品牌 ID。| +|site_id|外键|dim_site|site_id|门店 ID。| +|payment_method|外键|dim_payment_method|payment_method_id|原支付方式。| +|relate_type|-|业务字典|-|区分消费/充值等业务类型。| +|relate_id|外键（多态）|dwd_settlement_head / dwd_recharge_order|order_settle_id / recharge_order_id|随 relate_type 变化的业务主单 ID。| +|member_id|外键|dim_member|member_id|关联会员。| +|member_card_id|外键|dim_member_card_account|member_card_id|关联会员卡账户。| +|pay_config_id|外键|dim_pay_config|pay_config_id|支付配置（Ex 表）。| +|cashier_point_id|外键|dim_cashier_point|cashier_point_id|收银点（Ex 表）。| +|operator_id|外键|dim_staff|staff_id|退款操作员（Ex 表）。|