职位管理

1. 获取职位列表（getPositionList）

前端： 谭海涛
后端： 柏康 url： /v1/homing/system/web/position/page-list
备注： WEB-职位管理-分页列表【商户】

//! 注意，TS版本4^
import type { GetPositionListReq, GetPositionListRes } from '@homing/web'

homingClient.getPositionList({
  positionName: '经理',
  description: '管理',
  state: 1,
  pageIndex: 1,
  pageRows: 10
}).then((res: any) => {
  console.log('职位列表数据', res.list);
});

参数说明

参数名	类型	必填	说明	备注/枚举值
positionName	string	否	职位名称	支持模糊查询
description	string	否	职位描述	支持模糊查询
state	number	否	状态	0: 禁用, 1: 启用
pageIndex	number	否	当前页码	默认 1
pageRows	number	否	每页条数	默认 10

响应说明

字段名	类型	说明
list	array	职位列表

list 字段说明

字段名	类型	说明
positionCode	string	职位编码
positionName	string	职位名称
description	string	描述
state	number	状态
tenantCode	string	租户编码
createdTime	string	创建时间
addWay	number	添加方式
defaultPositionName	string	预设职位名称
employeeList	array	员工列表

employeeList 字段说明

字段名	类型	说明
nickname	string	员工名称

pager 字段说明

字段名	类型	说明
totalRows	number	总记录数
pageRows	number	每页条数
pageIndex	number	当前页码
totalPages	number	总页数
hasNextPage	boolean	是否有下一页
hasPrevPage	boolean	是否有上一页

2. 获取职位详情（getPositionInfo）

前端： 谭海涛
后端： 陈明辉 url： /v1/homing/system/web/position/get
备注： WEB-职位管理-查询

//! 注意，TS版本4^
import type { GetPositionInfoReq, GetPositionInfoRes } from '@homing/web'

homingClient.getPositionInfo({
  positionCode: 'P001'
}).then((res: any) => {
  console.log('职位详情', res);
});

参数说明

参数名	类型	必填	说明	备注/枚举值
positionCode	string	是	职位标识

响应说明

字段名	类型	说明
positionCode	string	职位编码
positionName	string	职位名称
description	string	描述
state	number	状态
tenantCode	string	租户标识

3. 添加职位（addPosition）

前端： 谭海涛
后端： 柏康 url： /v1/homing/system/web/position/add
备注： WEB-职位管理-添加【商户】

//! 注意，TS版本4^
import type { AddPositionReq } from '@homing/web' 

try {
    await client.addPosition({
        positionName: '技术总监',
        description: '负责技术团队管理',
        state: 1
    } as AddPositionReq);
    console.log('添加成功');
} catch (error: any) {
    console.log(error, '添加失败' + error?.message);
}

参数说明

参数名	类型	必填	说明	备注/枚举值
positionName	string	是	职位名称
description	string	否	职位描述
state	number	是	状态	0-禁用，1-启用

响应说明

字段名	类型	说明
无

4. 更新职位（updatePosition）

前端： 谭海涛
后端： 冀晋星 url： /v1/homing/system/web/position/update
备注： WEB-职位管理-更新【商户】

//! 注意，TS版本4^
import type { UpdatePositionReq } from '@homing/web' 

try {
    await client.updatePosition({
        positionCode: 'POS123456',
        positionName: '高级技术总监',
        description: '负责技术团队管理与规划',
        state: 1,
        positionId: '12345'
    } as UpdatePositionReq);
    console.log('更新成功');
} catch (error: any) {
    console.log(error, '更新失败' + error?.message);
}

参数说明

参数名	类型	必填	说明	备注/枚举值
positionCode	string	是	职位编码
positionName	string	是	职位名称
description	string	否	职位描述
state	number	否	状态	0-禁用，1-启用
positionId	string	是	职位id

响应说明

字段名	类型	说明
无

5. 启用职位（enablePosition）

前端： 谭海涛
后端： 陈明辉 url： /v1/homing/system/web/position/enable
备注： WEB-职位管理-启用

//! 注意，TS版本4^
import type { TogglePositionStateReq } from '@homing/web' 

try {
    await client.enablePosition({
        positionCode: 'POS123456'
    } as TogglePositionStateReq);
    console.log('启用成功');
} catch (error: any) {
    console.log(error, '启用失败' + error?.message);
}

参数说明

参数名	类型	必填	说明	备注/枚举值
positionCode	string	是	职位标识

响应说明

字段名	类型	说明
无

6. 禁用职位（disablePosition）

前端： 谭海涛
后端： 陈明辉 url： /v1/homing/system/web/position/disable
备注： WEB-职位管理-禁用

//! 注意，TS版本4^
import type { TogglePositionStateReq } from '@homing/web' 

try {
    await client.disablePosition({
        positionCode: 'POS123456'
    } as TogglePositionStateReq);
    console.log('禁用成功');
} catch (error: any) {
    console.log(error, '禁用失败' + error?.message);
}

参数说明

参数名	类型	必填	说明	备注/枚举值
positionCode	string	是	职位标识

响应说明

字段名	类型	说明
无