383 lines
17 KiB
Go
383 lines
17 KiB
Go
// ==========================================================================
|
||
// GFast自动生成api操作代码。
|
||
// 生成日期：2023-08-07 10:31:18
|
||
// 生成路径: api/v1/system/bus_construction_user.go
|
||
// 生成人：gfast
|
||
// desc:施工人员相关参数
|
||
// company:云南奇讯科技有限公司
|
||
// ==========================================================================
|
||
|
||
package system
|
||
|
||
import (
|
||
"github.com/gogf/gf/v2/frame/g"
|
||
"github.com/gogf/gf/v2/net/ghttp"
|
||
commonApi "github.com/tiger1103/gfast/v3/api/v1/common"
|
||
comModel "github.com/tiger1103/gfast/v3/internal/app/common/model"
|
||
"github.com/tiger1103/gfast/v3/internal/app/system/model"
|
||
wxModel "github.com/tiger1103/gfast/v3/internal/app/wxApplet/model"
|
||
)
|
||
|
||
// ExportDataFuncReq 分页请求参数
|
||
type ExportDataFuncReq struct {
|
||
g.Meta `path:"/list" tags:"施工人员" method:"get" summary:"施工人员列表"`
|
||
ProjectId string `p:"projectId" dc:"导出所有"` //项目id
|
||
Openid []string `p:"openid" dc:"根据openid导出"` //项目id
|
||
commonApi.Author
|
||
}
|
||
|
||
// ExportDataFuncRes 列表返回结果
|
||
type ExportDataFuncRes struct {
|
||
g.Meta `mime:"application/json"`
|
||
commonApi.ListRes
|
||
List []*model.BusConstructionUserListRes `json:"list"`
|
||
}
|
||
|
||
// BusConstructionUserSearchReq 分页请求参数
|
||
type BusConstructionUserSearchReq struct {
|
||
g.Meta `path:"/list" tags:"施工人员" method:"get" summary:"施工人员列表"`
|
||
NickName string `p:"nickName"` //微信名称
|
||
UserName string `p:"userName"` //人员姓名
|
||
ProjectId string `p:"projectId" v:"projectId@integer#项目id需为整数"` //项目id
|
||
Status string `p:"status"` //状态
|
||
CreatedAt string `p:"createdAt" v:"createdAt@datetime#创建时间需为YYYY-MM-DD hh:mm:ss格式"` //创建时间
|
||
Phone string `p:"phone"` //电话
|
||
Sex string `p:"sex"` //性别
|
||
SfzNation string `p:"sfzNation"` //身份证民族
|
||
NativePlace string `p:"nativePlace"` //籍贯
|
||
commonApi.PageReq
|
||
commonApi.Author
|
||
}
|
||
|
||
// BusConstructionUserSearchRes 列表返回结果
|
||
type BusConstructionUserSearchRes struct {
|
||
g.Meta `mime:"application/json"`
|
||
commonApi.ListRes
|
||
List []*model.BusConstructionUserListRes `json:"list"`
|
||
}
|
||
|
||
// BusConstructionUserAddReq 添加操作请求参数
|
||
type BusConstructionUserAddReq struct {
|
||
g.Meta `path:"/add" tags:"施工人员" method:"post" summary:"施工人员添加"`
|
||
commonApi.Author
|
||
Openid string `p:"openid" `
|
||
NickName string `p:"nickName" v:"required#微信名称不能为空"`
|
||
TeamId int64 `p:"teamId" `
|
||
HeadIcon string `p:"headIcon" `
|
||
PacePhoto string `p:"pacePhoto" `
|
||
UserName string `p:"userName" v:"required#人员姓名不能为空"`
|
||
ProjectId int64 `p:"projectId" `
|
||
Status string `p:"status" v:"required#状态不能为空"`
|
||
IsPinch string `p:"isPinch" `
|
||
IfManagement string `p:"ifManagement" `
|
||
CreateBy string `p:"createBy" `
|
||
UpdateBy string `p:"updateBy" `
|
||
Phone string `p:"phone" `
|
||
Sex string `p:"sex" `
|
||
SfzNation string `p:"sfzNation" `
|
||
SfzNumber string `p:"sfzNumber" `
|
||
SfzStart string `p:"sfzStart" `
|
||
SfzEnd string `p:"sfzEnd" `
|
||
SfzSite string `p:"sfzSite" `
|
||
NativePlace string `p:"nativePlace" `
|
||
YhkNumber string `p:"yhkNumber" `
|
||
YhkOpeningBank string `p:"yhkOpeningBank" `
|
||
YhkCardholder string `p:"yhkCardholder" `
|
||
ProjectRecord string `p:"projectRecord" `
|
||
RoleIds []int64 `p:"roleIds" dc:"角色ID" v:"array"`
|
||
}
|
||
|
||
// BusConstructionUserAddRes 添加操作返回结果
|
||
type BusConstructionUserAddRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
// BusConstructionUserEditReq 修改操作请求参数
|
||
type BusConstructionUserEditReq struct {
|
||
g.Meta `path:"/pcEdit" tags:"施工人员" method:"put" summary:"施工人员修改"`
|
||
commonApi.Author
|
||
WxOrPc string `p:"wxOrPc" dc:"参数为1表示pc添加 否则为小程序添加"`
|
||
SiteNum string `p:"siteNum" dc:"1入场时间 2离场时间 3或零值不操作"`
|
||
Id int64 `p:"id" v:"required#主键ID不能为空微信用户"`
|
||
Openid string `p:"openid" v:"required-unless:WxOrPc,1#需要填写小程序的openid"`
|
||
NickName string `p:"nickName" `
|
||
//TeamId int64 `p:"teamId" `
|
||
HeadIcon string `p:"headIcon" `
|
||
PacePhoto string `p:"pacePhoto" `
|
||
UserName string `p:"userName" v:"required#人员姓名不能为空"`
|
||
ProjectId int64 `p:"projectId" `
|
||
Status string `p:"status" v:"required#状态不能为空"`
|
||
IsPinch string `p:"isPinch" `
|
||
IfManagement string `p:"ifManagement" `
|
||
CreateBy string `p:"createBy" `
|
||
UpdateBy string `p:"updateBy" `
|
||
Phone string `p:"phone" v:"phone"`
|
||
Sex string `p:"sex" `
|
||
SfzNation string `p:"sfzNation" `
|
||
SfzNumber string `p:"sfzNumber" `
|
||
SfzStart string `p:"sfzStart" `
|
||
SfzEnd string `p:"sfzEnd" `
|
||
SfzSite string `p:"sfzSite" `
|
||
NativePlace string `p:"nativePlace" `
|
||
YhkNumber string `p:"yhkNumber" `
|
||
YhkOpeningBank string `p:"yhkOpeningBank" `
|
||
YhkCardholder string `p:"yhkCardholder" `
|
||
SfzBirth string `p:"sfzBirth" `
|
||
LabourserviceId int64 `p:"labourserviceId"`
|
||
TypeOfWork string `p:"typeOfWork"`
|
||
EntryDate string `p:"entryDate"`
|
||
LeaveDate string `p:"leaveDate"`
|
||
Clock string `p:"clock"`
|
||
PostReq *model.BusConstructionUserPostInfoRes `json:"postReq"`
|
||
ProjectListReq []*model.BusConstructionProjectListRes `json:"projectListReq"`
|
||
FilesListReq []*model.BusConstructionUserFileListRes `json:"filesListReq"`
|
||
ProjectRecord string `p:"projectRecord" `
|
||
DevNum string `p:"devNum" dc:"安全帽标识"`
|
||
RoleIds []int64 `p:"roleIds" dc:"角色ID" v:"array"`
|
||
}
|
||
|
||
// BusConstructionUserEditRes 修改操作返回结果
|
||
type BusConstructionUserEditRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
// BusConstructionUserGetReq 获取一条数据请求
|
||
type BusConstructionUserGetReq struct {
|
||
g.Meta `path:"/get" tags:"施工人员" method:"get" summary:"获取施工人员信息"`
|
||
commonApi.Author
|
||
Id int64 `p:"id" v:"required#主键必须"` //通过主键获取
|
||
}
|
||
|
||
// BusConstructionUserGetRes 获取一条数据结果
|
||
type BusConstructionUserGetRes struct {
|
||
g.Meta `mime:"application/json"`
|
||
*model.BusConstructionUserInfoRes
|
||
}
|
||
|
||
// BusConstructionUserDeleteReq 删除数据请求
|
||
type BusConstructionUserDeleteReq struct {
|
||
g.Meta `path:"/delete" tags:"施工人员" method:"delete" summary:"删除施工人员"`
|
||
commonApi.Author
|
||
Ids []int64 `p:"ids" v:"required#主键必须"` //通过主键删除
|
||
}
|
||
|
||
// BusConstructionUserDeleteRes 删除数据返回
|
||
type BusConstructionUserDeleteRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
// BatchImportDataReq 批量导入施工人员的资料
|
||
type BatchImportDataReq struct {
|
||
g.Meta `path:"/coryBatch" tags:"施工人员" method:"post" summary:"批量导入施工人员的资料（作废）"`
|
||
commonApi.Author
|
||
File *comModel.UpFile `p:"file"`
|
||
}
|
||
|
||
// BatchImportDataRes 批量导入施工人员的资料
|
||
type BatchImportDataRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
// ExportSalaryTeamReq 导出施工人员工资组成(项目)
|
||
type ExportSalaryTeamReq struct {
|
||
g.Meta `path:"/exportSalaryTeam" tags:"施工人员" method:"post" summary:"根据项目或班组导出出勤记录(项目)"`
|
||
commonApi.Author
|
||
//ProjectId int64 `p:"projectId" dc:"项目主键ID" v:"required#项目主键ID必须"`
|
||
//TeamId int64 `p:"teamId" dc:"班组主键ID" `
|
||
//Years string `p:"years" dc:"时间格式为2024-02" v:"date-format:Y-m#格式为2024-02"`
|
||
|
||
FuzzyQuery string `p:"fuzzyQuery" dc:"模糊查询" `
|
||
ProjectId int64 `p:"projectId" dc:"项目ID" v:"required#项目ID不能为空"`
|
||
TeamId int64 `p:"teamId" dc:"班组ID"`
|
||
TypeOfWork string `p:"typeOfWork" dc:"工种"`
|
||
DateStr string `p:"dateStr" dc:"日期（格式：2024-04）" v:"date-format:Y-m#时间格式为2024-04"`
|
||
}
|
||
|
||
// ExportSalaryReq 导出施工人员工资组成(班组)
|
||
type ExportSalaryReq struct {
|
||
g.Meta `path:"/exportSalary" tags:"施工人员" method:"post" summary:"根据项目或班组导出出勤记录(班组)"`
|
||
commonApi.Author
|
||
|
||
FuzzyQuery string `p:"fuzzyQuery" dc:"模糊查询" `
|
||
ProjectId int64 `p:"projectId" dc:"项目ID" v:"required#项目ID不能为空"`
|
||
TeamId int64 `p:"teamId" dc:"班组ID"`
|
||
TypeOfWork string `p:"typeOfWork" dc:"工种"`
|
||
DateStr string `p:"dateStr" dc:"日期（格式：2024-04）" v:"date-format:Y-m#时间格式为2024-04"`
|
||
}
|
||
|
||
// ExportSalaryRes 导出施工人员工资组成
|
||
type ExportSalaryRes struct {
|
||
commonApi.EmptyRes
|
||
AttendanceAllOne []model.AttendanceAllEntity `p:"attendanceAllOne" dc:"成员基本信息"`
|
||
}
|
||
|
||
type SigningMessagesReq struct {
|
||
g.Meta `path:"/signingMessages" tags:"施工人员" method:"get" summary:"【签名】根据openid获取到指定小程序用户的签名信息"`
|
||
commonApi.Author
|
||
Openid string `p:"openid" dc:"openid" v:"required#施工人员openid不能为空"`
|
||
}
|
||
type SigningMessagesRes struct {
|
||
commonApi.EmptyRes
|
||
Signature *wxModel.BusConstructiomUserSignatureRes `p:"signature" dc:"签名信息"`
|
||
}
|
||
|
||
type SigningUpdateFuncReq struct {
|
||
g.Meta `path:"/signingUpdate" tags:"施工人员" method:"put" summary:"【签名】修改指定签名的状态"`
|
||
commonApi.Author
|
||
Id string `p:"id" dc:"签名主键ID" v:"required#签名主键ID不能为空"`
|
||
Change string `p:"change" dc:"是否更改签名（1不更改 2更改）" v:"required#change状态不能为空"`
|
||
}
|
||
type SigningUpdateFuncRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
type OneClickOpenReq struct {
|
||
g.Meta `path:"/oneClickOpen" tags:"施工人员" method:"put" summary:"一键开启/关闭打开"`
|
||
commonApi.Author
|
||
Type string `p:"type" dc:"1开启 2关闭" v:"between:1,2#取值范围为1~2"`
|
||
ProjectId int64 `p:"projectId" dc:"项目ID" v:"required#项目主键ID必须"`
|
||
}
|
||
type OneClickOpenRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
type ClockingConditionReq struct {
|
||
g.Meta `path:"/clockingCondition" tags:"施工人员" method:"put" summary:"开启/关闭打开(根据某个人操作)"`
|
||
commonApi.Author
|
||
Type string `p:"type" dc:"1开启 2关闭" v:"between:1,2#取值范围为1~2"`
|
||
Id int64 `p:"id" dc:"ID" v:"required#主键ID必须"`
|
||
}
|
||
type ClockingConditionRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
type TemplateExportReq struct {
|
||
g.Meta `path:"/templateExport" tags:"施工人员" method:"get" summary:"施工人员资料文件上传模板导出"`
|
||
ProjectId int64 `p:"projectId" v:"required#项目ID必须"`
|
||
commonApi.Author
|
||
}
|
||
type TemplateExportRes struct {
|
||
commonApi.EmptyRes
|
||
Path string `p:"path" dc:"zip路径"`
|
||
}
|
||
|
||
type ZipFolderuploadReq struct {
|
||
g.Meta `path:"/zipFolderupload" tags:"施工人员" method:"post" summary:"批量上传施工人员的资料（压缩文件zip上传）"`
|
||
//File *ghttp.UploadFile `p:"file" `
|
||
FilePath string `p:"filePath" `
|
||
commonApi.Author
|
||
}
|
||
type ZipFolderuploadRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
type DepartureReq struct {
|
||
g.Meta `path:"/departure" tags:"施工人员" method:"post" summary:"离场（成员离开班组）"`
|
||
Id string `p:"id" dc:"班组成员主键ID" v:"required#班组成员主键ID必须"`
|
||
File []*ghttp.UploadFile `p:"file" dc:"附件"`
|
||
Remark string `p:"remark" dc:"备注" v:"max-length:512#最大输入字数为512"`
|
||
commonApi.Author
|
||
}
|
||
type DepartureRes struct {
|
||
commonApi.EmptyRes
|
||
}
|
||
|
||
type DepartureRecordReq struct {
|
||
g.Meta `path:"/departureRecord" tags:"施工人员" method:"post" summary:"施工人员入场退场历史记录信息（根据身份证信息查询）"`
|
||
SfzNumber string `p:"sfzNumber" dc:"身份证号码" v:"required#身份证号码必须"`
|
||
commonApi.Author
|
||
}
|
||
type DepartureRecordRes struct {
|
||
commonApi.EmptyRes
|
||
List []model.BusConstructionUserDepartureInfoRes `p:"list"`
|
||
}
|
||
|
||
type PcCollectDataForTwoWeeksReq struct {
|
||
g.Meta `path:"/pcCollectDataForTwoWeeks" tags:"施工人员" method:"get" summary:"获取最近两周的数据（统计全勤、半勤、缺勤）"`
|
||
commonApi.Author
|
||
ProjectId string `p:"projectId" dc:"项目ID" v:"required#项目ID不能为空"`
|
||
}
|
||
|
||
type PcCollectDataForTwoWeeksRes struct {
|
||
commonApi.EmptyRes
|
||
List []*PcCollectDataForTwoWeeksTwoRes `json:"list"`
|
||
}
|
||
|
||
type PcCollectDataForTwoWeeksTwoRes struct {
|
||
DateStr string `json:"dateStr" dc:"日期"`
|
||
Absenteeism int `json:"absenteeism" dc:"缺勤人数（下班未打卡）"`
|
||
HalfDuty int `json:"halfDuty" dc:"半勤人数（只打了上班）"`
|
||
Attendance int `json:"attendance" dc:"出勤人数（全勤）"`
|
||
}
|
||
|
||
type PcSelectBelowProjectOfPersonnelReq struct {
|
||
g.Meta `path:"/pcSelectBelowProjectOfPersonnel" tags:"施工人员" method:"get" summary:"获取指定项目下的人员打卡信息"`
|
||
commonApi.Author
|
||
commonApi.PageReq
|
||
FuzzyQuery string `p:"fuzzyQuery" dc:"模糊查询" `
|
||
ProjectId int64 `p:"projectId" dc:"项目ID" v:"required#项目ID不能为空"`
|
||
TeamId int64 `p:"teamId" dc:"班组ID"`
|
||
TypeOfWork string `p:"typeOfWork" dc:"工种"`
|
||
DateStr string `p:"dateStr" dc:"日期（格式：2024-04）" v:"date-format:Y-m#时间格式为2024-04"`
|
||
}
|
||
|
||
type PcSelectBelowProjectOfPersonnelRes struct {
|
||
commonApi.EmptyRes
|
||
commonApi.ListRes
|
||
List []*PcSelectBelowProjectOfPersonnelTwoRes `json:"list"`
|
||
}
|
||
|
||
type PcSelectBelowProjectOfPersonnelTwoRes struct {
|
||
Id string `p:"id" dc:"打卡主键ID"`
|
||
Openid string `p:"openid" dc:"openid"`
|
||
UserName string `p:"userName" dc:"用户名称"`
|
||
TeamName string `p:"teamName" dc:"班组名称"`
|
||
TypeOfWork string `p:"typeOfWork" dc:"工种（字典：type_of_work）"`
|
||
Attendance int `p:"attendance" dc:"出勤（单位：天）"`
|
||
BeLate int `p:"beLate" dc:"迟到（单位：次）"`
|
||
LeaveEarly int `p:"leaveEarly" dc:"早退（单位：次）"`
|
||
LackOfCard int `p:"lackOfCard" dc:"缺卡（单位：次）"`
|
||
List []*wxModel.BusAttendanceInfoRes `json:"list"`
|
||
}
|
||
|
||
type PcQueryBasedOnOpenidReq struct {
|
||
g.Meta `path:"/pcQueryBasedOnOpenid" tags:"施工人员" method:"get" summary:"根据openid查询某人指定月份的打卡详情"`
|
||
commonApi.Author
|
||
Openid string `p:"openid" dc:"openid" `
|
||
DateStr string `p:"dateStr" dc:"日期（格式：2024-04）" v:"date-format:Y-m#时间格式为2024-04"`
|
||
}
|
||
|
||
type PcQueryBasedOnOpenidRes struct {
|
||
commonApi.EmptyRes
|
||
List []*PcQueryBasedOnOpenidTwoRes `json:"list"`
|
||
}
|
||
|
||
type PcQueryBasedOnOpenidTwoRes struct {
|
||
Openid string `p:"openid" dc:"openid"`
|
||
ProjectId int64 `p:"projectId" dc:"项目ID"`
|
||
ProjectName string `p:"projectName" dc:"班组名称"`
|
||
TeamId int64 `p:"teamId" dc:"班组ID"`
|
||
TeamName string `p:"teamName" dc:"班组名称"`
|
||
PrintingDate string `p:"printingDate" dc:"年月日"`
|
||
Status []string `p:"status" dc:"1、考勤正常 2迟到早退缺卡 3补卡申请"`
|
||
ThreeList []*PcQueryBasedOnOpenidThreeRes `json:"threelist"`
|
||
}
|
||
|
||
type PcQueryBasedOnOpenidThreeRes struct {
|
||
Commuter string `p:"commuter" dc:"上下班（1上班 2下班）"`
|
||
Clock string `p:"clock" dc:"打卡日期时间"`
|
||
IsPinch string `p:"isPinch" dc:"1正常,2迟到,3早退,4缺勤,5补卡"`
|
||
}
|
||
|
||
type ListOfAttendanceMachinesReq struct {
|
||
g.Meta `path:"/listOfAttendanceMachines" tags:"施工人员" method:"get" summary:"考勤机列表"`
|
||
ProjectId int64 `p:"projectId" dc:"项目ID"` //项目id
|
||
Sn string `p:"sn" dc:"根据openid导出"` //sn
|
||
commonApi.Author
|
||
}
|
||
|
||
type ListOfAttendanceMachinesRes struct {
|
||
g.Meta `mime:"application/json"`
|
||
commonApi.ListRes
|
||
List []*model.BusConstructionUserListRes `json:"list"`
|
||
}
|