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();
}
}
}
}