From 4adc59b1b0f0eeff17fd5bd9017db9cbe07f51c3 Mon Sep 17 00:00:00 2001 From: markwang <2951177317@qq.com> Date: Thu, 2 Nov 2023 09:40:01 +0800 Subject: [PATCH] =?UTF-8?q?feat:=E4=BC=81=E4=B8=9A=E5=BE=AE=E4=BF=A1-?= =?UTF-8?q?=E6=89=93=E5=8D=A1-=E6=96=B0=E5=A2=9E=E7=9B=B8=E5=85=B3?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2=E6=8E=A5=E5=8F=A3=20(#746)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: markwang --- work/checkin/record.go | 401 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 401 insertions(+) diff --git a/work/checkin/record.go b/work/checkin/record.go index 8136ce0..18e97fa 100644 --- a/work/checkin/record.go +++ b/work/checkin/record.go @@ -13,6 +13,14 @@ const ( getDayDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_daydata?access_token=%s" // getMonthDataURL 获取打卡月报数据 getMonthDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_monthdata?access_token=%s" + // getCorpOptionURL 获取企业所有打卡规则 + getCorpOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcorpcheckinoption?access_token=%s" + // getOptionURL 获取员工打卡规则 + getOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinoption?access_token=%s" + // getScheduleListURL 获取打卡人员排班信息 + getScheduleListURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinschedulist?access_token=%s" + // getHardwareDataURL获取设备打卡数据 + getHardwareDataURL = "https://qyapi.weixin.qq.com/cgi-bin/hardware/get_hardware_checkin_data?access_token=%s" ) type ( @@ -257,3 +265,396 @@ func (r *Client) GetMonthData(req *GetCheckinDataRequest) (result *GetMonthDataR err = util.DecodeWithError(response, result, "GetMonthData") return } + +// GetCorpOptionResponse 获取企业所有打卡规则响应 +type GetCorpOptionResponse struct { + util.CommonError + Group []CorpOptionGroup `json:"group"` +} + +// CorpOptionGroup 企业规则信息列表 +type CorpOptionGroup struct { + GroupType int64 `json:"grouptype"` + GroupID int64 `json:"groupid"` + GroupName string `json:"groupname"` + CheckinDate []GroupCheckinDate `json:"checkindate"` + SpeWorkdays []SpeWorkdays `json:"spe_workdays"` + SpeOffDays []SpeOffDays `json:"spe_offdays"` + SyncHolidays bool `json:"sync_holidays"` + NeedPhoto bool `json:"need_photo"` + NoteCanUseLocalPic bool `json:"note_can_use_local_pic"` + AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"` + AllowApplyOffWorkday bool `json:"allow_apply_offworkday"` + WifiMacInfos []WifiMacInfos `json:"wifimac_infos"` + LocInfos []LocInfos `json:"loc_infos"` + Range []Range `json:"range"` + CreateTime int64 `json:"create_time"` + WhiteUsers []string `json:"white_users"` + Type int64 `json:"type"` + ReporterInfo ReporterInfo `json:"reporterinfo"` + OtInfo GroupOtInfo `json:"ot_info"` + OtApplyInfo OtApplyInfo `json:"otapplyinfo"` + Uptime int64 `json:"uptime"` + AllowApplyBkCnt int64 `json:"allow_apply_bk_cnt"` + OptionOutRange int64 `json:"option_out_range"` + CreateUserID string `json:"create_userid"` + UseFaceDetect bool `json:"use_face_detect"` + AllowApplyBkDayLimit int64 `json:"allow_apply_bk_day_limit"` + UpdateUserID string `json:"update_userid"` + BukaRestriction int64 `json:"buka_restriction"` + ScheduleList []ScheduleList `json:"schedulelist"` + OffWorkIntervalTime int64 `json:"offwork_interval_time"` +} + +// GroupCheckinDate 打卡时间，当规则类型为排班时没有意义 +type GroupCheckinDate struct { + Workdays []int64 `json:"workdays"` + CheckinTime []GroupCheckinTime `json:"checkintime"` + NoNeedOffWork bool `json:"noneed_offwork"` + LimitAheadTime int64 `json:"limit_aheadtime"` + FlexOnDutyTime int64 `json:"flex_on_duty_time"` + FlexOffDutyTime int64 `json:"flex_off_duty_time"` +} + +// GroupCheckinTime 工作日上下班打卡时间信息 +type GroupCheckinTime struct { + WorkSec int64 `json:"work_sec"` + OffWorkSec int64 `json:"off_work_sec"` + RemindWorkSec int64 `json:"remind_work_sec"` + RemindOffWorkSec int64 `json:"remind_off_work_sec"` +} + +// SpeWorkdays 特殊日期-必须打卡日期信息 +type SpeWorkdays struct { + Timestamp int64 `json:"timestamp"` + Notes string `json:"notes"` + CheckinTime []GroupCheckinTime `json:"checkintime"` +} + +// SpeOffDays 特殊日期-不用打卡日期信息 +type SpeOffDays struct { + Timestamp int64 `json:"timestamp"` + Notes string `json:"notes"` +} + +// WifiMacInfos 打卡地点-WiFi打卡信息 +type WifiMacInfos struct { + WifiName string `json:"wifiname"` + WifiMac string `json:"wifimac"` +} + +// LocInfos 打卡地点-位置打卡信息 +type LocInfos struct { + Lat int64 `json:"lat"` + Lng int64 `json:"lng"` + LocTitle string `json:"loc_title"` + LocDetail string `json:"loc_detail"` + Distance int64 `json:"distance"` +} + +// Range 打卡人员信息 +type Range struct { + PartyID []string `json:"partyid"` + UserID []string `json:"userid"` + TagID []int64 `json:"tagid"` +} + +// ReporterInfo 汇报对象信息 +type ReporterInfo struct { + Reporters []Reporters `json:"reporters"` + UpdateTime int64 `json:"updatetime"` +} + +// Reporters 汇报对象，每个汇报人用userid表示 +type Reporters struct { + UserID string `json:"userid"` +} + +// GroupOtInfo 加班信息 +type GroupOtInfo struct { + Type int64 `json:"type"` + AllowOtWorkingDay bool `json:"allow_ot_workingday"` + AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"` + OtCheckInfo OtCheckInfo `json:"otcheckinfo"` +} + +// OtCheckInfo 以打卡时间为准-加班时长计算规则信息 +type OtCheckInfo struct { + OtWorkingDayTimeStart int64 `json:"ot_workingday_time_start"` + OtWorkingDayTimeMin int64 `json:"ot_workingday_time_min"` + OtWorkingDayTimeMax int64 `json:"ot_workingday_time_max"` + OtNonworkingDayTimeMin int64 `json:"ot_nonworkingday_time_min"` + OtNonworkingDayTimeMax int64 `json:"ot_nonworkingday_time_max"` + OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"` + OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"` + OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"` +} + +// OtRestInfo 加班-休息扣除配置信息 +type OtRestInfo struct { + Type int64 `json:"type"` + FixTimeRule FixTimeRule `json:"fix_time_rule"` + CalOtTimeRule CalOtTimeRule `json:"cal_ottime_rule"` +} + +// FixTimeRule 工作日加班-指定休息时间配置信息 +type FixTimeRule struct { + FixTimeBeginSec int64 `json:"fix_time_begin_sec"` + FixTimeEndSec int64 `json:"fix_time_end_sec"` +} + +// CalOtTimeRule 工作日加班-按加班时长扣除配置信息 +type CalOtTimeRule struct { + Items []CalOtTimeRuleItem `json:"items"` +} + +// CalOtTimeRuleItem 工作日加班-按加班时长扣除条件信息 +type CalOtTimeRuleItem struct { + OtTime int64 `json:"ot_time"` + RestTime int64 `json:"rest_time"` +} + +// OtApplyInfo 以加班申请核算打卡记录相关信息 +type OtApplyInfo struct { + AllowOtWorkingDay bool `json:"allow_ot_workingday"` + AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"` + Uiptime int64 `json:"uptime"` + OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"` + OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"` + OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"` +} + +// ScheduleList 排班信息列表 +type ScheduleList struct { + ScheduleID int64 `json:"schedule_id"` + ScheduleName string `json:"schedule_name"` + TimeSection []TimeSection `json:"time_section"` + LimitAheadTime int64 `json:"limit_aheadtime"` + NoNeedOffWork bool `json:"noneed_offwork"` + LimitOffTime int64 `json:"limit_offtime"` + FlexOnDutyTime int64 `json:"flex_on_duty_time"` + FlexOffDutyTime int64 `json:"flex_off_duty_time"` + AllowFlex bool `json:"allow_flex"` + LateRule LateRule `json:"late_rule"` + MaxAllowArriveEarly int64 `json:"max_allow_arrive_early"` + MaxAllowArriveLate int64 `json:"max_allow_arrive_late"` +} + +// TimeSection 班次上下班时段信息 +type TimeSection struct { + TimeID int64 `json:"time_id"` + WorkSec int64 `json:"work_sec"` + OffWorkSec int64 `json:"off_work_sec"` + RemindWorkSec int64 `json:"remind_work_sec"` + RemindOffWorkSec int64 `json:"remind_off_work_sec"` + RestBeginTime int64 `json:"rest_begin_time"` + RestEndTime int64 `json:"rest_end_time"` + AllowRest bool `json:"allow_rest"` +} + +// LateRule 晚走晚到时间规则信息 +type LateRule struct { + AllowOffWorkAfterTime bool `json:"allow_offwork_after_time"` + TimeRules []TimeRule `json:"timerules"` +} + +// TimeRule 迟到规则时间 +type TimeRule struct { + OffWorkAfterTime int64 `json:"offwork_after_time"` + OnWorkFlexTime int64 `json:"onwork_flex_time"` +} + +// GetCorpOption 获取企业所有打卡规则 +// @see https://developer.work.weixin.qq.com/document/path/93384 +func (r *Client) GetCorpOption() (*GetCorpOptionResponse, error) { + var ( + accessToken string + err error + ) + if accessToken, err = r.GetAccessToken(); err != nil { + return nil, err + } + var response []byte + if response, err = util.HTTPPost(fmt.Sprintf(getCorpOptionURL, accessToken), ""); err != nil { + return nil, err + } + result := &GetCorpOptionResponse{} + err = util.DecodeWithError(response, result, "GetCorpOption") + return result, err +} + +// GetOptionRequest 获取员工打卡规则请求 +type GetOptionRequest struct { + Datetime int64 `json:"datetime"` + UserIDList []string `json:"useridlist"` +} + +// GetOptionResponse 获取员工打卡规则响应 +type GetOptionResponse struct { + util.CommonError + Info []OptionInfo `json:"info"` +} + +// OptionInfo 打卡规则列表 +type OptionInfo struct { + UserID string `json:"userid"` + Group OptionGroup `json:"group"` +} + +// OptionGroup 打卡规则相关信息 +type OptionGroup struct { + GroupType int64 `json:"grouptype"` + GroupID int64 `json:"groupid"` + GroupName string `json:"groupname"` + CheckinDate []OptionCheckinDate `json:"checkindate"` + SpeWorkdays []SpeWorkdays `json:"spe_workdays"` + SpeOffDays []SpeOffDays `json:"spe_offdays"` + SyncHolidays bool `json:"sync_holidays"` + NeedPhoto bool `json:"need_photo"` + WifiMacInfos []WifiMacInfos `json:"wifimac_infos"` + NoteCanUseLocalPic bool `json:"note_can_use_local_pic"` + AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"` + AllowApplyOffWorkday bool `json:"allow_apply_offworkday"` + LocInfos []LocInfos `json:"loc_infos"` + ScheduleList []ScheduleList `json:"schedulelist"` + BukaRestriction int64 `json:"buka_restriction"` +} + +// OptionCheckinDate 打卡时间配置 +type OptionCheckinDate struct { + Workdays []int64 `json:"workdays"` + CheckinTime []GroupCheckinTime `json:"checkintime"` + FlexTime int64 `json:"flex_time"` + NoNeedOffWork bool `json:"noneed_offwork"` + LimitAheadTime int64 `json:"limit_aheadtime"` + FlexOnDutyTime int64 `json:"flex_on_duty_time"` + FlexOffDutyTime int64 `json:"flex_off_duty_time"` +} + +// GetOption 获取员工打卡规则 +// see https://developer.work.weixin.qq.com/document/path/90263 +func (r *Client) GetOption(req *GetOptionRequest) (*GetOptionResponse, error) { + var ( + accessToken string + err error + ) + if accessToken, err = r.GetAccessToken(); err != nil { + return nil, err + } + var response []byte + if response, err = util.PostJSON(fmt.Sprintf(getOptionURL, accessToken), req); err != nil { + return nil, err + } + result := &GetOptionResponse{} + err = util.DecodeWithError(response, result, "GetOption") + return result, err +} + +// GetScheduleListRequest 获取打卡人员排班信息请求 +type GetScheduleListRequest struct { + StartTime int64 `json:"starttime"` + EndTime int64 `json:"endtime"` + UserIDList []string `json:"useridlist"` +} + +// GetScheduleListResponse 获取打卡人员排班信息响应 +type GetScheduleListResponse struct { + util.CommonError + ScheduleList []ScheduleItem `json:"schedule_list"` +} + +// ScheduleItem 排班表信息 +type ScheduleItem struct { + UserID string `json:"userid"` + YearMonth int64 `json:"yearmonth"` + GroupID int64 `json:"groupid"` + GroupName string `json:"groupname"` + Schedule Schedule `json:"schedule"` +} + +// Schedule 个人排班信息 +type Schedule struct { + ScheduleList []ScheduleListItem `json:"scheduleList"` +} + +// ScheduleListItem 个人排班表信息 +type ScheduleListItem struct { + Day int64 `json:"day"` + ScheduleInfo ScheduleInfo `json:"schedule_info"` +} + +// ScheduleInfo 个人当日排班信息 +type ScheduleInfo struct { + ScheduleID int64 `json:"schedule_id"` + ScheduleName string `json:"schedule_name"` + TimeSection []ScheduleTimeSection `json:"time_section"` +} + +// ScheduleTimeSection 班次上下班时段信息 +type ScheduleTimeSection struct { + ID int64 `json:"id"` + WorkSec int64 `json:"work_sec"` + OffWorkSec int64 `json:"off_work_sec"` + RemindWorkSec int64 `json:"remind_work_sec"` + RemindOffWorkSec int64 `json:"remind_off_work_sec"` +} + +// GetScheduleList 获取打卡人员排班信息 +// see https://developer.work.weixin.qq.com/document/path/93380 +func (r *Client) GetScheduleList(req *GetScheduleListRequest) (*GetScheduleListResponse, error) { + var ( + accessToken string + err error + ) + if accessToken, err = r.GetAccessToken(); err != nil { + return nil, err + } + var response []byte + if response, err = util.PostJSON(fmt.Sprintf(getScheduleListURL, accessToken), req); err != nil { + return nil, err + } + result := &GetScheduleListResponse{} + err = util.DecodeWithError(response, result, "GetScheduleList") + return result, err +} + +// GetHardwareDataRequest 获取设备打卡数据请求 +type GetHardwareDataRequest struct { + FilterType int64 `json:"filter_type"` + StartTime int64 `json:"starttime"` + EndTime int64 `json:"endtime"` + UserIDList []string `json:"useridlist"` +} + +// GetHardwareDataResponse 获取设备打卡数据响应 +type GetHardwareDataResponse struct { + util.CommonError + CheckinData []HardwareCheckinData `json:"checkindata"` +} + +// HardwareCheckinData 设备打卡数据 +type HardwareCheckinData struct { + UserID string `json:"userid"` + CheckinTime int64 `json:"checkin_time"` + DeviceSn string `json:"device_sn"` + DeviceName string `json:"device_name"` +} + +// GetHardwareData 获取设备打卡数据 +// see https://developer.work.weixin.qq.com/document/path/94126 +func (r *Client) GetHardwareData(req *GetHardwareDataRequest) (*GetHardwareDataResponse, error) { + var ( + accessToken string + err error + ) + if accessToken, err = r.GetAccessToken(); err != nil { + return nil, err + } + var response []byte + if response, err = util.PostJSON(fmt.Sprintf(getHardwareDataURL, accessToken), req); err != nil { + return nil, err + } + result := &GetHardwareDataResponse{} + err = util.DecodeWithError(response, result, "GetHardwareData") + return result, err +}