root/ZQYY.FQ-ETL

Fork 0

Files

Neo 3c51f5485d 初始提交：飞球 ETL 系统全量代码

2026-02-13 08:05:34 +08:00

7.1 KiB

Raw Blame History

助教撤销记录 — GetAbolitionAssistant

模块：AssistantPerformance · ODS 表：assistant_cancellation_records · 事件表（增量）

一、接口概述

查询门店下助教服务被撤销（废除）的记录。每条记录对应一次"助教排钟后被取消"的事件，包含台桌、助教、已计费时长、废除金额等信息。本表是助教流水的配套事件表，专门记录废除操作的明细，用于运营审计和对账。

属性	值
完整路径	`POST /AssistantPerformance/GetAbolitionAssistant`
Base URL	`https://pc.ficoo.vip/apiprod/admin/v1/`
鉴权	`Authorization: Bearer <token>`
分页	`page` + `limit`（最大 100）
时间范围	`startTime` / `endTime`（必填）

二、请求

请求体（JSON）

{
  "startTime": "2025-11-01 08:00:00",
  "endTime": "2025-11-10 08:00:00",
  "siteId": 2790685415443269,
  "page": 1,
  "limit": 100
}

参数说明

参数	类型	必填	说明
`startTime`	string	是	查询起始时间，格式 `YYYY-MM-DD HH:MM:SS`
`endTime`	string	是	查询结束时间，格式 `YYYY-MM-DD HH:MM:SS`
`siteId`	int	是	门店 ID
`page`	int	是	页码，从 1 开始
`limit`	int	是	每页条数，最大 100

三、响应结构

{
  "code": 200,
  "data": {
    "list": [ { ... }, { ... } ],
    "total": 15
  }
}

data.list 中每个对象即为一条助教撤销记录，共 13 个字段，按逻辑分组说明如下。

四、响应字段详解（13 个字段）

4.1 主键与门店

字段	类型	示例	说明
`id`	int	`2957675849518789`	撤销记录主键 ID，唯一标识一条废除事件
`siteId`	int	`2790685415443269`	门店 ID，与 `siteProfile.id` 一致
`siteProfile`	object	`{...}`	门店信息快照（冗余），包含门店名称、地址、经纬度等 26 个子字段。结构与其他接口的 `siteProfile` 完全一致，此处为空壳式冗余，不再逐字段展开

4.2 台桌维度

字段	类型	示例	说明
`tableId`	int	`2793016660660357`	台桌 ID，对应台桌配置表的主键。标识废除发生在哪张台
`tableName`	string	`"C1"`	台桌名称/编号，冗余展示字段。常见值如 `"C1"`、`"B9"`、`"VIP1"`、`"A4"`、`"666"`、`"董事办"` 等
`tableAreaId`	int	`2791963816579205`	台桌所在区域 ID，对应区域配置表主键
`tableArea`	string	`"C区"`	台桌所属区域名称。已知值：`"A区"`、`"B区"`、`"C区"`、`"VIP包厢"`、`"K包"`、`"补时长"`、`"666"`

4.3 助教维度

字段	类型	示例	说明
`assistantOn`	string	`"27"`	助教编号（工号），虽为字符串类型但内容为纯数字。对应助教账号表的 `assistant_no`、助教流水的 `assistantNo`
`assistantName`	string	`"泡芙"`	助教姓名/昵称，冗余展示字段。对应助教账号表的 `nickname` / `real_name`

4.4 时间与时长

字段	类型	示例	说明
`createTime`	string	`"2025-11-09 19:23:29"`	废除记录创建时间，即系统记录废除操作的时刻。格式 `YYYY-MM-DD HH:MM:SS`
`pdChargeMinutes`	int	`214`	废除前已累计的计费时长，单位为分钟。`0` 表示刚排钟即撤销，尚未产生有效计费时间。注意：助教流水中类似字段（`real_use_seconds`）单位为秒

4.5 金额与原因

字段	类型	示例	说明
`assistantAbolishAmount`	float	`5.83`	助教废除金额（元/人民币），本次废除操作对应的金额数值。`0.0` 表示纯记录操作，未产生金额变动
`trashReason`	string	`""`	废除原因，自由文本字段。当前数据中全部为空字符串，说明系统允许不填原因。预留用于记录如"顾客临时取消""录入错误""更换助教"等说明

五、响应样例（单条记录）

{
  "siteProfile": {
    "id": 2790685415443269,
    "org_id": 2790684179467077,
    "shop_name": "朗朗桌球",
    "avatar": "https://oss.ficoo.vip/admin/hXcE4E_1752495052016.jpg",
    "business_tel": "13316068642",
    "full_address": "广东省广州市天河区丽阳街12号",
    "address": "广东省广州市天河区天园街道朗朗桌球",
    "longitude": 113.360321,
    "latitude": 23.133629,
    "tenant_site_region_id": 156440100,
    "tenant_id": 2790683160709957,
    "auto_light": 1,
    "attendance_distance": 0,
    "wifi_name": "",
    "wifi_password": "",
    "customer_service_qrcode": "",
    "customer_service_wechat": "",
    "fixed_pay_qrCode": "",
    "prod_env": 1,
    "light_status": 1,
    "light_type": 0,
    "site_type": 1,
    "light_token": "",
    "site_label": "A",
    "attendance_enabled": 1,
    "shop_status": 1
  },
  "createTime": "2025-11-09 19:23:29",
  "id": 2957675849518789,
  "siteId": 2790685415443269,
  "tableAreaId": 2791963816579205,
  "tableId": 2793016660660357,
  "tableArea": "C区",
  "tableName": "C1",
  "assistantOn": "27",
  "assistantName": "泡芙",
  "pdChargeMinutes": 214,
  "assistantAbolishAmount": 5.83,
  "trashReason": ""
}

六、跨表关联

与助教流水（`assistant_service_records`）

本表字段	关联表字段	说明
`assistantOn`	`assistantNo`	助教编号
`assistantName`	`assistantName`	助教姓名
`siteId`	`site_id`	门店 ID
`tableId`	`site_table_id`	台桌 ID

本表没有 order_trade_no 等硬外键字段，无法直接关联到具体哪条助教流水。需通过"门店 + 助教 + 台桌 + 相近时间"的组合条件做软匹配。助教流水中的 is_trash 字段从主流水视角标记"已废除"状态，本表则以"废除事件"为主视角记录明细。

与助教账号（`assistant_accounts_master`）

本表字段	关联表字段	说明
`assistantOn`	`assistant_no`	助教工号
`assistantName`	`nickname` / `real_name`	助教姓名

与台桌配置

本表字段	关联表字段	说明
`tableId`	台桌列表 `id`	台桌主键
`tableName`	台桌列表 `table_name`	台桌名称
`tableAreaId`	区域配置表主键	台桌区域 ID
`tableArea`	区域配置表 `area_name`	区域名称

与门店维度

siteId 与所有业务表的 site_id 一致，共享门店维度。siteProfile 为冗余快照。

7.1 KiB Raw Blame History Unescape Escape