# site_tables_master 门店台桌主表

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | site_tables_master |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/site_tables_master.json |
| 说明 | 门店桌台主数据 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 台桌主键 ID |
| 2 | site_id | BIGINT | YES | 门店 ID |
| 3 | sitename | TEXT | YES | （待补充） |
| 4 | appletQrCodeUrl | TEXT | YES | （待补充） |
| 5 | areaname | TEXT | YES | （待补充） |
| 6 | audit_status | INTEGER | YES | 当前值：全部为 2 |
| 7 | charge_free | INTEGER | YES | 当前值：全部为 0 |
| 8 | create_time | TIMESTAMP | YES | 台桌配置的创建时间或最近一次创建/复制时间 |
| 9 | delay_lights_time | INTEGER | YES | 台灯熄灭延迟时间（单位多半是秒或分钟），用于结账后延时关灯 |
| 10 | is_online_reservation | INTEGER | YES | 布尔/开关字段，用于表示权限、可用性或状态开关 |
| 11 | is_rest_area | INTEGER | YES | 当前值：全部为 0 |
| 12 | light_status | INTEGER | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 13 | only_allow_groupon | INTEGER | YES | 小程序二维码 URL |
| 14 | order_delay_time | INTEGER | YES | 订单层面允许的“自动延时时长”（例如到点后自动延长多少时间继续计费） |
| 15 | self_table | INTEGER | YES | 当前值：全部为 1 |
| 16 | show_status | INTEGER | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 17 | site_table_area_id | BIGINT | YES | 门店维度的“台桌区域 ID” |
| 18 | tablestatusname | TEXT | YES | （待补充） |
| 19 | table_cloth_use_cycle | INTEGER | YES | （待补充） |
| 20 | table_cloth_use_time | TIMESTAMP | YES | 时间字段，用于记录业务时间点/发生时间 |
| 21 | table_name | TEXT | YES | 台号/台名称，用于前台操作界面展示，也出现在小票和各种流水中的 ledger_name 或 tableName 字段 |
| 22 | table_price | NUMERIC(18,2) | YES | 设计上应为“台的基础单价”字段（例如按小时或按局单价） |
| 23 | table_status | INTEGER | YES | 台当前运行状态，真实反映某一时刻台的占用/暂停情况 |
| 24 | temporary_light_second | INTEGER | YES | 临时点灯时长（秒），例如手动临时开灯一段时间 |
| 25 | virtual_table | INTEGER | YES | 当前值：全部为 0 |
| 26 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 27 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 28 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 29 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 30 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 31 | order_id | BIGINT | YES | 订单ID |

## 使用说明

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

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