# group_buy_redemption_records 团购核销记录

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | group_buy_redemption_records |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/group_buy_redemption_records.json |
| 说明 | 团购核销记录 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 本条“团购套餐流水”记录的 主键 ID |
| 2 | tenant_id | BIGINT | YES | 租户/品牌 ID |
| 3 | site_id | BIGINT | YES | 门店 ID，与其它 JSON 中一致 |
| 4 | sitename | TEXT | YES | （待补充） |
| 5 | table_id | BIGINT | YES | 球台 ID |
| 6 | tablename | TEXT | YES | （待补充） |
| 7 | tableareaname | TEXT | YES | （待补充） |
| 8 | tenant_table_area_id | BIGINT | YES | 租户级台区分组 ID，表示当前使用券的台桌所属的区域组合 |
| 9 | order_trade_no | TEXT | YES | 订单交易号，和其它消费明细（台费、商品、助教、团购）共用的订单主键 |
| 10 | order_settle_id | BIGINT | YES | 结算单 ID（小票结账主键） |
| 11 | order_pay_id | BIGINT | YES | 指向支付记录表中的支付流水 ID |
| 12 | order_coupon_id | BIGINT | YES | 订单中“券使用记录”的 ID |
| 13 | order_coupon_channel | INTEGER | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 14 | coupon_code | TEXT | YES | 团购券券码，核销时扫描/录入的字符串 |
| 15 | coupon_money | NUMERIC(18,2) | YES | 本次核销时，这张券在门店侧对应的金额额度（“可抵扣金额”） |
| 16 | coupon_origin_id | BIGINT | YES | 平台/上游系统中的券记录主键 ID，“券来源 ID” |
| 17 | ledger_name | TEXT | YES | 台费侧关联的“团购项目名称”（记账名） |
| 18 | ledger_group_name | TEXT | YES | 团购项目所属的“记账分组名称”（例如“团购台费”“团购包厢”等） |
| 19 | ledger_amount | NUMERIC(18,2) | YES | 本次券实际冲抵台费的金额 |
| 20 | ledger_count | NUMERIC(18,4) | YES | 按此次优惠实际计算的“核销秒数” |
| 21 | ledger_unit_price | NUMERIC(18,4) | YES | 对应台费的标准单价，单位元/小时（从数值来看是类似29.9/小时这种定价） |
| 22 | ledger_status | INTEGER | YES | 流水状态 |
| 23 | table_charge_seconds | INTEGER | YES | 本次结算中该球台总计计费的秒数（整台的台费计费时间） |
| 24 | promotion_activity_id | BIGINT | YES | 团购/促销活动 ID |
| 25 | promotion_coupon_id | BIGINT | YES | 团购套餐定义 ID |
| 26 | promotion_seconds | INTEGER | YES | 团购套餐定义的“标准时长”（券本身标称的可用时长） |
| 27 | offer_type | INTEGER | YES | 优惠类型 |
| 28 | assistant_promotion_money | NUMERIC(18,2) | YES | 分摊到“助教服务”的促销金额 |
| 29 | assistant_service_promotion_money | NUMERIC(18,2) | YES | 进一步细分助教服务的促销金额 |
| 30 | table_service_promotion_money | NUMERIC(18,2) | YES | 本次券使用中，分摊到“台费服务费”部分的促销金额 |
| 31 | goods_promotion_money | NUMERIC(18,2) | YES | 本次券使用中，分摊到“商品”部分的促销金额 |
| 32 | recharge_promotion_money | NUMERIC(18,2) | YES | 来自“充值类优惠”的分摊金额（例如储值赠送部分） |
| 33 | reward_promotion_money | NUMERIC(18,2) | YES | 本次促销中，属于“奖励金/积分抵扣”的金额 |
| 34 | goodsoptionprice | NUMERIC(18,2) | YES | （待补充） |
| 35 | salesman_name | TEXT | YES | 营业员姓名 |
| 36 | sales_man_org_id | BIGINT | YES | 营业员所属组织 ID |
| 37 | salesman_role_id | BIGINT | YES | 营业员角色 ID |
| 38 | salesman_user_id | BIGINT | YES | 营业员/业务员用户 ID |
| 39 | operator_id | BIGINT | YES | 执行本次核销/结算操作的 操作员 ID |
| 40 | operator_name | TEXT | YES | 操作员名称（包含角色说明），与 operator_id 对应的冗余展示字段 |
| 41 | is_single_order | INTEGER | YES | 是否单独作为一条订单行 |
| 42 | is_delete | INTEGER | YES | 逻辑删除标记（0=否，1=是） |
| 43 | create_time | TIMESTAMP | YES | 本条团购套餐使用流水创建时间（即券核销时间，或与结账时间接近） |
| 44 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 45 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 46 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 47 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 48 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 49 | assistant_service_share_money | NUMERIC(18,2) | YES | 助教服务分摊金额 |
| 50 | assistant_share_money | NUMERIC(18,2) | YES | 助教分摊金额 |
| 51 | coupon_sale_id | BIGINT | YES | 优惠券销售ID |
| 52 | good_service_share_money | NUMERIC(18,2) | YES | 商品服务分摊金额 |
| 53 | goods_share_money | NUMERIC(18,2) | YES | 商品分摊金额 |
| 54 | member_discount_money | NUMERIC(18,2) | YES | 会员折扣金额 |
| 55 | recharge_share_money | NUMERIC(18,2) | YES | 充值分摊金额 |
| 56 | table_service_share_money | NUMERIC(18,2) | YES | 台费服务分摊金额 |
| 57 | table_share_money | NUMERIC(18,2) | YES | 台费分摊金额 |

## 使用说明

```sql
-- 查询最新入库的记录
SELECT * FROM ods.group_buy_redemption_records
ORDER BY fetched_at DESC
LIMIT 10;
```

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.group_buy_redemption_records
WHERE id = <value>
ORDER BY fetched_at DESC;
```

## ETL 元数据字段

| 字段名 | 类型 | 说明 |
|--------|------|------|
| content_hash | TEXT | 对业务字段计算 SHA256，用于变更检测与去重 |
| source_file | TEXT | 原始导出文件名，用于数据追溯 |
| source_endpoint | TEXT | 采集来源（接口/文件路径），用于数据追溯 |
| fetched_at | TIMESTAMPTZ | 采集/入库时间戳，用于口径对齐与增量处理 |
| payload | JSONB | 完整原始 JSON 记录快照，用于回溯与二次解析 |

## 可回溯性

| 项目 | 说明 |
|------|------|
| 可回溯 | ✅ 完全可回溯（保留 payload 原始 JSON） |
| 数据来源 | export/test-json-doc/group_buy_redemption_records.json |
