16 KiB
台桌主数据（GetSiteTables）
自动生成于 2026-02-13 | 数据来源：本地 JSON 样本
基本信息
| 属性 | 值 |
|---|---|
| 接口路径 | Table/GetSiteTables |
| 完整 URL | https://pc.ficoo.vip/apiprod/admin/v1/Table/GetSiteTables |
| 请求方法 | POST |
| Content-Type | application/json |
| 鉴权方式 | Bearer Token（Authorization 头） |
| ODS 对应表 | site_tables_master |
| 分页方式 | page + limit（最大 100） |
| 时间范围 | 不需要 |
请求参数
| 参数名 | 类型 | 示例值 | 说明 |
|---|---|---|---|
showStatus |
int | 0 |
展示状态（0=全部） |
virtualTableType |
int | -1 |
虚拟桌类型（-1=全部） |
page |
int | 1 |
页码（从 1 开始） |
limit |
int | 100 |
每页条数（最大 100） |
响应字段（共 25 个）
| # | 字段名 | 类型 | 示例值 |
|---|---|---|---|
| 1 | id |
int | 2791964216463493 |
| 2 | audit_status |
int | 2 |
| 3 | charge_free |
int | 0 |
| 4 | self_table |
int | 1 |
| 5 | create_time |
string | '2025-07-15 17:52:54' |
| 6 | is_rest_area |
int | 0 |
| 7 | light_status |
int | 2 |
| 8 | show_status |
int | 1 |
| 9 | site_id |
int | 2790685415443269 |
| 10 | site_table_area_id |
int | 2791963794329671 |
| 11 | table_cloth_use_time |
int | 1863727 |
| 12 | table_cloth_use_Cycle |
int | 0 |
| 13 | virtual_table |
int | 0 |
| 14 | table_name |
string | 'A1' |
| 15 | table_price |
float | 0.0 |
| 16 | table_status |
int | 1 |
| 17 | areaName |
string | 'A区' |
| 18 | siteName |
string | '朗朗桌球' |
| 19 | tableStatusName |
string | '空闲中' |
| 20 | appletQrCodeUrl |
string | 'https://pc-we.ficoo.vip/rootwww/prodwx38a48dd2bc3c1642?e... |
| 21 | only_allow_groupon |
int | 2 |
| 22 | delay_lights_time |
int | 0 |
| 23 | order_delay_time |
int | 0 |
| 24 | temporary_light_second |
int | 0 |
| 25 | is_online_reservation |
int | 2 |
新增字段（相对本地 JSON 样本）
以下字段在最新 API 响应中出现，但本地 JSON 样本中不存在：
| 字段名 | 类型 |
|---|---|
order_id |
int |
详细字段分析
以下内容迁移自旧版
site_tables_master-Analysis.md，包含字段的业务含义、枚举值、跨表关联等详细说明。
结论： 台桌列表.json 是典型的 “台桌维表（维度表）”，为后续所有流水（台费、助教、打折等）提供 site_table_id → 台号/区域/配置 的主数据。
二、记录级字段明细（逐字段）
以下字段均针对 siteTables 数组中的单条记录。
- 主键 / 门店 / 区域基础字段
id
类型：int
唯一性：71 条记录各不相同。
含义：台桌主键 ID。
关联：
与 台费流水.json 中的 site_table_id 一致；
与 助教流水.json 中的 site_table_id 一致；
与 台费打折.json 中 tableProfile.id 一致。
作用：这是“台”的全系统唯一标识，是各类流水表引用的核心外键。
site_id
类型：int
当前值：全部为同一个值（例如 2790685415443269）。
含义：门店 ID。
关联：
与各个流水表、siteProfile.id 一致，本数据全部属于“朗朗桌球”这一家门店。
siteName
类型：string
当前值：全部为 "朗朗桌球"。
含义：门店名称快照，冗余字段，配合 site_id 使用。
site_table_area_id
类型：int
唯一性：14 个不同值。
含义：门店维度的“台桌区域 ID”。
关系：
同一个 site_table_area_id 对应一个唯一的 areaName（1:1）。
在其它 JSON（例如台费流水里的 tableProfile.site_table_area_id）中也存在同样的 ID，用于在门店内统一识别区域。
areaName
类型：string
枚举（本门店实际值）：
"A区"（18 台）
"B区"（15 台）
"补时长"（7 台）
"C区"（6 台）
"麻将房"（5 台）
"VIP包厢"（4 台）
"斯诺克区"（4 台）
"K包"（3 台）
"666", "M7", "k包活动区"（各 2 台）
"TV台", "M8", "发财"（各 1 台）
含义：区域名称，用于前台展示和区域维度管理。
结构特征：
site_table_area_id 与 areaName 一一对应；
有些区域名（如“补时长”“666”）本身就带业务含义（补时专用、特殊台）。
- 台桌自身属性字段
table_name
类型：string
唯一性：71 条记录 71 个不同值。
示例："A1" ~ "A18", "B1" ~ "B6", "S1" ~ "S4", "VIP1", "VIP2", "VIP3", "VIP5", "TV台", "M7", "M8", "666", "888", "发财", "常乐", "幸会(纯k)", "董事办", "补时长"、"补时长2"…"补时长7"，"大包", "小包" 等。
含义：台号/台名称，用于前台操作界面展示，也出现在小票和各种流水中的 ledger_name 或 tableName 字段。
table_price
类型：float
当前观测：全部为 0.0。
含义（结构角度）：
设计上应为“台的基础单价”字段（例如按小时或按局单价）；
本门店实际上没有在台列表中配置单价，台费单价来自别处（如计费策略、时段价格表），因此这里统一为 0。
结论：这是一个“预留但未在本门店使用”的价格字段，真实计费规则在其他地方。
virtual_table
类型：int，枚举。
当前值：全部为 0。
含义（推测）：
0：物理台（实体存在的桌）；
1：虚拟台（组合计费或逻辑台，如合台、补钟虚拟台等）。
说明：尽管存在“补时长*”这类功能性台，但字段上仍标记为 0，说明系统是通过“特殊命名 + 台费计费逻辑”来实现补时，而没有使用 virtual_table=1。
self_table
类型：int，枚举。
当前值：全部为 1。
含义（推测）：
1：“本门店自有台”，非共享或外部配置；
0：可能预留用于联营/非自有台等场景，本门店未出现。
结构意义：标记台桌归属类型，未来可用于区分自营台与其他来源台。
is_rest_area
类型：int，枚举。
当前值：全部为 0。
含义（推测）：
0：正常计费区域；
1：休息区，可能不参与计费或有不同计费逻辑。
本门店未使用此区分。
- 状态与展示控制相关字段
table_status
类型：int，枚举。
当前分布：
1：64 条，对应 tableStatusName = "空闲中"
2：2 条，对应 tableStatusName = "使用中"
3：5 条，对应 tableStatusName = "暂停中"
明确映射关系：
1 → 空闲中
2 → 使用中
3 → 暂停中
含义：台当前运行状态，真实反映某一时刻台的占用/暂停情况。
tableStatusName
类型：string，枚举。
当前值：
"空闲中"
"使用中"
"暂停中"
含义：table_status 的中文名称，仅为展示用途。
light_status
类型：int，枚举。
当前分布：
2：70 条
1：1 条
含义（结合命名推断）：
该字段是台灯/灯光状态开关位：
1：开灯/可控；
2：关灯/关闭状态。
当前导出时刻大部分台灯处于关闭状态（2），只有一张台为 1。
该字段与智能硬件（开关台灯）联动使用。
delay_lights_time
类型：int
当前值：全部为 0。
含义（推测）：台灯熄灭延迟时间（单位多半是秒或分钟），用于结账后延时关灯。
本门店未启用延迟关灯功能（全部为 0）。
temporary_light_second
类型：int
当前值：全部为 0。
含义（推测）：临时点灯时长（秒），例如手动临时开灯一段时间。
本门店未使用。
show_status
类型：int，枚举。
当前分布：
1：68 条，台名例如 "A1"..."A18", "B1"...，普通台以及多数补时长台；
2：3 条，台名为 "大包", "大包麻将房", "小包"。
含义（推测）：
1：正常在前台“开台列表”中展示；
2：不在常规开台列表展示，仅用于特殊用途（比如线上预约专用、单独套餐房间等）。
与 is_online_reservation 有明显配合（见下）。
audit_status
类型：int，枚举。
当前值：全部为 2。
含义（结合命名惯例）：
2：已审核/已启用；
其他值（未出现）可能用于“待审核/驳回”等状态。
当前门店所有台桌配置均处于已审核状态。
charge_free
类型：int，枚举。
当前值：全部为 0。
含义（推测）：
0：正常计费；
1：免单/常免台（不计费或特殊场景）。
本门店没有配置免单台。
show_status 已说明，不再赘述。
order_delay_time
类型：int
当前值：全部为 0。
含义（推测）：订单层面允许的“自动延时时长”（例如到点后自动延长多少时间继续计费）。
本门店未使用此功能。
- 线上预约 / 团购限制字段
is_online_reservation
类型：int，枚举。
当前分布：
2：69 条
1：2 条（台名为 "大包", "小包"）
含义（结合值分布推断）：
1：允许线上预约（可在小程序/线上平台预约这张台）；
2：不允许线上预约。
结构特征：
只有“大包”“小包”被标记为可线上预约，且它们的 show_status = 2，说明这两张台可能主要通过线上预约，而非普通前台开台列表。
only_allow_groupon
类型：int，枚举。
当前值：全部为 2。
含义（结合命名推断）：
1：仅允许团购/券预约使用（团购专用台）；
2：不限制，只要满足其他条件即可使用。
当前门店没有设置“仅限团购使用”的台桌，所有台都标记为 2。
appletQrCodeUrl
类型：string
特征：
每张台一个独立的 URL，结构类似： https://pc-we.ficoo.vip/rootwww/prodwx38a48dd2bc3c1642?env=prod&type=1&id=<table_id>&siteId=<site_id>
id 参数就是当前台的 id，siteId 为门店 ID。
含义：小程序二维码 URL。 一般用于：
打印二维码贴在台上，顾客扫码可呼叫服务、查看账单或发起线上预约；
员工也可通过小程序快捷开台。
- 台呢使用相关字段
table_cloth_use_time
类型：int
当前分布：
共有 69 个不同值；
范围：0 ~ 2137840。
含义（结合命名和数值特征）：
台呢使用累计时长，单位极大概率为“秒”：
例如 1863727 秒 ≈ 517 小时，符合“台呢累计使用时长”的量级。
用于提醒更换/保养台呢。
结构上：这是一个不断累加的计数器，每次开台会增长对应秒数。
table_cloth_use_Cycle
类型：int
当前值：全部为 0。
含义（推测）：
台呢使用周期阈值，例如达到某个秒数后提醒更换；
0 表示未配置该阈值。
本门店尚未设置自动提醒周期，只记录使用时长。
- 其他通用字段
create_time
类型：string，格式 YYYY-MM-DD HH:MM:SS
当前数据：
71 条记录，有 44 个不同的时间点；
多数台在 2025-07-16 这一时段集中创建，少数在 2025-07-15/2025-10-31。
含义：台桌配置的创建时间或最近一次创建/复制时间。
三、与其它 JSON 的字段级关联关系（结构视角）
仅从字段结构和命名角度说明，不做数值层面的比对。
- 与《台费流水.json》（台费使用记录）
关键关联字段：
台桌列表.id ↔ 台费流水中的 site_table_id
台桌列表.table_name ↔ 台费流水中的 ledger_name（或 tableName）
台桌列表.site_table_area_id ↔ 台费流水里的 tableProfile.site_table_area_id
台桌列表.areaName ↔ 台费流水里的 tableProfile.site_table_area_name
site_id、tenant_id 在两表保持一致。
结构关系：
台桌列表 提供静态的“台属性/区域属性/可用性配置”；
台费流水 提供动态的“台使用时段 + 台费金额拆分”；
两者通过 site_table_id 构成事实表–维度表关系。
- 与《台费打折.json》（台费调账/打折记录）
关键关联字段：
台桌列表.id ↔ 台费打折中的 site_table_id（或 tableProfile.id）
table_name ↔ tableProfile.table_name
site_table_area_id / areaName ↔ tableProfile.site_table_area_id / site_table_area_name
结构关系：
台费打折记录中的 tableProfile 实际上就是对“台桌列表”中某一行台的快照；
所有与台相关的打折，都可以回溯到 id 对应的台配置记录。
- 与《助教流水.json》
关键关联字段：
台桌列表.id ↔ 助教流水中的 site_table_id
table_name ↔ 助教流水中的 tableName
site_id、tenant_id 保持一致。
结构关系：
助教服务是附着在具体台或包厢上的；
助教流水 中记录“某助教在某张台上服务的时段和金额”，通过 site_table_id 与台桌配置联动；
可以从结构上做到“按台/按区域统计助教服务情况”。
- 与其它门店维度类 JSON（如门店信息等）
site_id、siteName 与各个 JSON 中的 siteProfile.id、shop_name一致；
台桌列表 是门店维度下的子实体表，与“门店档案”存在 1:N 关系（一个门店多张台）。
四、从结构关系角度额外能看出的重要线索
台桌列表在整个模型中是核心“维度表”
所有与“台”相关的流水（台费、助教、台费打折等）都通过 site_table_id 引用这里；
字段设计同时覆盖了：基础属性（name/area）、运营状态（table_status）、显示控制（show_status）、线上能力（is_online_reservation、only_allow_groupon）、硬件联动（light_status 与灯控系统）、耗材寿命管理（table_cloth_use_time）。
补时长相关的台是通过“命名 + 区域 + 计费规则”实现的，不是通过 virtual_table 字段
有一组台名字直接叫“补时长*（补时长、补时长2...补时长7）”，区域名也叫“补时长”；
但 virtual_table=0、charge_free=0、self_table=1，说明系统把它们当成普通台，只是在业务逻辑层面赋予“补时台”含义（结构上可注意这一点，用于后续建模时区分）。
线上预约房间与普通台桌在结构上的差异由 show_status + is_online_reservation 组合表达
普通台：show_status=1、is_online_reservation=2；
大/小包：show_status=2、is_online_reservation=1；
结构上的含义是：
普通台：主要由现场前台打开使用，不对外提供线上预约；
大/小包：主要通过线上预约入口使用，不在常规“开台列表”出现。
这在后续做结构分析或建模时，可以用两个字段组合出“台的业务角色”。
所有台处于 audit_status=2，说明当前配置已经“生效”
若未来有台处于 audit_status≠2 的情况，这将意味着该台尚未投入使用；
台费流水中不会引用未审核的台，这点从结构上可以推断出系统的约束逻辑。
台呢使用字段为“维护维度”提供结构钩子
table_cloth_use_time（累计秒数）+ table_cloth_use_Cycle（阈值）构成一个完整的“耗材寿命管理”结构；
本门店仅记录累积使用时长，还未设置“提醒更换周期”，但结构已经预留完备。
价格字段在台列表中未启用，说明计费策略是“另起表管理”
table_price=0 且台费实际单价在 台费流水.json 的 ledger_unit_price 中体现；
这说明系统采用： “台的物理属性 + 区域属性”在本表； “实时价格/活动价/时段价”在独立计费策略表； 台费流水则记录计费策略的执行结果（ledger_unit_price、ledger_amount）。
这一点在结构设计上非常明确，对后续做模型时需要把“台列表”和“计价策略”分开看。
综上，20251110_043250_台桌列表.json 从结构上完整刻画了门店所有台桌的静态属性和部分实时状态，并通过 id 字段在全系统范围内作为“台”的唯一主键，被台费、助教、打折等多类流水反复引用。它是整个非球科技门店模型中的核心基础维表之一。