using System; using System.Collections.Generic; using System.Globalization; using System.Linq; using NCC.Extend.Entitys.Dto.LqAttendanceRecord; using NCC.Extend.Entitys.Enum; using NCC.Extend.Entitys.lq_attendance_group; using NCC.Extend.Entitys.lq_attendance_record; using Newtonsoft.Json; using Newtonsoft.Json.Linq; namespace NCC.Extend { /// /// 半天假边界与考勤打卡时段解析(依赖考勤分组上午下班/下午上班配置)。 /// public static class AttendanceHalfDayLeaveHelper { private const string DefaultAmWorkEnd = "12:00"; private const string DefaultPmWorkStart = "13:00"; private const string DayHalfPeriodMarker = "[dayHalfPeriod:"; private static readonly TimeSpan CalendarHalfSplit = new TimeSpan(12, 0, 0); /// /// 半天假覆盖时段:无 / 上午 / 下午。 /// public enum HalfLeavePeriod { None = 0, Am = 1, Pm = 2 } /// /// 从考勤记录关联流程 JSON 解析当日半天假时段(优先 halfPeriod 字段,兼容旧数据再反推)。 /// public static HalfLeavePeriod ResolveFromRecord(LqAttendanceRecordEntity record, LqAttendanceGroupEntity group) { if (record == null) { return HalfLeavePeriod.None; } foreach (var item in GetActiveLeaveWorkflows(record.RelatedWorkflowsJson)) { if (item.leaveFraction.HasValue && item.leaveFraction.Value >= 1m) { return HalfLeavePeriod.None; } var explicitPeriod = ParseHalfPeriodToken(item.halfPeriod); if (explicitPeriod != HalfLeavePeriod.None) { return explicitPeriod; } if (item.leaveFraction.HasValue && item.leaveFraction.Value > 0m && item.leaveFraction.Value < 1m) { var fromRemark = InferHalfPeriodFromRemark(item.remark); if (fromRemark != HalfLeavePeriod.None) { return fromRemark; } } } return HalfLeavePeriod.None; } /// /// 是否存在有效半天请假流程(leaveFraction 为 (0,1))。 /// public static bool HasActiveHalfDayLeave(LqAttendanceRecordEntity record) { return ResolveFromRecord(record, null) != HalfLeavePeriod.None; } /// /// 是否存在可销假的请假流程项。 /// public static bool HasActiveLeaveWorkflow(string relatedWorkflowsJson) { return GetActiveLeaveWorkflows(relatedWorkflowsJson).Any(); } /// /// 重算考勤记录时传入 ResolveAttendanceStatus 的 requestedStatus。 /// 半天假覆盖日不得锁死历史旷工/缺卡/待考勤;全天请假(4/5)仍保持流程同步保护。 /// public static int ResolveRecalculationRequestedStatus( int currentStatus, HalfLeavePeriod halfLeave, bool leaveSyncedButCancelledInRemark, bool pendingAttendanceExpired, bool futureDayMissingShouldBePending) { if (leaveSyncedButCancelledInRemark || pendingAttendanceExpired || futureDayMissingShouldBePending) { return (int)AttendanceRecordStatusEnum.正常; } if (halfLeave != HalfLeavePeriod.None && currentStatus != (int)AttendanceRecordStatusEnum.请假 && currentStatus != (int)AttendanceRecordStatusEnum.病假) { return (int)AttendanceRecordStatusEnum.正常; } return currentStatus; } /// /// 解析关联流程中的请假项。 /// public static List GetActiveLeaveWorkflows(string relatedWorkflowsJson) { return ParseRelatedWorkflows(relatedWorkflowsJson) .Where(x => x != null && string.Equals(x.type, "请假", StringComparison.Ordinal)) .ToList(); } /// /// 计算请假在某自然日的折算天数(0 / 0.5 / 1)。 /// public static decimal GetLeaveFractionForDay( DateTime? leaveStartTime, DateTime? leaveEndTime, string leaveDayCount, DateTime day, LqAttendanceGroupEntity group, string explicitDayHalfPeriod = null) { if (!leaveStartTime.HasValue || !leaveEndTime.HasValue) { return 0m; } var d = day.Date; var startDate = leaveStartTime.Value.Date; var endDate = leaveEndTime.Value.Date; if (d < startDate || d > endDate) { return 0m; } if (!TryParseLeaveDays(leaveDayCount, out var totalDays) || totalDays <= 0m) { return 0m; } var calendarDays = (endDate - startDate).Days + 1; var fullDays = (int)Math.Floor(totalDays); var hasHalf = totalDays - fullDays >= 0.5m; if (startDate == endDate) { if (totalDays >= 1m) { return 1m; } if (totalDays >= 0.5m) { return 0.5m; } return totalDays; } if (!hasHalf) { return 1m; } var halfDayDate = ResolveHalfDayDate(startDate, endDate, totalDays, leaveStartTime.Value, leaveEndTime.Value, explicitDayHalfPeriod); return d == halfDayDate ? 0.5m : 1m; } /// /// 计算请假在某自然日的半天时段(仅 fraction=0.5 时有意义)。 /// public static HalfLeavePeriod GetHalfPeriodForDay( DateTime? leaveStartTime, DateTime? leaveEndTime, string leaveDayCount, DateTime day, LqAttendanceGroupEntity group, string explicitDayHalfPeriod = null) { var fraction = GetLeaveFractionForDay( leaveStartTime, leaveEndTime, leaveDayCount, day, group, explicitDayHalfPeriod); if (fraction < 0.5m || fraction >= 1m) { return HalfLeavePeriod.None; } var explicitPeriod = ParseHalfPeriodToken(explicitDayHalfPeriod); if (explicitPeriod != HalfLeavePeriod.None) { return explicitPeriod; } return InferHalfPeriodForFractionDay( day.Date, leaveStartTime.Value, leaveEndTime.Value, explicitDayHalfPeriod); } /// /// 将半天时段编码为流程 JSON 字段值。 /// public static string EncodeHalfPeriod(HalfLeavePeriod period) { return period switch { HalfLeavePeriod.Am => "am", HalfLeavePeriod.Pm => "pm", _ => null }; } /// /// 在 Description 中嵌入 dayHalfPeriod(am/pm),供请假单落库后同步考勤时优先读取。 /// public static string EmbedDayHalfPeriodInDescription(string description, string dayHalfPeriod) { var cleaned = StripDayHalfPeriodFromDescription(description); if (string.IsNullOrWhiteSpace(dayHalfPeriod)) { return cleaned; } var token = ParseHalfPeriodToken(dayHalfPeriod); if (token == HalfLeavePeriod.None) { return cleaned; } var suffix = $"{DayHalfPeriodMarker}{EncodeHalfPeriod(token)}]"; return string.IsNullOrWhiteSpace(cleaned) ? suffix : $"{cleaned} {suffix}"; } /// /// 从 Description 解析 dayHalfPeriod。 /// public static string ParseDayHalfPeriodFromDescription(string description) { if (string.IsNullOrWhiteSpace(description)) { return null; } var startIdx = description.LastIndexOf(DayHalfPeriodMarker, StringComparison.Ordinal); if (startIdx < 0) { return null; } var endIdx = description.IndexOf(']', startIdx); if (endIdx <= startIdx) { return null; } var inner = description.Substring(startIdx + DayHalfPeriodMarker.Length, endIdx - startIdx - DayHalfPeriodMarker.Length); var token = ParseHalfPeriodToken(inner); return token == HalfLeavePeriod.None ? null : EncodeHalfPeriod(token); } /// /// 移除 Description 中的 dayHalfPeriod 标记。 /// public static string StripDayHalfPeriodFromDescription(string description) { if (string.IsNullOrWhiteSpace(description)) { return description; } var startIdx = description.LastIndexOf(DayHalfPeriodMarker, StringComparison.Ordinal); if (startIdx < 0) { return description.Trim(); } return description.Substring(0, startIdx).TrimEnd(); } public static DateTime? ResolveWorkStart(DateTime day, LqAttendanceGroupEntity group) { return ParseWorkTime(day, group?.WorkStartTime); } public static DateTime? ResolveWorkEnd(DateTime day, LqAttendanceGroupEntity group) { return ParseWorkTime(day, group?.WorkEndTime); } public static DateTime? ResolveAmWorkEnd(DateTime day, LqAttendanceGroupEntity group) { return ParseWorkTime(day, string.IsNullOrWhiteSpace(group?.AmWorkEndTime) ? DefaultAmWorkEnd : group.AmWorkEndTime); } public static DateTime? ResolvePmWorkStart(DateTime day, LqAttendanceGroupEntity group) { return ParseWorkTime(day, string.IsNullOrWhiteSpace(group?.PmWorkStartTime) ? DefaultPmWorkStart : group.PmWorkStartTime); } /// /// 按半天假调整有效上下班标准时刻(用于迟到/早退判定)。 /// public static void ResolveEffectiveStandards( DateTime attendanceDate, LqAttendanceGroupEntity group, HalfLeavePeriod halfLeave, out DateTime? effectiveStart, out DateTime? effectiveEnd) { effectiveStart = ResolveWorkStart(attendanceDate, group); effectiveEnd = ResolveWorkEnd(attendanceDate, group); if (halfLeave == HalfLeavePeriod.Am) { effectiveStart = ResolvePmWorkStart(attendanceDate, group); } else if (halfLeave == HalfLeavePeriod.Pm) { effectiveEnd = ResolveAmWorkEnd(attendanceDate, group); } } private static DateTime ResolveHalfDayDate( DateTime startDate, DateTime endDate, decimal totalDays, DateTime leaveStartTime, DateTime leaveEndTime, string explicitDayHalfPeriod) { if (startDate == endDate) { return startDate; } // 与前端 computeLeaveRangeNaturalDay 一致:跨日且含 0.5 天时,半日落在结束日 return endDate; } private static HalfLeavePeriod InferHalfPeriodForFractionDay( DateTime day, DateTime leaveStartTime, DateTime leaveEndTime, string explicitDayHalfPeriod) { var explicitPeriod = ParseHalfPeriodToken(explicitDayHalfPeriod); if (explicitPeriod != HalfLeavePeriod.None) { return explicitPeriod; } if (leaveStartTime.Date == leaveEndTime.Date) { return InferHalfPeriodFromSingleDayTimes(leaveStartTime, leaveEndTime); } if (day.Date == leaveEndTime.Date) { if (leaveEndTime.TimeOfDay <= new TimeSpan(11, 59, 59)) { return HalfLeavePeriod.Am; } if (leaveEndTime.TimeOfDay >= CalendarHalfSplit) { return HalfLeavePeriod.Pm; } } if (day.Date == leaveStartTime.Date && leaveStartTime.TimeOfDay >= CalendarHalfSplit) { return HalfLeavePeriod.Pm; } return InferHalfPeriodFromRemark(null); } private static HalfLeavePeriod InferHalfPeriodFromSingleDayTimes(DateTime leaveStartTime, DateTime leaveEndTime) { if (leaveStartTime.TimeOfDay >= CalendarHalfSplit) { return HalfLeavePeriod.Pm; } if (leaveEndTime.TimeOfDay <= new TimeSpan(11, 59, 59)) { return HalfLeavePeriod.Am; } var midpoint = leaveStartTime.TimeOfDay + TimeSpan.FromTicks((leaveEndTime.TimeOfDay - leaveStartTime.TimeOfDay).Ticks / 2); return midpoint < CalendarHalfSplit ? HalfLeavePeriod.Am : HalfLeavePeriod.Pm; } private static HalfLeavePeriod ParseHalfPeriodToken(string token) { if (string.IsNullOrWhiteSpace(token)) { return HalfLeavePeriod.None; } if (string.Equals(token, "am", StringComparison.OrdinalIgnoreCase)) { return HalfLeavePeriod.Am; } if (string.Equals(token, "pm", StringComparison.OrdinalIgnoreCase)) { return HalfLeavePeriod.Pm; } return HalfLeavePeriod.None; } private static HalfLeavePeriod InferHalfPeriodFromRemark(string remark) { if (string.IsNullOrWhiteSpace(remark)) { return HalfLeavePeriod.Am; } if (remark.IndexOf("下午", StringComparison.Ordinal) >= 0 || remark.IndexOf("PM", StringComparison.OrdinalIgnoreCase) >= 0) { return HalfLeavePeriod.Pm; } if (remark.IndexOf("上午", StringComparison.Ordinal) >= 0 || remark.IndexOf("AM", StringComparison.OrdinalIgnoreCase) >= 0) { return HalfLeavePeriod.Am; } return HalfLeavePeriod.Am; } private static bool TryParseLeaveDays(string leaveDayCount, out decimal leaveDays) { leaveDays = 0m; if (string.IsNullOrWhiteSpace(leaveDayCount)) { return false; } if (decimal.TryParse(leaveDayCount, NumberStyles.Any, CultureInfo.InvariantCulture, out leaveDays)) { return true; } return decimal.TryParse(leaveDayCount, NumberStyles.Any, CultureInfo.CurrentCulture, out leaveDays); } private static DateTime? ParseWorkTime(DateTime day, string timeText) { if (string.IsNullOrWhiteSpace(timeText)) { return null; } if (!TimeSpan.TryParseExact(timeText.Trim(), @"hh\:mm", CultureInfo.InvariantCulture, out var ts) && !TimeSpan.TryParse(timeText.Trim(), out ts)) { return null; } return day.Date.Add(ts); } private static List ParseRelatedWorkflows(string json) { if (string.IsNullOrWhiteSpace(json)) { return new List(); } try { var token = JToken.Parse(json); if (token is JArray arr) { return arr.ToObject>() ?? new List(); } } catch { // ignore } try { return JsonConvert.DeserializeObject>(json) ?? new List(); } catch { return new List(); } } } }