# table_fee_discount_records 台费折扣/调整记录

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | table_fee_discount_records |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/table_fee_discount_records.json |
| 说明 | 台费折扣记录 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 台费打折 / 调整流水主键 ID |
| 2 | tenant_id | BIGINT | YES | 租户/品牌 ID |
| 3 | site_id | BIGINT | YES | 门店 ID，本批数据全部为同一家门店（朗朗桌球） |
| 4 | siteprofile | JSONB | YES | （待补充） |
| 5 | site_table_id | BIGINT | YES | 台桌 ID |
| 6 | tableprofile | JSONB | YES | （待补充） |
| 7 | tenant_table_area_id | BIGINT | YES | 租户维度的“台桌区域 ID” |
| 8 | adjust_type | INTEGER | YES | 文件名是“台费打折”，字段名为“调整类型”，当前所有记录都是 1，即“台费打折/台费减免”这一种调整类型 |
| 9 | ledger_amount | NUMERIC(18,2) | YES | 金额字段，用于计费/结算/分摊等金额计算 |
| 10 | ledger_count | NUMERIC(18,4) | YES | 这里不是“秒数”，而是“调整次数/条数”的量化，目前固定为 1，表示“一次调账事件” |
| 11 | ledger_name | TEXT | YES | 设计上应该用于记录“调账项目名称”或“打折原因描述”（例如某种优惠规则名称），但当前门店并未使用该字段 |
| 12 | ledger_status | INTEGER | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 13 | applicant_id | BIGINT | YES | 打折/调账申请人 ID |
| 14 | applicant_name | TEXT | YES | 申请人姓名（带角色描述），为 applicant_id 的冗余显示字段 |
| 15 | operator_id | BIGINT | YES | 实际执行调账操作的操作员 ID |
| 16 | operator_name | TEXT | YES | 操作员姓名 |
| 17 | order_settle_id | BIGINT | YES | 结算单/小票 ID |
| 18 | order_trade_no | TEXT | YES | 订单交易号 |
| 19 | is_delete | INTEGER | YES | 逻辑删除标记（0=否，1=是） |
| 20 | create_time | TIMESTAMP | YES | 台费调整记录的创建时间，即打折操作被执行的时间戳 |
| 21 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 22 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 23 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 24 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 25 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 26 | area_type_id | BIGINT | YES | 区域类型ID |
| 27 | charge_free | BOOLEAN | YES | 是否免费 |
| 28 | site_table_area_id | BIGINT | YES | 门店台区ID |
| 29 | site_table_area_name | TEXT | YES | 门店台区名称 |
| 30 | sitename | TEXT | YES | 门店名称 |
| 31 | table_name | TEXT | YES | 台桌名称 |
| 32 | table_price | NUMERIC(18,2) | YES | 台桌价格 |
| 33 | tenant_name | TEXT | YES | 租户名称 |

## 使用说明

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

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.table_fee_discount_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/table_fee_discount_records.json |
