[SPDBT-4008] Dynamics Helper: Provide an endpoint to create an invitation for business contact in spd_portalinvitation entity.

src/Spd.Manager.Licence/BizMemberContract.cs

@@ -16,7 +16,7 @@ public interface IBizMemberManager
     public Task<StakeholderAppInviteVerifyResponse> Handle(VerifyBizStakeholderInviteCommand command, CancellationToken ct);
 }
 
-public record BizStakeholderNewInviteCommand(Guid BizContactId, Guid UserId, string HostUrl, StakeholderAppInviteTypeCode InviteTypeCode = StakeholderAppInviteTypeCode.New) : IRequest<StakeholderInvitesCreateResponse>;
+public record BizStakeholderNewInviteCommand(Guid BizContactId, Guid? UserId, string HostUrl, StakeholderAppInviteTypeCode InviteTypeCode = StakeholderAppInviteTypeCode.New) : IRequest<StakeholderInvitesCreateResponse>;
 public record VerifyBizStakeholderInviteCommand(string InviteEncryptedCode) : IRequest<StakeholderAppInviteVerifyResponse>;
 public record GetBizMembersQuery(Guid BizId, Guid? AppId = null) : IRequest<Members>;
 public record GetNonSwlBizMemberCommand(Guid BizContactId) : IRequest<NonSwlContactInfo>;

src/Spd.Presentation.Dynamics/Controllers/OrgController.cs

@@ -1,8 +1,10 @@
 using MediatR;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
+using Spd.Manager.Licence;
 using Spd.Manager.Screening;
 using Spd.Utilities.Shared;
+using System.ComponentModel.DataAnnotations;
 using System.Configuration;
 
 namespace Spd.Presentation.Dynamics.Controllers;
@@ -46,4 +48,23 @@ public async Task<OrgInvitationLinkResponse> GetOrgInvitationLinkAsync(
 
         return await _mediator.Send(new OrgInvitationLinkCreateCommand(orgId, $"{screeningHostUrl}{screeningOrgPath}"), ct);
     }
+
+    /// <summary>
+    /// Create stakeholder (controlling member, biz manager) crc invitation for this biz contact
+    /// Example: http://localhost:5114/api/business-stakeholder-invitation/{bizContactId}
+    /// </summary>
+    /// <param name="bizContactId"></param>
+    /// <param name="inviteType"></param>
+    /// <returns></returns>
+    [Route("api/business-stakeholder-invitation/{bizContactId}")]
+    [HttpGet]
+    public async Task<StakeholderInvitesCreateResponse> CreateBizStakeHolderCrcAppInvitation([FromRoute][Required] Guid bizContactId,
+        [FromQuery] StakeholderAppInviteTypeCode inviteType = StakeholderAppInviteTypeCode.New)
+    {
+        string? hostUrl = _configuration.GetValue<string>("LicensingHostUrl");
+        if (hostUrl == null)
+            throw new ConfigurationErrorsException("HostUrl is not set correctly in configuration.");
+        var inviteCreateCmd = new BizStakeholderNewInviteCommand(bizContactId, null, hostUrl, inviteType);
+        return await _mediator.Send(inviteCreateCmd);
+    }
 }

src/Spd.Presentation.Dynamics/Spd.Presentation.Dynamics.csproj

@@ -14,6 +14,7 @@
 
 	<ItemGroup>
 		<ProjectReference Include="..\Spd.Manager.FinanceReconciliation\Spd.Manager.FinanceReconciliation.csproj" />
+		<ProjectReference Include="..\Spd.Manager.Licence\Spd.Manager.Licence.csproj" />
 		<ProjectReference Include="..\Spd.Manager.Payment\Spd.Manager.Payment.csproj" />
 		<ProjectReference Include="..\Spd.Manager.Printing\Spd.Manager.Printing.csproj" />
 		<ProjectReference Include="..\Spd.Manager.ScheduleJob\Spd.Manager.ScheduleJob.csproj" />

src/Spd.Resource.Repository/ControllingMemberInvite/Contract.cs

@@ -46,7 +46,7 @@ public record ControllingMemberInvite
         public string? MiddleName2 { get; set; }
         public string? EmailAddress { get; set; }
         public Guid BizId { get; set; }
-        public Guid CreatedByUserId { get; set; }
+        public Guid? CreatedByUserId { get; set; }
         public Guid BizContactId { get; set; }
         public ControllingMemberAppInviteTypeEnum InviteTypeCode { get; set; } = ControllingMemberAppInviteTypeEnum.New;
     }

src/Spd.Resource.Repository/ControllingMemberInvite/ControllingMemberInviteRepository.cs

@@ -44,15 +44,17 @@ public async Task ManageAsync(ControllingMemberInviteCmd cmd, CancellationToken
 
         public async Task CreateControllingMemberInviteAsync(ControllingMemberInviteCreateCmd createInviteCmd, CancellationToken ct)
         {
-            spd_portaluser? user = await _dynaContext.GetUserById(createInviteCmd.CreatedByUserId, ct);
+            spd_portaluser? user = null;
+            if (createInviteCmd.CreatedByUserId != null)
+                user = await _dynaContext.GetUserById((Guid)createInviteCmd.CreatedByUserId, ct);
             account? biz = await _dynaContext.GetOrgById(createInviteCmd.BizId, ct);
             spd_businesscontact? bizContact = await _dynaContext.GetBizContactById(createInviteCmd.BizContactId, ct);
             spd_portalinvitation invitation = _mapper.Map<spd_portalinvitation>(createInviteCmd);
             var encryptedInviteId = WebUtility.UrlEncode(_dataProtector.Protect(invitation.spd_portalinvitationid.ToString(), DateTimeOffset.UtcNow.AddDays(SpdConstants.ApplicationInviteValidDays)));
             invitation.spd_invitationlink = $"{createInviteCmd.HostUrl}{SpdConstants.BizPortalControllingMemberInviteLink}{encryptedInviteId}";
             _dynaContext.AddTospd_portalinvitations(invitation);
             _dynaContext.SetLink(invitation, nameof(spd_portalinvitation.spd_OrganizationId), biz);
-            _dynaContext.SetLink(invitation, nameof(spd_portalinvitation.spd_InvitedBy), user);
+            if (user != null) _dynaContext.SetLink(invitation, nameof(spd_portalinvitation.spd_InvitedBy), user);
             _dynaContext.SetLink(invitation, nameof(spd_portalinvitation.spd_BusinessContact), bizContact);
             spd_servicetype? servicetype = _dynaContext.LookupServiceType(ServiceTypeEnum.SECURITY_BUSINESS_LICENCE_CONTROLLING_MEMBER_CRC.ToString());
             if (servicetype != null)