Management of Employee Job Title API

Author: tiksn

src/API.Core/Entities/EmployeeEntity.cs

@@ -10,6 +10,7 @@ public record EmployeeEntity(
     Option<BranchId> AssignedBranchId,
     Option<DepartmentId> AssignedDepartmentId,
     Option<EmployeeId> ReportsToId,
+    string JobTitle,
     string FirstName,
     string LastName,
     string FullName)

src/API.Core/Messages/Commands/EmployeeCreationCommandHandler.cs

@@ -69,6 +69,7 @@ private async Task CreateEmployeeAsync(
       AssignedBranchId: None,
       AssignedDepartmentId: None,
       ReportsToId: None,
+      string.Empty,
       request.FirstName,
       request.LastName,
       request.FullName);

src/API.Core/Messages/Commands/EmployeeManagementCommand.cs

@@ -8,7 +8,8 @@ public record EmployeeManagementCommand(
   Guid UserID,
   Option<BranchId> AssignedBranchId,
   Option<DepartmentId> AssignedDepartmentId,
-  Option<EmployeeId> ReportsToId)
+  Option<EmployeeId> ReportsToId,
+  string JobTitle)
   : EntityTenantUserCommand<EmployeeEntity, EmployeeId, Guid, Guid>(TenantID, UserID)
 {
   public override IEnumerable<EmployeeId> AffectingTenantEntitiesIdentities

src/API.Core/Messages/Commands/EmployeeManagementCommandHandler.cs

@@ -25,7 +25,8 @@ public async Task<Unit> Handle(
     {
       AssignedBranchId = request.AssignedBranchId,
       AssignedDepartmentId = request.AssignedDepartmentId,
-      ReportsToId = request.ReportsToId
+      ReportsToId = request.ReportsToId,
+      JobTitle = request.JobTitle
     };
 
     await _employeeRepository.UpdateAsync(entity, cancellationToken).ConfigureAwait(false);

src/API.Core/Validators/EmployeeManagementCommandValidator.cs

@@ -49,6 +49,12 @@ public EmployeeManagementCommandValidator(
     RuleFor(x => x.ReportsToId)
       .MustAsync(ValidateReportsToIdNoCyclesAsync)
       .WithMessage("ReportsToId must not be cyclical.");
+
+    RuleFor(x => x.JobTitle)
+      .NotNull()
+      .WithMessage("Job Title cannot be null.")
+      .Must(s => !string.IsNullOrWhiteSpace(s))
+      .WithMessage("Job Title cannot be empty or whitespace.");
   }
 
   private async Task<bool> ValidateBranchAsync(EmployeeManagementCommand command, Option<BranchId> assignedBranchId, CancellationToken cancellationToken)

src/API.Persistence/Mongo/Entities/EmployeeMongoEntity.cs

@@ -23,6 +23,8 @@ public class EmployeeMongoEntity : IEntity<long>
 
   public long? ReportsToId { get; set; }
 
+  public string? JobTitle { get; set; }
+
   public string? FirstName { get; set; }
 
   public string? LastName { get; set; }

src/API.Persistence/Mongo/Mappers/EmployeeMongoMapper.cs

@@ -46,6 +46,7 @@ public EmployeeEntity Map(EmployeeMongoEntity source)
       Optional(source.AssignedBranchId).Map(_branchDataIdentityToDomainIdentityMapper.Map),
       Optional(source.AssignedDepartmentId).Map(_departmentDataToDomainIdentityMapper.Map),
       Optional(source.ReportsToId).Map(_dataIdentityToDomainIdentityMapper.Map),
+      source.JobTitle ?? string.Empty,
       source.FirstName ?? string.Empty,
       source.LastName ?? string.Empty,
       source.FullName ?? string.Empty);
@@ -62,6 +63,7 @@ public EmployeeMongoEntity Map(EmployeeEntity source)
       AssignedBranchId = source.AssignedBranchId.Map(_branchDomainIdentityToDataIdentityMapper.Map).MatchUnsafe(s => s, (long?)null),
       AssignedDepartmentId = source.AssignedDepartmentId.Map(_departmentDomainToDataIdentityMapper.Map).MatchUnsafe(s => s, (long?)null),
       ReportsToId = source.ReportsToId.Map(_domainIdentityToDataIdentityMapper.Map).MatchUnsafe(s => s, (long?)null),
+      JobTitle = source.JobTitle,
       FirstName = source.FirstName,
       LastName = source.LastName,
       FullName = source.FullName,

src/API.Web/Api/EmployeesController.cs

@@ -42,7 +42,8 @@ await _sender.Send(
         id,
         model.AssignedBranchId,
         model.AssignedDepartmentId,
-        model.ReportsToId),
+        model.ReportsToId,
+        model.JobTitle ?? string.Empty),
       cancellationToken);
   }
 

src/API.Web/ApiModels/EmployeeManagementModel.cs

@@ -3,4 +3,5 @@
 public record EmployeeManagementModel(
   long? AssignedBranchId,
   long? AssignedDepartmentId,
-  long? ReportsToId);
+  long? ReportsToId,
+  string? JobTitle);

src/API.Web/ApiModels/EmployeeRetrievalModel.cs

@@ -4,4 +4,5 @@ public record EmployeeRetrievalModel(
   long Id, long CompanyId,
   long? AssignedBranchId, long? AssignedDepartmentId,
   long? ReportsToId,
+  string JobTitle,
   string FirstName, string LastName, string FullName);