Files
yunzerwebsiteallinone/go/controllers/app_oa_attendance.go
T
2026-11-16 17:22:50 +08:00

631 lines
18 KiB
Go

package controllers
import (
"encoding/json"
"errors"
"fmt"
"io"
"strings"
"time"
"server/models"
"server/pkg/identity"
"server/pkg/jwtutil"
approvalEngine "server/services/approval"
authSvc "server/services/auth"
"github.com/beego/beego/v2/client/orm"
)
func (c *AppOaController) oaAttendAppClaims() (*jwtutil.Claims, int, string) {
claims, err := c.oaClaims()
if err != nil {
code := identity.Status(err)
return nil, code, err.Error()
}
if claims.TenantId <= 0 {
return nil, 403, "当前账号未绑定企业,无法打卡"
}
return claims, 200, ""
}
func (c *AppOaController) oaAttendSelf(claims *jwtutil.Claims) (*models.BackendEmployee, string) {
tid := uint64(claims.TenantId)
uid := uint64(claims.UserID)
if employee, ok := findSelfEmployee(tid, uid, claims.Username); ok {
return &employee, employee.Name
}
name := strings.TrimSpace(claims.Username)
if bind, err := authSvc.GetTenantUser(uid, tid); err == nil && bind != nil {
if v := authBindValue(bind.Name); v != "" {
name = v
} else if v := authBindValue(bind.Account); v != "" {
name = v
}
}
return nil, name
}
func oaAttendEmployeeMap(tid uint64, employee *models.BackendEmployee, fallbackName string) map[string]interface{} {
if employee == nil {
return map[string]interface{}{
"id": 0, "name": fallbackName, "account": "",
"org_id": 0, "org_name": "", "position": "", "bound": false,
}
}
orgID := scEmployeeDepartmentID(*employee)
position := ""
if employee.Position != nil {
position = strings.TrimSpace(*employee.Position)
}
return map[string]interface{}{
"id": employee.ID,
"name": employee.Name,
"account": employee.Account,
"org_id": orgID,
"org_name": oaAttendOrgName(tid, orgID),
"position": position,
"bound": true,
}
}
func oaAttendEntryMap(entry *models.OaScheduleEntry) map[string]interface{} {
if entry == nil {
return nil
}
return map[string]interface{}{
"id": entry.ID,
"shift_id": entry.ShiftID,
"shift_name": entry.ShiftName,
"short_name": entry.ShortName,
"color": entry.Color,
"work_start": entry.WorkStart,
"work_end": entry.WorkEnd,
"shift_text": oaAttendShiftText(entry.WorkStart, entry.WorkEnd),
"source": entry.Source,
"note": entry.Note,
}
}
func oaAttendTodayWarning(entry *models.OaScheduleEntry, employee *models.BackendEmployee) string {
if entry != nil {
return ""
}
if employee == nil {
return "未匹配到你的员工档案与今日排班,仍可签到,签到后将标记为「无排班打卡」"
}
return "今日未匹配到排班,仍可签到,签到后将标记为「无排班打卡」,请联系管理员核对排班"
}
func oaAttendRecentDays(tid, uid uint64, employeeID uint, endDate string, days int) []map[string]interface{} {
if days < 1 || days > 31 {
days = 7
}
startDate := nextOaDate(endDate, -(days - 1))
if startDate == "" {
startDate = endDate
}
entries := map[string]*models.OaScheduleEntry{}
if employeeID > 0 {
var entryRows []models.OaScheduleEntry
_, _ = models.Orm.QueryTable(new(models.OaScheduleEntry)).
Filter("tid", tid).
Filter("employee_id", employeeID).
Filter("is_deleted", 0).
Filter("schedule_date__gte", startDate).
Filter("schedule_date__lte", endDate).
All(&entryRows)
for i := range entryRows {
entries[normalizeOaDate(entryRows[i].ScheduleDate)] = &entryRows[i]
}
}
records := map[string]*models.OaAttendance{}
qs := oaAttendQuery(tid).
Filter("attend_date__gte", startDate).
Filter("attend_date__lte", endDate)
if employeeID > 0 {
qs = qs.Filter("employee_id", employeeID)
} else if uid > 0 {
qs = qs.Filter("uid", uid)
}
var recordRows []models.OaAttendance
_, _ = qs.All(&recordRows)
for i := range recordRows {
records[normalizeOaDate(recordRows[i].AttendDate)] = &recordRows[i]
}
list := make([]map[string]interface{}, 0, days)
today := time.Now().Format("2006-01-02")
for date := startDate; date != "" && date <= endDate; date = nextOaDate(date, 1) {
entry := entries[date]
record := records[date]
item := map[string]interface{}{
"date": date,
"weekday": oaAttendWeekday(date),
"is_today": date == today,
"has_schedule": entry != nil,
"matched": entry != nil,
"shift_name": "",
"shift_text": "",
"color": "",
"clock_in_hm": "",
"clock_out_hm": "",
"day_status": oaDayStatusRest,
"day_status_text": "休息",
}
if entry != nil {
item["shift_name"] = entry.ShiftName
item["shift_text"] = oaAttendShiftText(entry.WorkStart, entry.WorkEnd)
item["color"] = entry.Color
}
if record != nil {
view := oaAttendView(record)
item["shift_name"] = view.ShiftName
item["shift_text"] = view.ShiftText
item["color"] = view.Color
item["clock_in_hm"] = view.ClockInHm
item["clock_out_hm"] = view.ClockOutHm
item["day_status"] = view.DayStatus
item["day_status_text"] = view.DayStatusText
item["has_schedule"] = entry != nil || view.MatchStatus == models.OaAttendMatchOK
} else if entry != nil {
item["day_status"] = oaDayStatusMissing
item["day_status_text"] = "未打卡"
}
list = append(list, item)
}
for i, j := 0, len(list)-1; i < j; i, j = i+1, j-1 {
list[i], list[j] = list[j], list[i]
}
return list
}
func oaAttendPersonalStats(tid, uid uint64, employeeID uint, startDate, endDate string) map[string]interface{} {
baseCond := func() *orm.Condition {
cond := orm.NewCondition().
And("tid", tid).
And("attend_date__gte", startDate).
And("attend_date__lte", endDate)
if employeeID > 0 {
cond = cond.And("employee_id", employeeID)
} else {
cond = cond.And("uid", uid)
}
return cond
}
countWith := func(extra *orm.Condition) int64 {
cond := baseCond()
if extra != nil {
cond = cond.AndCond(extra)
}
n, _ := models.Orm.QueryTable(new(models.OaAttendance)).SetCond(cond).Count()
return n
}
scheduled := 0
if employeeID > 0 {
n, _ := models.Orm.QueryTable(new(models.OaScheduleEntry)).
Filter("tid", tid).
Filter("employee_id", employeeID).
Filter("is_deleted", 0).
Filter("schedule_date__gte", startDate).
Filter("schedule_date__lte", endDate).
Count()
scheduled = int(n)
}
clocked := countWith(orm.NewCondition().And("clock_in_time__isnull", false))
late := countWith(orm.NewCondition().And("clock_in_status", models.OaAttendClockLate))
early := countWith(orm.NewCondition().And("clock_out_status", models.OaAttendClockLate))
noSchedule := countWith(orm.NewCondition().And("match_status", models.OaAttendMatchMissing))
matchedClocked := countWith(orm.NewCondition().
And("clock_in_time__isnull", false).
And("match_status", models.OaAttendMatchOK))
missing := scheduled - int(matchedClocked)
if missing < 0 {
missing = 0
}
rate := 0
if scheduled > 0 {
rate = int(matchedClocked) * 100 / scheduled
}
return map[string]interface{}{
"scheduled": scheduled,
"clocked": clocked,
"late": late,
"early": early,
"noschedule": noSchedule,
"missing": missing,
"attendance_rate": rate,
}
}
func (c *AppOaController) AttendanceToday() {
claims, code, msg := c.oaAttendAppClaims()
if msg != "" {
c.oaErr(code, code, msg)
return
}
tid := uint64(claims.TenantId)
uid := uint64(claims.UserID)
days, _ := c.GetInt("days", 7)
now := time.Now()
date := now.Format("2006-01-02")
employee, fallbackName := c.oaAttendSelf(claims)
employeeID := uint(0)
if employee != nil {
employeeID = employee.ID
}
entry := oaAttendEntryOf(tid, employeeID, date)
record := oaAttendFind(tid, date, employeeID, uid)
var recordView interface{}
if record != nil {
recordView = oaAttendView(record)
}
canClockIn := record == nil || record.ClockInTime == nil
canClockOut := record == nil || record.ClockOutTime == nil
monthStart := time.Date(now.Year(), now.Month(), 1, 0, 0, 0, 0, now.Location()).Format("2006-01-02")
c.oaOk(map[string]interface{}{
"date": date,
"now": now.Format("2006-01-02 15:04:05"),
"employee": oaAttendEmployeeMap(tid, employee, fallbackName),
"entry": oaAttendEntryMap(entry),
"record": recordView,
"matched": entry != nil,
"warning": oaAttendTodayWarning(entry, employee),
"can_clock_in": canClockIn,
"can_clock_out": canClockOut,
"recent": oaAttendRecentDays(tid, uid, employeeID, date, days),
"stats": oaAttendPersonalStats(tid, uid, employeeID, monthStart, date),
})
}
func (c *AppOaController) AttendanceClock() {
claims, code, msg := c.oaAttendAppClaims()
if msg != "" {
c.oaErr(code, code, msg)
return
}
var payload struct {
Type string `json:"type"`
Location string `json:"location"`
Remark string `json:"remark"`
}
if raw, readErr := io.ReadAll(c.Ctx.Request.Body); readErr == nil && len(raw) > 0 {
if json.Unmarshal(raw, &payload) != nil {
c.oaErr(400, 400, "参数错误")
return
}
}
employee, fallbackName := c.oaAttendSelf(claims)
result, code, msg := oaAttendPunch(uint64(claims.TenantId), uint64(claims.UserID), employee, oaAttendPunchInput{
Type: payload.Type,
Location: strings.TrimSpace(payload.Location),
Remark: strings.TrimSpace(payload.Remark),
FallbackName: fallbackName,
})
if msg != "" {
c.oaErr(code, code, msg)
return
}
c.oaOk(map[string]interface{}{
"record": result.View,
"warning": result.Warning,
"duplicated": result.Duplicated,
"message": result.Message,
})
}
func (c *AppOaController) AttendanceFixSubmit() {
claims, code, msg := c.oaAttendAppClaims()
if msg != "" {
c.oaErr(code, code, msg)
return
}
var payload struct {
RecordID uint64 `json:"record_id"`
FixType int8 `json:"fix_type"`
FixTime string `json:"fix_time"`
Reason string `json:"reason"`
}
if raw, readErr := io.ReadAll(c.Ctx.Request.Body); readErr == nil && len(raw) > 0 {
if json.Unmarshal(raw, &payload) != nil {
c.oaErr(400, 400, "参数错误")
return
}
}
if payload.RecordID == 0 {
c.oaErr(400, 400, "缺少考勤记录")
return
}
if payload.FixType != models.OaAttendFixTypeIn && payload.FixType != models.OaAttendFixTypeOut {
c.oaErr(400, 400, "请选择补卡类型")
return
}
reason := strings.TrimSpace(payload.Reason)
if reason == "" {
c.oaErr(400, 400, "请填写补卡原因")
return
}
fixTime := strings.TrimSpace(payload.FixTime)
if fixTime != "" {
if _, err := time.Parse("15:04", fixTime); err != nil {
c.oaErr(400, 400, "补卡时间格式应为 HH:mm")
return
}
}
tid := uint64(claims.TenantId)
uid := uint64(claims.UserID)
var row models.OaAttendance
if err := models.Orm.QueryTable(new(models.OaAttendance)).
Filter("id", payload.RecordID).Filter("tid", tid).One(&row); err != nil {
c.oaErr(404, 404, "考勤记录不存在")
return
}
employee, _ := c.oaAttendSelf(claims)
isMine := row.Uid == uid || (employee != nil && row.EmployeeID > 0 && row.EmployeeID == employee.ID)
if !isMine {
c.oaErr(403, 403, "只能申请本人的补卡")
return
}
if row.FixStatus == models.OaAttendFixRunning {
c.oaErr(400, 400, "该记录已有补卡申请在审批中")
return
}
if row.FixStatus == models.OaAttendFixApproved {
c.oaErr(400, 400, "该记录已补卡成功,无需重复申请")
return
}
attendDate := normalizeOaDate(row.AttendDate)
if attendDate > time.Now().Format("2006-01-02") {
c.oaErr(400, 400, "未来日期无法补卡")
return
}
abnormal := false
needFixTime := false
if payload.FixType == models.OaAttendFixTypeIn {
abnormal = row.ClockInTime == nil || row.ClockInStatus == models.OaAttendClockLate ||
row.ClockInStatus == models.OaAttendClockNoShift || row.ClockInStatus == models.OaAttendClockOffTime
needFixTime = row.ClockInTime == nil
} else {
abnormal = row.ClockOutTime == nil || row.ClockOutStatus == models.OaAttendClockLate ||
row.ClockOutStatus == models.OaAttendClockNoShift || row.ClockOutStatus == models.OaAttendClockOffTime
needFixTime = row.ClockOutTime == nil
}
if !abnormal {
c.oaErr(400, 400, "当前打卡状态正常,无需补卡")
return
}
if needFixTime && fixTime == "" {
c.oaErr(400, 400, "缺卡补卡请填写实际打卡时间")
return
}
submitUID := oaApprovalSubmitUID(claims)
var deptID uint64
var tu models.SystemTenantUser
if models.Orm.QueryTable(new(models.SystemTenantUser)).
Filter("uid", submitUID).Filter("tid", tid).
Filter("delete_time__isnull", true).One(&tu) == nil {
deptID = tu.OrgID
}
fixTypeText := "签到补卡"
if payload.FixType == models.OaAttendFixTypeOut {
fixTypeText = "签退补卡"
}
title := fmt.Sprintf("考勤补卡 · %s %s", attendDate, fixTypeText)
instID, err := approvalEngine.Submit(approvalEngine.SubmitInput{
Scope: models.ApprovalScopeTenant,
Tid: tid,
BizType: models.ApprovalBizAttendanceFix,
BizID: row.ID,
BizTitle: title,
SubmitUID: submitUID,
SubmitName: oaApprovalUserName(c, claims),
DeptID: deptID,
FormData: map[string]interface{}{
"attend_date": attendDate,
"fix_type": payload.FixType,
"fix_type_text": fixTypeText,
"fix_time": fixTime,
"reason": reason,
"employee_name": row.EmployeeName,
"shift_name": row.ShiftName,
"work_start": row.WorkStart,
"work_end": row.WorkEnd,
"clock_in_hm": oaAttendTimeHm(row.ClockInTime),
"clock_out_hm": oaAttendTimeHm(row.ClockOutTime),
"apply_user_name": oaApprovalUserName(c, claims),
},
})
if err != nil {
var noFlow *approvalEngine.ErrNoFlow
if errors.As(err, &noFlow) {
c.oaErr(400, 400, "补卡审批流未配置,请联系管理员在「审批流配置」中启用考勤补卡")
return
}
c.oaErr(400, 400, err.Error())
return
}
instStatus := int8(models.ApprovalInstanceRunning)
var inst models.ApprovalInstance
if models.Orm.QueryTable(new(models.ApprovalInstance)).
Filter("id", instID).One(&inst, "status") == nil {
instStatus = inst.Status
}
fixStatus := models.OaAttendFixRunning
message := "补卡申请已提交,等待审批"
switch instStatus {
case models.ApprovalInstanceApproved:
fixStatus = models.OaAttendFixApproved
message = "补卡审批已通过,考勤记录已恢复正常"
case models.ApprovalInstanceRejected:
fixStatus = models.OaAttendFixRejected
case models.ApprovalInstanceWithdrawn, models.ApprovalInstanceCanceled:
fixStatus = models.OaAttendFixWithdrawn
}
_, _ = models.Orm.QueryTable(new(models.OaAttendance)).
Filter("id", row.ID).
Update(orm.Params{
"fix_status": fixStatus,
"fix_type": payload.FixType,
"fix_instance_id": instID,
"fix_time": fixTime,
"fix_reason": reason,
"update_time": time.Now(),
})
c.oaOk(map[string]interface{}{
"instance_id": instID,
"fix_status": fixStatus,
"message": message,
})
}
func oaAttendTimeHm(t *time.Time) string {
if t == nil {
return ""
}
return t.Format("15:04")
}
func (c *AppOaController) AttendanceRecords() {
claims, code, msg := c.oaAttendAppClaims()
if msg != "" {
c.oaErr(code, code, msg)
return
}
tid := uint64(claims.TenantId)
uid := uint64(claims.UserID)
page, _ := c.GetInt("page", 1)
pageSize, _ := c.GetInt("pageSize", 20)
if page < 1 {
page = 1
}
if pageSize < 1 || pageSize > 100 {
pageSize = 20
}
now := time.Now()
startDate := strings.TrimSpace(c.GetString("start_date"))
endDate := strings.TrimSpace(c.GetString("end_date"))
if startDate == "" || endDate == "" {
startDate = time.Date(now.Year(), now.Month(), 1, 0, 0, 0, 0, now.Location()).Format("2006-01-02")
endDate = now.Format("2006-01-02")
}
dates, msg := scDateSpan(startDate, endDate)
if msg != "" {
c.oaErr(400, 400, msg)
return
}
if len(dates) > oaAttendMaxRangeDays {
c.oaErr(400, 400, "单次最多查询 92 天")
return
}
employee, _ := c.oaAttendSelf(claims)
employeeID := uint(0)
if employee != nil {
employeeID = employee.ID
}
cond := orm.NewCondition().
And("tid", tid).
And("attend_date__gte", startDate).
And("attend_date__lte", endDate)
if employeeID > 0 {
cond = cond.And("employee_id", employeeID)
} else {
cond = cond.And("uid", uid)
}
qs := models.Orm.QueryTable(new(models.OaAttendance)).SetCond(cond)
total, _ := qs.Count()
var rows []models.OaAttendance
_, queryErr := qs.OrderBy("-attend_date", "id").
Limit(pageSize).Offset((page - 1) * pageSize).All(&rows)
if queryErr != nil && queryErr != orm.ErrNoRows {
c.oaErr(500, 500, "查询考勤记录失败")
return
}
list := make([]oaAttendanceView, 0, len(rows))
for i := range rows {
list = append(list, oaAttendView(&rows[i]))
}
c.oaOk(map[string]interface{}{
"list": list,
"total": total,
"start_date": startDate,
"end_date": endDate,
"stats": oaAttendPersonalStats(tid, uid, employeeID, startDate, endDate),
})
}
func (c *AppOaController) AttendanceStats() {
claims, code, msg := c.oaAttendAppClaims()
if msg != "" {
c.oaErr(code, code, msg)
return
}
tid := uint64(claims.TenantId)
uid := uint64(claims.UserID)
period := strings.ToLower(strings.TrimSpace(c.GetString("period")))
if period != "month" && period != "quarter" && period != "year" {
period = "month"
}
anchor := strings.TrimSpace(c.GetString("date"))
if !isValidOaDate(anchor) {
anchor = time.Now().Format("2006-01-02")
}
startDate, endDate, label, rangeOK := oaAttendPeriodRange(period, anchor)
if !rangeOK {
c.oaErr(400, 400, "日期参数无效")
return
}
endDate = oaAttendClampRange(startDate, endDate)
employee, _ := c.oaAttendSelf(claims)
employeeID := uint(0)
if employee != nil {
employeeID = employee.ID
}
c.oaOk(map[string]interface{}{
"period": period,
"label": label,
"anchor": anchor,
"start_date": startDate,
"end_date": endDate,
"stats": oaAttendPersonalStats(tid, uid, employeeID, startDate, endDate),
})
}