AdoS0EmployeesController.cs 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231
  1. using Admin.NET.Plugin.AiDOP.Dto.S0.Warehouse;
  2. using Admin.NET.Plugin.AiDOP.Entity;
  3. using Admin.NET.Plugin.AiDOP.Entity.S0.Warehouse;
  4. using Admin.NET.Plugin.AiDOP.Infrastructure;
  5. namespace Admin.NET.Plugin.AiDOP.Controllers.S0.Warehouse;
  6. /// <summary>
  7. /// S0 雇员主数据(EmployeeMaster 语义)。
  8. /// 多租户隔离:所有读写显式限定当前请求租户;部门父校验与部门名补显均限定当前租户;不依赖全局 AOP。
  9. /// </summary>
  10. [ApiController]
  11. [Route("api/s0/warehouse/employees")]
  12. [NonUnify]
  13. public class AdoS0EmployeesController : ControllerBase
  14. {
  15. private readonly SqlSugarRepository<AdoS0EmployeeMaster> _rep;
  16. private readonly SqlSugarRepository<AdoS0DepartmentMaster> _deptRep;
  17. private readonly SqlSugarRepository<AdoGeneralizedCodeRecord> _codeRep;
  18. private readonly AdoS0ReferenceChecker _refChecker;
  19. public AdoS0EmployeesController(
  20. SqlSugarRepository<AdoS0EmployeeMaster> rep,
  21. SqlSugarRepository<AdoS0DepartmentMaster> deptRep,
  22. SqlSugarRepository<AdoGeneralizedCodeRecord> codeRep,
  23. AdoS0ReferenceChecker refChecker)
  24. {
  25. _rep = rep;
  26. _deptRep = deptRep;
  27. _codeRep = codeRep;
  28. _refChecker = refChecker;
  29. }
  30. /// <summary>
  31. /// 岗位下拉选项(legacy GeneralizedCodeMaster.FldName='JobTitle':Val=编码、Comments=中文名,按编码去重)。
  32. /// 通用码表为跨租户参考数据,随雇员编辑弹窗提供岗位可选项。
  33. /// </summary>
  34. [HttpGet("job-titles")]
  35. public async Task<IActionResult> GetJobTitleOptionsAsync()
  36. {
  37. if (!AdoS0TenantScope.TryResolveRequired(out _, out var tenantError)) return tenantError!;
  38. var rows = await _codeRep.AsQueryable()
  39. .Where(x => x.FldName == "JobTitle")
  40. .Select(x => new { Val = x.Val, Comments = x.Comments })
  41. .ToListAsync();
  42. var options = rows
  43. .Where(x => !string.IsNullOrWhiteSpace(x.Val))
  44. .GroupBy(x => x.Val, StringComparer.OrdinalIgnoreCase)
  45. .Select(g => new
  46. {
  47. value = g.Key,
  48. label = g.Select(x => x.Comments).FirstOrDefault(c => !string.IsNullOrWhiteSpace(c)) ?? g.Key
  49. })
  50. .OrderBy(x => x.label, StringComparer.CurrentCulture)
  51. .ToList();
  52. return Ok(options);
  53. }
  54. [HttpGet]
  55. public async Task<IActionResult> GetPagedAsync([FromQuery] AdoS0EmployeeQueryDto q)
  56. {
  57. if (!AdoS0TenantScope.TryResolveRequired(out var tenantId, out var tenantError)) return tenantError!;
  58. (q.Page, q.PageSize) = PagingGuard.Normalize(q.Page, q.PageSize);
  59. var query = _rep.AsQueryable()
  60. .Where(x => x.TenantId == tenantId)
  61. .WhereIF(q.CompanyRefId.HasValue, x => x.CompanyRefId == q.CompanyRefId!.Value)
  62. .WhereIF(q.FactoryRefId.HasValue, x => x.FactoryRefId == q.FactoryRefId!.Value)
  63. .WhereIF(!string.IsNullOrWhiteSpace(q.DomainCode), x => x.DomainCode == q.DomainCode)
  64. .WhereIF(!string.IsNullOrWhiteSpace(q.Department), x => x.Department == q.Department)
  65. .WhereIF(q.IsActive.HasValue, x => x.IsActive == q.IsActive!.Value)
  66. .WhereIF(!string.IsNullOrWhiteSpace(q.Keyword),
  67. x => x.Employee.Contains(q.Keyword!) || (x.Name != null && x.Name.Contains(q.Keyword!)));
  68. var total = await query.CountAsync();
  69. var list = await query
  70. .OrderBy(x => x.Employee)
  71. .Skip((q.Page - 1) * q.PageSize)
  72. .Take(q.PageSize)
  73. .ToListAsync();
  74. await ApplyDeptDescrAsync(list, tenantId);
  75. return Ok(new { total, page = q.Page, pageSize = q.PageSize, list });
  76. }
  77. [HttpGet("{id:long}")]
  78. public async Task<IActionResult> GetAsync(long id)
  79. {
  80. if (!AdoS0TenantScope.TryResolveRequired(out var tenantId, out var tenantError)) return tenantError!;
  81. var item = await _rep.AsQueryable().Where(x => x.Id == id && x.TenantId == tenantId).FirstAsync();
  82. if (item == null) return NotFound();
  83. await ApplyDeptDescrAsync(new List<AdoS0EmployeeMaster> { item }, tenantId);
  84. return Ok(item);
  85. }
  86. [HttpPost]
  87. public async Task<IActionResult> CreateAsync([FromBody] AdoS0EmployeeUpsertDto dto)
  88. {
  89. if (!AdoS0TenantScope.TryResolveRequired(out var tenantId, out var tenantError)) return tenantError!;
  90. if (await _rep.IsAnyAsync(x => x.TenantId == tenantId && x.FactoryRefId == dto.FactoryRefId && x.Employee == dto.Employee))
  91. return AdoS0ApiErrors.Conflict(AdoS0ErrorCodes.DuplicateCode, "员工编码已存在");
  92. // 所属部门必须存在于当前租户(同 domain + department),杜绝员工绑定他租户部门
  93. if (!string.IsNullOrWhiteSpace(dto.Department)
  94. && !await _refChecker.DepartmentExistsInTenantAsync(tenantId, dto.DomainCode, dto.Department))
  95. return AdoS0ApiErrors.InvalidReference(AdoS0ErrorCodes.ReferenceNotFound,
  96. $"部门编码 '{dto.Department}' 不存在于当前租户部门主数据");
  97. var entity = MapToEntity(dto);
  98. entity.TenantId = tenantId;
  99. entity.CreateTime = DateTime.Now;
  100. await _rep.AsInsertable(entity).ExecuteReturnEntityAsync();
  101. return Ok(entity);
  102. }
  103. [HttpPut("{id:long}")]
  104. public async Task<IActionResult> UpdateAsync(long id, [FromBody] AdoS0EmployeeUpsertDto dto)
  105. {
  106. if (!AdoS0TenantScope.TryResolveRequired(out var tenantId, out var tenantError)) return tenantError!;
  107. var entity = await _rep.AsQueryable().Where(x => x.Id == id && x.TenantId == tenantId).FirstAsync();
  108. if (entity == null) return NotFound();
  109. if (await _rep.IsAnyAsync(x => x.TenantId == tenantId && x.Id != id && x.FactoryRefId == dto.FactoryRefId && x.Employee == dto.Employee))
  110. return AdoS0ApiErrors.Conflict(AdoS0ErrorCodes.DuplicateCode, "员工编码已存在");
  111. if (!string.IsNullOrWhiteSpace(dto.Department)
  112. && !await _refChecker.DepartmentExistsInTenantAsync(tenantId, dto.DomainCode, dto.Department))
  113. return AdoS0ApiErrors.InvalidReference(AdoS0ErrorCodes.ReferenceNotFound,
  114. $"部门编码 '{dto.Department}' 不存在于当前租户部门主数据");
  115. // entity.TenantId 保持不变(== tenantId);不接受前端修改 tenant
  116. entity.CompanyRefId = dto.CompanyRefId;
  117. entity.FactoryRefId = dto.FactoryRefId;
  118. entity.DomainCode = dto.DomainCode ?? string.Empty;
  119. entity.Employee = dto.Employee;
  120. entity.Name = dto.Name;
  121. entity.Sex = dto.Sex;
  122. entity.Phone = dto.Phone;
  123. entity.Email = dto.Email;
  124. entity.BirthDate = dto.BirthDate;
  125. entity.Department = dto.Department;
  126. entity.DateEmployed = dto.DateEmployed;
  127. entity.EmploymentStatus = dto.EmploymentStatus;
  128. entity.MaritalStatus = dto.MaritalStatus;
  129. entity.JobTitle = dto.JobTitle;
  130. entity.DateTerminated = dto.DateTerminated;
  131. entity.WorkCtr = dto.WorkCtr;
  132. entity.CarId = dto.CarId;
  133. entity.DefaultWorkLocation = dto.DefaultWorkLocation;
  134. entity.City = dto.City;
  135. entity.Country = dto.Country;
  136. entity.BusinessPhone = dto.BusinessPhone;
  137. entity.IsActive = dto.IsActive;
  138. entity.UpdateUser = dto.UpdateUser;
  139. entity.UpdateTime = DateTime.Now;
  140. await _rep.AsUpdateable(entity).ExecuteCommandAsync();
  141. return Ok(entity);
  142. }
  143. [HttpDelete("{id:long}")]
  144. public async Task<IActionResult> DeleteAsync(long id)
  145. {
  146. if (!AdoS0TenantScope.TryResolveRequired(out var tenantId, out var tenantError)) return tenantError!;
  147. var item = await _rep.AsQueryable().Where(x => x.Id == id && x.TenantId == tenantId).FirstAsync();
  148. if (item == null) return NotFound();
  149. var refInfo = await _refChecker.EmployeeReferencesAsync(tenantId, item.Employee);
  150. if (refInfo is { } r)
  151. return AdoS0ApiErrors.Conflict(AdoS0ErrorCodes.DeleteBlocked,
  152. $"存在 {r.Count} 条 {r.Table} 引用该雇员,无法删除");
  153. await _rep.DeleteAsync(item);
  154. return Ok(new { message = "删除成功" });
  155. }
  156. private static AdoS0EmployeeMaster MapToEntity(AdoS0EmployeeUpsertDto dto) => new()
  157. {
  158. CompanyRefId = dto.CompanyRefId,
  159. FactoryRefId = dto.FactoryRefId,
  160. DomainCode = dto.DomainCode ?? string.Empty,
  161. Employee = dto.Employee,
  162. Name = dto.Name,
  163. Sex = dto.Sex,
  164. Phone = dto.Phone,
  165. Email = dto.Email,
  166. BirthDate = dto.BirthDate,
  167. Department = dto.Department,
  168. DateEmployed = dto.DateEmployed,
  169. EmploymentStatus = dto.EmploymentStatus,
  170. MaritalStatus = dto.MaritalStatus,
  171. JobTitle = dto.JobTitle,
  172. DateTerminated = dto.DateTerminated,
  173. WorkCtr = dto.WorkCtr,
  174. CarId = dto.CarId,
  175. DefaultWorkLocation = dto.DefaultWorkLocation,
  176. City = dto.City,
  177. Country = dto.Country,
  178. BusinessPhone = dto.BusinessPhone,
  179. IsActive = dto.IsActive,
  180. CreateUser = dto.CreateUser
  181. };
  182. /// <summary>补显部门说明。关联 DepartmentMaster 限定当前租户,避免同编码部门跨租户补错描述。</summary>
  183. private async Task ApplyDeptDescrAsync(List<AdoS0EmployeeMaster> employees, long tenantId)
  184. {
  185. if (employees.Count == 0) return;
  186. var domainCodes = employees.Select(e => e.DomainCode).Distinct().ToList();
  187. var depts = await _deptRep.AsQueryable()
  188. .Where(d => d.TenantId == tenantId && domainCodes.Contains(d.DomainCode))
  189. .ToListAsync();
  190. foreach (var emp in employees)
  191. {
  192. var dept = depts.Find(d =>
  193. string.Equals(d.DomainCode, emp.DomainCode, StringComparison.OrdinalIgnoreCase)
  194. && string.Equals(d.Department, emp.Department, StringComparison.OrdinalIgnoreCase));
  195. emp.DepartDescr = dept?.Descr;
  196. // JobTitle 直接使用存储值作为展示(GeneralizedCodeMaster 暂不关联)
  197. emp.JobTitleDisplay = emp.JobTitle;
  198. }
  199. }
  200. }