payrun start: added support for async payrun job executions

payrun jobs page: enhanced status query dialogs
updated version to 0.9.0-beta.14

Author: Jani Giannoudis

Core/PayrollEngine.WebApp.Core.csproj

@@ -12,7 +12,7 @@
 	</PropertyGroup>
 
 	<ItemGroup>
-		<PackageReference Include="PayrollEngine.Client.Core" Version="0.9.0-beta.13" />
+		<PackageReference Include="PayrollEngine.Client.Core" Version="0.9.0-beta.14" />
 		<PackageReference Include="Microsoft.AspNetCore.Components" Version="10.0.1" />
 		<PackageReference Include="Blazored.LocalStorage" Version="4.5.0" />
 		<PackageReference Include="Microsoft.JSInterop" Version="10.0.1" />

Directory.Build.props

@@ -2,9 +2,9 @@
 
 	<PropertyGroup>
 		<TargetFramework>net10.0</TargetFramework>
-		<Version>0.9.0-beta.13</Version>
+		<Version>0.9.0-beta.14</Version>
 		<FileVersion>0.9.0</FileVersion>
-		<InformationalVersion>0.9.0-beta.13</InformationalVersion>
+		<InformationalVersion>0.9.0-beta.14</InformationalVersion>
 		<Authors>Jani Giannoudis</Authors>
 		<Company>Software Consulting Giannoudis</Company>
 		<Copyright>© 2026 Software Consulting Giannoudis</Copyright>

Presentation/Component/DialogServiceExtensions.cs

@@ -32,8 +32,8 @@ public async Task<bool> ShowMessageBoxAsync(string title, string message, string
             string noText = null, string cancelText = null,
             string icon = Icons.Material.Filled.Info,
             Color iconColor = Color.Info,
-            Color submitColor = Color.Primary,
-            Variant submitVariant = Variant.Outlined)
+            Color submitColor = Color.Tertiary,
+            Variant? submitVariant = null)
         {
             var options = new MessageBoxOptions
             {
@@ -42,6 +42,7 @@ public async Task<bool> ShowMessageBoxAsync(string title, string message, string
                 NoText = noText,
                 Message = message
             };
+            submitVariant ??= Globals.ButtonVariant;
             var parameters = new DialogParameters
             {
                 { nameof(MessageBoxDialog.Options), options },
@@ -71,8 +72,8 @@ public async Task<bool> ShowMessageBoxAsync(string title, MarkupString message,
             string noText = null, string cancelText = null,
             string icon = Icons.Material.Filled.Info,
             Color iconColor = Color.Info,
-            Color submitColor = Color.Primary,
-            Variant submitVariant = Variant.Outlined)
+            Color submitColor = Color.Tertiary,
+            Variant? submitVariant = null)
         {
             var options = new MessageBoxOptions
             {
@@ -81,6 +82,7 @@ public async Task<bool> ShowMessageBoxAsync(string title, MarkupString message,
                 NoText = noText,
                 MarkupMessage = message
             };
+            submitVariant ??= Globals.ButtonVariant;
             var parameters = new DialogParameters
             {
                 { nameof(MessageBoxDialog.Options), options },
@@ -108,7 +110,7 @@ await dialogService.ShowMessageBoxAsync(title, message,
                 icon: Icons.Material.Filled.Delete,
                 iconColor: Color.Error,
                 submitColor: Color.Error,
-                submitVariant: Variant.Filled);
+                submitVariant: Globals.ButtonVariant);
 
         /// <summary>
         /// Show delete message box with markup text
@@ -125,7 +127,7 @@ await dialogService.ShowMessageBoxAsync(title, message,
                 icon: Icons.Material.Filled.Delete,
                 iconColor: Color.Error,
                 submitColor: Color.Error,
-                submitVariant: Variant.Filled);
+                submitVariant: Globals.ButtonVariant);
 
         /// <summary>
         /// Show error message box

Presentation/Component/MessageBoxDialog.razor

@@ -2,8 +2,8 @@
     <DialogContent>
         <MudStack Row="true">
             <MudIcon Icon="@(Icon ?? Icons.Material.Filled.Info)"
-            Color="@IconColor"
-            Style="font-size: 2rem;" />
+                     Color="@IconColor"
+                     Style="font-size: 2rem; align-self: center;" />
             <MudText Style="align-self: center ">
                 @Options.Message
                 @Options.MarkupMessage
@@ -13,30 +13,40 @@
     <DialogActions>
         @if (Options.CancelText != null)
         {
-            <MudButton Color="Color.Primary" OnClick="Cancel">@Options.CancelText</MudButton>
+            <MudButton Variant="@Globals.ButtonVariant"
+                       OnClick="Cancel">
+                @Options.CancelText
+            </MudButton>
         }
         @if (Options.NoText != null)
         {
-            <MudButton Color="Color.Primary" OnClick="Cancel">@Options.NoText</MudButton>
+            <MudButton Variant="@Globals.ButtonVariant"
+                       OnClick="Cancel">
+                @Options.NoText
+            </MudButton>
         }
         @if (Options.YesText != null)
         {
-            <MudButton Color="@SubmitColor" Variant="@SubmitVariant" OnClick="Submit">@Options.YesText</MudButton>
+            <MudButton Color="@SubmitColor"
+                       Variant="@SubmitVariant"
+                       OnClick="Submit">
+                @Options.YesText
+            </MudButton>
         }
     </DialogActions>
 </MudDialog>
 
 <style>
     .dialog {
-    min-width: 24em;
+        min-width: 24em;
     }
 
     .title {
-    background-color: lightgrey;
+        background-color: lightgrey;
     }
 
     .titleDark {
-    background-color: darkslateblue;
+        background-color: darkslateblue;
     }
 </style>
 
@@ -46,8 +56,8 @@
     [Parameter] public MessageBoxOptions Options { get; set; }
     [Parameter] public string Icon { get; set; }
     [Parameter] public Color IconColor { get; set; } = Color.Info;
-    [Parameter] public Color SubmitColor { get; set; } = Color.Primary;
-    [Parameter] public Variant SubmitVariant { get; set; }
+    [Parameter] public Color SubmitColor { get; set; } = Color.Tertiary;
+    [Parameter] public Variant SubmitVariant { get; set; } = Globals.ButtonVariant;
 
     [Inject]
     private IThemeService ThemeService { get; set; }

Presentation/PayrollEngine.WebApp.Presentation.csproj

@@ -8,7 +8,7 @@
 
 	<ItemGroup>
 		<PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.1" />
-		<PackageReference Include="PayrollEngine.Document" Version="0.9.0-beta.13" />
+		<PackageReference Include="PayrollEngine.Document" Version="0.9.0-beta.14" />
 		<PackageReference Include="MudBlazor" Version="8.15.0" />
 		<PackageReference Include="NPOI" Version="2.7.5" />
 	</ItemGroup>

Presentation/Payrun/PayrunStartDialog.razor

@@ -8,7 +8,7 @@
 @using Employee = PayrollEngine.WebApp.ViewModel.Employee
 @using Log = PayrollEngine.Log
 
-<MudDialog Style="min-width: 30em;" TitleClass="mud-theme-primary pe-dialog-title">
+<MudDialog Style="min-width: 35em;" TitleClass="mud-theme-primary pe-dialog-title">
     <DialogContent>
         <MudStack Spacing="0">
             <MudSimpleTable>
@@ -78,8 +78,8 @@
             <div class="py-8">
                 @if (Executing)
                 {
-                    <MudText Class="pb-4">
-                        @Localizer.PayrunJob.JobExecuting
+                    <MudText Class="pb-4 px-4">
+                        @StatusMessage
                     </MudText>
                     <MudProgressLinear Color="Color.Info" Rounded="true"
                                        Class="mud-table-loading-progress"
@@ -88,7 +88,7 @@
                 @if (Failed)
                 {
                     <MudText Class="pb-4" Color="Color.Error">
-                        @Localizer.PayrunJob.JobFailed
+                        @ErrorMessage
                     </MudText>
                 }
                 @if (Completed)
@@ -114,6 +114,9 @@
                 <MudButton Variant="@Globals.ButtonVariant" Color="Color.Info"
                            StartIcon="@Icons.Material.Filled.NavigateNext"
                            OnClick="CloseViewResults">@Localizer.PayrunResult.PayrunResults</MudButton>
+            }
+            @if (Completed || Failed || Executing)
+            {
                 <MudButton Variant="@Globals.ButtonVariant" Color="Color.Tertiary"
                            OnClick="Close">@Localizer.Dialog.Close</MudButton>
             }
@@ -142,6 +145,9 @@
     private bool Completed { get; set; }
     private bool Failed { get; set; }
 
+    private string StatusMessage { get; set; }
+    private string ErrorMessage { get; set; }
+
     private void Cancel() => MudDialog.Cancel();
 
     private void CloseViewResults()
@@ -192,36 +198,55 @@
 
             // new payrun job
             var jobInvocation = new PayrunJobInvocation
-                {
-                    PayrunId = PayrunId,
-                    UserId = User.Id,
-                    Name = Setup.JobName,
-                    Forecast = Setup.ForecastName,
-                    PeriodStart = jobPeriod,
-                    EvaluationDate = Setup.EvaluationDate,
-                    EmployeeIdentifiers = employeeIdentifiers,
-                    Attributes = Setup.Parameters.ToDictionary(p => p.Name, p => p.GetValueByValueType()),
-                    Reason = Setup.Reason,
+            {
+                PayrunId = PayrunId,
+                UserId = User.Id,
+                Name = Setup.JobName,
+                Forecast = Setup.ForecastName,
+                PeriodStart = jobPeriod,
+                EvaluationDate = Setup.EvaluationDate,
+                EmployeeIdentifiers = employeeIdentifiers,
+                Attributes = Setup.Parameters.ToDictionary(p => p.Name, p => p.GetValueByValueType()),
+                Reason = Setup.Reason,
                 // automatic retro mode
-                    RetroPayMode = RetroPayMode.ValueChange
-                };
+                RetroPayMode = RetroPayMode.ValueChange
+            };
 
             // add payrun job
-            var result = await PayrunJobService.StartJobAsync<PayrunJob>(new(Tenant.Id), jobInvocation);
-            if (result == null)
+            var job = await PayrunJobService.StartJobAsync<PayrunJob>(new(Tenant.Id), jobInvocation);
+            if (job == null)
             {
                 await UserNotification.ShowErrorMessageBoxAsync(Localizer, Localizer.PayrunJob.PayrunJob, Localizer.PayrunJob.JobFailed);
             }
+            else
+            {
+                // wait for completed job
+                while (job.JobEnd == null)
+                {
+                    // status update
+                    var percent = job.TotalEmployeeCount > 0 && job.ProcessedEmployeeCount > 0 ?
+                        (job.ProcessedEmployeeCount * 100) / job.TotalEmployeeCount : 0;
+                    StatusMessage = Localizer.PayrunJob.JobProcessing(percent);
+                    StateHasChanged();
+
+                    // delay for a second
+                    Task.Delay(1000).Wait();
+
+                    // retry
+                    job = await PayrunJobService.GetAsync<PayrunJob>(new(Tenant.Id), job.Id);
+                }
+            }
 
             // expected exit
             Executing = false;
-            Completed = true;
+            Completed = job?.JobEnd != null;
             StateHasChanged();
         }
         catch (Exception exception)
         {
             // failed
-            Log.Error(exception, exception.GetBaseMessage());
+            ErrorMessage = exception.GetBaseMessage();
+            Log.Error(exception, ErrorMessage);
             Executing = false;
             Failed = true;
             StateHasChanged();

Presentation/Regulation/Component/ActionDialog.razor

@@ -274,7 +274,7 @@
                 <div class="d-flex flex-grow-1 justify-end pl-8">
                     <MudButton OnClick="ToggleActionsAsync"
                                Variant="@Globals.ButtonVariant"
-                               StartIcon="@(ActionState is ActionWorkState.Hidden ? Icons.Material.Outlined.ExpandMore : ActionState is ActionWorkState.Loading ? Icons.Material.Outlined.Pending : Icons.Material.Outlined.ExpandLess)">
+                               StartIcon="@(ActionState is ActionWorkState.Hidden ? Icons.Material.Outlined.ExpandMore : ActionState is ActionWorkState.Loading ? Icons.Material.Outlined.HourglassBottom : Icons.Material.Outlined.ExpandLess)">
                         @switch (ActionState)
                         {
                             case ActionWorkState.Hidden:

Server/Components/Pages/PayrunJobs.razor.cs

@@ -192,11 +192,14 @@ private async Task ChangeLegalStatusAsync(PayrunJobStatus jobStatus)
         }
 
         // confirmation
+        var source = Localizer.Enum(LegalJob.JobStatus);
+        var target = Localizer.Enum(jobStatus);
         if (!await DialogService.ShowMessageBoxAsync(
-                Localizer.PayrunJob.PayrunJob,
-                new MarkupString($"<br /><b>&#xbb;{jobStatus}&#xab;</b> {Localizer.PayrunJob.PayrunJob} {LegalJob.Name}?<br /><br />"),
-                Localizer.Dialog.Ok,
-                Localizer.Dialog.Cancel))
+                title: Localizer.PayrunJob.PayrunJob,
+                message: new MarkupString($"<br />{Localizer.PayrunJob.ChangeStatusQuery(source, target)}<br /><br />"),
+                yesText: target,
+                noText: Localizer.Dialog.Cancel,
+                submitColor: jobStatus is PayrunJobStatus.Cancel or PayrunJobStatus.Abort ? Color.Error : Color.Tertiary))
         {
             return;
         }
@@ -581,7 +584,7 @@ await DialogService.ShowAsync<PayrunJobDialog>(
     /// <param name="setup">The payrun job setup</param>
     private async Task ResetJobSetupAsync(PayrunJobSetup setup)
     {
-        setup.PeriodDate = Date.Today;
+        await SetJobPeriodDateAsync(setup, Date.Today);
         setup.JobName = $"{Localizer.Payrun.Payrun} {setup.PeriodDate?.ToCompactString()}";
         setup.ForecastName = null;
         setup.SelectedEmployees = null;
@@ -603,7 +606,7 @@ private async Task ResetJobSetupAsync(PayrunJobSetup setup)
     /// <param name="setup">The jo setup</param>
     private async Task ApplyToSetupAsync(PayrunJob job, PayrunJobSetup setup)
     {
-        setup.PeriodDate = job.PeriodStart;
+        await SetJobPeriodDateAsync(setup, job.PeriodStart);
         setup.EvaluationDate = job.EvaluationDate;
         setup.JobName = job.Name;
         setup.Reason = job.CreatedReason;
@@ -861,46 +864,35 @@ private DateTime? LegalSetupPeriodDate
     {
         // ReSharper disable once UnusedMember.Local
         get => LegalSetup.PeriodDate;
-        set
-        {
-            LegalSetup.PeriodDate = value;
-            InvokeAsync(UpdateLegalSetupPeriodAsync);
-        }
-    }
-
-    private async Task UpdateLegalSetupPeriodAsync()
-    {
-        var period = await CalendarService.GetPeriodAsync(
-            tenantId: Tenant.Id,
-            cultureName: PageCulture.Name,
-            calendarName: JobCalendar,
-            periodMoment: LegalSetup.PeriodDate);
-        LegalSetup.Period = period;
-        StateHasChanged();
+        set => InvokeAsync(() => SetJobPeriodDateAsync(LegalSetup, value));
     }
 
     private DateTime? ForecastSetupPeriodDate
     {
         // ReSharper disable once UnusedMember.Local
         get => ForecastSetup.PeriodDate;
-        set
-        {
-            ForecastSetup.PeriodDate = value;
-            InvokeAsync(UpdateForecastSetupPeriodAsync);
-        }
+        set => InvokeAsync(() => SetJobPeriodDateAsync(ForecastSetup, value));
     }
 
-    private async Task UpdateForecastSetupPeriodAsync()
+    private async Task SetJobPeriodDateAsync(PayrunJobSetup setup, DateTime? date)
     {
-        var period = await CalendarService.GetPeriodAsync(
-            tenantId: Tenant.Id,
-            cultureName: PageCulture.Name,
-            calendarName: JobCalendar,
-            periodMoment: ForecastSetup.PeriodDate);
-        ForecastSetup.Period = period;
-        StateHasChanged();
+        if (date == setup.PeriodDate)
+        {
+            return;
+        }
+        setup.PeriodDate = date;
+        await UpdateJobPeriodAsync(setup);
     }
 
+    private async Task UpdateJobPeriodAsync(PayrunJobSetup setup) =>
+        setup.Period = setup.PeriodDate != null ?
+            await CalendarService.GetPeriodAsync(
+                tenantId: Tenant.Id,
+                cultureName: PageCulture.Name,
+                calendarName: JobCalendar,
+                periodMoment: setup.PeriodDate) :
+            new();
+
     #endregion
 
     #region Users
@@ -1028,9 +1020,8 @@ protected override async Task OnPageAfterRenderAsync(bool firstRender)
         if (firstRender && HasFeature(Feature.Forecasts))
         {
             await SetupForecastHistoryAsync();
-            await UpdateLegalSetupPeriodAsync();
-            await UpdateForecastSetupPeriodAsync();
-
+            await UpdateJobPeriodAsync(LegalSetup);
+            await UpdateJobPeriodAsync(ForecastSetup);
         }
         await base.OnPageAfterRenderAsync(firstRender);
     }