18 KiB
助教账号主数据（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 等字段关联）。
二、记录级字段详解（按逻辑分组）
- 主键 / 账号身份类字段
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…）。
含义（推测）：系统内部生成的序列号或排序标识，用于全局排序或迁移。
- 个人基础信息字段
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 表示未填写。
- 组织、团队与门店维度字段
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 系统或内部员工档案集成使用，当前未启用。
- 等级、计费与薪资配置字段
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：一种固定含义（例如“参与薪资发放方案”或相反），具体码值需看系统配置。
仅从这份数据无法区分是否“启用/禁用”，只能确认这是一个薪酬相关开关字段。
- 入职 / 离职 / 考勤签署相关字段
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：离岗/停止安排（与离职状态挂钩）。
- 账号启用、展示与在线状态字段
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：已逻辑删除（数据保留，前台不可见）。
- 评价与投诉相关字段
criticism_status
类型：int，枚举。
观测：
1 × 49
2 × 1
含义（推测）：投诉/差评状态：
1：无投诉或正常
2：有投诉记录。
assistant_grade / sum_grade / get_grade_times
已在上文等级部分说明：
当前全部为 0，表示该门店尚未产生助教评价数据，但字段结构已经做好。
- 时间元数据与最近服务记录
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 的订单号。
含义（推测）：该助教最近一次关联的订单号，用于快速跳转或回溯最近服务行为。
- 灯控、钉钉等系统集成相关字段
ding_talk_synced
类型：int，枚举。
观测：全为 1。
含义（从字段名推测）：是否已同步至钉钉：
1：已同步
其他值：未同步/错误等。
site_light_cfg_id
类型：int
观测：全为 0。
含义：门店灯控配置 ID，本门店未在助教账号维度启用。
light_equipment_id
类型：string
观测：全为 ''。
含义：灯控设备 ID，如果开启“助教开台自动控制灯”，会通过该字段关联到灯控硬件。
light_status
类型：int，枚举。
观测：全为 2。
含义（推测）：灯光控制状态，如 1=启用控制、2=不启用 或相反。
由于所有记录是同一个值，只能确认这是一个预留状态字段。
- 其他标志字段
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 为与灯控设备联动预留的字段，目前在该门店未实际启用。