feat: Add WhatsApp Webhook Event handling and OpenWA client integration

- Created migration for WhatsAppWebhookEvents table to store incoming webhook events.
- Implemented WhatsAppWebhookEventEntity model for ORM mapping.
- Developed IOpenWAClient interface for OpenWA API interactions.
- Implemented OpenWAClient class to handle HTTP requests to the OpenWA gateway.
- Added OpenWAGatewayException for error handling during API calls.
- Created PowerShell scripts for managing OpenWA startup on Windows, including installation, registration, and removal of scheduled tasks.
- Documented OpenWA Windows startup procedures in a new markdown file.

Author: Ngonie69

OpenWA

@@ -0,0 +1 @@
+Subproject commit 697b4a199f6093ff9b0b7d146bacd970d53c421a

ShopInventory.Web/Components/Layout/NavMenu.razor

@@ -801,6 +801,12 @@
                         </span>
                         <span class="snav-text">Webhooks</span>
                     </NavLink>
+                    <NavLink class="snav-link" href="/whatsapp-inbox" Match="NavLinkMatch.Prefix">
+                        <span class="snav-icon">
+                            <MudIcon Icon="@Icons.Material.Filled.Chat" />
+                        </span>
+                        <span class="snav-text">WhatsApp Inbox</span>
+                    </NavLink>
                     <NavLink class="snav-link" href="/swagger" Match="NavLinkMatch.Prefix">
                         <span class="snav-icon">
                             <MudIcon Icon="@Icons.Material.Filled.Api" />

ShopInventory.Web/Components/Pages/MobileDrafts.razor

@@ -43,7 +43,7 @@
                         @BasePendingCount pending
                     </span>
                     <MudButton Variant="Variant.Outlined" Color="Color.Default" OnClick="ExportToExcel"
-                               Disabled="@(isExporting || FilteredCount == 0)" Class="podr-export-btn">
+                               Disabled="@(isExporting || BaseFilteredCount == 0)" Class="podr-export-btn">
                         @if (isExporting)
                         {
                             <MudProgressCircular Size="Size.Small" Indeterminate="true" Class="me-1" />
@@ -1002,19 +1002,20 @@
 
     private async Task ExportToExcel()
     {
-        if (report == null || FilteredCount == 0) return;
+        if (report == null || BaseFilteredCount == 0) return;
         isExporting = true;
         StateHasChanged();
         try
         {
+            var exportItems = BaseFilteredItems.ToList();
             var exportReport = new PodUploadStatusReport
             {
                 FromDate = report.FromDate,
                 ToDate = report.ToDate,
-                TotalInvoices = FilteredCount,
-                UploadedCount = FilteredItems.Count(i => i.HasPod),
-                PendingCount = FilteredItems.Count(i => !i.HasPod),
-                Items = FilteredItems.ToList()
+                TotalInvoices = exportItems.Count,
+                UploadedCount = exportItems.Count(i => i.HasPod),
+                PendingCount = exportItems.Count(i => !i.HasPod),
+                Items = exportItems
             };
 
             var bytes = ExportService.ExportPodUploadStatusToExcel(exportReport);

ShopInventory.Web/Components/Pages/PodUploadReport.razor

@@ -1,4 +1,5 @@
 @page "/pods"
+@using System.Globalization
 @using Microsoft.AspNetCore.Authorization
 @using ShopInventory.Web.Common
 @using ShopInventory.Web.Models
@@ -1387,19 +1388,91 @@
     private bool deleteSuccess;
     private PodAttachmentItemDto? deletePod;
     private string? currentUsername;
+    private int? appliedInitialDocNum;
+    private bool appliedInitialViewLatest;
 
     [SupplyParameterFromQuery(Name = "docNum")]
     public int? InitialDocNum { get; set; }
 
+    [SupplyParameterFromQuery(Name = "viewLatest")]
+    public bool InitialViewLatest { get; set; }
+
     protected override async Task OnInitializedAsync()
     {
         var authState = await AuthStateProvider.GetAuthenticationStateAsync();
         currentUsername = authState.User.Identity?.Name;
+    }
+
+    protected override async Task OnParametersSetAsync()
+    {
+        await ApplyInitialNavigationAsync();
+    }
+
+    private async Task ApplyInitialNavigationAsync()
+    {
+        if (!InitialDocNum.HasValue || InitialDocNum.Value <= 0)
+            return;
 
-        if (InitialDocNum.HasValue && InitialDocNum.Value > 0)
+        if (appliedInitialDocNum == InitialDocNum.Value && appliedInitialViewLatest == InitialViewLatest)
+            return;
+
+        appliedInitialDocNum = InitialDocNum.Value;
+        appliedInitialViewLatest = InitialViewLatest;
+
+        uploadDocNum = InitialDocNum.Value;
+        filterSearch = InitialDocNum.Value.ToString(CultureInfo.InvariantCulture);
+        activeFilterSearch = filterSearch;
+
+        await LookupInvoice();
+        await ReloadPodsTableAsync(resetToFirstPage: true);
+
+        if (InitialViewLatest)
         {
-            uploadDocNum = InitialDocNum.Value;
-            await LookupInvoice();
+            await OpenLatestPodForLookupInvoiceAsync();
+        }
+    }
+
+    private async Task OpenLatestPodForLookupInvoiceAsync()
+    {
+        if (lookupInvoice == null)
+            return;
+
+        try
+        {
+            var response = await PodService.GetInvoicePodsAsync(lookupInvoice.DocEntry);
+            var latestAttachment = response?.Attachments?
+                .OrderByDescending(attachment => attachment.UploadedAt)
+                .FirstOrDefault();
+
+            if (latestAttachment == null)
+            {
+                uploadSuccess = false;
+                uploadMessage = $"No POD upload was found for invoice #{lookupInvoice.DocNum}.";
+                return;
+            }
+
+            await ViewPod(new PodAttachmentItemDto
+            {
+                Id = latestAttachment.Id,
+                FileName = latestAttachment.FileName,
+                MimeType = latestAttachment.MimeType,
+                FileSizeBytes = latestAttachment.FileSizeBytes,
+                FileSizeFormatted = latestAttachment.FileSizeFormatted,
+                Description = latestAttachment.Description,
+                UploadedAt = latestAttachment.UploadedAt,
+                UploadedByUserName = latestAttachment.UploadedByUserName,
+                DownloadUrl = latestAttachment.DownloadUrl,
+                InvoiceDocEntry = lookupInvoice.DocEntry,
+                InvoiceDocNum = lookupInvoice.DocNum,
+                CardCode = lookupInvoice.CardCode,
+                CardName = lookupInvoice.CardName
+            });
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Error opening latest POD for invoice {DocNum}", lookupInvoice.DocNum);
+            uploadSuccess = false;
+            uploadMessage = "Failed to open the uploaded POD.";
         }
     }