# 助教账号主数据（SearchAssistantInfo）

> 自动生成于 2026-02-13 | 数据来源：本地 JSON 样本

## 基本信息

| 属性 | 值 |
|------|-----|
| 接口路径 | `PersonnelManagement/SearchAssistantInfo` |
| 完整 URL | `https://pc.ficoo.vip/apiprod/admin/v1/PersonnelManagement/SearchAssistantInfo` |
| 请求方法 | `POST` |
| Content-Type | `application/json` |
| 鉴权方式 | Bearer Token（`Authorization` 头） |
| ODS 对应表 | `assistant_accounts_master` |
| 分页方式 | `page` + `limit`（最大 100） |
| 时间范围 | 不需要 |

## 请求参数

| 参数名 | 类型 | 示例值 | 说明 |
|--------|------|--------|------|
| `workStatusEnum` | int | `0` | 工作状态（0=全部） |
| `dingTalkSynced` | int | `0` | 钉钉同步状态（0=全部） |
| `leaveId` | int | `0` | 离职状态（0=全部） |
| `criticismStatus` | int | `0` | 投诉状态（0=全部） |
| `signStatus` | int | `-1` | 签署状态（-1=全部） |
| `page` | int | `1` | 页码（从 1 开始） |
| `limit` | int | `100` | 每页条数（最大 100） |

## 响应字段（共 61 个）

| # | 字段名 | 类型 | 示例值 |
|---|--------|------|--------|
| 1 | `job_num` | string | '' |
| 2 | `shop_name` | string | '朗朗桌球' |
| 3 | `group_id` | int | 0 |
| 4 | `group_name` | string | '' |
| 5 | `staff_profile_id` | int | 0 |
| 6 | `ding_talk_synced` | int | 1 |
| 7 | `entry_type` | int | 1 |
| 8 | `team_name` | string | '1组' |
| 9 | `entry_sign_status` | int | 0 |
| 10 | `resign_sign_status` | int | 0 |
| 11 | `system_role_id` | int | 10 |
| 12 | `criticism_status` | int | 1 |
| 13 | `salary_grant_enabled` | int | 2 |
| 14 | `leave_status` | int | 1 |
| 15 | `id` | int | 2947562271297029 |
| 16 | `allow_cx` | int | 1 |
| 17 | `assistant_no` | string | '31' |
| 18 | `assistant_status` | int | 1 |
| 19 | `avatar` | string | 'https://oss.ficoo.vip/maUiImages/images/defaultAvatar.png' |
| 20 | `birth_date` | string | '0001-01-01 00:00:00' |
| 21 | `charge_way` | int | 2 |
| 22 | `create_time` | string | '2025-11-02 15:55:26' |
| 23 | `cx_unit_price` | float | 0.0 |
| 24 | `end_time` | string | '2025-12-01 08:00:00' |
| 25 | `entry_time` | string | '2025-11-02 08:00:00' |
| 26 | `gender` | int | 0 |
| 27 | `height` | float | 0.0 |
| 28 | `introduce` | string | '' |
| 29 | `is_delete` | int | 0 |
| 30 | `is_guaranteed` | int | 1 |
| 31 | `is_team_leader` | int | 0 |
| 32 | `last_table_id` | int | 0 |
| 33 | `last_table_name` | string | '' |
| 34 | `level` | int | 20 |
| 35 | `light_equipment_id` | string | '' |
| 36 | `light_status` | int | 2 |
| 37 | `mobile` | string | '15119679931' |
| 38 | `nickname` | string | '小然' |
| 39 | `online_status` | int | 1 |
| 40 | `order_trade_no` | int | 0 |
| 41 | `pd_unit_price` | float | 0.0 |
| 42 | `person_org_id` | int | 2947562271215109 |
| 43 | `real_name` | string | '张静然' |
| 44 | `resign_time` | string | '2025-11-03 08:00:00' |
| 45 | `serial_number` | int | 0 |
| 46 | `show_sort` | int | 31 |
| 47 | `show_status` | int | 1 |
| 48 | `site_id` | int | 2790685415443269 |
| 49 | `site_light_cfg_id` | int | 0 |
| 50 | `staff_id` | int | 0 |
| 51 | `start_time` | string | '2025-11-01 08:00:00' |
| 52 | `team_id` | int | 2792011585884037 |
| 53 | `tenant_id` | int | 2790683160709957 |
| 54 | `update_time` | string | '2025-11-03 18:32:07' |
| 55 | `user_id` | int | 2947562270838277 |
| 56 | `video_introduction_url` | string | '' |
| 57 | `weight` | float | 0.0 |
| 58 | `work_status` | int | 2 |
| 59 | `assistant_grade` | float | 0.0 |
| 60 | `sum_grade` | float | 0.0 |
| 61 | `get_grade_times` | int | 0 |

## 详细字段分析

> 以下内容迁移自旧版 `assistant_accounts_master-Analysis.md`，包含字段的业务含义、枚举值、跨表关联等详细说明。

一、文件整体定位与结构

业务含义（内容类型）

该文件是 “助教账号/人事档案维表”，记录的是某门店下所有助教（含管理类账号）的账号配置、人事状态、可见性、计费策略等基础信息。

每条记录对应 一名助教账号，是一张典型的“维度表”（在数据模型中，与“助教流水”等事实表通过 id / user_id / team_id / site_id 等字段关联）。

二、记录级字段详解（按逻辑分组）
1. 主键 / 账号身份类字段

id

类型：int

含义：助教账号主键 ID，在“助教流水.json”中对应 site_assistant_id。

作用：所有与助教相关的事实表（助教流水、助教排班等）都会通过这个 ID 关联到该维表。

user_id

类型：int

含义：系统级“用户账号 ID”，通常对应登录账号。

关联：

在“助教流水.json”中有同名字段 user_id，与此完全一致。

用途：用于统一人员在不同角色/模块下的账号，区别于岗位级的 id。

assistant_no

类型：string

观测值：'1' ~ '39' 等编号，重复时对应不同助教（编号不唯一）。

含义（结合字段名推测）：助教工号 / 编号，便于业务侧识别。

关联：在“助教流水.json”中有 assistantNo，与此字段对应。

job_num

类型：string

观测：全为 ''（空字符串）。

含义：备用工号字段，目前未在该门店启用。

serial_number

类型：int

观测：部分为 0，部分是较大的整数（例如 2738, 2698, 2534…）。

含义（推测）：系统内部生成的序列号或排序标识，用于全局排序或迁移。

2. 个人基础信息字段

real_name

类型：string

含义：助教真实姓名，如“何海婷”“梁婷婷”等。

关联：在“助教流水.json”的 assistantName 与此一致。

nickname

类型：string

含义：助教在前台展示的昵称，如“佳怡”“周周”“球球”等。

用途：与真实姓名区分，用于顾客侧展示。如在助教流水中 nickname 就是这个值。

gender

类型：int，枚举。

观测值：

0 × 40

1 × 1

2 × 9

含义（结合常见约定与值分布推测）：

0：未填/保密

1：男

2：女

birth_date

类型：string，时间格式。

观测值：

大部分为 "0001-01-01 00:00:00"（显然是默认无效日期）

少量为真实日期，如 "2007-01-14 00:00:00" 等。

含义：助教出生日期。

mobile

类型：string

观测：11 位手机号，每个账号基本唯一。

含义：助教手机号，用于登录绑定、通知、钉钉同步等。

avatar

类型：string

观测：

大量为默认头像 URL，如 .../defaultAvatar.png

少量为具体头像图片 URL。

含义：助教头像地址。

introduce

类型：string

观测：当前导出中全部为空字符串。

含义：个人简介文案，预留给助教自我介绍使用。

video_introduction_url

类型：string

观测：

49 条为 ''

1 条为视频 URL（oss 存储路径）

含义：助教个人视频介绍地址。

height

类型：float

观测：

多数为 0.0，少量为 163.0, 166.0, 167.0, 165.0, 170.0 等。

含义：身高（单位：厘米）。0 表示未填写。

weight

类型：float

观测：

多数为 0.0

少量为 55.0, 90.0, 100.0 等。

含义：体重（单位：公斤）。0 表示未填写。

3. 组织、团队与门店维度字段

tenant_id

类型：int

观测：所有记录相同。

含义：品牌/租户 ID，对应“非球科技”系统中该商户的唯一标识。

用途：多门店时用来区分不同商户。

site_id

类型：int

观测：所有记录相同。

含义：门店 ID，对应本次数据的这家球房（朗朗桌球）。

关联：与其它 JSON（台费流水、库存、销售等）中的 site_id 一致。

shop_name

类型：string

观测：全部为 "朗朗桌球"。

含义：门店名称，冗余字段，用于展示。

team_id

类型：int

观测：所有记录同一个值（唯一团队）。

含义：助教所属团队 ID。

关联：在“助教流水.json”中 assistant_team_id 与此一致。

team_name

类型：string

观测：全部为 "1组"。

含义：团队名称，展示用，和 team_id 一一对应。

group_id

类型：int

观测：全部为 0。

含义（推测）：上层“分组 ID”预留字段（例如集团/事业部），本门店未使用。

group_name

类型：string

观测：全部为 ''。

含义：group_id 对应的名称，目前为空。

person_org_id

类型：int

观测：每条记录一个不同的 ID。

含义：人事组织 ID，通常表示“某某门店-助教部-某小组”等层级组织。

关联：

在“助教流水.json”中同名字段 person_org_id 与此一致。

用途：用于人力组织维度统计、权限控制。

staff_id

类型：int

观测：全部为 0。

含义（推测）：预留给“人事系统员工 ID”的字段，目前未接入或未启用。

staff_profile_id

类型：int

观测：全部为 0。

含义（推测）：人事档案 ID，与第三方 HR 系统或内部员工档案集成使用，当前未启用。

4. 等级、计费与薪资配置字段

level

类型：int，枚举。

观测值：

10 × 24

20 × 18

30 × 4

40 × 3

8 × 1

含义（结合“助教流水中的 assistant_level / levelName 推测”）：

8：助教管理/管理员（和流水里的 "助教管理" 对应）

10：初级助教

20：中级助教

30：高级助教

40：更高等级（可能是“资深/专家”，该等级在流水里暂未出现）。

关联：在“助教流水.json”里以 assistant_level+levelName 体现。

assistant_grade

类型：float

观测：全部为 0.0。

含义（推测）：助教综合评分（员工维度的平均分 snapshot），当前尚未启用评分。

sum_grade

类型：float

观测：全为 0.0。

含义：评分总和，用于计算平均分（assistant_grade = sum_grade / get_grade_times），当前为 0。

get_grade_times

类型：int

观测：全为 0。

含义：累计被评分次数。

charge_way

类型：int，枚举。

观测：全为 2。

含义（推测）：计费方式：

2 代表当前门店为“计时收费”，其他值（1、3 等）可能对应按局、按课时等，当前未出现。

pd_unit_price

类型：float

观测：全为 0.0。

含义（推测）：某种标准单价（例如“普通时段单价”），这里未在账号上配置（实际单价在助教商品或套餐配置中）。

cx_unit_price

类型：float

观测：全为 0.0。

含义（推测）：促销时段的单价，本门店未在账号表层面设置。

allow_cx

类型：int，枚举。

观测：全为 1。

含义（从字段名推测）：

是否允许此助教参与“促销价（促销=促销/促销场）”：

1：允许参与促销计费。

其他值（未出现）可能为不允许。

is_guaranteed

类型：int，枚举。

观测：全为 1。

含义（从字段名推测）：是否配置“保底薪酬/保底时长”：

1：有保底规则。

其他值可能表示无保底。

salary_grant_enabled

类型：int，枚举。

观测：全为 2。

含义（推测）：薪资发放配置开关：

2：一种固定含义（例如“参与薪资发放方案”或相反），具体码值需看系统配置。

仅从这份数据无法区分是否“启用/禁用”，只能确认这是一个薪酬相关开关字段。

5. 入职 / 离职 / 考勤签署相关字段

entry_time

类型：string

观测：各类日期 "2025-07-16 08:00:00", "2025-09-01 08:00:00" 等。

含义：入职时间。

resign_time

类型：string

观测：

对在职员工：类似 "2225-11-01 17:57:41" 这类非常未来的年份，显然是“占位默认值”。

对已离职员工：正常的近时间，如 "2025-10-13 08:00:00" 等。

含义：离职日期；使用“远未来日期”作为“未离职”的占位。

entry_type

类型：int，枚举。

观测：全为 1。

含义（推测）：入职类型：

1：正式入职。

其他值可能表示实习、兼职等，当前未出现。

entry_sign_status

类型：int，枚举。

观测：全为 0。

含义（推测）：入职协议/合同签署状态：

0：未签署。

其他值可能表示已签署（目前未启用电子签功能）。

resign_sign_status

类型：int，枚举。

观测：全为 0。

含义（推测）：离职协议签署状态，类似上面。

leave_status

类型：int，枚举。

观测：

0 × 21

1 × 29

结合 work_status 和 resign_time 可以明确判断：

0：在职（resign_time 为 2225 年占位）

1：已离职（resign_time 为真实近日期）

work_status

类型：int，枚举。

观测：

当 leave_status = 0 时，work_status = 1

当 leave_status = 1 时，work_status = 2

推断含义：

1：在岗/可排班

2：离岗/停止安排（与离职状态挂钩）。

6. 账号启用、展示与在线状态字段

assistant_status

类型：int，枚举。

观测：

1 × 48

2 × 2

含义（推测）：账号启用状态：

1：启用

2：停用 / 冻结（这两条仍处于 leave_status = 0，说明未离职但账号被禁用）。

show_status

类型：int，枚举。

观测：全为 1。

含义（推测）：前台展示状态：

1：在助教选择界面展示。

其他值可能是不展示。

show_sort

类型：int

观测：多值，如 1, 3, 7, 9, 10, 11, 12, 16, 21, 25, 30, 36, 38, 39, 100 等。

含义：前台展示排序权重，值越小/越大对应不同的排序策略（当前看起来与 assistant_no 有一定对应关系）。

online_status

类型：int，枚举。

观测：全为 1。

含义（推测）：在线状态；当前门店所有助教账号均为在线状态。

is_delete

类型：int，枚举。

观测：全为 0。

含义：逻辑删除标记：

0：未删除

1：已逻辑删除（数据保留，前台不可见）。

7. 评价与投诉相关字段

criticism_status

类型：int，枚举。

观测：

1 × 49

2 × 1

含义（推测）：投诉/差评状态：

1：无投诉或正常

2：有投诉记录。

assistant_grade / sum_grade / get_grade_times

已在上文等级部分说明：

当前全部为 0，表示该门店尚未产生助教评价数据，但字段结构已经做好。

8. 时间元数据与最近服务记录

create_time

类型：string

含义：账号创建时间。

update_time

类型：string

含义：账号最近一次被修改的时间（例如修改等级、昵称等）。

start_time

类型：string

观测：多为整月开始，如 "2025-07-01 08:00:00", "2025-09-01 08:00:00" 等。

含义（推测）：当前配置生效的开始日期。

end_time

类型：string

观测：对应结束日期，如 "2025-08-01 08:00:00", "2025-10-01 08:00:00" 等。

含义：当前配置生效的结束日期（例如一个周期性的排班/合同周期）。

last_table_id

类型：int

观测：

大多为 0

少量为实际台桌 ID。

含义：该助教最近一次服务的球台 ID。

last_table_name

类型：string

观测：大多为 ''，少量为 "TV", "888" 等。

含义：最近服务球台名称（展示用）。

last_update_name

类型：string

观测：如 "助教管理员:黄月柳", "管理员：郑丽珊"。

含义：最近修改该账号配置的管理员名称。

order_trade_no

类型：int

观测：

绝大多数为 0

少量为非 0 的订单号。

含义（推测）：该助教最近一次关联的订单号，用于快速跳转或回溯最近服务行为。

9. 灯控、钉钉等系统集成相关字段

ding_talk_synced

类型：int，枚举。

观测：全为 1。

含义（从字段名推测）：是否已同步至钉钉：

1：已同步

其他值：未同步/错误等。

site_light_cfg_id

类型：int

观测：全为 0。

含义：门店灯控配置 ID，本门店未在助教账号维度启用。

light_equipment_id

类型：string

观测：全为 ''。

含义：灯控设备 ID，如果开启“助教开台自动控制灯”，会通过该字段关联到灯控硬件。

light_status

类型：int，枚举。

观测：全为 2。

含义（推测）：灯光控制状态，如 1=启用控制、2=不启用 或相反。

由于所有记录是同一个值，只能确认这是一个预留状态字段。

10. 其他标志字段

is_team_leader

类型：int，枚举。

观测：全为 0。

含义：是否为团队长/组长：

0：普通助教

1：团队长（当前门店未指定团队长）。

三、与其他 JSON 的字段级关联（从结构角度）

仍然只从“结构 / 关联键”角度说明，不做任何经营或盈利分析：

与《助教流水.json》的关联

助教流水.site_assistant_id ↔ 助教账号.id

助教流水.user_id ↔ 助教账号.user_id

助教流水.assistant_team_id ↔ 助教账号.team_id

助教流水.person_org_id ↔ 助教账号.person_org_id

助教流水.assistant_level ↔ 助教账号.level（以及 levelName）

助教流水.nickname ↔ 助教账号.nickname

说明：助教流水是事实表，这个文件是对应的助教维表。

与门店维度 / 其它业务表

所有表的 tenant_id、site_id 一致，说明这些记录全部属于同一商户、同一门店。

台费流水、销售记录、库存变化等表通过 site_id、shop_name 共享门店维。

与订单相关表（小票、结账）

此文件中的 order_trade_no 仅是“最近订单号”的影子值，真正的订单明细仍以订单表、小票详情中的 order_trade_no 和 orderSettleId 为主。

在“助教流水”中，order_trade_no、order_settle_id 与助教账号并无直接外键关系，而是通过“助教流水”这张桥接事实表关联起来。

与外部系统（钉钉 / 灯控）

ding_talk_synced / staff_profile_id / staff_id 等为与企业内部人事系统、钉钉等集成预留的字段。

site_light_cfg_id / light_equipment_id / light_status 为与灯控设备联动预留的字段，目前在该门店未实际启用。
