feat StayExport - Added ExportDetails for StayExports

Store a new field ('ExportDetails') with export details. This is a JSON field in DB that can store information about the export depending on the format provider used.

Changes:
- Updated models and created required migrations.
- Show field in StayExport list.

Directory.Packages.props

@@ -6,6 +6,8 @@
   </PropertyGroup>
   <ItemGroup>
     <PackageVersion Include="Extensions.MudBlazor.StaticInput" Version="4.1.0" />
+    <PackageVersion Include="FluentStorage" Version="8.0.16" />
+    <PackageVersion Include="FluentStorage.AWS" Version="8.0.10" />
     <PackageVersion Include="FluentValidation" Version="12.1.1" />
     <PackageVersion Include="Grpc.AspNetCore" Version="2.64.0" />
     <PackageVersion Include="Microsoft.Extensions.Localization" Version="10.0.9" />

src/Somnia.GuestLog/Components/App.razor

@@ -23,6 +23,7 @@
     <ReconnectModal />
     <script src="@Assets["_framework/blazor.web.js"]"></script>
     <script src="@Assets["_content/MudBlazor/MudBlazor.min.js"]"></script>
+    <script src="js/App.js"></script>
 </body>
 
 </html>

src/Somnia.GuestLog/Components/Controls/GuestDocumentSearchDialog.razor

@@ -1,9 +1,10 @@
 @using Somnia.GuestLog.Models.DTOs;
 @using Somnia.GuestLog.Services
+@using Somnia.GuestLog.Services.Entity
 
 @inject ILogger<AddressQueryDialog> logger;
 @inject IUserMessageService userMessage
-@inject IGuestDocumentService guestDocumentService;
+@inject IGuestDocumentEntityService guestDocumentService;
 
 
 <MudDialog Style="max-height: 90%;">
@@ -77,7 +78,10 @@
     private IMudDialogInstance MudDialog { get; set; } = null!;
 
 
-    private GuestDocFilterDTO filter { get; set; } = new();
+    private GuestDocFilterDTO filter { get; set; } = new()
+    {
+        OnlyLastVersion = true
+    };
     private IEnumerable<GuestDocumentDTO> results = [];
     private GuestDocumentDTO? SelectedResult { get; set; }
 

src/Somnia.GuestLog/Components/Forms/StayEntryForm.razor

@@ -95,7 +95,7 @@
                         {
                             <MudTd DataLabel="@LanguageLocale.general_actions">
                                 <MudIconButton Icon="@Icons.Material.Filled.Delete"
-                                               OnClick="@(() => BtnDeleteGuest(context.DocumentType!, context.DocumentNum!))" />
+                                               OnClick="@(() => BtnDeleteGuest(context.Id!.Value, context.Version!.Value))" />
                             </MudTd>
                         }
                         @if (ReadOnly)
@@ -229,8 +229,7 @@
         //Check if this guest is already added.
         if (Model.GuestDocuments.Count > 0)
         {
-            bool alreadyAdded = Model.GuestDocuments.Any(e => e.DocumentType == resultData.DocumentType
+            bool alreadyAdded = Model.GuestDocuments.Any(e => e.Id == resultData.Id);
-                && e.DocumentNum == resultData.DocumentNum);
             if (alreadyAdded)
             {
                 userMessage.ShowMessage("GuestDocument already added!", MessageKind.Warning);
@@ -241,13 +240,13 @@
         Model.GuestDocuments.Add(resultData);
     }
 
-    private void BtnDeleteGuest(string docType, string docNum)
+    private void BtnDeleteGuest(long guestDocId, int version)
     {
         Debug.Assert(Model.GuestDocuments is not null);
 
         //Filter out given GuestDocument from model.
         Model.GuestDocuments = Model.GuestDocuments
-            .Where(e => !(e.DocumentType == docType && e.DocumentNum == docNum))
+            .Where(e => !(e.Id == guestDocId && e.Version == version))
             .ToList();
     }
 

src/Somnia.GuestLog/Components/Layout/NavMenu.razor

@@ -13,4 +13,7 @@
     <MudNavLink Href="@GuestConsts.Page_StayEntry_List" Match="NavLinkMatch.Prefix" Icon="@Icons.Material.Filled.Book">
         @LanguageLocale.navMenu_StayEntryList
     </MudNavLink>
+    <MudNavLink Href="@GuestConsts.Page_StayExport_List" Match="NavLinkMatch.Prefix" Icon="@Icons.Material.Filled.ImportExport">
+        @LanguageLocale.navMenu_StayExport
+    </MudNavLink>
 </MudNavMenu>

src/Somnia.GuestLog/Components/Pages/GuestDocuments/GuestDocDetail.razor

@@ -7,14 +7,14 @@
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
 @inject NavigationManager Navigation
-@inject IGuestDocumentService guestDocService
+@inject IGuestDocumentEntityService guestDocService
-@inject IStayEntryService stayService
+@inject IStayEntryEntityService stayService
 
 
 <PageTitle>Somnia - Guest Docs - Details</PageTitle>
 
 <MudStack Row="true" Class="my-4">
-    <MudText Typo="Typo.h4" GutterBottom="true">Guest Document - "@docId"</MudText>
+    <MudText Typo="Typo.h4" GutterBottom="true">Guest Document: @docId - @documentModel?.FullDocument</MudText>
     <MudSpacer />
     <MudButton Variant="Variant.Filled" Color="Color.Success" Size="Size.Small" StartIcon="@Icons.Material.Filled.Edit"
                OnClick="() => BtnEdit()" Disabled>
@@ -77,7 +77,7 @@
 @code {
 
     [Parameter]
-    public string? docId { get; set; }
+    public long docId { get; set; }
 
     GuestDocForm _form = null!;
 
@@ -90,23 +90,8 @@
 
     protected override async Task OnInitializedAsync()
     {
-        if (docId is null)
-        {
-            userMessage.ShowMessage("No GuestDocument provided!!", MessageKind.Error);
-            Navigation.NotFound();
-            return;
-        }
-
-        GuestDocIdDTO? docIdModel = GuestDocIdDTO.DecodeFromString(docId);
-        if (docIdModel is null)
-        {
-            userMessage.ShowMessage($"Provided GuestDocId can't be decoded: '{docId}'", MessageKind.Error);
-            Navigation.NotFound();
-            return;
-        }
-
         //Get model from db.
-        documentModel = await guestDocService.GetDtoByIdAsync(docIdModel.DocumentType, docIdModel.DocumentNum);
+        documentModel = await guestDocService.GetLastVersionDtoByIdAsync(docId);
         if (documentModel is null)
         {
             userMessage.ShowMessage($"GuestDocument not found with ID: '{docId}'", MessageKind.Error);
@@ -123,13 +108,13 @@
             return;
         }
 
-        if (documentModel is null || documentModel.DocumentType is null || documentModel.DocumentNum is null)
+        if (documentModel is null || documentModel.Id is null || documentModel.Version is null)
         {
             throw new InvalidOperationException();
         }
 
         guestStaysLoading = true;
-        guestStayList = await stayService.GetStaysWithGuest(documentModel.DocumentType, documentModel.DocumentNum);
+        guestStayList = await stayService.GetStaysWithGuest(documentModel.Id.Value);
         guestStaysLoading = false;
     }
 

src/Somnia.GuestLog/Components/Pages/GuestDocuments/GuestDocList.razor

@@ -3,7 +3,7 @@
 @using Somnia.GuestLog.Models.DTOs;
 @using Somnia.GuestLog.Services;
 
-@inject IGuestDocumentService GuestDocService
+@inject IGuestDocumentEntityService GuestDocService
 @inject NavigationManager Navigation
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
@@ -43,6 +43,8 @@
         </MudStack>
     </ToolBarContent>
     <Columns>
+        <PropertyColumn Property="x => x.Id" Title="@LanguageLocale.dto_GuestDocument_Id" />
+        <PropertyColumn Property="x => x.Version" Title="@LanguageLocale.dto_GuestDocument_Version" />
         <PropertyColumn Title="@LanguageLocale.dto_GuestDocument_DocumentType"
                         Property="x => dataListService.GetLocalizedValue(GuestConsts.DataList_DocumentTypes, x.DocumentType)"
                         Hideable="false" />
@@ -50,6 +52,7 @@
                         Title="@LanguageLocale.dto_GuestDocument_DocumentNum" />
         <PropertyColumn Property="x => x.Name" Title="@LanguageLocale.dto_GuestDocument_Name" />
         <PropertyColumn Property="x => x.Surname" Title="@LanguageLocale.dto_GuestDocument_Surname" />
+        <PropertyColumn Property="x => x.Surname2" Title="@LanguageLocale.dto_GuestDocument_Surname2" />
         <PropertyColumn Title="@LanguageLocale.dto_GuestDocument_Nationality"
                         Property="x => dataListService.GetLocalizedValue(GuestConsts.DataList_CountryCodes, x.Nationality)" />
         <PropertyColumn Property="x => x.UpdateTime" Title="@LanguageLocale.dto_GuestDocument_UpdateTime" />
@@ -126,10 +129,9 @@
 
     private async Task BtnViewDetails(GuestDocumentDTO item)
     {
-        GuestDocIdDTO idDto = GuestDocIdDTO.BuildFromDto(item) ?? throw new InvalidOperationException();
+        string strId = item.Id?.ToString() ?? throw new InvalidOperationException();
 
-        string itemId = GuestDocIdDTO.EncodeAsString(idDto);
+        string uri = GuestConsts.Page_GuestDocs_Detail.Replace(GuestConsts.Page_GuestDocs_Detail_Param_DocId, strId);
-        string uri = GuestConsts.Page_GuestDocs_Detail.Replace(GuestConsts.Page_GuestDocs_Detail_Param_DocId, itemId);
         Navigation.NavigateTo(uri);
     }
 
@@ -151,7 +153,7 @@
         }
 
         userMessage.ShowMessage($"Document {item.DocumentType}-{item.DocumentNum} deleted!", MessageKind.Success);
-        await LoadDataAsync();
+        await LoadDataAsync(showMsg: false);
     }
 
     private void BtnNewGuest()

src/Somnia.GuestLog/Components/Pages/GuestDocuments/GuestDocNew.razor

@@ -7,7 +7,7 @@
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
 @inject NavigationManager Navigation
-@inject IGuestDocumentService guestDocService
+@inject IGuestDocumentEntityService guestDocService
 @inject IDataListService dataListService;
 
 @inject FluentValidation.IValidator<GuestDocIdDTO> docIdValidator;
@@ -82,6 +82,7 @@
 
     ePageMode currentPageMode = ePageMode.selectDocId;
     GuestDocIdDTO currentDocId = new() { DocumentNum = "", DocumentType = "" };
+    long? alreadyExistDocId = null;
     GuestDocumentDTO newDocumentModel = new();
 
     bool loadingDocId = false;
@@ -100,7 +101,8 @@
         }
 
         loadingDocId = true;
-        GuestDocumentDTO? dto = await guestDocService.GetDtoByIdAsync(currentDocId.DocumentType, currentDocId.DocumentNum);
+        GuestDocumentDTO? dto =
+            await guestDocService.GetLastVersionDtoByDocumentAsync(currentDocId.DocumentType, currentDocId.DocumentNum);
         loadingDocId = false;
 
         if (dto is null)
@@ -117,6 +119,7 @@
 
         //GuestDoc already exists!
         currentPageMode = ePageMode.alreadyExistDoc;
+        alreadyExistDocId = dto.Id;
     }
 
     private void BtnReturn()
@@ -153,14 +156,15 @@
 
     private void BtnGoToDocument()
     {
-        if (currentPageMode != ePageMode.alreadyExistDoc)
+        if (currentPageMode != ePageMode.alreadyExistDoc || alreadyExistDocId is null)
         {
             userMessage.ShowMessage("Invalid operation!", MessageKind.Error);
             return;
         }
 
-        string docId = GuestDocIdDTO.EncodeAsString(currentDocId);
+
-        string uri = GuestConsts.Page_GuestDocs_Detail.Replace("{docId}", docId);
+        string strId = alreadyExistDocId.Value.ToString();
+        string uri = GuestConsts.Page_GuestDocs_Detail.Replace(GuestConsts.Page_GuestDocs_Detail_Param_DocId, strId);
         Navigation.NavigateTo(uri);
     }
 

src/Somnia.GuestLog/Components/Pages/StayEntries/StayEntryDetail.razor

@@ -6,8 +6,8 @@
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
 @inject NavigationManager Navigation
-@inject IGuestDocumentService guestDocService
+@inject IGuestDocumentEntityService guestDocService
-@inject IStayEntryService stayService
+@inject IStayEntryEntityService stayService
 
 
 <PageTitle>Somnia - Guest Docs - Details</PageTitle>

src/Somnia.GuestLog/Components/Pages/StayEntries/StayEntryList.razor

@@ -3,7 +3,7 @@
 @using Somnia.GuestLog.Models.DTOs;
 @using Somnia.GuestLog.Services;
 
-@inject IStayEntryService StayEntryService
+@inject IStayEntryEntityService StayEntryService
 @inject NavigationManager Navigation
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
@@ -117,7 +117,7 @@
 
     private async Task BtnViewDetails(StayEntryDTO item)
     {
-        string itemId = $"{item.Id ?? -1}";
+        string itemId = item.Id?.ToString() ?? throw new InvalidOperationException();
         string uri = GuestConsts.Page_StayEntry_Detail.Replace(GuestConsts.Page_StayEntry_Detail_Param_Id, itemId);
         Navigation.NavigateTo(uri);
     }

src/Somnia.GuestLog/Components/Pages/StayEntries/StayEntryNew.razor

@@ -7,7 +7,7 @@
 @inject IUserMessageService userMessage
 @inject IDialogService DialogService
 @inject NavigationManager Navigation
-@inject IStayEntryService stayService
+@inject IStayEntryEntityService stayService
 @inject IDataListService dataListService;
 
 <PageTitle>Somnia - Stay Entries - New</PageTitle>

src/Somnia.GuestLog/Components/Pages/StayExport/StayExportList.razor

@@ -0,0 +1,197 @@
+@attribute [Route($"{GuestConsts.Page_StayExport_List}")]
+
+@using System.Text.Json;
+@using Somnia.GuestLog.Models.DTOs;
+@using Somnia.GuestLog.Services;
+@using Somnia.GuestLog.Services.StayExport;
+
+@inject IStayExportFileEntityService stayExportEntityService
+@inject NavigationManager Navigation
+@inject IUserMessageService userMessage
+@inject IDialogService DialogService
+@inject IDataListService dataListService;
+@inject ILocalizerService Localizer;
+
+@inject IStayExportService ExportService;
+@inject IJSRuntime JS
+
+
+<PageTitle>Somnia - Stay Export Files</PageTitle>
+
+<MudStack Row="true" Class="my-4">
+    <MudText Typo="Typo.h4" GutterBottom="true">@LanguageLocale.page_StayExportList_pageTitle</MudText>
+    <MudSpacer />
+    <MudButton Variant="Variant.Filled" Color="Color.Primary" Size="Size.Small"
+               StartIcon="@Icons.Material.Filled.Search" OnClick="() => BtnSearchDataAsync()">
+        @LanguageLocale.general_btnSearch
+    </MudButton>
+    <MudButton Variant="Variant.Filled" Color="Color.Primary" Size="Size.Small" StartIcon="@Icons.Material.Filled.Add"
+               OnClick="() => BtnNewExport()">
+        @LanguageLocale.page_StayExportList_btnNewExport
+    </MudButton>
+</MudStack>
+
+@* <MudPaper Class="pa-4 my-4" Elevation="2" Height="100%">
+    FILTER
+</MudPaper> *@
+
+<MudDataGrid @ref="_dataGrid" T="StayExportFileDTO" Items="@stayExportList" Loading="@_dataLoading" ReadOnly="true"
+             Elevation="2">
+    <ToolBarContent>
+        <MudText Typo="Typo.subtitle1">@LanguageLocale.page_StayExportList_exportList</MudText>
+    </ToolBarContent>
+    <Columns>
+        <PropertyColumn Property="x => x.Id" Hideable="false" Title="@LanguageLocale.dto_StayExportFile_Id" />
+        <PropertyColumn Property="x => Localizer.GetEnumValue(x.ExportFormat)"
+                        Title="@LanguageLocale.dto_StayExportFile_ExportFormat" />
+        <TemplateColumn Title="@LanguageLocale.dto_StayExportFile_ExportParams">
+            <CellTemplate>
+                <MudIconButton Size="@Size.Small" Icon="@Icons.Material.Outlined.Info"
+                               OnClick="() => ShowExportParams(context.Item)" />
+            </CellTemplate>
+        </TemplateColumn>
+        <PropertyColumn Property="x => Localizer.GetEnumValue(x.ExportResult)"
+                        Title="@LanguageLocale.dto_StayExportFile_ExportResult" />
+        <PropertyColumn Property="x => x.ExportTime" Title="@LanguageLocale.dto_StayExportFile_ExportTime" />
+        <TemplateColumn Title="@LanguageLocale.dto_StayExportFile_ExportDetails">
+            <CellTemplate>
+                <MudIconButton Size="@Size.Small" Icon="@Icons.Material.Outlined.Info"
+                               OnClick="() => ShowExportDetails(context.Item)" />
+            </CellTemplate>
+        </TemplateColumn>
+
+        <TemplateColumn CellClass="d-flex justify-between" Title="Options" StickyRight Hideable="false"
+                        ShowColumnOptions="false">
+            <CellTemplate>
+                <MudIconButton Size="@Size.Small" Icon="@Icons.Material.Outlined.Download"
+                               OnClick="() => BtnDownloadFile(context.Item)" />
+                <MudIconButton Size="@Size.Small" Icon="@Icons.Material.Outlined.Delete"
+                               OnClick="() => BtnDeleteItem(context.Item)" />
+            </CellTemplate>
+        </TemplateColumn>
+    </Columns>
+    <PagerContent>
+        <MudDataGridPager T="StayExportFileDTO" />
+    </PagerContent>
+</MudDataGrid>
+
+<ConfirmDeleteMsgBox @ref="_confirmDeleteMsgBox" />
+
+@code {
+    private bool _dataLoading = true;
+    private const int resultLimit = 200;
+
+    private IEnumerable<StayExportFileDTO> stayExportList = [];
+
+    private MudDataGrid<StayExportFileDTO> _dataGrid = null!;
+    private ConfirmDeleteMsgBox _confirmDeleteMsgBox = null!;
+
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadDataAsync(showMsg: false);
+    }
+
+    private async Task LoadDataAsync(bool showMsg = true)
+    {
+        _dataLoading = true;
+
+        stayExportList = await stayExportEntityService.GetDtoListAsync(limit: resultLimit);
+
+        if (showMsg)
+        {
+            userMessage.ShowMessage("Data loaded from DB", MessageKind.Info);
+        }
+        _dataLoading = false;
+    }
+
+
+    #region Event Handlers
+
+    private async Task BtnSearchDataAsync()
+    {
+        await LoadDataAsync();
+    }
+
+    private void BtnNewExport()
+    {
+        Navigation.NavigateTo(GuestConsts.Page_StayExport_New);
+    }
+
+
+    private async Task ShowExportParams(StayExportFileDTO dto)
+    {
+        string jsonParams = JsonSerializer.Serialize(dto.ExportParams, options: new() { WriteIndented = true });
+
+        await DialogService.ShowMessageBoxAsync("Details", (MarkupString)$"<pre>{jsonParams}</pre>");
+    }
+
+    private async Task ShowExportDetails(StayExportFileDTO dto)
+    {
+        if (string.IsNullOrEmpty(dto.ExportDetails))
+        {
+            userMessage.ShowMessage("This ExportFile doesn't have any export details", MessageKind.Info);
+            return;
+        }
+
+        using var jDoc = JsonDocument.Parse(dto.ExportDetails);
+        string jsonDetails = JsonSerializer.Serialize(jDoc, new JsonSerializerOptions { WriteIndented = true });
+
+        await DialogService.ShowMessageBoxAsync("Details", (MarkupString)$"<pre>{jsonDetails}</pre>");
+    }
+
+    private async Task BtnDownloadFile(StayExportFileDTO item)
+    {
+        if (item.ExportResult == Enums.Models.StayExportFileResult.NoData)
+        {
+            userMessage.ShowMessage("A Export without data can't be downloaded!", MessageKind.Warning);
+            return;
+        }
+
+        if (string.IsNullOrEmpty(item.ExportedPath))
+        {
+            userMessage.ShowMessage("File can't be downloaded: no path found!", MessageKind.Warning);
+            return;
+        }
+
+        using Stream objectStream = new MemoryStream();
+        Result loadResult = await ExportService.GetExportedFileAsync(item, objectStream);
+        if (!loadResult.IsSuccess)
+        {
+            userMessage.ShowResultWithMessage(loadResult, "Exported File can't be downloaded");
+            return;
+        }
+
+        objectStream.Seek(0, SeekOrigin.Begin);
+
+        using var streamRef = new DotNetStreamReference(stream: objectStream);
+
+        var fileName = Path.GetFileName(item.ExportedPath);
+        await JS.InvokeVoidAsync("downloadFileFromStream", fileName, streamRef);
+        userMessage.ShowMessage("Exported File downloaded!", MessageKind.Success);
+    }
+
+    private async Task BtnDeleteItem(StayExportFileDTO item)
+    {
+        bool? confirmDelete = await _confirmDeleteMsgBox.MsgBox.ShowAsync();
+
+        if (confirmDelete is null || confirmDelete.Value == false)
+        {
+            return;
+        }
+
+        Result deleteResult = await ExportService.DeleteExportedFileAsync(item);
+        if (!deleteResult.IsSuccess)
+        {
+            string errorMsg = $"Error deleting Export file {item.Id}";
+            userMessage.ShowResultWithMessage(deleteResult, errorMsg);
+            return;
+        }
+
+        userMessage.ShowMessage($"Export file {item.Id} deleted!", MessageKind.Success);
+        await LoadDataAsync();
+    }
+
+    #endregion
+
+}

src/Somnia.GuestLog/Components/Pages/StayExport/StayExportNew.razor

@@ -0,0 +1,162 @@
+@attribute [Route($"{GuestConsts.Page_StayExport_New}")]
+
+@using FluentValidation;
+@using Somnia.GuestLog.Models.DTOs;
+@using Somnia.GuestLog.Enums.Models;
+@using Somnia.GuestLog.Services;
+@using Somnia.GuestLog.Validators;
+@using Somnia.GuestLog.Services.StayExport;
+
+
+@inject IUserMessageService userMessage
+@inject IDialogService DialogService
+@inject NavigationManager Navigation
+@inject IValidator<StayExportParamsDTO> ExportParamsValidator;
+@inject ILocalizerService Localizer;
+@inject IStayExportService ExportService;
+
+@inject IJSRuntime JS
+
+
+<PageTitle>Somnia - Stay Export - New</PageTitle>
+
+<MudStack Row="true" Class="my-4">
+    <MudText Typo="Typo.h4" GutterBottom="true">
+        @LanguageLocale.page_StayExportNew_pageTitle
+    </MudText>
+    <MudSpacer />
+    <MudButton Variant="Variant.Filled" Color="Color.Success" Size="Size.Small" StartIcon="@Icons.Material.Filled.Add"
+               OnClick="() => BtnCreateExport()" Disabled="@_isExported">
+        @LanguageLocale.general_btnCreate
+    </MudButton>
+    <MudButton Variant="Variant.Filled" Color="Color.Default" Size="Size.Small"
+               StartIcon="@Icons.Material.Filled.ArrowBack" OnClick="() => BtnReturn()">
+        @LanguageLocale.general_btnReturn
+    </MudButton>
+</MudStack>
+
+<MudForm @ref="@_form" Model="@exportParams"
+         Validation="@((ExportParamsValidator as StayExportParamsDTOValidator)!.ValidateValue)" ReadOnly="@_isExported">
+    <MudPaper Class="pa-4 my-4" Elevation="3" Height="100%">
+        <MudStack Row style="margin-block: 0.2em;">
+            <MudSelect @bind-Value="exportFormat" Label="@LanguageLocale.dto_StayExportFile_ExportFormat" FullWidth
+                       Clearable>
+                @foreach (StayExportFormat option in Enum.GetValues<StayExportFormat>())
+                {
+                    <MudSelectItem Value="new Nullable<StayExportFormat>(option)">
+                        @Localizer.GetEnumValue(option)
+                    </MudSelectItem>
+                }
+            </MudSelect>
+            <MudSelect @bind-Value="exportParams.ExportType" For="@(() => exportParams.ExportType)"
+                       Label="@LanguageLocale.dto_StayExportParams_ExportType" FullWidth Clearable>
+                @foreach (StayExportParamType option in Enum.GetValues<StayExportParamType>())
+                {
+                    <MudSelectItem Value="new Nullable<StayExportParamType>(option)">
+                        @Localizer.GetEnumValue(option)
+                    </MudSelectItem>
+                }
+            </MudSelect>
+        </MudStack>
+    </MudPaper>
+    @if (_showPeriodFields)
+    {
+        <MudPaper Class="pa-4" Elevation="3" Height="100%">
+            <MudStack Row>
+                <MudDatePicker @bind-Date="exportParams.ExportPeriodStart" For="@(() => exportParams.ExportPeriodStart)"
+                               Label="@LanguageLocale.dto_StayExportParams_ExportPeriodStart" Clearable OpenTo="OpenTo.Date" Editable
+                               AutoClose="true" />
+                <MudDatePicker @bind-Date="exportParams.ExportPeriodEnd" For="@(() => exportParams.ExportPeriodEnd)"
+                               Label="@LanguageLocale.dto_StayExportParams_ExportPeriodEnd" Clearable OpenTo="OpenTo.Date" Editable
+                               AutoClose="true" />
+            </MudStack>
+        </MudPaper>
+    }
+
+</MudForm>
+
+@if (_isExported && exportedFile != null)
+{
+    <MudPaper Class="pa-4 my-6" Elevation="3" Height="100%">
+        <MudStack>
+            <MudText Typo="Typo.h4">File Exported!</MudText>
+            <MudTextField Value="@Localizer.GetEnumValue(exportedFile.ExportResult)"
+                          Label="@LanguageLocale.dto_StayExportFile_ExportResult" FullWidth ReadOnly="true" />
+            <MudTextField Value="@Localizer.GetEnumValue(exportedFile.ExportFormat)"
+                          Label="@LanguageLocale.dto_StayExportFile_ExportFormat" FullWidth ReadOnly="true" />
+            <MudButton OnClick="BtnDownloadExportedFile">Download Exported File</MudButton>
+        </MudStack>
+    </MudPaper>
+}
+
+@code {
+    MudForm _form = null!;
+
+    StayExportFormat? exportFormat = null;
+    StayExportParamsDTO exportParams = new();
+    StayExportFileDTO? exportedFile = null;
+
+    bool _showPeriodFields => exportParams.ExportType == StayExportParamType.PeriodDateIn;
+    bool _isExported => exportedFile != null;
+
+
+    private void BtnReturn()
+    {
+        Navigation.NavigateTo(GuestConsts.Page_StayExport_List);
+    }
+
+    private async Task BtnCreateExport()
+    {
+        await _form.ValidateAsync();
+        if (!_form.IsValid || exportFormat == null)
+        {
+            userMessage.ShowMessage("Invalid Form!", MessageKind.Warning);
+            return;
+        }
+
+        var loadingDialog = await DialogService.ShowAsync<LoadingDialog>();
+
+        var exportResult = await ExportService.ExportStaysByParamsAsync(exportFormat.Value, exportParams);
+        exportedFile = exportResult.Value;
+        loadingDialog.Close();
+
+        if (!exportResult.IsSuccess)
+        {
+            userMessage.ShowResultWithMessage(exportResult, $"Error exporting stays");
+            return;
+        }
+
+        userMessage.ShowMessage(
+            $"Stay exported: {exportResult.ResultCode} with export result: {exportedFile?.ExportResult}",
+            MessageKind.Success);
+    }
+
+    private async Task BtnDownloadExportedFile()
+    {
+        Debug.Assert(exportedFile != null);
+
+        if (string.IsNullOrEmpty(exportedFile.ExportedPath))
+        {
+            userMessage.ShowMessage("Exported File can't be downloaded as no file was saved", MessageKind.Warning);
+            return;
+        }
+
+        using Stream dataStream = new MemoryStream();
+
+        Result loadResult = await ExportService.GetExportedFileAsync(exportedFile, dataStream);
+        if (!loadResult.IsSuccess)
+        {
+            userMessage.ShowResultWithMessage(loadResult, "Exported File can't be downloaded");
+            return;
+        }
+
+        dataStream.Seek(0, SeekOrigin.Begin);
+        using var streamRef = new DotNetStreamReference(stream: dataStream);
+
+        var fileName = Path.GetFileName(exportedFile.ExportedPath);
+        await JS.InvokeVoidAsync("downloadFileFromStream", fileName, streamRef);
+
+        userMessage.ShowMessage("Exported File downloaded!", MessageKind.Success);
+    }
+
+}

src/Somnia.GuestLog/Components/Pages/_Imports.razor

@@ -1 +1,3 @@
-@using Somnia.GuestLog.Components.Controls
+@using Somnia.GuestLog.Components.Controls
+@using Somnia.GuestLog.Services.Entity;
+@using System.Diagnostics;

src/Somnia.GuestLog/Components/_Imports.razor

@@ -16,4 +16,4 @@
 @using Somnia.GuestLog.Components.Forms
 @using Somnia.GuestLog.Components.Controls
 @using Somnia.GuestLog.Resources
-@using MessageKind = Somnia.GuestLog.Services.IUserMessageService.MessageKind;
+@using Somnia.GuestLog.Enums.UI

src/Somnia.GuestLog/Enums/Models/StayExportFileResult.cs

@@ -0,0 +1,9 @@
+namespace Somnia.GuestLog.Enums.Models;
+
+public enum StayExportFileResult
+{
+    OK = 0,
+    NoData = 1,
+    ExportError = 2,
+    UploadError = 3,
+}

src/Somnia.GuestLog/Enums/Models/StayExportFormat.cs

@@ -0,0 +1,7 @@
+namespace Somnia.GuestLog.Enums.Models;
+
+public enum StayExportFormat
+{
+    GuestLogJson = 0,
+    SpainParteViajeros = 1,
+}

src/Somnia.GuestLog/Enums/Models/StayExportParamType.cs

@@ -0,0 +1,6 @@
+namespace Somnia.GuestLog.Enums.Models;
+
+public enum StayExportParamType
+{
+    PeriodDateIn = 0,
+}

src/Somnia.GuestLog/Enums/Services/AddressQueryProvider.cs

@@ -0,0 +1,7 @@
+namespace Somnia.GuestLog.Enums.Services;
+
+public enum AddressQueryProvider
+{
+    Nominatim,
+    GoogleApiV4
+}

src/Somnia.GuestLog/Enums/Services/ResultCode.cs

@@ -0,0 +1,15 @@
+namespace Somnia.GuestLog.Enums.Services;
+
+public enum ResultCode
+{
+    //Common Codes
+    Ok,
+    UnknownError,
+    FailedValidation,
+    NotFound,
+    FileStorageError,
+
+    //Specific Codes
+    GuestInStay,
+    GuestCurrentlyInStay,
+}

src/Somnia.GuestLog/Enums/UI/FormMode.cs

@@ -1,4 +1,4 @@
-namespace Somnia.GuestLog.Components.Forms;
+namespace Somnia.GuestLog.Enums.UI;
 
 public enum FormMode
 {

src/Somnia.GuestLog/Enums/UI/MessageKind.cs

@@ -0,0 +1,6 @@
+namespace Somnia.GuestLog.Enums.UI;
+
+public enum MessageKind
+{
+    Info, Warning, Error, Success, Normal
+}

src/Somnia.GuestLog/GuestConsts.cs

@@ -6,13 +6,16 @@ public static class GuestConsts
     public const string Page_GuestDocs_List = "/guest-documents";
     public const string Page_GuestDocs_New = "/guest-documents/new";
     public const string Page_GuestDocs_Detail = $"/guest-documents/d/{Page_GuestDocs_Detail_Param_DocId}";
-    public const string Page_GuestDocs_Detail_Param_DocId = "{docId}";
+    public const string Page_GuestDocs_Detail_Param_DocId = "{docId:long}";
 
     public const string Page_StayEntry_List = "/stayEntries";
     public const string Page_StayEntry_New = "/stayEntries/new";
     public const string Page_StayEntry_Detail = $"/stayEntries/d/{Page_StayEntry_Detail_Param_Id}";
     public const string Page_StayEntry_Detail_Param_Id = "{StayId:long}";
 
+    public const string Page_StayExport_List = "/stayExport";
+    public const string Page_StayExport_New = "/stayExport/new";
+
 
     public const string QueryParam_ReturnUrl = "returnUrl";
 
@@ -28,4 +31,13 @@ public static class GuestConsts
     public const string DocumentType_DNI = "DNI";
     public const string DocumentType_NIE = "NIE";
     public const string DocumentType_PASSPORT = "PASSPORT";
+
+    public const string GenderOptions_MALE = "M";
+    public const string GenderOptions_FEMALE = "F";
+    public const string GenderOptions_OTHER = "O";
+
+    public const int GuestDocument_FirstVersion = 1;
+
+
+    public const string EmptyField = "-";
 }

src/Somnia.GuestLog/Infrastructure/DbConsts.cs

@@ -5,4 +5,8 @@ public static class DbConsts
     public const string DbType_Timestamptz = "timestamp with time zone";
     public const string DbType_Timestamptz_0 = "timestamp(0) with time zone";
     public const string DbType_Timestamptz_3 = "timestamp(3) with time zone";
+
+    public const string DbType_jsonb = "jsonb";
+
+    public const string PK_NotApply = "N/A";
 }

src/Somnia.GuestLog/Infrastructure/EntityConfigs/GuestDocumentEntityConfig.cs

@@ -11,7 +11,13 @@ public class GuestDocumentEntityConfig : IEntityTypeConfiguration<GuestDocument>
         builder.ToTable("GuestDocument");
 
         //PK
-        builder.HasKey(e => new { e.DocumentType, e.DocumentNum });
+        builder.HasKey(e => new { e.Id, e.Version });
+
+        builder.Property(e => e.Id)
+            .UseIdentityByDefaultColumn();
+
+        builder.Property(e => e.Version)
+            .IsRequired();
 
         builder.Property(e => e.DocumentType)
             .IsRequired()
@@ -48,6 +54,15 @@ public class GuestDocumentEntityConfig : IEntityTypeConfiguration<GuestDocument>
         builder.Property(e => e.EmailAddress)
             .HasMaxLength(256);
 
+        builder.Property(e => e.CreateTime)
+            .IsRequired()
+            .HasColumnType(DbConsts.DbType_Timestamptz_3);
+        builder.Property(e => e.UpdateTime)
+            .IsRequired()
+            .HasColumnType(DbConsts.DbType_Timestamptz_3);
+        builder.Property(e => e.IsLastVersion)
+            .IsRequired();
+
 
         var addressBuilder = builder.ComplexProperty(e => e.AddressDetails);
 

src/Somnia.GuestLog/Infrastructure/EntityConfigs/StayExportFileEntityConfig.cs

@@ -0,0 +1,36 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Somnia.GuestLog.Models.Entities;
+
+namespace Somnia.GuestLog.Infrastructure.EntityConfigs;
+
+public class StayExportFileEntityConfig : IEntityTypeConfiguration<StayExportFile>
+{
+    public void Configure(EntityTypeBuilder<StayExportFile> builder)
+    {
+        builder.ToTable("StayExportFile");
+
+        //PK
+        builder.HasKey(e => e.Id);
+
+        builder.Property(e => e.Id)
+            .IsRequired()
+            .UseIdentityByDefaultColumn();
+
+        builder.ComplexProperty(e => e.ExportParams, e =>
+        {
+            e.ToJson();
+        });
+
+        builder.Property(e => e.ExportedPath)
+            .HasMaxLength(256);
+
+        builder.Property(e => e.ExportDetails)
+            .HasColumnType(DbConsts.DbType_jsonb);
+
+
+        builder.Property(e => e.ExportTime)
+            .IsRequired()
+            .HasColumnType(DbConsts.DbType_Timestamptz);
+    }
+}

src/Somnia.GuestLog/Infrastructure/GuestLogContext.cs

@@ -13,11 +13,14 @@ public partial class GuestLogContext : DbContext
     public DbSet<GuestDocument> GuestDocuments { get; set; }
     public DbSet<StayEntry> StayEntries { get; set; }
 
-    
+    public DbSet<StayExportFile> StayExportFiles { get; set; }
+
+
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
         modelBuilder.ApplyConfiguration<GuestDocument>(new GuestDocumentEntityConfig());
         modelBuilder.ApplyConfiguration<StayEntry>(new StayEntryEntityConfig());
+        modelBuilder.ApplyConfiguration<StayExportFile>(new StayExportFileEntityConfig());
 
         OnModelCreatingPartial(modelBuilder);
         base.OnModelCreating(modelBuilder);

src/Somnia.GuestLog/Infrastructure/Migrations/20260830201743_GuestDocument_ChangePKToIdAndVersion.Designer.cs

@@ -0,0 +1,205 @@
+// <auto-generated />
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+using Somnia.GuestLog.Infrastructure;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    [DbContext(typeof(GuestLogContext))]
+    [Migration("20260830201743_GuestDocument_ChangePKToIdAndVersion")]
+    partial class GuestDocument_ChangePKToIdAndVersion
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Proxies:ChangeTracking", false)
+                .HasAnnotation("Proxies:CheckEquality", false)
+                .HasAnnotation("Proxies:LazyLoading", true)
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.Property<long>("StayEntryId")
+                        .HasColumnType("bigint");
+
+                    b.Property<long>("GuestDocumentsId")
+                        .HasColumnType("bigint");
+
+                    b.Property<int>("GuestDocumentsVersion")
+                        .HasColumnType("integer");
+
+                    b.HasKey("StayEntryId", "GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.HasIndex("GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.ToTable("GuestDocumentStayEntry");
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.GuestDocument", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<int>("Version")
+                        .HasColumnType("integer");
+
+                    b.Property<DateOnly>("BirthDate")
+                        .HasColumnType("date");
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("DocumentNum")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("DocumentType")
+                        .IsRequired()
+                        .HasMaxLength(8)
+                        .HasColumnType("character varying(8)");
+
+                    b.Property<string>("EmailAddress")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("Gender")
+                        .HasMaxLength(1)
+                        .HasColumnType("character varying(1)");
+
+                    b.Property<DateOnly>("IssueDate")
+                        .HasColumnType("date");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Nationality")
+                        .IsRequired()
+                        .HasMaxLength(3)
+                        .HasColumnType("character varying(3)");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<string>("SupportNum")
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)");
+
+                    b.Property<string>("Surname")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Surname2")
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "AddressDetails", "Somnia.GuestLog.Models.Entities.GuestDocument.AddressDetails#GuestAddress", b1 =>
+                        {
+                            b1.Property<string>("Address")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCity")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCountry")
+                                .IsRequired()
+                                .HasMaxLength(3)
+                                .HasColumnType("character varying(3)");
+
+                            b1.Property<string>("AddressProvince")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressState")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("ZipCode")
+                                .HasMaxLength(12)
+                                .HasColumnType("character varying(12)");
+                        });
+
+                    b.HasKey("Id", "Version");
+
+                    b.ToTable("GuestDocument", (string)null);
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayEntry", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTime>("DateIn")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<DateTime>("DateOut")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<string>("PaymentMethod")
+                        .IsRequired()
+                        .HasMaxLength(5)
+                        .HasColumnType("character varying(5)");
+
+                    b.Property<int>("RoomCount")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("RoomNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayEntry", (string)null);
+                });
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.HasOne("Somnia.GuestLog.Models.Entities.StayEntry", null)
+                        .WithMany()
+                        .HasForeignKey("StayEntryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("Somnia.GuestLog.Models.Entities.GuestDocument", null)
+                        .WithMany()
+                        .HasForeignKey("GuestDocumentsId", "GuestDocumentsVersion")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/20260830201743_GuestDocument_ChangePKToIdAndVersion.cs

@@ -0,0 +1,101 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class GuestDocument_ChangePKToIdAndVersion : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            //Data don't really matter right now. Just get it working good.
+            //This migration will destry all data, but it's fine.
+
+            migrationBuilder.DropTable(
+                name: "GuestDocumentStayEntry"
+            );
+
+            migrationBuilder.Sql("""DELETE FROM "StayEntry";""");
+
+            migrationBuilder.DropTable(
+                name: "GuestDocument"
+            );
+
+            migrationBuilder.CreateTable(
+                name: "GuestDocument",
+                columns: table => new
+                {
+                    Id = table.Column<long>(type: "bigint", nullable: false)
+                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+                    Version = table.Column<int>(type: "integer", nullable: false),
+                    DocumentType = table.Column<string>(type: "character varying(8)", maxLength: 8, nullable: false),
+                    DocumentNum = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false),
+                    IssueDate = table.Column<DateOnly>(type: "date", nullable: false),
+                    SupportNum = table.Column<string>(type: "character varying(10)", maxLength: 10, nullable: true),
+                    Nationality = table.Column<string>(type: "character varying(3)", maxLength: 3, nullable: false),
+                    Name = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false),
+                    Surname = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false),
+                    Surname2 = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
+                    BirthDate = table.Column<DateOnly>(type: "date", nullable: false),
+                    Gender = table.Column<string>(type: "character varying(1)", maxLength: 1, nullable: true),
+                    PhoneNumber = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: true),
+                    EmailAddress = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    CreateTime = table.Column<DateTime>(type: "timestamp(3) with time zone", nullable: false),
+                    UpdateTime = table.Column<DateTime>(type: "timestamp(3) with time zone", nullable: false),
+                    IsLastVersion = table.Column<bool>(type: "boolean", nullable: false),
+                    AddressDetails_Address = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AddressDetails_AddressCity = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AddressDetails_AddressCountry = table.Column<string>(type: "character varying(3)", maxLength: 3, nullable: true),
+                    AddressDetails_AddressProvince = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AddressDetails_AddressState = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AddressDetails_ZipCode = table.Column<string>(type: "character varying(12)", maxLength: 12, nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_GuestDocument", x => new { x.Id, x.Version });
+                }
+            );
+
+
+            //Existing index for "DocType" and "DocNum" can be useful, so let's keep it.
+            migrationBuilder.CreateTable(
+                name: "GuestDocumentStayEntry",
+                columns: table => new
+                {
+                    StayEntryId = table.Column<long>(type: "bigint", nullable: false),
+                    GuestDocumentsId = table.Column<long>(type: "bigint", nullable: false),
+                    GuestDocumentsVersion = table.Column<int>(type: "integer", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_GuestDocumentStayEntry", x => new { x.StayEntryId, x.GuestDocumentsId, x.GuestDocumentsVersion });
+                    table.ForeignKey(
+                        name: "FK_GuestDocumentStayEntry_GuestDocument_GuestDocumentsId_Guest~",
+                        columns: x => new { x.GuestDocumentsId, x.GuestDocumentsVersion },
+                        principalTable: "GuestDocument",
+                        principalColumns: new[] { "Id", "Version" },
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_GuestDocumentStayEntry_StayEntry_StayEntryId",
+                        column: x => x.StayEntryId,
+                        principalTable: "StayEntry",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_GuestDocumentStayEntry_GuestDocumentsId_GuestDocumentsVersi~",
+                table: "GuestDocumentStayEntry",
+                columns: new[] { "GuestDocumentsId", "GuestDocumentsVersion" });
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            throw new NotSupportedException("Rollback is not supported for this migration!");
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/20260901161146_AddTable_StayExportFile.Designer.cs

@@ -0,0 +1,249 @@
+// <auto-generated />
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+using Somnia.GuestLog.Infrastructure;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    [DbContext(typeof(GuestLogContext))]
+    [Migration("20260901161146_AddTable_StayExportFile")]
+    partial class AddTable_StayExportFile
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Proxies:ChangeTracking", false)
+                .HasAnnotation("Proxies:CheckEquality", false)
+                .HasAnnotation("Proxies:LazyLoading", true)
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.Property<long>("StayEntryId")
+                        .HasColumnType("bigint");
+
+                    b.Property<long>("GuestDocumentsId")
+                        .HasColumnType("bigint");
+
+                    b.Property<int>("GuestDocumentsVersion")
+                        .HasColumnType("integer");
+
+                    b.HasKey("StayEntryId", "GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.HasIndex("GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.ToTable("GuestDocumentStayEntry");
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.GuestDocument", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<int>("Version")
+                        .HasColumnType("integer");
+
+                    b.Property<DateOnly>("BirthDate")
+                        .HasColumnType("date");
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp(3) with time zone");
+
+                    b.Property<string>("DocumentNum")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("DocumentType")
+                        .IsRequired()
+                        .HasMaxLength(8)
+                        .HasColumnType("character varying(8)");
+
+                    b.Property<string>("EmailAddress")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("Gender")
+                        .HasMaxLength(1)
+                        .HasColumnType("character varying(1)");
+
+                    b.Property<bool>("IsLastVersion")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateOnly>("IssueDate")
+                        .HasColumnType("date");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Nationality")
+                        .IsRequired()
+                        .HasMaxLength(3)
+                        .HasColumnType("character varying(3)");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<string>("SupportNum")
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)");
+
+                    b.Property<string>("Surname")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Surname2")
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp(3) with time zone");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "AddressDetails", "Somnia.GuestLog.Models.Entities.GuestDocument.AddressDetails#GuestAddress", b1 =>
+                        {
+                            b1.Property<string>("Address")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCity")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCountry")
+                                .IsRequired()
+                                .HasMaxLength(3)
+                                .HasColumnType("character varying(3)");
+
+                            b1.Property<string>("AddressProvince")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressState")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("ZipCode")
+                                .HasMaxLength(12)
+                                .HasColumnType("character varying(12)");
+                        });
+
+                    b.HasKey("Id", "Version");
+
+                    b.ToTable("GuestDocument", (string)null);
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayEntry", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTime>("DateIn")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<DateTime>("DateOut")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<string>("PaymentMethod")
+                        .IsRequired()
+                        .HasMaxLength(5)
+                        .HasColumnType("character varying(5)");
+
+                    b.Property<int>("RoomCount")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("RoomNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayEntry", (string)null);
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayExportFile", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<int>("ExportFormat")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ExportResult")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime>("ExportTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("ExportedPath")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "ExportParams", "Somnia.GuestLog.Models.Entities.StayExportFile.ExportParams#StayExportParams", b1 =>
+                        {
+                            b1.IsRequired();
+
+                            b1.Property<DateTime?>("ExportPeriodEnd");
+
+                            b1.Property<DateTime?>("ExportPeriodStart");
+
+                            b1.Property<int>("ExportType");
+
+                            b1
+                                .ToJson("ExportParams")
+                                .HasColumnType("jsonb");
+                        });
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayExportFile", (string)null);
+                });
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.HasOne("Somnia.GuestLog.Models.Entities.StayEntry", null)
+                        .WithMany()
+                        .HasForeignKey("StayEntryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("Somnia.GuestLog.Models.Entities.GuestDocument", null)
+                        .WithMany()
+                        .HasForeignKey("GuestDocumentsId", "GuestDocumentsVersion")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/20260901161146_AddTable_StayExportFile.cs

@@ -0,0 +1,40 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddTable_StayExportFile : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "StayExportFile",
+                columns: table => new
+                {
+                    Id = table.Column<long>(type: "bigint", nullable: false)
+                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+                    ExportFormat = table.Column<int>(type: "integer", nullable: false),
+                    ExportResult = table.Column<int>(type: "integer", nullable: false),
+                    ExportedPath = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    ExportTime = table.Column<DateTime>(type: "timestamp with time zone", nullable: false),
+                    ExportParams = table.Column<string>(type: "jsonb", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_StayExportFile", x => x.Id);
+                });
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "StayExportFile");
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/20260908172441_StayExportFile_AddColumn_ExportDetails.Designer.cs

@@ -0,0 +1,252 @@
+// <auto-generated />
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+using Somnia.GuestLog.Infrastructure;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    [DbContext(typeof(GuestLogContext))]
+    [Migration("20260908172441_StayExportFile_AddColumn_ExportDetails")]
+    partial class StayExportFile_AddColumn_ExportDetails
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Proxies:ChangeTracking", false)
+                .HasAnnotation("Proxies:CheckEquality", false)
+                .HasAnnotation("Proxies:LazyLoading", true)
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.Property<long>("StayEntryId")
+                        .HasColumnType("bigint");
+
+                    b.Property<long>("GuestDocumentsId")
+                        .HasColumnType("bigint");
+
+                    b.Property<int>("GuestDocumentsVersion")
+                        .HasColumnType("integer");
+
+                    b.HasKey("StayEntryId", "GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.HasIndex("GuestDocumentsId", "GuestDocumentsVersion");
+
+                    b.ToTable("GuestDocumentStayEntry");
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.GuestDocument", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<int>("Version")
+                        .HasColumnType("integer");
+
+                    b.Property<DateOnly>("BirthDate")
+                        .HasColumnType("date");
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp(3) with time zone");
+
+                    b.Property<string>("DocumentNum")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("DocumentType")
+                        .IsRequired()
+                        .HasMaxLength(8)
+                        .HasColumnType("character varying(8)");
+
+                    b.Property<string>("EmailAddress")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("Gender")
+                        .HasMaxLength(1)
+                        .HasColumnType("character varying(1)");
+
+                    b.Property<bool>("IsLastVersion")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateOnly>("IssueDate")
+                        .HasColumnType("date");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Nationality")
+                        .IsRequired()
+                        .HasMaxLength(3)
+                        .HasColumnType("character varying(3)");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<string>("SupportNum")
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)");
+
+                    b.Property<string>("Surname")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("Surname2")
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp(3) with time zone");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "AddressDetails", "Somnia.GuestLog.Models.Entities.GuestDocument.AddressDetails#GuestAddress", b1 =>
+                        {
+                            b1.Property<string>("Address")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCity")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressCountry")
+                                .IsRequired()
+                                .HasMaxLength(3)
+                                .HasColumnType("character varying(3)");
+
+                            b1.Property<string>("AddressProvince")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("AddressState")
+                                .HasMaxLength(128)
+                                .HasColumnType("character varying(128)");
+
+                            b1.Property<string>("ZipCode")
+                                .HasMaxLength(12)
+                                .HasColumnType("character varying(12)");
+                        });
+
+                    b.HasKey("Id", "Version");
+
+                    b.ToTable("GuestDocument", (string)null);
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayEntry", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<DateTime>("CreateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTime>("DateIn")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<DateTime>("DateOut")
+                        .HasColumnType("timestamp(0) with time zone");
+
+                    b.Property<string>("PaymentMethod")
+                        .IsRequired()
+                        .HasMaxLength(5)
+                        .HasColumnType("character varying(5)");
+
+                    b.Property<int>("RoomCount")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("RoomNumber")
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<DateTime>("UpdateTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayEntry", (string)null);
+                });
+
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayExportFile", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<string>("ExportDetails")
+                        .HasColumnType("jsonb");
+
+                    b.Property<int>("ExportFormat")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ExportResult")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime>("ExportTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("ExportedPath")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "ExportParams", "Somnia.GuestLog.Models.Entities.StayExportFile.ExportParams#StayExportParams", b1 =>
+                        {
+                            b1.IsRequired();
+
+                            b1.Property<DateTime?>("ExportPeriodEnd");
+
+                            b1.Property<DateTime?>("ExportPeriodStart");
+
+                            b1.Property<int>("ExportType");
+
+                            b1
+                                .ToJson("ExportParams")
+                                .HasColumnType("jsonb");
+                        });
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayExportFile", (string)null);
+                });
+
+            modelBuilder.Entity("GuestDocumentStayEntry", b =>
+                {
+                    b.HasOne("Somnia.GuestLog.Models.Entities.StayEntry", null)
+                        .WithMany()
+                        .HasForeignKey("StayEntryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("Somnia.GuestLog.Models.Entities.GuestDocument", null)
+                        .WithMany()
+                        .HasForeignKey("GuestDocumentsId", "GuestDocumentsVersion")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/20260908172441_StayExportFile_AddColumn_ExportDetails.cs

@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Somnia.GuestLog.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class StayExportFile_AddColumn_ExportDetails : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "ExportDetails",
+                table: "StayExportFile",
+                type: "jsonb",
+                nullable: true);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "ExportDetails",
+                table: "StayExportFile");
+        }
+    }
+}

src/Somnia.GuestLog/Infrastructure/Migrations/GuestLogContextModelSnapshot.cs

@@ -19,6 +19,9 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
 #pragma warning disable 612, 618
             modelBuilder
                 .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Proxies:ChangeTracking", false)
+                .HasAnnotation("Proxies:CheckEquality", false)
+                .HasAnnotation("Proxies:LazyLoading", true)
                 .HasAnnotation("Relational:MaxIdentifierLength", 63);
 
             NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
@@ -28,34 +31,45 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
                     b.Property<long>("StayEntryId")
                         .HasColumnType("bigint");
 
-                    b.Property<string>("GuestDocumentsDocumentType")
+                    b.Property<long>("GuestDocumentsId")
-                        .HasColumnType("character varying(8)");
+                        .HasColumnType("bigint");
 
-                    b.Property<string>("GuestDocumentsDocumentNum")
+                    b.Property<int>("GuestDocumentsVersion")
-                        .HasColumnType("character varying(64)");
+                        .HasColumnType("integer");
 
-                    b.HasKey("StayEntryId", "GuestDocumentsDocumentType", "GuestDocumentsDocumentNum");
+                    b.HasKey("StayEntryId", "GuestDocumentsId", "GuestDocumentsVersion");
 
-                    b.HasIndex("GuestDocumentsDocumentType", "GuestDocumentsDocumentNum");
+                    b.HasIndex("GuestDocumentsId", "GuestDocumentsVersion");
 
                     b.ToTable("GuestDocumentStayEntry");
                 });
 
             modelBuilder.Entity("Somnia.GuestLog.Models.Entities.GuestDocument", b =>
                 {
-                    b.Property<string>("DocumentType")
+                    b.Property<long>("Id")
-                        .HasMaxLength(8)
+                        .ValueGeneratedOnAdd()
-                        .HasColumnType("character varying(8)");
+                        .HasColumnType("bigint");
 
-                    b.Property<string>("DocumentNum")
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
-                        .HasMaxLength(64)
+
-                        .HasColumnType("character varying(64)");
+                    b.Property<int>("Version")
+                        .HasColumnType("integer");
 
                     b.Property<DateOnly>("BirthDate")
                         .HasColumnType("date");
 
                     b.Property<DateTime>("CreateTime")
-                        .HasColumnType("timestamp with time zone");
+                        .HasColumnType("timestamp(3) with time zone");
+
+                    b.Property<string>("DocumentNum")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("DocumentType")
+                        .IsRequired()
+                        .HasMaxLength(8)
+                        .HasColumnType("character varying(8)");
 
                     b.Property<string>("EmailAddress")
                         .HasMaxLength(256)
@@ -65,6 +79,9 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
                         .HasMaxLength(1)
                         .HasColumnType("character varying(1)");
 
+                    b.Property<bool>("IsLastVersion")
+                        .HasColumnType("boolean");
+
                     b.Property<DateOnly>("IssueDate")
                         .HasColumnType("date");
 
@@ -96,7 +113,7 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
                         .HasColumnType("character varying(64)");
 
                     b.Property<DateTime>("UpdateTime")
-                        .HasColumnType("timestamp with time zone");
+                        .HasColumnType("timestamp(3) with time zone");
 
                     b.ComplexProperty(typeof(Dictionary<string, object>), "AddressDetails", "Somnia.GuestLog.Models.Entities.GuestDocument.AddressDetails#GuestAddress", b1 =>
                         {
@@ -126,7 +143,7 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
                                 .HasColumnType("character varying(12)");
                         });
 
-                    b.HasKey("DocumentType", "DocumentNum");
+                    b.HasKey("Id", "Version");
 
                     b.ToTable("GuestDocument", (string)null);
                 });
@@ -168,6 +185,50 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
                     b.ToTable("StayEntry", (string)null);
                 });
 
+            modelBuilder.Entity("Somnia.GuestLog.Models.Entities.StayExportFile", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<string>("ExportDetails")
+                        .HasColumnType("jsonb");
+
+                    b.Property<int>("ExportFormat")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ExportResult")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime>("ExportTime")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("ExportedPath")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.ComplexProperty(typeof(Dictionary<string, object>), "ExportParams", "Somnia.GuestLog.Models.Entities.StayExportFile.ExportParams#StayExportParams", b1 =>
+                        {
+                            b1.IsRequired();
+
+                            b1.Property<DateTime?>("ExportPeriodEnd");
+
+                            b1.Property<DateTime?>("ExportPeriodStart");
+
+                            b1.Property<int>("ExportType");
+
+                            b1
+                                .ToJson("ExportParams")
+                                .HasColumnType("jsonb");
+                        });
+
+                    b.HasKey("Id");
+
+                    b.ToTable("StayExportFile", (string)null);
+                });
+
             modelBuilder.Entity("GuestDocumentStayEntry", b =>
                 {
                     b.HasOne("Somnia.GuestLog.Models.Entities.StayEntry", null)
@@ -178,7 +239,7 @@ namespace Somnia.GuestLog.Infrastructure.Migrations
 
                     b.HasOne("Somnia.GuestLog.Models.Entities.GuestDocument", null)
                         .WithMany()
-                        .HasForeignKey("GuestDocumentsDocumentType", "GuestDocumentsDocumentNum")
+                        .HasForeignKey("GuestDocumentsId", "GuestDocumentsVersion")
                         .OnDelete(DeleteBehavior.Cascade)
                         .IsRequired();
                 });

src/Somnia.GuestLog/Models/Configuration/AddressQueryConfig.cs

@@ -1,3 +1,5 @@
+using Somnia.GuestLog.Enums.Services;
+
 namespace Somnia.GuestLog.Models.Configuration;
 
 public class AddressQueryConfig
@@ -5,18 +7,10 @@ public class AddressQueryConfig
     public const string SectionName = "AddressQuery";
 
     public bool EnableAddressQuery { get; set; }
-    public AddressQueryProviderEnum? Provider { get; set; }
+    public AddressQueryProvider? Provider { get; set; }
     public string? ServiceURL { get; set; }
     public string? ApiKey { get; set; }
     public string? UserAgent { get; set; }
     public string? ResultLang { get; set; }
-
-
-    public enum AddressQueryProviderEnum
-    {
-        Nominatim,
-        GoogleApiV4
-    }
-
 }
 

src/Somnia.GuestLog/Models/Configuration/StayExportConfig.cs

@@ -0,0 +1,10 @@
+namespace Somnia.GuestLog.Models.Configuration;
+
+public class StayExportConfig
+{
+    public const string SectionName = "StayExport";
+
+    public bool EnableStayExport { get; set; } = false;
+    public string? ExportStorageConnectionString { get; set; }
+    public bool UseSubdirectoryByFormat { get; set; }
+}

src/Somnia.GuestLog/Models/Configuration/StayExportSpainParteViajerosConfig.cs

@@ -0,0 +1,9 @@
+namespace Somnia.GuestLog.Models.Configuration;
+
+public class StayExportSpainParteViajerosConfig
+{
+    public const string SectionName = "StayExportSpainParteViajeros";
+
+    public bool InternetAvailable { get; set; } = false;
+    public string? CodigoEstablecimiento { get; set; }
+}

src/Somnia.GuestLog/Models/DTOs/GuestDocFilterDTO.cs

@@ -10,6 +10,8 @@ public class GuestDocFilterDTO
 
     public string? PhoneNumber { get; set; }
 
+    public bool OnlyLastVersion { get; set; }
+
 
     public bool IsEmpty => string.IsNullOrEmpty(DocumentType)
             && string.IsNullOrEmpty(DocumentNumber)

src/Somnia.GuestLog/Models/DTOs/GuestDocumentDTO.cs

@@ -2,6 +2,9 @@ namespace Somnia.GuestLog.Models.DTOs;
 
 public class GuestDocumentDTO
 {
+    public long? Id { get; set; }
+    public int? Version { get; set; }
+
     public string? DocumentType { get; set; }
     public string? DocumentNum { get; set; }
 
@@ -33,5 +36,6 @@ public class GuestDocumentDTO
     public DateTime? UpdateTime { get; set; }
 
 
-    public string FullKey => $"{DocumentType}-{DocumentNum}";
+    public string FullKey => $"{Id}-{Version}";
+    public string FullDocument => $"{DocumentType ?? "???"}-{DocumentNum ?? "???"}";
 }

src/Somnia.GuestLog/Models/DTOs/Result.cs

@@ -1,24 +1,42 @@
+using Somnia.GuestLog.Enums.Services;
+
 namespace Somnia.GuestLog.Models.DTOs;
 
-public sealed record Result(bool IsSuccess, string ResultCode, params object[]? Context)
+public interface IResult
 {
-    public static Result Ok() => new(IsSuccess: true, ResultCode: Models.ResultCode.Ok, Context: null);
+    bool IsSuccess { get; }
-
+    ResultCode ResultCode { get; }
-    public static Result Fail(string resultCode) => new(IsSuccess: false, resultCode, Context: null);
+    object[]? Context { get; }
-    public static Result FailWithContext(string resultCode, params object[] context)
-        => new(IsSuccess: false, resultCode, context);
-    public static Result FailUnknownError()
-        => new(IsSuccess: false, ResultCode: Models.ResultCode.UnknownError, Context: null);
-
-    public bool IsUnknownError => !IsSuccess && ResultCode == Models.ResultCode.UnknownError;
 }
 
-public sealed record Result<T>(bool IsSuccess, T? Value, string ResultCode, params object[]? Context)
+public sealed record Result(
+    bool IsSuccess,
+    ResultCode ResultCode,
+    params object[]? Context
+) : IResult
 {
-    public static Result<T> Ok(T value) => new(IsSuccess: true, value, ResultCode: Models.ResultCode.Ok, Context: null);
+    public static Result Ok() => new(IsSuccess: true, ResultCode: ResultCode.Ok, Context: null);
-    public static Result<T> Fail(string resultCode) => new(IsSuccess: false, Value: default, resultCode, Context: null);
+
-    public static Result<T> FailWithContext(string resultCode, params object[] context)
+    public static Result Fail(ResultCode resultCode) => new(IsSuccess: false, resultCode, Context: null);
+    public static Result FailWithContext(ResultCode resultCode, params object[] context)
+        => new(IsSuccess: false, resultCode, context);
+    public static Result FailUnknownError()
+        => new(IsSuccess: false, ResultCode: ResultCode.UnknownError, Context: null);
+
+    public bool IsUnknownError => !IsSuccess && ResultCode == ResultCode.UnknownError;
+}
+
+public sealed record Result<T>(
+    bool IsSuccess,
+    T? Value,
+    ResultCode ResultCode,
+    params object[]? Context
+) : IResult
+{
+    public static Result<T> Ok(T value) => new(IsSuccess: true, value, ResultCode: ResultCode.Ok, Context: null);
+    public static Result<T> Fail(ResultCode resultCode) => new(IsSuccess: false, Value: default, resultCode, Context: null);
+    public static Result<T> FailWithContext(ResultCode resultCode, params object[] context)
         => new(IsSuccess: false, Value: default, resultCode, context);
 
-    public bool IsUnknownError => !IsSuccess && ResultCode == Models.ResultCode.UnknownError;
+    public bool IsUnknownError => !IsSuccess && ResultCode == ResultCode.UnknownError;
 }

src/Somnia.GuestLog/Models/DTOs/StayExportFileDTO.cs

@@ -0,0 +1,29 @@
+using Somnia.GuestLog.Enums.Models;
+
+namespace Somnia.GuestLog.Models.DTOs;
+
+public class StayExportFileDTO
+{
+    public long? Id { get; set; }
+
+    public StayExportFormat? ExportFormat { get; set; }
+
+    public StayExportParamsDTO? ExportParams { get; set; }
+
+    public StayExportFileResult? ExportResult { get; set; }
+
+    public string? ExportedPath { get; set; }
+    
+    public string? ExportDetails { get; set; }
+
+
+    public DateTime? ExportTime { get; set; }
+}
+
+public class StayExportParamsDTO
+{
+    public StayExportParamType? ExportType { get; set; }
+
+    public DateTime? ExportPeriodStart { get; set; }
+    public DateTime? ExportPeriodEnd { get; set; }
+}

src/Somnia.GuestLog/Models/Entities/GuestAddress.cs

@@ -1,3 +1,5 @@
+using Somnia.GuestLog.Infrastructure;
+
 namespace Somnia.GuestLog.Models.Entities;
 
 public class GuestAddress : BaseEntity
@@ -9,5 +11,5 @@ public class GuestAddress : BaseEntity
     public required string AddressCountry { get; set; }
     public string? ZipCode { get; set; }
 
-    public override string GetFullKey() => "N/A";
+    public override string GetFullKey() => DbConsts.PK_NotApply;
 }

src/Somnia.GuestLog/Models/Entities/GuestDocument.cs

@@ -2,6 +2,9 @@ namespace Somnia.GuestLog.Models.Entities;
 
 public class GuestDocument : BaseEntity
 {
+    public long Id { get; set; }
+    public int Version { get; set; }
+
     public required string DocumentType { get; set; }
     public required string DocumentNum { get; set; }
 
@@ -26,6 +29,8 @@ public class GuestDocument : BaseEntity
     public required DateTime CreateTime { get; set; }
     public required DateTime UpdateTime { get; set; }
 
+    public required bool IsLastVersion { get; set; }
 
-    public override string GetFullKey() => $"{DocumentType}-{DocumentNum}";
+
+    public override string GetFullKey() => $"{Id}-{Version}";
 }

src/Somnia.GuestLog/Models/Entities/StayExportFile.cs

@@ -0,0 +1,33 @@
+using Somnia.GuestLog.Enums.Models;
+
+namespace Somnia.GuestLog.Models.Entities;
+
+public class StayExportFile : BaseEntity
+{
+    public long Id { get; set; }
+
+    public required StayExportFormat ExportFormat { get; set; }
+    public required StayExportParams ExportParams { get; set; }
+
+    public required StayExportFileResult ExportResult { get; set; }
+
+    /// <summary>
+    /// Path to exported data.
+    /// Should be relative to configured Storage.
+    /// </summary>
+    public string? ExportedPath { get; set; }
+
+    /// <summary>
+    /// A JSON column to store details about the exported file.
+    /// This details can contain information about errors, which stays where included, etc.
+    /// </summary>
+    public string? ExportDetails { get; set; }
+
+    /// <summary>
+    /// Date/Time when export file was generated.
+    /// </summary>
+    public required DateTime ExportTime { get; set; }
+
+
+    public override string GetFullKey() => $"{Id}";
+}

src/Somnia.GuestLog/Models/Entities/StayExportParams.cs

@@ -0,0 +1,19 @@
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Infrastructure;
+
+namespace Somnia.GuestLog.Models.Entities;
+
+/// <summary>
+/// This class store params used on StayExport. 
+/// Different params apply for different export types.
+/// </summary>
+public class StayExportParams : BaseEntity
+{
+    public required StayExportParamType ExportType { get; set; }
+
+    public DateTime? ExportPeriodStart { get; set; }
+    public DateTime? ExportPeriodEnd { get; set; }
+
+
+    public override string GetFullKey() => DbConsts.PK_NotApply;
+}

src/Somnia.GuestLog/Models/EntityMapping.cs

@@ -10,6 +10,8 @@ internal static class EntityMapping
     {
         return new()
         {
+            Id = entity.Id,
+            Version = entity.Version,
             DocumentType = entity.DocumentType,
             DocumentNum = entity.DocumentNum,
             IssueDate = entity.IssueDate.ToDateTime(TimeOnly.MinValue),
@@ -49,4 +51,25 @@ internal static class EntityMapping
         };
     }
 
+    public static StayExportFileDTO MapStayExportFileEntityToDTO(StayExportFile entity)
+    {
+        StayExportParamsDTO exportParamsDto = new()
+        {
+            ExportType = entity.ExportParams.ExportType,
+            ExportPeriodStart = entity.ExportParams.ExportPeriodStart,
+            ExportPeriodEnd = entity.ExportParams.ExportPeriodEnd,
+        };
+
+        return new()
+        {
+            Id = entity.Id,
+            ExportFormat = entity.ExportFormat,
+            ExportParams = exportParamsDto,
+            ExportResult = entity.ExportResult,
+            ExportedPath = entity.ExportedPath,
+            ExportDetails = entity.ExportDetails,
+            ExportTime = entity.ExportTime,
+        };
+    }
+
 }

src/Somnia.GuestLog/Models/ResultCode.cs

@@ -1,11 +0,0 @@
-namespace Somnia.GuestLog.Models;
-
-public static class ResultCode
-{
-    public const string Ok = "Ok";
-    public const string UnknownError = "UnknownError";
-    public const string FailedValidation = "FailedValidation";
-    public const string NotFound = "NotFound";
-
-    public const string GuestCurrentlyInStay = "GuestCurrentlyInStay";
-}

src/Somnia.GuestLog/Program.cs

@@ -1,3 +1,4 @@
+using FluentStorage;
 using FluentValidation;
 using Microsoft.AspNetCore.Localization;
 using Microsoft.EntityFrameworkCore;
@@ -9,6 +10,9 @@ using Somnia.GuestLog.Models.Configuration;
 using Somnia.GuestLog.Models.DTOs;
 using Somnia.GuestLog.Services;
 using Somnia.GuestLog.Services.AddressQuery;
+using Somnia.GuestLog.Services.Entity;
+using Somnia.GuestLog.Services.SpainCodigoMunicipio;
+using Somnia.GuestLog.Services.StayExport;
 using Somnia.GuestLog.Utils;
 using Somnia.GuestLog.Validators;
 
@@ -53,20 +57,31 @@ builder.Services.AddHttpClient();
 builder.Services.AddSingleton<IValidator<GuestDocumentDTO>, GuestDocumentDTOValidator>();
 builder.Services.AddSingleton<IValidator<GuestDocIdDTO>, GuestDocIdDTOValidator>();
 builder.Services.AddSingleton<IValidator<StayEntryDTO>, StayEntryDTOValidator>();
+builder.Services.AddSingleton<IValidator<StayExportParamsDTO>, StayExportParamsDTOValidator>();
+
+// Add Entity Services
+builder.Services.AddSingleton<IGuestDocumentEntityService, GuestDocumentEntityService>();
+builder.Services.AddSingleton<IStayEntryEntityService, StayEntryEntityService>();
+builder.Services.AddSingleton<IStayExportFileEntityService, StayExportFileEntityService>();
 
 // Add Services
-builder.Services.AddSingleton<IGuestDocumentService, GuestDocumentService>();
-builder.Services.AddSingleton<IStayEntryService, StayEntryService>();
 builder.Services.AddSingleton<IDataListService, StaticDataListService>();
-
 builder.Services.AddScoped<IUserMessageService, UserMessageService>();
+builder.Services.AddSingleton<ILocalizerService, LocalizerService>();
+builder.Services.AddSingleton<IStayExportService, StayExportService>();
+builder.Services.AddSingleton<ISpainCodigoMunicipioService, SpainCodigoMunicipioCatastroService>();
 
 // Add Factories (and it's services)
 builder.Services.AddFactoryDI<IAddressQueryFactory, ConfigFileAddressQueryFactory>();
+builder.Services.AddFactoryDI<IStayExportFormatProviderFactory, StayExportFormatProviderFactory>();
 
 // Add Options config
 builder.Services.AddOptions<AddressQueryConfig>()
     .Bind(builder.Configuration.GetSection(AddressQueryConfig.SectionName));
+builder.Services.AddOptions<StayExportConfig>()
+    .Bind(builder.Configuration.GetSection(StayExportConfig.SectionName));
+builder.Services.AddOptions<StayExportSpainParteViajerosConfig>()
+    .Bind(builder.Configuration.GetSection(StayExportSpainParteViajerosConfig.SectionName));
 
 var app = builder.Build();
 
@@ -101,4 +116,7 @@ app.MapStaticAssets();
 app.MapRazorComponents<App>()
     .AddInteractiveServerRenderMode();
 
+//Activate S3 storage.
+AwsS3Storage.Use();
+
 app.Run();

src/Somnia.GuestLog/Resources/LanguageLocale.resx

@@ -122,6 +122,8 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0,
       Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
+  <data name="dto.GuestDocument.Id" xml:space="preserve"><value>ID</value></data>
+  <data name="dto.GuestDocument.Version" xml:space="preserve"><value>Version</value></data>
   <data name="dto.GuestDocument.DocumentType" xml:space="preserve"><value>Document Type</value></data>
   <data name="dto.GuestDocument.DocumentNum" xml:space="preserve"><value>Document Number</value></data>
   <data name="dto.GuestDocument.IssueDate" xml:space="preserve"><value>Issue Date</value></data>
@@ -147,6 +149,18 @@
   <data name="dto.StayEntry.CreateTime" xml:space="preserve"><value>Creation Time</value></data>
   <data name="dto.StayEntry.UpdateTime" xml:space="preserve"><value>Update Time</value></data>
 
+  <data name="dto.StayExportFile.Id" xml:space="preserve"><value>Id</value></data>
+  <data name="dto.StayExportFile.ExportFormat" xml:space="preserve"><value>Export Format</value></data>
+  <data name="dto.StayExportFile.ExportParams" xml:space="preserve"><value>Export Params</value></data>
+  <data name="dto.StayExportFile.ExportResult" xml:space="preserve"><value>Export Result</value></data>
+  <data name="dto.StayExportFile.ExportedPath" xml:space="preserve"><value>Export Path</value></data>
+  <data name="dto.StayExportFile.ExportDetails" xml:space="preserve"><value>Export Details</value></data>
+  <data name="dto.StayExportFile.ExportTime" xml:space="preserve"><value>Export Time</value></data>
+
+  <data name="dto.StayExportParams.ExportType" xml:space="preserve"><value>Export Type</value></data>
+  <data name="dto.StayExportParams.ExportPeriodStart" xml:space="preserve"><value>Date From</value></data>
+  <data name="dto.StayExportParams.ExportPeriodEnd" xml:space="preserve"><value>Date To</value></data>
+
   <data name="tmp" xml:space="preserve"><value>TMP</value></data>
 
   <data name="general.actions" xml:space="preserve"><value>Actions</value></data>
@@ -175,19 +189,32 @@
   <data name="general.address.state" xml:space="preserve"><value>State</value></data>
   <data name="general.address.country" xml:space="preserve"><value>Country</value></data>
   <data name="general.address.zipCode" xml:space="preserve"><value>Zip Code</value></data>
-  
+
-  
+
   <!-- Common codes -->
-  <data name="resultCode.Ok" xml:space="preserve"><value>OK</value></data>
+  <data name="enum.ResultCode.Ok" xml:space="preserve"><value>OK</value></data>
-  <data name="resultCode.UnknownError" xml:space="preserve"><value>Unknown Error</value></data>
+  <data name="enum.ResultCode.UnknownError" xml:space="preserve"><value>Unknown Error</value></data>
-  <data name="resultCode.FailedValidation" xml:space="preserve"><value>Failed entity validation</value></data>
+  <data name="enum.ResultCode.FailedValidation" xml:space="preserve"><value>Failed entity validation</value></data>
-  <data name="resultCode.NotFound" xml:space="preserve"><value>Not found</value></data>
+  <data name="enum.ResultCode.NotFound" xml:space="preserve"><value>Not found</value></data>
+  <data name="enum.ResultCode.FileStorageError" xml:space="preserve"><value>File Storage Error</value></data>
   <!-- Specific codes -->
-  <data name="resultCode.GuestCurrentlyInStay" xml:space="preserve"><value>Guest ('{0}') is already in one stay during the period: {1}</value></data>
+  <data name="enum.ResultCode.GuestInStay" xml:space="preserve"><value>Guest (ID: '{0}') is in a stay.</value></data>
-  
+  <data name="enum.ResultCode.GuestCurrentlyInStay" xml:space="preserve"><value>Guest (ID: '{0}') is already in one stay during the period: {1}</value></data>
+
+  <data name="enum.StayExportFileResult.OK" xml:space="preserve"><value>OK</value></data>
+  <data name="enum.StayExportFileResult.NoData" xml:space="preserve"><value>No Data</value></data>
+  <data name="enum.StayExportFileResult.ExportError" xml:space="preserve"><value>Export Error</value></data>
+  <data name="enum.StayExportFileResult.UploadError" xml:space="preserve"><value>File Error</value></data>
+
+  <data name="enum.StayExportFormat.GuestLogJson" xml:space="preserve"><value>GuestLog JSON</value></data>
+  <data name="enum.StayExportFormat.SpainParteViajeros" xml:space="preserve"><value>Spain Parte Viajeros</value></data>
+
+  <data name="enum.StayExportParamType.PeriodDateIn" xml:space="preserve"><value>Stay 'Date In' Period</value></data>
+
 
   <data name="navMenu.GuestDocumentList" xml:space="preserve"><value>Guests</value></data>
   <data name="navMenu.StayEntryList" xml:space="preserve"><value>Stays</value></data>
+  <data name="navMenu.StayExport" xml:space="preserve"><value>Stay Export</value></data>
 
 
   <data name="page.GuestDocList.pageTitle" xml:space="preserve"><value>Guest Documents</value></data>
@@ -202,7 +229,14 @@
   <data name="page.StayEntryList.btnNewStay" xml:space="preserve"><value>New Stay</value></data>
 
   <data name="page.StayEntryNew.pageTitle" xml:space="preserve"><value>New Stay</value></data>
-  
+
+  <data name="page.StayExportList.pageTitle" xml:space="preserve"><value>Stay Export Files</value></data>
+  <data name="page.StayExportList.exportList" xml:space="preserve"><value>Export List</value></data>
+  <data name="page.StayExportList.btnNewExport" xml:space="preserve"><value>New Export</value></data>
+
+  <data name="page.StayExportNew.pageTitle" xml:space="preserve"><value>New Stay Export</value></data>
+
+
   <data name="control.GuestDocForm.sectionDocument" xml:space="preserve"><value>Document Details</value></data>
   <data name="control.GuestDocForm.sectionGuest" xml:space="preserve"><value>Guest Details</value></data>
   <data name="control.GuestDocForm.sectionContact" xml:space="preserve"><value>Contact Details</value></data>

src/Somnia.GuestLog/Services/AddressQuery/ConfigFileAddressQueryFactory.cs

@@ -1,4 +1,5 @@
 using Microsoft.Extensions.Options;
+using Somnia.GuestLog.Enums.Services;
 using Somnia.GuestLog.Models.Configuration;
 using Somnia.GuestLog.Utils.DI;
 
@@ -11,8 +12,8 @@ public class ConfigFileAddressQueryFactory(
 {
     public static void RegisterFactoryItems(IServiceCollection services)
     {
-        services.AddKeyedTransient<IAddressQueryService, NominatimAddressQueryService>(AddressQueryConfig.AddressQueryProviderEnum.Nominatim);
+        services.AddKeyedTransient<IAddressQueryService, NominatimAddressQueryService>(AddressQueryProvider.Nominatim);
-        services.AddKeyedTransient<IAddressQueryService, GoogleApiAddressQueryService>(AddressQueryConfig.AddressQueryProviderEnum.GoogleApiV4);
+        services.AddKeyedTransient<IAddressQueryService, GoogleApiAddressQueryService>(AddressQueryProvider.GoogleApiV4);
     }
 
     public IAddressQueryService GetService()

src/Somnia.GuestLog/Services/AddressQuery/NominatimAddressQueryService.cs

@@ -44,7 +44,7 @@ public class NominatimAddressQueryService(
                     HouseNumber = result.Address.House_number,
                     AddressRoad = result.Address.Road ?? result.Address.Square,
                     AddressCity = result.Address.City ?? result.Address.Municipality ?? result.Address.Town ?? result.Address.Village,
-                    AddressProvince = result.Address.Province,
+                    AddressProvince = result.Address.Province ?? result.Address.State_district ?? result.Address.County,
                     AddressState = result.Address.State,
                     AddressCountry = result.Address.Country,
                     ZipCode = result.Address.Postcode,
@@ -97,6 +97,8 @@ public class NominatimAddressQueryService(
         string? Village = null,
         string? Town = null,
         string? Province = null,
+        string? State_district = null,
+        string? County = null,
         string? State = null,
         string? Country = null,
         string? Postcode = null,

src/Somnia.GuestLog/Services/Entity/GuestDocumentEntityService.cs

@@ -1,18 +1,20 @@
 using FluentValidation;
 using Microsoft.EntityFrameworkCore;
+using Somnia.GuestLog.Enums.Services;
 using Somnia.GuestLog.Infrastructure;
 using Somnia.GuestLog.Models;
 using Somnia.GuestLog.Models.DTOs;
 using Somnia.GuestLog.Models.Entities;
 using Somnia.GuestLog.Utils;
 
-namespace Somnia.GuestLog.Services;
+namespace Somnia.GuestLog.Services.Entity;
 
-public class GuestDocumentService(
+public class GuestDocumentEntityService(
-    ILogger<GuestDocumentService> logger,
+    ILogger<GuestDocumentEntityService> logger,
     IDbContextFactory<GuestLogContext> contextFactory,
-    IValidator<GuestDocumentDTO> dtoValidator
+    IValidator<GuestDocumentDTO> dtoValidator,
-) : IGuestDocumentService
+    IStayEntryEntityService stayEntityService
+) : IGuestDocumentEntityService
 {
     public async Task<Result> CreateDocumentAsync(GuestDocumentDTO dto)
     {
@@ -39,6 +41,7 @@ public class GuestDocumentService(
         DateTime createTime = DateTime.UtcNow;
         GuestDocument dbItem = new()
         {
+            Version = GuestConsts.GuestDocument_FirstVersion,
             DocumentType = dto.DocumentType!,
             DocumentNum = dto.DocumentNum!,
             IssueDate = DateOnly.FromDateTime(dto.IssueDate!.Value),
@@ -54,6 +57,7 @@ public class GuestDocumentService(
             AddressDetails = addressItem,
             CreateTime = createTime,
             UpdateTime = createTime,
+            IsLastVersion = true, //On creation, created entity is last version.
         };
 
         try
@@ -79,54 +83,93 @@ public class GuestDocumentService(
 
     public Task<Result> DeleteDocumentAsync(GuestDocumentDTO dto)
     {
-        if (dto.DocumentType is null || dto.DocumentNum is null)
+        if (dto.Id is null)
         {
-            throw new InvalidOperationException("GuestDocumentService - DeleteDocument: A DTO without key can't be deleted!");
+            throw new InvalidOperationException("GuestDocumentService - DeleteDocument: A DTO without ID can't be deleted!");
         }
 
-        return DeleteDocumentAsync(dto.DocumentType, dto.DocumentNum);
+        return DeleteDocumentAsync(dto.Id.Value);
     }
 
-    public async Task<Result> DeleteDocumentAsync(string docType, string docNum)
+    public async Task<Result> DeleteDocumentAsync(long id)
     {
-        using var dbContext = contextFactory.CreateDbContext();
-        GuestDocument? dbItem = await dbContext.GuestDocuments.FindAsync(docType, docNum);
-        if (dbItem is null)
-        {
-            logger.LogWarning("GuestDocumentService - DeleteDocument: Error deleting GuestDocument. Entity not found with key: '{key}-{key2}'", docType, docNum);
-            return Result.Fail(ResultCode.NotFound);
-        }
-
         try
         {
-            dbContext.GuestDocuments.Remove(dbItem);
+            using var dbContext = contextFactory.CreateDbContext();
-            await dbContext.SaveChangesAsync();
 
-            logger.LogInformation("GuestDocumentService - DeleteDocument: GuestDocument deleted: '{id}'", dbItem.GetFullKey());
+            //Check if GuestDocument is used in a Stay.
+            bool isUsed = await stayEntityService.IsGuestInStay(id);
+            if (isUsed)
+            {
+                logger.LogWarning("GuestDocumentService - DeleteDocument: Error deleting GuestDocument. Guest (ID: '{ID}') is in a Stay", id);
+                return Result.FailWithContext(ResultCode.GuestInStay, id);
+            }
+
+            int deletedCount = await dbContext.GuestDocuments
+               .Where(e => e.Id == id)
+               .ExecuteDeleteAsync();
+
+            if (deletedCount == 0)
+            {
+                logger.LogWarning("GuestDocumentService - DeleteDocument: Error deleting GuestDocument. Entity not found with ID: '{ID}'", id);
+                return Result.Fail(ResultCode.NotFound);
+            }
+
+            logger.LogInformation(
+                "GuestDocumentService - DeleteDocument: GuestDocument deleted with Id: '{id}'. Versions deleted: '{Count}'",
+                id, deletedCount);
             return Result.Ok();
         }
         catch (Exception ex)
         {
-            logger.LogError(ex, "GuestDocumentService - CreateDocument: Error deleting GuestDocument: '{id}'", dbItem.GetFullKey());
+            logger.LogError(ex, "GuestDocumentService - CreateDocument: Error deleting GuestDocument: '{id}'", id);
             return Result.FailUnknownError();
         }
     }
 
-
+    public async Task<GuestDocumentDTO?> GetLastVersionDtoByIdAsync(long id)
-    public async Task<GuestDocumentDTO?> GetDtoByIdAsync(string docType, string docNum)
     {
         using var dbContext = contextFactory.CreateDbContext();
-        GuestDocument? dbItem = await dbContext.GuestDocuments.FindAsync(docType, docNum);
+        GuestDocument? dbItem = await dbContext.GuestDocuments
+            .Where(e => e.Id == id)
+            .OrderByDescending(e => e.Version)
+            .FirstOrDefaultAsync();
+
         return dbItem is not null ? GetDtoFromDb(dbItem) : null;
     }
 
-    public async Task<IEnumerable<GuestDocumentDTO>> GetDtoListAsync()
+    public async Task<GuestDocumentDTO?> GetLastVersionDtoByDocumentAsync(string docType, string docNum)
     {
         using var dbContext = contextFactory.CreateDbContext();
-        var dbList = await dbContext.GuestDocuments
+        GuestDocument? dbItem = await dbContext.GuestDocuments
-            .OrderByDescending(e => e.UpdateTime)
+            .Where(e => e.DocumentType == docType && e.DocumentNum == docNum)
+            .OrderByDescending(e => e.Version)
+            .FirstOrDefaultAsync();
+
+        return dbItem is not null ? GetDtoFromDb(dbItem) : null;
+    }
+
+    public async Task<IEnumerable<GuestDocumentDTO>> GetDtoListAsync(bool onlyLastVersion)
+    {
+        using var dbContext = contextFactory.CreateDbContext();
+
+        // TEMP solution
+        var query = dbContext.GuestDocuments.AsQueryable();
+        if (onlyLastVersion)
+        {
+            query = query.Where(e => e.IsLastVersion == true);
+        }
+        var dbList = await query.OrderByDescending(e => e.UpdateTime)
             .ToListAsync();
 
+        // TODO: Waiting for EF Core Window function improvements:
+        //  See expected translation: https://github.com/dotnet/efcore/issues/36380#issuecomment-3082788964
+        //  See window function status: https://github.com/dotnet/efcore/issues/12747
+        // var dbList = await dbContext.GuestDocuments
+        //     .GroupBy(e => e.Id)
+        //     .Select(g => g.OrderByDescending(e => e.Version).First())
+        //     .ToListAsync();
+
         return dbList.Select(GetDtoFromDb);
     }
 
@@ -153,8 +196,21 @@ public class GuestDocumentService(
         query = query.WhereIf(!string.IsNullOrEmpty(filter.Surname),
             e => EF.Functions.Like(e.Surname, filter.Surname));
 
+        // TEMP while waiting for EF Core Window function improvements
+        query = query.WhereIf(filter.OnlyLastVersion,
+            e => e.IsLastVersion == true);
         query = query.OrderByDescending(e => e.UpdateTime);
 
+
+        // TODO: Waiting for EF Core Window function improvements:
+        //  See: https://github.com/dotnet/efcore/issues/27470
+        //  See window function status: https://github.com/dotnet/efcore/issues/12747
+        //  For Ordering (or operations post-grouping), see: https://github.com/dotnet/efcore/pull/38687
+        // query = query
+        //     .OrderByDescending(e => e.UpdateTime)
+        //     .GroupBy(e => e.Id)
+        //     .Select(g => g.OrderByDescending(e => e.Version).First());
+
         if (limit > 0)
         {
             query = query.Take(limit);

src/Somnia.GuestLog/Services/Entity/IGuestDocumentEntityService.cs

@@ -0,0 +1,28 @@
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Services.Entity;
+
+public interface IGuestDocumentEntityService
+{
+    public Task<Result> CreateDocumentAsync(GuestDocumentDTO dto);
+    public Task<Result> UpdateDocumentAsync(GuestDocumentDTO dto);
+
+    /// <summary>
+    /// Same behavior as <see cref="DeleteDocumentAsync(long)"/>
+    /// </summary>
+    public Task<Result> DeleteDocumentAsync(GuestDocumentDTO dto);
+
+    /// <summary>
+    /// Delete documents by ID.
+    /// This operation will delete all versions of a document.
+    /// </summary>
+    /// <param name="id">ID of the document to Delete</param>
+    public Task<Result> DeleteDocumentAsync(long id);
+
+    public Task<GuestDocumentDTO?> GetLastVersionDtoByIdAsync(long id);
+    public Task<GuestDocumentDTO?> GetLastVersionDtoByDocumentAsync(string docType, string docNum);
+
+    public Task<IEnumerable<GuestDocumentDTO>> GetDtoListAsync(bool onlyLastVersion);
+    public Task<IEnumerable<GuestDocumentDTO>> GetDtoListByFilterAsync(GuestDocFilterDTO filter, int limit = 0);
+
+}

src/Somnia.GuestLog/Services/Entity/IStayEntryEntityService.cs

@@ -1,9 +1,9 @@
 using Somnia.GuestLog.Models.DTOs;
 using Somnia.GuestLog.Models.QueryConfigs;
 
-namespace Somnia.GuestLog.Services;
+namespace Somnia.GuestLog.Services.Entity;
 
-public interface IStayEntryService
+public interface IStayEntryEntityService
 {
     public Task<Result> CreateEntryAsync(StayEntryDTO dto);
     public Task<Result> UpdateEntryAsync(StayEntryDTO updatedDto);
@@ -15,7 +15,8 @@ public interface IStayEntryService
     public Task<IEnumerable<StayEntryDTO>> GetDtoListByFilterAsync(StayEntryFilterDTO filter, int limit = 0, StayEntryQueryConfig? queryConfig = null);
 
 
-    public Task<bool> IsGuestInStayInPeriod(string docType, string docNum, DateTime startTime, DateTime endTime);
+    public Task<bool> IsGuestInStay(long guestDocId);
-    public Task<IEnumerable<StayEntryDTO>> GetStaysWithGuest(string docType, string docNum, StayEntryQueryConfig? queryConfig = null);
+    public Task<bool> IsGuestInStayInPeriod(long guestDocId, DateTime startTime, DateTime endTime);
+    public Task<IEnumerable<StayEntryDTO>> GetStaysWithGuest(long guestDocId, StayEntryQueryConfig? queryConfig = null);
 
 }

src/Somnia.GuestLog/Services/Entity/IStayExportFileEntityService.cs

@@ -0,0 +1,19 @@
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Services.Entity;
+
+public interface IStayExportFileEntityService
+{
+    public Task<Result> CreateStayExportAsync(StayExportFileDTO dto);
+    public Task<Result> UpdateStayExportAsync(StayExportFileDTO dto);
+
+    /// <summary>
+    /// Delete StayExport entry from DB.
+    /// Exported File won't be deleted from Storage.
+    /// </summary>
+    public Task<Result> DeleteStayExportAsync(StayExportFileDTO dto);
+
+    public Task<StayExportFileDTO?> GetDtoByIdAsync(long id);
+    //public Task<IEnumerable<StayExportFileDTO>> GetDtoListByFilterAsync(StayExportFileFilterDTO filter, int limit = 0);
+    public Task<IEnumerable<StayExportFileDTO>> GetDtoListAsync(int limit = 0);
+}

src/Somnia.GuestLog/Services/Entity/StayEntryEntityService.cs

@@ -1,5 +1,6 @@
 using FluentValidation;
 using Microsoft.EntityFrameworkCore;
+using Somnia.GuestLog.Enums.Services;
 using Somnia.GuestLog.Infrastructure;
 using Somnia.GuestLog.Models;
 using Somnia.GuestLog.Models.DTOs;
@@ -7,13 +8,13 @@ using Somnia.GuestLog.Models.Entities;
 using Somnia.GuestLog.Models.QueryConfigs;
 using Somnia.GuestLog.Utils;
 
-namespace Somnia.GuestLog.Services;
+namespace Somnia.GuestLog.Services.Entity;
 
-public class StayEntryService(
+public class StayEntryEntityService(
-    ILogger<StayEntryService> logger,
+    ILogger<StayEntryEntityService> logger,
     IDbContextFactory<GuestLogContext> contextFactory,
     IValidator<StayEntryDTO> dtoValidator
-) : IStayEntryService
+) : IStayEntryEntityService
 {
     public async Task<Result> CreateEntryAsync(StayEntryDTO dto)
     {
@@ -45,12 +46,13 @@ public class StayEntryService(
             //Check and add GuestDocuments
             foreach (GuestDocumentDTO guestDto in dto.GuestDocuments!)
             {
-                //Get it from db.
+                //Get guest from db.
-                GuestDocument? dbGuest = await dbContext.GuestDocuments.FindAsync(guestDto.DocumentType, guestDto.DocumentNum)
+                GuestDocument dbGuest = await dbContext.GuestDocuments
-                    ?? throw new InvalidOperationException($"GuestDocument not found! Id: '{guestDto.FullKey}'");
+                    .Where(gd => gd.Id == guestDto.Id && gd.Version == guestDto.Version)
+                    .SingleAsync();
 
                 //Check if Guest is already in other stay during the same period.
-                bool isInOtherStay = await this.IsGuestInStayInPeriod(dbGuest.DocumentType, dbGuest.DocumentNum, dbStay.DateIn, dbStay.DateOut);
+                bool isInOtherStay = await this.IsGuestInStayInPeriod(dbGuest.Id, dbStay.DateIn, dbStay.DateOut);
                 if (isInOtherStay)
                 {
                     string period = $"{dbStay.DateIn}-{dbStay.DateOut}";
@@ -167,24 +169,34 @@ public class StayEntryService(
     }
 
 
-    public async Task<bool> IsGuestInStayInPeriod(string docType, string docNum, DateTime startTime, DateTime endTime)
+    public async Task<bool> IsGuestInStay(long guestDocId)
+    {
+        using var dbContext = contextFactory.CreateDbContext();
+
+        bool rs = await dbContext.StayEntries
+            .AnyAsync(s => s.GuestDocuments.Any(g => g.Id == guestDocId));
+
+        return rs;
+    }
+
+    public async Task<bool> IsGuestInStayInPeriod(long guestDocId, DateTime startTime, DateTime endTime)
     {
         using var dbContext = contextFactory.CreateDbContext();
 
         bool rs = await dbContext.StayEntries
             .AnyAsync(s => s.DateIn < endTime && s.DateOut > startTime
-                && s.GuestDocuments.Any(g => g.DocumentType == docType && g.DocumentNum == docNum)
+                && s.GuestDocuments.Any(g => g.Id == guestDocId)
             );
 
         return rs;
     }
 
-    public async Task<IEnumerable<StayEntryDTO>> GetStaysWithGuest(string docType, string docNum, StayEntryQueryConfig? queryConfig = null)
+    public async Task<IEnumerable<StayEntryDTO>> GetStaysWithGuest(long guestDocId, StayEntryQueryConfig? queryConfig = null)
     {
         using var dbContext = contextFactory.CreateDbContext();
 
         var rs = await dbContext.StayEntries
-            .Where(s => s.GuestDocuments.Any(g => g.DocumentType == docType && g.DocumentNum == docNum))
+            .Where(s => s.GuestDocuments.Any(g => g.Id == guestDocId))
             .AddQueryConfig(queryConfig)
             .OrderByDescending(e => e.DateIn)
             .ToListAsync();

src/Somnia.GuestLog/Services/Entity/StayExportFileEntityService.cs

@@ -0,0 +1,139 @@
+using FluentValidation;
+using Microsoft.EntityFrameworkCore;
+using Somnia.GuestLog.Enums.Services;
+using Somnia.GuestLog.Infrastructure;
+using Somnia.GuestLog.Models;
+using Somnia.GuestLog.Models.DTOs;
+using Somnia.GuestLog.Models.Entities;
+using Somnia.GuestLog.Utils;
+
+namespace Somnia.GuestLog.Services.Entity;
+
+public class StayExportFileEntityService(
+    ILogger<StayExportFileEntityService> logger,
+    IDbContextFactory<GuestLogContext> contextFactory
+) : IStayExportFileEntityService
+{
+    public async Task<Result> CreateStayExportAsync(StayExportFileDTO dto)
+    {
+        ArgumentNullException.ThrowIfNull(dto, nameof(dto));
+
+        //Check for null values in the DTO.
+        if (dto.ExportFormat == null || dto.ExportResult == null || dto.ExportTime == null)
+        {
+            throw new InvalidOperationException("StayExportFile dto contains null fields");
+        }
+
+        if (dto.ExportParams == null)
+        {
+            throw new InvalidOperationException("StayExportFile dto contains null ExportParams");
+        }
+
+        StayExportParams exportParams = GetExportParamsFromDTO(dto.ExportParams);
+        StayExportFile dbItem = new()
+        {
+            ExportFormat = dto.ExportFormat.Value,
+            ExportParams = exportParams,
+            ExportResult = dto.ExportResult.Value,
+            ExportedPath = dto.ExportedPath,
+            ExportDetails = dto.ExportDetails,
+            ExportTime = dto.ExportTime?.ToUniversalTime() ?? DateTime.UtcNow,
+        };
+
+        try
+        {
+            using var dbContext = contextFactory.CreateDbContext();
+            await dbContext.AddAsync(dbItem);
+            await dbContext.SaveChangesAsync();
+
+            logger.LogInformation("StayExportFileService - CreateStayExportAsync: GuestDocument Created: '{id}'", dbItem.GetFullKey());
+            return Result.Ok();
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "StayExportFileService - CreateStayExportAsync: Error creating GuestDocument");
+            return Result.FailUnknownError();
+        }
+    }
+
+    public Task<Result> UpdateStayExportAsync(StayExportFileDTO dto)
+    {
+        throw new NotImplementedException();
+    }
+
+    public async Task<Result> DeleteStayExportAsync(StayExportFileDTO dto)
+    {
+        try
+        {
+            using var dbContext = contextFactory.CreateDbContext();
+
+            int deletedCount = await dbContext.StayExportFiles
+                .Where(e => e.Id == dto.Id)
+                .ExecuteDeleteAsync();
+
+            if (deletedCount == 0)
+            {
+                logger.LogWarning("StayExportFileService - DeleteStayExportAsync: Error deleting StayExport. Entity not found with ID: '{ID}'", dto.Id);
+                return Result.Fail(ResultCode.NotFound);
+            }
+
+            logger.LogInformation(
+                "StayExportFileService - DeleteStayExportAsync: StayExport deleted with Id: '{id}'.", dto.Id);
+            return Result.Ok();
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "StayExportFileService - DeleteStayExportAsync: Error creating GuestDocument");
+            return Result.FailUnknownError();
+        }
+    }
+
+
+    public async Task<StayExportFileDTO?> GetDtoByIdAsync(long id)
+    {
+        using var dbContext = contextFactory.CreateDbContext();
+        StayExportFile? dbItem = await dbContext.StayExportFiles
+            .Where(e => e.Id == id)
+            .FirstOrDefaultAsync();
+
+        return dbItem is not null ? GetDtoFromDb(dbItem) : null;
+    }
+
+    public async Task<IEnumerable<StayExportFileDTO>> GetDtoListAsync(int limit = 0)
+    {
+        using var dbContext = contextFactory.CreateDbContext();
+
+        IQueryable<StayExportFile> query = dbContext.StayExportFiles
+            .OrderByDescending(e => e.ExportTime)
+            .WithLimit(limit);
+
+        var dbList = await query.ToListAsync();
+
+        return dbList.Select(e => GetDtoFromDb(e));
+    }
+
+
+    #region Internal Methods
+
+    private static StayExportFileDTO GetDtoFromDb(StayExportFile dbItem)
+    {
+        return EntityMapping.MapStayExportFileEntityToDTO(dbItem);
+    }
+
+    private static StayExportParams GetExportParamsFromDTO(StayExportParamsDTO dto)
+    {
+        if (dto.ExportType == null)
+        {
+            throw new InvalidOperationException("Dto with invalid data");
+        }
+
+        return new()
+        {
+            ExportType = dto.ExportType.Value,
+            ExportPeriodStart = dto.ExportPeriodStart?.ToUniversalTime(),
+            ExportPeriodEnd = dto.ExportPeriodEnd?.ToUniversalTime()
+        };
+    }
+
+    #endregion
+}

src/Somnia.GuestLog/Services/IGuestDocumentService.cs

@@ -1,16 +0,0 @@
-using Somnia.GuestLog.Models.DTOs;
-
-namespace Somnia.GuestLog.Services;
-
-public interface IGuestDocumentService
-{
-    public Task<Result> CreateDocumentAsync(GuestDocumentDTO dto);
-    public Task<Result> UpdateDocumentAsync(GuestDocumentDTO dto);
-    public Task<Result> DeleteDocumentAsync(GuestDocumentDTO dto);
-    public Task<Result> DeleteDocumentAsync(string docType, string docNum);
-
-    public Task<GuestDocumentDTO?> GetDtoByIdAsync(string docType, string docNum);
-    public Task<IEnumerable<GuestDocumentDTO>> GetDtoListByFilterAsync(GuestDocFilterDTO filter, int limit = 0);
-    public Task<IEnumerable<GuestDocumentDTO>> GetDtoListAsync();
-
-}

src/Somnia.GuestLog/Services/ILocalizerService.cs

@@ -0,0 +1,7 @@
+namespace Somnia.GuestLog.Services;
+
+public interface ILocalizerService
+{
+    public string GetEnumValue<TEnum>(TEnum? enumValue) where TEnum : struct, Enum;
+    public string GetEnumValue<TEnum>(TEnum enumValue) where TEnum : struct, Enum;
+}

src/Somnia.GuestLog/Services/IUserMessageService.cs

@@ -1,4 +1,5 @@
-using Somnia.GuestLog.Models.DTOs;
+using Somnia.GuestLog.Enums.UI;
+using IResult = Somnia.GuestLog.Models.DTOs.IResult;
 
 namespace Somnia.GuestLog.Services;
 
@@ -6,12 +7,6 @@ public interface IUserMessageService
 {
     public void ShowMessage(string text, MessageKind kind, params object[] parameters);
 
-    public void ShowResult(Result resultDto);
+    public void ShowResult(IResult resultDto);
-    public void ShowResultWithMessage(Result resultDto, string message);
+    public void ShowResultWithMessage(IResult resultDto, string message);
-
-
-    public enum MessageKind
-    {
-        Info, Warning, Error, Success, Normal
-    }
 }

src/Somnia.GuestLog/Services/LocalizerService.cs

@@ -0,0 +1,37 @@
+using Microsoft.Extensions.Localization;
+using Somnia.GuestLog.Resources;
+
+namespace Somnia.GuestLog.Services;
+
+public class LocalizerService(
+    IServiceProvider serviceProvider
+) : ILocalizerService
+{
+    private IStringLocalizer<LanguageLocale> Localizer
+    {
+        get
+        {
+            field ??= serviceProvider.GetRequiredService<IStringLocalizer<LanguageLocale>>();
+            return field;
+        }
+    }
+
+    public string GetEnumValue<TEnum>(TEnum? enumValue) where TEnum : struct, Enum
+    {
+        if (enumValue == null)
+        {
+            return GuestConsts.EmptyField;
+        }
+
+        return GetEnumValue(enumValue.Value);
+    }
+
+    public string GetEnumValue<TEnum>(TEnum enumValue) where TEnum : struct, Enum
+    {
+        string enumName = typeof(TEnum).Name;
+        string? strEnumValue = Enum.GetName(enumValue);
+        string localeKey = $"enum.{enumName}.{strEnumValue}";
+
+        return Localizer[localeKey];
+    }
+}

src/Somnia.GuestLog/Services/SpainCodigoMunicipio/ISpainCodigoMunicipioService.cs

@@ -0,0 +1,6 @@
+namespace Somnia.GuestLog.Services.SpainCodigoMunicipio;
+
+public interface ISpainCodigoMunicipioService
+{
+    public Task<string?> GetCodigoMunicipioAsync(string municipio, string province);
+}

src/Somnia.GuestLog/Services/SpainCodigoMunicipio/SpainCodigoMunicipioCatastroService.cs

@@ -0,0 +1,123 @@
+using System.Xml.Serialization;
+using Microsoft.AspNetCore.WebUtilities;
+
+namespace Somnia.GuestLog.Services.SpainCodigoMunicipio;
+
+public class SpainCodigoMunicipioCatastroService(
+    ILogger<SpainCodigoMunicipioCatastroService> logger,
+    IHttpClientFactory httpFactory
+) : ISpainCodigoMunicipioService
+{
+    private const string Api_Host = "https://ovc.catastro.meh.es";
+    private const string Api_Address = "OVCServWeb/OVCWcfCallejero/COVCCallejero.svc/rest/ObtenerMunicipios";
+    private const string Api_Param_Provincia = "Provincia";
+    private const string Api_Param_Municipio = "Municipio";
+
+
+    //Result Cache.
+    readonly Dictionary<(string provincia, string municipio), string> codigoMunicipioCache = [];
+
+
+    public async Task<string?> GetCodigoMunicipioAsync(string municipio, string province)
+    {
+        var cacheKey = (province.ToUpper(), municipio.ToUpper());
+
+        //Try get from cache.
+        if (codigoMunicipioCache.TryGetValue(cacheKey, out string? cacheCode))
+        {
+            logger.LogInformation("SpainCodigoMunicipioCatastroService - Municipio found in cache for: '{key}'", cacheKey);
+            return cacheCode;
+        }
+
+        try
+        {
+            string uri = GetRequestUri(municipio, province);
+            logger.LogInformation("SpainCodigoMunicipioCatastroService - Getting municipios from API with query: '{addr}'", uri);
+
+            var httpClient = httpFactory.CreateClient();
+            using var rsStream = await httpClient.GetStreamAsync(uri);
+
+            XmlSerializer serializer = new(typeof(CatastroApiResult));
+
+            if (serializer.Deserialize(rsStream) is not CatastroApiResult rs)
+            {
+                logger.LogError("SpainCodigoMunicipioCatastroService - Result can't be deserialized!");
+                return null;
+            }
+
+            if (rs.municipios.Count == 0)
+            {
+                logger.LogWarning("SpainCodigoMunicipioCatastroService - No municipios found for query: '{addr}'", uri);
+                return null;
+            }
+
+            if (rs.municipios.Count > 1)
+            {
+                logger.LogWarning("SpainCodigoMunicipioCatastroService - More than 1 municipio was returned. First one will be used!");
+            }
+
+            CatastroApiResultCodigoIne? codIne = rs.municipios.First().codigoIne;
+            if (codIne == null || codIne.codigoMunicipio == null || codIne.codigoProvincia == null)
+            {
+                logger.LogWarning("SpainCodigoMunicipioCatastroService - Returned Municipio without data!");
+                return null;
+            }
+
+            string finalCode = $"{codIne.codigoProvincia}{codIne.codigoMunicipio}";
+
+            codigoMunicipioCache.Add(cacheKey, finalCode);
+            return finalCode;
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "SpainCodigoMunicipioCatastroService - Error getting codigo municipio from catastro API!");
+            return null;
+        }
+    }
+
+
+    #region Internal Methods
+
+    private static string GetRequestUri(string municipio, string province)
+    {
+        string baseAddress = $"{Api_Host}/{Api_Address}";
+
+        return QueryHelpers.AddQueryString(baseAddress, [
+            new KeyValuePair<string, string?>(Api_Param_Provincia, province),
+            new KeyValuePair<string, string?>(Api_Param_Municipio, municipio),
+        ]);
+    }
+
+    #endregion
+
+    #region API Model
+
+    [XmlRoot(ElementName = "consulta_municipiero", Namespace = "http://www.catastro.meh.es/")]
+    public class CatastroApiResult()
+    {
+        [XmlArray(ElementName = "municipiero")]
+        [XmlArrayItem(ElementName = "muni")]
+        public required List<CatastroApiResultMunicipio> municipios;
+    }
+
+    public class CatastroApiResultMunicipio()
+    {
+        [XmlElement(ElementName = "nm")]
+        public string? municipio;
+
+        [XmlElement(ElementName = "loine")]
+        public CatastroApiResultCodigoIne? codigoIne;
+
+    }
+
+    public class CatastroApiResultCodigoIne
+    {
+        [XmlElement(ElementName = "cp")]
+        public string? codigoProvincia;
+
+        [XmlElement(ElementName = "cm")]
+        public string? codigoMunicipio;
+    }
+
+    #endregion
+}

src/Somnia.GuestLog/Services/StayExport/IStayExportFormatProvider.cs

@@ -0,0 +1,19 @@
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public interface IStayExportFormatProvider
+{
+    public StayExportFormat GetFormat();
+    public string GetFilename(DateTime exportTime);
+
+    /// <summary>
+    /// Export Data with the corresponding format.
+    /// Data is copied to given stream (no other operations are performed to the stream).
+    /// </summary>
+    /// <param name="stayList">List of Stays to export</param>
+    /// <param name="dataStream">Stream to copy exported data.</param>
+    public Task<(StayExportFileResult fileResult, string? exportDetails)> ExportDataAsync(IEnumerable<StayEntryDTO> stayList, Stream dataStream);
+
+}

src/Somnia.GuestLog/Services/StayExport/IStayExportFormatProviderFactory.cs

@@ -0,0 +1,11 @@
+using Somnia.GuestLog.Enums.Models;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public interface IStayExportFormatProviderFactory
+{
+    /// <summary>
+    /// Returns the StayExport service implementation given current configuration.
+    /// </summary>
+    public IStayExportFormatProvider GetProvider(StayExportFormat exportFormat);
+}

src/Somnia.GuestLog/Services/StayExport/IStayExportService.cs

@@ -0,0 +1,14 @@
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public interface IStayExportService
+{
+    public Task<Result<StayExportFileDTO>> ExportStaysByParamsAsync(StayExportFormat format, StayExportParamsDTO exportParams);
+
+
+    public Task<Result> GetExportedFileAsync(StayExportFileDTO item, Stream dataStream);
+
+    public Task<Result> DeleteExportedFileAsync(StayExportFileDTO item);
+}

src/Somnia.GuestLog/Services/StayExport/StayExportFormatProviderFactory.cs

@@ -0,0 +1,30 @@
+using Microsoft.Extensions.Options;
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.Configuration;
+using Somnia.GuestLog.Utils.DI;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public class StayExportFormatProviderFactory(
+    IServiceProvider serviceProvider,
+    IOptions<StayExportConfig> config
+) : IStayExportFormatProviderFactory, IFactoryDI
+{
+    public static void RegisterFactoryItems(IServiceCollection services)
+    {
+        services.AddKeyedSingleton<IStayExportFormatProvider, StayExportProviderJson>(StayExportFormat.GuestLogJson);
+        services.AddKeyedSingleton<IStayExportFormatProvider, StayExportProviderSpainParteViajeros>(StayExportFormat.SpainParteViajeros);
+    }
+
+
+    public IStayExportFormatProvider GetProvider(StayExportFormat exportFormat)
+    {
+        if (config.Value.EnableStayExport == false)
+        {
+            throw new InvalidOperationException("StayExport is disabled. Enable and configure it first!");
+        }
+
+        return serviceProvider.GetKeyedService<IStayExportFormatProvider>(exportFormat)
+            ?? throw new InvalidOperationException($"StayExport service not found for ExportFormat: '{exportFormat}'");
+    }
+}

src/Somnia.GuestLog/Services/StayExport/StayExportProviderJson.cs

@@ -0,0 +1,30 @@
+using System.Text.Json;
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public class StayExportProviderJson : IStayExportFormatProvider
+{
+    private const string fileExtension = "json";
+
+    public StayExportFormat GetFormat() => StayExportFormat.GuestLogJson;
+    public string GetFilename(DateTime exportTime)
+        => $"{Enum.GetName(GetFormat())}_{exportTime.ToFileTimeUtc()}.{fileExtension}";
+
+
+    public async Task<(StayExportFileResult fileResult, string? exportDetails)> ExportDataAsync(IEnumerable<StayEntryDTO> stayList, Stream dataStream)
+    {
+        if (!stayList.Any())
+        {
+            return (fileResult: StayExportFileResult.NoData, exportDetails: null);
+        }
+
+        // Convert to JSON.
+        await JsonSerializer.SerializeAsync(dataStream, stayList);
+
+        List<string> exportDetails = [.. stayList.Where(s => s.Id != null).Select(s => s.Id?.ToString() ?? "")];
+        string details = JsonSerializer.Serialize(exportDetails);
+        return (fileResult: StayExportFileResult.OK, exportDetails: details);
+    }
+}

src/Somnia.GuestLog/Services/StayExport/StayExportProviderSpainParteViajeros.cs

@@ -0,0 +1,411 @@
+using System.Diagnostics;
+using System.Text.Json;
+using System.Xml.Serialization;
+using FluentValidation;
+using Microsoft.Extensions.Options;
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.Configuration;
+using Somnia.GuestLog.Models.DTOs;
+using Somnia.GuestLog.Services.SpainCodigoMunicipio;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public class StayExportProviderSpainParteViajeros(
+    ILogger<StayExportProviderSpainParteViajeros> logger,
+    ISpainCodigoMunicipioService codigoMunicipioService,
+    IOptions<StayExportSpainParteViajerosConfig> configOptions
+) : IStayExportFormatProvider
+{
+    private const string fileExtension = "xml";
+
+    private const string ExportDetailsResult_Error = "Error";
+    private const string ExportDetailsResult_Ok = "Ok";
+
+    private const string PersonRole = "VI";
+    private const string PersonRelation = "OT";
+
+    private const string PersonTipoDoc_NIF = "NIF";
+    private const string PersonTipoDoc_NIE = "NIE";
+    private const string PersonTipoDoc_PAS = "PAS";
+    private const string PersonTipoDoc_OTRO = "OTRO";
+
+    private const string PersonDireccionPais_ESP = "ESP";
+
+    private const string XmlNamespace_Peticion = "http://www.neg.hospedajes.mir.es/altaParteHospedaje";
+
+    private readonly StayExportSpainParteViajerosConfig config = configOptions.Value;
+
+
+    public StayExportFormat GetFormat() => StayExportFormat.SpainParteViajeros;
+    public string GetFilename(DateTime exportTime)
+        => $"{Enum.GetName(GetFormat())}_{exportTime.ToFileTimeUtc()}.{fileExtension}";
+
+    public async Task<(StayExportFileResult fileResult, string? exportDetails)> ExportDataAsync(IEnumerable<StayEntryDTO> stayList, Stream dataStream)
+    {
+        if (string.IsNullOrEmpty(config.CodigoEstablecimiento))
+        {
+            logger.LogError("StayExportProviderSpainParteViajeros - Config error: CodigoEstablecimiento is not configured!");
+            return (fileResult: StayExportFileResult.ExportError, exportDetails: null);
+        }
+
+        if (!stayList.Any())
+        {
+            return (fileResult: StayExportFileResult.NoData, exportDetails: null);
+        }
+
+        List<StayExportDetails> stayExportDetails = [];
+        ComunicacionValidator comunicacionValidator = new();
+
+        List<Comunicacion> comunicacionsList = [];
+        foreach (StayEntryDTO stay in stayList)
+        {
+            (Comunicacion? comunicacion, string errorMsg) = await GetComunicacionFromStay(stay);
+            if (comunicacion == null)
+            {
+                logger.LogWarning("StayExportProviderSpainParteViajeros - Stay (ID: {id}) can't be exported: Error: {code}", stay.Id, errorMsg);
+                stayExportDetails.Add(new(StayId: stay.Id ?? -1, ExportResult: ExportDetailsResult_Error, Details: errorMsg));
+                continue;
+            }
+
+            var errors = comunicacionValidator.Validate(comunicacion);
+            if (!errors.IsValid)
+            {
+                logger.LogWarning("StayExportProviderSpainParteViajeros - Stay (ID: {id}) is invalid: Errors: {errors}", stay.Id, errors.Errors);
+                stayExportDetails.Add(new(StayId: stay.Id ?? -1, ExportResult: ExportDetailsResult_Error, Details: errors.ToString()));
+                continue;
+            }
+
+            comunicacionsList.Add(comunicacion);
+            logger.LogInformation("StayExportProviderSpainParteViajeros - Stay (ID: {id}) Exported OK", stay.Id);
+            stayExportDetails.Add(new(StayId: stay.Id ?? -1, ExportResult: ExportDetailsResult_Ok, Details: null));
+        }
+
+        Peticion peticion = new()
+        {
+            solicitud = new()
+            {
+                codigoEstablecimiento = config.CodigoEstablecimiento,
+                comunicacion = comunicacionsList,
+            }
+        };
+
+        XmlSerializer serializer = new(typeof(Peticion));
+        serializer.Serialize(dataStream, peticion);
+
+        string details = JsonSerializer.Serialize(stayExportDetails);
+        return (fileResult: StayExportFileResult.OK, exportDetails: details);
+    }
+
+    #region Internal Methods
+
+    private async Task<(Comunicacion? comunicacion, string errorMsg)> GetComunicacionFromStay(StayEntryDTO stay)
+    {
+        Debug.Assert(stay.Id != null
+            && stay.DateIn != null
+            && stay.DateOut != null
+            && stay.GuestDocuments != null
+        );
+
+        //Call Fn to validate Stay.
+
+        Contrato contrato = new()
+        {
+            referencia = stay.Id.Value.ToString(),
+            fechaContrato = stay.DateIn.Value.Date,
+            fechaEntrada = stay.DateIn.Value,
+            fechaSalida = stay.DateOut.Value,
+            internet = config.InternetAvailable,
+            numHabitaciones = stay.RoomCount ?? -1,
+            numPersonas = stay.GuestDocuments.Count,
+            pago = new()
+            {
+                tipoPago = GetTipoPagoFromStay(stay)!
+            }
+        };
+
+        List<Persona> personasList = [];
+        foreach (GuestDocumentDTO doc in stay.GuestDocuments)
+        {
+            Direccion dir = new()
+            {
+                direccion = doc.Address!,
+                codigoPostal = doc.ZipCode!,
+                pais = doc.AddressCountry!,
+            };
+
+            //Get Municipio given current country.
+            if (doc.AddressCountry != PersonDireccionPais_ESP)
+            {
+                List<string?> addressParts = [doc.AddressCity, doc.AddressProvince, doc.AddressState];
+                dir.nombreMunicipio = string.Join(", ", addressParts.Where(p => !string.IsNullOrEmpty(p)));
+            }
+            if (doc.AddressCountry == PersonDireccionPais_ESP)
+            {
+                dir.codigoMunicipio = await GetMunicipioFromGuestAddressAsync(doc);
+                if (dir.codigoMunicipio == null)
+                {
+                    return (
+                        comunicacion: null,
+                        errorMsg: "Can't get codigo municio"
+                    );
+                }
+            }
+
+            Persona persona = new()
+            {
+                rol = PersonRole,
+                nombre = doc.Name!,
+                apellido1 = doc.Surname!,
+                apellido2 = doc.Surname2,
+                tipoDocumento = GetTipoDocumentoFromGuest(doc)!,
+                numeroDocumento = doc.DocumentNum!,
+                soporteDocumento = doc.SupportNum,
+                fechaNacimiento = doc.BirthDate?.Date ?? DateTime.MaxValue,
+                nacionalidad = doc.Nationality!,
+                sexo = GetSexoFromGuest(doc)!,
+                telefono = doc.PhoneNumber,
+                correo = doc.EmailAddress,
+                parentesco = PersonRelation,
+                direccion = dir,
+            };
+            personasList.Add(persona);
+        }
+
+        return (
+            comunicacion: new()
+            {
+                contrato = contrato,
+                persona = personasList
+            },
+            errorMsg: "OK");
+    }
+
+    private static string? GetTipoDocumentoFromGuest(GuestDocumentDTO doc)
+    {
+        return doc.DocumentType switch
+        {
+            GuestConsts.DocumentType_DNI => PersonTipoDoc_NIF,
+            GuestConsts.DocumentType_NIE => PersonTipoDoc_NIE,
+            GuestConsts.DocumentType_PASSPORT => PersonTipoDoc_PAS,
+            null => null,
+            _ => PersonTipoDoc_OTRO
+        };
+    }
+
+    private static string? GetSexoFromGuest(GuestDocumentDTO doc)
+    {
+        return doc.Gender switch
+        {
+            GuestConsts.GenderOptions_MALE => "H",
+            GuestConsts.GenderOptions_FEMALE => "F",
+            null => null,
+            _ => "O"
+        };
+    }
+
+    private static string? GetTipoPagoFromStay(StayEntryDTO stay)
+    {
+        return stay.PaymentMethod;
+    }
+
+    private async Task<string?> GetMunicipioFromGuestAddressAsync(GuestDocumentDTO doc)
+    {
+        if (string.IsNullOrEmpty(doc.AddressCity) || string.IsNullOrEmpty(doc.AddressProvince))
+        {
+            return null;
+        }
+
+        //Get codMunicipio from API.
+        return await codigoMunicipioService.GetCodigoMunicipioAsync(doc.AddressCity, doc.AddressProvince);
+    }
+
+    #endregion
+
+    #region Validator
+
+    private sealed class ComunicacionValidator : AbstractValidator<Comunicacion>
+    {
+        //TODO: Validate values in list for: Pago.tipoPago, Persona.sexo, Persona.tipoDocumento
+
+        public ComunicacionValidator()
+        {
+            RuleFor(comm => comm.contrato)
+                .NotNull()
+                .ChildRules(contrato =>
+                {
+                    contrato.RuleFor(p => p.referencia)
+                        .NotEmpty()
+                        .MaximumLength(50);
+
+                    contrato.RuleFor(p => p.fechaEntrada)
+                        .LessThan(p => p.fechaSalida);
+
+                    contrato.RuleFor(p => p.fechaSalida)
+                        .GreaterThan(p => p.fechaEntrada);
+
+                    contrato.RuleFor(p => p.numHabitaciones)
+                        .GreaterThanOrEqualTo(0);
+
+                    //BLOQUE PAGO
+                    contrato.RuleFor(p => p.pago)
+                        .ChildRules(e =>
+                        {
+                            e.RuleFor(p => p.tipoPago)
+                                .NotEmpty();
+                        });
+                });
+
+            RuleForEach(comm => comm.persona)
+                .ChildRules(person =>
+                {
+                    person.RuleFor(p => p.rol)
+                        .Equal(PersonRole);
+                    person.RuleFor(p => p.nombre)
+                        .NotEmpty()
+                        .MaximumLength(50);
+                    person.RuleFor(p => p.apellido1)
+                        .NotEmpty()
+                        .MaximumLength(50);
+                    person.RuleFor(p => p.apellido2)
+                        .MaximumLength(50);
+                    person.RuleFor(p => p.tipoDocumento)
+                        .NotEmpty()
+                        .MaximumLength(5);
+                    person.RuleFor(p => p.numeroDocumento)
+                        .NotEmpty()
+                        .MaximumLength(15);
+                    person.RuleFor(p => p.soporteDocumento)
+                        .NotEmpty()
+                        .When(p => p.tipoDocumento == PersonTipoDoc_NIF || p.tipoDocumento == PersonTipoDoc_NIE);
+                    person.RuleFor(p => p.fechaNacimiento)
+                        .NotEmpty();
+                    person.RuleFor(p => p.sexo)
+                        .MaximumLength(1);
+                    person.RuleFor(p => p.telefono)
+                        .MaximumLength(20);
+                    person.RuleFor(p => p.correo)
+                        .MaximumLength(250);
+
+                    person.RuleFor(p => p.direccion)
+                        .ChildRules(d =>
+                        {
+                            d.RuleFor(p => p.direccion)
+                                .NotEmpty()
+                                .MaximumLength(100);
+                            d.RuleFor(p => p.codigoMunicipio)
+                                .NotEmpty()
+                                .When(p => p.pais == PersonDireccionPais_ESP)
+                                .MaximumLength(5);
+                            d.RuleFor(p => p.nombreMunicipio)
+                                .NotEmpty()
+                                .When(p => p.pais != PersonDireccionPais_ESP)
+                                .MaximumLength(100);
+                            d.RuleFor(p => p.codigoMunicipio)
+                                .NotEmpty()
+                                .MaximumLength(20);
+                            d.RuleFor(p => p.pais)
+                                .NotEmpty()
+                                .Length(3);
+                        });
+                });
+
+            RuleForEach(comm => comm.persona)
+                .Must(p => !string.IsNullOrEmpty(p.telefono) || !string.IsNullOrEmpty(p.correo))
+                .WithMessage($"It's required to have at least one of the following fields: '{nameof(Persona.telefono)}', '{nameof(Persona.correo)}'");
+        }
+    }
+
+    #endregion
+
+    #region Export Data Classes
+
+    private record StayExportDetails(long StayId, string ExportResult, string? Details);
+
+    [XmlRoot(ElementName = "peticion", Namespace = XmlNamespace_Peticion)]
+    public class Peticion
+    {
+        public required Solicitud solicitud;
+    }
+
+    [XmlRoot(ElementName = "solicitud")]
+    public class Solicitud
+    {
+        public required string codigoEstablecimiento;
+        public required List<Comunicacion> comunicacion;
+    }
+
+    [XmlRoot(ElementName = "comunicacion")]
+    public class Comunicacion
+    {
+        public required Contrato contrato;
+        public required List<Persona> persona;
+    }
+
+    [XmlRoot(ElementName = "contrato")]
+    public class Contrato
+    {
+        public required string referencia;
+
+        [XmlElement(DataType = "date")]
+        public required DateTime fechaContrato;
+
+        [XmlElement(DataType = "dateTime")]
+        public required DateTime fechaEntrada;
+
+        [XmlElement(DataType = "dateTime")]
+        public required DateTime fechaSalida;
+
+        public required int numPersonas;
+        public int? numHabitaciones;
+        public bool? internet;
+
+        //BLOQUE PAGO
+        public required Pago pago;
+    }
+
+    [XmlRoot(ElementName = "persona")]
+    public class Persona
+    {
+        public required string rol;
+        public required string nombre;
+        public required string apellido1;
+        public string? apellido2;
+        public required string tipoDocumento;
+        public required string numeroDocumento;
+        public string? soporteDocumento;
+
+        [XmlElement(DataType = "date")]
+        public required DateTime fechaNacimiento;
+        public required string nacionalidad;
+        public required string sexo;
+
+        public string? telefono;
+        public string? correo;
+        public required string parentesco;
+
+        // BLOQUE DIRECCION
+        public required Direccion direccion;
+    }
+
+    public class Pago
+    {
+        public required string tipoPago;
+
+        // [XmlElement(DataType = "date")]
+        // public required DateTime fechaPago;
+        public string? medioPago;
+        public string? titular;
+        public string? caducidadTarjeta;
+    }
+
+    public class Direccion
+    {
+        public required string direccion;
+        public string? codigoMunicipio;
+        public string? nombreMunicipio;
+        public required string codigoPostal;
+        public required string pais;
+    }
+
+    #endregion
+}

src/Somnia.GuestLog/Services/StayExport/StayExportService.cs

@@ -0,0 +1,247 @@
+using System.Diagnostics;
+using FluentStorage;
+using FluentStorage.Storage;
+using Microsoft.Extensions.Options;
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Enums.Services;
+using Somnia.GuestLog.Models.Configuration;
+using Somnia.GuestLog.Models.DTOs;
+using Somnia.GuestLog.Models.QueryConfigs;
+using Somnia.GuestLog.Services.Entity;
+
+namespace Somnia.GuestLog.Services.StayExport;
+
+public class StayExportService(
+    ILogger<StayExportProviderJson> logger,
+    IOptions<StayExportConfig> exportConfig,
+    IStayExportFileEntityService stayExportEntityService,
+    IStayEntryEntityService stayEntityService,
+    IStayExportFormatProviderFactory providerFactory
+) : IStayExportService
+{
+
+    private static readonly StayEntryQueryConfig queryConfig =
+        new(IncludeGuests: true, UseSplitQueries: true, DisableTracking: true);
+    private readonly StayExportConfig config = exportConfig.Value;
+
+
+    public async Task<Result<StayExportFileDTO>> ExportStaysByParamsAsync(StayExportFormat format, StayExportParamsDTO exportParams)
+    {
+        //Get data to export.
+        IEnumerable<StayEntryDTO>? stayList;
+        try
+        {
+            stayList = await GetStaysToExportByParamsAsync(exportParams);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "JsonStayExportService - ExportStaysByParams: Error retriving stays to export!");
+            return Result<StayExportFileDTO>.Fail(ResultCode.UnknownError);
+        }
+
+        //Create initial StayExportFile
+        DateTime exportTime = DateTime.UtcNow;
+        StayExportFileDTO stayExport = new()
+        {
+            ExportFormat = format,
+            ExportParams = exportParams,
+            ExportTime = exportTime,
+        };
+
+        //Export data.
+        using Stream exportedDataStream = new MemoryStream();
+
+        //Generate data to export.
+        StayExportFileResult exportResult;
+        string? exportFilename = null;
+        try
+        {
+            //Create Format provider and export data to stream.
+            var provider = providerFactory.GetProvider(format);
+            (exportResult, stayExport.ExportDetails) = await provider.ExportDataAsync(stayList, exportedDataStream);
+
+            // "Rewind" stream so it can be read from the begining when uploading.
+            exportedDataStream.Seek(0, SeekOrigin.Begin);
+
+            exportFilename = provider.GetFilename(exportTime);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "JsonStayExportService - ExportStaysByParams: Error exporting data!");
+            exportResult = StayExportFileResult.ExportError;
+        }
+
+        //If data exported OK, save to file.
+        if (exportResult == StayExportFileResult.OK)
+        {
+            try
+            {
+                Debug.Assert(exportFilename != null);
+
+                string exportPathSubdir = "";
+                if (config.UseSubdirectoryByFormat)
+                {
+                    exportPathSubdir = Enum.GetName(format) ?? "";
+                }
+                string exportPath = Path.Combine(exportPathSubdir, exportFilename);
+
+                //Store data.
+                using IStore exportStore = GetExportStore();
+                await exportStore.SetObject(objectPath: exportPath, dataStream: exportedDataStream);
+
+                //Update path in item.
+                stayExport.ExportedPath = exportPath;
+            }
+            catch (Exception ex)
+            {
+                logger.LogError(ex, "JsonStayExportService - ExportStaysByParams: Error Uploading exported data!");
+                exportResult = StayExportFileResult.UploadError;
+            }
+        }
+
+        //Store StayExport in DB.
+        stayExport.ExportResult = exportResult;
+        Result? createResult = null;
+        try
+        {
+            createResult = await stayExportEntityService.CreateStayExportAsync(stayExport);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "JsonStayExportService - ExportStaysByParams: Error storing StayExportFile entity to DB: {stayExport}", stayExport);
+        }
+
+        //If everything is OK, return OK.
+        if (createResult != null && createResult.ResultCode == ResultCode.Ok)
+        {
+            return Result<StayExportFileDTO>.Ok(stayExport);
+        }
+
+        //Saving export to DB failed. Delete exported file (if exported)
+        if (!string.IsNullOrEmpty(stayExport.ExportedPath))
+        {
+            try
+            {
+                using IStore exportStore = GetExportStore();
+                await exportStore.DeleteObject(objectPath: stayExport.ExportedPath);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError(ex, "JsonStayExportService - ExportStaysByParams: Error deleting exported file after db saving error: {exportedPath}", stayExport.ExportedPath);
+            }
+        }
+
+        logger.LogError(
+            "JsonStayExportService - ExportStaysByDateIn: Error (code '{code}') storing StayExportFile entity to DB: {stayExport}",
+            createResult?.ResultCode, stayExport);
+        return Result<StayExportFileDTO>.Fail(ResultCode.UnknownError);
+    }
+
+
+    public async Task<Result> GetExportedFileAsync(StayExportFileDTO item, Stream dataStream)
+    {
+        if (string.IsNullOrEmpty(item.ExportedPath))
+        {
+            logger.LogWarning("Trying to get exported file without path!! Exported file can't be loaded!");
+            return Result.Fail(ResultCode.NotFound);
+        }
+
+        try
+        {
+            IStore store = GetExportStore();
+            await store.GetObject(item.ExportedPath, dataStream);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Error getting exported file '{id}' from path '{path}'", item.Id, item.ExportedPath);
+            return Result.FailUnknownError();
+        }
+
+        return Result.Ok();
+    }
+
+    public async Task<Result> DeleteExportedFileAsync(StayExportFileDTO item)
+    {
+        //Try to delete existing file.
+        if (!string.IsNullOrEmpty(item.ExportedPath))
+        {
+            bool fileDeletedFromStore = await DeleteExportFileFromStoreAsync(item);
+            if (!fileDeletedFromStore)
+            {
+                return Result.Fail(ResultCode.FileStorageError);
+            }
+        }
+
+        //Delete entry from DB.
+        Result deleteResult = await stayExportEntityService.DeleteStayExportAsync(item);
+        if (!deleteResult.IsSuccess)
+        {
+            return Result.Fail(deleteResult.ResultCode);
+        }
+
+        return Result.Ok();
+    }
+
+
+    #region Internal Methods
+
+    private async Task<IEnumerable<StayEntryDTO>> GetStaysToExportByParamsAsync(StayExportParamsDTO exportParams)
+    {
+        //Todo - Improve type selection (when there are more types).
+        if (exportParams.ExportType == StayExportParamType.PeriodDateIn)
+        {
+            if (exportParams.ExportPeriodStart == null || exportParams.ExportPeriodEnd == null)
+            {
+                throw new InvalidOperationException($"StayExportFile - ExportType {exportParams.ExportType} require date start/end. Null dates found");
+            }
+
+            //Get Stays in period.
+            StayEntryFilterDTO filter = new()
+            {
+                DateInStart = exportParams.ExportPeriodStart,
+                DateInEnd = exportParams.ExportPeriodEnd
+            };
+            return await stayEntityService.GetDtoListByFilterAsync(filter, limit: 0, queryConfig: queryConfig);
+        }
+
+        throw new InvalidOperationException($"StayExportFile - Error getting stays using params: export type invalid: {exportParams.ExportType}");
+    }
+
+    private async Task<bool> DeleteExportFileFromStoreAsync(StayExportFileDTO item)
+    {
+        Debug.Assert(!string.IsNullOrEmpty(item.ExportedPath));
+
+        try
+        {
+            IStore store = GetExportStore();
+            bool objectExist = await store.ObjectExists(item.ExportedPath);
+            if (!objectExist)
+            {
+                logger.LogWarning("StayExportService - File for item {id} not found in store! Skip delete!", item.Id);
+                return true;
+            }
+
+            await store.DeleteObject(item.ExportedPath);
+            logger.LogInformation("StayExportService - File for item {id} deleted from path {path}", item.Id, item.ExportedPath);
+            return true;
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "StayExportService - Error deleting export file of item {id}", item.Id);
+            return false;
+        }
+    }
+
+    private IStore GetExportStore()
+    {
+        string? storageConnString = config.ExportStorageConnectionString;
+        if (string.IsNullOrEmpty(storageConnString))
+        {
+            throw new InvalidOperationException("No Stay Export Storage configured. Stays can't be exported");
+        }
+
+        return StorageFactory.FromConnectionString(storageConnString);
+    }
+
+    #endregion
+}

src/Somnia.GuestLog/Services/UserMessageService.cs

@@ -1,26 +1,16 @@
-using Microsoft.Extensions.Localization;
 using MudBlazor;
-using Somnia.GuestLog.Models;
+using Somnia.GuestLog.Enums.Services;
+using Somnia.GuestLog.Enums.UI;
 using Somnia.GuestLog.Models.DTOs;
-using Somnia.GuestLog.Resources;
+using IResult = Somnia.GuestLog.Models.DTOs.IResult;
-using MessageKind = Somnia.GuestLog.Services.IUserMessageService.MessageKind;
 
 namespace Somnia.GuestLog.Services;
 
 public class UserMessageService(
-    IServiceProvider serviceProvider,
+    ILocalizerService Localizer,
     ISnackbar snackbar
 ) : IUserMessageService
 {
-    private IStringLocalizer<LanguageLocale> _localizer
-    {
-        get
-        {
-            return serviceProvider.GetRequiredService<IStringLocalizer<LanguageLocale>>();
-        }
-    }
-
-
     public void ShowMessage(string text, MessageKind kind, params object[] parameters)
     {
         string formatedMsg = GetFormatedMessage(text, parameters);
@@ -28,12 +18,12 @@ public class UserMessageService(
     }
 
 
-    public void ShowResult(Result resultDto)
+    public void ShowResult(IResult resultDto)
     {
         ShowResultWithMessage(resultDto, message: null);
     }
 
-    public void ShowResultWithMessage(Result resultDto, string? message)
+    public void ShowResultWithMessage(IResult resultDto, string? message)
     {
         string resultMsg = GetMsgForResultCode(resultDto.ResultCode);
         resultMsg = GetFormatedMessage(resultMsg, resultDto.Context);
@@ -59,9 +49,9 @@ public class UserMessageService(
         snackbar.Add(message: msg, severity: GetSnackbarSeveryForMessageKind(kind));
     }
 
-    private string GetMsgForResultCode(string resultCode)
+    private string GetMsgForResultCode(ResultCode resultCode)
     {
-        return _localizer[$"resultCode.{resultCode}"];
+        return Localizer.GetEnumValue(resultCode);
     }
 
     private static string GetFormatedMessage(string template, params object[]? parameters)

src/Somnia.GuestLog/Somnia.GuestLog.csproj

@@ -8,6 +8,8 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="FluentStorage" />
+    <PackageReference Include="FluentStorage.AWS" />
     <PackageReference Include="FluentValidation" />
     <PackageReference Include="MudBlazor" />
   </ItemGroup>

src/Somnia.GuestLog/Utils/QueryExtensions.cs

@@ -8,4 +8,9 @@ public static class QueryExtensions
     {
         return condition ? source.Where(predicate) : source;
     }
+
+    public static IQueryable<T> WithLimit<T>(this IQueryable<T> source, int limit)
+    {
+        return limit > 0 ? source.Take(limit) : source;
+    }
 }

src/Somnia.GuestLog/Validators/StayExportParamsDTOValidator.cs

@@ -0,0 +1,23 @@
+using FluentValidation;
+using Somnia.GuestLog.Enums.Models;
+using Somnia.GuestLog.Models.DTOs;
+
+namespace Somnia.GuestLog.Validators;
+
+public class StayExportParamsDTOValidator : ValueValidator<StayExportParamsDTO>
+{
+    public StayExportParamsDTOValidator()
+    {
+        RuleFor(e => e.ExportType)
+            .NotEmpty();
+
+        RuleFor(e => e.ExportPeriodStart)
+            .NotEmpty()
+            .When(e => e.ExportType == StayExportParamType.PeriodDateIn);
+
+        RuleFor(e => e.ExportPeriodEnd)
+            .NotEmpty()
+            .When(e => e.ExportType == StayExportParamType.PeriodDateIn);
+
+    }
+}

src/Somnia.GuestLog/appsettings.json

@@ -20,5 +20,14 @@
     "ApiKey": "",
     "UserAgent": "Somnia-GuestLog-Dev",
     "ResultLang": "es"
+  },
+  "StayExport": {
+    "EnableStayExport": true,
+    "ExportStorageConnectionString": "disk://path=/SomniaGuestLog/StayExportFiles",
+    "UseSubdirectoryByFormat": true
+  },
+  "StayExportSpainParteViajeros": {
+    "InternetAvailable": true,
+    "CodigoEstablecimiento": ""
   }
 }

src/Somnia.GuestLog/wwwroot/js/App.js

@@ -0,0 +1,13 @@
+
+// Function to download files from Blazor pages
+window.downloadFileFromStream = async (fileName, contentStreamReference) => {
+    const arrayBuffer = await contentStreamReference.arrayBuffer();
+    const blob = new Blob([arrayBuffer]);
+    const url = URL.createObjectURL(blob);
+    const anchorElement = document.createElement('a');
+    anchorElement.href = url;
+    anchorElement.download = fileName ?? '';
+    anchorElement.click();
+    anchorElement.remove();
+    URL.revokeObjectURL(url);
+}