Files

Neo fafc95e64c 在前后端开发联调前的提交20260223

2026-02-23 23:02:20 +08:00

522 KiB

Raw Blame History

飞球连接器 — 数据流结构分析报告

生成时间：2026-02-21 15:45:48 CST 分析范围：飞球（feiqiu）连接器，共 22 张 ODS 表数据来源：API JSON 采样 + PostgreSQL ODS/DWD 表结构 + 三层字段映射 + BD_manual 业务文档 API 请求日期范围：2025-11-23 ~ 2026-02-21 JSON 数据总量：3388 条记录

数据源文件清单

本报告基于以下 JSON 数据文件生成：

collection_manifest.json — 采集元数据（表清单、日期范围、记录数）（✓）

json_trees/ — API JSON 字段结构（递归展开后的字段路径、类型、示例值）（22 个文件）

json_trees/assistant_accounts_master.json
json_trees/assistant_cancellation_records.json
json_trees/assistant_service_records.json
json_trees/goods_stock_movements.json
json_trees/goods_stock_summary.json
json_trees/group_buy_packages.json
json_trees/group_buy_redemption_records.json
json_trees/member_balance_changes.json
json_trees/member_profiles.json
json_trees/member_stored_value_cards.json
json_trees/payment_transactions.json
json_trees/platform_coupon_redemption_records.json
json_trees/recharge_settlements.json
json_trees/refund_transactions.json
json_trees/settlement_records.json
json_trees/site_tables_master.json
json_trees/stock_goods_category_tree.json
json_trees/store_goods_master.json
json_trees/store_goods_sales_records.json
json_trees/table_fee_discount_records.json
json_trees/table_fee_transactions.json
json_trees/tenant_goods_master.json

field_mappings/ — 三层字段映射（API→ODS→DWD 映射关系）（22 个文件）

field_mappings/assistant_accounts_master.json
field_mappings/assistant_cancellation_records.json
field_mappings/assistant_service_records.json
field_mappings/goods_stock_movements.json
field_mappings/goods_stock_summary.json
field_mappings/group_buy_packages.json
field_mappings/group_buy_redemption_records.json
field_mappings/member_balance_changes.json
field_mappings/member_profiles.json
field_mappings/member_stored_value_cards.json
field_mappings/payment_transactions.json
field_mappings/platform_coupon_redemption_records.json
field_mappings/recharge_settlements.json
field_mappings/refund_transactions.json
field_mappings/settlement_records.json
field_mappings/site_tables_master.json
field_mappings/stock_goods_category_tree.json
field_mappings/store_goods_master.json
field_mappings/store_goods_sales_records.json
field_mappings/table_fee_discount_records.json
field_mappings/table_fee_transactions.json
field_mappings/tenant_goods_master.json

db_schemas/ — 数据库表结构（ODS/DWD 列定义，来自 PostgreSQL）（64 个文件）

db_schemas/dwd_dim_assistant.json
db_schemas/dwd_dim_assistant_ex.json
db_schemas/dwd_dim_goods_category.json
db_schemas/dwd_dim_groupbuy_package.json
db_schemas/dwd_dim_groupbuy_package_ex.json
db_schemas/dwd_dim_member.json
db_schemas/dwd_dim_member_card_account.json
db_schemas/dwd_dim_member_card_account_ex.json
db_schemas/dwd_dim_member_ex.json
db_schemas/dwd_dim_site.json
db_schemas/dwd_dim_site_ex.json
db_schemas/dwd_dim_store_goods.json
db_schemas/dwd_dim_store_goods_ex.json
db_schemas/dwd_dim_table.json
db_schemas/dwd_dim_table_ex.json
db_schemas/dwd_dim_tenant_goods.json
db_schemas/dwd_dim_tenant_goods_ex.json
db_schemas/dwd_dwd_assistant_service_log.json
db_schemas/dwd_dwd_assistant_service_log_ex.json
db_schemas/dwd_dwd_assistant_trash_event.json
db_schemas/dwd_dwd_assistant_trash_event_ex.json
db_schemas/dwd_dwd_goods_stock_movement.json
db_schemas/dwd_dwd_goods_stock_summary.json
db_schemas/dwd_dwd_groupbuy_redemption.json
db_schemas/dwd_dwd_groupbuy_redemption_ex.json
db_schemas/dwd_dwd_member_balance_change.json
db_schemas/dwd_dwd_member_balance_change_ex.json
db_schemas/dwd_dwd_payment.json
db_schemas/dwd_dwd_platform_coupon_redemption.json
db_schemas/dwd_dwd_platform_coupon_redemption_ex.json
db_schemas/dwd_dwd_recharge_order.json
db_schemas/dwd_dwd_recharge_order_ex.json
db_schemas/dwd_dwd_refund.json
db_schemas/dwd_dwd_refund_ex.json
db_schemas/dwd_dwd_settlement_head.json
db_schemas/dwd_dwd_settlement_head_ex.json
db_schemas/dwd_dwd_store_goods_sale.json
db_schemas/dwd_dwd_store_goods_sale_ex.json
db_schemas/dwd_dwd_table_fee_adjust.json
db_schemas/dwd_dwd_table_fee_adjust_ex.json
db_schemas/dwd_dwd_table_fee_log.json
db_schemas/dwd_dwd_table_fee_log_ex.json
db_schemas/ods_assistant_accounts_master.json
db_schemas/ods_assistant_cancellation_records.json
db_schemas/ods_assistant_service_records.json
db_schemas/ods_goods_stock_movements.json
db_schemas/ods_goods_stock_summary.json
db_schemas/ods_group_buy_packages.json
db_schemas/ods_group_buy_redemption_records.json
db_schemas/ods_member_balance_changes.json
db_schemas/ods_member_profiles.json
db_schemas/ods_member_stored_value_cards.json
db_schemas/ods_payment_transactions.json
db_schemas/ods_platform_coupon_redemption_records.json
db_schemas/ods_recharge_settlements.json
db_schemas/ods_refund_transactions.json
db_schemas/ods_settlement_records.json
db_schemas/ods_site_tables_master.json
db_schemas/ods_stock_goods_category_tree.json
db_schemas/ods_store_goods_master.json
db_schemas/ods_store_goods_sales_records.json
db_schemas/ods_table_fee_discount_records.json
db_schemas/ods_table_fee_transactions.json
db_schemas/ods_tenant_goods_master.json

bd_descriptions/ — 业务描述（来自 BD_manual 文档）（22 个文件）

bd_descriptions/assistant_accounts_master.json
bd_descriptions/assistant_cancellation_records.json
bd_descriptions/assistant_service_records.json
bd_descriptions/goods_stock_movements.json
bd_descriptions/goods_stock_summary.json
bd_descriptions/group_buy_packages.json
bd_descriptions/group_buy_redemption_records.json
bd_descriptions/member_balance_changes.json
bd_descriptions/member_profiles.json
bd_descriptions/member_stored_value_cards.json
bd_descriptions/payment_transactions.json
bd_descriptions/platform_coupon_redemption_records.json
bd_descriptions/recharge_settlements.json
bd_descriptions/refund_transactions.json
bd_descriptions/settlement_records.json
bd_descriptions/site_tables_master.json
bd_descriptions/stock_goods_category_tree.json
bd_descriptions/store_goods_master.json
bd_descriptions/store_goods_sales_records.json
bd_descriptions/table_fee_discount_records.json
bd_descriptions/table_fee_transactions.json
bd_descriptions/tenant_goods_master.json

1. 总览

#	ODS 表名	业务描述	采样记录数	API JSON 字段数	ODS 列数	DWD 目标表	DWD 总列数
1	`assistant_accounts_master`	助教账号档案	69	62	67	dim_assistant, dim_assistant_ex	71
2	`settlement_records`	结账记录	200	92	71	dwd_settlement_head, dwd_settlement_head_ex	67
3	`table_fee_transactions`	台费计费流水	200	67	47	dim_site, dim_site_ex, dwd_table_fee_log, dwd_table_fee_log_ex	84
4	`assistant_service_records`	助教服务流水	200	91	71	dwd_assistant_service_log, dwd_assistant_service_log_ex	66
5	`assistant_cancellation_records`	助教废除记录	78	38	19	dwd_assistant_trash_event, dwd_assistant_trash_event_ex	15
6	`store_goods_sales_records`	门店商品销售流水	200	51	56	dwd_store_goods_sale, dwd_store_goods_sale_ex	53
7	`payment_transactions`	支付流水	200	36	17	dwd_payment	12
8	`refund_transactions`	退款流水	29	57	37	dwd_refund, dwd_refund_ex	32
9	`platform_coupon_redemption_records`	平台/团购券核销	200	51	31	dwd_platform_coupon_redemption, dwd_platform_coupon_redemption_ex	26
10	`member_profiles`	会员档案	200	20	25	dim_member, dim_member_ex	30
11	`member_stored_value_cards`	会员储值卡	200	71	80	dim_member_card_account, dim_member_card_account_ex	84
12	`member_balance_changes`	会员余额变动	200	28	33	dwd_member_balance_change, dwd_member_balance_change_ex	30
13	`recharge_settlements`	充值结算	191	92	71	dwd_recharge_order, dwd_recharge_order_ex	67
14	`group_buy_packages`	团购套餐定义	18	40	43	dim_groupbuy_package, dim_groupbuy_package_ex	47
15	`group_buy_redemption_records`	团购套餐核销	200	52	57	dwd_groupbuy_redemption, dwd_groupbuy_redemption_ex	53
16	`goods_stock_summary`	库存汇总	173	14	19	dwd_goods_stock_summary	17
17	`goods_stock_movements`	库存变化记录	200	19	24	dwd_goods_stock_movement	20
18	`site_tables_master`	台桌维表	74	26	31	dim_table, dim_table_ex	36
19	`stock_goods_category_tree`	库存商品分类树	9	20	16	dim_goods_category	16
20	`store_goods_master`	门店商品档案	173	53	52	dim_store_goods, dim_store_goods_ex	57
21	`table_fee_discount_records`	台费折扣/调账	200	55	33	dwd_table_fee_adjust, dwd_table_fee_adjust_ex	29
22	`tenant_goods_master`	租户商品档案	174	32	37	dim_tenant_goods, dim_tenant_goods_ex	41
	合计		3388	1067	937		953

1.1 API↔ODS↔DWD 字段对比差异

以下汇总各表在三层之间的字段差异（点击数字跳转至分表详情）：

ODS 表名	API→ODS 未映射	ODS 无 JSON 源	ODS→DWD 未映射	DWD 无 ODS 源	主要差异原因
`assistant_accounts_master`	0	5	5	8	SCD2/派生列 8 个；白名单 10 个
`settlement_records`	25	5	5	0	白名单 35 个
`table_fee_transactions`	24	6	6	8	SCD2/派生列 8 个；白名单 34 个
`assistant_service_records`	24	6	6	0	白名单 34 个
`assistant_cancellation_records`	24	6	6	0	白名单 34 个
`store_goods_sales_records`	0	5	5	0	白名单 10 个
`payment_transactions`	24	6	6	0	白名单 34 个
`refund_transactions`	24	6	6	0	白名单 34 个
`platform_coupon_redemption_records`	24	6	6	0	白名单 34 个
`member_profiles`	0	5	5	9	SCD2/派生列 9 个；白名单 10 个
`member_stored_value_cards`	0	9	5	8	SCD2/派生列 8 个；白名单 10 个
`member_balance_changes`	0	5	5	0	白名单 10 个
`recharge_settlements`	25	5	5	0	白名单 35 个
`group_buy_packages`	2	5	5	8	平层未映射 2 个；SCD2/派生列 8 个；白名单 10 个
`group_buy_redemption_records`	0	5	5	0	白名单 10 个
`goods_stock_summary`	0	5	18	16	SCD2/派生列 16 个；白名单 9 个
`goods_stock_movements`	0	5	20	16	SCD2/派生列 16 个；白名单 9 个
`site_tables_master`	0	6	6	9	SCD2/派生列 9 个；白名单 10 个
`stock_goods_category_tree`	0	6	6	4	SCD2/派生列 4 个；白名单 10 个
`store_goods_master`	5	5	5	8	嵌套对象 4 个；平层未映射 1 个；SCD2/派生列 8 个；白名单 10 个
`table_fee_discount_records`	25	7	7	0	嵌套对象 1 个；白名单 34 个
`tenant_goods_master`	0	5	6	8	SCD2/派生列 8 个；白名单 10 个

1.1.1 assistant_accounts_master 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_assistant	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_assistant	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_assistant	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_assistant	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_assistant_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_assistant_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_assistant_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_assistant_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.2 settlement_records 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (25 个)

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.3 table_fee_transactions 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_site	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_site	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_site	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_site	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_site_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_site_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_site_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_site_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.4 assistant_service_records 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

1.1.5 assistant_cancellation_records 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.6 store_goods_sales_records 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

1.1.7 payment_transactions 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.8 refund_transactions 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.9 platform_coupon_redemption_records 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.10 member_profiles 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 9 个

#	DWD 表	DWD 列	说明	状态
1	dim_member	`update_time`	更新时间	⚠️ 无 ODS 源
2	dim_member	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
3	dim_member	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
4	dim_member	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
5	dim_member	`scd2_version`	版本号	⚠️ 无 ODS 源
6	dim_member_ex	`scd2_start_time`		⚠️ 无 ODS 源
7	dim_member_ex	`scd2_end_time`		⚠️ 无 ODS 源
8	dim_member_ex	`scd2_is_current`		⚠️ 无 ODS 源
9	dim_member_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.11 member_stored_value_cards 字段差异明细

ODS 无 JSON 源 — 4 个

#	ODS 列	说明	状态
1	`goodscategoryid`	（待补充）	⚠️ 无 JSON 源
2	`tableareaid`	（待补充）	⚠️ 无 JSON 源
3	`pdassisnatlevel`	（待补充）	⚠️ 无 JSON 源
4	`cxassisnatlevel`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_member_card_account	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_member_card_account	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_member_card_account	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_member_card_account	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_member_card_account_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_member_card_account_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_member_card_account_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_member_card_account_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.12 member_balance_changes 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.13 recharge_settlements 字段差异明细

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (25 个)

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.14 group_buy_packages 字段差异明细

API→ODS 未映射（平层） — 2 个

#	JSON 字段	示例值	说明	状态
1	`tenantTableAreaIdList[]`	`2791960001957765`, `2791961347968901`, `2791961060364165`, `2791961709907845`, `2791960521691013`		⚠️ 未映射
2	`tableAreaNameList[]`	`A区`, `斯诺克区`, `VIP包厢`, `K包`, `B区`		⚠️ 未映射

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_groupbuy_package	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_groupbuy_package	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_groupbuy_package	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_groupbuy_package	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_groupbuy_package_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_groupbuy_package_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_groupbuy_package_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_groupbuy_package_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.15 group_buy_redemption_records 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

1.1.16 goods_stock_summary 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 14 个

#	ODS 列	说明	状态
1	`sitegoodsid`	（待补充）	⚠️ 无 DWD 目标
2	`goodsname`	（待补充）	⚠️ 无 DWD 目标
3	`goodsunit`	（待补充）	⚠️ 无 DWD 目标
4	`goodscategoryid`	（待补充）	⚠️ 无 DWD 目标
5	`goodscategorysecondid`	（待补充）	⚠️ 无 DWD 目标
6	`categoryname`	（待补充）	⚠️ 无 DWD 目标
7	`rangestartstock`	（待补充）	⚠️ 无 DWD 目标
8	`rangeendstock`	（待补充）	⚠️ 无 DWD 目标
9	`rangein`	（待补充）	⚠️ 无 DWD 目标
10	`rangeout`	（待补充）	⚠️ 无 DWD 目标
11	`rangesale`	（待补充）	⚠️ 无 DWD 目标
12	`rangesalemoney`	（待补充）	⚠️ 无 DWD 目标
13	`rangeinventory`	（待补充）	⚠️ 无 DWD 目标
14	`currentstock`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, payload (4 个)

DWD 无 ODS 源 — 16 个

#	DWD 表	DWD 列	状态
1	dwd_goods_stock_summary	`site_goods_id`	⚠️ 无 ODS 源
2	dwd_goods_stock_summary	`goods_name`	⚠️ 无 ODS 源
3	dwd_goods_stock_summary	`goods_unit`	⚠️ 无 ODS 源
4	dwd_goods_stock_summary	`goods_category_id`	⚠️ 无 ODS 源
5	dwd_goods_stock_summary	`goods_category_second_id`	⚠️ 无 ODS 源
6	dwd_goods_stock_summary	`category_name`	⚠️ 无 ODS 源
7	dwd_goods_stock_summary	`range_start_stock`	⚠️ 无 ODS 源
8	dwd_goods_stock_summary	`range_end_stock`	⚠️ 无 ODS 源
9	dwd_goods_stock_summary	`range_in`	⚠️ 无 ODS 源
10	dwd_goods_stock_summary	`range_out`	⚠️ 无 ODS 源
11	dwd_goods_stock_summary	`range_sale`	⚠️ 无 ODS 源
12	dwd_goods_stock_summary	`range_sale_money`	⚠️ 无 ODS 源
13	dwd_goods_stock_summary	`range_inventory`	⚠️ 无 ODS 源
14	dwd_goods_stock_summary	`current_stock`	⚠️ 无 ODS 源
15	dwd_goods_stock_summary	`site_id`	⚠️ 无 ODS 源
16	dwd_goods_stock_summary	`tenant_id`	⚠️ 无 ODS 源

1.1.17 goods_stock_movements 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 16 个

#	ODS 列	说明	状态
1	`sitegoodsstockid`	（待补充）	⚠️ 无 DWD 目标
2	`tenantid`	（待补充）	⚠️ 无 DWD 目标
3	`siteid`	（待补充）	⚠️ 无 DWD 目标
4	`sitegoodsid`	（待补充）	⚠️ 无 DWD 目标
5	`goodsname`	（待补充）	⚠️ 无 DWD 目标
6	`goodscategoryid`	（待补充）	⚠️ 无 DWD 目标
7	`goodssecondcategoryid`	（待补充）	⚠️ 无 DWD 目标
8	`stocktype`	（待补充）	⚠️ 无 DWD 目标
9	`changenum`	（待补充）	⚠️ 无 DWD 目标
10	`startnum`	（待补充）	⚠️ 无 DWD 目标
11	`endnum`	（待补充）	⚠️ 无 DWD 目标
12	`changenuma`	（待补充）	⚠️ 无 DWD 目标
13	`startnuma`	（待补充）	⚠️ 无 DWD 目标
14	`endnuma`	（待补充）	⚠️ 无 DWD 目标
15	`operatorname`	（待补充）	⚠️ 无 DWD 目标
16	`createtime`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, payload (4 个)

DWD 无 ODS 源 — 16 个

#	DWD 表	DWD 列	状态
1	dwd_goods_stock_movement	`site_goods_stock_id`	⚠️ 无 ODS 源
2	dwd_goods_stock_movement	`tenant_id`	⚠️ 无 ODS 源
3	dwd_goods_stock_movement	`site_id`	⚠️ 无 ODS 源
4	dwd_goods_stock_movement	`site_goods_id`	⚠️ 无 ODS 源
5	dwd_goods_stock_movement	`goods_name`	⚠️ 无 ODS 源
6	dwd_goods_stock_movement	`goods_category_id`	⚠️ 无 ODS 源
7	dwd_goods_stock_movement	`goods_second_category_id`	⚠️ 无 ODS 源
8	dwd_goods_stock_movement	`stock_type`	⚠️ 无 ODS 源
9	dwd_goods_stock_movement	`change_num`	⚠️ 无 ODS 源
10	dwd_goods_stock_movement	`start_num`	⚠️ 无 ODS 源
11	dwd_goods_stock_movement	`end_num`	⚠️ 无 ODS 源
12	dwd_goods_stock_movement	`change_num_a`	⚠️ 无 ODS 源
13	dwd_goods_stock_movement	`start_num_a`	⚠️ 无 ODS 源
14	dwd_goods_stock_movement	`end_num_a`	⚠️ 无 ODS 源
15	dwd_goods_stock_movement	`operator_name`	⚠️ 无 ODS 源
16	dwd_goods_stock_movement	`create_time`	⚠️ 无 ODS 源

1.1.18 site_tables_master 字段差异明细

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`appletQrCodeUrl`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`appletQrCodeUrl`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 9 个

#	DWD 表	DWD 列	说明	状态
1	dim_table	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_table	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_table	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_table	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_table_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_table_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_table_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_table_ex	`scd2_version`		⚠️ 无 ODS 源
9	dim_table_ex	`applet_qr_code_url`		⚠️ 无 ODS 源

1.1.19 stock_goods_category_tree 字段差异明细

ODS 无 JSON 源 — 1 个

#	ODS 列	说明	状态
1	`categoryboxes`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`categoryboxes`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 无 ODS 源 — 4 个

#	DWD 表	DWD 列	说明	状态
1	dim_goods_category	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_goods_category	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_goods_category	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_goods_category	`scd2_version`	版本号	⚠️ 无 ODS 源

1.1.20 store_goods_master 字段差异明细

API→ODS 未映射（平层） — 1 个

#	JSON 字段	示例值	说明	状态
1	`time_slot_sale`	`2`		⚠️ 未映射

API→ODS 未映射（嵌套对象）— 4 个

#	JSON 字段	示例值	状态
1	`goodsStockWarningInfo.site_goods_id`	`0`	📦 嵌套
2	`goodsStockWarningInfo.sales_day`	`0.0`	📦 嵌套
3	`goodsStockWarningInfo.warning_day_max`	`0`	📦 嵌套
4	`goodsStockWarningInfo.warning_day_min`	`0`	📦 嵌套

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_store_goods	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_store_goods	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_store_goods	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_store_goods	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_store_goods_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_store_goods_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_store_goods_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_store_goods_ex	`scd2_version`		⚠️ 无 ODS 源

1.1.21 table_fee_discount_records 字段差异明细

API→ODS 未映射（嵌套对象）— 1 个

#	JSON 字段	示例值	说明	状态
1	`tableProfile.ewelink_client_id`			📦 嵌套

ℹ️ API→ODS 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel, siteProfile.full_address... (24 个)

ODS 无 JSON 源 — 2 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 JSON 源
2	`tableprofile`	（待补充）	⚠️ 无 JSON 源

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

ODS→DWD 未映射 — 2 个

#	ODS 列	说明	状态
1	`siteprofile`	（待补充）	⚠️ 无 DWD 目标
2	`tableprofile`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

1.1.22 tenant_goods_master 字段差异明细

ℹ️ ODS 无 JSON 源白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

ODS→DWD 未映射 — 1 个

#	ODS 列	说明	状态
1	`commoditycode`	（待补充）	⚠️ 无 DWD 目标

ℹ️ ODS→DWD 白名单字段（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 无 ODS 源 — 8 个

#	DWD 表	DWD 列	说明	状态
1	dim_tenant_goods	`scd2_start_time`	SCD2 版本生效时间	⚠️ 无 ODS 源
2	dim_tenant_goods	`scd2_end_time`	SCD2 版本失效时间	⚠️ 无 ODS 源
3	dim_tenant_goods	`scd2_is_current`	当前版本标记	⚠️ 无 ODS 源
4	dim_tenant_goods	`scd2_version`	版本号	⚠️ 无 ODS 源
5	dim_tenant_goods_ex	`scd2_start_time`		⚠️ 无 ODS 源
6	dim_tenant_goods_ex	`scd2_end_time`		⚠️ 无 ODS 源
7	dim_tenant_goods_ex	`scd2_is_current`		⚠️ 无 ODS 源
8	dim_tenant_goods_ex	`scd2_version`		⚠️ 无 ODS 源

2. 全局统计

2.1 JSON→ODS 映射覆盖

JSON 字段总数：1067
已映射到 ODS 列：841（78.8%）
仅存于 payload：226（21.2%）

2.2 ODS→DWD 映射覆盖

DWD 列总数：953

2.3 各表 JSON→ODS 映射覆盖率

ODS 表名	业务描述	JSON 字段数	已映射	仅 payload	覆盖率
`assistant_accounts_master`	助教账号档案	62	62	0	100.0%
`store_goods_sales_records`	门店商品销售流水	51	51	0	100.0%
`member_profiles`	会员档案	20	20	0	100.0%
`member_stored_value_cards`	会员储值卡	71	71	0	100.0%
`member_balance_changes`	会员余额变动	28	28	0	100.0%
`group_buy_redemption_records`	团购套餐核销	52	52	0	100.0%
`goods_stock_summary`	库存汇总	14	14	0	100.0%
`goods_stock_movements`	库存变化记录	19	19	0	100.0%
`site_tables_master`	台桌维表	26	26	0	100.0%
`stock_goods_category_tree`	库存商品分类树	20	20	0	100.0%
`tenant_goods_master`	租户商品档案	32	32	0	100.0%
`group_buy_packages`	团购套餐定义	40	38	2	95.0%
`store_goods_master`	门店商品档案	53	48	5	90.6%
`assistant_service_records`	助教服务流水	91	67	24	73.6%
`settlement_records`	结账记录	92	67	25	72.8%
`recharge_settlements`	充值结算	92	67	25	72.8%
`table_fee_transactions`	台费计费流水	67	43	24	64.2%
`refund_transactions`	退款流水	57	33	24	57.9%
`table_fee_discount_records`	台费折扣/调账	55	30	25	54.5%
`platform_coupon_redemption_records`	平台/团购券核销	51	27	24	52.9%
`assistant_cancellation_records`	助教废除记录	38	14	24	36.8%
`payment_transactions`	支付流水	36	12	24	33.3%

3. 逐表详情

3.1 assistant_accounts_master（助教账号档案）

任务代码：ODS_ASSISTANT_ACCOUNT
采样记录数：69
API JSON 字段数：62
ODS 列数：67
DWD 目标表：dim_assistant, dim_assistant_ex

API 源字段 — assistant_accounts_master 🔗 ODS

已映射 62/62，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`job_num`	string	`job_num`	备用工号字段，目前未在该门店启用
2	`shop_name`	string	`shop_name`	门店名称，冗余字段，用于展示	示例: `朗朗桌球`
3	`group_id`	integer	`group_id`	上层“分组 ID”预留字段（例如集团/事业部），本门店未使用	示例: `0`
4	`group_name`	string	`group_name`	group_id 对应的名称，目前为空
5	`staff_profile_id`	integer	`staff_profile_id`	人事档案 ID，与第三方 HR 系统或内部员工档案集成使用，当前未启用	示例: `0`
6	`ding_talk_synced`	integer	`ding_talk_synced`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
7	`entry_type`	integer	`entry_type`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `3`
8	`team_name`	string	`team_name`	团队名称，展示用，和 team_id 一一对应	枚举值: `2组`, `1组`
9	`entry_sign_status`	integer	`entry_sign_status`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `0`
10	`resign_sign_status`	integer	`resign_sign_status`	离职协议签署状态，类似上面	示例: `0`
11	`system_role_id`	integer	`system_role_id`	标识类 ID 字段，用于关联/定位相关实体	示例: `10`
12	`criticism_status`	integer	`criticism_status`	1 × 49	枚举值: `1`, `2`
13	`salary_grant_enabled`	integer	`salary_grant_enabled`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `2`
14	`leave_status`	integer	`leave_status`	0 × 21	枚举值: `0`, `1`
15	`id`	integer	`id`	助教账号主键 ID，在“助教流水.json”中对应 site_assistant_id	枚举值: `3067857612671685`, `3058170108874053`, `3056644876634181`, `3053833422211141`, `3053834039789701`, `3045477940824517`, `3027024317123653`, `3022685829761989`
16	`allow_cx`	integer	`allow_cx`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
17	`assistant_no`	string	`assistant_no`	助教工号 / 编号，便于业务侧识别	枚举值: `13`, `38`, `8`, `41`, `40`, `27`, `28`, `33`
18	`assistant_status`	integer	`assistant_status`	1 × 48	示例: `1`
19	`avatar`	string	`avatar`	助教头像地址	枚举值: `https://oss.ficoo.vip/cbb/userAvatar/1769426176673/176942617`, `https://oss.ficoo.vip/cbb/userAvatar/1768822727212/176882272`, `https://oss.ficoo.vip/cbb/userAvatar/1768831143754/176883114`, `https://oss.ficoo.vip/cbb/userAvatar/1768556565021/176855656`, `https://oss.ficoo.vip/cbb/userAvatar/1768556665960/176855666`, `https://oss.ficoo.vip/cbb/userAvatar/1768048632753/176804863`, `https://oss.ficoo.vip/maUiImages/images/defaultAvatar.png`, `https://oss.ficoo.vip/cbb/userAvatar/1764929477604/176492947`
20	`birth_date`	string	`birth_date`	助教出生日期	枚举值: `0001-01-01 00:00:00`, `2025-11-01 00:00:00`, `2007-01-14 00:00:00`, `2003-11-01 00:00:00`, `2001-04-08 00:00:00`, `2004-08-16 00:00:00`
21	`charge_way`	integer	`charge_way`	2 代表当前门店为“计时收费”，其他值（1、3 等）可能对应按局、按课时等，当前未出现	示例: `2`
22	`create_time`	string	`create_time`	账号创建时间	枚举值: `2026-01-26 15:26:11`, `2026-01-19 19:11:32`, `2026-01-18 17:20:00`, `2026-01-16 17:40:02`, `2026-01-16 17:40:40`, `2026-01-10 20:00:24`, `2025-12-28 19:08:24`, `2025-12-25 17:35:04`
23	`cx_unit_price`	number	`cx_unit_price`	促销时段的单价，本门店未在账号表层面设置	示例: `0.0`
24	`end_time`	string	`end_time`	当前配置生效的结束日期（例如一个周期性的排班/合同周期）	出现率 96%；枚举值: `2026-02-01 08:00:00`, `2026-01-01 08:00:00`, `2025-12-01 08:00:00`, `2025-11-01 08:00:00`, `2025-10-01 08:00:00`, `2025-09-01 08:00:00`, `2025-08-01 08:00:00`
25	`entry_time`	string	`entry_time`	入职时间	枚举值: `2026-01-26 08:00:00`, `2026-01-19 08:00:00`, `2026-01-18 08:00:00`, `2026-01-16 08:00:00`, `2026-01-10 08:00:00`, `2025-12-28 08:00:00`, `2025-12-25 08:00:00`, `2025-12-24 08:00:00`
26	`gender`	integer	`gender`	0 × 40	枚举值: `0`, `2`
27	`height`	number	`height`	身高（单位：厘米）	枚举值: `0.0`, `158.0`, `162.0`, `163.0`, `166.0`, `167.0`, `165.0`, `170.0`
28	`introduce`	string	`introduce`	个人简介文案，预留给助教自我介绍使用
29	`is_delete`	integer	`is_delete`	逻辑删除标记（0=否，1=是）	示例: `0`
30	`is_guaranteed`	integer	`is_guaranteed`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `1`
31	`is_team_leader`	integer	`is_team_leader`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `0`
32	`last_table_id`	integer	`last_table_id`	该助教最近一次服务的球台 ID	示例: `0`
33	`last_table_name`	string	`last_table_name`	最近服务球台名称（展示用）
34	`last_update_name`	string	`last_update_name`	最近修改该账号配置的管理员名称	出现率 62%；枚举值: `教练:夏滋岸`, `管理员：郑丽珊`, `助教管理员:amy`, `教练:周蒙`, `助教管理员:黄月柳`
35	`level`	integer	`level`	10 × 24	枚举值: `10`, `20`, `40`, `30`, `8`
36	`light_equipment_id`	string	`light_equipment_id`	灯控设备 ID，如果开启“助教开台自动控制灯”，会通过该字段关联到灯控硬件
37	`light_status`	integer	`light_status`	灯光控制状态，如 1=启用控制、2=不启用或相反	示例: `2`
38	`mobile`	string	`mobile`	助教手机号，用于登录绑定、通知、钉钉同步等	枚举值: `17606621482`, `13537431206`, `13527970519`, `17819747429`, `19521138382`, `18613137001`, `15918443696`, `19866705026`
39	`nickname`	string	`nickname`	助教在前台展示的昵称，如“佳怡”“周周”“球球”等	枚举值: `渔渔`, `菲菲`, `吱吱`, `yy`, `凤梨`, `小琳`, `布丁`, `嘉嘉`
40	`online_status`	integer	`online_status`	在线状态	示例: `1`
41	`order_trade_no`	integer	`order_trade_no`	该助教最近一次关联的订单号，用于快速跳转或回溯最近服务行为	示例: `0`
42	`pd_unit_price`	number	`pd_unit_price`	某种标准单价（例如“普通时段单价”），这里未在账号上配置（实际单价在助教商品或套餐配置中）	示例: `0.0`
43	`person_org_id`	integer	`person_org_id`	人事组织 ID，通常表示“某某门店-助教部-某小组”等层级组织	枚举值: `3067857612573381`, `3058170108775749`, `3056644876519493`, `3053833421785157`, `3053834039609477`, `3045477940726213`, `3027024317008965`, `3022685829663685`
44	`real_name`	string	`real_name`	助教真实姓名，如“何海婷”“梁婷婷”等	枚举值: `李思怡`, `袁菲菲`, `曹金梅`, `陈研`, `黄凤丽`, `习燕琳`, `杨婧`, `王嘉琪`
45	`resign_time`	string	`resign_time`	离职日期	枚举值: `2226-01-26 15:26:11`, `2026-01-23 08:00:00`, `2226-01-18 17:20:00`, `2226-01-16 17:40:02`, `2226-01-16 17:40:40`, `2226-01-10 20:00:24`, `2026-01-01 08:00:00`, `2025-12-27 08:00:00`
46	`serial_number`	integer	`serial_number`	系统内部生成的序列号或排序标识，用于全局排序或迁移	枚举值: `5130`, `4955`, `5018`, `5134`, `5153`, `4726`, `4327`, `4325`
47	`show_sort`	integer	`show_sort`	前台展示排序权重，值越小/越大对应不同的排序策略（当前看起来与 assistant_no 有一定对应关系）	枚举值: `13`, `38`, `8`, `41`, `40`, `27`, `28`, `33`
48	`show_status`	integer	`show_status`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
49	`site_id`	integer	`site_id`	门店 ID，对应本次数据的这家球房（朗朗桌球）	示例: `2790685415443269`
50	`site_light_cfg_id`	integer	`site_light_cfg_id`	门店灯控配置 ID，本门店未在助教账号维度启用	示例: `0`
51	`staff_id`	integer	`staff_id`	预留给“人事系统员工 ID”的字段，目前未接入或未启用	示例: `0`
52	`start_time`	string	`start_time`	当前配置生效的开始日期	出现率 96%；枚举值: `2026-01-01 08:00:00`, `2025-12-01 08:00:00`, `2025-11-01 08:00:00`, `2025-10-01 08:00:00`, `2025-09-01 08:00:00`, `2025-08-01 08:00:00`, `2025-07-01 08:00:00`
53	`team_id`	integer	`team_id`	助教所属团队 ID	枚举值: `2959085810992645`, `2792011585884037`
54	`tenant_id`	integer	`tenant_id`	品牌/租户 ID，对应“非球科技”系统中该商户的唯一标识	示例: `2790683160709957`
55	`update_time`	string	`update_time`	账号最近一次被修改的时间（例如修改等级、昵称等）	枚举值: `2026-01-28 21:32:15`, `2026-01-23 17:39:41`, `2026-01-26 19:47:04`, `2026-01-30 00:54:45`, `2026-01-30 00:54:41`, `2026-01-01 15:33:02`, `2026-01-01 15:33:31`, `2026-01-01 15:33:18`
56	`user_id`	integer	`user_id`	系统级“用户账号 ID”，通常对应登录账号	枚举值: `3067857612163781`, `3058170108300613`, `3056644876077125`, `3053833420064837`, `3053834038954117`, `3045477940300229`, `3027024316582981`, `3022685829237701`
57	`video_introduction_url`	string	`video_introduction_url`	助教个人视频介绍地址	枚举值: `https://oss.ficoo.vip/cbb/userVideo/1764149549870/1764149549`, `https://oss.ficoo.vip/cbb/userVideo/1753096246308/1753096246`
58	`weight`	number	`weight`	体重（单位：公斤）	枚举值: `0.0`, `106.0`, `102.0`, `100.0`, `90.0`, `55.0`
59	`work_status`	integer	`work_status`	当 leave_status = 0 时，work_status = 1	枚举值: `1`, `2`
60	`assistant_grade`	number	`assistant_grade`	助教综合评分（员工维度的平均分 snapshot），当前尚未启用评分	示例: `0.0`
61	`sum_grade`	number	`sum_grade`	评分总和，用于计算平均分（assistant_grade = sum_grade / get_grade_time...	示例: `0.0`
62	`get_grade_times`	integer	`get_grade_times`	累计被评分次数	示例: `0`

ODS 表结构 — ods.assistant_accounts_master 🔗 API

共 67 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_assistant.assistant_id`, `dim_assistant_ex.assistant_id`	助教账号主键 ID，在“助教流水.json”中对应 site_assistant_id
2	`tenant_id`	bigint	`tenant_id`	`dim_assistant.tenant_id`	品牌/租户 ID，对应“非球科技”系统中该商户的唯一标识
3	`site_id`	bigint	`site_id`	`dim_assistant.site_id`	门店 ID，对应本次数据的这家球房（朗朗桌球）
4	`assistant_no`	text	`assistant_no`	`dim_assistant.assistant_no`	助教工号 / 编号，便于业务侧识别
5	`nickname`	text	`nickname`	`dim_assistant.nickname`	助教在前台展示的昵称，如“佳怡”“周周”“球球”等
6	`real_name`	text	`real_name`	`dim_assistant.real_name`	助教真实姓名，如“何海婷”“梁婷婷”等
7	`mobile`	text	`mobile`	`dim_assistant.mobile`	助教手机号，用于登录绑定、通知、钉钉同步等
8	`team_id`	bigint	`team_id`	`dim_assistant.team_id`	助教所属团队 ID
9	`team_name`	text	`team_name`	`dim_assistant.team_name`	团队名称，展示用，和 team_id 一一对应
10	`user_id`	bigint	`user_id`	`dim_assistant.user_id`	系统级“用户账号 ID”，通常对应登录账号
11	`level`	text	`level`	`dim_assistant.level`	10 × 24
12	`assistant_status`	integer	`assistant_status`	`dim_assistant.assistant_status`	1 × 48
13	`work_status`	integer	`work_status`	`dim_assistant_ex.work_status`	当 leave_status = 0 时，work_status = 1
14	`leave_status`	integer	`leave_status`	`dim_assistant.leave_status`	0 × 21
15	`entry_time`	timestamp without time zone	`entry_time`	`dim_assistant.entry_time`	入职时间
16	`resign_time`	timestamp without time zone	`resign_time`	`dim_assistant.resign_time`	离职日期
17	`start_time`	timestamp without time zone	`start_time`	`dim_assistant_ex.start_time`	当前配置生效的开始日期
18	`end_time`	timestamp without time zone	`end_time`	`dim_assistant_ex.end_time`	当前配置生效的结束日期（例如一个周期性的排班/合同周期）
19	`create_time`	timestamp without time zone	`create_time`	`dim_assistant_ex.create_time`	账号创建时间
20	`update_time`	timestamp without time zone	`update_time`	`dim_assistant_ex.update_time`	账号最近一次被修改的时间（例如修改等级、昵称等）
21	`order_trade_no`	text	`order_trade_no`	`dim_assistant_ex.order_trade_no`	该助教最近一次关联的订单号，用于快速跳转或回溯最近服务行为
22	`staff_id`	bigint	`staff_id`	`dim_assistant_ex.staff_id`	预留给“人事系统员工 ID”的字段，目前未接入或未启用
23	`staff_profile_id`	bigint	`staff_profile_id`	`dim_assistant_ex.staff_profile_id`	人事档案 ID，与第三方 HR 系统或内部员工档案集成使用，当前未启用
24	`system_role_id`	bigint	`system_role_id`	`dim_assistant_ex.system_role_id`	标识类 ID 字段，用于关联/定位相关实体
25	`avatar`	text	`avatar`	`dim_assistant_ex.avatar`	助教头像地址
26	`birth_date`	timestamp without time zone	`birth_date`	`dim_assistant_ex.birth_date`	助教出生日期
27	`gender`	integer	`gender`	`dim_assistant_ex.gender`	0 × 40
28	`height`	numeric	`height`	`dim_assistant_ex.height`	身高（单位：厘米）
29	`weight`	numeric	`weight`	`dim_assistant_ex.weight`	体重（单位：公斤）
30	`job_num`	text	`job_num`	`dim_assistant_ex.job_num`	备用工号字段，目前未在该门店启用
31	`show_status`	integer	`show_status`	`dim_assistant_ex.show_status`	来自 JSON 导出的原始字段，用于保留业务取值
32	`show_sort`	integer	`show_sort`	`dim_assistant_ex.show_sort`	前台展示排序权重，值越小/越大对应不同的排序策略（当前看起来与 assistant_no 有一定对应关系）
33	`sum_grade`	numeric	`sum_grade`	`dim_assistant_ex.sum_grade`	评分总和，用于计算平均分（assistant_grade = sum_grade / get_grade_time...
34	`assistant_grade`	numeric	`assistant_grade`	`dim_assistant_ex.assistant_grade`	助教综合评分（员工维度的平均分 snapshot），当前尚未启用评分
35	`get_grade_times`	integer	`get_grade_times`	`dim_assistant_ex.get_grade_times`	累计被评分次数
36	`introduce`	text	`introduce`	`dim_assistant_ex.introduce`	个人简介文案，预留给助教自我介绍使用
37	`video_introduction_url`	text	`video_introduction_url`	`dim_assistant_ex.video_introduction_url`	助教个人视频介绍地址
38	`group_id`	bigint	`group_id`	`dim_assistant_ex.group_id`	上层“分组 ID”预留字段（例如集团/事业部），本门店未使用
39	`group_name`	text	`group_name`	`dim_assistant_ex.group_name`	group_id 对应的名称，目前为空
40	`shop_name`	text	`shop_name`	`dim_assistant_ex.shop_name`	门店名称，冗余字段，用于展示
41	`charge_way`	integer	`charge_way`	`dim_assistant_ex.charge_way`	2 代表当前门店为“计时收费”，其他值（1、3 等）可能对应按局、按课时等，当前未出现
42	`entry_type`	integer	`entry_type`	`dim_assistant_ex.entry_type`	来自 JSON 导出的原始字段，用于保留业务取值
43	`allow_cx`	integer	`allow_cx`	`dim_assistant_ex.allow_cx`	来自 JSON 导出的原始字段，用于保留业务取值
44	`is_guaranteed`	integer	`is_guaranteed`	`dim_assistant_ex.is_guaranteed`	布尔/开关字段，用于表示权限、可用性或状态开关
45	`salary_grant_enabled`	integer	`salary_grant_enabled`	`dim_assistant_ex.salary_grant_enabled`	来自 JSON 导出的原始字段，用于保留业务取值
46	`light_status`	integer	`light_status`	`dim_assistant_ex.light_status`	灯光控制状态，如 1=启用控制、2=不启用或相反
47	`online_status`	integer	`online_status`	`dim_assistant_ex.online_status`	在线状态
48	`is_delete`	integer	`is_delete`	`dim_assistant_ex.is_delete`	逻辑删除标记（0=否，1=是）
49	`cx_unit_price`	numeric	`cx_unit_price`	`dim_assistant_ex.cx_unit_price`	促销时段的单价，本门店未在账号表层面设置
50	`pd_unit_price`	numeric	`pd_unit_price`	`dim_assistant_ex.pd_unit_price`	某种标准单价（例如“普通时段单价”），这里未在账号上配置（实际单价在助教商品或套餐配置中）
51	`last_table_id`	bigint	`last_table_id`	`dim_assistant_ex.last_table_id`	该助教最近一次服务的球台 ID
52	`last_table_name`	text	`last_table_name`	`dim_assistant_ex.last_table_name`	最近服务球台名称（展示用）
53	`person_org_id`	bigint	`person_org_id`	`dim_assistant_ex.person_org_id`	人事组织 ID，通常表示“某某门店-助教部-某小组”等层级组织
54	`serial_number`	bigint	`serial_number`	`dim_assistant_ex.serial_number`	系统内部生成的序列号或排序标识，用于全局排序或迁移
55	`is_team_leader`	integer	`is_team_leader`	`dim_assistant_ex.is_team_leader`	布尔/开关字段，用于表示权限、可用性或状态开关
56	`criticism_status`	integer	`criticism_status`	`dim_assistant_ex.criticism_status`	1 × 49
57	`last_update_name`	text	`last_update_name`	`dim_assistant_ex.last_update_name`	最近修改该账号配置的管理员名称
58	`ding_talk_synced`	integer	`ding_talk_synced`	`dim_assistant_ex.ding_talk_synced`	来自 JSON 导出的原始字段，用于保留业务取值
59	`site_light_cfg_id`	bigint	`site_light_cfg_id`	`dim_assistant_ex.site_light_cfg_id`	门店灯控配置 ID，本门店未在助教账号维度启用
60	`light_equipment_id`	text	`light_equipment_id`	`dim_assistant_ex.light_equipment_id`	灯控设备 ID，如果开启“助教开台自动控制灯”，会通过该字段关联到灯控硬件
61	`entry_sign_status`	integer	`entry_sign_status`	`dim_assistant_ex.entry_sign_status`	来自 JSON 导出的原始字段，用于保留业务取值
62	`resign_sign_status`	integer	`resign_sign_status`	`dim_assistant_ex.resign_sign_status`	离职协议签署状态，类似上面

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_assistant 🔗 ODS

共 19 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_id`	bigint	`id`	直接	助教唯一标识 ID
2	`user_id`	bigint	`user_id`	直接	关联用户 ID（当前数据全为 0，[作用待确认]）
3	`assistant_no`	text	`assistant_no`	直接	助教工号，如 "11"、"27"
4	`real_name`	text	`real_name`	直接	真实姓名，如 "梁婷婷"、"周佳怡"
5	`nickname`	text	`nickname`	直接	昵称/花名，如 "柚子"、"周周"、"Amy"
6	`mobile`	text	`mobile`	直接	手机号码
7	`tenant_id`	bigint	`tenant_id`	直接	租户 ID（当前值: 2790683160709957）
8	`site_id`	bigint	`site_id`	直接	门店 ID → dim_site（当前值: 2790685415443269）
9	`team_id`	bigint	`team_id`	直接	团队 ID
10	`team_name`	text	`team_name`	直接	团队名称。枚举值: "1组"(对应 team_id = 2792011585884037), "2组"(对...
11	`level`	integer	`level`	直接	助教等级。枚举值: 8 = 助教管理, 10 = 初级, 20 = 中级, 30 = 高级, 40 =专家
12	`entry_time`	timestamp with time zone	`entry_time`	直接	入职时间
13	`resign_time`	timestamp with time zone	`resign_time`	直接	离职时间（远未来日期如 2225-xx-xx 表示在职）
14	`leave_status`	integer	`leave_status`	直接	在职状态。枚举值: 0 = 在职, 1 = 已离职
15	`assistant_status`	integer	`assistant_status`	直接	观察者状态。枚举值: 1 = 为非观察者, 2 = 为观察者。
16	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
17	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
18	`scd2_is_current`	integer	—	SCD2	当前版本标记
19	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_assistant_ex 🔗 ODS

共 52 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_id`	bigint	`id`	直接	字段重命名
2	`gender`	integer	`gender`	直接	同名直传
3	`birth_date`	timestamp with time zone	`birth_date`	直接	同名直传
4	`avatar`	text	`avatar`	直接	同名直传
5	`introduce`	text	`introduce`	直接	维度字段，用于补充维度属性
6	`video_introduction_url`	text	`video_introduction_url`	直接	同名直传
7	`height`	numeric	`height`	直接	同名直传
8	`weight`	numeric	`weight`	直接	同名直传
9	`shop_name`	text	`shop_name`	直接	同名直传
10	`group_id`	bigint	`group_id`	直接	同名直传
11	`group_name`	text	`group_name`	直接	名称字段，用于展示与辅助识别
12	`person_org_id`	bigint	`person_org_id`	直接	同名直传
13	`staff_id`	bigint	`staff_id`	直接	同名直传
14	`staff_profile_id`	bigint	`staff_profile_id`	直接	同名直传
15	`assistant_grade`	double precision	`assistant_grade`	直接	同名直传
16	`sum_grade`	double precision	`sum_grade`	直接	同名直传
17	`get_grade_times`	integer	`get_grade_times`	直接	同名直传
18	`charge_way`	integer	`charge_way`	直接	同名直传
19	`allow_cx`	integer	`allow_cx`	直接	同名直传
20	`is_guaranteed`	integer	`is_guaranteed`	直接	同名直传
21	`salary_grant_enabled`	integer	`salary_grant_enabled`	直接	同名直传
22	`entry_type`	integer	`entry_type`	直接	同名直传
23	`entry_sign_status`	integer	`entry_sign_status`	直接	同名直传
24	`resign_sign_status`	integer	`resign_sign_status`	直接	同名直传
25	`work_status`	integer	`work_status`	直接	同名直传
26	`show_status`	integer	`show_status`	直接	同名直传
27	`show_sort`	integer	`show_sort`	直接	同名直传
28	`online_status`	integer	`online_status`	直接	同名直传
29	`is_delete`	integer	`is_delete`	直接	同名直传
30	`criticism_status`	integer	`criticism_status`	直接	同名直传
31	`create_time`	timestamp with time zone	`create_time`	直接	同名直传
32	`update_time`	timestamp with time zone	`update_time`	直接	同名直传
33	`start_time`	timestamp with time zone	`start_time`	直接	同名直传
34	`end_time`	timestamp with time zone	`end_time`	直接	同名直传
35	`last_table_id`	bigint	`last_table_id`	直接	同名直传
36	`last_table_name`	text	`last_table_name`	直接	同名直传
37	`last_update_name`	text	`last_update_name`	直接	同名直传
38	`order_trade_no`	bigint	`order_trade_no`	直接	同名直传
39	`ding_talk_synced`	integer	`ding_talk_synced`	直接	同名直传
40	`site_light_cfg_id`	bigint	`site_light_cfg_id`	直接	同名直传
41	`light_equipment_id`	text	`light_equipment_id`	直接	标识类 ID 字段，用于关联/定位相关实体
42	`light_status`	integer	`light_status`	直接	同名直传
43	`is_team_leader`	integer	`is_team_leader`	直接	同名直传
44	`serial_number`	bigint	`serial_number`	直接	同名直传
45	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
46	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
47	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
48	`scd2_version`	integer	—	SCD2	SCD2 元数据
49	`system_role_id`	bigint	`system_role_id`	直接	系统角色 ID，标识助教在系统中的角色类型
50	`job_num`	text	`job_num`	直接	工号，助教的内部编号标识
51	`cx_unit_price`	numeric	`cx_unit_price`	直接	促销单价（元），助教提供促销服务时的计费单价
52	`pd_unit_price`	numeric	`pd_unit_price`	直接	陪打单价（元），助教提供陪打服务时的计费单价

3.2 settlement_records（结账记录）

任务代码：ODS_SETTLEMENT_RECORDS
采样记录数：200
API JSON 字段数：92
ODS 列数：71
DWD 目标表：dwd_settlement_head, dwd_settlement_head_ex

API 源字段 — settlement_records 🔗 ODS

已映射 67/92，覆盖率 72.8% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`settleList.id`	integer	`id`	结账记录主键 ID（订单结算 ID）	枚举值: `3093864077166789`, `3093859276196037`, `3093855537596549`, `3093843703564549`, `3093804233967877`, `3093800338802821`, `3093793847478597`, `3093774959741061`
2	`settleList.tenantId`	integer	`tenantid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790683160709957`
3	`settleList.siteId`	integer	`siteid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790685415443269`
4	`settleList.siteName`	string	`sitename`	名称字段，用于展示与辅助识别	大小写匹配；示例: `朗朗桌球`
5	`settleList.balanceAmount`	number	`balanceamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `232.0`, `125.0`, `18.0`, `300.0`, `4285.55`, `43.61`, `132.0`
6	`settleList.cardAmount`	number	`cardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
7	`settleList.cashAmount`	number	`cashamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `5.0`
8	`settleList.couponAmount`	number	`couponamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `96.0`, `48.0`, `68.0`, `44.2`, `136.0`, `113.66`, `116.0`
9	`settleList.createTime`	string	`createtime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；枚举值: `2026-02-14 00:21:19`, `2026-02-14 00:16:26`, `2026-02-14 00:12:38`, `2026-02-14 00:00:36`, `2026-02-13 23:20:27`, `2026-02-13 23:16:29`, `2026-02-13 23:09:53`, `2026-02-13 22:50:40`
10	`settleList.memberId`	integer	`memberid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `0`, `2799207359858437`, `2799207406946053`, `2799210153232133`, `2799207522600709`, `2799207117129477`, `2799207133021957`, `2849995548625861`
11	`settleList.memberName`	string	`membername`	名称字段，用于展示与辅助识别	大小写匹配
12	`settleList.tenantMemberCardId`	integer	`tenantmembercardid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
13	`settleList.memberCardTypeName`	string	`membercardtypename`	名称字段，用于展示与辅助识别	大小写匹配
14	`settleList.memberPhone`	string	`memberphone`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配
15	`settleList.tableId`	integer	`tableid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `0`, `2793003506815045`, `2793001904918661`, `2793022937911365`, `2793020260044869`, `2793001695301765`, `2791964216463493`, `2793002980429893`
16	`settleList.consumeMoney`	number	`consumemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `10.0`, `135.9`, `78.26`, `395.84`, `107.9`, `68.26`, `64.46`, `809.43`
17	`settleList.onlineAmount`	number	`onlineamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
18	`settleList.operatorId`	integer	`operatorid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790687322443013`
19	`settleList.operatorName`	string	`operatorname`	名称字段，用于展示与辅助识别	大小写匹配；示例: `收银员:郑丽珊`
20	`settleList.revokeOrderId`	integer	`revokeorderid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
21	`settleList.revokeOrderName`	string	`revokeordername`	名称字段，用于展示与辅助识别	大小写匹配
22	`settleList.revokeTime`	string	`revoketime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；示例: `0001-01-01 00:00:00`
23	`settleList.payAmount`	number	`payamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `7.0`, `0.0`, `10.0`, `684.0`, `5.0`, `43.0`, `49.0`, `2.0`
24	`settleList.pointAmount`	number	`pointamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `7.0`, `0.0`, `10.0`, `684.0`, `5.0`, `43.0`, `49.0`, `2.0`
25	`settleList.refundAmount`	number	`refundamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
26	`settleList.settleName`	string	`settlename`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `商城订单`, `A区 A15`, `A区 A4`, `TV台 TV`, `斯诺克区 S4`, `A区 A3`, `A区 A1`, `A区 A9`
27	`settleList.settleRelateId`	integer	`settlerelateid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `3093864074381509`, `3093740766775621`, `3093784062036101`, `3093701555882181`, `3093729955563653`, `3093681905567877`, `3093730735376517`, `3093720617519301`
28	`settleList.settleStatus`	integer	`settlestatus`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2`
29	`settleList.settleType`	integer	`settletype`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `3`, `1`
30	`settleList.payTime`	string	`paytime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；枚举值: `2026-02-14 00:21:21`, `2026-02-14 00:16:27`, `2026-02-14 00:12:40`, `2026-02-14 00:01:01`, `2026-02-13 23:20:28`, `2026-02-13 23:16:30`, `2026-02-13 23:09:55`, `2026-02-13 22:50:42`
31	`settleList.roundingAmount`	number	`roundingamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `0.45`, `0.72`, `0.33`, `0.71`, `0.86`, `0.03`, `0.56`
32	`settleList.paymentMethod`	integer	`paymentmethod`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
33	`settleList.adjustAmount`	number	`adjustamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `125.88`, `66.14`, `64.0`, `34.0`, `1282.22`, `92.66`, `249.16`
34	`settleList.assistantCxMoney`	number	`assistantcxmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
35	`settleList.assistantPdMoney`	number	`assistantpdmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `646.32`, `546.6`, `408.9`, `127.45`
36	`settleList.couponSaleAmount`	number	`couponsaleamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
37	`settleList.plCouponSaleAmount`	number	`plcouponsaleamount`	平台券销售额	大小写匹配；枚举值: `0.0`, `39.9`, `20.26`, `79.8`, `69.9`, `59.9`, `119.7`, `40.52`
38	`settleList.merVouSalesAmount`	number	`mervousalesamount`	商户券销售额	大小写匹配；示例: `0.0`
39	`settleList.memberDiscountAmount`	number	`memberdiscountamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `163.84`, `134.3`, `286.6`, `681.58`
40	`settleList.tableChargeMoney`	number	`tablechargemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `96.0`, `48.0`, `163.84`, `68.0`, `44.2`, `629.43`, `136.0`
41	`settleList.goodsMoney`	number	`goodsmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `10.0`, `0.0`, `232.0`, `180.0`, `5.0`, `125.0`, `18.0`, `2.0`
42	`settleList.realGoodsMoney`	number	`realgoodsmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `7.0`, `0.0`, `10.0`, `232.0`, `180.0`, `5.0`, `125.0`, `18.0`
43	`settleList.serviceMoney`	number	`servicemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
44	`settleList.prepayMoney`	number	`prepaymoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `300.0`
45	`settleList.salesManName`	string	`salesmanname`	名称字段，用于展示与辅助识别	大小写匹配
46	`settleList.orderRemark`	string	`orderremark`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `五折`
47	`settleList.salesManUserId`	integer	`salesmanuserid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
48	`settleList.canBeRevoked`	boolean	`canberevoked`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
49	`settleList.pointDiscountPrice`	number	`pointdiscountprice`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
50	`settleList.pointDiscountCost`	number	`pointdiscountcost`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
51	`settleList.activityDiscount`	number	`activitydiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
52	`settleList.serialNumber`	integer	`serialnumber`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0`
53	`settleList.assistantManualDiscount`	number	`assistantmanualdiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
54	`settleList.allCouponDiscount`	number	`allcoupondiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
55	`settleList.goodsPromotionMoney`	number	`goodspromotionmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
56	`settleList.assistantPromotionMoney`	number	`assistantpromotionmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
57	`settleList.isUseCoupon`	boolean	`isusecoupon`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
58	`settleList.isUseDiscount`	boolean	`isusediscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `False`
59	`settleList.isActivity`	boolean	`isactivity`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
60	`settleList.isBindMember`	boolean	`isbindmember`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
61	`settleList.isFirst`	integer	`isfirst`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
62	`settleList.rechargeCardAmount`	integer	`rechargecardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0`, `232.0`, `300.0`, `4285.55`, `43.61`, `132.0`, `71.07`, `58.0`
63	`settleList.giftCardAmount`	integer	`giftcardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0`, `125.0`, `18.0`, `26.0`, `219.23`, `24.0`
64	`settleList.electricityMoney`	number	`electricitymoney`	电费金额	大小写匹配；示例: `0.0`
65	`settleList.realElectricityMoney`	number	`realelectricitymoney`	实际电费金额	大小写匹配；示例: `0.0`
66	`settleList.electricityAdjustMoney`	number	`electricityadjustmoney`	电费调整金额	大小写匹配；示例: `0.0`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.settlement_records 🔗 API

共 71 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_settlement_head.order_settle_id`, `dwd_settlement_head_ex.order_settle_id`	结账记录主键 ID（订单结算 ID）
2	`tenantid`	bigint	`settleList.tenantId`	`dwd_settlement_head.tenant_id`	来自 JSON 导出的原始字段，用于保留业务取值
3	`siteid`	bigint	`settleList.siteId`	`dwd_settlement_head.site_id`	来自 JSON 导出的原始字段，用于保留业务取值
4	`sitename`	text	`settleList.siteName`	`dwd_settlement_head.site_name`	名称字段，用于展示与辅助识别
5	`balanceamount`	numeric	`settleList.balanceAmount`	`dwd_settlement_head.balance_amount`	金额字段，用于计费/结算/分摊等金额计算
6	`cardamount`	numeric	`settleList.cardAmount`	`dwd_settlement_head_ex.card_amount`	金额字段，用于计费/结算/分摊等金额计算
7	`cashamount`	numeric	`settleList.cashAmount`	`dwd_settlement_head_ex.cash_amount`	金额字段，用于计费/结算/分摊等金额计算
8	`couponamount`	numeric	`settleList.couponAmount`	`dwd_settlement_head.coupon_amount`	金额字段，用于计费/结算/分摊等金额计算
9	`createtime`	timestamp with time zone	`settleList.createTime`	`dwd_settlement_head.create_time`	时间字段，用于记录业务时间点/发生时间
10	`memberid`	bigint	`settleList.memberId`	`dwd_settlement_head.member_id`	来自 JSON 导出的原始字段，用于保留业务取值
11	`membername`	text	`settleList.memberName`	`dwd_settlement_head.member_name`	名称字段，用于展示与辅助识别
12	`tenantmembercardid`	bigint	`settleList.tenantMemberCardId`	`dwd_settlement_head.member_card_account_id`	来自 JSON 导出的原始字段，用于保留业务取值
13	`membercardtypename`	text	`settleList.memberCardTypeName`	`dwd_settlement_head.member_card_type_name`	名称字段，用于展示与辅助识别
14	`memberphone`	text	`settleList.memberPhone`	`dwd_settlement_head.member_phone`	来自 JSON 导出的原始字段，用于保留业务取值
15	`tableid`	bigint	`settleList.tableId`	`dwd_settlement_head.table_id`	来自 JSON 导出的原始字段，用于保留业务取值
16	`consumemoney`	numeric	`settleList.consumeMoney`	`dwd_settlement_head.consume_money`	金额字段，用于计费/结算/分摊等金额计算
17	`onlineamount`	numeric	`settleList.onlineAmount`	`dwd_settlement_head_ex.online_amount`	金额字段，用于计费/结算/分摊等金额计算
18	`operatorid`	bigint	`settleList.operatorId`	`dwd_settlement_head_ex.operator_id`	来自 JSON 导出的原始字段，用于保留业务取值
19	`operatorname`	text	`settleList.operatorName`	`dwd_settlement_head_ex.operator_name`	名称字段，用于展示与辅助识别
20	`revokeorderid`	bigint	`settleList.revokeOrderId`	`dwd_settlement_head.revoke_order_id`	来自 JSON 导出的原始字段，用于保留业务取值
21	`revokeordername`	text	`settleList.revokeOrderName`	`dwd_settlement_head_ex.revoke_order_name`	名称字段，用于展示与辅助识别
22	`revoketime`	timestamp with time zone	`settleList.revokeTime`	`dwd_settlement_head_ex.revoke_time`	时间字段，用于记录业务时间点/发生时间
23	`payamount`	numeric	`settleList.payAmount`	`dwd_settlement_head.pay_amount`	金额字段，用于计费/结算/分摊等金额计算
24	`pointamount`	numeric	`settleList.pointAmount`	`dwd_settlement_head.point_amount`	金额字段，用于计费/结算/分摊等金额计算
25	`refundamount`	numeric	`settleList.refundAmount`	`dwd_settlement_head_ex.refund_amount`	金额字段，用于计费/结算/分摊等金额计算
26	`settlename`	text	`settleList.settleName`	`dwd_settlement_head.settle_name`	名称字段，用于展示与辅助识别
27	`settlerelateid`	bigint	`settleList.settleRelateId`	`dwd_settlement_head.order_trade_no`	来自 JSON 导出的原始字段，用于保留业务取值
28	`settlestatus`	integer	`settleList.settleStatus`	`dwd_settlement_head_ex.settle_status`	来自 JSON 导出的原始字段，用于保留业务取值
29	`settletype`	integer	`settleList.settleType`	`dwd_settlement_head.settle_type`	来自 JSON 导出的原始字段，用于保留业务取值
30	`paytime`	timestamp with time zone	`settleList.payTime`	`dwd_settlement_head.pay_time`	时间字段，用于记录业务时间点/发生时间
31	`roundingamount`	numeric	`settleList.roundingAmount`	`dwd_settlement_head.rounding_amount`	金额字段，用于计费/结算/分摊等金额计算
32	`paymentmethod`	integer	`settleList.paymentMethod`	`dwd_settlement_head_ex.payment_method`	来自 JSON 导出的原始字段，用于保留业务取值
33	`adjustamount`	numeric	`settleList.adjustAmount`	`dwd_settlement_head.adjust_amount`	金额字段，用于计费/结算/分摊等金额计算
34	`assistantcxmoney`	numeric	`settleList.assistantCxMoney`	`dwd_settlement_head.assistant_cx_money`	金额字段，用于计费/结算/分摊等金额计算
35	`assistantpdmoney`	numeric	`settleList.assistantPdMoney`	`dwd_settlement_head.assistant_pd_money`	金额字段，用于计费/结算/分摊等金额计算
36	`couponsaleamount`	numeric	`settleList.couponSaleAmount`	`dwd_settlement_head_ex.coupon_sale_amount`	金额字段，用于计费/结算/分摊等金额计算
37	`memberdiscountamount`	numeric	`settleList.memberDiscountAmount`	`dwd_settlement_head.member_discount_amount`	金额字段，用于计费/结算/分摊等金额计算
38	`tablechargemoney`	numeric	`settleList.tableChargeMoney`	`dwd_settlement_head.table_charge_money`	金额字段，用于计费/结算/分摊等金额计算
39	`goodsmoney`	numeric	`settleList.goodsMoney`	`dwd_settlement_head.goods_money`	金额字段，用于计费/结算/分摊等金额计算
40	`realgoodsmoney`	numeric	`settleList.realGoodsMoney`	`dwd_settlement_head.real_goods_money`	金额字段，用于计费/结算/分摊等金额计算
41	`servicemoney`	numeric	`settleList.serviceMoney`	`dwd_settlement_head_ex.service_money`	金额字段，用于计费/结算/分摊等金额计算
42	`prepaymoney`	numeric	`settleList.prepayMoney`	`dwd_settlement_head_ex.prepay_money`	金额字段，用于计费/结算/分摊等金额计算
43	`salesmanname`	text	`settleList.salesManName`	`dwd_settlement_head_ex.salesman_name`	名称字段，用于展示与辅助识别
44	`orderremark`	text	`settleList.orderRemark`	`dwd_settlement_head_ex.order_remark`	来自 JSON 导出的原始字段，用于保留业务取值
45	`salesmanuserid`	bigint	`settleList.salesManUserId`	`dwd_settlement_head_ex.salesman_user_id`	来自 JSON 导出的原始字段，用于保留业务取值
46	`canberevoked`	boolean	`settleList.canBeRevoked`	`dwd_settlement_head_ex.can_be_revoked`	来自 JSON 导出的原始字段，用于保留业务取值
47	`pointdiscountprice`	numeric	`settleList.pointDiscountPrice`	`dwd_settlement_head_ex.point_discount_price`	金额字段，用于计费/结算/分摊等金额计算
48	`pointdiscountcost`	numeric	`settleList.pointDiscountCost`	`dwd_settlement_head_ex.point_discount_cost`	金额字段，用于计费/结算/分摊等金额计算
49	`activitydiscount`	numeric	`settleList.activityDiscount`	`dwd_settlement_head_ex.activity_discount`	数量/时长字段，用于统计与计量
50	`serialnumber`	bigint	`settleList.serialNumber`	`dwd_settlement_head_ex.serial_number`	数量/时长字段，用于统计与计量
51	`assistantmanualdiscount`	numeric	`settleList.assistantManualDiscount`	`dwd_settlement_head_ex.assistant_manual_discount`	数量/时长字段，用于统计与计量
52	`allcoupondiscount`	numeric	`settleList.allCouponDiscount`	`dwd_settlement_head_ex.all_coupon_discount`	数量/时长字段，用于统计与计量
53	`goodspromotionmoney`	numeric	`settleList.goodsPromotionMoney`	`dwd_settlement_head_ex.goods_promotion_money`	金额字段，用于计费/结算/分摊等金额计算
54	`assistantpromotionmoney`	numeric	`settleList.assistantPromotionMoney`	`dwd_settlement_head_ex.assistant_promotion_money`	金额字段，用于计费/结算/分摊等金额计算
55	`isusecoupon`	boolean	`settleList.isUseCoupon`	`dwd_settlement_head_ex.is_use_coupon`	来自 JSON 导出的原始字段，用于保留业务取值
56	`isusediscount`	boolean	`settleList.isUseDiscount`	`dwd_settlement_head_ex.is_use_discount`	数量/时长字段，用于统计与计量
57	`isactivity`	boolean	`settleList.isActivity`	`dwd_settlement_head_ex.is_activity`	来自 JSON 导出的原始字段，用于保留业务取值
58	`isbindmember`	boolean	`settleList.isBindMember`	`dwd_settlement_head.is_bind_member`	来自 JSON 导出的原始字段，用于保留业务取值
59	`isfirst`	integer	`settleList.isFirst`	`dwd_settlement_head_ex.is_first_order`	来自 JSON 导出的原始字段，用于保留业务取值
60	`rechargecardamount`	numeric	`settleList.rechargeCardAmount`	`dwd_settlement_head.recharge_card_amount`	金额字段，用于计费/结算/分摊等金额计算
61	`giftcardamount`	numeric	`settleList.giftCardAmount`	`dwd_settlement_head.gift_card_amount`	金额字段，用于计费/结算/分摊等金额计算
62	`electricityadjustmoney`	numeric	`settleList.electricityAdjustMoney`	`dwd_settlement_head.electricity_adjust_money`	电费调整金额
63	`electricitymoney`	numeric	`settleList.electricityMoney`	`dwd_settlement_head.electricity_money`	电费金额
64	`mervousalesamount`	numeric	`settleList.merVouSalesAmount`	`dwd_settlement_head.mervou_sales_amount`	商户券销售额
65	`plcouponsaleamount`	numeric	`settleList.plCouponSaleAmount`	`dwd_settlement_head.pl_coupon_sale_amount`	平台券销售额
66	`realelectricitymoney`	numeric	`settleList.realElectricityMoney`	`dwd_settlement_head.real_electricity_money`	实际电费金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_settlement_head 🔗 ODS

共 37 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`order_settle_id`	bigint	`id`	直接	结账单 ID
2	`tenant_id`	bigint	`tenantid`	直接	租户 ID
3	`site_id`	bigint	`siteid`	直接	门店 ID → dim_site
4	`site_name`	character varying	`sitename`	直接	门店名称。当前值: "朗朗桌球"
5	`table_id`	bigint	`tableid`	直接	台桌 ID → dim_table（0=非台桌订单，如商城订单）
6	`settle_name`	character varying	`settlename`	直接	结账名称。样本值: "商城订单", "A区 A3", "A区 A4", "斯诺克区 S1"
7	`order_trade_no`	bigint	`settlerelateid`	直接	订单号
8	`create_time`	timestamp with time zone	`createtime`	直接	创建时间
9	`pay_time`	timestamp with time zone	`paytime`	直接	支付时间
10	`settle_type`	integer	`settletype`	直接	结账类型。枚举值: 1=台桌结账, 3=商城订单, 6=退货订单, 7=退款订单
11	`revoke_order_id`	bigint	`revokeorderid`	直接	撤销订单 ID（当前数据全为 0）
12	`member_id`	bigint	`memberid`	直接	会员 ID → dim_member（0=散客，占比约 82.8%）
13	`member_name`	character varying	`membername`	直接	会员名称
14	`member_phone`	character varying	`memberphone`	直接	会员电话
15	`member_card_account_id`	bigint	`tenantmembercardid`	直接	会员卡账户 ID（当前数据全为 0）
16	`member_card_type_name`	character varying	`membercardtypename`	直接	卡类型名称（当前数据全为空）
17	`is_bind_member`	boolean	`isbindmember`	直接	是否绑定会员。枚举值: False=否
18	`member_discount_amount`	numeric	`memberdiscountamount`	直接	会员折扣金额
19	`consume_money`	numeric	`consumemoney`	直接	消费总金额（元）
20	`table_charge_money`	numeric	`tablechargemoney`	直接	台费金额
21	`goods_money`	numeric	`goodsmoney`	直接	商品金额
22	`real_goods_money`	numeric	`realgoodsmoney`	直接	实收商品金额
23	`assistant_pd_money`	numeric	`assistantpdmoney`	直接	助教陪打费用
24	`assistant_cx_money`	numeric	`assistantcxmoney`	直接	助教超休费用
25	`adjust_amount`	numeric	`adjustamount`	直接	调整金额
26	`pay_amount`	numeric	`payamount`	直接	实付金额
27	`balance_amount`	numeric	`balanceamount`	直接	余额支付金额
28	`recharge_card_amount`	numeric	`rechargecardamount`	直接	储值卡支付金额
29	`gift_card_amount`	numeric	`giftcardamount`	直接	礼品卡支付金额
30	`coupon_amount`	numeric	`couponamount`	直接	券抵扣金额
31	`rounding_amount`	numeric	`roundingamount`	直接	抹零金额
32	`point_amount`	numeric	`pointamount`	直接	积分抵扣等值金额
33	`electricity_money`	numeric	`electricitymoney`	直接	电费金额
34	`real_electricity_money`	numeric	`realelectricitymoney`	直接	实际电费金额
35	`electricity_adjust_money`	numeric	`electricityadjustmoney`	直接	电费调整金额
36	`pl_coupon_sale_amount`	numeric	`plcouponsaleamount`	直接	平台券销售额
37	`mervou_sales_amount`	numeric	`mervousalesamount`	直接	商户券销售额

DWD 表结构 — dwd.dwd_settlement_head_ex 🔗 ODS

共 30 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`order_settle_id`	bigint	`id`	直接	字段重命名
2	`serial_number`	integer	`serialnumber`	直接	字段重命名
3	`settle_status`	integer	`settlestatus`	直接	字段重命名
4	`can_be_revoked`	boolean	`canberevoked`	→ boolean	字段重命名
5	`revoke_order_name`	character varying	`revokeordername`	直接	字段重命名
6	`revoke_time`	timestamp with time zone	`revoketime`	直接	字段重命名
7	`is_first_order`	boolean	`isfirst`	→ boolean	字段重命名
8	`service_money`	numeric	`servicemoney`	直接	字段重命名
9	`cash_amount`	numeric	`cashamount`	直接	字段重命名
10	`card_amount`	numeric	`cardamount`	直接	字段重命名
11	`online_amount`	numeric	`onlineamount`	直接	字段重命名
12	`refund_amount`	numeric	`refundamount`	直接	字段重命名
13	`prepay_money`	numeric	`prepaymoney`	直接	字段重命名
14	`payment_method`	integer	`paymentmethod`	直接	字段重命名
15	`coupon_sale_amount`	numeric	`couponsaleamount`	直接	字段重命名
16	`all_coupon_discount`	numeric	`allcoupondiscount`	直接	字段重命名
17	`goods_promotion_money`	numeric	`goodspromotionmoney`	直接	字段重命名
18	`assistant_promotion_money`	numeric	`assistantpromotionmoney`	直接	字段重命名
19	`activity_discount`	numeric	`activitydiscount`	直接	字段重命名
20	`assistant_manual_discount`	numeric	`assistantmanualdiscount`	直接	字段重命名
21	`point_discount_price`	numeric	`pointdiscountprice`	直接	字段重命名
22	`point_discount_cost`	numeric	`pointdiscountcost`	直接	字段重命名
23	`is_use_coupon`	boolean	`isusecoupon`	→ boolean	字段重命名
24	`is_use_discount`	boolean	`isusediscount`	→ boolean	字段重命名
25	`is_activity`	boolean	`isactivity`	→ boolean	字段重命名
26	`operator_name`	character varying	`operatorname`	直接	字段重命名
27	`salesman_name`	character varying	`salesmanname`	直接	字段重命名
28	`order_remark`	character varying	`orderremark`	直接	字段重命名
29	`operator_id`	bigint	`operatorid`	直接	字段重命名
30	`salesman_user_id`	bigint	`salesmanuserid`	直接	字段重命名

3.3 table_fee_transactions（台费计费流水）

任务代码：ODS_TABLE_USE
采样记录数：200
API JSON 字段数：67
ODS 列数：47
DWD 目标表：dim_site, dim_site_ex, dwd_table_fee_log, dwd_table_fee_log_ex

API 源字段 — table_fee_transactions 🔗 ODS

已映射 43/67，覆盖率 64.2% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`id`	integer	`id`	台费流水记录主键（事实表主键）	枚举值: `3093859291416901`, `3093855576901893`, `3093844120701253`, `3093804251023685`, `3093800356989125`, `3093793885112581`, `3093774985185413`, `3093761347356805`
2	`add_clock_seconds`	integer	`add_clock_seconds`	加钟秒数，在原有使用基础上追加的时长	枚举值: `0`, `1200`, `1800`
3	`activity_discount_amount`	number	`activity_discount_amount`	活动折扣金额	示例: `0.0`
4	`adjust_amount`	number	`adjust_amount`	调整金额/调账金额，用于将台费金额转移或冲减到其它项目，或手工调整	枚举值: `0.0`, `125.88`, `66.14`, `64.0`, `34.0`, `1191.01`, `91.21`, `92.66`
5	`coupon_promotion_amount`	number	`coupon_promotion_amount`	由优惠券/活动/团购（平台/门店促销）承担的优惠金额，直接抵扣在台费上	枚举值: `96.0`, `48.0`, `0.0`, `68.0`, `44.2`, `136.0`, `113.66`, `116.0`
6	`create_time`	string	`create_time`	这条台费流水记录的创建时间，通常接近结账时间	枚举值: `2026-02-14 00:16:27`, `2026-02-14 00:12:40`, `2026-02-14 00:01:01`, `2026-02-13 23:20:28`, `2026-02-13 23:16:30`, `2026-02-13 23:09:55`, `2026-02-13 22:50:42`, `2026-02-13 22:36:49`
7	`fee_total`	number	`fee_total`	各种附加费用（如管理费、服务费）合计值	示例: `0.0`
8	`is_delete`	integer	`is_delete`	逻辑删除标记（0=否，1=是）	示例: `0`
9	`is_single_order`	integer	`is_single_order`	布尔/开关字段，用于表示权限、可用性或状态开关	枚举值: `1`, `0`
10	`last_use_time`	string	`last_use_time`	最后使用/操作时间	枚举值: `2026-02-14 00:15:53`, `2026-02-13 23:59:55`, `2026-02-14 00:00:33`, `2026-02-13 23:04:53`, `2026-02-13 23:16:00`, `2026-02-13 23:05:40`, `2026-02-13 22:50:38`, `2026-02-13 22:35:21`
11	`ledger_amount`	number	`ledger_amount`	按单价与计费时长计算出的原始应收台费金额	枚举值: `96.0`, `48.0`, `163.84`, `68.0`, `44.2`, `629.43`, `136.0`, `113.66`
12	`ledger_count`	integer	`ledger_count`	台账记录的计费秒数，计费用秒数（应收时长）	枚举值: `7200`, `3600`, `8674`, `3315`, `12053`, `7055`, `3171`, `3650`
13	`ledger_end_time`	string	`ledger_end_time`	台账上的计费结束时间	枚举值: `2026-02-14 00:15:53`, `2026-02-13 23:59:55`, `2026-02-14 00:00:33`, `2026-02-13 23:04:53`, `2026-02-13 23:16:00`, `2026-02-13 23:05:40`, `2026-02-13 22:50:38`, `2026-02-13 22:35:21`
14	`ledger_name`	string	`ledger_name`	台号名称，实际展示给员工/顾客看的桌台编号	枚举值: `A15`, `A4`, `TV`, `S4`, `A3`, `A1`, `A9`, `A17`
15	`ledger_start_time`	string	`ledger_start_time`	台账上的计费起始时间	枚举值: `2026-02-13 22:15:53`, `2026-02-13 22:59:55`, `2026-02-13 21:35:59`, `2026-02-13 22:04:53`, `2026-02-13 21:16:00`, `2026-02-13 22:05:40`, `2026-02-13 21:55:23`, `2026-02-13 20:35:21`
16	`ledger_status`	integer	`ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
17	`ledger_unit_price`	number	`ledger_unit_price`	台费结算时设置的每小时单价/计费单价	枚举值: `48.0`, `68.0`, `188.0`, `58.0`, `398.0`, `98.0`, `158.0`, `100.0`
18	`member_discount_amount`	number	`member_discount_amount`	由会员权益产生的优惠金额，例如会员折扣、会员价等	枚举值: `0.0`, `163.84`, `134.3`, `286.6`, `681.58`, `158.74`
19	`member_id`	integer	`member_id`	门店/租户内的会员 ID	枚举值: `0`, `2799207359858437`, `2799207406946053`, `2799207522600709`, `2799207117129477`, `2799207133021957`, `2849995548625861`, `2799212845565701`
20	`mgmt_fee`	number	`mgmt_fee`	管理费字段，用于未来支持“台费附加管理费/服务费”的功能	示例: `0.0`
21	`operator_id`	integer	`operator_id`	操作员 ID，负责开台/结账的员工账号 ID	示例: `2790687322443013`
22	`operator_name`	string	`operator_name`	操作员姓名（冗余字段），便于直接阅读，不必再联表员工档案	示例: `收银员:郑丽珊`
23	`order_consumption_type`	integer	`order_consumption_type`	订单消费类型	枚举值: `3`, `2`, `1`
24	`order_pay_id`	integer	`order_pay_id`	订单支付记录 ID	示例: `0`
25	`order_settle_id`	integer	`order_settle_id`	结算单号/结账 ID，对应一次结账操作	枚举值: `3093859276196037`, `3093855537596549`, `3093843703564549`, `3093804233967877`, `3093800338802821`, `3093793847478597`, `3093774959741061`, `3093761316341957`
26	`order_trade_no`	integer	`order_trade_no`	订单交易号，是整笔订单的主编号	枚举值: `3093740766775621`, `3093784062036101`, `3093701555882181`, `3093729955563653`, `3093681905567877`, `3093730735376517`, `3093720617519301`, `3093641948924229`
27	`real_table_charge_money`	number	`real_table_charge_money`	台费中实际向顾客收取的金额（现金/实付维度，未含券方承担或内部调账的那一部分）	枚举值: `0.0`, `503.55`, `42.28`, `48.67`, `24.29`, `66.14`, `49.97`, `24.44`
28	`real_table_use_seconds`	integer	`real_table_use_seconds`	实际使用的总秒数（系统真实统计的使用时长）	枚举值: `7200`, `3600`, `8674`, `3315`, `12053`, `7055`, `3171`, `3651`
29	`real_service_money`	number	`real_service_money`	实际服务费金额	示例: `0.0`
30	`salesman_name`	string	`salesman_name`	业务员/营业员姓名，如果台费有单独提成员工，这里记录归属人
31	`salesman_org_id`	integer	`salesman_org_id`	营业员所属机构/部门 ID	示例: `0`
32	`salesman_user_id`	integer	`salesman_user_id`	营业员的用户 ID（与 salesman_name 搭配）	示例: `0`
33	`service_money`	number	`service_money`	门店用于记录“服务费/成本/分成金额”的字段，类似助教流水里的 service_money	示例: `0.0`
34	`site_id`	integer	`site_id`	门店 ID，本次数据全部来自同一门店（朗朗桌球）	示例: `2790685415443269`
35	`site_table_area_id`	integer	`site_table_area_id`	门店内“台桌区域” ID（站在门店物理布局的角度）	枚举值: `2791963794329671`, `2791963864273029`, `2791963836207173`, `2791963855982661`, `2791963807682693`, `2791963816579205`, `2791963887030341`, `2956246442462533`
36	`site_table_area_name`	string	`site_table_area_name`	台桌区域的名称，用于门店表现和区域统计	枚举值: `A区`, `TV台`, `斯诺克区`, `K包`, `B区`, `C区`, `麻将房`, `发财`
37	`site_table_id`	integer	`site_table_id`	球台 ID	枚举值: `2793003506815045`, `2793001904918661`, `2793022937911365`, `2793020260044869`, `2793001695301765`, `2791964216463493`, `2793002980429893`, `2793003705192517`
38	`start_use_time`	string	`start_use_time`	台开始使用的时间（实际开台时间）	枚举值: `2026-02-13 22:15:53`, `2026-02-13 22:59:55`, `2026-02-13 21:35:59`, `2026-02-13 22:04:53`, `2026-02-13 21:16:00`, `2026-02-13 22:05:40`, `2026-02-13 21:55:23`, `2026-02-13 20:35:21`
39	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
40	`tenant_table_area_id`	integer	`tenant_table_area_id`	租户维度的台桌区域 ID（品牌层面的同一类区域）	枚举值: `2791960001957765`, `2791962068946821`, `2791961347968901`, `2791961709907845`, `2791960521691013`, `2791960850435973`, `2791962314215301`, `2956244810877893`
41	`used_card_amount`	number	`used_card_amount`	由储值卡、次卡等“卡内余额”抵扣的金额	示例: `0.0`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.table_fee_transactions 🔗 API

共 47 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_table_fee_log.table_fee_log_id`, `dwd_table_fee_log_ex.table_fee_log_id`	台费流水记录主键（事实表主键）
2	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_table_fee_log.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dim_site.site_id`, `dim_site_ex.site_id`, `dwd_table_fee_log.site_id`	门店 ID，本次数据全部来自同一门店（朗朗桌球）
4	`siteprofile`	jsonb	—	—	（待补充）
5	`site_table_id`	bigint	`site_table_id`	`dwd_table_fee_log.site_table_id`	球台 ID
6	`site_table_area_id`	bigint	`site_table_area_id`	`dwd_table_fee_log.site_table_area_id`	门店内“台桌区域” ID（站在门店物理布局的角度）
7	`site_table_area_name`	text	`site_table_area_name`	`dwd_table_fee_log.site_table_area_name`	台桌区域的名称，用于门店表现和区域统计
8	`tenant_table_area_id`	bigint	`tenant_table_area_id`	`dwd_table_fee_log.tenant_table_area_id`	租户维度的台桌区域 ID（品牌层面的同一类区域）
9	`order_trade_no`	text	`order_trade_no`	`dwd_table_fee_log.order_trade_no`	订单交易号，是整笔订单的主编号
10	`order_pay_id`	bigint	`order_pay_id`	`dwd_table_fee_log.order_pay_id`	订单支付记录 ID
11	`order_settle_id`	bigint	`order_settle_id`	`dwd_table_fee_log.order_settle_id`	结算单号/结账 ID，对应一次结账操作
12	`ledger_name`	text	`ledger_name`	`dwd_table_fee_log.ledger_name`	台号名称，实际展示给员工/顾客看的桌台编号
13	`ledger_amount`	numeric	`ledger_amount`	`dwd_table_fee_log.ledger_amount`	按单价与计费时长计算出的原始应收台费金额
14	`ledger_count`	numeric	`ledger_count`	`dwd_table_fee_log.ledger_count`	台账记录的计费秒数，计费用秒数（应收时长）
15	`ledger_unit_price`	numeric	`ledger_unit_price`	`dwd_table_fee_log.ledger_unit_price`	台费结算时设置的每小时单价/计费单价
16	`ledger_status`	integer	`ledger_status`	`dwd_table_fee_log.ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值
17	`ledger_start_time`	timestamp without time zone	`ledger_start_time`	`dwd_table_fee_log_ex.ledger_start_time`	台账上的计费起始时间
18	`ledger_end_time`	timestamp without time zone	`ledger_end_time`	`dwd_table_fee_log.ledger_end_time`	台账上的计费结束时间
19	`start_use_time`	timestamp without time zone	`start_use_time`	`dwd_table_fee_log.start_use_time`	台开始使用的时间（实际开台时间）
20	`last_use_time`	timestamp without time zone	`last_use_time`	`dwd_table_fee_log_ex.last_use_time`	最后使用/操作时间
21	`real_table_use_seconds`	integer	`real_table_use_seconds`	`dwd_table_fee_log.real_table_use_seconds`	实际使用的总秒数（系统真实统计的使用时长）
22	`real_table_charge_money`	numeric	`real_table_charge_money`	`dwd_table_fee_log.real_table_charge_money`	台费中实际向顾客收取的金额（现金/实付维度，未含券方承担或内部调账的那一部分）
23	`add_clock_seconds`	integer	`add_clock_seconds`	`dwd_table_fee_log.add_clock_seconds`	加钟秒数，在原有使用基础上追加的时长
24	`adjust_amount`	numeric	`adjust_amount`	`dwd_table_fee_log.adjust_amount`	调整金额/调账金额，用于将台费金额转移或冲减到其它项目，或手工调整
25	`coupon_promotion_amount`	numeric	`coupon_promotion_amount`	`dwd_table_fee_log.coupon_promotion_amount`	由优惠券/活动/团购（平台/门店促销）承担的优惠金额，直接抵扣在台费上
26	`member_discount_amount`	numeric	`member_discount_amount`	`dwd_table_fee_log.member_discount_amount`	由会员权益产生的优惠金额，例如会员折扣、会员价等
27	`used_card_amount`	numeric	`used_card_amount`	`dwd_table_fee_log_ex.used_card_amount`	由储值卡、次卡等“卡内余额”抵扣的金额
28	`mgmt_fee`	numeric	`mgmt_fee`	`dwd_table_fee_log_ex.mgmt_fee`	管理费字段，用于未来支持“台费附加管理费/服务费”的功能
29	`service_money`	numeric	`service_money`	`dwd_table_fee_log_ex.service_money`	门店用于记录“服务费/成本/分成金额”的字段，类似助教流水里的 service_money
30	`fee_total`	numeric	`fee_total`	`dwd_table_fee_log_ex.fee_total`	各种附加费用（如管理费、服务费）合计值
31	`is_single_order`	integer	`is_single_order`	`dwd_table_fee_log.is_single_order`	布尔/开关字段，用于表示权限、可用性或状态开关
32	`is_delete`	integer	`is_delete`	`dwd_table_fee_log.is_delete`	逻辑删除标记（0=否，1=是）
33	`member_id`	bigint	`member_id`	`dwd_table_fee_log.member_id`	门店/租户内的会员 ID
34	`operator_id`	bigint	`operator_id`	`dwd_table_fee_log_ex.operator_id`	操作员 ID，负责开台/结账的员工账号 ID
35	`operator_name`	text	`operator_name`	`dwd_table_fee_log_ex.operator_name`	操作员姓名（冗余字段），便于直接阅读，不必再联表员工档案
36	`salesman_name`	text	`salesman_name`	`dwd_table_fee_log_ex.salesman_name`	业务员/营业员姓名，如果台费有单独提成员工，这里记录归属人
37	`salesman_org_id`	bigint	`salesman_org_id`	`dwd_table_fee_log_ex.salesman_org_id`	营业员所属机构/部门 ID
38	`salesman_user_id`	bigint	`salesman_user_id`	`dwd_table_fee_log_ex.salesman_user_id`	营业员的用户 ID（与 salesman_name 搭配）
39	`create_time`	timestamp without time zone	`create_time`	`dwd_table_fee_log.create_time`	这条台费流水记录的创建时间，通常接近结账时间
40	`activity_discount_amount`	numeric	`activity_discount_amount`	`dwd_table_fee_log.activity_discount_amount`	活动折扣金额
41	`order_consumption_type`	integer	`order_consumption_type`	`dwd_table_fee_log_ex.order_consumption_type`	订单消费类型
42	`real_service_money`	numeric	`real_service_money`	`dwd_table_fee_log.real_service_money`	实际服务费金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dim_site 🔗 ODS

共 17 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_id`	bigint	`site_id`	直接	门店 ID
2	`org_id`	bigint	`siteprofile->>'org_id'`	直接	组织机构 ID
3	`tenant_id`	bigint	`siteprofile->>'tenant_id'`	直接	租户 ID（当前值: 2790683160709957）
4	`shop_name`	text	`siteprofile->>'shop_name'`	直接	门店名称。当前值: "朗朗桌球"
5	`site_label`	text	`siteprofile->>'site_label'`	直接	门店标签。当前值: "A"
6	`full_address`	text	`siteprofile->>'full_address'`	直接	详细地址。当前值: "广东省广州市天河区丽阳街12号"
7	`address`	text	`siteprofile->>'address'`	直接	地址描述。当前值: "广东省广州市天河区天园街道朗朗桌球"
8	`longitude`	numeric	`siteprofile->>'longitude'`	→ numeric	经度。当前值: 113.360321
9	`latitude`	numeric	`siteprofile->>'latitude'`	→ numeric	纬度。当前值: 23.133629
10	`tenant_site_region_id`	bigint	`siteprofile->>'tenant_site_region_id'`	直接	区域 ID。当前值: 156440100
11	`business_tel`	text	`siteprofile->>'business_tel'`	直接	联系电话。当前值: "13316068642"
12	`site_type`	integer	`siteprofile->>'site_type'`	直接	门店类型。枚举值: 1(1)=[待确认]
13	`shop_status`	integer	`siteprofile->>'shop_status'`	直接	营业状态。枚举值: 1(1)=营业中 [待确认]
14	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
15	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
16	`scd2_is_current`	integer	—	SCD2	当前版本标记
17	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_site_ex 🔗 ODS

共 25 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_id`	bigint	`site_id`	直接	同名直传
2	`avatar`	text	`siteprofile->>'avatar'`	直接	JSONB 提取
3	`address`	text	`siteprofile->>'address'`	直接	JSONB 提取
4	`longitude`	numeric	`siteprofile->>'longitude'`	→ numeric	JSONB 提取
5	`latitude`	numeric	`siteprofile->>'latitude'`	→ numeric	JSONB 提取
6	`tenant_site_region_id`	bigint	`siteprofile->>'tenant_site_region_id'`	直接	JSONB 提取
7	`auto_light`	integer	`siteprofile->>'auto_light'`	直接	JSONB 提取
8	`light_status`	integer	`siteprofile->>'light_status'`	直接	JSONB 提取
9	`light_type`	integer	`siteprofile->>'light_type'`	直接	JSONB 提取
10	`light_token`	text	`siteprofile->>'light_token'`	直接	JSONB 提取
11	`site_type`	integer	`siteprofile->>'site_type'`	直接	JSONB 提取
12	`site_label`	text	`siteprofile->>'site_label'`	直接	JSONB 提取
13	`attendance_enabled`	integer	`siteprofile->>'attendance_enabled'`	直接	JSONB 提取
14	`attendance_distance`	integer	`siteprofile->>'attendance_distance'`	直接	JSONB 提取
15	`customer_service_qrcode`	text	`siteprofile->>'customer_service_qrcode'`	直接	JSONB 提取
16	`customer_service_wechat`	text	`siteprofile->>'customer_service_wechat'`	直接	JSONB 提取
17	`fixed_pay_qrcode`	text	`siteprofile->>'fixed_pay_qrCode'`	直接	JSONB 提取
18	`prod_env`	text	`siteprofile->>'prod_env'`	直接	JSONB 提取
19	`shop_status`	integer	`siteprofile->>'shop_status'`	直接	JSONB 提取
20	`create_time`	timestamp with time zone	`siteprofile->>'create_time'`	→ timestamptz	JSONB 提取
21	`update_time`	timestamp with time zone	`siteprofile->>'update_time'`	→ timestamptz	JSONB 提取
22	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
23	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
24	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
25	`scd2_version`	integer	—	SCD2	SCD2 元数据

DWD 表结构 — dwd.dwd_table_fee_log 🔗 ODS

共 29 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_fee_log_id`	bigint	`id`	直接	台费流水 ID
2	`order_trade_no`	bigint	`order_trade_no`	直接	订单号
3	`order_settle_id`	bigint	`order_settle_id`	直接	结账单 ID → dwd_settlement_head
4	`order_pay_id`	bigint	`order_pay_id`	直接	支付单 ID（当前数据全为 0）
5	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
6	`site_id`	bigint	`site_id`	直接	门店 ID
7	`site_table_id`	bigint	`site_table_id`	直接	台桌 ID → dim_table
8	`site_table_area_id`	bigint	`site_table_area_id`	直接	台区 ID
9	`site_table_area_name`	character varying	`site_table_area_name`	直接	台区名称。枚举值: "A区", "B区", "斯诺克区", "麻将房", "C区", "补时长", "VI...
10	`tenant_table_area_id`	bigint	`tenant_table_area_id`	直接	租户级台区 ID
11	`member_id`	bigint	`member_id`	直接	会员 ID（0=散客，占比约 82.4%）
12	`ledger_name`	character varying	`ledger_name`	直接	台桌名称。样本值: "A3", "A5", "A4", "S1", "B5", "M3" 等
13	`ledger_unit_price`	numeric	`ledger_unit_price`	直接	单价（元/小时），如 48.00/58.00/68.00
14	`ledger_count`	integer	`ledger_count`	直接	计费时长（秒）。样本值: 3600=1h, 7200=2h, 10800=3h 等
15	`ledger_amount`	numeric	`ledger_amount`	直接	计费金额（元）
16	`real_table_charge_money`	numeric	`real_table_charge_money`	直接	实收台费金额
17	`coupon_promotion_amount`	numeric	`coupon_promotion_amount`	直接	券促销金额
18	`member_discount_amount`	numeric	`member_discount_amount`	直接	会员折扣金额
19	`adjust_amount`	numeric	`adjust_amount`	直接	调整金额
20	`real_table_use_seconds`	integer	`real_table_use_seconds`	直接	实际使用时长（秒）
21	`add_clock_seconds`	integer	`add_clock_seconds`	直接	加时时长（秒），大多为 0
22	`start_use_time`	timestamp with time zone	`start_use_time`	直接	开台时间
23	`ledger_end_time`	timestamp with time zone	`ledger_end_time`	直接	结账时间
24	`create_time`	timestamp with time zone	`create_time`	直接	记录创建时间
25	`ledger_status`	integer	`ledger_status`	直接	账本状态。枚举值: 1=已结算
26	`is_single_order`	integer	`is_single_order`	直接	是否独立订单。枚举值: 0=合并订单, 1=独立订单
27	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
28	`activity_discount_amount`	numeric	`activity_discount_amount`	直接	活动折扣金额
29	`real_service_money`	numeric	`real_service_money`	直接	实际服务费金额

DWD 表结构 — dwd.dwd_table_fee_log_ex 🔗 ODS

共 13 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_fee_log_id`	bigint	`id`	直接	字段重命名
2	`operator_name`	character varying	`operator_name`	直接	同名直传
3	`salesman_name`	character varying	`salesman_name`	直接	名称字段，用于展示与辅助识别
4	`used_card_amount`	numeric	`used_card_amount`	直接	同名直传
5	`service_money`	numeric	`service_money`	直接	同名直传
6	`mgmt_fee`	numeric	`mgmt_fee`	直接	同名直传
7	`fee_total`	numeric	`fee_total`	直接	同名直传
8	`ledger_start_time`	timestamp with time zone	`ledger_start_time`	直接	同名直传
9	`last_use_time`	timestamp with time zone	`last_use_time`	直接	同名直传
10	`operator_id`	bigint	`operator_id`	直接	同名直传
11	`salesman_user_id`	bigint	`salesman_user_id`	直接	同名直传
12	`salesman_org_id`	bigint	`salesman_org_id`	直接	同名直传
13	`order_consumption_type`	integer	`order_consumption_type`	直接

3.4 assistant_service_records（助教服务流水）

任务代码：ODS_ASSISTANT_LEDGER
采样记录数：200
API JSON 字段数：91
ODS 列数：71
DWD 目标表：dwd_assistant_service_log, dwd_assistant_service_log_ex

API 源字段 — assistant_service_records 🔗 ODS

已映射 67/91，覆盖率 73.6% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`assistantNo`	string	`assistantno`	（待补充）	大小写匹配；枚举值: `15`, `21`, `1`, `2`, `11`, `37`, `9`, `4`
2	`nickname`	string	`nickname`	助教对外昵称，如“佳怡”“周周”“球球”等	枚举值: `七七`, `年糕`, `小燕`, `佳怡`, `千千`, `阿清`, `球球`, `璇子`
3	`levelName`	string	`levelname`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `中级`, `初级`, `星级`, `高级`
4	`assistantTeamName`	string	`assistantteamname`	助教团队名称	大小写匹配；枚举值: `1组`, `2组`
5	`assistantName`	string	`assistantname`	（待补充）	大小写匹配；枚举值: `邹绮`, `李艳`, `李小燕`, `陈嘉怡`, `张芳梅`, `梁坚锖`, `胡敏`, `谭璇`
6	`tableName`	string	`tablename`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `发财`, `666`, `C5`, `S1`, `TV`, `VIP5`, `M5`, `A1`
7	`skillName`	string	`skillname`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `基础课`, `附加课`, `包厢课`
8	`id`	integer	`id`	本条助教流水记录的主键 ID（流水唯一标识）	枚举值: `3092712427276485`, `3091323705821317`, `3091115886692677`, `3090827615127877`, `3090739976226949`, `3090257805610309`, `3090257805102405`, `3089721510071749`
9	`order_trade_no`	integer	`order_trade_no`	订单交易号，整个订单层面的编号	枚举值: `3092230766020741`, `3091018769713413`, `3090862690715909`, `3090742856632581`, `3090601961359621`, `3089320298319045`, `3089223699680453`, `3089415923404101`
10	`site_id`	integer	`site_id`	门店 ID，本数据中指“朗朗桌球”这一家门店	示例: `2790685415443269`
11	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
12	`operator_id`	integer	`operator_id`	操作员 ID（录入/结算这条助教服务的员工）	示例: `2790687322443013`
13	`operator_name`	string	`operator_name`	操作员姓名，与 operator_id 一起使用，便于直接阅读	示例: `收银员:郑丽珊`
14	`order_settle_id`	integer	`order_settle_id`	订单结算 ID，相当于“结账单号”的内部主键	枚举值: `3092711340902597`, `3091323600603397`, `3091115820353733`, `3090827566926085`, `3090739928746117`, `3090257727786373`, `3089721241816261`, `3089689788959941`
15	`ledger_name`	string	`ledger_name`	名称字段，用于展示与辅助识别	枚举值: `15-七七`, `21-年糕`, `1-小燕`, `2-佳怡`, `11-千千`, `37-阿清`, `9-球球`, `4-璇子`
16	`ledger_group_name`	string	`ledger_group_name`	助教项目所属的“计费分组/套餐分组名称”，例如某种助教套餐或业务组名称
17	`ledger_unit_price`	number	`ledger_unit_price`	助教服务标准单价（通常是标价：每小时、每节课的单价）	枚举值: `108.0`, `98.0`, `138.0`, `190.0`, `118.0`
18	`ledger_count`	integer	`ledger_count`	台账记录的计时总秒数	枚举值: `21544`, `18220`, `15021`, `4682`, `7717`, `47652`, `4774`, `1224`
19	`ledger_amount`	number	`ledger_amount`	按标准单价计算出来的应收金额（近似 = ledger_unit_price × income_seconds / ...	枚举值: `646.32`, `546.6`, `408.9`, `127.45`, `210.07`, `1429.56`, `129.96`, `33.32`
20	`order_pay_id`	integer	`order_pay_id`	关联到“支付记录”的主键 ID	示例: `0`
21	`create_time`	string	`create_time`	这条助教流水记录创建时间（一般接近结算/下单时间）	枚举值: `2026-02-13 04:49:48`, `2026-02-12 05:17:07`, `2026-02-12 01:45:43`, `2026-02-11 20:52:28`, `2026-02-11 19:23:19`, `2026-02-11 11:12:50`, `2026-02-11 02:07:17`, `2026-02-11 01:35:18`
22	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
23	`assistant_team_id`	integer	`assistant_team_id`	助教所属团队 ID	枚举值: `2792011585884037`, `2959085810992645`
24	`assistant_level`	integer	`assistant_level`	助教等级名称，与 assistant_level 一一对应（初级/中级/高级/助教管理）	枚举值: `20`, `10`, `40`, `30`
25	`ledger_start_time`	string	`ledger_start_time`	台账层面记录的开始时间	枚举值: `2026-02-12 21:15:08`, `2026-02-12 00:07:00`, `2026-02-11 21:30:41`, `2026-02-11 19:32:32`, `2026-02-11 17:14:22`, `2026-02-10 20:58:18`, `2026-02-10 18:38:59`, `2026-02-10 21:44:36`
26	`ledger_end_time`	string	`ledger_end_time`	台账层面的结束时间	枚举值: `2026-02-13 03:14:14`, `2026-02-12 05:10:40`, `2026-02-12 01:41:02`, `2026-02-11 20:50:34`, `2026-02-11 19:22:59`, `2026-02-11 10:12:32`, `2026-02-10 19:58:33`, `2026-02-10 22:05:00`
27	`is_single_order`	integer	`is_single_order`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `1`
28	`order_assistant_id`	integer	`order_assistant_id`	订单中“助教项目明细”的内部 ID	枚举值: `3092265482209605`, `3091018857580869`, `3090865193781509`, `3090749033924741`, `3090613220428101`, `3089417770093893`, `3089280814894277`, `3089463294922117`
29	`site_assistant_id`	integer	`site_assistant_id`	门店维度的助教 ID	枚举值: `2793493699088517`, `2861304461364293`, `2964673443302213`, `2793530479530053`, `2964640248745157`, `2964641017858885`, `2840060593686213`, `2793532503855173`
30	`order_assistant_type`	integer	`order_assistant_type`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `2`
31	`ledger_status`	integer	`ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
32	`site_table_id`	integer	`site_table_id`	球台 ID	枚举值: `2956248279567557`, `2793020955840645`, `2793017278582917`, `2793020259897413`, `2793022937911365`, `2793018776735877`, `2793023960731717`, `2791964216463493`
33	`projected_income`	number	`projected_income`	实际结算计入门店的金额（已经考虑折扣、卡权益、券等后的结果）	枚举值: `538.5`, `454.5`, `333.33`, `104.0`, `170.67`, `1191.0`, `105.33`, `26.67`
34	`is_not_responding`	integer	`is_not_responding`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `0`
35	`income_seconds`	integer	`income_seconds`	计费秒数 / 应计收入对应的时间	枚举值: `21540`, `18180`, `15000`, `4680`, `7680`, `47640`, `4740`, `1200`
36	`user_id`	integer	`user_id`	助教对应的“用户账号 ID”（系统级用户）	枚举值: `2793493698596997`, `2861304460905541`, `2643377426450373`, `2793530479054917`, `2964640248253637`, `2964641017334597`, `2840060593211077`, `2793532503380037`
37	`trash_applicant_id`	integer	`trash_applicant_id`	提出废除申请的员工 ID（通常是操作员/管理员）	示例: `0`
38	`trash_applicant_name`	string	`trash_applicant_name`	废除申请人姓名
39	`is_trash`	integer	`is_trash`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `0`
40	`trash_reason`	string	`trash_reason`	废除原因（文本说明），例如“顾客取消”“录入错误”等
41	`real_use_seconds`	integer	`real_use_seconds`	实际使用时长（秒）	枚举值: `21544`, `18220`, `15021`, `4683`, `7718`, `47652`, `4774`, `1224`
42	`real_service_money`	number	`real_service_money`	实际服务费金额	示例: `0.0`
43	`add_clock`	integer	`add_clock`	加钟秒数，即在原有预约/服务基础上临时追加的时长	枚举值: `0`, `2820`, `13380`, `14400`
44	`returns_clock`	integer	`returns_clock`	退钟秒数（取消加钟或提前结束退回的时间）	示例: `0`
45	`is_confirm`	integer	`is_confirm`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `2`
46	`member_discount_amount`	number	`member_discount_amount`	由会员卡折扣产生的优惠金额	示例: `0.0`
47	`manual_discount_amount`	number	`manual_discount_amount`	收银员手动给予的减免金额（人工改价）	示例: `0.0`
48	`service_money`	number	`service_money`	用于记录与助教结算的金额（平台预留的“成本/分成”字段）	示例: `0.0`
49	`person_org_id`	integer	`person_org_id`	助教所属“人事组织/部门 ID”	枚举值: `2793493698990213`, `2861304461265989`, `2964673443203909`, `2793530479431749`, `2964640248630469`, `2964641017760581`, `2840060593587909`, `2793532503756869`
50	`last_use_time`	string	`last_use_time`	最后一次使用（实际服务）时间	枚举值: `2026-02-13 03:14:14`, `2026-02-12 05:10:40`, `2026-02-12 01:41:02`, `2026-02-11 20:50:35`, `2026-02-11 19:23:00`, `2026-02-11 10:12:32`, `2026-02-10 19:58:33`, `2026-02-10 22:05:00`
51	`salesman_name`	string	`salesman_name`	关联的“营业员/销售员姓名”，用于提成归属
52	`salesman_user_id`	integer	`salesman_user_id`	营业员用户 ID	示例: `0`
53	`salesman_org_id`	integer	`salesman_org_id`	营业员所属组织/部门 ID	示例: `0`
54	`coupon_deduct_money`	number	`coupon_deduct_money`	由“优惠券/代金券/团购券”等直接抵扣到这条助教服务上的金额	示例: `0.0`
55	`skill_id`	integer	`skill_id`	助教服务“课程/技能”ID	枚举值: `2790683529513797`, `2790683529513798`, `3039912271463941`
56	`start_use_time`	string	`start_use_time`	助教实际开始服务时间	枚举值: `2026-02-12 21:15:08`, `2026-02-12 00:07:00`, `2026-02-11 21:30:41`, `2026-02-11 19:32:32`, `2026-02-11 17:14:22`, `2026-02-10 20:58:18`, `2026-02-10 18:38:59`, `2026-02-10 21:44:36`
57	`tenant_member_id`	integer	`tenant_member_id`	商户维度会员 ID（门店/品牌内的会员主键）	枚举值: `2799207522600709`, `2799207359858437`, `2799207363643141`, `0`, `2969257129938053`, `3048238811858693`, `2799207124305669`, `2799207406946053`
58	`system_member_id`	integer	`system_member_id`	系统级会员 ID（全集团统一 ID）	枚举值: `2799207521568517`, `2799207358777093`, `2485293902352645`, `0`, `2644610908900421`, `3048238810220293`, `2799207123224325`, `2799207405995781`
59	`skill_grade`	integer	`skill_grade`	顾客对“技能表现”的评分（整数或打分等级）	示例: `0`
60	`service_grade`	integer	`service_grade`	顾客对“服务态度”的评分	示例: `0`
61	`composite_grade`	number	`composite_grade`	综合评分（例如技能+服务加权后的平均分），当前数据没有实际评分	示例: `0.0`
62	`sum_grade`	number	`sum_grade`	累计评分总和（可能用于计算平均分），当前为 0	示例: `0.0`
63	`get_grade_times`	integer	`get_grade_times`	该条记录对应的评价次数（或该助教被评价次数快照）	示例: `0`
64	`grade_status`	integer	`grade_status`	1 = 未评价/正常	示例: `1`
65	`composite_grade_time`	string	`composite_grade_time`	助教服务所在的球台名称（如 "A17"、"S1"）	示例: `0001-01-01 00:00:00`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.assistant_service_records 🔗 API

共 71 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_assistant_service_log.assistant_service_id`, `dwd_assistant_service_log_ex.assistant_service_id`	本条助教流水记录的主键 ID（流水唯一标识）
2	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_assistant_service_log.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dwd_assistant_service_log.site_id`	门店 ID，本数据中指“朗朗桌球”这一家门店
4	`siteprofile`	jsonb	—	—	（待补充）
5	`site_table_id`	bigint	`site_table_id`	`dwd_assistant_service_log.site_table_id`	球台 ID
6	`order_settle_id`	bigint	`order_settle_id`	`dwd_assistant_service_log.order_settle_id`	订单结算 ID，相当于“结账单号”的内部主键
7	`order_trade_no`	text	`order_trade_no`	`dwd_assistant_service_log.order_trade_no`	订单交易号，整个订单层面的编号
8	`order_pay_id`	bigint	`order_pay_id`	`dwd_assistant_service_log.order_pay_id`	关联到“支付记录”的主键 ID
9	`order_assistant_id`	bigint	`order_assistant_id`	`dwd_assistant_service_log.order_assistant_id`	订单中“助教项目明细”的内部 ID
10	`order_assistant_type`	integer	`order_assistant_type`	`dwd_assistant_service_log.order_assistant_type`	来自 JSON 导出的原始字段，用于保留业务取值
11	`assistantname`	text	`assistantName`	`dwd_assistant_service_log_ex.assistant_name`	（待补充）
12	`assistantno`	text	`assistantNo`	`dwd_assistant_service_log.assistant_no`	（待补充）
13	`assistant_level`	text	`assistant_level`	`dwd_assistant_service_log.assistant_level`	助教等级名称，与 assistant_level 一一对应（初级/中级/高级/助教管理）
14	`levelname`	text	`levelName`	`dwd_assistant_service_log.level_name`	名称字段，用于展示与辅助识别
15	`site_assistant_id`	bigint	`site_assistant_id`	`dwd_assistant_service_log.site_assistant_id`	门店维度的助教 ID
16	`skill_id`	bigint	`skill_id`	`dwd_assistant_service_log.skill_id`	助教服务“课程/技能”ID
17	`skillname`	text	`skillName`	`dwd_assistant_service_log.skill_name`	名称字段，用于展示与辅助识别
18	`system_member_id`	bigint	`system_member_id`	`dwd_assistant_service_log.system_member_id`	系统级会员 ID（全集团统一 ID）
19	`tablename`	text	`tableName`	`dwd_assistant_service_log_ex.table_name`	名称字段，用于展示与辅助识别
20	`tenant_member_id`	bigint	`tenant_member_id`	`dwd_assistant_service_log.tenant_member_id`	商户维度会员 ID（门店/品牌内的会员主键）
21	`user_id`	bigint	`user_id`	`dwd_assistant_service_log.user_id`	助教对应的“用户账号 ID”（系统级用户）
22	`assistant_team_id`	bigint	`assistant_team_id`	`dwd_assistant_service_log.assistant_team_id`	助教所属团队 ID
23	`nickname`	text	`nickname`	`dwd_assistant_service_log.nickname`	助教对外昵称，如“佳怡”“周周”“球球”等
24	`ledger_name`	text	`ledger_name`	`dwd_assistant_service_log_ex.ledger_name`	名称字段，用于展示与辅助识别
25	`ledger_group_name`	text	`ledger_group_name`	`dwd_assistant_service_log_ex.ledger_group_name`	助教项目所属的“计费分组/套餐分组名称”，例如某种助教套餐或业务组名称
26	`ledger_amount`	numeric	`ledger_amount`	`dwd_assistant_service_log.ledger_amount`	按标准单价计算出来的应收金额（近似 = ledger_unit_price × income_seconds / ...
27	`ledger_count`	numeric	`ledger_count`	`dwd_assistant_service_log_ex.ledger_count`	台账记录的计时总秒数
28	`ledger_unit_price`	numeric	`ledger_unit_price`	`dwd_assistant_service_log.ledger_unit_price`	助教服务标准单价（通常是标价：每小时、每节课的单价）
29	`ledger_status`	integer	`ledger_status`	`dwd_assistant_service_log_ex.ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值
30	`ledger_start_time`	timestamp without time zone	`ledger_start_time`	`dwd_assistant_service_log_ex.ledger_start_time`	台账层面记录的开始时间
31	`ledger_end_time`	timestamp without time zone	`ledger_end_time`	`dwd_assistant_service_log_ex.ledger_end_time`	台账层面的结束时间
32	`manual_discount_amount`	numeric	`manual_discount_amount`	`dwd_assistant_service_log_ex.manual_discount_amount`	收银员手动给予的减免金额（人工改价）
33	`member_discount_amount`	numeric	`member_discount_amount`	`dwd_assistant_service_log_ex.member_discount_amount`	由会员卡折扣产生的优惠金额
34	`coupon_deduct_money`	numeric	`coupon_deduct_money`	`dwd_assistant_service_log.coupon_deduct_money`	由“优惠券/代金券/团购券”等直接抵扣到这条助教服务上的金额
35	`service_money`	numeric	`service_money`	`dwd_assistant_service_log_ex.service_money`	用于记录与助教结算的金额（平台预留的“成本/分成”字段）
36	`projected_income`	numeric	`projected_income`	`dwd_assistant_service_log.projected_income`	实际结算计入门店的金额（已经考虑折扣、卡权益、券等后的结果）
37	`real_use_seconds`	integer	`real_use_seconds`	`dwd_assistant_service_log.real_use_seconds`	实际使用时长（秒）
38	`income_seconds`	integer	`income_seconds`	`dwd_assistant_service_log.income_seconds`	计费秒数 / 应计收入对应的时间
39	`start_use_time`	timestamp without time zone	`start_use_time`	`dwd_assistant_service_log.start_use_time`	助教实际开始服务时间
40	`last_use_time`	timestamp without time zone	`last_use_time`	`dwd_assistant_service_log.last_use_time`	最后一次使用（实际服务）时间
41	`create_time`	timestamp without time zone	`create_time`	`dwd_assistant_service_log.create_time`	这条助教流水记录创建时间（一般接近结算/下单时间）
42	`is_single_order`	integer	`is_single_order`	`dwd_assistant_service_log_ex.is_single_order`	布尔/开关字段，用于表示权限、可用性或状态开关
43	`is_delete`	integer	`is_delete`	`dwd_assistant_service_log.is_delete`	逻辑删除标志
44	`is_trash`	integer	`is_trash`	`dwd_assistant_service_log_ex.is_trash`	布尔/开关字段，用于表示权限、可用性或状态开关
45	`trash_reason`	text	`trash_reason`	`dwd_assistant_service_log_ex.trash_reason`	废除原因（文本说明），例如“顾客取消”“录入错误”等
46	`trash_applicant_id`	bigint	`trash_applicant_id`	`dwd_assistant_service_log_ex.trash_applicant_id`	提出废除申请的员工 ID（通常是操作员/管理员）
47	`trash_applicant_name`	text	`trash_applicant_name`	`dwd_assistant_service_log_ex.trash_applicant_name`	废除申请人姓名
48	`operator_id`	bigint	`operator_id`	`dwd_assistant_service_log_ex.operator_id`	操作员 ID（录入/结算这条助教服务的员工）
49	`operator_name`	text	`operator_name`	`dwd_assistant_service_log_ex.operator_name`	操作员姓名，与 operator_id 一起使用，便于直接阅读
50	`salesman_name`	text	`salesman_name`	`dwd_assistant_service_log_ex.salesman_name`	关联的“营业员/销售员姓名”，用于提成归属
51	`salesman_org_id`	bigint	`salesman_org_id`	`dwd_assistant_service_log_ex.salesman_org_id`	营业员所属组织/部门 ID
52	`salesman_user_id`	bigint	`salesman_user_id`	`dwd_assistant_service_log_ex.salesman_user_id`	营业员用户 ID
53	`person_org_id`	bigint	`person_org_id`	`dwd_assistant_service_log.person_org_id`	助教所属“人事组织/部门 ID”
54	`add_clock`	integer	`add_clock`	`dwd_assistant_service_log.add_clock`	加钟秒数，即在原有预约/服务基础上临时追加的时长
55	`returns_clock`	integer	`returns_clock`	`dwd_assistant_service_log_ex.returns_clock`	退钟秒数（取消加钟或提前结束退回的时间）
56	`composite_grade`	numeric	`composite_grade`	`dwd_assistant_service_log_ex.composite_grade`	综合评分（例如技能+服务加权后的平均分），当前数据没有实际评分
57	`composite_grade_time`	timestamp without time zone	`composite_grade_time`	`dwd_assistant_service_log_ex.composite_grade_time`	助教服务所在的球台名称（如 "A17"、"S1"）
58	`skill_grade`	numeric	`skill_grade`	`dwd_assistant_service_log_ex.skill_grade`	顾客对“技能表现”的评分（整数或打分等级）
59	`service_grade`	numeric	`service_grade`	`dwd_assistant_service_log_ex.service_grade`	顾客对“服务态度”的评分
60	`sum_grade`	numeric	`sum_grade`	`dwd_assistant_service_log_ex.sum_grade`	累计评分总和（可能用于计算平均分），当前为 0
61	`grade_status`	integer	`grade_status`	`dwd_assistant_service_log_ex.grade_status`	1 = 未评价/正常
62	`get_grade_times`	integer	`get_grade_times`	`dwd_assistant_service_log_ex.get_grade_times`	该条记录对应的评价次数（或该助教被评价次数快照）
63	`is_not_responding`	integer	`is_not_responding`	`dwd_assistant_service_log_ex.is_not_responding`	布尔/开关字段，用于表示权限、可用性或状态开关
64	`is_confirm`	integer	`is_confirm`	`dwd_assistant_service_log_ex.is_confirm`	布尔/开关字段，用于表示权限、可用性或状态开关
65	`assistantteamname`	text	`assistantTeamName`	`dwd_assistant_service_log_ex.assistant_team_name`	助教团队名称
66	`real_service_money`	numeric	`real_service_money`	`dwd_assistant_service_log.real_service_money`	实际服务费金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dwd_assistant_service_log 🔗 ODS

共 33 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_service_id`	bigint	`id`	直接	服务流水 ID
2	`order_trade_no`	bigint	`order_trade_no`	直接	订单号 → dwd_settlement_head
3	`order_settle_id`	bigint	`order_settle_id`	直接	结账单 ID → dwd_settlement_head
4	`order_pay_id`	bigint	`order_pay_id`	直接	支付单 ID（当前数据全为 0）
5	`order_assistant_id`	bigint	`order_assistant_id`	直接	订单助教 ID
6	`order_assistant_type`	integer	`order_assistant_type`	直接	服务类型。枚举值: 1=基础课或包厢课, 2=附加课/激励课
7	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
8	`site_id`	bigint	`site_id`	直接	门店 ID
9	`site_table_id`	bigint	`site_table_id`	直接	台桌 ID → dim_table（0=非台桌服务）
10	`tenant_member_id`	bigint	`tenant_member_id`	直接	会员 ID → dim_member（0=散客）
11	`system_member_id`	bigint	`system_member_id`	直接	系统会员 ID（0=散客）
12	`assistant_no`	character varying	`assistantno`	直接	助教工号。样本值: "2", "9"等
13	`nickname`	character varying	`nickname`	直接	助教昵称。样本值: "佳怡", "婉婉", "七七"等
14	`site_assistant_id`	bigint	`site_assistant_id`	直接	助教 ID → dim_assistant
15	`user_id`	bigint	`user_id`	直接	助教用户 ID
16	`assistant_team_id`	bigint	`assistant_team_id`	直接	助教团队 ID。枚举值: 2792011585884037=1组, 2959085810992645=2组
17	`person_org_id`	bigint	`person_org_id`	直接	人事组织 ID
18	`assistant_level`	integer	`assistant_level`	直接	助教等级。枚举值: 8=助教管理, 10=初级, 20=中级, 30=高级, 40=星级
19	`level_name`	character varying	`levelname`	直接	等级名称。枚举值: "助教管理", "初级", "中级", "高级", "星级"
20	`skill_id`	bigint	`skill_id`	直接	技能 ID 枚举值: 2790683529513797 = 基础课 , 2790683529513798...
21	`skill_name`	character varying	`skillname`	直接	技能名称。枚举值: "基础课","附加课","包厢课"
22	`ledger_unit_price`	numeric	`ledger_unit_price`	直接	单价（元/小时），样本值: 98.00/108.00/190.00 等
23	`ledger_amount`	numeric	`ledger_amount`	直接	计费金额
24	`projected_income`	numeric	`projected_income`	直接	预估收入
25	`coupon_deduct_money`	numeric	`coupon_deduct_money`	直接	券抵扣金额
26	`income_seconds`	integer	`income_seconds`	直接	计费时长（秒）。常见值: 3600=1h, 7200=2h, 10800=3h
27	`real_use_seconds`	integer	`real_use_seconds`	直接	实际使用时长（秒）
28	`add_clock`	integer	`add_clock`	直接	加时时长（秒），大多为 0
29	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
30	`start_use_time`	timestamp with time zone	`start_use_time`	直接	服务开始时间
31	`last_use_time`	timestamp with time zone	`last_use_time`	直接	服务结束时间
32	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
33	`real_service_money`	numeric	`real_service_money`	直接	实际服务费金额

DWD 表结构 — dwd.dwd_assistant_service_log_ex 🔗 ODS

共 33 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_service_id`	bigint	`id`	直接	字段重命名
2	`table_name`	character varying	`tablename`	直接	字段重命名
3	`assistant_name`	character varying	`assistantname`	直接	字段重命名
4	`ledger_name`	character varying	`ledger_name`	直接	同名直传
5	`ledger_group_name`	character varying	`ledger_group_name`	直接	名称字段，用于展示与辅助识别
6	`ledger_count`	integer	`ledger_count`	直接	同名直传
7	`member_discount_amount`	numeric	`member_discount_amount`	直接	同名直传
8	`manual_discount_amount`	numeric	`manual_discount_amount`	直接	同名直传
9	`service_money`	numeric	`service_money`	直接	同名直传
10	`returns_clock`	integer	`returns_clock`	直接	同名直传
11	`ledger_start_time`	timestamp with time zone	`ledger_start_time`	直接	同名直传
12	`ledger_end_time`	timestamp with time zone	`ledger_end_time`	直接	同名直传
13	`ledger_status`	integer	`ledger_status`	直接	同名直传
14	`is_confirm`	integer	`is_confirm`	直接	同名直传
15	`is_single_order`	integer	`is_single_order`	直接	同名直传
16	`is_not_responding`	integer	`is_not_responding`	直接	同名直传
17	`is_trash`	integer	`is_trash`	直接	同名直传
18	`trash_applicant_id`	bigint	`trash_applicant_id`	直接	同名直传
19	`trash_applicant_name`	character varying	`trash_applicant_name`	直接	名称字段，用于展示与辅助识别
20	`trash_reason`	character varying	`trash_reason`	直接	明细字段，用于记录事实取值
21	`salesman_user_id`	bigint	`salesman_user_id`	直接	同名直传
22	`salesman_name`	character varying	`salesman_name`	直接	名称字段，用于展示与辅助识别
23	`salesman_org_id`	bigint	`salesman_org_id`	直接	同名直传
24	`skill_grade`	integer	`skill_grade`	直接	同名直传
25	`service_grade`	integer	`service_grade`	直接	同名直传
26	`composite_grade`	numeric	`composite_grade`	直接	同名直传
27	`sum_grade`	numeric	`sum_grade`	直接	同名直传
28	`get_grade_times`	integer	`get_grade_times`	直接	同名直传
29	`grade_status`	integer	`grade_status`	直接	同名直传
30	`composite_grade_time`	timestamp with time zone	`composite_grade_time`	直接	同名直传
31	`assistant_team_name`	text	`assistantteamname`	直接	字段重命名
32	`operator_id`	bigint	`operator_id`	直接	操作员 ID，录入/结算这条助教服务的员工
33	`operator_name`	text	`operator_name`	直接	操作员姓名（带职位前缀），与 operator_id 一起使用，便于直接阅读

3.5 assistant_cancellation_records（助教废除记录）

任务代码：ODS_ASSISTANT_ABOLISH
采样记录数：78
API JSON 字段数：38
ODS 列数：19
DWD 目标表：dwd_assistant_trash_event, dwd_assistant_trash_event_ex

API 源字段 — assistant_cancellation_records 🔗 ODS

已映射 14/38，覆盖率 36.8% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`createTime`	string	`createtime`	（待补充）	大小写匹配；枚举值: `2026-01-29 02:47:00`, `2026-01-28 02:19:55`, `2026-01-25 00:27:57`, `2026-01-22 08:15:32`, `2026-01-21 19:20:48`, `2026-01-18 03:55:40`, `2026-01-16 22:13:16`, `2026-01-15 19:40:27`
2	`id`	integer	`id`	本表主键 ID，用于唯一标识一条记录	枚举值: `3071358041819077`, `3069915840121925`, `3065559038266181`, `3061771962043973`, `3061771960880709`, `3061771962486341`, `3061771963567685`, `3061010362977861`
3	`siteId`	integer	`siteid`	（待补充）	大小写匹配；示例: `2790685415443269`
4	`tableAreaId`	integer	`tableareaid`	（待补充）	大小写匹配；枚举值: `2791963887030341`, `2956246442462533`, `2791963794329671`, `2791963816579205`, `2942056024575749`, `2791963855982661`, `2791963825803397`, `2791963836207173`
5	`tableId`	integer	`tableid`	（待补充）	大小写匹配；枚举值: `2793023960600645`, `2793023960682565`, `2793023960551493`, `2956248279567557`, `2793003806953541`, `2793017278632069`, `2942056832061125`, `2793022145302597`
6	`tableArea`	string	`tablearea`	（待补充）	大小写匹配；枚举值: `麻将房`, `发财`, `A区`, `C区`, `M7`, `K包`, `VIP包厢`, `斯诺克区`
7	`tableName`	string	`tablename`	（待补充）	大小写匹配；枚举值: `M2`, `M4`, `Ｍ1`, `发财`, `A18`, `C6`, `M7`, `888`
8	`assistantOn`	string	`assistanton`	（待补充）	大小写匹配；枚举值: `6`, `15`, `4`, `18`, `23`, `9`, `21`, `2`
9	`assistantName`	string	`assistantname`	（待补充）	大小写匹配；枚举值: `乔西`, `七七`, `璇子`, `涛涛`, `婉婉`, `球球`, `年糕`, `佳怡`
10	`pdChargeMinutes`	integer	`pdchargeminutes`	（待补充）	大小写匹配；枚举值: `3600`, `3390`, `0`, `4959`, `10800`, `27791`, `555`, `364`
11	`assistantAbolishAmount`	number	`assistantabolishamount`	（待补充）	大小写匹配；枚举值: `190.0`, `101.7`, `0.0`, `190.1`, `570.0`, `833.73`, `15.11`, `10.92`
12	`trashReason`	string	`trashreason`	（待补充）	大小写匹配

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.assistant_cancellation_records 🔗 API

共 19 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_assistant_trash_event.assistant_trash_event_id`, `dwd_assistant_trash_event_ex.assistant_trash_event_id`	本表主键 ID，用于唯一标识一条记录
2	`siteid`	bigint	`siteId`	`dwd_assistant_trash_event.site_id`	（待补充）
3	`siteprofile`	jsonb	—	—	（待补充）
4	`assistantname`	text	`assistantName`	`dwd_assistant_trash_event.assistant_name`	（待补充）
5	`assistantabolishamount`	numeric	`assistantAbolishAmount`	`dwd_assistant_trash_event.abolish_amount`	（待补充）
6	`assistanton`	integer	`assistantOn`	`dwd_assistant_trash_event.assistant_no`, `dwd_assistant_trash_event_ex.assistant_no_int`	（待补充）
7	`pdchargeminutes`	integer	`pdChargeMinutes`	`dwd_assistant_trash_event.charge_minutes_raw`	（待补充）
8	`tableareaid`	bigint	`tableAreaId`	`dwd_assistant_trash_event.table_area_id`	（待补充）
9	`tablearea`	text	`tableArea`	`dwd_assistant_trash_event_ex.table_area_name`	（待补充）
10	`tableid`	bigint	`tableId`	`dwd_assistant_trash_event.table_id`	（待补充）
11	`tablename`	text	`tableName`	`dwd_assistant_trash_event_ex.table_name`	（待补充）
12	`trashreason`	text	`trashReason`	`dwd_assistant_trash_event.trash_reason`	（待补充）
13	`createtime`	timestamp without time zone	`createTime`	`dwd_assistant_trash_event.create_time`	（待补充）
14	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_assistant_trash_event.tenant_id`	租户ID

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_assistant_trash_event 🔗 ODS

共 11 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_trash_event_id`	bigint	`id`	直接	作废事件 ID
2	`site_id`	bigint	`siteid`	直接	门店 ID
3	`table_id`	bigint	`tableid`	直接	台桌 ID → dim_table
4	`table_area_id`	bigint	`tableareaid`	直接	台区 ID
5	`assistant_no`	character varying	`assistanton`	直接	助教工号/昵称。样本值: "七七", "乔西", "球球"等
6	`assistant_name`	character varying	`assistantname`	直接	助教名称，与 assistant_no 相同
7	`charge_minutes_raw`	integer	`pdchargeminutes`	直接	原计费时长（秒）。样本值: 0, 3600=1h, 10800=3h 等
8	`abolish_amount`	numeric	`assistantabolishamount`	直接	作废金额（元）。样本值: 0.00, 190.00, 570.00 等
9	`trash_reason`	character varying	`trashreason`	直接	作废原因（当前数据全为 NULL）
10	`create_time`	timestamp with time zone	`createtime`	直接	创建时间
11	`tenant_id`	bigint	`tenant_id`	直接	租户 ID

DWD 表结构 — dwd.dwd_assistant_trash_event_ex 🔗 ODS

共 4 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`assistant_trash_event_id`	bigint	`id`	直接	字段重命名
2	`table_name`	character varying	`tablename`	直接	字段重命名
3	`table_area_name`	character varying	`tablearea`	直接	字段重命名
4	`assistant_no_int`	integer	`assistanton`	直接	字段重命名

3.6 store_goods_sales_records（门店商品销售流水）

任务代码：ODS_STORE_GOODS_SALES
采样记录数：200
API JSON 字段数：51
ODS 列数：56
DWD 目标表：dwd_store_goods_sale, dwd_store_goods_sale_ex

API 源字段 — store_goods_sales_records 🔗 ODS

已映射 51/51，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`siteId`	integer	`siteid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
2	`siteName`	string	`sitename`	名称字段，用于展示与辅助识别	大小写匹配；示例: `朗朗桌球`
3	`orderGoodsId`	integer	`ordergoodsid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
4	`openSalesman`	integer	`opensalesman`	（待补充）	大小写匹配；示例: `2`
5	`id`	integer	`id`	本条「门店销售流水」记录的主键 ID	枚举值: `3093864106133701`, `3093855577688325`, `3093844121422150`, `3093844121422149`, `3093844121405766`, `3093844121405765`, `3093844121389382`, `3093844121389381`
6	`cost_money`	number	`cost_money`	本条销售对应的成本金额（以元计）	枚举值: `0.0`, `0.13`, `0.04`, `0.63`, `0.01`, `0.02`
7	`coupon_deduct_money`	number	`coupon_deduct_money`	被优惠券 / 团购券直接抵扣到这条商品明细上的金额	示例: `0.0`
8	`coupon_share_money`	number	`coupon_share_money`	优惠券分摊金额	示例: `0.0`
9	`create_time`	string	`create_time`	销售记录创建时间，通常就是结账时间或录入时间	枚举值: `2026-02-14 00:21:21`, `2026-02-14 00:12:40`, `2026-02-14 00:01:01`, `2026-02-13 21:56:07`, `2026-02-13 21:50:13`, `2026-02-13 20:43:53`, `2026-02-13 20:42:32`, `2026-02-13 20:35:39`
10	`discount_money`	number	`discount_money`	本条销售明细的「价格优惠金额」，即原价部分被减免掉的金额	枚举值: `3.0`, `0.0`, `2.0`, `6.0`, `8.0`, `1.0`
11	`discount_price`	number	`discount_price`	折后单价（元/单位）	枚举值: `7.0`, `5.0`, `15.0`, `2.0`, `28.0`, `125.0`, `8.0`, `10.0`
12	`goods_remark`	string	`goods_remark`	商品备注/口味说明/特殊说明	枚举值: `可乐`, `哇哈哈矿泉水`, `百威235毫升`, `打火机`, `软玉溪`, `东鹏特饮`, `普通扑克`, `雪碧`
13	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
14	`is_single_order`	integer	`is_single_order`	是否单独订单标识	示例: `1`
15	`ledger_amount`	number	`ledger_amount`	原始应收金额，公式上接近 ledger_unit_price × ledger_count	枚举值: `10.0`, `5.0`, `90.0`, `2.0`, `28.0`, `7.0`, `180.0`, `125.0`
16	`ledger_count`	integer	`ledger_count`	销售数量（以 unit 为单位，unit 字段在门店商品档案中）	枚举值: `1`, `2`, `6`, `12`, `4`, `3`, `5`
17	`ledger_group_name`	string	`ledger_group_name`	销售项目所属的「门店内部分组名称」，类似前台菜单分组或大类标签	枚举值: `酒水`, `其他`, `香烟`, `零食`
18	`ledger_name`	string	`ledger_name`	销售项目名称（商品名称），例如 “哇哈哈矿泉水”“地道肠”“东方树叶”等	枚举值: `哇米诺豆奶`, `可乐`, `哇哈哈矿泉水`, `百威235毫升`, `打火机`, `软玉溪`, `东鹏特饮`, `普通扑克`
19	`ledger_status`	integer	`ledger_status`	销售流水状态	示例: `1`
20	`ledger_unit_price`	number	`ledger_unit_price`	商品在该次销售中的「结算单价」（元/单位）	枚举值: `10.0`, `5.0`, `15.0`, `2.0`, `28.0`, `7.0`, `125.0`, `8.0`
21	`member_coupon_id`	integer	`member_coupon_id`	会员券 ID（比如会员专享优惠券）	示例: `0`
22	`member_discount_amount`	number	`member_discount_amount`	由会员身份（会员折扣）针对这一行商品产生的优惠金额	示例: `0.0`
23	`operator_id`	integer	`operator_id`	操作员 ID（录入这笔销售的员工）	示例: `2790687322443013`
24	`operator_name`	string	`operator_name`	操作员姓名，文字冗余	示例: `收银员:郑丽珊`
25	`option_coupon_deduct_money`	number	`option_coupon_deduct_money`	由优惠券抵扣“选项价格”的金额	示例: `0.0`
26	`option_member_discount_money`	number	`option_member_discount_money`	由会员折扣作用在“选项价格”上的优惠金额	示例: `0.0`
27	`option_price`	number	`option_price`	商品选项（规格/加料）的附加价格	示例: `0.0`
28	`option_value_name`	string	`option_value_name`	商品选项名称（如规格、口味：大杯/小杯，不加冰等）
29	`order_coupon_id`	integer	`order_coupon_id`	订单级优惠券 ID	示例: `0`
30	`order_goods_id`	integer	`order_goods_id`	订单商品明细 ID（订单内部的商品行主键）	枚举值: `3093864075495621`, `3093793750862149`, `3093838483065157`, `3093746072144197`, `3093710576814405`, `3093707437050181`, `3093706719037573`, `3093703198656709`
31	`order_pay_id`	integer	`order_pay_id`	关联支付记录的 ID	示例: `0`
32	`order_settle_id`	integer	`order_settle_id`	订单结算 ID（结账单主键）	枚举值: `3093864077166789`, `3093855537596549`, `3093843703564549`, `3093721299536133`, `3093715499501701`, `3093650242373957`, `3093648911108293`, `3093642206103749`
33	`order_trade_no`	integer	`order_trade_no`	订单交易号（业务单号）	枚举值: `3093864074381509`, `3093784062036101`, `3093701555882181`, `3093324364122309`, `3093592572217541`, `3093650239260997`, `3093530699761989`, `3093642203187397`
34	`package_coupon_id`	integer	`package_coupon_id`	套餐券 ID	示例: `0`
35	`point_discount_money`	number	`point_discount_money`	由积分抵扣的金额（顾客兑换积分抵现金额）	示例: `0.0`
36	`point_discount_money_cost`	number	`point_discount_money_cost`	积分抵扣对应的“成本金额”（后台核算用），例如按积分成本来计提费用	示例: `0.0`
37	`push_money`	number	`push_money`	本条销售对应的提成金额（给营业员/促销员的提成）	示例: `0.0`
38	`real_goods_money`	number	`real_goods_money`	商品实际入账金额（考虑折扣、可能还会考虑其它抵扣后的实际销售金额）	枚举值: `7.0`, `10.0`, `5.0`, `90.0`, `2.0`, `28.0`, `180.0`, `125.0`
39	`returns_number`	integer	`returns_number`	退货数量（如果这条明细做了退货，会记录退货数量）	示例: `0`
40	`sales_man_org_id`	integer	`sales_man_org_id`	营业员所属组织/部门 ID	示例: `0`
41	`sales_type`	integer	`sales_type`	销售类型	示例: `1`
42	`salesman_name`	string	`salesman_name`	营业员姓名（如果有为具体销售员记业绩，则在此填姓名）
43	`salesman_role_id`	integer	`salesman_role_id`	营业员的系统角色 ID（例如某个角色代码表示“销售员”）	示例: `0`
44	`salesman_user_id`	integer	`salesman_user_id`	营业员用户 ID（系统账号 ID）	示例: `0`
45	`site_goods_id`	integer	`site_goods_id`	门店商品 ID	枚举值: `3004536125639493`, `2793026183041093`, `2793026176012357`, `2793026185154629`, `2828836772432837`, `2793025862799429`, `2793026180501573`, `2794695801409669`
46	`site_id`	integer	`site_id`	门店 ID（系统主键）	示例: `2790685415443269`
47	`site_table_id`	integer	`site_table_id`	球台 ID	枚举值: `0`, `2793001904918661`, `2793022937911365`, `2793022145302597`, `2793020259897413`, `2793016660660357`, `2793003066429509`, `2793001695301765`
48	`tenant_goods_business_id`	integer	`tenant_goods_business_id`	租户级商品「业务大类」ID（例如“零食类”“酒水类”等更高维度）	枚举值: `2790683528317768`, `2793217599407941`, `2790683528317765`, `2791932037238661`
49	`tenant_goods_category_id`	integer	`tenant_goods_category_id`	租户级商品一级分类 ID	枚举值: `2790683528350540`, `2790683528350541`, `2793218343257925`, `2792063209623429`, `2793236829620037`, `2791948300259205`
50	`tenant_goods_id`	integer	`tenant_goods_id`	租户（品牌）级商品 ID（全局商品 ID）	枚举值: `3004531315313413`, `2792138158329733`, `2792115932417925`, `2792039804047237`, `2828836270377733`, `2792102047797125`, `2792126853369733`, `2793228842862405`
51	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`

ODS 表结构 — ods.store_goods_sales_records 🔗 API

共 56 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dwd_store_goods_sale.store_goods_sale_id`, `dwd_store_goods_sale_ex.store_goods_sale_id`	本条「门店销售流水」记录的主键 ID
2	`tenant_id`	bigint	`tenant_id`	`dwd_store_goods_sale.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dwd_store_goods_sale.site_id`	门店 ID（系统主键）
4	`siteid`	bigint	`siteId`	`dwd_store_goods_sale_ex.legacy_site_id`	来自 JSON 导出的原始字段，用于保留业务取值
5	`sitename`	text	`siteName`	`dwd_store_goods_sale_ex.site_name`	名称字段，用于展示与辅助识别
6	`site_goods_id`	bigint	`site_goods_id`	`dwd_store_goods_sale.site_goods_id`	门店商品 ID
7	`tenant_goods_id`	bigint	`tenant_goods_id`	`dwd_store_goods_sale.tenant_goods_id`	租户（品牌）级商品 ID（全局商品 ID）
8	`order_settle_id`	bigint	`order_settle_id`	`dwd_store_goods_sale.order_settle_id`	订单结算 ID（结账单主键）
9	`order_trade_no`	text	`order_trade_no`	`dwd_store_goods_sale.order_trade_no`	订单交易号（业务单号）
10	`order_goods_id`	bigint	`order_goods_id`	`dwd_store_goods_sale.order_goods_id`	订单商品明细 ID（订单内部的商品行主键）
11	`ordergoodsid`	bigint	`orderGoodsId`	`dwd_store_goods_sale_ex.legacy_order_goods_id`	来自 JSON 导出的原始字段，用于保留业务取值
12	`order_pay_id`	bigint	`order_pay_id`	`dwd_store_goods_sale.order_pay_id`	关联支付记录的 ID
13	`order_coupon_id`	bigint	`order_coupon_id`	`dwd_store_goods_sale_ex.order_coupon_id`	订单级优惠券 ID
14	`ledger_name`	text	`ledger_name`	`dwd_store_goods_sale.ledger_name`	销售项目名称（商品名称），例如 “哇哈哈矿泉水”“地道肠”“东方树叶”等
15	`ledger_group_name`	text	`ledger_group_name`	`dwd_store_goods_sale.ledger_group_name`	销售项目所属的「门店内部分组名称」，类似前台菜单分组或大类标签
16	`ledger_amount`	numeric	`ledger_amount`	`dwd_store_goods_sale.ledger_amount`	原始应收金额，公式上接近 ledger_unit_price × ledger_count
17	`ledger_count`	numeric	`ledger_count`	`dwd_store_goods_sale.ledger_count`	销售数量（以 unit 为单位，unit 字段在门店商品档案中）
18	`ledger_unit_price`	numeric	`ledger_unit_price`	`dwd_store_goods_sale.ledger_unit_price`	商品在该次销售中的「结算单价」（元/单位）
19	`ledger_status`	integer	`ledger_status`	`dwd_store_goods_sale.ledger_status`	销售流水状态
20	`discount_money`	numeric	`discount_money`	`dwd_store_goods_sale.discount_money`, `dwd_store_goods_sale_ex.discount_money`	本条销售明细的「价格优惠金额」，即原价部分被减免掉的金额
21	`discount_price`	numeric	`discount_price`	`dwd_store_goods_sale.discount_price`	折后单价（元/单位）
22	`coupon_deduct_money`	numeric	`coupon_deduct_money`	`dwd_store_goods_sale_ex.coupon_deduct_money`	被优惠券 / 团购券直接抵扣到这条商品明细上的金额
23	`member_discount_amount`	numeric	`member_discount_amount`	`dwd_store_goods_sale_ex.member_discount_amount`	由会员身份（会员折扣）针对这一行商品产生的优惠金额
24	`option_coupon_deduct_money`	numeric	`option_coupon_deduct_money`	`dwd_store_goods_sale_ex.option_coupon_deduct_money`	由优惠券抵扣“选项价格”的金额
25	`option_member_discount_money`	numeric	`option_member_discount_money`	`dwd_store_goods_sale_ex.option_member_discount_money`	由会员折扣作用在“选项价格”上的优惠金额
26	`point_discount_money`	numeric	`point_discount_money`	`dwd_store_goods_sale_ex.point_discount_money`	由积分抵扣的金额（顾客兑换积分抵现金额）
27	`point_discount_money_cost`	numeric	`point_discount_money_cost`	`dwd_store_goods_sale_ex.point_discount_money_cost`	积分抵扣对应的“成本金额”（后台核算用），例如按积分成本来计提费用
28	`real_goods_money`	numeric	`real_goods_money`	`dwd_store_goods_sale.real_goods_money`	商品实际入账金额（考虑折扣、可能还会考虑其它抵扣后的实际销售金额）
29	`cost_money`	numeric	`cost_money`	`dwd_store_goods_sale.cost_money`	本条销售对应的成本金额（以元计）
30	`push_money`	numeric	`push_money`	`dwd_store_goods_sale_ex.push_money`	本条销售对应的提成金额（给营业员/促销员的提成）
31	`sales_type`	integer	`sales_type`	`dwd_store_goods_sale_ex.sales_type`	销售类型
32	`is_single_order`	integer	`is_single_order`	`dwd_store_goods_sale_ex.is_single_order`	是否单独订单标识
33	`is_delete`	integer	`is_delete`	`dwd_store_goods_sale.is_delete`	逻辑删除标志
34	`goods_remark`	text	`goods_remark`	`dwd_store_goods_sale_ex.goods_remark`	商品备注/口味说明/特殊说明
35	`option_price`	numeric	`option_price`	`dwd_store_goods_sale_ex.option_price`	商品选项（规格/加料）的附加价格
36	`option_value_name`	text	`option_value_name`	`dwd_store_goods_sale_ex.option_value_name`	商品选项名称（如规格、口味：大杯/小杯，不加冰等）
37	`member_coupon_id`	bigint	`member_coupon_id`	`dwd_store_goods_sale_ex.member_coupon_id`	会员券 ID（比如会员专享优惠券）
38	`package_coupon_id`	bigint	`package_coupon_id`	`dwd_store_goods_sale_ex.package_coupon_id`	套餐券 ID
39	`sales_man_org_id`	bigint	`sales_man_org_id`	`dwd_store_goods_sale_ex.salesman_org_id`	营业员所属组织/部门 ID
40	`salesman_name`	text	`salesman_name`	`dwd_store_goods_sale_ex.salesman_name`	营业员姓名（如果有为具体销售员记业绩，则在此填姓名）
41	`salesman_role_id`	bigint	`salesman_role_id`	`dwd_store_goods_sale_ex.salesman_role_id`	营业员的系统角色 ID（例如某个角色代码表示“销售员”）
42	`salesman_user_id`	bigint	`salesman_user_id`	`dwd_store_goods_sale_ex.salesman_user_id`	营业员用户 ID（系统账号 ID）
43	`operator_id`	bigint	`operator_id`	`dwd_store_goods_sale_ex.operator_id`	操作员 ID（录入这笔销售的员工）
44	`operator_name`	text	`operator_name`	`dwd_store_goods_sale_ex.operator_name`	操作员姓名，文字冗余
45	`opensalesman`	text	`openSalesman`	`dwd_store_goods_sale_ex.open_salesman_flag`	（待补充）
46	`returns_number`	integer	`returns_number`	`dwd_store_goods_sale_ex.returns_number`	退货数量（如果这条明细做了退货，会记录退货数量）
47	`site_table_id`	bigint	`site_table_id`	`dwd_store_goods_sale.site_table_id`	球台 ID
48	`tenant_goods_business_id`	bigint	`tenant_goods_business_id`	`dwd_store_goods_sale.tenant_goods_business_id`	租户级商品「业务大类」ID（例如“零食类”“酒水类”等更高维度）
49	`tenant_goods_category_id`	bigint	`tenant_goods_category_id`	`dwd_store_goods_sale.tenant_goods_category_id`	租户级商品一级分类 ID
50	`create_time`	timestamp without time zone	`create_time`	`dwd_store_goods_sale.create_time`	销售记录创建时间，通常就是结账时间或录入时间
51	`coupon_share_money`	numeric	`coupon_share_money`	`dwd_store_goods_sale.coupon_share_money`	优惠券分摊金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dwd_store_goods_sale 🔗 ODS

共 25 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`store_goods_sale_id`	bigint	`id`	直接	销售流水 ID
2	`order_trade_no`	bigint	`order_trade_no`	直接	订单号
3	`order_settle_id`	bigint	`order_settle_id`	直接	结账单 ID → dwd_settlement_head
4	`order_pay_id`	bigint	`order_pay_id`	直接	支付单 ID（当前数据全为 0）
5	`order_goods_id`	bigint	`order_goods_id`	直接	订单商品 ID（0=商城订单）
6	`site_id`	bigint	`site_id`	直接	门店 ID
7	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
8	`site_goods_id`	bigint	`site_goods_id`	直接	门店商品 ID → dim_store_goods
9	`tenant_goods_id`	bigint	`tenant_goods_id`	直接	租户商品 ID → dim_tenant_goods
10	`tenant_goods_category_id`	bigint	`tenant_goods_category_id`	直接	商品分类 ID
11	`tenant_goods_business_id`	bigint	`tenant_goods_business_id`	直接	业务大类 ID
12	`site_table_id`	bigint	`site_table_id`	直接	台桌 ID（0=商城订单，非台桌消费）
13	`ledger_name`	character varying	`ledger_name`	直接	商品名称。样本值: "哇哈哈矿泉水", "东方树叶", "可乐" 等
14	`ledger_group_name`	character varying	`ledger_group_name`	直接	商品分类。样本值: "酒水", "零食", "香烟" 等
15	`ledger_unit_price`	numeric	`ledger_unit_price`	直接	单价（元）
16	`ledger_count`	integer	`ledger_count`	直接	购买数量。样本值: 1, 2, 3, 4 等
17	`ledger_amount`	numeric	`ledger_amount`	直接	销售金额（元）
18	`discount_money`	numeric	`discount_money`	直接	折扣金额，即原价被减免的金额部分
19	`real_goods_money`	numeric	`real_goods_money`	直接	实收金额
20	`cost_money`	numeric	`cost_money`	直接	成本金额
21	`ledger_status`	integer	`ledger_status`	直接	账本状态。枚举值: 1=已结算
22	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
23	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
24	`coupon_share_money`	numeric	`coupon_share_money`	直接	优惠券分摊金额
25	`discount_price`	numeric	`discount_price`	直接	折扣金额

DWD 表结构 — dwd.dwd_store_goods_sale_ex 🔗 ODS

共 28 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`store_goods_sale_id`	bigint	`id`	直接	字段重命名
2	`legacy_order_goods_id`	bigint	`ordergoodsid`	直接	字段重命名
3	`site_name`	text	`sitename`	直接	字段重命名
4	`legacy_site_id`	bigint	`siteid`	直接	字段重命名
5	`goods_remark`	text	`goods_remark`	直接	同名直传
6	`option_value_name`	text	`option_value_name`	直接	名称字段，用于展示与辅助识别
7	`operator_name`	text	`operator_name`	直接	同名直传
8	`open_salesman_flag`	integer	`opensalesman`	→ integer	字段重命名
9	`salesman_user_id`	bigint	`salesman_user_id`	直接	同名直传
10	`salesman_name`	text	`salesman_name`	直接	名称字段，用于展示与辅助识别
11	`salesman_role_id`	bigint	`salesman_role_id`	直接	同名直传
12	`salesman_org_id`	bigint	`sales_man_org_id`	直接	字段重命名
13	`discount_money`	numeric	`discount_money`	直接	同名直传
14	`returns_number`	integer	`returns_number`	直接	同名直传
15	`coupon_deduct_money`	numeric	`coupon_deduct_money`	直接	同名直传
16	`member_discount_amount`	numeric	`member_discount_amount`	直接	同名直传
17	`point_discount_money`	numeric	`point_discount_money`	直接	同名直传
18	`point_discount_money_cost`	numeric	`point_discount_money_cost`	直接	同名直传
19	`package_coupon_id`	bigint	`package_coupon_id`	直接	同名直传
20	`order_coupon_id`	bigint	`order_coupon_id`	直接	同名直传
21	`member_coupon_id`	bigint	`member_coupon_id`	直接	同名直传
22	`option_price`	numeric	`option_price`	直接	同名直传
23	`option_member_discount_money`	numeric	`option_member_discount_money`	直接	同名直传
24	`option_coupon_deduct_money`	numeric	`option_coupon_deduct_money`	直接	同名直传
25	`push_money`	numeric	`push_money`	直接	同名直传
26	`is_single_order`	integer	`is_single_order`	直接	同名直传
27	`sales_type`	integer	`sales_type`	直接	同名直传
28	`operator_id`	bigint	`operator_id`	直接	同名直传

3.7 payment_transactions（支付流水）

任务代码：ODS_PAYMENT
采样记录数：200
API JSON 字段数：36
ODS 列数：17
DWD 目标表：dwd_payment

API 源字段 — payment_transactions 🔗 ODS

已映射 12/36，覆盖率 33.3% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`create_time`	string	`create_time`	支付记录创建时间，通常与发起支付请求的时间一致（创建支付流水的时间戳）	枚举值: `2026-02-14 00:21:21`, `2026-02-14 00:16:27`, `2026-02-14 00:12:40`, `2026-02-14 00:01:01`, `2026-02-13 23:20:28`, `2026-02-13 23:16:30`, `2026-02-13 23:09:55`, `2026-02-13 22:50:41`
2	`pay_amount`	number	`pay_amount`	本条支付流水的“支付金额”，单位为元	枚举值: `7.0`, `0.0`, `10.0`, `684.0`, `5.0`, `43.0`, `49.0`, `2.0`
3	`pay_status`	integer	`pay_status`	支付状态枚举字段	示例: `2`
4	`pay_time`	string	`pay_time`	实际支付完成时间（支付状态变为成功的时间戳）	枚举值: `2026-02-14 00:21:21`, `2026-02-14 00:16:27`, `2026-02-14 00:12:40`, `2026-02-14 00:01:01`, `2026-02-13 23:20:28`, `2026-02-13 23:16:30`, `2026-02-13 23:09:55`, `2026-02-13 22:50:42`
5	`online_pay_channel`	integer	`online_pay_channel`	每一笔结账单（settleList.id）对应一条支付记录（当前样本中是一条记录，relate_id 唯一）	示例: `0`
6	`relate_type`	integer	`relate_type`	表示“这条支付记录关联的业务类型”	枚举值: `2`, `1`
7	`relate_id`	integer	`relate_id`	关联业务记录的主键 ID（按 relate_type 不同指向不同表）	枚举值: `3093864077166789`, `3093859276196037`, `3093855537596549`, `3093843703564549`, `3093804233967877`, `3093800338802821`, `3093793847478597`, `3093774959741061`
8	`site_id`	integer	`site_id`	支付记录所属的门店 ID	示例: `2790685415443269`
9	`id`	integer	`id`	支付流水记录的主键 ID	枚举值: `3093864103463109`, `3093859289221445`, `3093855574345989`, `3093844117801285`, `3093804248779077`, `3093800354400453`, `3093793882589445`, `3093774982547589`
10	`payment_method`	integer	`payment_method`	支付方式枚举，例如微信、支付宝、现金、银行卡、储值卡等某一种	枚举值: `4`, `2`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.payment_transactions 🔗 API

共 17 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_payment.payment_id`	支付流水记录的主键 ID
2	`site_id`	bigint	`site_id`	`dwd_payment.site_id`	支付记录所属的门店 ID
3	`siteprofile`	jsonb	—	—	（待补充）
4	`relate_type`	integer	`relate_type`	`dwd_payment.relate_type`	表示“这条支付记录关联的业务类型”
5	`relate_id`	bigint	`relate_id`	`dwd_payment.relate_id`	关联业务记录的主键 ID（按 relate_type 不同指向不同表）
6	`pay_amount`	numeric	`pay_amount`	`dwd_payment.pay_amount`	本条支付流水的“支付金额”，单位为元
7	`pay_status`	integer	`pay_status`	`dwd_payment.pay_status`	支付状态枚举字段
8	`pay_time`	timestamp without time zone	`pay_time`	`dwd_payment.pay_time`, `dwd_payment.pay_date`	实际支付完成时间（支付状态变为成功的时间戳）
9	`create_time`	timestamp without time zone	`create_time`	`dwd_payment.create_time`	支付记录创建时间，通常与发起支付请求的时间一致（创建支付流水的时间戳）
10	`payment_method`	integer	`payment_method`	`dwd_payment.payment_method`	支付方式枚举，例如微信、支付宝、现金、银行卡、储值卡等某一种
11	`online_pay_channel`	integer	`online_pay_channel`	`dwd_payment.online_pay_channel`	每一笔结账单（settleList.id）对应一条支付记录（当前样本中是一条记录，relate_id 唯一）
12	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_payment.tenant_id`	租户ID

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_payment 🔗 ODS

共 12 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`payment_id`	bigint	`id`	直接	支付流水 ID
2	`site_id`	bigint	`site_id`	直接	门店 ID
3	`relate_type`	integer	`relate_type`	直接	关联业务类型。枚举值: 1=预付, 2=结账, 5=充值, 6=线上商城
4	`relate_id`	bigint	`relate_id`	直接	关联业务 ID
5	`pay_amount`	numeric	`pay_amount`	直接	支付金额（元）
6	`pay_status`	integer	`pay_status`	直接	支付状态。枚举值: 2=已支付
7	`payment_method`	integer	`payment_method`	直接	支付方式。枚举值: 2=现金支付 , 4=离线支付
8	`online_pay_channel`	integer	`online_pay_channel`	直接	在线支付渠道（当前数据全为 0）
9	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
10	`pay_time`	timestamp with time zone	`pay_time`	直接	支付时间
11	`pay_date`	date	`pay_time`	→ date	支付日期
12	`tenant_id`	bigint	`tenant_id`	直接	租户 ID

3.8 refund_transactions（退款流水）

任务代码：ODS_REFUND
采样记录数：29
API JSON 字段数：57
ODS 列数：37
DWD 目标表：dwd_refund, dwd_refund_ex

API 源字段 — refund_transactions 🔗 ODS

已映射 33/57，覆盖率 57.9% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`tenantName`	string	`tenantname`	（待补充）	大小写匹配；示例: `朗朗桌球`
2	`id`	integer	`id`	本条退款流水的唯一 ID	枚举值: `3089577798995141`, `3085106065510021`, `3080691980947141`, `3076746573219397`, `3075315080365445`, `3072740947101125`, `3063816474921925`, `3062207845584517`
3	`site_id`	integer	`site_id`	门店 ID	示例: `2790685415443269`
4	`tenant_id`	integer	`tenant_id`	租户/品牌 ID，全系统维度标识该商户	示例: `2790683160709957`
5	`pay_sn`	integer	`pay_sn`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `0`
6	`pay_amount`	number	`pay_amount`	本次退款的资金变动金额	枚举值: `-8.0`, `-1.5`, `-98.0`, `-50.0`, `-20.0`, `-10000.0`, `-5.0`, `-2.0`
7	`pay_status`	integer	`pay_status`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `2`
8	`pay_time`	string	`pay_time`	退款在支付渠道层面实际发生的时间	枚举值: `2026-02-10 23:41:06`, `2026-02-07 19:52:13`, `2026-02-04 17:01:58`, `2026-02-01 22:08:30`, `2026-01-31 21:52:18`, `2026-01-30 02:13:46`, `2026-01-23 18:55:19`, `2026-01-22 15:38:56`
9	`create_time`	string	`create_time`	本条退款流水在系统内创建时间	枚举值: `2026-02-10 23:41:06`, `2026-02-07 19:52:13`, `2026-02-04 17:01:58`, `2026-02-01 22:08:30`, `2026-01-31 21:52:18`, `2026-01-30 02:13:46`, `2026-01-23 18:55:19`, `2026-01-22 15:38:56`
10	`relate_type`	integer	`relate_type`	本退款对应的“业务类型”	枚举值: `1`, `5`, `2`
11	`relate_id`	integer	`relate_id`	本次退款关联的业务 ID	枚举值: `3089548319804869`, `3085105740795590`, `3080690280517125`, `3076716749112965`, `3075314390828613`, `3072740722083269`, `3063630706494661`, `3062058292596165`
12	`is_revoke`	integer	`is_revoke`	布尔/开关字段，用于表示权限、可用性或状态开关	示例: `0`
13	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
14	`online_pay_channel`	integer	`online_pay_channel`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `0`
15	`payment_method`	integer	`payment_method`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `4`, `2`
16	`balance_frozen_amount`	number	`balance_frozen_amount`	涉及会员储值卡退款时，暂时冻结的余额金额	示例: `0.0`
17	`card_frozen_amount`	number	`card_frozen_amount`	与上一个类似，偏向“某张卡的被冻结金额”，也与会员卡/储值账户相关	示例: `0.0`
18	`member_id`	integer	`member_id`	租户内部的会员 ID（对应会员档案中的某个主键）	示例: `0`
19	`member_card_id`	integer	`member_card_id`	关联的会员卡账户 ID（对应“储值卡列表”或“会员档案”中的某一张卡）	示例: `0`
20	`round_amount`	number	`round_amount`	舍入金额/抹零金额	示例: `0.0`
21	`online_pay_type`	integer	`online_pay_type`	当前：全部 0	示例: `0`
22	`action_type`	integer	`action_type`	当前：全部 2	示例: `2`
23	`refund_amount`	number	`refund_amount`	设计上本应显示“实际退款金额”（正数），与 pay_amount 配合使用	示例: `0.0`
24	`cashier_point_id`	integer	`cashier_point_id`	收银点 ID，例如前台 1、前台 2、自助机等	示例: `0`
25	`operator_id`	integer	`operator_id`	执行该退款操作的操作员 ID	示例: `0`
26	`pay_terminal`	integer	`pay_terminal`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
27	`pay_config_id`	integer	`pay_config_id`	支付配置 ID，例如商户在“非球科技”内配置的某一条支付通道（某个微信商户号、银联通道）的主键	示例: `0`
28	`channel_payer_id`	string	`channel_payer_id`	支付渠道侧的 payer ID，例如微信 openid、银行卡号掩码等
29	`channel_pay_no`	string	`channel_pay_no`	第三方支付平台的交易号（如微信支付单号、支付宝交易号等）
30	`check_status`	integer	`check_status`	当前：全部 1	示例: `1`
31	`channel_fee`	number	`channel_fee`	第三方支付渠道对本次退款收取的手续费	示例: `0.0`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.refund_transactions 🔗 API

共 37 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_refund.refund_id`, `dwd_refund_ex.refund_id`	本条退款流水的唯一 ID
2	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_refund.tenant_id`	租户/品牌 ID，全系统维度标识该商户
3	`tenantname`	text	`tenantName`	`dwd_refund_ex.tenant_name`	（待补充）
4	`site_id`	bigint	`site_id`	`dwd_refund.site_id`	门店 ID
5	`siteprofile`	jsonb	—	—	（待补充）
6	`relate_type`	integer	`relate_type`	`dwd_refund.relate_type`	本退款对应的“业务类型”
7	`relate_id`	bigint	`relate_id`	`dwd_refund.relate_id`	本次退款关联的业务 ID
8	`pay_sn`	text	`pay_sn`	`dwd_refund_ex.pay_sn`	来自 JSON 导出的原始字段，用于保留业务取值
9	`pay_amount`	numeric	`pay_amount`	`dwd_refund.pay_amount`	本次退款的资金变动金额
10	`refund_amount`	numeric	`refund_amount`	`dwd_refund_ex.refund_amount`	设计上本应显示“实际退款金额”（正数），与 pay_amount 配合使用
11	`round_amount`	numeric	`round_amount`	`dwd_refund_ex.round_amount`	舍入金额/抹零金额
12	`pay_status`	integer	`pay_status`	`dwd_refund_ex.pay_status`	来自 JSON 导出的原始字段，用于保留业务取值
13	`pay_time`	timestamp without time zone	`pay_time`	`dwd_refund.pay_time`	退款在支付渠道层面实际发生的时间
14	`create_time`	timestamp without time zone	`create_time`	`dwd_refund.create_time`	本条退款流水在系统内创建时间
15	`payment_method`	integer	`payment_method`	`dwd_refund.payment_method`	来自 JSON 导出的原始字段，用于保留业务取值
16	`pay_terminal`	integer	`pay_terminal`	`dwd_refund_ex.pay_terminal`	来自 JSON 导出的原始字段，用于保留业务取值
17	`pay_config_id`	bigint	`pay_config_id`	`dwd_refund_ex.pay_config_id`	支付配置 ID，例如商户在“非球科技”内配置的某一条支付通道（某个微信商户号、银联通道）的主键
18	`online_pay_channel`	integer	`online_pay_channel`	`dwd_refund_ex.online_pay_channel`	来自 JSON 导出的原始字段，用于保留业务取值
19	`online_pay_type`	integer	`online_pay_type`	`dwd_refund_ex.online_pay_type`	当前：全部 0
20	`channel_fee`	numeric	`channel_fee`	`dwd_refund.channel_fee`	第三方支付渠道对本次退款收取的手续费
21	`channel_payer_id`	text	`channel_payer_id`	`dwd_refund_ex.channel_payer_id`	支付渠道侧的 payer ID，例如微信 openid、银行卡号掩码等
22	`channel_pay_no`	text	`channel_pay_no`	`dwd_refund_ex.channel_pay_no`	第三方支付平台的交易号（如微信支付单号、支付宝交易号等）
23	`member_id`	bigint	`member_id`	`dwd_refund.member_id`	租户内部的会员 ID（对应会员档案中的某个主键）
24	`member_card_id`	bigint	`member_card_id`	`dwd_refund.member_card_id`	关联的会员卡账户 ID（对应“储值卡列表”或“会员档案”中的某一张卡）
25	`cashier_point_id`	bigint	`cashier_point_id`	`dwd_refund_ex.cashier_point_id`	收银点 ID，例如前台 1、前台 2、自助机等
26	`operator_id`	bigint	`operator_id`	`dwd_refund_ex.operator_id`	执行该退款操作的操作员 ID
27	`action_type`	integer	`action_type`	`dwd_refund_ex.action_type`	当前：全部 2
28	`check_status`	integer	`check_status`	`dwd_refund_ex.check_status`	当前：全部 1
29	`is_revoke`	integer	`is_revoke`	`dwd_refund_ex.is_revoke`	布尔/开关字段，用于表示权限、可用性或状态开关
30	`is_delete`	integer	`is_delete`	`dwd_refund_ex.is_delete`	逻辑删除标志
31	`balance_frozen_amount`	numeric	`balance_frozen_amount`	`dwd_refund_ex.balance_frozen_amount`	涉及会员储值卡退款时，暂时冻结的余额金额
32	`card_frozen_amount`	numeric	`card_frozen_amount`	`dwd_refund_ex.card_frozen_amount`	与上一个类似，偏向“某张卡的被冻结金额”，也与会员卡/储值账户相关

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_refund 🔗 ODS

共 12 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`refund_id`	bigint	`id`	直接	退款流水 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`site_id`	bigint	`site_id`	直接	门店 ID
4	`relate_type`	integer	`relate_type`	直接	关联业务类型。枚举值: 1(7)=预付退款 , 2(31)=结账退款, 5(7)=充值退款
5	`relate_id`	bigint	`relate_id`	直接	关联业务 ID
6	`pay_amount`	numeric	`pay_amount`	直接	退款金额（元，负数）
7	`channel_fee`	numeric	`channel_fee`	直接	渠道手续费
8	`pay_time`	timestamp with time zone	`pay_time`	直接	退款时间
9	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
10	`payment_method`	integer	`payment_method`	直接	支付方式，暂无用途。
11	`member_id`	bigint	`member_id`	直接	会员 ID（当前数据全为 0）
12	`member_card_id`	bigint	`member_card_id`	直接	会员卡 ID（当前数据全为 0）

DWD 表结构 — dwd.dwd_refund_ex 🔗 ODS

共 20 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`refund_id`	bigint	`id`	直接	字段重命名
2	`tenant_name`	character varying	`tenantname`	直接	字段重命名
3	`pay_sn`	bigint	`pay_sn`	直接	同名直传
4	`refund_amount`	numeric	`refund_amount`	直接	同名直传
5	`round_amount`	numeric	`round_amount`	直接	同名直传
6	`balance_frozen_amount`	numeric	`balance_frozen_amount`	直接	同名直传
7	`card_frozen_amount`	numeric	`card_frozen_amount`	直接	同名直传
8	`pay_status`	integer	`pay_status`	直接	同名直传
9	`action_type`	integer	`action_type`	直接	同名直传
10	`is_revoke`	integer	`is_revoke`	直接	同名直传
11	`is_delete`	integer	`is_delete`	直接	同名直传
12	`check_status`	integer	`check_status`	直接	同名直传
13	`online_pay_channel`	integer	`online_pay_channel`	直接	同名直传
14	`online_pay_type`	integer	`online_pay_type`	直接	同名直传
15	`pay_terminal`	integer	`pay_terminal`	直接	同名直传
16	`pay_config_id`	integer	`pay_config_id`	直接	同名直传
17	`cashier_point_id`	integer	`cashier_point_id`	直接	同名直传
18	`operator_id`	bigint	`operator_id`	直接	同名直传
19	`channel_payer_id`	character varying	`channel_payer_id`	直接	标识类 ID 字段，用于关联/定位相关实体
20	`channel_pay_no`	character varying	`channel_pay_no`	直接	明细字段，用于记录事实取值

3.9 platform_coupon_redemption_records（平台/团购券核销）

任务代码：ODS_PLATFORM_COUPON
采样记录数：200
API JSON 字段数：51
ODS 列数：31
DWD 目标表：dwd_platform_coupon_redemption, dwd_platform_coupon_redemption_ex

API 源字段 — platform_coupon_redemption_records 🔗 ODS

已映射 27/51，覆盖率 52.9% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`id`	integer	`id`	本条平台验券记录在本系统内的主键 ID	枚举值: `3093784060856453`, `3093740765382981`, `3093730734033029`, `3093729952467077`, `3093720616372421`, `3093689826576709`, `3093683005753477`, `3093681904502917`
2	`tenant_id`	integer	`tenant_id`	商户/租户 ID（品牌级别）	示例: `2790683160709957`
3	`site_id`	integer	`site_id`	门店 ID	示例: `2790685415443269`
4	`sale_price`	number	`sale_price`	顾客在第三方平台上实际支付的价格（团购售价）	枚举值: `20.26`, `39.9`, `69.9`, `59.9`, `35.9`, `128.0`, `12.12`, `9.9`
5	`coupon_code`	string	`coupon_code`	券码，顾客出示的团购券密码/编号	枚举值: `0108970935413`, `0107305319597`, `0107317733529`, `0103968076185`, `0102409858353`, `0103957102485`, `0106359943515`, `0101346097990`
6	`coupon_channel`	integer	`coupon_channel`	券来源渠道（第三方平台渠道编号）	示例: `1`
7	`site_order_id`	integer	`site_order_id`	门店内部的订单 ID（平台券核销时对应的店内订单）	枚举值: `3093784062036101`, `3093740766775621`, `3093730735376517`, `3093729955563653`, `3093720617519301`, `3093689828067653`, `3093683006916741`, `3093681905567877`
8	`coupon_free_time`	integer	`coupon_free_time`	券附带的“免费时长”字段（例如送多少分钟台费）	示例: `0`
9	`use_status`	integer	`use_status`	值 1：198 条	示例: `1`
10	`create_time`	string	`create_time`	验券记录在本系统中创建的时间（记录入库时间）	枚举值: `2026-02-13 22:59:56`, `2026-02-13 22:15:53`, `2026-02-13 22:05:41`, `2026-02-13 22:04:53`, `2026-02-13 21:55:23`, `2026-02-13 21:24:04`, `2026-02-13 21:17:08`, `2026-02-13 21:16:00`
11	`is_delete`	integer	`is_delete`	把平台验券记录挂到本门店的一条订单上	示例: `0`
12	`coupon_name`	string	`coupon_name`	团购券产品名称（即第三方平台上向顾客展示的名称）	枚举值: `【全天可用】中八桌球一小时（大厅A区）`, `【全天可用】中八桌球两小时（A区）`, `【全天可用】斯诺克一小时`, `【全天可用】斯诺克两小时`, `【全天可用】中八桌球两小时（B区）`, `【全天可用】B区桌球一小时`, `【全天可用】麻将、掼蛋包厢四小时`, `1小时中八台球\|【新年特惠】（A区）`
13	`coupon_cover`	string	`coupon_cover`	来自 JSON 导出的原始字段，用于保留业务取值
14	`coupon_remark`	string	`coupon_remark`	来自 JSON 导出的原始字段，用于保留业务取值
15	`channel_deal_id`	integer	`channel_deal_id`	渠道侧 dealId / 产品 ID，一般是第三方平台给该团购商品定义的主键	枚举值: `1128411555`, `1130465371`, `1147633733`, `1130443985`, `1137872168`, `1370841337`, `1134269810`, `1203035334`
16	`group_package_id`	integer	`group_package_id`	标识类 ID 字段，用于关联/定位相关实体	示例: `0`
17	`consume_time`	string	`consume_time`	券被核销/使用的业务时间	枚举值: `2026-02-13 22:59:56`, `2026-02-13 22:15:54`, `2026-02-13 22:05:41`, `2026-02-13 22:04:54`, `2026-02-13 21:55:24`, `2026-02-13 21:24:05`, `2026-02-13 21:17:08`, `2026-02-13 21:16:01`
18	`groupon_type`	integer	`groupon_type`	团购券类型	示例: `1`
19	`coupon_money`	number	`coupon_money`	券面值 / 套餐价值（系统层面的“可抵扣金额或对应套餐价值”）	枚举值: `48.0`, `96.0`, `68.0`, `136.0`, `116.0`, `58.0`, `288.0`
20	`operator_id`	integer	`operator_id`	操作员 ID（执行验券操作的收银员/员工）	示例: `2790687322443013`
21	`operator_name`	string	`operator_name`	操作员姓名，例如 "收银员:郑丽珊"	示例: `收银员:郑丽珊`
22	`table_id`	integer	`table_id`	使用券的球台 ID	枚举值: `2793001904918661`, `2793003506815045`, `2791964216463493`, `2793020260044869`, `2793003705192517`, `2792521437958213`, `2793001695301765`, `2793002509209733`
23	`certificate_id`	string	`certificate_id`	平台侧的凭证 ID（通常由第三方团购平台生成的券实例 ID）	枚举值: `5017032752860339573`, `5017032752444438459`, `5017032752542324772`, `5017032752441028251`, `5017032751805056410`, `5017032751601072902`, `5017032751448614451`, `5017032751498902695`
24	`verify_id`	string	`verify_id`	平台核销记录 ID（某些平台会为每一次核销生成一个唯一 ID）
25	`deal_id`	integer	`deal_id`	另一个层次的团购产品 ID	枚举值: `1345108507`, `1346103574`, `1350374807`, `1346105245`, `1347938899`, `1398374101`, `1347146296`, `1364921087`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.platform_coupon_redemption_records 🔗 API

共 31 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_platform_coupon_redemption.platform_coupon_redemption_id`, `dwd_platform_coupon_redemption_ex.platform_coupon_redemption_id`	本条平台验券记录在本系统内的主键 ID
2	`verify_id`	bigint	`verify_id`	`dwd_platform_coupon_redemption.verify_id`	平台核销记录 ID（某些平台会为每一次核销生成一个唯一 ID）
3	`certificate_id`	text	`certificate_id`	`dwd_platform_coupon_redemption.certificate_id`	平台侧的凭证 ID（通常由第三方团购平台生成的券实例 ID）
4	`coupon_code`	text	`coupon_code`	`dwd_platform_coupon_redemption.coupon_code`	券码，顾客出示的团购券密码/编号
5	`coupon_name`	text	`coupon_name`	`dwd_platform_coupon_redemption.coupon_name`	团购券产品名称（即第三方平台上向顾客展示的名称）
6	`coupon_channel`	integer	`coupon_channel`	`dwd_platform_coupon_redemption.coupon_channel`	券来源渠道（第三方平台渠道编号）
7	`groupon_type`	integer	`groupon_type`	`dwd_platform_coupon_redemption_ex.groupon_type`	团购券类型
8	`group_package_id`	bigint	`group_package_id`	`dwd_platform_coupon_redemption.group_package_id`	标识类 ID 字段，用于关联/定位相关实体
9	`sale_price`	numeric	`sale_price`	`dwd_platform_coupon_redemption.sale_price`	顾客在第三方平台上实际支付的价格（团购售价）
10	`coupon_money`	numeric	`coupon_money`	`dwd_platform_coupon_redemption.coupon_money`	券面值 / 套餐价值（系统层面的“可抵扣金额或对应套餐价值”）
11	`coupon_free_time`	numeric	`coupon_free_time`	`dwd_platform_coupon_redemption.coupon_free_time`	券附带的“免费时长”字段（例如送多少分钟台费）
12	`coupon_cover`	text	`coupon_cover`	`dwd_platform_coupon_redemption_ex.coupon_cover`	来自 JSON 导出的原始字段，用于保留业务取值
13	`coupon_remark`	text	`coupon_remark`	`dwd_platform_coupon_redemption_ex.coupon_remark`	来自 JSON 导出的原始字段，用于保留业务取值
14	`use_status`	integer	`use_status`	`dwd_platform_coupon_redemption.use_status`	值 1：198 条
15	`consume_time`	timestamp without time zone	`consume_time`	`dwd_platform_coupon_redemption.consume_time`	券被核销/使用的业务时间
16	`create_time`	timestamp without time zone	`create_time`	`dwd_platform_coupon_redemption.create_time`	验券记录在本系统中创建的时间（记录入库时间）
17	`deal_id`	text	`deal_id`	`dwd_platform_coupon_redemption.deal_id`	另一个层次的团购产品 ID
18	`channel_deal_id`	text	`channel_deal_id`	`dwd_platform_coupon_redemption.channel_deal_id`	渠道侧 dealId / 产品 ID，一般是第三方平台给该团购商品定义的主键
19	`site_id`	bigint	`site_id`	`dwd_platform_coupon_redemption.site_id`	门店 ID
20	`site_order_id`	bigint	`site_order_id`	`dwd_platform_coupon_redemption.site_order_id`	门店内部的订单 ID（平台券核销时对应的店内订单）
21	`table_id`	bigint	`table_id`	`dwd_platform_coupon_redemption.table_id`	使用券的球台 ID
22	`tenant_id`	bigint	`siteProfile.tenant_id`	`dwd_platform_coupon_redemption.tenant_id`	商户/租户 ID（品牌级别）
23	`operator_id`	bigint	`operator_id`	`dwd_platform_coupon_redemption_ex.operator_id`	操作员 ID（执行验券操作的收银员/员工）
24	`operator_name`	text	`operator_name`	`dwd_platform_coupon_redemption_ex.operator_name`	操作员姓名，例如 "收银员:郑丽珊"
25	`is_delete`	integer	`is_delete`	`dwd_platform_coupon_redemption.is_delete`	把平台验券记录挂到本门店的一条订单上
26	`siteprofile`	jsonb	—	—	（待补充）

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_platform_coupon_redemption 🔗 ODS

共 20 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`platform_coupon_redemption_id`	bigint	`id`	直接	核销 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`site_id`	bigint	`site_id`	直接	门店 ID
4	`coupon_code`	character varying	`coupon_code`	直接	券码
5	`coupon_channel`	integer	`coupon_channel`	直接	券渠道。枚举值: 1=美团, 2=抖音
6	`coupon_name`	character varying	`coupon_name`	直接	券名称。样本值: "【全天可用】中八桌球一小时（A区）", "【全天可用】中八桌球两小时（A区）" 等
7	`sale_price`	numeric	`sale_price`	直接	售卖价（元）。样本值: 29.90, 69.90, 59.90, 39.90, 19.90 等
8	`coupon_money`	numeric	`coupon_money`	直接	券面额（元）。样本值: 48.00, 96.00, 116.00, 68.00 等
9	`coupon_free_time`	integer	`coupon_free_time`	直接	券赠送时长（当前数据全为 0）
10	`channel_deal_id`	bigint	`channel_deal_id`	直接	渠道交易 ID
11	`deal_id`	bigint	`deal_id`	直接	交易 ID
12	`group_package_id`	bigint	`group_package_id`	直接	团购套餐 ID（当前数据全为 0）
13	`site_order_id`	bigint	`site_order_id`	直接	门店订单 ID
14	`table_id`	bigint	`table_id`	直接	台桌 ID → dim_table
15	`certificate_id`	character varying	`certificate_id`	直接	凭证 ID
16	`verify_id`	character varying	`verify_id`	直接	核验 ID（仅抖音券有值）
17	`use_status`	integer	`use_status`	直接	使用状态。枚举值: 1=已使用, 2=已撤销
18	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
19	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
20	`consume_time`	timestamp with time zone	`consume_time`	直接	核销时间

DWD 表结构 — dwd.dwd_platform_coupon_redemption_ex 🔗 ODS

共 6 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`platform_coupon_redemption_id`	bigint	`id`	直接	字段重命名
2	`coupon_cover`	character varying	`coupon_cover`	直接	明细字段，用于记录事实取值
3	`coupon_remark`	character varying	`coupon_remark`	直接	同名直传
4	`groupon_type`	integer	`groupon_type`	直接	同名直传
5	`operator_id`	bigint	`operator_id`	直接	同名直传
6	`operator_name`	character varying	`operator_name`	直接	同名直传

3.10 member_profiles（会员档案）

任务代码：ODS_MEMBER
采样记录数：200
API JSON 字段数：20
ODS 列数：25
DWD 目标表：dim_member, dim_member_ex

API 源字段 — member_profiles 🔗 ODS

已映射 20/20，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`id`	integer	`id`	这是“租户内会员账户”的主键 ID	枚举值: `3085176958944837`, `3066773303512389`, `3062388521698821`, `3055176918828421`, `3054195561631109`, `3052749341853317`, `3048238811858693`, `3043883848157381`
2	`create_time`	string	`create_time`	会员账户的创建时间（即这条档案/这张卡在系统中被创建的时间）	枚举值: `2026-02-07 21:04:20`, `2026-01-25 21:03:10`, `2026-01-22 18:42:44`, `2026-01-17 16:26:43`, `2026-01-16 23:48:25`, `2026-01-15 23:17:15`, `2026-01-12 18:48:54`, `2026-01-09 16:58:48`
3	`member_card_grade_code`	integer	`member_card_grade_code`	这两个字段是成对出现的：一个数值码，一个中文名称	枚举值: `2790683528022856`, `2790683528022853`, `2790683528022855`, `2790683528022857`
4	`mobile`	string	`mobile`	会员绑定的手机号码	枚举值: `13728281927`, `17306741548`, `13332883280`, `18898887676`, `15902048888`, `13434273425`, `15815818028`, `15146102616`
5	`nickname`	string	`nickname`	会员在当前租户下的显示名称（可以是姓名，也可以是昵称）	枚举值: `黄先生`, `李`, `袁`, `章先生`, `公孙先生`, `孙总`, `胡先生`, `吴先生`
6	`register_site_id`	integer	`register_site_id`	会员的注册门店 ID	示例: `2790685415443269`
7	`site_name`	string	`site_name`	注册门店名称，属于冗余字段，用于直接展示	示例: `朗朗桌球`
8	`member_card_grade_name`	string	`member_card_grade_name`	这是“会员卡种类/等级”的定义字段	枚举值: `活动抵用券`, `储值卡`, `台费卡`, `月卡`
9	`system_member_id`	integer	`system_member_id`	这是“系统级会员 ID”，在全平台唯一，用来把一个会员在不同门店/不同卡类型下的账户统一到一个“人”的维度上	枚举值: `3085176956307013`, `3066773300268357`, `3062388519667205`, `3055176917108101`, `3054195559402885`, `3052749336856197`, `3048238810220293`, `3043883846568133`
10	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
11	`referrer_member_id`	integer	`referrer_member_id`	推荐人会员 ID，用于记录该会员是由哪位老会员推荐	示例: `0`
12	`point`	number	`point`	当前积分余额（这条会员账户的积分值）	示例: `0.0`
13	`user_status`	integer	`user_status`	用户账号状态（偏“用户逻辑”层面的状态）	示例: `1`
14	`status`	integer	`status`	帐户状态（偏“卡状态/档案状态”）	枚举值: `1`, `3`
15	`growth_value`	number	`growth_value`	成长值 / 经验值，用于会员等级晋升的累计指标	示例: `0.0`
16	`person_tenant_org_id`	integer	`person_tenant_org_id`	人员租户组织ID	示例: `0`
17	`person_tenant_org_name`	string	`person_tenant_org_name`	人员租户组织名称
18	`register_source`	integer	`register_source`	注册来源	枚举值: `6`, `1`
19	`recharge_money_sum`	number	`recharge_money_sum`	累计充值金额	枚举值: `5000.0`, `188.0`, `1000.0`, `3288.0`, `17078.51`, `2176.0`, `6576.0`, `1376.0`
20	`pay_money_sum`	number	`pay_money_sum`	累计支付金额	枚举值: `-12.79`, `-188.0`, `-203.4`, `-808.51`, `-989.24`, `-17078.51`, `-2064.94`, `-5705.0`

ODS 表结构 — ods.member_profiles 🔗 API

共 25 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`tenant_id`	bigint	`tenant_id`	`dim_member.tenant_id`	租户/品牌 ID
2	`register_site_id`	bigint	`register_site_id`	`dim_member.register_site_id`	会员的注册门店 ID
3	`site_name`	text	`site_name`	`dim_member_ex.register_site_name`	注册门店名称，属于冗余字段，用于直接展示
4	`id`	bigint	`id`	`dim_member.member_id`, `dim_member_ex.member_id`	这是“租户内会员账户”的主键 ID
5	`system_member_id`	bigint	`system_member_id`	`dim_member.system_member_id`	这是“系统级会员 ID”，在全平台唯一，用来把一个会员在不同门店/不同卡类型下的账户统一到一个“人”的维度上
6	`member_card_grade_code`	bigint	`member_card_grade_code`	`dim_member.member_card_grade_code`	这两个字段是成对出现的：一个数值码，一个中文名称
7	`member_card_grade_name`	text	`member_card_grade_name`	`dim_member.member_card_grade_name`	这是“会员卡种类/等级”的定义字段
8	`mobile`	text	`mobile`	`dim_member.mobile`	会员绑定的手机号码
9	`nickname`	text	`nickname`	`dim_member.nickname`	会员在当前租户下的显示名称（可以是姓名，也可以是昵称）
10	`point`	numeric	`point`	`dim_member_ex.point`	当前积分余额（这条会员账户的积分值）
11	`growth_value`	numeric	`growth_value`	`dim_member_ex.growth_value`	成长值 / 经验值，用于会员等级晋升的累计指标
12	`referrer_member_id`	bigint	`referrer_member_id`	`dim_member_ex.referrer_member_id`	推荐人会员 ID，用于记录该会员是由哪位老会员推荐
13	`status`	integer	`status`	`dim_member_ex.status`	帐户状态（偏“卡状态/档案状态”）
14	`user_status`	integer	`user_status`	`dim_member_ex.user_status`	用户账号状态（偏“用户逻辑”层面的状态）
15	`create_time`	timestamp without time zone	`create_time`	`dim_member.create_time`	会员账户的创建时间（即这条档案/这张卡在系统中被创建的时间）
16	`pay_money_sum`	numeric	`pay_money_sum`	`dim_member.pay_money_sum`	累计支付金额
17	`person_tenant_org_id`	bigint	`person_tenant_org_id`	`dim_member_ex.person_tenant_org_id`	人员租户组织ID
18	`person_tenant_org_name`	text	`person_tenant_org_name`	`dim_member_ex.person_tenant_org_name`	人员租户组织名称
19	`recharge_money_sum`	numeric	`recharge_money_sum`	`dim_member.recharge_money_sum`	累计充值金额
20	`register_source`	text	`register_source`	`dim_member_ex.register_source`	注册来源

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_member 🔗 ODS

共 16 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`member_id`	bigint	`id`	直接	租户内会员 ID（tenant_member_id）
2	`system_member_id`	bigint	`system_member_id`	直接	系统级会员 ID
3	`tenant_id`	bigint	`tenant_id`	直接	租户 ID（当前值: 2790683160709957）
4	`register_site_id`	bigint	`register_site_id`	直接	注册门店 ID → dim_site（当前值: 2790685415443269）
5	`mobile`	text	`mobile`	直接	手机号码
6	`nickname`	text	`nickname`	直接	昵称。样本值: "陈先生", "张先生", "李先生",等
7	`member_card_grade_code`	bigint	`member_card_grade_code`	直接	卡等级代码
8	`member_card_grade_name`	text	`member_card_grade_name`	直接	卡等级名称。枚举值: "储值卡", "台费卡", "年卡", "活动抵用券", "月卡"
9	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
10	`update_time`	timestamp with time zone	—	—	更新时间
11	`pay_money_sum`	numeric	`pay_money_sum`	直接	累计支付金额
12	`recharge_money_sum`	numeric	`recharge_money_sum`	直接	累计充值金额
13	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
14	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
15	`scd2_is_current`	integer	—	SCD2	当前版本标记
16	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_member_ex 🔗 ODS

共 14 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`member_id`	bigint	`id`	直接	字段重命名
2	`referrer_member_id`	bigint	`referrer_member_id`	直接	同名直传
3	`point`	numeric	`point`	直接	同名直传
4	`register_site_name`	text	`site_name`	直接	字段重命名
5	`growth_value`	numeric	`growth_value`	直接	同名直传
6	`user_status`	integer	`user_status`	直接	同名直传
7	`status`	integer	`status`	直接	同名直传
8	`person_tenant_org_id`	bigint	`person_tenant_org_id`	直接
9	`person_tenant_org_name`	text	`person_tenant_org_name`	直接
10	`register_source`	text	`register_source`	直接
11	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
12	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
13	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
14	`scd2_version`	integer	—	SCD2	SCD2 元数据

3.11 member_stored_value_cards（会员储值卡）

任务代码：ODS_MEMBER_CARD
采样记录数：200
API JSON 字段数：71
ODS 列数：80
DWD 目标表：dim_member_card_account, dim_member_card_account_ex

API 源字段 — member_stored_value_cards 🔗 ODS

已映射 71/71，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`site_name`	string	`site_name`	卡归属门店名称（视图中的展示字段）	示例: `朗朗桌球`
2	`member_name`	string	`member_name`	持卡会员姓名快照	出现率 98%；枚举值: `黄先生`, `李`, `袁`, `章先生`, `公孙先生`, `孙总`, `胡先生`, `吴先生`
3	`member_mobile`	string	`member_mobile`	持卡会员手机号快照	出现率 98%；枚举值: `13728281927`, `17306741548`, `13332883280`, `15726865555`, `18898887676`, `15902048888`, `13434273425`, `15815818028`
4	`member_card_type_name`	string	`member_card_type_name`	卡类型名称，实际与 member_card_grade_code_name 一致	枚举值: `活动抵用券`, `储值卡`, `台费卡`, `月卡`, `酒水卡`
5	`table_service_discount`	number	`table_service_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
6	`assistant_service_discount`	number	`assistant_service_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
7	`coupon_discount`	number	`coupon_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
8	`goods_service_discount`	number	`goods_service_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
9	`electricity_discount`	number	`electricity_discount`	电费折扣	示例: `10.0`
10	`is_allow_give`	integer	`is_allow_give`	是否允许转赠/转让给其他会员	示例: `0`
11	`able_cross_site`	integer	`able_cross_site`	是否允许跨店使用	示例: `1`
12	`cardSettleDeduct`	number	`cardsettlededuct`	（待补充）	大小写匹配；示例: `0.0`
13	`tenantAvatar`	string	`tenantavatar`	（待补充）	大小写匹配
14	`tenantName`	string	`tenantname`	（待补充）	大小写匹配
15	`member_card_grade_code_name`	string	`member_card_grade_code_name`	卡等级/卡类名称	枚举值: `活动抵用券`, `储值卡`, `台费卡`, `月卡`, `酒水卡`
16	`table_discount_sub_switch`	integer	`table_discount_sub_switch`	数量/时长字段，用于统计与计量	示例: `2`
17	`goods_discount_sub_switch`	integer	`goods_discount_sub_switch`	数量/时长字段，用于统计与计量	示例: `2`
18	`assistant_discount_sub_switch`	integer	`assistant_discount_sub_switch`	数量/时长字段，用于统计与计量	示例: `2`
19	`assistant_reward_discount_sub_switch`	integer	`assistant_reward_discount_sub_switch`	数量/时长字段，用于统计与计量	示例: `2`
20	`goods_discount_range_type`	integer	`goods_discount_range_type`	数量/时长字段，用于统计与计量	示例: `1`
21	`use_scene`	string	`use_scene`	卡使用场景说明（比如“仅店内使用”“仅团建”等），本门店尚未使用此字段
22	`balance`	number	`balance`	当前卡内余额（主要针对储值卡、部分券卡）	枚举值: `4987.21`, `0.0`, `796.6`, `88.0`, `2479.49`, `2298.76`, `111.06`, `871.0`
23	`table_deduct_radio`	number	`table_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
24	`table_service_deduct_radio`	number	`table_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
25	`goods_deduct_radio`	number	`goods_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
26	`goods_service_deduct_radio`	number	`goods_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
27	`assistant_deduct_radio`	number	`assistant_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
28	`assistant_service_deduct_radio`	number	`assistant_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
29	`assistant_reward_deduct_radio`	number	`assistant_reward_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
30	`coupon_deduct_radio`	number	`coupon_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算	示例: `100.0`
31	`electricity_deduct_radio`	number	`electricity_deduct_radio`	电费扣减比例	示例: `100.0`
32	`electricityCardDeduct`	number	`electricitycarddeduct`	电费卡扣	大小写匹配；示例: `0.0`
33	`tableCardDeduct`	number	`tablecarddeduct`	（待补充）	大小写匹配；示例: `0.0`
34	`tableServiceCardDeduct`	number	`tableservicecarddeduct`	（待补充）	大小写匹配；示例: `0.0`
35	`goodsCarDeduct`	number	`goodscardeduct`	（待补充）	大小写匹配；示例: `0.0`
36	`goodsServiceCardDeduct`	number	`goodsservicecarddeduct`	（待补充）	大小写匹配；示例: `0.0`
37	`assistantCardDeduct`	number	`assistantcarddeduct`	（待补充）	大小写匹配；示例: `0.0`
38	`assistantServiceCardDeduct`	number	`assistantservicecarddeduct`	（待补充）	大小写匹配；示例: `0.0`
39	`assistantRewardCardDeduct`	number	`assistantrewardcarddeduct`	（待补充）	大小写匹配；示例: `0.0`
40	`couponCardDeduct`	number	`couponcarddeduct`	（待补充）	大小写匹配；示例: `0.0`
41	`deliveryFeeDeduct`	number	`deliveryfeededuct`	（待补充）	大小写匹配；示例: `0.0`
42	`is_allow_order_deduct`	integer	`is_allow_order_deduct`	是否允许在“订单层面统一扣款”	示例: `0`
43	`member_grade`	integer	`member_grade`	会员等级	枚举值: `2790683528022856`, `2790683528022853`, `2790683528022855`, `2790683528022857`, `0`, `2790683528022854`
44	`able_share_member_discount`	integer	`able_share_member_discount`	是否可共享会员折扣	示例: `1`
45	`rechargeFreezeBalance`	number	`rechargefreezebalance`	充值冻结余额	大小写匹配；示例: `0.0`
46	`id`	integer	`id`	本表主键 ID，用于唯一标识一条记录	枚举值: `3085176959321669`, `3066773307755845`, `3062388522452485`, `3055567606646661`, `3055177241628037`, `3055176919745925`, `3054195913755845`, `3054195562007941`
47	`assistant_discount`	number	`assistant_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
48	`assistant_reward_discount`	number	`assistant_reward_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
49	`bind_password`	string	`bind_password`	卡绑定密码，用于消费或查询验证（目前未启用）
50	`card_no`	string	`card_no`	实体卡物理卡号／条码号
51	`card_physics_type`	integer	`card_physics_type`	物理卡类型	示例: `1`
52	`card_type_id`	integer	`card_type_id`	卡种 ID（定义“这是哪一种卡”）	枚举值: `2793266846533445`, `2793249295533893`, `2791990152417157`, `2793306611533637`, `2794699703437125`
53	`create_time`	string	`create_time`	卡片创建时间（开卡时间）	枚举值: `2026-02-07 21:04:20`, `2026-01-25 21:03:10`, `2026-01-22 18:42:44`, `2026-01-17 23:04:08`, `2026-01-17 16:27:02`, `2026-01-17 16:26:43`, `2026-01-16 23:48:47`, `2026-01-16 23:48:25`
54	`denomination`	number	`denomination`	采用“几折”的记法：10=不打折，9=九折，8=八折	示例: `0.0`
55	`disable_end_time`	string	`disable_end_time`	停用时间段（比如临时冻结卡的起止时间）	示例: `0001-01-01 00:00:00`
56	`disable_start_time`	string	`disable_start_time`	停用时间段（比如临时冻结卡的起止时间）	示例: `0001-01-01 00:00:00`
57	`effect_site_id`	integer	`effect_site_id`	卡片限定生效门店 ID	示例: `0`
58	`end_time`	string	`end_time`	卡片有效期结束时间	枚举值: `2225-01-01 00:00:00`, `2025-12-29 18:36:43`, `2025-11-22 20:00:54`, `2025-10-16 19:04:52`, `2025-10-14 18:55:53`, `2025-08-30 15:31:33`
59	`goods_discount`	number	`goods_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
60	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
61	`last_consume_time`	string	`last_consume_time`	最近一次消费时间	枚举值: `2026-02-11 17:12:24`, `2026-01-28 13:11:46`, `2026-02-02 23:05:28`, `2026-01-17 23:31:05`, `2026-02-06 16:09:21`, `2026-01-28 23:54:57`, `2026-02-01 19:46:39`, `2026-01-20 07:19:17`
62	`member_card_grade_code`	integer	`member_card_grade_code`	卡等级/卡类代码，和下面两个名称字段一一对应	枚举值: `2790683528022856`, `2790683528022853`, `2790683528022855`, `2790683528022857`, `2790683528022858`
63	`principal_balance`	number	`principal_balance`	本金余额	枚举值: `0.0`, `796.6`, `88.0`, `2479.49`, `2298.76`, `111.06`, `871.0`, `488.77`
64	`register_site_id`	integer	`register_site_id`	卡首次办理的门店 ID	示例: `2790685415443269`
65	`sort`	integer	`sort`	在前端展示或某些列表中的排序权重	示例: `1`
66	`start_time`	string	`start_time`	卡片生效开始时间（有效期起始）	枚举值: `2026-02-07 21:04:20`, `2026-01-25 21:03:10`, `2026-01-22 18:42:44`, `2026-01-17 23:04:08`, `2026-01-17 16:27:02`, `2026-01-17 16:26:43`, `2026-01-16 23:48:47`, `2026-01-16 23:48:25`
67	`status`	integer	`status`	状态枚举，用于标识记录当前业务状态	枚举值: `1`, `4`
68	`system_member_id`	integer	`system_member_id`	系统级会员 ID（跨门店统一主键）	枚举值: `3085176956307013`, `3066773300268357`, `3062388519667205`, `2799207086114565`, `3055176917108101`, `3054195559402885`, `3052749336856197`, `3048238810220293`
69	`table_discount`	number	`table_discount`	数量/时长字段，用于统计与计量	示例: `10.0`
70	`tenant_id`	integer	`tenant_id`	租户/品牌 ID，与其他 JSON 中 tenant_id 一致	示例: `2790683160709957`
71	`tenant_member_id`	integer	`tenant_member_id`	当前商户（品牌/租户）中会员的主键 ID	枚举值: `3085176958944837`, `3066773303512389`, `3062388521698821`, `2799207087163141`, `3055176918828421`, `3054195561631109`, `3052749341853317`, `3048238811858693`

ODS 表结构 — ods.member_stored_value_cards 🔗 API

共 80 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`tenant_id`	bigint	`tenant_id`	`dim_member_card_account.tenant_id`	租户/品牌 ID，与其他 JSON 中 tenant_id 一致
2	`tenant_member_id`	bigint	`tenant_member_id`	`dim_member_card_account.tenant_member_id`	当前商户（品牌/租户）中会员的主键 ID
3	`system_member_id`	bigint	`system_member_id`	`dim_member_card_account.system_member_id`	系统级会员 ID（跨门店统一主键）
4	`register_site_id`	bigint	`register_site_id`	`dim_member_card_account.register_site_id`	卡首次办理的门店 ID
5	`site_name`	text	`site_name`	`dim_member_card_account_ex.site_name`	卡归属门店名称（视图中的展示字段）
6	`id`	bigint	`id`	`dim_member_card_account.member_card_id`, `dim_member_card_account_ex.member_card_id`	本表主键 ID，用于唯一标识一条记录
7	`member_card_grade_code`	bigint	`member_card_grade_code`	`dim_member_card_account.member_card_grade_code`	卡等级/卡类代码，和下面两个名称字段一一对应
8	`member_card_grade_code_name`	text	`member_card_grade_code_name`	`dim_member_card_account.member_card_grade_code_name`	卡等级/卡类名称
9	`member_card_type_name`	text	`member_card_type_name`	`dim_member_card_account.member_card_type_name`	卡类型名称，实际与 member_card_grade_code_name 一致
10	`member_name`	text	`member_name`	`dim_member_card_account.member_name`	持卡会员姓名快照
11	`member_mobile`	text	`member_mobile`	`dim_member_card_account.member_mobile`	持卡会员手机号快照
12	`card_type_id`	bigint	`card_type_id`	`dim_member_card_account.card_type_id`	卡种 ID（定义“这是哪一种卡”）
13	`card_no`	text	`card_no`	`dim_member_card_account_ex.card_no`	实体卡物理卡号／条码号
14	`card_physics_type`	text	`card_physics_type`	`dim_member_card_account_ex.card_physics_type`	物理卡类型
15	`balance`	numeric	`balance`	`dim_member_card_account.balance`	当前卡内余额（主要针对储值卡、部分券卡）
16	`denomination`	numeric	`denomination`	`dim_member_card_account_ex.denomination`	采用“几折”的记法：10=不打折，9=九折，8=八折
17	`table_discount`	numeric	`table_discount`	`dim_member_card_account_ex.table_discount`	数量/时长字段，用于统计与计量
18	`goods_discount`	numeric	`goods_discount`	`dim_member_card_account_ex.goods_discount`	数量/时长字段，用于统计与计量
19	`assistant_discount`	numeric	`assistant_discount`	`dim_member_card_account_ex.assistant_discount`	数量/时长字段，用于统计与计量
20	`assistant_reward_discount`	numeric	`assistant_reward_discount`	`dim_member_card_account_ex.assistant_reward_discount`	数量/时长字段，用于统计与计量
21	`table_service_discount`	numeric	`table_service_discount`	`dim_member_card_account_ex.table_service_discount`	数量/时长字段，用于统计与计量
22	`assistant_service_discount`	numeric	`assistant_service_discount`	`dim_member_card_account_ex.assistant_service_discount`	数量/时长字段，用于统计与计量
23	`coupon_discount`	numeric	`coupon_discount`	`dim_member_card_account_ex.coupon_discount`	数量/时长字段，用于统计与计量
24	`goods_service_discount`	numeric	`goods_service_discount`	`dim_member_card_account_ex.goods_service_discount`	数量/时长字段，用于统计与计量
25	`assistant_discount_sub_switch`	integer	`assistant_discount_sub_switch`	`dim_member_card_account_ex.assistant_discount_sub_switch`	数量/时长字段，用于统计与计量
26	`table_discount_sub_switch`	integer	`table_discount_sub_switch`	`dim_member_card_account_ex.table_discount_sub_switch`	数量/时长字段，用于统计与计量
27	`goods_discount_sub_switch`	integer	`goods_discount_sub_switch`	`dim_member_card_account_ex.goods_discount_sub_switch`	数量/时长字段，用于统计与计量
28	`assistant_reward_discount_sub_switch`	integer	`assistant_reward_discount_sub_switch`	`dim_member_card_account_ex.assistant_reward_discount_sub_switch`	数量/时长字段，用于统计与计量
29	`table_service_deduct_radio`	numeric	`table_service_deduct_radio`	`dim_member_card_account_ex.table_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
30	`assistant_service_deduct_radio`	numeric	`assistant_service_deduct_radio`	`dim_member_card_account_ex.assistant_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
31	`goods_service_deduct_radio`	numeric	`goods_service_deduct_radio`	`dim_member_card_account_ex.goods_service_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
32	`assistant_deduct_radio`	numeric	`assistant_deduct_radio`	`dim_member_card_account_ex.assistant_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
33	`table_deduct_radio`	numeric	`table_deduct_radio`	`dim_member_card_account_ex.table_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
34	`goods_deduct_radio`	numeric	`goods_deduct_radio`	`dim_member_card_account_ex.goods_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
35	`coupon_deduct_radio`	numeric	`coupon_deduct_radio`	`dim_member_card_account_ex.coupon_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
36	`assistant_reward_deduct_radio`	numeric	`assistant_reward_deduct_radio`	`dim_member_card_account_ex.assistant_reward_deduct_radio`	金额字段，用于计费/结算/分摊等金额计算
37	`tablecarddeduct`	numeric	`tableCardDeduct`	`dim_member_card_account_ex.tablecarddeduct`	（待补充）
38	`tableservicecarddeduct`	numeric	`tableServiceCardDeduct`	`dim_member_card_account_ex.tableservicecarddeduct`	（待补充）
39	`goodscardeduct`	numeric	`goodsCarDeduct`	`dim_member_card_account_ex.goodscardeduct`	（待补充）
40	`goodsservicecarddeduct`	numeric	`goodsServiceCardDeduct`	`dim_member_card_account_ex.goodsservicecarddeduct`	（待补充）
41	`assistantcarddeduct`	numeric	`assistantCardDeduct`	`dim_member_card_account_ex.assistantcarddeduct`	（待补充）
42	`assistantservicecarddeduct`	numeric	`assistantServiceCardDeduct`	`dim_member_card_account_ex.assistantservicecarddeduct`	（待补充）
43	`assistantrewardcarddeduct`	numeric	`assistantRewardCardDeduct`	`dim_member_card_account_ex.assistantrewardcarddeduct`	（待补充）
44	`cardsettlededuct`	numeric	`cardSettleDeduct`	`dim_member_card_account_ex.cardsettlededuct`	（待补充）
45	`couponcarddeduct`	numeric	`couponCardDeduct`	`dim_member_card_account_ex.couponcarddeduct`	（待补充）
46	`deliveryfeededuct`	numeric	`deliveryFeeDeduct`	`dim_member_card_account_ex.deliveryfeededuct`	（待补充）
47	`use_scene`	integer	`use_scene`	`dim_member_card_account_ex.use_scene`	卡使用场景说明（比如“仅店内使用”“仅团建”等），本门店尚未使用此字段
48	`able_cross_site`	integer	`able_cross_site`	`dim_member_card_account_ex.able_cross_site`	是否允许跨店使用
49	`is_allow_give`	integer	`is_allow_give`	`dim_member_card_account_ex.is_allow_give`	是否允许转赠/转让给其他会员
50	`is_allow_order_deduct`	integer	`is_allow_order_deduct`	`dim_member_card_account_ex.is_allow_order_deduct`	是否允许在“订单层面统一扣款”
51	`is_delete`	integer	`is_delete`	`dim_member_card_account.is_delete`	逻辑删除标志
52	`bind_password`	text	`bind_password`	`dim_member_card_account_ex.bind_password`	卡绑定密码，用于消费或查询验证（目前未启用）
53	`goods_discount_range_type`	integer	`goods_discount_range_type`	`dim_member_card_account_ex.goods_discount_range_type`	数量/时长字段，用于统计与计量
54	`goodscategoryid`	bigint	—	`dim_member_card_account_ex.goodscategoryid`	（待补充）
55	`tableareaid`	bigint	—	`dim_member_card_account_ex.tableareaid`	（待补充）
56	`effect_site_id`	bigint	`effect_site_id`	`dim_member_card_account_ex.effect_site_id`	卡片限定生效门店 ID
57	`start_time`	timestamp without time zone	`start_time`	`dim_member_card_account.start_time`	卡片生效开始时间（有效期起始）
58	`end_time`	timestamp without time zone	`end_time`	`dim_member_card_account.end_time`	卡片有效期结束时间
59	`disable_start_time`	timestamp without time zone	`disable_start_time`	`dim_member_card_account_ex.disable_start_time`	停用时间段（比如临时冻结卡的起止时间）
60	`disable_end_time`	timestamp without time zone	`disable_end_time`	`dim_member_card_account_ex.disable_end_time`	停用时间段（比如临时冻结卡的起止时间）
61	`last_consume_time`	timestamp without time zone	`last_consume_time`	`dim_member_card_account.last_consume_time`	最近一次消费时间
62	`create_time`	timestamp without time zone	`create_time`	`dim_member_card_account_ex.create_time`	卡片创建时间（开卡时间）
63	`status`	integer	`status`	`dim_member_card_account.status`	状态枚举，用于标识记录当前业务状态
64	`sort`	integer	`sort`	`dim_member_card_account_ex.sort`	在前端展示或某些列表中的排序权重
65	`tenantavatar`	text	`tenantAvatar`	`dim_member_card_account_ex.tenantavatar`	（待补充）
66	`tenantname`	text	`tenantName`	`dim_member_card_account_ex.tenant_name`	（待补充）
67	`pdassisnatlevel`	text	—	`dim_member_card_account_ex.pdassisnatlevel`	（待补充）
68	`cxassisnatlevel`	text	—	`dim_member_card_account_ex.cxassisnatlevel`	（待补充）
69	`able_share_member_discount`	boolean	`able_share_member_discount`	`dim_member_card_account_ex.able_share_member_discount`	是否可共享会员折扣
70	`electricity_deduct_radio`	numeric	`electricity_deduct_radio`	`dim_member_card_account_ex.electricity_deduct_radio`	电费扣减比例
71	`electricity_discount`	numeric	`electricity_discount`	`dim_member_card_account_ex.electricity_discount`	电费折扣
72	`electricitycarddeduct`	boolean	`electricityCardDeduct`	`dim_member_card_account_ex.electricity_card_deduct`	电费卡扣
73	`member_grade`	bigint	`member_grade`	`dim_member_card_account.member_grade`	会员等级
74	`principal_balance`	numeric	`principal_balance`	`dim_member_card_account.principal_balance`	本金余额
75	`rechargefreezebalance`	numeric	`rechargeFreezeBalance`	`dim_member_card_account_ex.recharge_freeze_balance`	充值冻结余额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_member_card_account 🔗 ODS

共 23 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`member_card_id`	bigint	`id`	直接	会员卡账户 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`register_site_id`	bigint	`register_site_id`	直接	开卡门店 ID → dim_site
4	`tenant_member_id`	bigint	`tenant_member_id`	直接	持卡会员 ID → dim_member（0=未绑定会员）
5	`system_member_id`	bigint	`system_member_id`	直接	系统级会员 ID
6	`card_type_id`	bigint	`card_type_id`	直接	卡种 ID
7	`member_card_grade_code`	bigint	`member_card_grade_code`	直接	卡等级代码
8	`member_card_grade_code_name`	text	`member_card_grade_code_name`	直接	卡等级名称。枚举值: "储值卡", "台费卡", "活动抵用券", "酒水卡", "月卡", "年卡"
9	`member_card_type_name`	text	`member_card_type_name`	直接	卡类型名称（与 grade_code_name 相同）
10	`member_name`	text	`member_name`	直接	持卡人姓名快照
11	`member_mobile`	text	`member_mobile`	直接	持卡人手机号快照
12	`balance`	numeric	`balance`	直接	当前余额（元）
13	`start_time`	timestamp with time zone	`start_time`	直接	卡生效时间
14	`end_time`	timestamp with time zone	`end_time`	直接	卡失效时间（2225-01-01=长期有效）
15	`last_consume_time`	timestamp with time zone	`last_consume_time`	直接	最近消费时间
16	`status`	integer	`status`	直接	卡状态。枚举值: 1=正常, 4=过期
17	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
18	`principal_balance`	numeric	`principal_balance`	直接	本金余额
19	`member_grade`	bigint	`member_grade`	直接	会员等级
20	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
21	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
22	`scd2_is_current`	integer	—	SCD2	当前版本标记
23	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_member_card_account_ex 🔗 ODS

共 61 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`member_card_id`	bigint	`id`	直接	字段重命名
2	`site_name`	text	`site_name`	直接	同名直传
3	`tenant_name`	character varying	`tenantname`	直接	字段重命名
4	`tenantavatar`	text	`tenantavatar`	直接	维度字段，用于补充维度属性
5	`effect_site_id`	bigint	`effect_site_id`	直接	同名直传
6	`able_cross_site`	integer	`able_cross_site`	直接	同名直传
7	`card_physics_type`	integer	`card_physics_type`	直接	同名直传
8	`card_no`	text	`card_no`	直接	维度字段，用于补充维度属性
9	`bind_password`	text	`bind_password`	直接	维度字段，用于补充维度属性
10	`use_scene`	text	`use_scene`	直接	维度字段，用于补充维度属性
11	`denomination`	numeric	`denomination`	直接	同名直传
12	`create_time`	timestamp with time zone	`create_time`	直接	同名直传
13	`disable_start_time`	timestamp with time zone	`disable_start_time`	直接	同名直传
14	`disable_end_time`	timestamp with time zone	`disable_end_time`	直接	同名直传
15	`is_allow_give`	integer	`is_allow_give`	直接	同名直传
16	`is_allow_order_deduct`	integer	`is_allow_order_deduct`	直接	同名直传
17	`sort`	integer	`sort`	直接	同名直传
18	`table_discount`	numeric	`table_discount`	直接	同名直传
19	`goods_discount`	numeric	`goods_discount`	直接	同名直传
20	`assistant_discount`	numeric	`assistant_discount`	直接	同名直传
21	`assistant_reward_discount`	numeric	`assistant_reward_discount`	直接	同名直传
22	`table_service_discount`	numeric	`table_service_discount`	直接	同名直传
23	`goods_service_discount`	numeric	`goods_service_discount`	直接	同名直传
24	`assistant_service_discount`	numeric	`assistant_service_discount`	直接	同名直传
25	`coupon_discount`	numeric	`coupon_discount`	直接	同名直传
26	`table_discount_sub_switch`	integer	`table_discount_sub_switch`	直接	同名直传
27	`goods_discount_sub_switch`	integer	`goods_discount_sub_switch`	直接	同名直传
28	`assistant_discount_sub_switch`	integer	`assistant_discount_sub_switch`	直接	同名直传
29	`assistant_reward_discount_sub_switch`	integer	`assistant_reward_discount_sub_switch`	直接	同名直传
30	`goods_discount_range_type`	integer	`goods_discount_range_type`	直接	同名直传
31	`table_deduct_radio`	numeric	`table_deduct_radio`	直接	同名直传
32	`goods_deduct_radio`	numeric	`goods_deduct_radio`	直接	同名直传
33	`assistant_deduct_radio`	numeric	`assistant_deduct_radio`	直接	同名直传
34	`table_service_deduct_radio`	numeric	`table_service_deduct_radio`	直接	同名直传
35	`goods_service_deduct_radio`	numeric	`goods_service_deduct_radio`	直接	同名直传
36	`assistant_service_deduct_radio`	numeric	`assistant_service_deduct_radio`	直接	同名直传
37	`assistant_reward_deduct_radio`	numeric	`assistant_reward_deduct_radio`	直接	同名直传
38	`coupon_deduct_radio`	numeric	`coupon_deduct_radio`	直接	同名直传
39	`cardsettlededuct`	numeric	`cardsettlededuct`	直接	同名直传
40	`tablecarddeduct`	numeric	`tablecarddeduct`	直接	同名直传
41	`tableservicecarddeduct`	numeric	`tableservicecarddeduct`	直接	同名直传
42	`goodscardeduct`	numeric	`goodscardeduct`	直接	同名直传
43	`goodsservicecarddeduct`	numeric	`goodsservicecarddeduct`	直接	同名直传
44	`assistantcarddeduct`	numeric	`assistantcarddeduct`	直接	同名直传
45	`assistantservicecarddeduct`	numeric	`assistantservicecarddeduct`	直接	同名直传
46	`assistantrewardcarddeduct`	numeric	`assistantrewardcarddeduct`	直接	同名直传
47	`couponcarddeduct`	numeric	`couponcarddeduct`	直接	同名直传
48	`deliveryfeededuct`	numeric	`deliveryfeededuct`	直接	同名直传
49	`tableareaid`	text	`tableareaid`	直接	维度字段，用于补充维度属性
50	`goodscategoryid`	text	`goodscategoryid`	直接	维度字段，用于补充维度属性
51	`pdassisnatlevel`	text	`pdassisnatlevel`	直接	同名直传
52	`cxassisnatlevel`	text	`cxassisnatlevel`	直接	同名直传
53	`able_share_member_discount`	boolean	`able_share_member_discount`	→ boolean
54	`electricity_deduct_radio`	numeric	`electricity_deduct_radio`	直接
55	`electricity_discount`	numeric	`electricity_discount`	直接
56	`electricity_card_deduct`	boolean	`electricitycarddeduct`	→ boolean	字段重命名
57	`recharge_freeze_balance`	numeric	`rechargefreezebalance`	直接	字段重命名
58	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
59	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
60	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
61	`scd2_version`	integer	—	SCD2	SCD2 元数据

3.12 member_balance_changes（会员余额变动）

任务代码：ODS_MEMBER_BALANCE
采样记录数：200
API JSON 字段数：28
ODS 列数：33
DWD 目标表：dwd_member_balance_change, dwd_member_balance_change_ex

API 源字段 — member_balance_changes 🔗 ODS

已映射 28/28，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`memberCardTypeName`	string	`membercardtypename`	（待补充）	大小写匹配；枚举值: `储值卡`, `活动抵用券`, `酒水卡`, `台费卡`
2	`paySiteName`	string	`paysitename`	（待补充）	大小写匹配；示例: `朗朗桌球`
3	`registerSiteName`	string	`registersitename`	（待补充）	大小写匹配；示例: `朗朗桌球`
4	`memberName`	string	`membername`	（待补充）	大小写匹配；枚举值: `罗先生`, `张先生`, `陈先生`, `轩哥`, `胡先生`, `曾丹烨`, `果`, `李先生`
5	`memberMobile`	string	`membermobile`	（待补充）	大小写匹配；枚举值: `13924036996`, `13902258852`, `13535220066`, `18826267530`, `13394654634`, `13922213242`, `13902203836`, `18825868576`
6	`id`	integer	`id`	余额变更记录的主键 ID，唯一标识这一条“账户余额变化事件”	枚举值: `3093844118358341`, `3093650318379141`, `3093649004579013`, `3093365819410565`, `3092712423049413`, `3092443610270021`, `3092315441612997`, `3092248235444421`
7	`account_data`	number	`account_data`	本次变动的金额（元），正数表示增加，负数表示减少	枚举值: `-232.0`, `-125.0`, `-18.0`, `-300.0`, `-4285.55`, `-43.61`, `-132.0`, `-71.07`
8	`after`	number	`after`	本次变动后，该卡账户的余额（元）	枚举值: `110.64`, `3657.58`, `3782.58`, `1709.69`, `3255.83`, `0.0`, `2722.73`, `373.91`
9	`before`	number	`before`	本次变动前，该卡账户的余额（元）	枚举值: `342.64`, `3782.58`, `3800.58`, `2009.69`, `7541.38`, `43.61`, `2854.73`, `444.98`
10	`card_type_id`	integer	`card_type_id`	卡种类型 ID，用于区分不同卡种	枚举值: `2793249295533893`, `2793266846533445`, `2794699703437125`, `2791990152417157`
11	`create_time`	string	`create_time`	本条余额变更记录的创建时间，通常接近交易发生时间	枚举值: `2026-02-14 00:01:01`, `2026-02-13 20:43:53`, `2026-02-13 20:42:32`, `2026-02-13 15:54:28`, `2026-02-13 04:49:48`, `2026-02-13 00:16:21`, `2026-02-12 22:05:58`, `2026-02-12 20:57:36`
12	`from_type`	integer	`from_type`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `2`, `4`, `3`, `9`
13	`is_delete`	integer	`is_delete`	逻辑删除标记（0=否，1=是）	示例: `0`
14	`operator_id`	integer	`operator_id`	执行此次余额变更操作的员工 ID	枚举值: `2790687322443013`, `2790687633313029`, `2800457030093701`, `2800459869441029`
15	`operator_name`	string	`operator_name`	操作员姓名（带职位前缀），是对 operator_id 的可读冗余字段	枚举值: `收银员:郑丽珊`, `店长:蒋雨轩`, `店长:郑丽珊`, `管理员：郑丽珊`, `店长:黄月柳`, `店长:谢晓洪`
16	`payment_method`	integer	`payment_method`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `0`, `3`, `4`
17	`refund_amount`	number	`refund_amount`	可能用于标记“其中有多少金额是以‘退款’形式回流的”，或区分“退回余额”和“原路退回”两种模式	示例: `0.0`
18	`register_site_id`	integer	`register_site_id`	会员卡的“注册门店 ID”，即办卡所在门店	示例: `2790685415443269`
19	`relate_id`	integer	`relate_id`	例如某次充值记录的 ID、某张订单/结算单 ID、某次活动抵用券核销记录 ID 等	枚举值: `3093843703564549`, `3093650242373957`, `3093648911108293`, `3093365762853125`, `3092711340902597`, `3092443433306437`, `3092315370047749`, `3092248181688581`
20	`remark`	string	`remark`	当为空时，说明这条变动没有额外备注说明
21	`site_id`	integer	`site_id`	非 0：记录所属的具体门店 ID（与其他 JSON 内的 site_id 一致）	枚举值: `2790685415443269`, `0`
22	`system_member_id`	integer	`system_member_id`	系统级（全局）会员 ID	枚举值: `2799207358777093`, `2799207405995781`, `2799210152216325`, `2799207521568517`, `2849995547528133`, `2799212844549893`, `2799207074645765`, `2799207466075909`
23	`tenant_id`	integer	`tenant_id`	租户/商户 ID，本数据中是固定值（同一品牌/商户）	示例: `2790683160709957`
24	`tenant_member_card_id`	integer	`tenant_member_card_id`	会员卡账户 ID，在租户内唯一标识某张卡	枚举值: `2799218552833797`, `2815108067970885`, `2799218599413509`, `2799217444914949`, `2849995548871621`, `2799219999295237`, `2799215892219653`, `2799216936748805`
25	`tenant_member_id`	integer	`tenant_member_id`	商户维度的会员 ID（租户内会员主键）	枚举值: `2799207359858437`, `2799207406946053`, `2799210153232133`, `2799207522600709`, `2849995548625861`, `2799212845565701`, `2799207075874565`, `2799207467042565`
26	`principal_after`	number	`principal_after`	变动后本金	枚举值: `110.64`, `0.0`, `1709.69`, `3255.83`, `2722.73`, `373.91`, `255.6`, `111.06`
27	`principal_before`	number	`principal_before`	变动前本金	枚举值: `342.64`, `0.0`, `2009.69`, `7541.38`, `43.61`, `2854.73`, `444.98`, `313.6`
28	`principal_data`	number	`principal_data`	本金变动数据	枚举值: `-232.0`, `0.0`, `-300.0`, `-4285.55`, `-43.61`, `-132.0`, `-71.07`, `-58.0`

ODS 表结构 — ods.member_balance_changes 🔗 API

共 33 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`tenant_id`	bigint	`tenant_id`	`dwd_member_balance_change.tenant_id`	租户/商户 ID，本数据中是固定值（同一品牌/商户）
2	`site_id`	bigint	`site_id`	`dwd_member_balance_change.site_id`	非 0：记录所属的具体门店 ID（与其他 JSON 内的 site_id 一致）
3	`register_site_id`	bigint	`register_site_id`	`dwd_member_balance_change.register_site_id`	会员卡的“注册门店 ID”，即办卡所在门店
4	`registersitename`	text	`registerSiteName`	`dwd_member_balance_change_ex.register_site_name`	（待补充）
5	`paysitename`	text	`paySiteName`	`dwd_member_balance_change_ex.pay_site_name`	（待补充）
6	`id`	bigint	`id`	`dwd_member_balance_change.balance_change_id`, `dwd_member_balance_change_ex.balance_change_id`	余额变更记录的主键 ID，唯一标识这一条“账户余额变化事件”
7	`tenant_member_id`	bigint	`tenant_member_id`	`dwd_member_balance_change.tenant_member_id`	商户维度的会员 ID（租户内会员主键）
8	`tenant_member_card_id`	bigint	`tenant_member_card_id`	`dwd_member_balance_change.tenant_member_card_id`	会员卡账户 ID，在租户内唯一标识某张卡
9	`system_member_id`	bigint	`system_member_id`	`dwd_member_balance_change.system_member_id`	系统级（全局）会员 ID
10	`membername`	text	`memberName`	`dwd_member_balance_change.member_name`	（待补充）
11	`membermobile`	text	`memberMobile`	`dwd_member_balance_change.member_mobile`	（待补充）
12	`card_type_id`	bigint	`card_type_id`	`dwd_member_balance_change.card_type_id`	卡种类型 ID，用于区分不同卡种
13	`membercardtypename`	text	`memberCardTypeName`	`dwd_member_balance_change.card_type_name`	（待补充）
14	`account_data`	numeric	`account_data`	`dwd_member_balance_change.change_amount`	本次变动的金额（元），正数表示增加，负数表示减少
15	`before`	numeric	`before`	`dwd_member_balance_change.balance_before`	本次变动前，该卡账户的余额（元）
16	`after`	numeric	`after`	`dwd_member_balance_change.balance_after`	本次变动后，该卡账户的余额（元）
17	`refund_amount`	numeric	`refund_amount`	`dwd_member_balance_change_ex.refund_amount`	可能用于标记“其中有多少金额是以‘退款’形式回流的”，或区分“退回余额”和“原路退回”两种模式
18	`from_type`	integer	`from_type`	`dwd_member_balance_change.from_type`	来自 JSON 导出的原始字段，用于保留业务取值
19	`payment_method`	integer	`payment_method`	`dwd_member_balance_change.payment_method`	来自 JSON 导出的原始字段，用于保留业务取值
20	`relate_id`	bigint	`relate_id`	`dwd_member_balance_change_ex.relate_id`	例如某次充值记录的 ID、某张订单/结算单 ID、某次活动抵用券核销记录 ID 等
21	`remark`	text	`remark`	`dwd_member_balance_change.remark`	当为空时，说明这条变动没有额外备注说明
22	`operator_id`	bigint	`operator_id`	`dwd_member_balance_change_ex.operator_id`	执行此次余额变更操作的员工 ID
23	`operator_name`	text	`operator_name`	`dwd_member_balance_change_ex.operator_name`	操作员姓名（带职位前缀），是对 operator_id 的可读冗余字段
24	`is_delete`	integer	`is_delete`	`dwd_member_balance_change.is_delete`	逻辑删除标记（0=否，1=是）
25	`create_time`	timestamp without time zone	`create_time`	`dwd_member_balance_change.change_time`	本条余额变更记录的创建时间，通常接近交易发生时间
26	`principal_after`	numeric	`principal_after`	`dwd_member_balance_change.principal_after`	变动后本金
27	`principal_before`	numeric	`principal_before`	`dwd_member_balance_change.principal_before`	变动前本金
28	`principal_data`	text	`principal_data`	`dwd_member_balance_change_ex.principal_data`	本金变动数据

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_member_balance_change 🔗 ODS

共 22 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`balance_change_id`	bigint	`id`	直接	变动流水 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`site_id`	bigint	`site_id`	直接	门店 ID
4	`register_site_id`	bigint	`register_site_id`	直接	注册门店 ID
5	`tenant_member_id`	bigint	`tenant_member_id`	直接	会员 ID → dim_member
6	`system_member_id`	bigint	`system_member_id`	直接	系统会员 ID
7	`tenant_member_card_id`	bigint	`tenant_member_card_id`	直接	会员卡 ID → dim_member_card_account
8	`card_type_id`	bigint	`card_type_id`	直接	卡类型 ID
9	`card_type_name`	character varying	`membercardtypename`	直接	卡类型名称。枚举值: "储值卡", "活动抵用券", "台费卡", "酒水卡", "年卡", "月卡"
10	`member_name`	character varying	`membername`	直接	会员名称快照
11	`member_mobile`	character varying	`membermobile`	直接	会员手机号快照
12	`balance_before`	numeric	`before`	直接	变动前余额
13	`change_amount`	numeric	`account_data`	直接	变动金额（正=充值/赠送，负=消费）
14	`balance_after`	numeric	`after`	直接	变动后余额
15	`from_type`	integer	`from_type`	直接	变动来源。枚举值: 1=结账/消费, 2=结账撤销, 3=现付充值, 4=活动赠送, 7=充值撤销/退款,...
16	`payment_method`	integer	`payment_method`	直接	支付方式，暂未启用。
17	`change_time`	timestamp with time zone	`create_time`	直接	变动时间
18	`is_delete`	integer	`is_delete`	直接	删除标记
19	`remark`	character varying	`remark`	直接	备注。样本值: "注销会员", "充值退款" 等
20	`principal_before`	numeric	`principal_before`	直接	变动前本金
21	`principal_after`	numeric	`principal_after`	直接	变动后本金
22	`principal_change_amount`	numeric	`COALESCE(CAST(principal_after AS numeric),0) - COALESCE(CAST(principal_before AS numeric),0)`	→ numeric	本金变动金额（正=增加，负=减少）

DWD 表结构 — dwd.dwd_member_balance_change_ex 🔗 ODS

共 8 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`balance_change_id`	bigint	`id`	直接	字段重命名
2	`pay_site_name`	character varying	`paysitename`	直接	字段重命名
3	`register_site_name`	character varying	`registersitename`	直接	字段重命名
4	`refund_amount`	numeric	`refund_amount`	直接	同名直传
5	`operator_id`	bigint	`operator_id`	直接	同名直传
6	`operator_name`	character varying	`operator_name`	直接	同名直传
7	`principal_data`	text	`principal_data`	直接
8	`relate_id`	bigint	`relate_id`	直接	关联业务单据 ID，指向触发本次余额变动的业务记录（如充值单、订单、结算单等），按 from_type 不同指向不同表

3.13 recharge_settlements（充值结算）

任务代码：ODS_RECHARGE_SETTLE
采样记录数：191
API JSON 字段数：92
ODS 列数：71
DWD 目标表：dwd_recharge_order, dwd_recharge_order_ex

API 源字段 — recharge_settlements 🔗 ODS

已映射 67/92，覆盖率 72.8% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`settleList.id`	integer	`id`	门店 ID	枚举值: `3087072625102533`, `3087072183438981`, `3086802110271237`, `3085662010822277`, `3084086428765829`, `3083626062351877`, `3083418544754181`, `3082874684165765`
2	`settleList.tenantId`	integer	`tenantid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790683160709957`
3	`settleList.siteId`	integer	`siteid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790685415443269`
4	`settleList.siteName`	string	`sitename`	名称字段，用于展示与辅助识别	大小写匹配
5	`settleList.balanceAmount`	number	`balanceamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
6	`settleList.cardAmount`	number	`cardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
7	`settleList.cashAmount`	number	`cashamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
8	`settleList.couponAmount`	number	`couponamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
9	`settleList.createTime`	string	`createtime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；枚举值: `2026-02-09 05:12:42`, `2026-02-09 05:12:15`, `2026-02-09 00:37:31`, `2026-02-08 05:17:45`, `2026-02-07 02:34:59`, `2026-02-06 18:46:41`, `2026-02-06 15:15:35`, `2026-02-06 06:02:20`
10	`settleList.memberId`	integer	`memberid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `2799207363643141`, `2799207522600709`, `2969257129938053`, `2799207124305669`, `2799207359858437`, `2849995548625861`, `2799212430657285`, `2799207406946053`
11	`settleList.memberName`	string	`membername`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `葛先生`, `轩哥`, `小燕`, `陈腾鑫`, `罗先生`, `胡先生`, `黄先生`, `张先生`
12	`settleList.tenantMemberCardId`	integer	`tenantmembercardid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `2799216572794629`, `2799217444914949`, `2969257130232965`, `2799215988246277`, `2799218552833797`, `2849995548871621`, `2799219055920901`, `2799217231906565`
13	`settleList.memberCardTypeName`	string	`membercardtypename`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `储值卡`, `月卡`
14	`settleList.memberPhone`	string	`memberphone`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `13811638071`, `18826267530`, `17802081334`, `17817318218`, `13924036996`, `13394654634`, `13570163507`, `13902258852`
15	`settleList.tableId`	integer	`tableid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
16	`settleList.consumeMoney`	number	`consumemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `10000.0`, `3000.0`, `1000.0`, `298.0`, `-10000.0`, `5000.0`, `1200.0`, `-3000.0`
17	`settleList.onlineAmount`	number	`onlineamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
18	`settleList.operatorId`	integer	`operatorid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2790687322443013`
19	`settleList.operatorName`	string	`operatorname`	名称字段，用于展示与辅助识别	大小写匹配；示例: `收银员:郑丽珊`
20	`settleList.revokeOrderId`	integer	`revokeorderid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
21	`settleList.revokeOrderName`	string	`revokeordername`	名称字段，用于展示与辅助识别	大小写匹配
22	`settleList.revokeTime`	string	`revoketime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；示例: `0001-01-01 00:00:00`
23	`settleList.payAmount`	number	`payamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `10000.0`, `3000.0`, `1000.0`, `298.0`, `-10000.0`, `5000.0`, `1200.0`, `-3000.0`
24	`settleList.pointAmount`	number	`pointamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `10000.0`, `3000.0`, `1000.0`, `298.0`, `0.0`, `5000.0`, `1200.0`, `539.0`
25	`settleList.refundAmount`	number	`refundamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；枚举值: `0.0`, `10000.0`, `3000.0`
26	`settleList.settleName`	string	`settlename`	名称字段，用于展示与辅助识别	大小写匹配；枚举值: `充值订单`, `充值撤销`
27	`settleList.settleRelateId`	integer	`settlerelateid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `3087072624987845`, `3087072183324293`, `3086802110156549`, `3085662010707589`, `3084086428667525`, `3083626062204421`, `3083418544623109`, `3082874684067461`
28	`settleList.settleStatus`	integer	`settlestatus`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `2`
29	`settleList.settleType`	integer	`settletype`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `5`, `7`
30	`settleList.payTime`	string	`paytime`	时间字段，用于记录业务时间点/发生时间	大小写匹配；枚举值: `2026-02-09 05:12:42`, `2026-02-09 05:12:15`, `2026-02-09 00:37:31`, `2026-02-08 05:17:45`, `2026-02-07 02:34:59`, `2026-02-06 18:46:41`, `2026-02-06 15:15:35`, `2026-02-06 06:02:20`
31	`settleList.roundingAmount`	number	`roundingamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
32	`settleList.paymentMethod`	integer	`paymentmethod`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `4`, `1`
33	`settleList.adjustAmount`	number	`adjustamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
34	`settleList.assistantCxMoney`	number	`assistantcxmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
35	`settleList.assistantPdMoney`	number	`assistantpdmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
36	`settleList.couponSaleAmount`	number	`couponsaleamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
37	`settleList.plCouponSaleAmount`	number	`plcouponsaleamount`	平台券销售额	大小写匹配；示例: `0.0`
38	`settleList.merVouSalesAmount`	number	`mervousalesamount`	商户券销售额	大小写匹配；示例: `0.0`
39	`settleList.memberDiscountAmount`	number	`memberdiscountamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
40	`settleList.tableChargeMoney`	number	`tablechargemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
41	`settleList.goodsMoney`	number	`goodsmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
42	`settleList.realGoodsMoney`	number	`realgoodsmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
43	`settleList.serviceMoney`	number	`servicemoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
44	`settleList.prepayMoney`	number	`prepaymoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
45	`settleList.salesManName`	string	`salesmanname`	名称字段，用于展示与辅助识别	大小写匹配
46	`settleList.orderRemark`	string	`orderremark`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配
47	`settleList.salesManUserId`	integer	`salesmanuserid`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `0`
48	`settleList.canBeRevoked`	boolean	`canberevoked`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
49	`settleList.pointDiscountPrice`	number	`pointdiscountprice`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
50	`settleList.pointDiscountCost`	number	`pointdiscountcost`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
51	`settleList.activityDiscount`	number	`activitydiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
52	`settleList.serialNumber`	integer	`serialnumber`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0`
53	`settleList.assistantManualDiscount`	number	`assistantmanualdiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
54	`settleList.allCouponDiscount`	number	`allcoupondiscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `0.0`
55	`settleList.goodsPromotionMoney`	number	`goodspromotionmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
56	`settleList.assistantPromotionMoney`	number	`assistantpromotionmoney`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0.0`
57	`settleList.isUseCoupon`	boolean	`isusecoupon`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
58	`settleList.isUseDiscount`	boolean	`isusediscount`	数量/时长字段，用于统计与计量	大小写匹配；示例: `False`
59	`settleList.isActivity`	boolean	`isactivity`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
60	`settleList.isBindMember`	boolean	`isbindmember`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；示例: `False`
61	`settleList.isFirst`	integer	`isfirst`	来自 JSON 导出的原始字段，用于保留业务取值	大小写匹配；枚举值: `2`, `1`
62	`settleList.rechargeCardAmount`	integer	`rechargecardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0`
63	`settleList.giftCardAmount`	integer	`giftcardamount`	金额字段，用于计费/结算/分摊等金额计算	大小写匹配；示例: `0`
64	`settleList.electricityMoney`	number	`electricitymoney`	电费金额	大小写匹配；示例: `0.0`
65	`settleList.realElectricityMoney`	number	`realelectricitymoney`	实际电费金额	大小写匹配；示例: `0.0`
66	`settleList.electricityAdjustMoney`	number	`electricityadjustmoney`	电费调整金额	大小写匹配；示例: `0.0`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.recharge_settlements 🔗 API

共 71 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`siteProfile.id`	`dwd_recharge_order.recharge_order_id`, `dwd_recharge_order_ex.recharge_order_id`	门店 ID
2	`tenantid`	bigint	`settleList.tenantId`	`dwd_recharge_order.tenant_id`	来自 JSON 导出的原始字段，用于保留业务取值
3	`siteid`	bigint	`settleList.siteId`	`dwd_recharge_order.site_id`	来自 JSON 导出的原始字段，用于保留业务取值
4	`sitename`	text	`settleList.siteName`	`dwd_recharge_order_ex.site_name_snapshot`	名称字段，用于展示与辅助识别
5	`balanceamount`	numeric	`settleList.balanceAmount`	`dwd_recharge_order_ex.balance_amount`	金额字段，用于计费/结算/分摊等金额计算
6	`cardamount`	numeric	`settleList.cardAmount`	`dwd_recharge_order_ex.card_amount`	金额字段，用于计费/结算/分摊等金额计算
7	`cashamount`	numeric	`settleList.cashAmount`	`dwd_recharge_order.cash_amount`	金额字段，用于计费/结算/分摊等金额计算
8	`couponamount`	numeric	`settleList.couponAmount`	`dwd_recharge_order_ex.coupon_amount`	金额字段，用于计费/结算/分摊等金额计算
9	`createtime`	timestamp with time zone	`settleList.createTime`	`dwd_recharge_order.create_time`	时间字段，用于记录业务时间点/发生时间
10	`memberid`	bigint	`settleList.memberId`	`dwd_recharge_order.member_id`	来自 JSON 导出的原始字段，用于保留业务取值
11	`membername`	text	`settleList.memberName`	`dwd_recharge_order.member_name_snapshot`	名称字段，用于展示与辅助识别
12	`tenantmembercardid`	bigint	`settleList.tenantMemberCardId`	`dwd_recharge_order.tenant_member_card_id`	来自 JSON 导出的原始字段，用于保留业务取值
13	`membercardtypename`	text	`settleList.memberCardTypeName`	`dwd_recharge_order.member_card_type_name`	名称字段，用于展示与辅助识别
14	`memberphone`	text	`settleList.memberPhone`	`dwd_recharge_order.member_phone_snapshot`	来自 JSON 导出的原始字段，用于保留业务取值
15	`tableid`	bigint	`settleList.tableId`	`dwd_recharge_order_ex.table_id`	来自 JSON 导出的原始字段，用于保留业务取值
16	`consumemoney`	numeric	`settleList.consumeMoney`	`dwd_recharge_order_ex.consume_money`	金额字段，用于计费/结算/分摊等金额计算
17	`onlineamount`	numeric	`settleList.onlineAmount`	`dwd_recharge_order_ex.online_amount`	金额字段，用于计费/结算/分摊等金额计算
18	`operatorid`	bigint	`settleList.operatorId`	`dwd_recharge_order_ex.operator_id`	来自 JSON 导出的原始字段，用于保留业务取值
19	`operatorname`	text	`settleList.operatorName`	`dwd_recharge_order_ex.operator_name_snapshot`	名称字段，用于展示与辅助识别
20	`revokeorderid`	bigint	`settleList.revokeOrderId`	`dwd_recharge_order_ex.revoke_order_id`	来自 JSON 导出的原始字段，用于保留业务取值
21	`revokeordername`	text	`settleList.revokeOrderName`	`dwd_recharge_order_ex.revoke_order_name`	名称字段，用于展示与辅助识别
22	`revoketime`	timestamp with time zone	`settleList.revokeTime`	`dwd_recharge_order_ex.revoke_time`	时间字段，用于记录业务时间点/发生时间
23	`payamount`	numeric	`settleList.payAmount`	`dwd_recharge_order.pay_amount`	金额字段，用于计费/结算/分摊等金额计算
24	`pointamount`	numeric	`settleList.pointAmount`	`dwd_recharge_order.point_amount`	金额字段，用于计费/结算/分摊等金额计算
25	`refundamount`	numeric	`settleList.refundAmount`	`dwd_recharge_order.refund_amount`	金额字段，用于计费/结算/分摊等金额计算
26	`settlename`	text	`settleList.settleName`	`dwd_recharge_order.settle_name`	名称字段，用于展示与辅助识别
27	`settlerelateid`	bigint	`settleList.settleRelateId`	`dwd_recharge_order.settle_relate_id`	来自 JSON 导出的原始字段，用于保留业务取值
28	`settlestatus`	integer	`settleList.settleStatus`	`dwd_recharge_order_ex.settle_status`	来自 JSON 导出的原始字段，用于保留业务取值
29	`settletype`	integer	`settleList.settleType`	`dwd_recharge_order.settle_type`	来自 JSON 导出的原始字段，用于保留业务取值
30	`paytime`	timestamp with time zone	`settleList.payTime`	`dwd_recharge_order.pay_time`	时间字段，用于记录业务时间点/发生时间
31	`roundingamount`	numeric	`settleList.roundingAmount`	`dwd_recharge_order_ex.rounding_amount`	金额字段，用于计费/结算/分摊等金额计算
32	`paymentmethod`	integer	`settleList.paymentMethod`	`dwd_recharge_order.payment_method`	来自 JSON 导出的原始字段，用于保留业务取值
33	`adjustamount`	numeric	`settleList.adjustAmount`	`dwd_recharge_order_ex.adjust_amount`	金额字段，用于计费/结算/分摊等金额计算
34	`assistantcxmoney`	numeric	`settleList.assistantCxMoney`	`dwd_recharge_order_ex.assistant_cx_money`	金额字段，用于计费/结算/分摊等金额计算
35	`assistantpdmoney`	numeric	`settleList.assistantPdMoney`	`dwd_recharge_order_ex.assistant_pd_money`	金额字段，用于计费/结算/分摊等金额计算
36	`couponsaleamount`	numeric	`settleList.couponSaleAmount`	`dwd_recharge_order_ex.coupon_sale_amount`	金额字段，用于计费/结算/分摊等金额计算
37	`memberdiscountamount`	numeric	`settleList.memberDiscountAmount`	`dwd_recharge_order_ex.member_discount_amount`	金额字段，用于计费/结算/分摊等金额计算
38	`tablechargemoney`	numeric	`settleList.tableChargeMoney`	`dwd_recharge_order_ex.table_charge_money`	金额字段，用于计费/结算/分摊等金额计算
39	`goodsmoney`	numeric	`settleList.goodsMoney`	`dwd_recharge_order_ex.goods_money`	金额字段，用于计费/结算/分摊等金额计算
40	`realgoodsmoney`	numeric	`settleList.realGoodsMoney`	`dwd_recharge_order_ex.real_goods_money`	金额字段，用于计费/结算/分摊等金额计算
41	`servicemoney`	numeric	`settleList.serviceMoney`	`dwd_recharge_order_ex.service_money`	金额字段，用于计费/结算/分摊等金额计算
42	`prepaymoney`	numeric	`settleList.prepayMoney`	`dwd_recharge_order_ex.prepay_money`	金额字段，用于计费/结算/分摊等金额计算
43	`salesmanname`	text	`settleList.salesManName`	`dwd_recharge_order_ex.salesman_name`	名称字段，用于展示与辅助识别
44	`orderremark`	text	`settleList.orderRemark`	`dwd_recharge_order_ex.order_remark`	来自 JSON 导出的原始字段，用于保留业务取值
45	`salesmanuserid`	bigint	`settleList.salesManUserId`	`dwd_recharge_order_ex.salesman_user_id`	来自 JSON 导出的原始字段，用于保留业务取值
46	`canberevoked`	boolean	`settleList.canBeRevoked`	`dwd_recharge_order_ex.can_be_revoked`	来自 JSON 导出的原始字段，用于保留业务取值
47	`pointdiscountprice`	numeric	`settleList.pointDiscountPrice`	`dwd_recharge_order_ex.point_discount_price`	金额字段，用于计费/结算/分摊等金额计算
48	`pointdiscountcost`	numeric	`settleList.pointDiscountCost`	`dwd_recharge_order_ex.point_discount_cost`	金额字段，用于计费/结算/分摊等金额计算
49	`activitydiscount`	numeric	`settleList.activityDiscount`	`dwd_recharge_order_ex.activity_discount`	数量/时长字段，用于统计与计量
50	`serialnumber`	bigint	`settleList.serialNumber`	`dwd_recharge_order_ex.serial_number`	数量/时长字段，用于统计与计量
51	`assistantmanualdiscount`	numeric	`settleList.assistantManualDiscount`	`dwd_recharge_order_ex.assistant_manual_discount`	数量/时长字段，用于统计与计量
52	`allcoupondiscount`	numeric	`settleList.allCouponDiscount`	`dwd_recharge_order_ex.all_coupon_discount`	数量/时长字段，用于统计与计量
53	`goodspromotionmoney`	numeric	`settleList.goodsPromotionMoney`	`dwd_recharge_order_ex.goods_promotion_money`	金额字段，用于计费/结算/分摊等金额计算
54	`assistantpromotionmoney`	numeric	`settleList.assistantPromotionMoney`	`dwd_recharge_order_ex.assistant_promotion_money`	金额字段，用于计费/结算/分摊等金额计算
55	`isusecoupon`	boolean	`settleList.isUseCoupon`	`dwd_recharge_order_ex.is_use_coupon`	来自 JSON 导出的原始字段，用于保留业务取值
56	`isusediscount`	boolean	`settleList.isUseDiscount`	`dwd_recharge_order_ex.is_use_discount`	数量/时长字段，用于统计与计量
57	`isactivity`	boolean	`settleList.isActivity`	`dwd_recharge_order_ex.is_activity`	来自 JSON 导出的原始字段，用于保留业务取值
58	`isbindmember`	boolean	`settleList.isBindMember`	`dwd_recharge_order_ex.is_bind_member`	来自 JSON 导出的原始字段，用于保留业务取值
59	`isfirst`	integer	`settleList.isFirst`	`dwd_recharge_order.is_first`	来自 JSON 导出的原始字段，用于保留业务取值
60	`rechargecardamount`	numeric	`settleList.rechargeCardAmount`	`dwd_recharge_order_ex.recharge_card_amount`	金额字段，用于计费/结算/分摊等金额计算
61	`giftcardamount`	numeric	`settleList.giftCardAmount`	`dwd_recharge_order_ex.gift_card_amount`	金额字段，用于计费/结算/分摊等金额计算
62	`electricityadjustmoney`	numeric	`settleList.electricityAdjustMoney`	`dwd_recharge_order.electricity_adjust_money`	电费调整金额
63	`electricitymoney`	numeric	`settleList.electricityMoney`	`dwd_recharge_order.electricity_money`	电费金额
64	`mervousalesamount`	numeric	`settleList.merVouSalesAmount`	`dwd_recharge_order.mervou_sales_amount`	商户券销售额
65	`plcouponsaleamount`	numeric	`settleList.plCouponSaleAmount`	`dwd_recharge_order.pl_coupon_sale_amount`	平台券销售额
66	`realelectricitymoney`	numeric	`settleList.realElectricityMoney`	`dwd_recharge_order.real_electricity_money`	实际电费金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_recharge_order 🔗 ODS

共 24 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`recharge_order_id`	bigint	`id`	直接	充值订单 ID
2	`tenant_id`	bigint	`tenantid`	直接	租户 ID
3	`site_id`	bigint	`siteid`	直接	门店 ID
4	`member_id`	bigint	`memberid`	直接	会员 ID → dim_member
5	`member_name_snapshot`	text	`membername`	直接	会员名称快照
6	`member_phone_snapshot`	text	`memberphone`	直接	会员电话快照
7	`tenant_member_card_id`	bigint	`tenantmembercardid`	直接	会员卡账户 ID → dim_member_card_account
8	`member_card_type_name`	text	`membercardtypename`	直接	卡类型名称。枚举值: "储值卡", "月卡"
9	`settle_relate_id`	bigint	`settlerelateid`	直接	结算关联 ID
10	`settle_type`	integer	`settletype`	直接	结算类型。枚举值: 5=充值订单, 7=充值退款
11	`settle_name`	text	`settlename`	直接	结算名称。枚举值: "充值订单", "充值退款"
12	`is_first`	integer	`isfirst`	直接	是否首充。枚举值: 1=是, 2=否
13	`pay_amount`	numeric	`payamount`	直接	充值金额（元，撤销为负数）
14	`refund_amount`	numeric	`refundamount`	直接	退款金额
15	`point_amount`	numeric	`pointamount`	直接	积分金额
16	`cash_amount`	numeric	`cashamount`	直接	现金金额
17	`payment_method`	integer	`paymentmethod`	直接	支付方式，暂未启用。
18	`create_time`	timestamp with time zone	`createtime`	直接	创建时间
19	`pay_time`	timestamp with time zone	`paytime`	直接	支付时间
20	`pl_coupon_sale_amount`	numeric	`plcouponsaleamount`	直接	平台券销售金额
21	`mervou_sales_amount`	numeric	`mervousalesamount`	直接	美团/大众点评等平台销售金额
22	`electricity_money`	numeric	`electricitymoney`	直接	电费金额
23	`real_electricity_money`	numeric	`realelectricitymoney`	直接	实际电费金额
24	`electricity_adjust_money`	numeric	`electricityadjustmoney`	直接	电费调整金额

DWD 表结构 — dwd.dwd_recharge_order_ex 🔗 ODS

共 43 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`recharge_order_id`	bigint	`id`	直接	字段重命名
2	`site_name_snapshot`	text	`sitename`	直接	字段重命名
3	`settle_status`	integer	`settlestatus`	直接	字段重命名
4	`is_bind_member`	boolean	`isbindmember`	→ boolean	字段重命名
5	`is_activity`	boolean	`isactivity`	→ boolean	字段重命名
6	`is_use_coupon`	boolean	`isusecoupon`	→ boolean	字段重命名
7	`is_use_discount`	boolean	`isusediscount`	→ boolean	字段重命名
8	`can_be_revoked`	boolean	`canberevoked`	→ boolean	字段重命名
9	`online_amount`	numeric	`onlineamount`	直接	字段重命名
10	`balance_amount`	numeric	`balanceamount`	直接	字段重命名
11	`card_amount`	numeric	`cardamount`	直接	字段重命名
12	`coupon_amount`	numeric	`couponamount`	直接	字段重命名
13	`recharge_card_amount`	numeric	`rechargecardamount`	直接	字段重命名
14	`gift_card_amount`	numeric	`giftcardamount`	直接	字段重命名
15	`prepay_money`	numeric	`prepaymoney`	直接	字段重命名
16	`consume_money`	numeric	`consumemoney`	直接	字段重命名
17	`goods_money`	numeric	`goodsmoney`	直接	字段重命名
18	`real_goods_money`	numeric	`realgoodsmoney`	直接	字段重命名
19	`table_charge_money`	numeric	`tablechargemoney`	直接	字段重命名
20	`service_money`	numeric	`servicemoney`	直接	字段重命名
21	`activity_discount`	numeric	`activitydiscount`	直接	字段重命名
22	`all_coupon_discount`	numeric	`allcoupondiscount`	直接	字段重命名
23	`goods_promotion_money`	numeric	`goodspromotionmoney`	直接	字段重命名
24	`assistant_promotion_money`	numeric	`assistantpromotionmoney`	直接	字段重命名
25	`assistant_pd_money`	numeric	`assistantpdmoney`	直接	字段重命名
26	`assistant_cx_money`	numeric	`assistantcxmoney`	直接	字段重命名
27	`assistant_manual_discount`	numeric	`assistantmanualdiscount`	直接	字段重命名
28	`coupon_sale_amount`	numeric	`couponsaleamount`	直接	字段重命名
29	`member_discount_amount`	numeric	`memberdiscountamount`	直接	字段重命名
30	`point_discount_price`	numeric	`pointdiscountprice`	直接	字段重命名
31	`point_discount_cost`	numeric	`pointdiscountcost`	直接	字段重命名
32	`adjust_amount`	numeric	`adjustamount`	直接	字段重命名
33	`rounding_amount`	numeric	`roundingamount`	直接	字段重命名
34	`operator_id`	bigint	`operatorid`	直接	字段重命名
35	`operator_name_snapshot`	text	`operatorname`	直接	字段重命名
36	`salesman_user_id`	bigint	`salesmanuserid`	直接	字段重命名
37	`salesman_name`	text	`salesmanname`	直接	字段重命名
38	`order_remark`	text	`orderremark`	直接	字段重命名
39	`table_id`	integer	`tableid`	直接	字段重命名
40	`serial_number`	integer	`serialnumber`	直接	字段重命名
41	`revoke_order_id`	bigint	`revokeorderid`	直接	字段重命名
42	`revoke_order_name`	text	`revokeordername`	直接	字段重命名
43	`revoke_time`	timestamp with time zone	`revoketime`	直接	字段重命名

3.14 group_buy_packages（团购套餐定义）

任务代码：ODS_GROUP_PACKAGE
采样记录数：18
API JSON 字段数：40
ODS 列数：43
DWD 目标表：dim_groupbuy_package, dim_groupbuy_package_ex

API 源字段 — group_buy_packages 🔗 ODS

已映射 38/40，覆盖率 95.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`site_name`	string	`site_name`	门店名称	示例: `朗朗桌球`
2	`effective_status`	integer	`effective_status`	1：13 条	枚举值: `1`, `3`
3	`tenantTableAreaIdList[]`	integer	⚠️ 未映射		枚举值: `2791960001957765`, `2791961347968901`, `2791961060364165`, `2791961709907845`, `2791960521691013`, `2791962314215301`
4	`tableAreaNameList[]`	string	⚠️ 未映射		枚举值: `A区`, `斯诺克区`, `VIP包厢`, `K包`, `B区`, `麻将房`
5	`tenantCouponSaleOrderItemId`	integer	`tenantcouponsaleorderitemid`	租户券销售订单项ID	大小写匹配；示例: `0`
6	`id`	integer	`id`	门店侧套餐 ID，本文件内部的主键	枚举值: `3048468851870085`, `3035353129373509`, `3035353102028549`, `3035346503502213`, `3031000036133445`, `3030876421573701`, `3030875431701445`, `3030874907937861`
7	`add_end_clock`	string	`add_end_clock`	附加时段结束时间，多数情况配合 "00:00:00" 或 "10:00:00" 使用	枚举值: `1.02:00:00`, `23:59:59`, `1.00:00:00`, `18:00:00`
8	`add_start_clock`	string	`add_start_clock`	附加可用时间段的起始时间（第二段）	枚举值: `23:00:00`, `10:00:00`, `00:00:00`
9	`area_tag_type`	integer	`area_tag_type`	1 很可能代表“按台区标签限制”，例如 A区、中八区、包厢、KTV 等	示例: `1`
10	`card_type_ids`	string	`card_type_ids`	原意是“适用会员卡类型 ID 列表”，例如某套餐只允许某几种会员卡使用，可以在此配置	示例: `0`
11	`coupon_money`	number	`coupon_money`	券面值或内部结算面值，表示该套餐在门店侧对应的金额额度	示例: `0.0`
12	`create_time`	string	`create_time`	该套餐在系统中创建的时间	枚举值: `2026-01-12 22:42:55`, `2026-01-03 16:20:55`, `2026-01-03 16:20:53`, `2026-01-03 16:14:10`, `2025-12-31 14:32:43`, `2025-12-31 12:26:58`, `2025-12-31 12:25:58`, `2025-12-31 12:25:26`
13	`creator_name`	string	`creator_name`	创建人信息，一般包含“角色：姓名”	枚举值: `店长:郑丽珊`, `管理员：郑丽珊`
14	`date_info`	string	`date_info`	预留字段，通常用来存储更细粒度的日期信息，如具体日期列表、节假日特殊规则（可能是 JSON 字符串或编码）	示例: `0`
15	`date_type`	integer	`date_type`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
16	`duration`	integer	`duration`	套餐内包含的时长（秒）	枚举值: `3600`, `7200`, `14400`
17	`end_clock`	string	`end_clock`	每日可用的结束时间点（第一段）	枚举值: `1.02:00:00`, `23:59:59`, `1.00:00:00`
18	`end_time`	string	`end_time`	套餐失效的日期时间（到这个时间点后不可使用）	枚举值: `2027-01-13 00:00:00`, `2027-01-04 00:00:00`, `2026-01-03 00:00:00`, `2027-01-01 00:00:00`, `2027-09-01 00:00:00`, `2026-12-31 00:00:00`, `2026-09-03 00:00:00`
19	`group_type`	integer	`group_type`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
20	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
21	`is_enabled`	integer	`is_enabled`	启用状态	枚举值: `1`, `2`
22	`is_first_limit`	integer	`is_first_limit`	是否首单限制	示例: `1`
23	`max_selectable_categories`	integer	`max_selectable_categories`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `0`
24	`package_id`	integer	`package_id`	“上层套餐 ID” 或“总部/系统级套餐 ID”	枚举值: `1134850618`, `1130443985`, `1203035334`, `1812429097416714`, `1814707240811572`, `1137882866`, `1130465371`, `1137872168`
25	`package_name`	string	`package_name`	团购套餐名称，用于前台展示和核销界面	枚举值: `午夜场9.9`, `斯诺克两小时`, `新人特惠一小时`, `中八、斯诺克包厢两小时`, `新人特惠A区中八一小时`, `KTV欢唱四小时`, `全天A区中八两小时`, `全天B区中八两小时`
26	`selling_price`	number	`selling_price`	语义上应该是“团购售卖价”（顾客在平台购买券时的成交价格）	示例: `0.0`
27	`site_id`	integer	`site_id`	门店 ID	示例: `2790685415443269`
28	`sort`	integer	`sort`	排序	示例: `100`
29	`start_clock`	string	`start_clock`	每日可用起始时间点（第一段）	枚举值: `23:00:00`, `10:00:00`, `00:00:00`
30	`start_time`	string	`start_time`	套餐开始生效的日期时间	枚举值: `2026-01-12 00:00:00`, `2026-01-03 00:00:00`, `2025-12-31 00:00:00`, `2025-07-21 00:00:00`, `2025-07-22 00:00:00`, `2025-12-30 00:00:00`, `2025-09-02 00:00:00`
31	`system_group_type`	integer	`system_group_type`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
32	`table_area_id`	string	`table_area_id`	原始设计应为“单一台区 ID”，当套餐只限一个区域可以用这个字段存储	示例: `0`
33	`table_area_id_list`	string	`table_area_id_list`	用来存放具体台区 ID 列表（例如 "1,2,3"），实现更细粒度的台桌限制
34	`table_area_name`	string	`table_area_name`	套餐适用的“门店台区名称”，用于显示和筛选	示例: `B区`
35	`tenant_id`	integer	`tenant_id`	租户 ID（品牌/商户 ID）	示例: `2790683160709957`
36	`tenant_table_area_id`	string	`tenant_table_area_id`	与 table_area_id 类似，是租户层级的台区 ID，原本用于单区选择	示例: `0`
37	`tenant_table_area_id_list`	string	`tenant_table_area_id_list`	实际代表“台区集合 ID”或“租户台区配置 ID”，用来限制套餐可用的台区范围	示例: `2791960521691013`
38	`type`	integer	`type`	内部业务子类型，具体含义需要结合系统文档	枚举值: `1`, `2`
39	`usable_count`	integer	`usable_count`	可使用次数上限	示例: `0`
40	`usable_range`	string	`usable_range`	一般用于文字描述可用日期范围（例如“周一至周五”）

ODS 表结构 — ods.group_buy_packages 🔗 API

共 43 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_groupbuy_package.groupbuy_package_id`, `dim_groupbuy_package_ex.groupbuy_package_id`	门店侧套餐 ID，本文件内部的主键
2	`package_id`	bigint	`package_id`	`dim_groupbuy_package.package_template_id`	“上层套餐 ID” 或“总部/系统级套餐 ID”
3	`package_name`	text	`package_name`	`dim_groupbuy_package.package_name`	团购套餐名称，用于前台展示和核销界面
4	`selling_price`	numeric	`selling_price`	`dim_groupbuy_package.selling_price`	语义上应该是“团购售卖价”（顾客在平台购买券时的成交价格）
5	`coupon_money`	numeric	`coupon_money`	`dim_groupbuy_package.coupon_face_value`	券面值或内部结算面值，表示该套餐在门店侧对应的金额额度
6	`date_type`	integer	`date_type`	`dim_groupbuy_package_ex.date_type`	来自 JSON 导出的原始字段，用于保留业务取值
7	`date_info`	text	`date_info`	`dim_groupbuy_package_ex.date_info`	预留字段，通常用来存储更细粒度的日期信息，如具体日期列表、节假日特殊规则（可能是 JSON 字符串或编码）
8	`start_time`	timestamp without time zone	`start_time`	`dim_groupbuy_package.start_time`	套餐开始生效的日期时间
9	`end_time`	timestamp without time zone	`end_time`	`dim_groupbuy_package.end_time`	套餐失效的日期时间（到这个时间点后不可使用）
10	`start_clock`	text	`start_clock`	`dim_groupbuy_package_ex.start_clock`	每日可用起始时间点（第一段）
11	`end_clock`	text	`end_clock`	`dim_groupbuy_package_ex.end_clock`	每日可用的结束时间点（第一段）
12	`add_start_clock`	text	`add_start_clock`	`dim_groupbuy_package_ex.add_start_clock`	附加可用时间段的起始时间（第二段）
13	`add_end_clock`	text	`add_end_clock`	`dim_groupbuy_package_ex.add_end_clock`	附加时段结束时间，多数情况配合 "00:00:00" 或 "10:00:00" 使用
14	`duration`	integer	`duration`	`dim_groupbuy_package.duration_seconds`	套餐内包含的时长（秒）
15	`usable_count`	integer	`usable_count`	`dim_groupbuy_package_ex.usable_count`	可使用次数上限
16	`usable_range`	integer	`usable_range`	`dim_groupbuy_package_ex.usable_range`	一般用于文字描述可用日期范围（例如“周一至周五”）
17	`table_area_id`	bigint	`table_area_id`	`dim_groupbuy_package_ex.table_area_id`	原始设计应为“单一台区 ID”，当套餐只限一个区域可以用这个字段存储
18	`table_area_name`	text	`table_area_name`	`dim_groupbuy_package.table_area_name`	套餐适用的“门店台区名称”，用于显示和筛选
19	`table_area_id_list`	jsonb	`table_area_id_list`	`dim_groupbuy_package_ex.table_area_id_list`	用来存放具体台区 ID 列表（例如 "1,2,3"），实现更细粒度的台桌限制
20	`tenant_table_area_id`	bigint	`tenant_table_area_id`	`dim_groupbuy_package_ex.tenant_table_area_id`	与 table_area_id 类似，是租户层级的台区 ID，原本用于单区选择
21	`tenant_table_area_id_list`	jsonb	`tenant_table_area_id_list`	`dim_groupbuy_package.tenant_table_area_id_list`	实际代表“台区集合 ID”或“租户台区配置 ID”，用来限制套餐可用的台区范围
22	`site_id`	bigint	`site_id`	`dim_groupbuy_package.site_id`	门店 ID
23	`site_name`	text	`site_name`	`dim_groupbuy_package_ex.site_name`	门店名称
24	`tenant_id`	bigint	`tenant_id`	`dim_groupbuy_package.tenant_id`	租户 ID（品牌/商户 ID）
25	`card_type_ids`	jsonb	`card_type_ids`	`dim_groupbuy_package.card_type_ids`	原意是“适用会员卡类型 ID 列表”，例如某套餐只允许某几种会员卡使用，可以在此配置
26	`group_type`	integer	`group_type`	`dim_groupbuy_package_ex.group_type`	来自 JSON 导出的原始字段，用于保留业务取值
27	`system_group_type`	integer	`system_group_type`	`dim_groupbuy_package_ex.system_group_type`	来自 JSON 导出的原始字段，用于保留业务取值
28	`type`	integer	`type`	`dim_groupbuy_package_ex.package_type`	内部业务子类型，具体含义需要结合系统文档
29	`effective_status`	integer	`effective_status`	`dim_groupbuy_package_ex.effective_status`	1：13 条
30	`is_enabled`	integer	`is_enabled`	`dim_groupbuy_package.is_enabled`	启用状态
31	`is_delete`	integer	`is_delete`	`dim_groupbuy_package.is_delete`	逻辑删除标志
32	`max_selectable_categories`	integer	`max_selectable_categories`	`dim_groupbuy_package_ex.max_selectable_categories`	来自 JSON 导出的原始字段，用于保留业务取值
33	`area_tag_type`	integer	`area_tag_type`	`dim_groupbuy_package_ex.area_tag_type`	1 很可能代表“按台区标签限制”，例如 A区、中八区、包厢、KTV 等
34	`creator_name`	text	`creator_name`	`dim_groupbuy_package_ex.creator_name`	创建人信息，一般包含“角色：姓名”
35	`create_time`	timestamp without time zone	`create_time`	`dim_groupbuy_package.create_time`	该套餐在系统中创建的时间
36	`is_first_limit`	boolean	`is_first_limit`	`dim_groupbuy_package.is_first_limit`	是否首单限制
37	`sort`	integer	`sort`	`dim_groupbuy_package.sort`	排序
38	`tenantcouponsaleorderitemid`	bigint	`tenantCouponSaleOrderItemId`	`dim_groupbuy_package_ex.tenant_coupon_sale_order_item_id`	租户券销售订单项ID

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_groupbuy_package 🔗 ODS

共 22 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`groupbuy_package_id`	bigint	`id`	直接	团购套餐 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID（当前值: 2790683160709957）
3	`site_id`	bigint	`site_id`	直接	门店 ID → dim_site（当前值: 2790685415443269）
4	`package_name`	character varying	`package_name`	直接	套餐名称。样本值: "中八、斯诺克包厢两小时", "斯诺克两小时"等
5	`package_template_id`	bigint	`package_id`	直接	套餐模板 ID
6	`selling_price`	numeric	`selling_price`	直接	售卖价格（每笔订单不同，从核销记录中dwd_groupbuy_redemption获取）
7	`coupon_face_value`	numeric	`coupon_money`	直接	券面值（每笔订单不同，从核销记录中dwd_groupbuy_redemption获取）
8	`duration_seconds`	integer	`duration`	直接	套餐时长（秒）。样本值: 3600=1小时, 7200=2小时, 14400=4小时等
9	`start_time`	timestamp with time zone	`start_time`	直接	套餐生效开始时间
10	`end_time`	timestamp with time zone	`end_time`	直接	套餐生效结束时间
11	`table_area_name`	character varying	`table_area_name`	直接	适用台区名称。枚举值: "A区", "VIP包厢", "斯诺克区", "B区", "麻将房", "888"
12	`is_enabled`	integer	`is_enabled`	直接	启用状态。枚举值: 1=启用, 2=停用
13	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
14	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
15	`tenant_table_area_id_list`	character varying	`tenant_table_area_id_list`	直接	租户级台区 ID 列表
16	`card_type_ids`	character varying	`card_type_ids`	直接	允许使用的卡类型 ID 列表（当前数据为 "0"）
17	`sort`	integer	`sort`	直接	排序
18	`is_first_limit`	boolean	`is_first_limit`	→ boolean	是否首单限制
19	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
20	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
21	`scd2_is_current`	integer	—	SCD2	当前版本标记
22	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_groupbuy_package_ex 🔗 ODS

共 25 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`groupbuy_package_id`	bigint	`id`	直接	字段重命名
2	`site_name`	character varying	`site_name`	直接	同名直传
3	`usable_count`	integer	`usable_count`	直接	同名直传
4	`date_type`	integer	`date_type`	直接	同名直传
5	`usable_range`	character varying	`usable_range`	直接	维度字段，用于补充维度属性
6	`date_info`	character varying	`date_info`	直接	同名直传
7	`start_clock`	character varying	`start_clock`	直接	同名直传
8	`end_clock`	character varying	`end_clock`	直接	同名直传
9	`add_start_clock`	character varying	`add_start_clock`	直接	同名直传
10	`add_end_clock`	character varying	`add_end_clock`	直接	同名直传
11	`area_tag_type`	integer	`area_tag_type`	直接	同名直传
12	`table_area_id`	bigint	`table_area_id`	直接	标识类 ID 字段，用于关联/定位相关实体
13	`tenant_table_area_id`	bigint	`tenant_table_area_id`	直接	标识类 ID 字段，用于关联/定位相关实体
14	`table_area_id_list`	character varying	`table_area_id_list`	直接	维度字段，用于补充维度属性
15	`group_type`	integer	`group_type`	直接	同名直传
16	`system_group_type`	integer	`system_group_type`	直接	同名直传
17	`package_type`	integer	`type`	直接	字段重命名
18	`effective_status`	integer	`effective_status`	直接	同名直传
19	`max_selectable_categories`	integer	`max_selectable_categories`	直接	同名直传
20	`creator_name`	character varying	`creator_name`	直接	同名直传
21	`tenant_coupon_sale_order_item_id`	bigint	`tenantcouponsaleorderitemid`	直接	字段重命名
22	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
23	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
24	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
25	`scd2_version`	integer	—	SCD2	SCD2 元数据

3.15 group_buy_redemption_records（团购套餐核销）

任务代码：ODS_GROUP_BUY_REDEMPTION
采样记录数：200
API JSON 字段数：52
ODS 列数：57
DWD 目标表：dwd_groupbuy_redemption, dwd_groupbuy_redemption_ex

API 源字段 — group_buy_redemption_records 🔗 ODS

已映射 52/52，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`tableName`	string	`tablename`	（待补充）	大小写匹配；枚举值: `A15`, `A4`, `S4`, `A3`, `A1`, `A9`, `A17`, `A8`
2	`tableAreaName`	string	`tableareaname`	（待补充）	大小写匹配；枚举值: `A区`, `斯诺克区`, `B区`, `麻将房`
3	`siteName`	string	`sitename`	（待补充）	大小写匹配；示例: `朗朗桌球`
4	`goodsOptionPrice`	number	`goodsoptionprice`	（待补充）	大小写匹配；示例: `0.0`
5	`id`	integer	`id`	本条“团购套餐流水”记录的主键 ID	枚举值: `3093859292088645`, `3093855577786629`, `3093804251662661`, `3093800357562565`, `3093793885882629`, `3093774985857157`, `3093761348159621`, `3093749943830789`
6	`assistant_promotion_money`	number	`assistant_promotion_money`	分摊到“助教服务”的促销金额	示例: `0.0`
7	`assistant_service_promotion_money`	number	`assistant_service_promotion_money`	进一步细分助教服务的促销金额	示例: `0.0`
8	`assistant_service_share_money`	number	`assistant_service_share_money`	助教服务分摊金额	示例: `0.0`
9	`assistant_share_money`	number	`assistant_share_money`	助教分摊金额	示例: `0.0`
10	`coupon_code`	string	`coupon_code`	团购券券码，核销时扫描/录入的字符串	枚举值: `0107305319597`, `0108970935413`, `0103968076185`, `0101346097990`, `0107317733529`, `0102409858353`, `0102774179020`, `0103957102485`
11	`coupon_money`	number	`coupon_money`	本次核销时，这张券在门店侧对应的金额额度（“可抵扣金额”）	枚举值: `96.0`, `48.0`, `68.0`, `136.0`, `116.0`, `288.0`, `58.0`
12	`coupon_origin_id`	integer	`coupon_origin_id`	平台/上游系统中的券记录主键 ID，“券来源 ID”	枚举值: `3093740768184645`, `3093784063412357`, `3093729957169285`, `3093681906993285`, `3093730736834693`, `3093720619157701`, `3093641950333253`, `3093689829460293`
13	`create_time`	string	`create_time`	本条团购套餐使用流水创建时间（即券核销时间，或与结账时间接近）	枚举值: `2026-02-14 00:16:27`, `2026-02-14 00:12:40`, `2026-02-13 23:20:28`, `2026-02-13 23:16:30`, `2026-02-13 23:09:55`, `2026-02-13 22:50:42`, `2026-02-13 22:36:49`, `2026-02-13 22:25:13`
14	`good_service_share_money`	number	`good_service_share_money`	商品服务分摊金额	示例: `0.0`
15	`goods_promotion_money`	number	`goods_promotion_money`	本次券使用中，分摊到“商品”部分的促销金额	示例: `0.0`
16	`goods_share_money`	number	`goods_share_money`	商品分摊金额	示例: `0.0`
17	`is_delete`	integer	`is_delete`	逻辑删除标记（0=否，1=是）	示例: `0`
18	`is_single_order`	integer	`is_single_order`	是否单独作为一条订单行	示例: `1`
19	`ledger_amount`	number	`ledger_amount`	本次券实际冲抵台费的金额	枚举值: `96.0`, `48.0`, `68.0`, `44.2`, `136.0`, `113.66`, `116.0`, `38.16`
20	`ledger_count`	integer	`ledger_count`	按此次优惠实际计算的“核销秒数”	枚举值: `7200`, `3600`, `3315`, `7055`, `2862`, `3273`, `14400`, `3197`
21	`ledger_group_name`	string	`ledger_group_name`	团购项目所属的“记账分组名称”（例如“团购台费”“团购包厢”等）
22	`ledger_name`	string	`ledger_name`	台费侧关联的“团购项目名称”（记账名）	枚举值: `全天A区中八两小时`, `全天A区中八一小时`, `全天斯诺克一小时`, `斯诺克两小时`, `全天B区中八两小时`, `麻将包厢4小时`, `B区桌球一小时`, `新人特惠一小时`
23	`ledger_status`	integer	`ledger_status`	流水状态	示例: `1`
24	`ledger_unit_price`	number	`ledger_unit_price`	对应台费的标准单价，单位元/小时（从数值来看是类似29.9/小时这种定价）	枚举值: `39.9`, `20.26`, `69.9`, `59.9`, `128.0`, `35.9`, `12.12`, `9.9`
25	`offer_type`	integer	`offer_type`	优惠类型	示例: `1`
26	`operator_id`	integer	`operator_id`	执行本次核销/结算操作的操作员 ID	示例: `2790687322443013`
27	`operator_name`	string	`operator_name`	操作员名称（包含角色说明），与 operator_id 对应的冗余展示字段	示例: `收银员:郑丽珊`
28	`order_coupon_channel`	integer	`order_coupon_channel`	来自 JSON 导出的原始字段，用于保留业务取值	示例: `1`
29	`order_coupon_id`	integer	`order_coupon_id`	订单中“券使用记录”的 ID	枚举值: `3093740768184645`, `3093784063412357`, `3093729957169285`, `3093681906993285`, `3093730736834693`, `3093720619157701`, `3093641950333253`, `3093689829460293`
30	`order_pay_id`	integer	`order_pay_id`	指向支付记录表中的支付流水 ID	示例: `0`
31	`order_settle_id`	integer	`order_settle_id`	结算单 ID（小票结账主键）	枚举值: `3093859276196037`, `3093855537596549`, `3093804233967877`, `3093800338802821`, `3093793847478597`, `3093774959741061`, `3093761316341957`, `3093749870790789`
32	`order_trade_no`	integer	`order_trade_no`	订单交易号，和其它消费明细（台费、商品、助教、团购）共用的订单主键	枚举值: `3093740766775621`, `3093784062036101`, `3093729955563653`, `3093681905567877`, `3093730735376517`, `3093720617519301`, `3093641948924229`, `3093689828067653`
33	`promotion_activity_id`	integer	`promotion_activity_id`	团购/促销活动 ID	枚举值: `3093740765382981`, `3093784060856453`, `3093729952467077`, `3093681904502917`, `3093730734033029`, `3093720616372421`, `3093641947482437`, `3093689826576709`
34	`promotion_coupon_id`	integer	`promotion_coupon_id`	团购套餐定义 ID	枚举值: `3030874716834757`, `3030872476945477`, `3030025905916997`, `3035353129373509`, `3030874133269445`, `3029784419027909`, `2861343275830405`, `3031000036133445`
35	`promotion_seconds`	integer	`promotion_seconds`	团购套餐定义的“标准时长”（券本身标称的可用时长）	枚举值: `7200`, `3600`, `14400`
36	`recharge_promotion_money`	number	`recharge_promotion_money`	来自“充值类优惠”的分摊金额（例如储值赠送部分）	示例: `0.0`
37	`recharge_share_money`	number	`recharge_share_money`	充值分摊金额	示例: `0.0`
38	`reward_promotion_money`	number	`reward_promotion_money`	本次促销中，属于“奖励金/积分抵扣”的金额	示例: `0.0`
39	`sales_man_org_id`	integer	`sales_man_org_id`	营业员所属组织 ID	示例: `0`
40	`salesman_name`	string	`salesman_name`	营业员姓名
41	`salesman_role_id`	integer	`salesman_role_id`	营业员角色 ID	示例: `0`
42	`salesman_user_id`	integer	`salesman_user_id`	营业员/业务员用户 ID	示例: `0`
43	`site_id`	integer	`site_id`	门店 ID，与其它 JSON 中一致	示例: `2790685415443269`
44	`table_charge_seconds`	integer	`table_charge_seconds`	本次结算中该球台总计计费的秒数（整台的台费计费时间）	枚举值: `7200`, `3600`, `3315`, `7055`, `2862`, `10800`, `3273`, `14400`
45	`table_id`	integer	`table_id`	球台 ID	枚举值: `2793003506815045`, `2793001904918661`, `2793020260044869`, `2793001695301765`, `2791964216463493`, `2793002980429893`, `2793003705192517`, `2793002896494725`
46	`table_service_promotion_money`	number	`table_service_promotion_money`	本次券使用中，分摊到“台费服务费”部分的促销金额	示例: `0.0`
47	`table_service_share_money`	number	`table_service_share_money`	台费服务分摊金额	示例: `0.0`
48	`table_share_money`	number	`table_share_money`	台费分摊金额	枚举值: `39.9`, `20.26`, `69.9`, `59.9`, `128.0`, `35.9`, `12.12`, `9.9`
49	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
50	`tenant_table_area_id`	integer	`tenant_table_area_id`	租户级台区分组 ID，表示当前使用券的台桌所属的区域组合	枚举值: `2791960001957765`, `2791961347968901`, `2791960521691013`, `2791962314215301`
51	`coupon_sale_id`	integer	`coupon_sale_id`	优惠券销售ID	示例: `0`
52	`member_discount_money`	number	`member_discount_money`	会员折扣金额	示例: `0.0`

ODS 表结构 — ods.group_buy_redemption_records 🔗 API

共 57 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dwd_groupbuy_redemption.redemption_id`, `dwd_groupbuy_redemption_ex.redemption_id`	本条“团购套餐流水”记录的主键 ID
2	`tenant_id`	bigint	`tenant_id`	`dwd_groupbuy_redemption.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dwd_groupbuy_redemption.site_id`	门店 ID，与其它 JSON 中一致
4	`sitename`	text	`siteName`	`dwd_groupbuy_redemption_ex.site_name`	（待补充）
5	`table_id`	bigint	`table_id`	`dwd_groupbuy_redemption.table_id`	球台 ID
6	`tablename`	text	`tableName`	`dwd_groupbuy_redemption_ex.table_name`	（待补充）
7	`tableareaname`	text	`tableAreaName`	`dwd_groupbuy_redemption_ex.table_area_name`	（待补充）
8	`tenant_table_area_id`	bigint	`tenant_table_area_id`	`dwd_groupbuy_redemption.tenant_table_area_id`	租户级台区分组 ID，表示当前使用券的台桌所属的区域组合
9	`order_trade_no`	text	`order_trade_no`	`dwd_groupbuy_redemption.order_trade_no`	订单交易号，和其它消费明细（台费、商品、助教、团购）共用的订单主键
10	`order_settle_id`	bigint	`order_settle_id`	`dwd_groupbuy_redemption.order_settle_id`	结算单 ID（小票结账主键）
11	`order_pay_id`	bigint	`order_pay_id`	`dwd_groupbuy_redemption_ex.order_pay_id`	指向支付记录表中的支付流水 ID
12	`order_coupon_id`	bigint	`order_coupon_id`	`dwd_groupbuy_redemption.order_coupon_id`	订单中“券使用记录”的 ID
13	`order_coupon_channel`	integer	`order_coupon_channel`	`dwd_groupbuy_redemption.order_coupon_channel`	来自 JSON 导出的原始字段，用于保留业务取值
14	`coupon_code`	text	`coupon_code`	`dwd_groupbuy_redemption.coupon_code`	团购券券码，核销时扫描/录入的字符串
15	`coupon_money`	numeric	`coupon_money`	`dwd_groupbuy_redemption.coupon_money`	本次核销时，这张券在门店侧对应的金额额度（“可抵扣金额”）
16	`coupon_origin_id`	bigint	`coupon_origin_id`	`dwd_groupbuy_redemption.coupon_origin_id`	平台/上游系统中的券记录主键 ID，“券来源 ID”
17	`ledger_name`	text	`ledger_name`	`dwd_groupbuy_redemption.ledger_name`	台费侧关联的“团购项目名称”（记账名）
18	`ledger_group_name`	text	`ledger_group_name`	`dwd_groupbuy_redemption_ex.ledger_group_name`	团购项目所属的“记账分组名称”（例如“团购台费”“团购包厢”等）
19	`ledger_amount`	numeric	`ledger_amount`	`dwd_groupbuy_redemption.ledger_amount`	本次券实际冲抵台费的金额
20	`ledger_count`	numeric	`ledger_count`	`dwd_groupbuy_redemption.ledger_count`	按此次优惠实际计算的“核销秒数”
21	`ledger_unit_price`	numeric	`ledger_unit_price`	`dwd_groupbuy_redemption.ledger_unit_price`	对应台费的标准单价，单位元/小时（从数值来看是类似29.9/小时这种定价）
22	`ledger_status`	integer	`ledger_status`	`dwd_groupbuy_redemption_ex.ledger_status`	流水状态
23	`table_charge_seconds`	integer	`table_charge_seconds`	`dwd_groupbuy_redemption.table_charge_seconds`	本次结算中该球台总计计费的秒数（整台的台费计费时间）
24	`promotion_activity_id`	bigint	`promotion_activity_id`	`dwd_groupbuy_redemption.promotion_activity_id`	团购/促销活动 ID
25	`promotion_coupon_id`	bigint	`promotion_coupon_id`	`dwd_groupbuy_redemption.promotion_coupon_id`	团购套餐定义 ID
26	`promotion_seconds`	integer	`promotion_seconds`	`dwd_groupbuy_redemption.promotion_seconds`	团购套餐定义的“标准时长”（券本身标称的可用时长）
27	`offer_type`	integer	`offer_type`	`dwd_groupbuy_redemption_ex.offer_type`	优惠类型
28	`assistant_promotion_money`	numeric	`assistant_promotion_money`	`dwd_groupbuy_redemption_ex.assistant_promotion_money`	分摊到“助教服务”的促销金额
29	`assistant_service_promotion_money`	numeric	`assistant_service_promotion_money`	`dwd_groupbuy_redemption_ex.assistant_service_promotion_money`	进一步细分助教服务的促销金额
30	`table_service_promotion_money`	numeric	`table_service_promotion_money`	`dwd_groupbuy_redemption_ex.table_service_promotion_money`	本次券使用中，分摊到“台费服务费”部分的促销金额
31	`goods_promotion_money`	numeric	`goods_promotion_money`	`dwd_groupbuy_redemption_ex.goods_promotion_money`	本次券使用中，分摊到“商品”部分的促销金额
32	`recharge_promotion_money`	numeric	`recharge_promotion_money`	`dwd_groupbuy_redemption_ex.recharge_promotion_money`	来自“充值类优惠”的分摊金额（例如储值赠送部分）
33	`reward_promotion_money`	numeric	`reward_promotion_money`	`dwd_groupbuy_redemption_ex.reward_promotion_money`	本次促销中，属于“奖励金/积分抵扣”的金额
34	`goodsoptionprice`	numeric	`goodsOptionPrice`	`dwd_groupbuy_redemption_ex.goods_option_price`	（待补充）
35	`salesman_name`	text	`salesman_name`	`dwd_groupbuy_redemption_ex.salesman_name`	营业员姓名
36	`sales_man_org_id`	bigint	`sales_man_org_id`	`dwd_groupbuy_redemption_ex.salesman_org_id`	营业员所属组织 ID
37	`salesman_role_id`	bigint	`salesman_role_id`	`dwd_groupbuy_redemption_ex.salesman_role_id`	营业员角色 ID
38	`salesman_user_id`	bigint	`salesman_user_id`	`dwd_groupbuy_redemption_ex.salesman_user_id`	营业员/业务员用户 ID
39	`operator_id`	bigint	`operator_id`	`dwd_groupbuy_redemption_ex.operator_id`	执行本次核销/结算操作的操作员 ID
40	`operator_name`	text	`operator_name`	`dwd_groupbuy_redemption_ex.operator_name`	操作员名称（包含角色说明），与 operator_id 对应的冗余展示字段
41	`is_single_order`	integer	`is_single_order`	`dwd_groupbuy_redemption.is_single_order`	是否单独作为一条订单行
42	`is_delete`	integer	`is_delete`	`dwd_groupbuy_redemption.is_delete`	逻辑删除标记（0=否，1=是）
43	`create_time`	timestamp without time zone	`create_time`	`dwd_groupbuy_redemption.create_time`	本条团购套餐使用流水创建时间（即券核销时间，或与结账时间接近）
44	`assistant_service_share_money`	numeric	`assistant_service_share_money`	`dwd_groupbuy_redemption_ex.assistant_service_share_money`	助教服务分摊金额
45	`assistant_share_money`	numeric	`assistant_share_money`	`dwd_groupbuy_redemption_ex.assistant_share_money`	助教分摊金额
46	`coupon_sale_id`	bigint	`coupon_sale_id`	`dwd_groupbuy_redemption.coupon_sale_id`	优惠券销售ID
47	`good_service_share_money`	numeric	`good_service_share_money`	`dwd_groupbuy_redemption_ex.good_service_share_money`	商品服务分摊金额
48	`goods_share_money`	numeric	`goods_share_money`	`dwd_groupbuy_redemption_ex.goods_share_money`	商品分摊金额
49	`member_discount_money`	numeric	`member_discount_money`	`dwd_groupbuy_redemption.member_discount_money`	会员折扣金额
50	`recharge_share_money`	numeric	`recharge_share_money`	`dwd_groupbuy_redemption_ex.recharge_share_money`	充值分摊金额
51	`table_service_share_money`	numeric	`table_service_share_money`	`dwd_groupbuy_redemption_ex.table_service_share_money`	台费服务分摊金额
52	`table_share_money`	numeric	`table_share_money`	`dwd_groupbuy_redemption_ex.table_share_money`	台费分摊金额

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dwd_groupbuy_redemption 🔗 ODS

共 25 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`redemption_id`	bigint	`id`	直接	核销 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`site_id`	bigint	`site_id`	直接	门店 ID
4	`table_id`	bigint	`table_id`	直接	台桌 ID → dim_table
5	`tenant_table_area_id`	bigint	`tenant_table_area_id`	直接	台区 ID
6	`table_charge_seconds`	integer	`table_charge_seconds`	直接	台费计费时长（秒）。样本值: 3600=1h, 7200=2h, 10800=3h 等
7	`order_trade_no`	bigint	`order_trade_no`	直接	订单号
8	`order_settle_id`	bigint	`order_settle_id`	直接	结账单 ID → dwd_settlement_head
9	`order_coupon_id`	bigint	`order_coupon_id`	直接	订单券 ID
10	`coupon_origin_id`	bigint	`coupon_origin_id`	直接	券来源 ID
11	`promotion_activity_id`	bigint	`promotion_activity_id`	直接	促销活动 ID
12	`promotion_coupon_id`	bigint	`promotion_coupon_id`	直接	促销券 ID → dim_groupbuy_package
13	`order_coupon_channel`	integer	`order_coupon_channel`	直接	券渠道。枚举值: 1=美团, 2=抖音
14	`ledger_unit_price`	numeric	`ledger_unit_price`	直接	单价（元）。样本值: 29.90, 12.12, 11.11, 39.90 等
15	`ledger_count`	integer	`ledger_count`	直接	计费数量（秒）。样本值: 3600=1h, 7200=2h 等
16	`ledger_amount`	numeric	`ledger_amount`	直接	账本金额（元）。样本值: 48.00, 96.00, 68.00 等
17	`coupon_money`	numeric	`coupon_money`	直接	券面额（元）。样本值: 48.00, 116.00, 96.00, 68.00 等
18	`promotion_seconds`	integer	`promotion_seconds`	直接	促销时长（秒）。样本值: 3600=1h, 7200=2h, 14400=4h 等
19	`coupon_code`	character varying	`coupon_code`	直接	券码
20	`is_single_order`	integer	`is_single_order`	直接	是否独立订单。枚举值: 0=否, 1=是
21	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
22	`ledger_name`	character varying	`ledger_name`	直接	套餐名称。样本值: "全天A区中八一小时", "中八A区新人特惠一小时" 等
23	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
24	`member_discount_money`	numeric	`member_discount_money`	直接	会员折扣金额
25	`coupon_sale_id`	bigint	`coupon_sale_id`	直接	优惠券销售 ID

DWD 表结构 — dwd.dwd_groupbuy_redemption_ex 🔗 ODS

共 28 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`redemption_id`	bigint	`id`	直接	字段重命名
2	`site_name`	character varying	`sitename`	直接	字段重命名
3	`table_name`	character varying	`tablename`	直接	字段重命名
4	`table_area_name`	character varying	`tableareaname`	直接	字段重命名
5	`order_pay_id`	bigint	`order_pay_id`	直接	同名直传
6	`goods_option_price`	numeric	`goodsoptionprice`	直接	字段重命名
7	`goods_promotion_money`	numeric	`goods_promotion_money`	直接	同名直传
8	`table_service_promotion_money`	numeric	`table_service_promotion_money`	直接	同名直传
9	`assistant_promotion_money`	numeric	`assistant_promotion_money`	直接	同名直传
10	`assistant_service_promotion_money`	numeric	`assistant_service_promotion_money`	直接	同名直传
11	`reward_promotion_money`	numeric	`reward_promotion_money`	直接	同名直传
12	`recharge_promotion_money`	numeric	`recharge_promotion_money`	直接	同名直传
13	`offer_type`	integer	`offer_type`	直接	同名直传
14	`ledger_status`	integer	`ledger_status`	直接	同名直传
15	`operator_id`	bigint	`operator_id`	直接	同名直传
16	`operator_name`	character varying	`operator_name`	直接	同名直传
17	`salesman_user_id`	bigint	`salesman_user_id`	直接	同名直传
18	`salesman_name`	character varying	`salesman_name`	直接	名称字段，用于展示与辅助识别
19	`salesman_role_id`	bigint	`salesman_role_id`	直接	同名直传
20	`salesman_org_id`	bigint	`sales_man_org_id`	直接	字段重命名
21	`ledger_group_name`	character varying	`ledger_group_name`	直接	名称字段，用于展示与辅助识别
22	`table_share_money`	numeric	`table_share_money`	直接
23	`table_service_share_money`	numeric	`table_service_share_money`	直接
24	`goods_share_money`	numeric	`goods_share_money`	直接
25	`good_service_share_money`	numeric	`good_service_share_money`	直接
26	`assistant_share_money`	numeric	`assistant_share_money`	直接
27	`assistant_service_share_money`	numeric	`assistant_service_share_money`	直接
28	`recharge_share_money`	numeric	`recharge_share_money`	直接

3.16 goods_stock_summary（库存汇总）

任务代码：ODS_INVENTORY_STOCK
采样记录数：173
API JSON 字段数：14
ODS 列数：19
DWD 目标表：dwd_goods_stock_summary

API 源字段 — goods_stock_summary 🔗 ODS

已映射 14/14，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`siteGoodsId`	integer	`sitegoodsid`	（待补充）	大小写匹配；枚举值: `3089190204491141`, `3073782716778501`, `3069455725923269`, `3053572251340677`, `3047846073076101`, `3028609051954117`, `3004536125639493`, `2994236295696133`
2	`goodsName`	string	`goodsname`	（待补充）	大小写匹配；枚举值: `小合味道`, `无穷单个鸡爪`, `大瓶蓝妹`, `金银花凉茶`, `乌龙茶香槟榔`, `酱香爆珠槟榔`, `哇米诺豆奶`, `黄鹤楼`
3	`goodsUnit`	string	`goodsunit`	（待补充）	大小写匹配；枚举值: `桶`, `包`, `瓶`, `罐`, `杯`, `份`, `张`, `个`
4	`goodsCategoryId`	integer	`goodscategoryid`	（待补充）	大小写匹配；枚举值: `2791941988405125`, `2790683528350539`, `2790683528350533`, `2792062778003333`, `2793217944864581`, `2790683528350545`, `2790683528350535`, `2793220945250117`
5	`goodsCategorySecondId`	integer	`goodscategorysecondid`	（待补充）	大小写匹配；枚举值: `2793236829620037`, `2791948300259205`, `2790683528350541`, `2790683528350540`, `2790683528350534`, `2792063209623429`, `2793218343257925`, `2792050275864453`
6	`rangeStartStock`	integer	`rangestartstock`	（待补充）	大小写匹配；枚举值: `21`, `33`, `28`, `12`, `0`, `3`, `5`, `22`
7	`rangeEndStock`	integer	`rangeendstock`	（待补充）	大小写匹配；枚举值: `21`, `33`, `28`, `12`, `0`, `3`, `5`, `22`
8	`rangeIn`	integer	`rangein`	（待补充）	大小写匹配；示例: `0`
9	`rangeOut`	integer	`rangeout`	（待补充）	大小写匹配；示例: `0`
10	`rangeInventory`	integer	`rangeinventory`	（待补充）	大小写匹配；示例: `0`
11	`rangeSale`	integer	`rangesale`	（待补充）	大小写匹配；示例: `0`
12	`rangeSaleMoney`	number	`rangesalemoney`	（待补充）	大小写匹配；示例: `0.0`
13	`currentStock`	integer	`currentstock`	（待补充）	大小写匹配；枚举值: `21`, `33`, `28`, `12`, `0`, `3`, `5`, `22`
14	`categoryName`	string	`categoryname`	（待补充）	大小写匹配；枚举值: `零食`, `酒水`, `槟榔`, `香烟`, `其他`, `果盘`, `器材`, `小吃`

ODS 表结构 — ods.goods_stock_summary 🔗 API

共 19 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`sitegoodsid`	bigint	`siteGoodsId`	—	（待补充）
2	`goodsname`	text	`goodsName`	—	（待补充）
3	`goodsunit`	text	`goodsUnit`	—	（待补充）
4	`goodscategoryid`	bigint	`goodsCategoryId`	—	（待补充）
5	`goodscategorysecondid`	bigint	`goodsCategorySecondId`	—	（待补充）
6	`categoryname`	text	`categoryName`	—	（待补充）
7	`rangestartstock`	numeric	`rangeStartStock`	—	（待补充）
8	`rangeendstock`	numeric	`rangeEndStock`	—	（待补充）
9	`rangein`	numeric	`rangeIn`	—	（待补充）
10	`rangeout`	numeric	`rangeOut`	—	（待补充）
11	`rangesale`	numeric	`rangeSale`	—	（待补充）
12	`rangesalemoney`	numeric	`rangeSaleMoney`	—	（待补充）
13	`rangeinventory`	numeric	`rangeInventory`	—	（待补充）
14	`currentstock`	numeric	`currentStock`	—	（待补充）

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_goods_stock_summary 🔗 ODS

共 17 列（其中 1 个白名单列已折叠）

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_goods_id`	bigint	—	—	未显式映射
2	`goods_name`	text	—	—	未显式映射
3	`goods_unit`	text	—	—	未显式映射
4	`goods_category_id`	bigint	—	—	未显式映射
5	`goods_category_second_id`	bigint	—	—	未显式映射
6	`category_name`	text	—	—	未显式映射
7	`range_start_stock`	numeric	—	—	未显式映射
8	`range_end_stock`	numeric	—	—	未显式映射
9	`range_in`	numeric	—	—	未显式映射
10	`range_out`	numeric	—	—	未显式映射
11	`range_sale`	numeric	—	—	未显式映射
12	`range_sale_money`	numeric	—	—	未显式映射
13	`range_inventory`	numeric	—	—	未显式映射
14	`current_stock`	numeric	—	—	未显式映射
15	`site_id`	bigint	—	—	未显式映射
16	`tenant_id`	bigint	—	—	未显式映射

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: fetched_at (1 个)

3.17 goods_stock_movements（库存变化记录）

任务代码：ODS_INVENTORY_CHANGE
采样记录数：200
API JSON 字段数：19
ODS 列数：24
DWD 目标表：dwd_goods_stock_movement

API 源字段 — goods_stock_movements 🔗 ODS

已映射 19/19，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`siteGoodsStockId`	integer	`sitegoodsstockid`	（待补充）	大小写匹配；枚举值: `3093864105101509`, `3093838482901317`, `3093793750665542`, `3093746072013125`, `3093710576699717`, `3093707436935493`, `3093706718922885`, `3093703198542021`
2	`siteGoodsId`	integer	`sitegoodsid`	（待补充）	大小写匹配；枚举值: `3004536125639493`, `2793026176012357`, `2793026183041093`, `2793026185154629`, `2828836772432837`, `2793025862799429`, `2793026180501573`, `2794695801409669`
3	`siteId`	integer	`siteid`	（待补充）	大小写匹配；示例: `2790685415443269`
4	`tenantId`	integer	`tenantid`	（待补充）	大小写匹配；示例: `2790683160709957`
5	`stockType`	integer	`stocktype`	（待补充）	大小写匹配；枚举值: `1`, `4`
6	`goodsName`	string	`goodsname`	（待补充）	大小写匹配；枚举值: `哇米诺豆奶`, `哇哈哈矿泉水`, `可乐`, `百威235毫升`, `打火机`, `软玉溪`, `东鹏特饮`, `普通扑克`
7	`createTime`	string	`createtime`	（待补充）	大小写匹配；枚举值: `2026-02-14 00:21:21`, `2026-02-13 23:55:17`, `2026-02-13 23:09:47`, `2026-02-13 22:21:17`, `2026-02-13 21:45:10`, `2026-02-13 21:41:59`, `2026-02-13 21:41:15`, `2026-02-13 21:37:40`
8	`startNum`	integer	`startnum`	（待补充）	大小写匹配；枚举值: `4`, `9`, `68`, `429`, `194`, `5`, `69`, `8`
9	`endNum`	integer	`endnum`	（待补充）	大小写匹配；枚举值: `3`, `8`, `66`, `423`, `193`, `4`, `68`, `7`
10	`changeNum`	integer	`changenum`	（待补充）	大小写匹配；枚举值: `-1`, `-2`, `-6`, `2`, `1`, `-12`, `-4`, `3`
11	`unit`	string	`unit`	库存计量单位	枚举值: `瓶`, `支`, `包`, `盒`, `个`, `桶`, `根`, `份`
12	`price`	number	`price`	商品单价（单位金额）	枚举值: `10.0`, `5.0`, `15.0`, `2.0`, `28.0`, `7.0`, `125.0`, `8.0`
13	`operatorName`	string	`operatorname`	（待补充）	大小写匹配；示例: `收银员:郑丽珊`
14	`changeNumA`	integer	`changenuma`	（待补充）	大小写匹配；示例: `0`
15	`startNumA`	integer	`startnuma`	（待补充）	大小写匹配；示例: `0`
16	`endNumA`	integer	`endnuma`	（待补充）	大小写匹配；示例: `0`
17	`remark`	string	`remark`	备注信息，用于手工记录本次变更的特殊原因说明（例如“盘点差异调整”“报损”）
18	`goodsCategoryId`	integer	`goodscategoryid`	（待补充）	大小写匹配；枚举值: `2790683528350539`, `2793217944864581`, `2792062778003333`, `2791941988405125`
19	`goodsSecondCategoryId`	integer	`goodssecondcategoryid`	（待补充）	大小写匹配；枚举值: `2790683528350540`, `2790683528350541`, `2793218343257925`, `2792063209623429`, `2793236829620037`, `2791948300259205`

ODS 表结构 — ods.goods_stock_movements 🔗 API

共 24 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`sitegoodsstockid`	bigint	`siteGoodsStockId`	—	（待补充）
2	`tenantid`	bigint	`tenantId`	—	（待补充）
3	`siteid`	bigint	`siteId`	—	（待补充）
4	`sitegoodsid`	bigint	`siteGoodsId`	—	（待补充）
5	`goodsname`	text	`goodsName`	—	（待补充）
6	`goodscategoryid`	bigint	`goodsCategoryId`	—	（待补充）
7	`goodssecondcategoryid`	bigint	`goodsSecondCategoryId`	—	（待补充）
8	`unit`	text	`unit`	`dwd_goods_stock_movement.unit`	库存计量单位
9	`price`	numeric	`price`	`dwd_goods_stock_movement.price`	商品单价（单位金额）
10	`stocktype`	integer	`stockType`	—	（待补充）
11	`changenum`	numeric	`changeNum`	—	（待补充）
12	`startnum`	numeric	`startNum`	—	（待补充）
13	`endnum`	numeric	`endNum`	—	（待补充）
14	`changenuma`	numeric	`changeNumA`	—	（待补充）
15	`startnuma`	numeric	`startNumA`	—	（待补充）
16	`endnuma`	numeric	`endNumA`	—	（待补充）
17	`remark`	text	`remark`	`dwd_goods_stock_movement.remark`	备注信息，用于手工记录本次变更的特殊原因说明（例如“盘点差异调整”“报损”）
18	`operatorname`	text	`operatorName`	—	（待补充）
19	`createtime`	timestamp without time zone	`createTime`	—	（待补充）

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_goods_stock_movement 🔗 ODS

共 20 列（其中 1 个白名单列已折叠）

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_goods_stock_id`	bigint	—	—	未显式映射
2	`tenant_id`	bigint	—	—	未显式映射
3	`site_id`	bigint	—	—	未显式映射
4	`site_goods_id`	bigint	—	—	未显式映射
5	`goods_name`	text	—	—	未显式映射
6	`goods_category_id`	bigint	—	—	未显式映射
7	`goods_second_category_id`	bigint	—	—	未显式映射
8	`unit`	text	`unit`	直接
9	`price`	numeric	`price`	→ numeric
10	`stock_type`	integer	—	—	未显式映射
11	`change_num`	numeric	—	—	未显式映射
12	`start_num`	numeric	—	—	未显式映射
13	`end_num`	numeric	—	—	未显式映射
14	`change_num_a`	numeric	—	—	未显式映射
15	`start_num_a`	numeric	—	—	未显式映射
16	`end_num_a`	numeric	—	—	未显式映射
17	`remark`	text	`remark`	直接
18	`operator_name`	text	—	—	未显式映射
19	`create_time`	timestamp with time zone	—	—	未显式映射

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: fetched_at (1 个)

3.18 site_tables_master（台桌维表）

任务代码：ODS_TABLES
采样记录数：74
API JSON 字段数：26
ODS 列数：31
DWD 目标表：dim_table, dim_table_ex

API 源字段 — site_tables_master 🔗 ODS

已映射 26/26，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`id`	integer	`id`	台桌主键 ID	枚举值: `2791964216463493`, `2792521437958213`, `2793001695301765`, `2793001904918661`, `2793002509209733`, `2793002673295493`, `2793002808987781`, `2793002896494725`
2	`order_id`	integer	`order_id`	订单ID	枚举值: `0`, `2994377264058629`
3	`audit_status`	integer	`audit_status`	当前值：全部为 2	示例: `2`
4	`charge_free`	integer	`charge_free`	当前值：全部为 0	示例: `0`
5	`self_table`	integer	`self_table`	当前值：全部为 1	示例: `1`
6	`create_time`	string	`create_time`	台桌配置的创建时间或最近一次创建/复制时间	枚举值: `2025-07-15 17:52:54`, `2025-07-16 03:19:44`, `2025-07-16 11:28:17`, `2025-07-16 11:28:30`, `2025-07-16 11:29:07`, `2025-07-16 11:29:17`, `2025-07-16 11:29:25`, `2025-07-16 11:29:30`
7	`is_rest_area`	integer	`is_rest_area`	当前值：全部为 0	示例: `0`
8	`light_status`	integer	`light_status`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `2`, `1`
9	`show_status`	integer	`show_status`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `2`
10	`site_id`	integer	`site_id`	门店 ID	示例: `2790685415443269`
11	`site_table_area_id`	integer	`site_table_area_id`	门店维度的“台桌区域 ID”	枚举值: `2791963794329671`, `2791963807682693`, `2791963816579205`, `2791963825803397`, `2791963836207173`, `2791963848527941`, `2791963864273029`, `2791963887030341`
12	`table_cloth_use_time`	integer	`table_cloth_use_time`	时间字段，用于记录业务时间点/发生时间	枚举值: `3847788`, `3997128`, `4828391`, `4752591`, `4550047`, `1776155`, `4028812`, `3444224`
13	`table_cloth_use_Cycle`	integer	`table_cloth_use_cycle`	（待补充）	大小写匹配；示例: `0`
14	`virtual_table`	integer	`virtual_table`	当前值：全部为 0	示例: `0`
15	`table_name`	string	`table_name`	台号/台名称，用于前台操作界面展示，也出现在小票和各种流水中的 ledger_name 或 tableName 字段	枚举值: `A1`, `A2`, `A3`, `A4`, `A5`, `A6`, `A7`, `A8`
16	`table_price`	number	`table_price`	设计上应为“台的基础单价”字段（例如按小时或按局单价）	示例: `0.0`
17	`table_status`	integer	`table_status`	台当前运行状态，真实反映某一时刻台的占用/暂停情况	枚举值: `1`, `3`
18	`areaName`	string	`areaname`	（待补充）	大小写匹配；枚举值: `A区`, `B区`, `C区`, `VIP包厢`, `斯诺克区`, `666`, `TV台`, `麻将房`
19	`siteName`	string	`sitename`	（待补充）	大小写匹配；示例: `朗朗桌球`
20	`tableStatusName`	string	`tablestatusname`	（待补充）	大小写匹配；枚举值: `空闲中`, `暂停中`
21	`appletQrCodeUrl`	string	`appletqrcodeurl`	（待补充）	大小写匹配；示例: `https://pc-we.ficoo.vip/roo...`
22	`only_allow_groupon`	integer	`only_allow_groupon`	小程序二维码 URL	示例: `2`
23	`delay_lights_time`	integer	`delay_lights_time`	台灯熄灭延迟时间（单位多半是秒或分钟），用于结账后延时关灯	示例: `0`
24	`order_delay_time`	integer	`order_delay_time`	订单层面允许的“自动延时时长”（例如到点后自动延长多少时间继续计费）	示例: `0`
25	`temporary_light_second`	integer	`temporary_light_second`	临时点灯时长（秒），例如手动临时开灯一段时间	示例: `0`
26	`is_online_reservation`	integer	`is_online_reservation`	布尔/开关字段，用于表示权限、可用性或状态开关	枚举值: `2`, `1`

ODS 表结构 — ods.site_tables_master 🔗 API

共 31 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_table.table_id`, `dim_table_ex.table_id`	台桌主键 ID
2	`site_id`	bigint	`site_id`	`dim_table.site_id`	门店 ID
3	`sitename`	text	`siteName`	`dim_table_ex.sitename`	（待补充）
4	`appletQrCodeUrl`	text	—	—	（待补充）
5	`areaname`	text	`areaName`	`dim_table.site_table_area_name`	（待补充）
6	`audit_status`	integer	`audit_status`	`dim_table_ex.audit_status`	当前值：全部为 2
7	`charge_free`	integer	`charge_free`	`dim_table_ex.charge_free`	当前值：全部为 0
8	`create_time`	timestamp without time zone	`create_time`	`dim_table_ex.create_time`	台桌配置的创建时间或最近一次创建/复制时间
9	`delay_lights_time`	integer	`delay_lights_time`	`dim_table_ex.delay_lights_time`	台灯熄灭延迟时间（单位多半是秒或分钟），用于结账后延时关灯
10	`is_online_reservation`	integer	`is_online_reservation`	`dim_table_ex.is_online_reservation`	布尔/开关字段，用于表示权限、可用性或状态开关
11	`is_rest_area`	integer	`is_rest_area`	`dim_table_ex.is_rest_area`	当前值：全部为 0
12	`light_status`	integer	`light_status`	`dim_table_ex.light_status`	来自 JSON 导出的原始字段，用于保留业务取值
13	`only_allow_groupon`	integer	`only_allow_groupon`	`dim_table_ex.only_allow_groupon`	小程序二维码 URL
14	`order_delay_time`	integer	`order_delay_time`	`dim_table_ex.order_delay_time`	订单层面允许的“自动延时时长”（例如到点后自动延长多少时间继续计费）
15	`self_table`	integer	`self_table`	`dim_table_ex.self_table`	当前值：全部为 1
16	`show_status`	integer	`show_status`	`dim_table_ex.show_status`	来自 JSON 导出的原始字段，用于保留业务取值
17	`site_table_area_id`	bigint	`site_table_area_id`	`dim_table.site_table_area_id`, `dim_table.tenant_table_area_id`	门店维度的“台桌区域 ID”
18	`tablestatusname`	text	`tableStatusName`	`dim_table_ex.tablestatusname`	（待补充）
19	`table_cloth_use_cycle`	integer	`table_cloth_use_Cycle`	`dim_table_ex.table_cloth_use_cycle`	（待补充）
20	`table_cloth_use_time`	timestamp without time zone	`table_cloth_use_time`	`dim_table_ex.table_cloth_use_time`	时间字段，用于记录业务时间点/发生时间
21	`table_name`	text	`table_name`	`dim_table.table_name`	台号/台名称，用于前台操作界面展示，也出现在小票和各种流水中的 ledger_name 或 tableName 字段
22	`table_price`	numeric	`table_price`	`dim_table.table_price`	设计上应为“台的基础单价”字段（例如按小时或按局单价）
23	`table_status`	integer	`table_status`	`dim_table_ex.table_status`	台当前运行状态，真实反映某一时刻台的占用/暂停情况
24	`temporary_light_second`	integer	`temporary_light_second`	`dim_table_ex.temporary_light_second`	临时点灯时长（秒），例如手动临时开灯一段时间
25	`virtual_table`	integer	`virtual_table`	`dim_table_ex.virtual_table`	当前值：全部为 0
26	`order_id`	bigint	`order_id`	`dim_table.order_id`	订单ID

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_table 🔗 ODS

共 12 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_id`	bigint	`id`	直接	台桌 ID
2	`site_id`	bigint	`site_id`	直接	门店 ID → dim_site
3	`table_name`	text	`table_name`	直接	台桌名称。样本值: "A1", "A2", "B1", "B2", "S1", "C1", "VIP1...
4	`site_table_area_id`	bigint	`site_table_area_id`	直接	台区 ID
5	`site_table_area_name`	text	`areaname`	直接	台区名称。样本值: "A区", "B区", "补时长", "C区", "麻将房", "K包", "VIP包...
6	`tenant_table_area_id`	bigint	`site_table_area_id`	直接	租户级台区 ID
7	`table_price`	numeric	`table_price`	直接	台桌单价（当前数据全为 0.00）
8	`order_id`	bigint	`order_id`	直接	订单 ID
9	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
10	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
11	`scd2_is_current`	integer	—	SCD2	当前版本标记
12	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_table_ex 🔗 ODS

共 24 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_id`	bigint	`id`	直接	字段重命名
2	`show_status`	integer	`show_status`	直接	同名直传
3	`is_online_reservation`	integer	`is_online_reservation`	直接	同名直传
4	`table_cloth_use_time`	integer	`table_cloth_use_time`	直接	时间/日期字段，用于记录业务时间与统计口径对齐
5	`table_cloth_use_cycle`	integer	`table_cloth_use_cycle`	直接	同名直传
6	`table_status`	integer	`table_status`	直接	同名直传
7	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
8	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
9	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
10	`scd2_version`	integer	—	SCD2	SCD2 元数据
11	`create_time`	timestamp with time zone	`create_time`	直接	台桌配置的创建时间或最近一次创建/复制时间
12	`light_status`	integer	`light_status`	直接	台灯状态枚举（如 2=已开灯），用于标识台桌灯光当前状态
13	`tablestatusname`	text	`tablestatusname`	直接	台桌状态中文名称（如"空闲中""使用中"），仅展示用途
14	`sitename`	text	`sitename`	直接	门店名称快照，冗余字段，配合 site_id 使用
15	`applet_qr_code_url`	text	—	—	未显式映射
16	`audit_status`	integer	`audit_status`	直接	审核状态枚举（当前全部为 2，含义待确认）
17	`charge_free`	integer	`charge_free`	直接	是否免费台（0=收费，1=免费），当前全部为 0
18	`delay_lights_time`	integer	`delay_lights_time`	直接	台灯熄灭延迟时间（单位秒或分钟），结账后延时关灯
19	`is_rest_area`	integer	`is_rest_area`	直接	是否休息区台桌（0=否，1=是），当前全部为 0
20	`only_allow_groupon`	integer	`only_allow_groupon`	直接	是否仅允许团购开台（0/1/2 枚举）
21	`order_delay_time`	integer	`order_delay_time`	直接	订单自动延时时长（到点后自动延长继续计费的时间）
22	`self_table`	integer	`self_table`	直接	是否自有台桌（1=自有），当前全部为 1
23	`temporary_light_second`	integer	`temporary_light_second`	直接	临时开灯秒数，用于短时照明场景
24	`virtual_table`	integer	`virtual_table`	直接	是否虚拟台桌（0=实体台，1=虚拟台）

3.19 stock_goods_category_tree（库存商品分类树）

任务代码：ODS_GOODS_CATEGORY
采样记录数：9
API JSON 字段数：20
ODS 列数：16
DWD 目标表：dim_goods_category

API 源字段 — stock_goods_category_tree 🔗 ODS

已映射 20/20，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`id`	integer	`id`	分类节点主键 ID（在商品分类维度中的唯一标识）	枚举值: `2790683528350533`, `2790683528350535`, `2790683528350539`, `2790683528350545`, `2791941988405125`, `2791942087561093`, `2792062778003333`, `2793217944864581`
2	`tenant_id`	integer	`tenant_id`	租户 ID（品牌/商户 ID）	示例: `2790683160709957`
3	`category_name`	string	`category_name`	分类名称（实际业务分类名称）	枚举值: `槟榔`, `器材`, `酒水`, `果盘`, `零食`, `雪糕`, `香烟`, `其他`
4	`alias_name`	string	`alias_name`	名称字段，用于展示与辅助识别
5	`pid`	integer	`pid`	父级分类 ID	示例: `0`
6	`business_name`	string	`business_name`	业务大类名称	枚举值: `槟榔`, `器材`, `酒水`, `水果`, `零食`, `雪糕`, `香烟`, `其他`
7	`tenant_goods_business_id`	integer	`tenant_goods_business_id`	业务大类 ID	枚举值: `2790683528317766`, `2790683528317767`, `2790683528317768`, `2790683528317769`, `2791932037238661`, `2791931866402693`, `2790683528317765`, `2793217599407941`
8	`open_salesman`	integer	`open_salesman`	是否启用“营业员”或“导购提成”相关的功能开关	示例: `2`
9	`categoryBoxes[].id`	integer	`id`	分类节点主键 ID（在商品分类维度中的唯一标识）	枚举值: `2790683528350534`, `2790683528350536`, `2790683528350537`, `2790683528350538`, `2790683528350540`, `2790683528350541`, `2790683528350542`, `2790683528350543`
10	`categoryBoxes[].tenant_id`	integer	`tenant_id`	租户 ID（品牌/商户 ID）	示例: `2790683160709957`
11	`categoryBoxes[].category_name`	string	`category_name`	分类名称（实际业务分类名称）	枚举值: `槟榔`, `皮头`, `球杆`, `其他`, `饮料`, `酒水`, `茶水`, `咖啡`
12	`categoryBoxes[].alias_name`	string	`alias_name`	名称字段，用于展示与辅助识别
13	`categoryBoxes[].pid`	integer	`pid`	父级分类 ID	枚举值: `2790683528350533`, `2790683528350535`, `2790683528350539`, `2790683528350545`, `2791941988405125`, `2791942087561093`, `2792062778003333`, `2793217944864581`
14	`categoryBoxes[].business_name`	string	`business_name`	业务大类名称	枚举值: `槟榔`, `器材`, `酒水`, `水果`, `零食`, `雪糕`, `香烟`, `其他`
15	`categoryBoxes[].tenant_goods_business_id`	integer	`tenant_goods_business_id`	业务大类 ID	枚举值: `2790683528317766`, `2790683528317767`, `2790683528317768`, `2790683528317769`, `2791932037238661`, `2791931866402693`, `2790683528317765`, `2793217599407941`
16	`categoryBoxes[].open_salesman`	integer	`open_salesman`	是否启用“营业员”或“导购提成”相关的功能开关	示例: `2`
17	`categoryBoxes[].sort`	integer	`sort`	分类的排序序号，用于前端展示顺序的控制	枚举值: `0`, `1`
18	`categoryBoxes[].is_warehousing`	integer	`is_warehousing`	本文件可视为“所有参与库存管理的商品分类清单”，因此均为 1	示例: `1`
19	`sort`	integer	`sort`	分类的排序序号，用于前端展示顺序的控制	枚举值: `1`, `0`
20	`is_warehousing`	integer	`is_warehousing`	本文件可视为“所有参与库存管理的商品分类清单”，因此均为 1	示例: `1`

ODS 表结构 — ods.stock_goods_category_tree 🔗 API

共 16 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_goods_category.category_id`	分类节点主键 ID（在商品分类维度中的唯一标识）
2	`tenant_id`	bigint	`tenant_id`	`dim_goods_category.tenant_id`	租户 ID（品牌/商户 ID）
3	`category_name`	text	`category_name`	`dim_goods_category.category_name`	分类名称（实际业务分类名称）
4	`alias_name`	text	`alias_name`	`dim_goods_category.alias_name`	名称字段，用于展示与辅助识别
5	`pid`	bigint	`pid`	`dim_goods_category.parent_category_id`	父级分类 ID
6	`business_name`	text	`business_name`	`dim_goods_category.business_name`	业务大类名称
7	`tenant_goods_business_id`	bigint	`tenant_goods_business_id`	`dim_goods_category.tenant_goods_business_id`	业务大类 ID
8	`open_salesman`	integer	`open_salesman`	`dim_goods_category.open_salesman`	是否启用“营业员”或“导购提成”相关的功能开关
9	`categoryboxes`	jsonb	—	—	（待补充）
10	`sort`	integer	`categoryBoxes[].sort`	`dim_goods_category.sort_order`	分类的排序序号，用于前端展示顺序的控制
11	`is_warehousing`	integer	`categoryBoxes[].is_warehousing`	`dim_goods_category.is_warehousing`	本文件可视为“所有参与库存管理的商品分类清单”，因此均为 1

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dim_goods_category 🔗 ODS

共 16 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`category_id`	bigint	`id`	直接	分类唯一标识
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID（当前值: 2790683160709957）
3	`category_name`	character varying	`category_name`	直接	分类名称。样本值: "槟榔", "皮头" 等
4	`alias_name`	character varying	`alias_name`	直接	分类别名（当前数据大部分为空）
5	`parent_category_id`	bigint	`pid`	直接	父级分类 ID（0=一级分类）→ 自关联
6	`business_name`	character varying	`business_name`	直接	业务大类名称。样本值: "酒水", "器材" 等
7	`tenant_goods_business_id`	bigint	`tenant_goods_business_id`	直接	业务大类 ID
8	`category_level`	integer	`CASE WHEN pid = 0 THEN 1 ELSE 2 END`	直接	分类层级。枚举值: 1=一级大类, 2=二级子类
9	`is_leaf`	integer	`CASE WHEN categoryboxes IS NULL OR jsonb_array_length(categoryboxes)=0 THEN 1 ELSE 0 END`	直接	是否叶子节点。枚举值: 0=非叶子, 1=叶子
10	`open_salesman`	integer	`open_salesman`	直接	营业员开关。
11	`sort_order`	integer	`sort`	直接	排序序号
12	`is_warehousing`	integer	`is_warehousing`	直接	是否库存管理。枚举值: 1=参与库存管理
13	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
14	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
15	`scd2_is_current`	integer	—	SCD2	当前版本标记
16	`scd2_version`	integer	—	SCD2	版本号

3.20 store_goods_master（门店商品档案）

任务代码：ODS_STORE_GOODS
采样记录数：173
API JSON 字段数：53
ODS 列数：52
DWD 目标表：dim_store_goods, dim_store_goods_ex

API 源字段 — store_goods_master 🔗 ODS

已映射 48/53，覆盖率 90.6%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`siteName`	string	`sitename`	（待补充）	大小写匹配；示例: `朗朗桌球`
2	`oneCategoryName`	string	`onecategoryname`	（待补充）	大小写匹配；枚举值: `零食`, `酒水`, `小吃`, `其他`, `香烟`, `果盘`, `雪糕`, `器材`
3	`twoCategoryName`	string	`twocategoryname`	（待补充）	大小写匹配；枚举值: `面`, `洋酒`, `小吃`, `其他2`, `香烟`, `果盘`, `雪糕`, `零食`
4	`goodsStockWarningInfo.tenant_goods_id`	integer	`tenant_goods_id`	租户/品牌维度的商品 ID，相当于“全局商品 ID”	示例: `0`
5	`goodsStockWarningInfo.site_goods_id`	integer	⚠️ 未映射		📦 嵌套对象；示例: `0`
6	`goodsStockWarningInfo.sales_day`	number	⚠️ 未映射		📦 嵌套对象；示例: `0.0`
7	`goodsStockWarningInfo.warning_day_max`	integer	⚠️ 未映射		📦 嵌套对象；示例: `0`
8	`goodsStockWarningInfo.warning_day_min`	integer	⚠️ 未映射		📦 嵌套对象；示例: `0`
9	`id`	integer	`id`	门店商品 ID，门店维度的商品主键	枚举值: `2793025844727877`, `2793025849102405`, `2793025851560005`, `3089190204491141`, `2794695800246405`, `2794695800443013`, `2793025845825605`, `2793025849593925`
10	`able_discount`	integer	`able_discount`	是否允许参与折扣	示例: `1`
11	`able_site_transfer`	integer	`able_site_transfer`	表示是否允许跨门店调拨或跨站点共享库存	枚举值: `2`, `0`
12	`audit_status`	integer	`audit_status`	观察值：全部为 2	示例: `2`
13	`average_monthly_sales`	number	`average_monthly_sales`	平均月销量（件/月），根据某个统计周期内的销售数据折算而来	枚举值: `1.81`, `0.61`, `0.74`, `0.1`, `0.0`, `3.48`, `6.87`, `0.06`
14	`batch_stock_quantity`	integer	`batch_stock_quantity`	当前“批次”的库存数量（主单位）	枚举值: `31`, `22`, `0`, `24`, `1`, `2`, `136`, `20`
15	`commodity_code`	string	`commodity_code`	商品编码	枚举值: `10000002`, `1234541`, `1234545`, `1111111111`, `10000`, `10002`, `100001`, `1234551`
16	`cost_price`	number	`cost_price`	商品成本价（单件成本）	枚举值: `0.0`, `0.0002`, `2.0`, `0.0009`, `0.4377`, `0.1308`, `2.8679`, `0.0089`
17	`cost_price_type`	integer	`cost_price_type`	1 代表使用“固定成本价”（手工维护的 cost_price），provisional_total_cost 按“...	枚举值: `1`, `2`
18	`create_time`	string	`create_time`	门店商品档案创建时间（商品在门店建立档案的时间点）	枚举值: `2025-07-16 11:52:51`, `2026-02-10 17:06:49`, `2025-07-17 16:11:37`, `2025-07-16 11:53:11`, `2025-07-22 18:46:04`, `2025-07-22 21:43:02`, `2025-07-29 18:22:17`, `2025-08-10 19:01:36`
19	`custom_label_type`	integer	`custom_label_type`	自定义标签类型	示例: `2`
20	`days_available`	integer	`days_available`	商品“在架天数”或“可售天数”，大致等于当前时间减去首次上架时间	枚举值: `13`, `22`, `0`, `210`, `33`, `6`, `633`, `13942`
21	`enable_status`	integer	`enable_status`	控制商品档案是否参与任何业务（库存、销售等）	示例: `1`
22	`forbid_sell_status`	integer	`forbid_sell_status`	观察值：全部为 1	示例: `1`
23	`freeze`	integer	`freeze`	（待补充）	示例: `0`
24	`goods_bar_code`	string	`goods_bar_code`	商品条形码（如 EAN-13 编码），用于扫码销售
25	`goods_category_id`	integer	`goods_category_id`	商品一级分类 ID	枚举值: `2791941988405125`, `2790683528350539`, `2793220945250117`, `2793217944864581`, `2792062778003333`, `2790683528350545`, `2791942087561093`, `2790683528350535`
26	`goods_cover`	string	`goods_cover`	商品图片 URL（如 OSS 对象存储地址），用于前端展示商品图片	枚举值: `https://oss.ficoo.vip/admin/mWT72w_1721195534466.png`, `https://oss.ficoo.vip/admin/66JknP_1753204240471.jpg`, `https://oss.ficoo.vip/admin/8M1WM7_1753204221337.jpg`, `https://oss.ficoo.vip/admin/rCBBPB_1770715245749.jpg`, `https://oss.ficoo.vip/admin/RWW8bM_1710125368666.jpg`, `https://oss.ficoo.vip/admin/kiMwJG_1753195462903.jpg`, `https://oss.ficoo.vip/admin/iC16iC_1753195476922.jpg`, `https://oss.ficoo.vip/admin/TFrrEm_1753195493834.jpg`
27	`goods_name`	string	`goods_name`	商品名称，例如“合味道泡面”“地道肠”“麻将房茶位费”等	枚举值: `红烧牛肉面`, `火鸡面`, `合味道泡面`, `小合味道`, `名仕`, `人头马`, `鱼蛋`, `地道肠`
28	`goods_second_category_id`	integer	`goods_second_category_id`	商品二级分类 ID	枚举值: `2793236829620037`, `2793221553489733`, `2793221283104581`, `2793218343257925`, `2792063209623429`, `2792050275864453`, `2792035069284229`, `2791948300259205`
29	`goods_state`	integer	`goods_state`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `2`
30	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
31	`is_warehousing`	integer	`is_warehousing`	是否纳入库存管理	示例: `1`
32	`min_discount_price`	number	`min_discount_price`	最低允许成交价（限价）	枚举值: `0.0`, `130.0`, `998.0`, `2.0`, `40.0`, `8.0`, `3.0`, `18.0`
33	`not_sale`	integer	`not_sale`	（待补充）	示例: `2`
34	`option_required`	integer	`option_required`	是否需要在销售时选择规格/选项	示例: `1`
35	`pinyin_initial`	string	`pinyin_initial`	商品名称的拼音首字母缩写，有时多个别名用逗号分隔	枚举值: `HSNRM,GSNRM`, `HJM`, `HWDPM,GWDPM`, `XHWD,XGWD`, `MS`, `RTM`, `YD`, `DDC`
36	`provisional_total_cost`	number	`provisional_total_cost`	暂估总成本，单位为元	枚举值: `0.0`, `0.1`, `8.0`, `152.0`
37	`remark`	string	`remark`	商品备注（可以写口味说明、供应商、注意事项等）
38	`safe_stock`	integer	`safe_stock`	安全库存量（阈值），低于该值时系统可以提示补货	示例: `0`
39	`sale_channel`	string	`sale_channel`	销售渠道类型	示例: `1,2,3`
40	`sale_num`	integer	`sale_num`	在当前统计口径下的销售数量（总销量，单位同 unit）	枚举值: `452`, `185`, `218`, `3`, `1`, `0`, `1155`, `2650`
41	`sale_price`	number	`sale_price`	商品标准销售价（挂牌价），单位为元	枚举值: `12.0`, `10.0`, `8.0`, `998.0`, `5.0`, `18.0`, `2.0`, `40.0`
42	`send_state`	integer	`send_state`	观察值：全部为 1	示例: `1`
43	`site_id`	integer	`site_id`	门店 ID	示例: `2790685415443269`
44	`sort`	integer	`sort`	排序权重，用于前端商品列表展示时的排版顺序，数值越小/越大哪个优先，具体规则看系统设定（一般是数值越小排序越靠前）	示例: `100`
45	`stock`	integer	`stock`	当前可用库存数量（以 unit 为单位）	枚举值: `24`, `14`, `0`, `21`, `1`, `2`, `45`, `19`
46	`stock_A`	integer	`stock_a`	（待补充）	大小写匹配；示例: `0`
47	`tenant_goods_id`	integer	`tenant_goods_id`	租户/品牌维度的商品 ID，相当于“全局商品 ID”	枚举值: `2792037812375429`, `2792170827517829`, `2792178593255301`, `3089189492279813`, `2793225054603077`, `2793226137552709`, `2792152201432965`, `2792171921870725`
48	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
49	`time_slot_sale`	integer	⚠️ 未映射		示例: `2`
50	`total_purchase_cost`	number	`total_purchase_cost`	总采购成本，单位为元	枚举值: `0.0`, `0.1`, `0.23`, `24.07`, `8.24`, `152.0`, `0.63`, `108.53`
51	`total_sales`	integer	`total_sales`	累计销售数量	枚举值: `452`, `185`, `218`, `3`, `1`, `0`, `1155`, `2650`
52	`unit`	string	`unit`	商品计量单位（销售单位）	枚举值: `桶`, `瓶`, `份`, `根`, `盒`, `个`, `杯`, `支`
53	`update_time`	string	`update_time`	最后一次修改该商品档案的时间（包括价格调整、状态变更等）	枚举值: `2026-02-13 18:56:51`, `2026-02-12 00:07:13`, `2026-02-10 17:07:59`, `2026-02-13 17:31:06`, `2025-11-21 00:46:49`, `2025-07-21 11:05:15`, `2026-02-10 00:34:11`, `2026-01-01 02:53:23`

ODS 表结构 — ods.store_goods_master 🔗 API

共 52 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_store_goods.site_goods_id`, `dim_store_goods_ex.site_goods_id`	门店商品 ID，门店维度的商品主键
2	`tenant_id`	bigint	`tenant_id`	`dim_store_goods.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dim_store_goods.site_id`	门店 ID
4	`sitename`	text	`siteName`	`dim_store_goods_ex.site_name`	（待补充）
5	`tenant_goods_id`	bigint	`goodsStockWarningInfo.tenant_goods_id`	`dim_store_goods.tenant_goods_id`	租户/品牌维度的商品 ID，相当于“全局商品 ID”
6	`goods_name`	text	`goods_name`	`dim_store_goods.goods_name`	商品名称，例如“合味道泡面”“地道肠”“麻将房茶位费”等
7	`goods_bar_code`	text	`goods_bar_code`	`dim_store_goods_ex.goods_barcode`	商品条形码（如 EAN-13 编码），用于扫码销售
8	`goods_category_id`	bigint	`goods_category_id`	`dim_store_goods.goods_category_id`	商品一级分类 ID
9	`goods_second_category_id`	bigint	`goods_second_category_id`	`dim_store_goods.goods_second_category_id`	商品二级分类 ID
10	`onecategoryname`	text	`oneCategoryName`	`dim_store_goods.category_level1_name`	（待补充）
11	`twocategoryname`	text	`twoCategoryName`	`dim_store_goods.category_level2_name`	（待补充）
12	`unit`	text	`unit`	`dim_store_goods_ex.unit`	商品计量单位（销售单位）
13	`sale_price`	numeric	`sale_price`	`dim_store_goods.sale_price`	商品标准销售价（挂牌价），单位为元
14	`cost_price`	numeric	`cost_price`	`dim_store_goods_ex.cost_price`	商品成本价（单件成本）
15	`cost_price_type`	integer	`cost_price_type`	`dim_store_goods_ex.cost_price_type`	1 代表使用“固定成本价”（手工维护的 cost_price），provisional_total_cost 按“...
16	`min_discount_price`	numeric	`min_discount_price`	`dim_store_goods_ex.min_discount_price`	最低允许成交价（限价）
17	`safe_stock`	numeric	`safe_stock`	`dim_store_goods_ex.safety_stock_qty`	安全库存量（阈值），低于该值时系统可以提示补货
18	`stock`	numeric	`stock`	`dim_store_goods_ex.stock_qty`	当前可用库存数量（以 unit 为单位）
19	`stock_a`	numeric	`stock_A`	`dim_store_goods_ex.stock_secondary_qty`	（待补充）
20	`sale_num`	numeric	`sale_num`	`dim_store_goods.sale_qty`	在当前统计口径下的销售数量（总销量，单位同 unit）
21	`total_purchase_cost`	numeric	`total_purchase_cost`	`dim_store_goods_ex.total_purchase_cost`	总采购成本，单位为元
22	`total_sales`	numeric	`total_sales`	`dim_store_goods.total_sales_qty`	累计销售数量
23	`average_monthly_sales`	numeric	`average_monthly_sales`	`dim_store_goods.avg_monthly_sales`	平均月销量（件/月），根据某个统计周期内的销售数据折算而来
24	`batch_stock_quantity`	numeric	`batch_stock_quantity`	`dim_store_goods.batch_stock_qty`, `dim_store_goods_ex.batch_stock_quantity`	当前“批次”的库存数量（主单位）
25	`days_available`	integer	`days_available`	`dim_store_goods_ex.days_on_shelf`	商品“在架天数”或“可售天数”，大致等于当前时间减去首次上架时间
26	`provisional_total_cost`	numeric	`provisional_total_cost`	`dim_store_goods_ex.provisional_total_cost`	暂估总成本，单位为元
27	`enable_status`	integer	`enable_status`	`dim_store_goods.enable_status`	控制商品档案是否参与任何业务（库存、销售等）
28	`audit_status`	integer	`audit_status`	`dim_store_goods_ex.audit_status`	观察值：全部为 2
29	`goods_state`	integer	`goods_state`	`dim_store_goods.goods_state`	来自 JSON 导出的原始字段，用于保留业务取值
30	`is_delete`	integer	`is_delete`	`dim_store_goods.is_delete`	逻辑删除标志
31	`is_warehousing`	integer	`is_warehousing`	`dim_store_goods_ex.is_warehousing`	是否纳入库存管理
32	`able_discount`	integer	`able_discount`	`dim_store_goods_ex.is_discountable`	是否允许参与折扣
33	`able_site_transfer`	integer	`able_site_transfer`	`dim_store_goods_ex.able_site_transfer`	表示是否允许跨门店调拨或跨站点共享库存
34	`forbid_sell_status`	integer	`forbid_sell_status`	`dim_store_goods_ex.forbid_sell_status`	观察值：全部为 1
35	`freeze`	integer	`freeze`	`dim_store_goods_ex.freeze_status`	（待补充）
36	`send_state`	integer	`send_state`	`dim_store_goods.send_state`	观察值：全部为 1
37	`custom_label_type`	integer	`custom_label_type`	`dim_store_goods_ex.custom_label_type`	自定义标签类型
38	`option_required`	integer	`option_required`	`dim_store_goods_ex.option_required`	是否需要在销售时选择规格/选项
39	`sale_channel`	integer	`sale_channel`	`dim_store_goods_ex.sale_channel`	销售渠道类型
40	`sort`	integer	`sort`	`dim_store_goods_ex.sort_order`	排序权重，用于前端商品列表展示时的排版顺序，数值越小/越大哪个优先，具体规则看系统设定（一般是数值越小排序越靠前）
41	`remark`	text	`remark`	`dim_store_goods_ex.remark`	商品备注（可以写口味说明、供应商、注意事项等）
42	`pinyin_initial`	text	`pinyin_initial`	`dim_store_goods_ex.pinyin_initial`	商品名称的拼音首字母缩写，有时多个别名用逗号分隔
43	`goods_cover`	text	`goods_cover`	`dim_store_goods_ex.goods_cover_url`	商品图片 URL（如 OSS 对象存储地址），用于前端展示商品图片
44	`create_time`	timestamp without time zone	`create_time`	`dim_store_goods.created_at`	门店商品档案创建时间（商品在门店建立档案的时间点）
45	`update_time`	timestamp without time zone	`update_time`	`dim_store_goods.updated_at`	最后一次修改该商品档案的时间（包括价格调整、状态变更等）
46	`commodity_code`	text	`commodity_code`	`dim_store_goods.commodity_code`	商品编码
47	`not_sale`	integer	`not_sale`	`dim_store_goods.not_sale`	（待补充）

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dim_store_goods 🔗 ODS

共 26 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_goods_id`	bigint	`id`	直接	门店商品 ID
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`site_id`	bigint	`site_id`	直接	门店 ID → dim_site
4	`tenant_goods_id`	bigint	`tenant_goods_id`	直接	租户商品 ID → dim_tenant_goods
5	`goods_name`	text	`goods_name`	直接	商品名称。样本值: "双中支中华", "炫赫门小南京"等
6	`goods_category_id`	bigint	`goods_category_id`	直接	一级分类 ID → dim_goods_category
7	`goods_second_category_id`	bigint	`goods_second_category_id`	直接	二级分类 ID → dim_goods_category
8	`category_level1_name`	text	`onecategoryname`	直接	一级分类名称。样本值: "零食", "酒水", "其他", "香烟" 等
9	`category_level2_name`	text	`twocategoryname`	直接	二级分类名称。样本值: "零食", "饮料", "其他2", "香烟", "雪糕", "酒水", "球杆"...
10	`batch_stock_qty`	integer	`batch_stock_quantity`	直接	批次库存数量
11	`sale_qty`	integer	`sale_num`	直接	销售数量
12	`total_sales_qty`	integer	`total_sales`	直接	累计销售数量
13	`sale_price`	numeric	`sale_price`	直接	销售价格（元）
14	`created_at`	timestamp with time zone	`create_time`	直接	创建时间
15	`updated_at`	timestamp with time zone	`update_time`	直接	更新时间
16	`avg_monthly_sales`	numeric	`average_monthly_sales`	直接	月均销量
17	`goods_state`	integer	`goods_state`	直接	商品状态。枚举值: 1=上架, 2=下架
18	`enable_status`	integer	`enable_status`	直接	启用状态。枚举值: 1=启用
19	`send_state`	integer	`send_state`	直接	配送状态。暂无作用
20	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
21	`commodity_code`	text	`commodity_code`	直接	商品编码
22	`not_sale`	integer	`not_sale`	直接	是否停售
23	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
24	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
25	`scd2_is_current`	integer	—	SCD2	当前版本标记
26	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_store_goods_ex 🔗 ODS

共 31 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`site_goods_id`	bigint	`id`	直接	字段重命名
2	`site_name`	text	`sitename`	直接	字段重命名
3	`unit`	text	`unit`	直接	同名直传
4	`goods_barcode`	text	`goods_bar_code`	直接	字段重命名
5	`goods_cover_url`	text	`goods_cover`	直接	字段重命名
6	`pinyin_initial`	text	`pinyin_initial`	直接	同名直传
7	`stock_qty`	integer	`stock`	直接	字段重命名
8	`stock_secondary_qty`	integer	`stock_a`	直接	字段重命名
9	`safety_stock_qty`	integer	`safe_stock`	直接	字段重命名
10	`cost_price`	numeric	`cost_price`	直接	同名直传
11	`cost_price_type`	integer	`cost_price_type`	直接	同名直传
12	`provisional_total_cost`	numeric	`provisional_total_cost`	直接	暂估总成本，区别于实际采购成本（total_purchase_cost）
13	`total_purchase_cost`	numeric	`total_purchase_cost`	直接	同名直传
14	`min_discount_price`	numeric	`min_discount_price`	直接	同名直传
15	`is_discountable`	integer	`able_discount`	直接	字段重命名
16	`days_on_shelf`	integer	`days_available`	直接	字段重命名
17	`audit_status`	integer	`audit_status`	直接	同名直传
18	`sale_channel`	integer	`sale_channel`	直接	同名直传
19	`is_warehousing`	integer	`is_warehousing`	直接	同名直传
20	`freeze_status`	integer	`freeze`	直接	字段重命名
21	`forbid_sell_status`	integer	`forbid_sell_status`	直接	同名直传
22	`able_site_transfer`	integer	`able_site_transfer`	直接	同名直传
23	`custom_label_type`	integer	`custom_label_type`	直接	同名直传
24	`option_required`	integer	`option_required`	直接	同名直传
25	`remark`	text	`remark`	直接	维度字段，用于补充维度属性
26	`sort_order`	integer	`sort`	直接	字段重命名
27	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
28	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
29	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
30	`scd2_version`	integer	—	SCD2	SCD2 元数据
31	`batch_stock_quantity`	numeric	`batch_stock_quantity`	直接	同名直传

3.21 table_fee_discount_records（台费折扣/调账）

任务代码：ODS_TABLE_FEE_DISCOUNT
采样记录数：200
API JSON 字段数：55
ODS 列数：33
DWD 目标表：dwd_table_fee_adjust, dwd_table_fee_adjust_ex

API 源字段 — table_fee_discount_records 🔗 ODS

已映射 30/55，覆盖率 54.5% （其中 26 个白名单字段已折叠）

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`tableProfile.id`	integer	`id`	台费打折 / 调整流水主键 ID	枚举值: `2793022145302597`, `2793001695301765`, `2793023960682565`, `2793020259995717`, `2956248279567557`, `2793018776735877`, `2793023960551493`, `2793012902121605`
2	`tableProfile.tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
3	`tableProfile.tenant_name`	string	`tenant_name`	租户名称
4	`tableProfile.siteName`	string	`sitename`	门店名称	大小写匹配
5	`tableProfile.table_name`	string	`table_name`	台桌名称	枚举值: `888`, `A3`, `M4`, `S3`, `发财`, `VIP5`, `Ｍ1`, `B4`
6	`tableProfile.site_table_area_id`	integer	`site_table_area_id`	门店台区ID	枚举值: `2791963855982661`, `2791963794329671`, `2791963887030341`, `2791963836207173`, `2956246442462533`, `2791963825803397`, `2791963807682693`, `2791963848527941`
7	`tableProfile.area_type_id`	integer	`area_type_id`	区域类型ID	示例: `0`
8	`tableProfile.table_price`	number	`table_price`	台桌价格	示例: `0.0`
9	`tableProfile.ewelink_client_id`	string	⚠️ 未映射		📦 嵌套对象
10	`tableProfile.site_table_area_name`	string	`site_table_area_name`	门店台区名称	枚举值: `K包`, `A区`, `麻将房`, `斯诺克区`, `发财`, `VIP包厢`, `B区`, `666`
11	`tableProfile.charge_free`	integer	`charge_free`	是否免费	示例: `0`
12	`id`	integer	`id`	台费打折 / 调整流水主键 ID	枚举值: `3093721330321541`, `3093570952251653`, `3093460887587141`, `3093240533174469`, `3092712429406405`, `3092712429357253`, `3092668244035717`, `3092563449776389`
13	`adjust_type`	integer	`adjust_type`	文件名是“台费打折”，字段名为“调整类型”，当前所有记录都是 1，即“台费打折/台费减免”这一种调整类型	示例: `1`
14	`applicant_id`	integer	`applicant_id`	打折/调账申请人 ID	示例: `2790687322443013`
15	`applicant_name`	string	`applicant_name`	申请人姓名（带角色描述），为 applicant_id 的冗余显示字段	示例: `收银员:郑丽珊`
16	`create_time`	string	`create_time`	台费调整记录的创建时间，即打折操作被执行的时间戳	枚举值: `2026-02-13 21:56:07`, `2026-02-13 19:23:08`, `2026-02-13 17:31:10`, `2026-02-13 13:47:01`, `2026-02-13 04:49:48`, `2026-02-13 04:04:51`, `2026-02-13 02:18:15`, `2026-02-12 22:05:58`
17	`is_delete`	integer	`is_delete`	逻辑删除标记（0=否，1=是）	示例: `0`
18	`ledger_amount`	number	`ledger_amount`	金额字段，用于计费/结算/分摊等金额计算	枚举值: `125.88`, `66.14`, `64.0`, `34.0`, `1191.01`, `91.21`, `92.66`, `249.16`
19	`ledger_count`	integer	`ledger_count`	这里不是“秒数”，而是“调整次数/条数”的量化，目前固定为 1，表示“一次调账事件”	示例: `1`
20	`ledger_name`	string	`ledger_name`	设计上应该用于记录“调账项目名称”或“打折原因描述”（例如某种优惠规则名称），但当前门店并未使用该字段
21	`ledger_status`	integer	`ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值	枚举值: `1`, `0`
22	`operator_id`	integer	`operator_id`	实际执行调账操作的操作员 ID	示例: `2790687322443013`
23	`operator_name`	string	`operator_name`	操作员姓名	示例: `收银员:郑丽珊`
24	`order_settle_id`	integer	`order_settle_id`	结算单/小票 ID	枚举值: `3093721299536133`, `3093570809759941`, `3093460849854725`, `3093240497031301`, `3092711340902597`, `3092668010514757`, `3092562710104197`, `3092315370047749`
25	`order_trade_no`	integer	`order_trade_no`	订单交易号	枚举值: `3093324364122309`, `3093400552720645`, `3093249285933253`, `3093153157597509`, `3092230766020741`, `3092158231251269`, `3092081794779333`, `3092053788625093`
26	`site_id`	integer	`site_id`	门店 ID，本批数据全部为同一家门店（朗朗桌球）	示例: `2790685415443269`
27	`site_table_id`	integer	`site_table_id`	台桌 ID	枚举值: `2793022145302597`, `2793001695301765`, `2793023960682565`, `2793020259995717`, `2956248279567557`, `2793018776735877`, `2793023960551493`, `2793012902121605`
28	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
29	`tenant_table_area_id`	integer	`tenant_table_area_id`	租户维度的“台桌区域 ID”	枚举值: `2791961709907845`, `2791960001957765`, `2791962314215301`, `2791961347968901`, `2956244810877893`, `2791961060364165`, `2791960521691013`, `2791961598955397`

ℹ️ 白名单字段（已检查，不展开详情）：API 嵌套对象（siteProfile）: siteProfile.id, siteProfile.org_id, siteProfile.shop_name, siteProfile.avatar, siteProfile.business_tel... (26 个)

ODS 表结构 — ods.table_fee_discount_records 🔗 API

共 33 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`tableProfile.id`	`dwd_table_fee_adjust.table_fee_adjust_id`, `dwd_table_fee_adjust_ex.table_fee_adjust_id`	台费打折 / 调整流水主键 ID
2	`tenant_id`	bigint	`tableProfile.tenant_id`	`dwd_table_fee_adjust.tenant_id`	租户/品牌 ID
3	`site_id`	bigint	`site_id`	`dwd_table_fee_adjust.site_id`	门店 ID，本批数据全部为同一家门店（朗朗桌球）
4	`siteprofile`	jsonb	—	—	（待补充）
5	`site_table_id`	bigint	`site_table_id`	`dwd_table_fee_adjust.table_id`	台桌 ID
6	`tableprofile`	jsonb	—	—	（待补充）
7	`tenant_table_area_id`	bigint	`tenant_table_area_id`	`dwd_table_fee_adjust.table_area_id`, `dwd_table_fee_adjust.tenant_table_area_id`	租户维度的“台桌区域 ID”
8	`adjust_type`	integer	`adjust_type`	`dwd_table_fee_adjust_ex.adjust_type`	文件名是“台费打折”，字段名为“调整类型”，当前所有记录都是 1，即“台费打折/台费减免”这一种调整类型
9	`ledger_amount`	numeric	`ledger_amount`	`dwd_table_fee_adjust.ledger_amount`	金额字段，用于计费/结算/分摊等金额计算
10	`ledger_count`	numeric	`ledger_count`	`dwd_table_fee_adjust_ex.ledger_count`	这里不是“秒数”，而是“调整次数/条数”的量化，目前固定为 1，表示“一次调账事件”
11	`ledger_name`	text	`ledger_name`	`dwd_table_fee_adjust_ex.ledger_name`	设计上应该用于记录“调账项目名称”或“打折原因描述”（例如某种优惠规则名称），但当前门店并未使用该字段
12	`ledger_status`	integer	`ledger_status`	`dwd_table_fee_adjust.ledger_status`	来自 JSON 导出的原始字段，用于保留业务取值
13	`applicant_id`	bigint	`applicant_id`	`dwd_table_fee_adjust_ex.applicant_id`	打折/调账申请人 ID
14	`applicant_name`	text	`applicant_name`	`dwd_table_fee_adjust_ex.applicant_name`	申请人姓名（带角色描述），为 applicant_id 的冗余显示字段
15	`operator_id`	bigint	`operator_id`	`dwd_table_fee_adjust_ex.operator_id`	实际执行调账操作的操作员 ID
16	`operator_name`	text	`operator_name`	`dwd_table_fee_adjust_ex.operator_name`	操作员姓名
17	`order_settle_id`	bigint	`order_settle_id`	`dwd_table_fee_adjust.order_settle_id`	结算单/小票 ID
18	`order_trade_no`	text	`order_trade_no`	`dwd_table_fee_adjust.order_trade_no`	订单交易号
19	`is_delete`	integer	`is_delete`	`dwd_table_fee_adjust.is_delete`	逻辑删除标记（0=否，1=是）
20	`create_time`	timestamp without time zone	`create_time`	`dwd_table_fee_adjust.adjust_time`	台费调整记录的创建时间，即打折操作被执行的时间戳
21	`area_type_id`	bigint	`tableProfile.area_type_id`	`dwd_table_fee_adjust_ex.area_type_id`	区域类型ID
22	`charge_free`	boolean	`tableProfile.charge_free`	`dwd_table_fee_adjust.charge_free`	是否免费
23	`site_table_area_id`	bigint	`tableProfile.site_table_area_id`	`dwd_table_fee_adjust_ex.site_table_area_id`	门店台区ID
24	`site_table_area_name`	text	`tableProfile.site_table_area_name`	`dwd_table_fee_adjust_ex.site_table_area_name`	门店台区名称
25	`sitename`	text	`tableProfile.siteName`	`dwd_table_fee_adjust_ex.site_name`	门店名称
26	`table_name`	text	`tableProfile.table_name`	`dwd_table_fee_adjust.table_name`	台桌名称
27	`table_price`	numeric	`tableProfile.table_price`	`dwd_table_fee_adjust.table_price`	台桌价格
28	`tenant_name`	text	`tableProfile.tenant_name`	`dwd_table_fee_adjust_ex.tenant_name`	租户名称

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: content_hash, source_file, source_endpoint, fetched_at, payload (5 个)

DWD 表结构 — dwd.dwd_table_fee_adjust 🔗 ODS

共 16 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_fee_adjust_id`	bigint	`id`	直接	台费调整 ID
2	`order_trade_no`	bigint	`order_trade_no`	直接	订单号
3	`order_settle_id`	bigint	`order_settle_id`	直接	结账单 ID → dwd_settlement_head
4	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
5	`site_id`	bigint	`site_id`	直接	门店 ID
6	`table_id`	bigint	`site_table_id`	直接	台桌 ID → dim_table
7	`table_area_id`	bigint	`tenant_table_area_id`	直接	台区 ID
8	`table_area_name`	character varying	`tableprofile->>'table_area_name'`	直接	台区名称（当前数据全为 NULL）
9	`tenant_table_area_id`	bigint	`tenant_table_area_id`	直接	租户台区 ID
10	`ledger_amount`	numeric	`ledger_amount`	直接	调整金额（元）
11	`ledger_status`	integer	`ledger_status`	直接	账本状态。枚举值: 0=待确认, 1=已确认
12	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
13	`adjust_time`	timestamp with time zone	`create_time`	直接	调整时间
14	`table_name`	text	`table_name`	直接	台桌名称
15	`table_price`	numeric	`table_price`	直接	台桌价格
16	`charge_free`	boolean	`charge_free`	→ boolean	是否免费

DWD 表结构 — dwd.dwd_table_fee_adjust_ex 🔗 ODS

共 13 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`table_fee_adjust_id`	bigint	`id`	直接	字段重命名
2	`adjust_type`	integer	`adjust_type`	直接	同名直传
3	`ledger_count`	integer	`ledger_count`	直接	同名直传
4	`ledger_name`	character varying	`ledger_name`	直接	名称字段，用于展示与辅助识别
5	`applicant_name`	character varying	`applicant_name`	直接	同名直传
6	`operator_name`	character varying	`operator_name`	直接	同名直传
7	`applicant_id`	bigint	`applicant_id`	直接	同名直传
8	`operator_id`	bigint	`operator_id`	直接	同名直传
9	`area_type_id`	bigint	`area_type_id`	直接
10	`site_table_area_id`	bigint	`site_table_area_id`	直接
11	`site_table_area_name`	text	`site_table_area_name`	直接
12	`site_name`	text	`sitename`	直接	字段重命名
13	`tenant_name`	text	`tenant_name`	直接

3.22 tenant_goods_master（租户商品档案）

任务代码：ODS_TENANT_GOODS
采样记录数：174
API JSON 字段数：32
ODS 列数：37
DWD 目标表：dim_tenant_goods, dim_tenant_goods_ex

API 源字段 — tenant_goods_master 🔗 ODS

已映射 32/32，覆盖率 100.0%

#	JSON 字段	类型	→ ODS 列	业务描述	示例值与说明
1	`categoryName`	string	`categoryname`	（待补充）	大小写匹配；枚举值: `饮料`, `面`, `酒水`, `零食`, `槟榔`, `雪糕`, `香烟`, `小吃`
2	`isInSite`	boolean	`isinsite`	（待补充）	大小写匹配；示例: `False`
3	`commodityCode[]`	string	`commoditycode`	（待补充）	大小写匹配；枚举值: `10000028`, `10000002`, `10000012`, `10000020`, `10000010`, `10000006`, `10000123`, `10000019`
4	`id`	integer	`id`	商品档案主键 ID，唯一标识一条商品	枚举值: `2791925230096261`, `2792037812375429`, `2792038476746629`, `2792039804047237`, `2792044495523717`, `2792045494685573`, `2792056126328709`, `2792067181399941`
5	`able_discount`	integer	`able_discount`	是否允许参与折扣/打折	示例: `1`
6	`able_site_transfer`	integer	`able_site_transfer`	布尔/开关字段，用于表示权限、可用性或状态开关	枚举值: `2`, `0`
7	`commodity_code`	string	`commodity_code`	商品编码（通常为对外商品编码或条码）	枚举值: `10000028`, `10000002`, `10000012`, `10000020`, `10000010`, `10000006`, `10000123`, `10000019`
8	`common_sale_royalty`	integer	`common_sale_royalty`	普通销售提成比例或提成金额的配置字段	示例: `0`
9	`cost_price`	number	`cost_price`	成本价格	枚举值: `0.0`, `2.5`, `3.0`, `2.0`, `35.0`
10	`cost_price_type`	integer	`cost_price_type`	金额字段，用于计费/结算/分摊等金额计算	枚举值: `1`, `2`
11	`create_time`	string	`create_time`	商品档案创建时间	枚举值: `2025-07-15 17:13:15`, `2025-07-15 19:07:46`, `2025-07-15 19:08:27`, `2025-07-15 19:09:48`, `2025-07-15 19:14:34`, `2025-07-15 19:15:35`, `2025-07-15 19:26:24`, `2025-07-15 19:37:39`
12	`goods_bar_code`	string	`goods_bar_code`	商品条码（EAN 等），目前未维护
13	`goods_category_id`	integer	`goods_category_id`	商品一级分类 ID	枚举值: `2790683528350539`, `2791941988405125`, `2790683528350533`, `2791942087561093`, `2792062778003333`, `2793220945250117`, `2790683528350535`, `2793217944864581`
14	`goods_cover`	string	`goods_cover`	商品封面图片 URL 地址	枚举值: `https://oss.ficoo.vip/admin/ZwS8fj_1753175129443.jpg`, `https://oss.ficoo.vip/admin/mWT72w_1721195534466.png`, `https://oss.ficoo.vip/admin/rbm2dh_1753175603319.jpg`, `https://oss.ficoo.vip/admin/17r1dP_1721196142478.jpg`, `https://oss.ficoo.vip/admin/bYc2xB_1721195801432.png`, `https://oss.ficoo.vip/admin/xb1n3a_1753204721074.jpg`, `https://oss.ficoo.vip/admin/RWW8bM_1710125368666.jpg`, `https://oss.ficoo.vip/admin/75yN2R_1721196107928.jpg`
15	`goods_name`	string	`goods_name`	商品名称（前台展示名称）	枚举值: `东方树叶`, `红烧牛肉面`, `水溶C`, `百威235毫升`, `薯片`, `100 和成天下`, `可爱多`, `奥利奥饼干`
16	`goods_number`	string	`goods_number`	商品内部编码（自定义货号/系统货号）	枚举值: `1`, `2`, `3`, `4`, `5`, `6`, `9`, `7`
17	`goods_second_category_id`	integer	`goods_second_category_id`	商品二级分类 ID	枚举值: `2790683528350540`, `2793236829620037`, `2790683528350541`, `2791948300259205`, `2790683528350534`, `2792035069284229`, `2792063209623429`, `2793221283104581`
18	`goods_state`	integer	`goods_state`	商品状态（上架/下架等）	枚举值: `1`, `2`
19	`is_delete`	integer	`is_delete`	逻辑删除标志	示例: `0`
20	`is_warehousing`	integer	`is_warehousing`	是否启用库存管理	示例: `1`
21	`market_price`	number	`market_price`	商品标价 / 售价（标准销售单价）	枚举值: `8.0`, `12.0`, `15.0`, `6.0`, `115.0`, `18.0`, `5.0`, `72.0`
22	`min_discount_price`	number	`min_discount_price`	该商品允许售卖的最低价格（底价）	枚举值: `0.0`, `6.0`, `2.0`, `5.0`, `10.0`, `115.0`, `8.0`, `4.0`
23	`not_sale`	integer	`not_sale`	（待补充）	示例: `2`
24	`out_goods_id`	integer	`out_goods_id`	外部系统商品 ID（对接第三方平台使用，如外卖、线上商城等）	示例: `0`
25	`pinyin_initial`	string	`pinyin_initial`	拼音首字母/助记码	枚举值: `DFSY,DFSX`, `HSNRM,GSNRM`, `SRC`, `BW235HS`, `SP`, `100 HCTX`, `KAD`, `ALABG`
26	`point_sale_royalty`	integer	`point_sale_royalty`	积分销售提成/积分赠送规则相关配置	示例: `0`
27	`remark_name`	string	`remark_name`	商品备注名/别名，通常用来配置简写或特殊显示名称
28	`sale_channel`	string	`sale_channel`	销售渠道类型，如“门店堂食/线下零售/线上小程序”等的一种编码	示例: `1,2,3`
29	`supplier_id`	integer	`supplier_id`	供应商 ID，用于关联到供应商档案	示例: `0`
30	`tenant_id`	integer	`tenant_id`	租户/品牌 ID	示例: `2790683160709957`
31	`unit`	string	`unit`	计量单位	枚举值: `瓶`, `桶`, `包`, `个`, `盒`, `份`, `根`, `杯`
32	`update_time`	string	`update_time`	商品档案最近一次修改时间	出现率 83%；枚举值: `2025-10-29 23:51:38`, `2025-08-09 20:23:23`, `2025-11-10 18:27:31`, `2025-07-24 16:30:27`, `2025-11-10 18:27:45`, `2025-11-10 18:27:54`, `2025-07-23 15:38:28`, `2025-11-10 18:28:01`

ODS 表结构 — ods.tenant_goods_master 🔗 API

共 37 列（其中 5 个白名单列已折叠）

#	ODS 列名	类型	← JSON 源	→ DWD 目标	业务描述
1	`id`	bigint	`id`	`dim_tenant_goods.tenant_goods_id`, `dim_tenant_goods_ex.tenant_goods_id`	商品档案主键 ID，唯一标识一条商品
2	`tenant_id`	bigint	`tenant_id`	`dim_tenant_goods.tenant_id`	租户/品牌 ID
3	`goods_name`	text	`goods_name`	`dim_tenant_goods.goods_name`	商品名称（前台展示名称）
4	`goods_bar_code`	text	`goods_bar_code`	`dim_tenant_goods_ex.goods_bar_code`	商品条码（EAN 等），目前未维护
5	`goods_category_id`	bigint	`goods_category_id`	`dim_tenant_goods.goods_category_id`	商品一级分类 ID
6	`goods_second_category_id`	bigint	`goods_second_category_id`	`dim_tenant_goods.goods_second_category_id`	商品二级分类 ID
7	`categoryname`	text	`categoryName`	`dim_tenant_goods.category_name`	（待补充）
8	`unit`	text	`unit`	`dim_tenant_goods.unit`	计量单位
9	`goods_number`	text	`goods_number`	`dim_tenant_goods.goods_number`	商品内部编码（自定义货号/系统货号）
10	`out_goods_id`	text	`out_goods_id`	`dim_tenant_goods_ex.out_goods_id`	外部系统商品 ID（对接第三方平台使用，如外卖、线上商城等）
11	`goods_state`	integer	`goods_state`	`dim_tenant_goods.goods_state`	商品状态（上架/下架等）
12	`sale_channel`	integer	`sale_channel`	`dim_tenant_goods_ex.sale_channel`	销售渠道类型，如“门店堂食/线下零售/线上小程序”等的一种编码
13	`able_discount`	integer	`able_discount`	`dim_tenant_goods_ex.able_discount`	是否允许参与折扣/打折
14	`able_site_transfer`	integer	`able_site_transfer`	`dim_tenant_goods_ex.able_site_transfer`	布尔/开关字段，用于表示权限、可用性或状态开关
15	`is_delete`	integer	`is_delete`	`dim_tenant_goods.is_delete`	逻辑删除标志
16	`is_warehousing`	integer	`is_warehousing`	`dim_tenant_goods_ex.is_warehousing`	是否启用库存管理
17	`isinsite`	integer	`isInSite`	`dim_tenant_goods_ex.is_in_site`	（待补充）
18	`cost_price`	numeric	`cost_price`	`dim_tenant_goods_ex.cost_price`	成本价格
19	`cost_price_type`	integer	`cost_price_type`	`dim_tenant_goods_ex.cost_price_type`	金额字段，用于计费/结算/分摊等金额计算
20	`market_price`	numeric	`market_price`	`dim_tenant_goods.market_price`	商品标价 / 售价（标准销售单价）
21	`min_discount_price`	numeric	`min_discount_price`	`dim_tenant_goods_ex.min_discount_price`	该商品允许售卖的最低价格（底价）
22	`common_sale_royalty`	numeric	`common_sale_royalty`	`dim_tenant_goods_ex.common_sale_royalty`	普通销售提成比例或提成金额的配置字段
23	`point_sale_royalty`	numeric	`point_sale_royalty`	`dim_tenant_goods_ex.point_sale_royalty`	积分销售提成/积分赠送规则相关配置
24	`pinyin_initial`	text	`pinyin_initial`	`dim_tenant_goods_ex.pinyin_initial`	拼音首字母/助记码
25	`commoditycode`	text	`commodityCode[]`	—	（待补充）
26	`commodity_code`	text	`commodity_code`	`dim_tenant_goods_ex.commodity_code`, `dim_tenant_goods_ex.commodity_code_list`	商品编码（通常为对外商品编码或条码）
27	`goods_cover`	text	`goods_cover`	`dim_tenant_goods_ex.goods_cover`	商品封面图片 URL 地址
28	`supplier_id`	bigint	`supplier_id`	`dim_tenant_goods.supplier_id`	供应商 ID，用于关联到供应商档案
29	`remark_name`	text	`remark_name`	`dim_tenant_goods_ex.remark_name`	商品备注名/别名，通常用来配置简写或特殊显示名称
30	`create_time`	timestamp without time zone	`create_time`	`dim_tenant_goods.create_time`	商品档案创建时间
31	`update_time`	timestamp without time zone	`update_time`	`dim_tenant_goods.update_time`	商品档案最近一次修改时间
32	`not_sale`	integer	`not_sale`	`dim_tenant_goods.not_sale`	（待补充）

ℹ️ 白名单列（已检查，不展开详情）：ETL 元数据列: payload, content_hash, source_file, source_endpoint, fetched_at (5 个)

DWD 表结构 — dwd.dim_tenant_goods 🔗 ODS

共 19 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`tenant_goods_id`	bigint	`id`	直接	租户商品 ID（SKU）
2	`tenant_id`	bigint	`tenant_id`	直接	租户 ID
3	`supplier_id`	bigint	`supplier_id`	直接	供应商 ID（当前数据全为 0）
4	`category_name`	character varying	`categoryname`	直接	分类名称（二级分类）。样本值: "零食", "饮料", "香烟"等
5	`goods_category_id`	bigint	`goods_category_id`	直接	一级分类 ID
6	`goods_second_category_id`	bigint	`goods_second_category_id`	直接	二级分类 ID
7	`goods_name`	character varying	`goods_name`	直接	商品名称。样本值: "海之言", "西梅多多饮品", "美汁源果粒橙", "三诺橙汁"等
8	`goods_number`	character varying	`goods_number`	直接	商品编号（序号）
9	`unit`	character varying	`unit`	直接	商品单位。枚举值: "包", "瓶", "个", "份"等
10	`market_price`	numeric	`market_price`	直接	市场价/吊牌价（元）
11	`goods_state`	integer	`goods_state`	直接	商品状态。枚举值: 1=上架, 2=下架
12	`create_time`	timestamp with time zone	`create_time`	直接	创建时间
13	`update_time`	timestamp with time zone	`update_time`	直接	更新时间
14	`is_delete`	integer	`is_delete`	直接	删除标记。枚举值: 0=未删除
15	`not_sale`	integer	`not_sale`	直接	是否停售
16	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 版本生效时间
17	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 版本失效时间
18	`scd2_is_current`	integer	—	SCD2	当前版本标记
19	`scd2_version`	integer	—	SCD2	版本号

DWD 表结构 — dwd.dim_tenant_goods_ex 🔗 ODS

共 22 列

#	DWD 列名	类型	← ODS 来源	转换	业务描述
1	`tenant_goods_id`	bigint	`id`	直接	字段重命名
2	`remark_name`	character varying	`remark_name`	直接	名称字段，用于展示与辅助识别
3	`pinyin_initial`	character varying	`pinyin_initial`	直接	同名直传
4	`goods_cover`	character varying	`goods_cover`	直接	同名直传
5	`goods_bar_code`	character varying	`goods_bar_code`	直接	维度字段，用于补充维度属性
6	`commodity_code`	character varying	`commodity_code`	直接	同名直传
7	`commodity_code_list`	character varying	`commodity_code`	直接	字段重命名
8	`min_discount_price`	numeric	`min_discount_price`	直接	同名直传
9	`cost_price`	numeric	`cost_price`	直接	同名直传
10	`cost_price_type`	integer	`cost_price_type`	直接	同名直传
11	`able_discount`	integer	`able_discount`	直接	同名直传
12	`sale_channel`	integer	`sale_channel`	直接	同名直传
13	`is_warehousing`	integer	`is_warehousing`	直接	同名直传
14	`is_in_site`	boolean	`isinsite`	→ boolean	字段重命名
15	`able_site_transfer`	integer	`able_site_transfer`	直接	同名直传
16	`common_sale_royalty`	integer	`common_sale_royalty`	直接	同名直传
17	`point_sale_royalty`	integer	`point_sale_royalty`	直接	同名直传
18	`out_goods_id`	bigint	`out_goods_id`	直接	同名直传
19	`scd2_start_time`	timestamp with time zone	—	SCD2	SCD2 元数据
20	`scd2_end_time`	timestamp with time zone	—	SCD2	SCD2 元数据
21	`scd2_is_current`	integer	—	SCD2	SCD2 元数据
22	`scd2_version`	integer	—	SCD2	SCD2 元数据

522 KiB Raw Blame History Unescape Escape

飞球连接器 — 数据流结构分析报告

数据源文件清单

1. 总览

1.1 API↔ODS↔DWD 字段对比差异

1.1.1 assistant_accounts_master 字段差异明细

1.1.2 settlement_records 字段差异明细

1.1.3 table_fee_transactions 字段差异明细

1.1.4 assistant_service_records 字段差异明细

1.1.5 assistant_cancellation_records 字段差异明细

1.1.6 store_goods_sales_records 字段差异明细

1.1.7 payment_transactions 字段差异明细

1.1.8 refund_transactions 字段差异明细

1.1.9 platform_coupon_redemption_records 字段差异明细

1.1.10 member_profiles 字段差异明细

1.1.11 member_stored_value_cards 字段差异明细

1.1.12 member_balance_changes 字段差异明细

1.1.13 recharge_settlements 字段差异明细

1.1.14 group_buy_packages 字段差异明细

1.1.15 group_buy_redemption_records 字段差异明细

1.1.16 goods_stock_summary 字段差异明细

1.1.17 goods_stock_movements 字段差异明细

1.1.18 site_tables_master 字段差异明细

1.1.19 stock_goods_category_tree 字段差异明细

1.1.20 store_goods_master 字段差异明细

1.1.21 table_fee_discount_records 字段差异明细

1.1.22 tenant_goods_master 字段差异明细

2. 全局统计

2.1 JSON→ODS 映射覆盖

2.2 ODS→DWD 映射覆盖

2.3 各表 JSON→ODS 映射覆盖率

3. 逐表详情

3.1 assistant_accounts_master（助教账号档案）

API 源字段 — assistant_accounts_master 🔗 ODS

ODS 表结构 — ods.assistant_accounts_master 🔗 API

DWD 表结构 — dwd.dim_assistant 🔗 ODS

DWD 表结构 — dwd.dim_assistant_ex 🔗 ODS

3.2 settlement_records（结账记录）

API 源字段 — settlement_records 🔗 ODS

ODS 表结构 — ods.settlement_records 🔗 API

DWD 表结构 — dwd.dwd_settlement_head 🔗 ODS

DWD 表结构 — dwd.dwd_settlement_head_ex 🔗 ODS

3.3 table_fee_transactions（台费计费流水）

API 源字段 — table_fee_transactions 🔗 ODS

ODS 表结构 — ods.table_fee_transactions 🔗 API

DWD 表结构 — dwd.dim_site 🔗 ODS

DWD 表结构 — dwd.dim_site_ex 🔗 ODS

DWD 表结构 — dwd.dwd_table_fee_log 🔗 ODS

DWD 表结构 — dwd.dwd_table_fee_log_ex 🔗 ODS

3.4 assistant_service_records（助教服务流水）

API 源字段 — assistant_service_records 🔗 ODS

ODS 表结构 — ods.assistant_service_records 🔗 API

DWD 表结构 — dwd.dwd_assistant_service_log 🔗 ODS

DWD 表结构 — dwd.dwd_assistant_service_log_ex 🔗 ODS

3.5 assistant_cancellation_records（助教废除记录）

API 源字段 — assistant_cancellation_records 🔗 ODS

ODS 表结构 — ods.assistant_cancellation_records 🔗 API

DWD 表结构 — dwd.dwd_assistant_trash_event 🔗 ODS

DWD 表结构 — dwd.dwd_assistant_trash_event_ex 🔗 ODS

3.6 store_goods_sales_records（门店商品销售流水）

API 源字段 — store_goods_sales_records 🔗 ODS

ODS 表结构 — ods.store_goods_sales_records 🔗 API

DWD 表结构 — dwd.dwd_store_goods_sale 🔗 ODS

DWD 表结构 — dwd.dwd_store_goods_sale_ex 🔗 ODS

3.7 payment_transactions（支付流水）

API 源字段 — payment_transactions 🔗 ODS

ODS 表结构 — ods.payment_transactions 🔗 API

DWD 表结构 — dwd.dwd_payment 🔗 ODS

3.8 refund_transactions（退款流水）

API 源字段 — refund_transactions 🔗 ODS

ODS 表结构 — ods.refund_transactions 🔗 API

DWD 表结构 — dwd.dwd_refund 🔗 ODS

DWD 表结构 — dwd.dwd_refund_ex 🔗 ODS

3.9 platform_coupon_redemption_records（平台/团购券核销）

API 源字段 — platform_coupon_redemption_records 🔗 ODS

ODS 表结构 — ods.platform_coupon_redemption_records 🔗 API

DWD 表结构 — dwd.dwd_platform_coupon_redemption 🔗 ODS

DWD 表结构 — dwd.dwd_platform_coupon_redemption_ex 🔗 ODS

3.10 member_profiles（会员档案）

API 源字段 — member_profiles 🔗 ODS

522 KiB

Raw Blame History