# 助教撤销记录 — GetAbolitionAssistant > 模块：`AssistantPerformance` · ODS 表：`assistant_cancellation_records` · 事件表（增量） --- ## 一、接口概述 查询门店下助教服务被撤销（废除）的记录。每条记录对应一次"助教排钟后被取消"的事件，包含台桌、助教、已计费时长、废除金额等信息。本表是助教流水的配套事件表，专门记录废除操作的明细，用于运营审计和对账。 | 属性 | 值 | |------|-----| | 完整路径 | `POST /AssistantPerformance/GetAbolitionAssistant` | | Base URL | `https://pc.ficoo.vip/apiprod/admin/v1/` | | 鉴权 | `Authorization: Bearer ` | | 分页 | `page` + `limit`（最大 100） | | 时间范围 | `startTime` / `endTime`（必填） | --- ## 二、请求 ### 请求体（JSON） ```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 | `""` | 废除原因，自由文本字段。当前数据中全部为空字符串，说明系统允许不填原因。预留用于记录如"顾客临时取消""录入错误""更换助教"等说明 | --- ## 五、响应样例（单条记录） ```json { "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` 为冗余快照。