Merge pull request #1541 from bcgov/tasks/ecer-5552

ECER-5552: PortalInvitation handlers refactored

Author: farzadnadiri

src/ECER.Clients.PSPPortal/ecer.clients.pspportal.client/package-lock.json

@@ -157,6 +157,7 @@ public record ICRAWorkExperienceReferenceSubmissionRequest([Required] string Tok
   public bool? WorkedWithChildren { get; set; }
   public IEnumerable<ChildcareAgeRanges>? ChildcareAgeRanges { get; set; }
   public ReferenceRelationship? ReferenceRelationship { get; set; }
+  public bool WillProvideReference { get; set; }
   public DateTime? DateSigned { get; set; }
 
 }

src/ECER.Clients.RegistryPortal/ECER.Clients.RegistryPortal.Server/References/ReferencesEndpoints.cs

@@ -86,6 +86,7 @@ public record ICRAWorkExperienceReferenceSubmissionRequest
   public bool? WorkedWithChildren { get; set; }
   public IEnumerable<Applications.ChildcareAgeRanges>? ChildcareAgeRanges { get; set; }
   public Applications.ReferenceRelationship? ReferenceRelationship { get; set; }
+  public bool WillProvideReference { get; set; }
   public DateTime? DateSigned { get; set; }
 }
 

src/ECER.Clients.RegistryPortal/ecer.clients.registryportal.client/package-lock.json

@@ -1,5 +1,6 @@
 using ECER.Infrastructure.Common;
 using ECER.Managers.Registry.Contract.Registrants;
+using ECER.Managers.Registry.PortalInvitations;
 using ECER.Managers.Registry.UserRegistrationIdentityService;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
@@ -17,6 +18,9 @@ public void Configure([NotNull] ConfigurationContext configurationContext)
     configurationContext.Services.AddTransient<ICRAEligibilityHandlers>();
     configurationContext.Services.AddTransient<RegistrantHandlers>();
     configurationContext.Services.AddTransient<PortalInvitationHandlers>();
+    configurationContext.Services.AddTransient<IPortalInvitationVerificationHandler, ReferencePortalInvitationVerificationHandler>();
+    configurationContext.Services.AddTransient<IPortalInvitationVerificationHandler, IcraReferencePortalInvitationVerificationHandler>();
+    configurationContext.Services.AddTransient<IPortalInvitationVerificationHandler, PspPortalInvitationVerificationHandler>();
     configurationContext.Services.AddTransient<RecaptchaHandlers>();
     configurationContext.Services.Configure<RecaptchaAppSettings>(recaptchaAppSettings =>
     configurationContext.Configuration.GetSection("Recaptcha").Bind(recaptchaAppSettings));

src/ECER.Managers.Registry.Contract/ICRA/Contract.cs

@@ -0,0 +1,40 @@
+using AutoMapper;
+using ECER.Engines.Transformation;
+using ECER.Engines.Transformation.PortalInvitations;
+using ECER.Managers.Registry.Contract.PortalInvitations;
+using ECER.Resources.Documents.PortalInvitations;
+using MediatR;
+
+namespace ECER.Managers.Registry.PortalInvitations;
+
+public class PortalInvitationHandlers(
+  IPortalInvitationTransformationEngine transformationEngine,
+  IPortalInvitationRepository portalInvitationRepository,
+  IMapper mapper,
+  IEnumerable<IPortalInvitationVerificationHandler> verificationHandlers)
+  : IRequestHandler<PortalInvitationVerificationQuery, PortalInvitationVerificationQueryResult>
+{
+  public async Task<PortalInvitationVerificationQueryResult> Handle(PortalInvitationVerificationQuery request, CancellationToken cancellationToken)
+  {
+    ArgumentNullException.ThrowIfNull(request);
+    var response = await transformationEngine.Transform(new DecryptInviteTokenRequest(request.VerificationToken))! as DecryptInviteTokenResponse ?? throw new InvalidCastException("Invalid response type");
+    if (response.PortalInvitation == Guid.Empty)
+    {
+      return PortalInvitationVerificationQueryResult.Failure("Invalid Token");
+    }
+
+    var portalInvitation = await portalInvitationRepository.Query(new PortalInvitationQuery(response.PortalInvitation), cancellationToken);
+    if (portalInvitation == null)
+    {
+      return PortalInvitationVerificationQueryResult.Failure("Portal Invitation not found");
+    }
+    var portalInvitation_Manager = mapper.Map<Contract.PortalInvitations.PortalInvitation>(portalInvitation);
+    var handler = verificationHandlers.FirstOrDefault(h => h.CanHandle(portalInvitation_Manager.InviteType));
+    if (handler == null)
+    {
+      return PortalInvitationVerificationQueryResult.Failure("Unsupported invite type.");
+    }
+
+    return await handler.Verify(portalInvitation_Manager, cancellationToken);
+  }
+}

src/ECER.Managers.Registry/Configurer.cs

@@ -2,7 +2,7 @@
 using ECER.Resources.Documents.Applications;
 using ECER.Resources.Documents.PortalInvitations;
 
-namespace ECER.Managers.Registry;
+namespace ECER.Managers.Registry.PortalInvitations;
 
 public class PortalInvitationMapper : Profile
 {

src/ECER.Managers.Registry/PortalInvitations/PortalInvitationHandlers.cs

@@ -0,0 +1,11 @@
+using ECER.Managers.Registry.Contract.PortalInvitations;
+
+namespace ECER.Managers.Registry;
+
+public interface IPortalInvitationVerificationHandler
+{
+  bool CanHandle(InviteType? inviteType);
+  Task<PortalInvitationVerificationQueryResult> Verify(PortalInvitation portalInvitation, CancellationToken cancellationToken);
+}
+
+

src/ECER.Managers.Registry/PortalInvitationMapper.cs renamed to src/ECER.Managers.Registry/PortalInvitations/PortalInvitationMapper.cs

@@ -0,0 +1,54 @@
+using AutoMapper;
+using ECER.Managers.Registry.Contract.PortalInvitations;
+using ECER.Resources.Accounts.Registrants;
+
+namespace ECER.Managers.Registry;
+
+public class IcraReferencePortalInvitationVerificationHandler(
+  IRegistrantRepository registrantRepository,
+  IMapper mapper)
+  : IPortalInvitationVerificationHandler
+{
+  public bool CanHandle(InviteType? inviteType)
+  {
+    return inviteType == InviteType.WorkExperienceReferenceforICRA;
+  }
+
+  public async Task<PortalInvitationVerificationQueryResult> Verify(PortalInvitation portalInvitation, CancellationToken cancellationToken)
+  {
+    var emptyGuidString = Guid.Empty.ToString();
+    if (portalInvitation == null || portalInvitation.WorkexperienceReferenceId == emptyGuidString)
+    {
+      return PortalInvitationVerificationQueryResult.Failure("Reference not found");
+    }
+
+    var registrantResult = await registrantRepository.Query(new RegistrantQuery() { ByUserId = portalInvitation.ApplicantId }, cancellationToken);
+    var applicant = registrantResult.SingleOrDefault();
+    if (applicant == null)
+    {
+      return PortalInvitationVerificationQueryResult.Failure("Applicant not found");
+    }
+
+    var result = mapper.Map<Contract.PortalInvitations.PortalInvitation>(portalInvitation);
+
+    switch (result.StatusCode)
+    {
+      case Contract.PortalInvitations.PortalInvitationStatusCode.Completed:
+        return PortalInvitationVerificationQueryResult.Failure("Reference has already been submitted.");
+      case Contract.PortalInvitations.PortalInvitationStatusCode.Expired:
+        return PortalInvitationVerificationQueryResult.Failure("Reference has expired.");
+      case Contract.PortalInvitations.PortalInvitationStatusCode.Cancelled:
+        return PortalInvitationVerificationQueryResult.Failure("Reference has been cancelled.");
+      case Contract.PortalInvitations.PortalInvitationStatusCode.Failed:
+        return PortalInvitationVerificationQueryResult.Failure("Reference has failed.");
+    }
+
+    // For ICRA references there is no ApplicationId; do not attempt to load application or certification data
+    result.ApplicantFirstName = applicant.Profile.FirstName;
+    result.ApplicantLastName = applicant.Profile.LastName;
+
+    return PortalInvitationVerificationQueryResult.Success(result);
+  }
+}
+
+

src/ECER.Managers.Registry/PortalInvitations/Verification/IPortalInvitationVerificationHandler.cs

@@ -0,0 +1,20 @@
+using AutoMapper;
+using ECER.Managers.Registry.Contract.PortalInvitations;
+
+namespace ECER.Managers.Registry;
+
+public class PspPortalInvitationVerificationHandler(IMapper mapper) : IPortalInvitationVerificationHandler
+{
+  public bool CanHandle(InviteType? inviteType)
+  {
+    return inviteType == InviteType.PSIProgramRepresentative;
+  }
+
+  public Task<PortalInvitationVerificationQueryResult> Verify(PortalInvitation portalInvitation, CancellationToken cancellationToken)
+  {
+    var result = mapper.Map<Contract.PortalInvitations.PortalInvitation>(portalInvitation);
+    return Task.FromResult(PortalInvitationVerificationQueryResult.Success(result));
+  }
+}
+
+