184 lines
7.0 KiB
Go
184 lines
7.0 KiB
Go
|
// ==========================================================================
|
|||
|
|
// GFast自动生成api操作代码。
|
|||
|
|
// 生成日期：2025-03-03 10:32:47
|
|||
|
|
// 生成路径: api/v1/system/bus_attendance_machine.go
|
|||
|
|
// 生成人：gfast
|
|||
|
|
// desc:考勤机相关参数
|
|||
|
|
// company:云南奇讯科技有限公司
|
|||
|
|
// ==========================================================================
|
|||
|
|
|
|||
|
|
package system
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"github.com/gogf/gf/v2/frame/g"
|
|||
|
|
commonApi "github.com/tiger1103/gfast/v3/api/v1/common"
|
|||
|
|
"github.com/tiger1103/gfast/v3/internal/app/system/model"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineSearchReq 分页请求参数
|
|||
|
|
type BusAttendanceMachineSearchReq struct {
|
|||
|
|
g.Meta `path:"/list" tags:"考勤机" method:"get" summary:"考勤机列表"`
|
|||
|
|
ProjectId string `p:"projectId" dc:"项目ID"`
|
|||
|
|
Sn string `p:"sn" dc:"设备sn"`
|
|||
|
|
commonApi.PageReq
|
|||
|
|
commonApi.Author
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineSearchRes 列表返回结果
|
|||
|
|
type BusAttendanceMachineSearchRes struct {
|
|||
|
|
g.Meta `mime:"application/json"`
|
|||
|
|
commonApi.ListRes
|
|||
|
|
List []*model.BusAttendanceMachineExtendRes `json:"list"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineAddReq 添加操作请求参数
|
|||
|
|
type BusAttendanceMachineAddReq struct {
|
|||
|
|
g.Meta `path:"/add" tags:"考勤机" method:"post" summary:"考勤机添加"`
|
|||
|
|
commonApi.Author
|
|||
|
|
ProjectId uint64 `p:"projectId" v:"required#项目ID不能为空"`
|
|||
|
|
Sn string `p:"sn" v:"required#设备sn不能为空"`
|
|||
|
|
Teams string `p:"teams" `
|
|||
|
|
CreateBy string `p:"createBy" `
|
|||
|
|
Remark string `p:"remark" `
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineAddRes 添加操作返回结果
|
|||
|
|
type BusAttendanceMachineAddRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineEditReq 修改操作请求参数
|
|||
|
|
type BusAttendanceMachineEditReq struct {
|
|||
|
|
g.Meta `path:"/edit" tags:"考勤机" method:"put" summary:"考勤机修改"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Sn string `p:"sn" v:"required#设备sn不能为空"`
|
|||
|
|
Id uint64 `p:"id" v:"required#主键ID不能为空"`
|
|||
|
|
ProjectId uint64 `p:"projectId" v:"required#项目ID不能为空"`
|
|||
|
|
Teams string `p:"teams" dc:"班组ID（多个逗号分割）" v:"required#班组ID不能为空"`
|
|||
|
|
Remark string `p:"remark" dc:"备注"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineEditRes 修改操作返回结果
|
|||
|
|
type BusAttendanceMachineEditRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineGetReq 获取一条数据请求
|
|||
|
|
type BusAttendanceMachineGetReq struct {
|
|||
|
|
g.Meta `path:"/get" tags:"考勤机" method:"get" summary:"获取考勤机信息"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Id uint64 `p:"id" v:"required#主键必须"` //通过主键获取
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineGetRes 获取一条数据结果
|
|||
|
|
type BusAttendanceMachineGetRes struct {
|
|||
|
|
g.Meta `mime:"application/json"`
|
|||
|
|
*model.BusAttendanceMachineExtendRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineDeleteReq 删除数据请求
|
|||
|
|
type BusAttendanceMachineDeleteReq struct {
|
|||
|
|
g.Meta `path:"/delete" tags:"考勤机" method:"delete" summary:"删除考勤机"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Ids []uint64 `p:"ids" v:"required#主键必须"` //通过主键删除
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// BusAttendanceMachineDeleteRes 删除数据返回
|
|||
|
|
type BusAttendanceMachineDeleteRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
===============================================================
|
|||
|
|
===============================================================
|
|||
|
|
===============================================================
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
type BusAttendanceMachineRegisterReq struct {
|
|||
|
|
g.Meta `path:"/busAttendanceMachineRegister" tags:"考勤机" method:"post" summary:"考勤机注册"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Sn string `p:"sn" v:"required#设备sn不能为空"`
|
|||
|
|
Remark string `p:"remark" `
|
|||
|
|
}
|
|||
|
|
type BusAttendanceMachineRegisterRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type BusAttendanceMachineChangeReq struct {
|
|||
|
|
g.Meta `path:"/busAttendanceMachineChange" tags:"考勤机" method:"post" summary:"变更考勤机状态"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Sn string `p:"sn" v:"required#设备sn不能为空"`
|
|||
|
|
Status string `p:"status" dc:"考勤机在线状态"`
|
|||
|
|
}
|
|||
|
|
type BusAttendanceMachineChangeRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type BindUserInformationToDevicesInBatchesReq struct {
|
|||
|
|
g.Meta `path:"/bindUserInformationToDevicesInBatches" tags:"考勤机" method:"post" summary:"将用户信息与考勤机绑定"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Bind []BindUserInformationToDevicesInBatchesTwoReq `p:"bind" v:"required#用户信息"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type BindUserInformationToDevicesInBatchesTwoReq struct {
|
|||
|
|
MachineId int64 `p:"machineId" v:"required#考勤机ID不能为空"`
|
|||
|
|
TeamId int64 `p:"teamId" v:"required#班组ID不能为空"`
|
|||
|
|
UserId string `p:"userId" v:"required#用户ID不能为空"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type BindUserInformationToDevicesInBatchesRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type SendTheUserInformationToTheAttendanceMachineReq struct {
|
|||
|
|
g.Meta `path:"/sendTheUserInformationToTheAttendanceMachine" tags:"考勤机" method:"post" summary:"将用户信息下发到考勤机上"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Sn string `p:"sn" dc:"设备唯一标识" v:"required#sn不能为空"`
|
|||
|
|
MachineId string `p:"machineId" dc:"自增id" v:"required#machineIdsn不能为空"`
|
|||
|
|
Type int `p:"type" dc:"1全部 2批量 3指定" v:"between:1,3#参数传递为1~3"`
|
|||
|
|
UserId []string `p:"userId" dc:"type为1不传递 2传递部分 3传递一个"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type SendTheUserInformationToTheAttendanceMachineRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type DeleteTheUserBoundToTheAttendanceMachineAndDeviceReq struct {
|
|||
|
|
g.Meta `path:"/deleteTheUserBoundToTheAttendanceMachineAndDevice" tags:"考勤机" method:"post" summary:"将考勤机和设备绑定的用户删除掉"`
|
|||
|
|
commonApi.Author
|
|||
|
|
Sn string `p:"sn" dc:"设备唯一标识" v:"required#sn不能为空"`
|
|||
|
|
MachineId string `p:"machineId" dc:"自增id" v:"required#machineIdsn不能为空"`
|
|||
|
|
TeamId int64 `p:"teamId" v:"required#班组ID不能为空"`
|
|||
|
|
UserId string `p:"userId" dc:"用户openid" v:"required#用户openid不能为空"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type DeleteTheUserBoundToTheAttendanceMachineAndDeviceRes struct {
|
|||
|
|
commonApi.EmptyRes
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type ObtainInformationAboutPersonnelAssociatedWithTheAttendanceDeviceReq struct {
|
|||
|
|
g.Meta `path:"/obtainInformationAboutPersonnelAssociatedWithTheAttendanceDevice" tags:"考勤机" method:"get" summary:"获取考勤设备关联的人员信息"`
|
|||
|
|
Sn string `p:"sn" dc:"设备唯一标识" v:"required#sn不能为空"`
|
|||
|
|
MachineId string `p:"machineId" dc:"自增id" v:"required#machineIdsn不能为空"`
|
|||
|
|
TeamId string `p:"teamId" dc:"班组ID" v:"required#班组ID不能为空"`
|
|||
|
|
UserName string `p:"name" dc:"用户名称"`
|
|||
|
|
commonApi.Paging
|
|||
|
|
commonApi.PageReq
|
|||
|
|
commonApi.Author
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type ObtainInformationAboutPersonnelAssociatedWithTheAttendanceDeviceRes struct {
|
|||
|
|
g.Meta `mime:"application/json"`
|
|||
|
|
commonApi.ListRes
|
|||
|
|
UserList []*ObtainInformationAboutPersonnelAssociatedWithTheAttendanceDeviceTwo `p:"userList" dc:"用户信息列表"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type ObtainInformationAboutPersonnelAssociatedWithTheAttendanceDeviceTwo struct {
|
|||
|
|
Openid string `p:"openid" dc:"用户openId"`
|
|||
|
|
UserName string `p:"userName" dc:"用户名称"`
|
|||
|
|
TeamId string `p:"teamId" dc:"班组ID"`
|
|||
|
|
PacePhoto string `p:"pacePhoto" dc:"人脸照"`
|
|||
|
|
XFStatus string `p:"xFStatus" dc:"是否已绑定设备(1绑定 0未绑定)"`
|
|||
|
|
Status string `p:"status" dc:"是否存在考勤设备中(1存在 0不存在)"`
|
|||
|
|
}
|