LqAttendanceSummaryService.cs
17.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Mapster;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using NCC.Common.Core.Manager;
using NCC.Common.Enum;
using NCC.Common.Filter;
using NCC.Dependency;
using NCC.DynamicApiController;
using NCC.Extend.Entitys.Dto.LqAttendanceSummary;
using NCC.Extend.Entitys.Enum;
using NCC.Extend.Entitys.lq_attendance_group;
using NCC.Extend.Entitys.lq_attendance_record;
using NCC.Extend.Entitys.lq_attendance_summary;
using NCC.Extend.Interfaces.LqAttendanceRecord;
using NCC.Extend.Interfaces.LqAttendanceSummary;
using NCC.FriendlyException;
using NCC.System.Entitys.Permission;
using SqlSugar;
using Yitter.IdGenerator;
namespace NCC.Extend
{
/// <summary>
/// 考勤汇总服务
/// </summary>
[ApiDescriptionSettings(Tag = "绿纤考勤汇总服务", Name = "LqAttendanceSummary", Order = 200)]
[Route("api/Extend/[controller]")]
public class LqAttendanceSummaryService : ILqAttendanceSummaryService, IDynamicApiController, ITransient
{
private readonly ISqlSugarClient _db;
private readonly IUserManager _userManager;
private readonly ILogger<LqAttendanceSummaryService> _logger;
private readonly ILqAttendanceRecordService _attendanceRecordService;
/// <summary>
/// 构造函数
/// </summary>
/// <param name="db">数据库客户端</param>
/// <param name="userManager">用户管理器</param>
/// <param name="logger">日志记录器</param>
/// <param name="attendanceRecordService">考勤打卡服务(从打卡记录汇总写入汇总表)</param>
public LqAttendanceSummaryService(
ISqlSugarClient db,
IUserManager userManager,
ILogger<LqAttendanceSummaryService> logger,
ILqAttendanceRecordService attendanceRecordService)
{
_db = db;
_userManager = userManager;
_logger = logger;
_attendanceRecordService = attendanceRecordService;
}
#region 从考勤打卡记录同步汇总
/// <summary>
/// 从考勤打卡记录按自然月重新汇总到 lq_attendance_summary(覆盖该月已有数据)
/// </summary>
/// <remarks>
/// 人选与月度考勤矩阵、员工花名册「当月在职」一致(见 Skill historical-on-job-inference):
/// 有当月有效汇总且员工状态为在职则入选;无汇总时按主档入职/离职边界推断。
/// 出勤/请假/休息天数按每日一条打卡记录(同日取最新一条)的状态统计:正常+迟到→出勤,请假+病假→请假,休息→休息。
/// 未来月不允许调用(仅认已有汇总)。
/// </remarks>
/// <param name="year">年</param>
/// <param name="month">月</param>
/// <param name="keyword">可选,与月度矩阵相同(姓名/账号/门店/分组)</param>
/// <param name="attendanceGroupId">可选考勤分组 ID</param>
/// <returns>同步结果</returns>
[HttpPost("SyncFromAttendanceRecords/{year}/{month}")]
public Task<dynamic> SyncFromAttendanceRecords(
int year,
int month,
[FromQuery] string keyword = null,
[FromQuery] string attendanceGroupId = null)
{
return _attendanceRecordService.SyncMonthSummaryFromAttendanceRecordsAsync(year, month, keyword, attendanceGroupId);
}
#endregion
#region 获取考勤汇总列表
/// <summary>
/// 获取考勤汇总列表
/// </summary>
/// <param name="input">请求参数</param>
/// <returns></returns>
[HttpGet("")]
public async Task<dynamic> GetList([FromQuery] LqAttendanceSummaryListQueryInput input)
{
var sidx = input.sidx == null ? "id" : input.sidx;
var sord = input.sort == null ? "desc" : input.sort;
var data = await _db.Queryable<LqAttendanceSummaryEntity>()
.Where(a => a.IsEffective == StatusEnum.有效.GetHashCode())
.WhereIF(!string.IsNullOrEmpty(input.UserId), a => a.UserId == input.UserId)
.WhereIF(input.Year.HasValue, a => a.Year == input.Year)
.WhereIF(input.Month.HasValue, a => a.Month == input.Month)
.WhereIF(input.EmployeeStatus.HasValue, a => a.EmployeeStatus == input.EmployeeStatus)
.Select(a => new LqAttendanceSummaryListOutput
{
id = a.Id,
userId = a.UserId,
userName = SqlFunc.Subqueryable<UserEntity>().Where(u => u.Id == a.UserId).Select(u => u.RealName),
year = a.Year,
month = a.Month,
employeeStatus = a.EmployeeStatus,
workDays = a.WorkDays,
leaveDays = a.LeaveDays,
restDays = a.RestDays,
remark = a.Remark,
createUser = a.CreateUser,
createUserName = SqlFunc.Subqueryable<UserEntity>().Where(u => u.Id == a.CreateUser).Select(u => u.RealName),
createTime = a.CreateTime,
updateUser = a.UpdateUser,
updateUserName = SqlFunc.Subqueryable<UserEntity>().Where(u => u.Id == a.UpdateUser).Select(u => u.RealName),
updateTime = a.UpdateTime,
isEffective = a.IsEffective,
})
.MergeTable()
.OrderBy(sidx + " " + input.sort)
.ToPagedListAsync(input.currentPage, input.pageSize);
var pageRows = data.list == null
? new List<LqAttendanceSummaryListOutput>()
: data.list.ToList();
await FillSummaryListDerivedFromRecordsAsync(pageRows);
return PageResult<LqAttendanceSummaryListOutput>.SqlSugarPageResult(data);
}
/// <summary>
/// 按分页结果从打卡记录补全:当月考勤组文案 + 应休/到岗/请假/迟到早退/旷工及可算扣款。
/// </summary>
private async Task FillSummaryListDerivedFromRecordsAsync(List<LqAttendanceSummaryListOutput> items)
{
if (items == null || items.Count == 0)
{
return;
}
var userIds = items.Select(x => x.userId).Where(x => !string.IsNullOrWhiteSpace(x)).Distinct().ToList();
if (userIds.Count == 0)
{
return;
}
var monthBounds = items.Select(x => (x.year, x.month)).Distinct().ToList();
var minStart = monthBounds.Min(m => new DateTime(m.year, m.month, 1));
var maxEnd = monthBounds.Max(m => new DateTime(m.year, m.month, 1).AddMonths(1));
var records = await _db.Queryable<LqAttendanceRecordEntity>()
.Where(x => x.IsEffective == StatusEnum.有效.GetHashCode())
.Where(x => x.AttendanceDate >= minStart && x.AttendanceDate < maxEnd)
.Where(x => userIds.Contains(x.UserId))
.ToListAsync();
var users = await _db.Queryable<UserEntity>()
.Where(u => userIds.Contains(u.Id) && u.DeleteMark == null)
.Select(u => new { u.Id, u.AttendanceGroupId })
.ToListAsync();
var groupIds = users.Select(u => u.AttendanceGroupId).Where(x => !string.IsNullOrWhiteSpace(x)).Distinct().ToList();
var groups = groupIds.Count == 0
? new List<LqAttendanceGroupEntity>()
: await _db.Queryable<LqAttendanceGroupEntity>()
.Where(g => groupIds.Contains(g.Id) && SqlFunc.IsNull(g.DeleteMark, 0) == 0)
.ToListAsync();
var groupById = groups.GroupBy(x => x.Id).ToDictionary(x => x.Key, x => x.First());
var groupNameById = groupById.ToDictionary(x => x.Key, x => x.Value.GroupName ?? string.Empty);
var monthlyRestByGroupId = groupById.ToDictionary(x => x.Key, x => x.Value.MonthlyRestDays);
var profileNameByUserId = users.ToDictionary(
u => u.Id,
u => !string.IsNullOrWhiteSpace(u.AttendanceGroupId) && groupNameById.TryGetValue(u.AttendanceGroupId, out var gn)
? gn
: string.Empty);
var profileMonthlyRestByUserId = users.ToDictionary(
u => u.Id,
u =>
{
if (string.IsNullOrWhiteSpace(u.AttendanceGroupId)
|| !monthlyRestByGroupId.TryGetValue(u.AttendanceGroupId, out var mr))
{
return 0;
}
return mr;
});
var recordsByUserMonth = records
.GroupBy(r => (r.UserId, r.AttendanceDate.Year, r.AttendanceDate.Month))
.ToDictionary(g => g.Key, g => g.ToList());
foreach (var item in items)
{
if (string.IsNullOrWhiteSpace(item.userId))
{
item.attendanceGroupDisplay = "无";
continue;
}
recordsByUserMonth.TryGetValue((item.userId, item.year, item.month), out var monthRecs);
profileNameByUserId.TryGetValue(item.userId, out var profileName);
item.attendanceGroupDisplay =
AttendanceMonthGroupDisplayHelper.BuildDisplay(monthRecs, profileName ?? string.Empty);
profileMonthlyRestByUserId.TryGetValue(item.userId, out var fallbackRest);
var perDay = AttendanceSummaryMonthMetricsHelper.CollapseToLatestPerDay(monthRecs);
var metrics = AttendanceSummaryMonthMetricsHelper.Compute(perDay, fallbackRest, null);
item.monthEntitledRestDays = metrics.EntitledRestDays;
item.monthOnDutyDays = metrics.OnDutyDays;
item.monthCompositeWorkDays = metrics.CompositeWorkDays;
item.monthPaidLeaveDays = metrics.PaidLeaveDays;
item.monthLeaveDaysTotal = metrics.LeaveDaysTotal;
item.monthLateEarlyDays = metrics.LateEarlyDays;
item.monthAbsenteeismDays = metrics.AbsenteeismDays;
item.monthLateDeductionAmount = metrics.LateDeductionAmount;
item.monthLeaveDeductionAmount = metrics.LeaveDeductionAmount;
item.monthAbsenteeismDeductionAmount = metrics.AbsenteeismDeductionAmount;
}
}
#endregion
#region 清空某一个月的数据
/// <summary>
/// 清空某一个月的数据
/// </summary>
/// <param name="year">年份</param>
/// <param name="month">月份</param>
/// <returns></returns>
[HttpDelete("DeleteByMonth/{year}/{month}")]
public async Task<dynamic> DeleteByMonth(string year, string month)
{
int yearInt = int.Parse(year);
int monthInt = int.Parse(month);
await _db.Deleteable<LqAttendanceSummaryEntity>().Where(p => p.Year == yearInt && p.Month == monthInt).ExecuteCommandAsync();
return new
{
success = true,
message = "清空成功"
};
}
#endregion
#region 生成健康师考勤模拟数据
/// <summary>
/// 生成健康师考勤模拟数据
/// </summary>
/// <remarks>
/// 为所有健康师生成指定年月的考勤模拟数据
///
/// 规则:
/// - 80%以上的健康师出勤天数 >= 21天
/// - 其他健康师出勤天数随机生成(0-20天)
/// - 员工状态默认为1(在职)
///
/// 示例请求:
/// ```json
/// {
/// "year": 2025,
/// "month": 11
/// }
/// ```
/// </remarks>
/// <param name="year">年份</param>
/// <param name="month">月份</param>
/// <returns>生成结果</returns>
/// <response code="200">成功生成考勤模拟数据</response>
/// <response code="400">参数错误</response>
/// <response code="500">生成失败</response>
[HttpPost("GenerateMockData/{year}/{month}")]
public async Task<dynamic> GenerateMockData(int year, int month)
{
try
{
// 验证参数
if (year < 2000 || year > 3000)
{
throw NCCException.Oh("年份参数无效");
}
if (month < 1 || month > 12)
{
throw NCCException.Oh("月份参数无效,应在1-12之间");
}
// 查询所有健康师
var healthCoaches = await _db.Queryable<UserEntity>()
.Where(u => u.Gw == "健康师" && u.EnabledMark == 1 && (u.DeleteMark == null || u.DeleteMark == 0))
.Select(u => new { u.Id, u.RealName })
.ToListAsync();
if (!healthCoaches.Any())
{
throw NCCException.Oh("未找到健康师用户");
}
// 检查是否已存在该年月的考勤数据
var existingRecords = await _db.Queryable<LqAttendanceSummaryEntity>()
.Where(a => a.Year == year && a.Month == month)
.CountAsync();
if (existingRecords > 0)
{
throw NCCException.Oh($"已存在{year}年{month}月的考勤数据,请先清空后再生成");
}
var totalCount = healthCoaches.Count;
var highAttendanceCount = (int)Math.Ceiling(totalCount * 0.8); // 80%以上,向上取整
var lowAttendanceCount = totalCount - highAttendanceCount;
var random = new Random();
var entitiesToInsert = new List<LqAttendanceSummaryEntity>();
var now = DateTime.Now;
// 生成考勤数据
for (int i = 0; i < totalCount; i++)
{
var healthCoach = healthCoaches[i];
decimal workDays;
decimal leaveDays;
decimal restDays;
if (i < highAttendanceCount)
{
// 80%以上的健康师:出勤天数 >= 21天
workDays = random.Next(21, 31); // 21-30天
var remainingDays = 30 - workDays;
// 剩余天数分配给请假和休息
if (remainingDays > 0)
{
leaveDays = random.Next(0, (int)remainingDays + 1);
restDays = remainingDays - leaveDays;
}
else
{
leaveDays = 0;
restDays = 0;
}
}
else
{
// 其他20%的健康师:出勤天数 < 21天
workDays = random.Next(0, 21); // 0-20天
var remainingDays = 30 - workDays;
// 剩余天数分配给请假和休息
if (remainingDays > 0)
{
leaveDays = random.Next(0, (int)remainingDays + 1);
restDays = remainingDays - leaveDays;
}
else
{
leaveDays = 0;
restDays = 0;
}
}
var entity = new LqAttendanceSummaryEntity
{
Id = YitIdHelper.NextId().ToString(),
UserId = healthCoach.Id,
Year = year,
Month = month,
EmployeeStatus = 1, // 在职
WorkDays = workDays,
LeaveDays = leaveDays,
RestDays = restDays,
Remark = "模拟数据",
CreateUser = _userManager.UserId ?? "system",
CreateTime = now,
UpdateUser = _userManager.UserId ?? "system",
UpdateTime = now,
IsEffective = 1
};
entitiesToInsert.Add(entity);
}
// 批量插入
await _db.Insertable(entitiesToInsert).ExecuteCommandAsync();
// 统计结果
var highAttendanceActual = entitiesToInsert.Count(e => e.WorkDays >= 21);
var highAttendancePercentage = (decimal)highAttendanceActual / totalCount * 100;
return new
{
success = true,
message = "生成考勤模拟数据成功",
data = new
{
year = year,
month = month,
totalCount = totalCount,
highAttendanceCount = highAttendanceActual,
highAttendancePercentage = Math.Round(highAttendancePercentage, 2),
generatedCount = entitiesToInsert.Count
}
};
}
catch (Exception ex)
{
_logger.LogError(ex, $"生成健康师考勤模拟数据失败 - 年份: {year}, 月份: {month}");
throw NCCException.Oh($"生成健康师考勤模拟数据失败:{ex.Message}");
}
}
#endregion
}
}