rama creada apartir de master en j

adas-core.Domain/Models/DTO/AppointmentDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for transferring appointment information between application layers or services.
+/// </summary>
 public class AppointmentDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/AssetDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for conveying asset information between application layers or services.
+/// </summary>
 public class AssetDto
 {
     public string? Name { get; set; }

adas-core.Domain/Models/DTO/ConfigObservationDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to convey configuration observation information between application layers.
+/// </summary>
 public class ConfigObservationDto
 {
     public string Id { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/CreateUserWithAuthDto.cs

@@ -2,6 +2,9 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to create a user along with authentication details.
+/// </summary>
 public class CreateUserWithAuthDto
 {
     public User User { get; set; } = new();

adas-core.Domain/Models/DTO/DeviceDto.cs

@@ -4,6 +4,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object (DTO) used to encapsulate and transfer device-related information between application layers or services.
+/// </summary>
 public class DeviceDto
 {
     public DeviceEvent? Event { get; set; }
@@ -22,6 +25,12 @@ public class DeviceDto
     public List<ObjectId>? PointOfCareIds { get; set; } = new(); 
     public DeviceSettings? Settings { get; set; }
 }
+/// <summary>
+/// Represents an event associated with a device, encapsulating information about a device-related occurrence or state change.
+/// </summary>
+/// <remarks>
+/// This class is intended to be used as a data carrier for device event notifications or processing.
+/// </remarks>
 public class DeviceEvent
 {
     public ClickType? ClickType { get; set; } 

adas-core.Domain/Models/DTO/DiagnosisDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object (DTO) for conveying diagnosis information between application layers or services.
+/// </summary>
 public class DiagnosisDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/Display/ColorConfigDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object (DTO) that encapsulates color configuration settings for transferring color-related data between application layers or systems.
+/// </summary>
 public class ColorConfigDto
 {
     public LevelColors? Level { get; set; }
@@ -12,6 +15,9 @@ public class ColorConfigDto
     public TestColors? Test { get; set; }
     public ProcedureColors? Procedure { get; set; }
 
+    /// <summary>
+    /// Represents configuration settings that define the visual appearance, such as colors, themes, or styling preferences.
+    /// </summary>
     public class AppearanceSettings
     {
         public string? TextColor { get; set; }
@@ -24,6 +30,12 @@ public class ColorConfigDto
         public double? IconInvertColor { get; set; }
     }
 
+    /// <summary>
+    /// Represents the color settings used for rendering numeric values within a status box.
+    /// </summary>
+    /// <remarks>
+    /// This type is intended to encapsulate the visual color configuration associated with the numeric portion of a status box display.
+    /// </remarks>
     public class StatusBoxNumberColors
     {
         public AppearanceSettings? Reserved { get; set; }
@@ -35,6 +47,9 @@ public class ColorConfigDto
         public AppearanceSettings? Altable { get; set; }
     }
 
+    /// <summary>
+    /// Provides a centralized set of color values used throughout the therapy-related user interface or visual components.
+    /// </summary>
     public class TherapyColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -43,6 +58,9 @@ public class ColorConfigDto
         public AppearanceSettings? InProgress { get; set; }
     }
 
+    /// <summary>
+    /// Provides a collection of color values intended for use in test scenarios.
+    /// </summary>
     public class TestColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -51,6 +69,9 @@ public class ColorConfigDto
         public AppearanceSettings? Expired { get; set; }
     }
 
+    /// <summary>
+    /// Represents a collection of color definitions used to visually represent procedures.
+    /// </summary>
     public class ProcedureColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -59,6 +80,12 @@ public class ColorConfigDto
         public AppearanceSettings? Expired { get; set; }
     }
 
+    /// <summary>
+    /// Represents a set of colors associated with level rendering or visual state.
+    /// </summary>
+    /// <remarks>
+    /// Used to centralize color definitions related to level display, allowing consistent theming across level-related UI elements.
+    /// </remarks>
     public class LevelColors
     {
         public string? Level1 { get; set; }
@@ -68,6 +95,9 @@ public class ColorConfigDto
         public string? Level5 { get; set; }
     }
 
+    /// <summary>
+    /// Represents a collection of predefined text color values or definitions for styling text output.
+    /// </summary>
     public class TextColors
     {
         public string? Normal { get; set; }
@@ -77,6 +107,9 @@ public class ColorConfigDto
         public string? Expired { get; set; }
     }
 
+    /// <summary>
+    /// Provides a set of predefined color values used for rendering arrows in charts or visualizations.
+    /// </summary>
     public class ArrowColors
     {
         public string? Normal { get; set; }
@@ -85,6 +118,9 @@ public class ColorConfigDto
         public string? Improve { get; set; }
     }
 
+    /// <summary>
+    /// Represents a collection or definition of colors used to visually style an indicator.
+    /// </summary>
     public class IndicatorColors
     {
         public string? Empty { get; set; }
@@ -95,6 +131,9 @@ public class ColorConfigDto
         public string? EmptyBackground { get; set; }
     }
 
+    /// <summary>
+    /// Represents a collection or definition of colors used for rendering graphs and chart elements.
+    /// </summary>
     public class GraphColors
     {
         public string? Normal { get; set; }

adas-core.Domain/Models/DTO/Display/CreateDisplayConfigDto.cs

@@ -4,6 +4,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object used to create a new display configuration.
+/// </summary>
 public class CreateDisplayConfigDto
 {
     public DisplayConfigEnums.DisplayType Type { get; set; } =
@@ -14,6 +17,9 @@ public class CreateDisplayConfigDto
     public string? DisplayConfigIdTemplate { get; set; }
 }
 
+/// <summary>
+/// Represents a data transfer object used to create a display configuration card.
+/// </summary>
 public class CreateDisplayConfigCardDto
 {
     public CardConfig? CardConfig { get; set; }

adas-core.Domain/Models/DTO/Display/DisplayConfigDto.cs

@@ -5,6 +5,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object for display configuration settings.
+/// </summary>
 public class DisplayConfigDto
 {
     public ObjectId Id { get; set; }

adas-core.Domain/Models/DTO/Display/DisplayConfigLocationDto.cs

@@ -1,5 +1,11 @@
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object that encapsulates display configuration and location information.
+/// </summary>
+/// <remarks>
+/// This DTO is used to transfer display configuration settings along with their associated location data between application layers.
+/// </remarks>
 public class DisplayConfigLocationDto
 {
     public string? DisplayName { get; set; }

adas-core.Domain/Models/DTO/Display/DisplayConfigSummary.cs

@@ -3,6 +3,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a summary of display configuration settings, providing a consolidated view of display-related parameters.
+/// </summary>
 public class DisplayConfigSummary
 {
     public ObjectId Id { get; set; }

adas-core.Domain/Models/DTO/Display/DisplayMinimalDto.cs

@@ -3,6 +3,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a minimal data transfer object that encapsulates a subset of fields from a <see cref="MongoModels.Display"/> model for lightweight serialization or transfer.
+/// </summary>
 public class DisplayMinimalDto(MongoModels.Display display)
 {
     public ObjectId Id { get; set; } = display.Id;

adas-core.Domain/Models/DTO/Display/DisplayNurseDto.cs

@@ -2,6 +2,9 @@
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object used for displaying nurse information, extending the base display configuration functionality provided by <see cref="DisplayConfigDto"/>.
+/// </summary>
 public class DisplayNurseDto : DisplayConfigDto
 {
     public List<BannerItem>? HomeBanner { get; set; }

adas-core.Domain/Models/DTO/Display/DisplayWithPermissionsDto.cs

@@ -2,6 +2,12 @@
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object that combines display-related information with associated permissions.
+/// </summary>
+/// <remarks>
+/// This DTO is intended for transferring presentation data together with the permissions required to view or interact with it.
+/// </remarks>
 public class DisplayWithPermissionsDto
 {
     public DisplayPermissionTypes? Permissions { get; set; }

adas-core.Domain/Models/DTO/Display/MinimalDisplayListDto.cs

@@ -2,6 +2,9 @@ using adas_core.Domain.Models.MongoModels;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object that provides a minimal representation of a display list for transfer between application layers.
+/// </summary>
 public class MinimalDisplayListDto
 {
     public List<MinimalDisplaySection> DisplayNurse { get; set; } = [];

adas-core.Domain/Models/DTO/Display/SmartDisplayDto.cs

@@ -3,6 +3,9 @@ using adas_core.Domain.Models.MongoModels;
 
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object for a smart display configuration, extending the base display configuration with additional smart display properties.
+/// </summary>
 public class SmartDisplayDto : DisplayConfigDto
 {
     public bool? HasCameras { get; set; }

adas-core.Domain/Models/DTO/Display/UpdateDisplayConfigNameDto.cs

@@ -1,5 +1,11 @@
 namespace adas_core.Domain.Models.DTO.Display;
 
+/// <summary>
+/// Represents a data transfer object used to update the name of a display configuration.
+/// </summary>
+/// <remarks>
+/// This DTO is intended to carry the necessary information to modify the name of an existing display configuration entity.
+/// </remarks>
 public class UpdateDisplayConfigNameDto
 {
     public string DisplayName { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/MasterListDto.cs

@@ -3,6 +3,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for a master list, used to transfer collection data between application layers.
+/// </summary>
 public class MasterListDto
 {
     public ObjectId Id { get; set; }

adas-core.Domain/Models/DTO/MasterListWithPaginatedOptionsDto.cs

@@ -4,6 +4,12 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object that combines a master list with pagination options and a collection of unit information items.
+/// </summary>
+/// <remarks>
+/// This DTO packages a <see cref="MasterList"/> together with the configured <c>pageSize</c> and a list of <see cref="UnitInfoDto"/> entries for transport across application boundaries.
+/// </remarks>
 public class MasterListWithPaginatedOptionsDto(MasterList masterList, int pageSize, List<UnitInfoDto> units)
 {
     public ObjectId Id { get; set; } = masterList.Id;

adas-core.Domain/Models/DTO/ObservationAlarmDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for an observation alarm, used to encapsulate and transfer alarm-related information between application layers.
+/// </summary>
 public class ObservationAlarmDto
 {
     public string? PatientNumber { get; set; }

adas-core.Domain/Models/DTO/ObservationDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for an observation, used to transfer observation data between application layers or services.
+/// </summary>
 public class ObservationDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/PaginationPairDto.cs

@@ -2,6 +2,12 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object (DTO) that encapsulates a pair of pagination-related values for transport between layers or services.
+/// </summary>
+/// <remarks>
+/// Typically used to convey paired pagination metadata, such as a page number together with a page size or total count, in request or response payloads.
+/// </remarks>
 public class PaginationPairDto
 {
     public PaginationFilter ListFilter { get; set; } = new();

adas-core.Domain/Models/DTO/PatientDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to encapsulate and transfer patient information between application layers or services.
+/// </summary>
 public class PatientDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/PocAndUnitDto.cs

@@ -2,11 +2,17 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object that encapsulates point of contact and unit information for transfer between application layers or systems.
+/// </summary>
 public class PocAndUnitDto
 {
     public List<MinimalPocAndUnitDto> PocList { get; set; } = [];
 }
 
+/// <summary>
+/// Represents a minimal data transfer object encapsulating point of consumption and unit information.
+/// </summary>
 public class MinimalPocAndUnitDto
 {
     public string? PocName { get; set; }

adas-core.Domain/Models/DTO/PointOfCareDto.cs

@@ -5,6 +5,9 @@ using LightBeacon = adas_core.Domain.Models.MongoModels.LightBeacon;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for point-of-care information, used to transfer point-of-care data between application layers or services.
+/// </summary>
 public class PointOfCareDto
 {
    
@@ -32,6 +35,9 @@ public class PointOfCareDto
 
     #endregion
 }
+/// <summary>
+/// Represents a data transfer object (DTO) for point-of-care configuration settings, used to transfer configuration data between layers or systems.
+/// </summary>
 public class PointOfCareConfigurationDto
 {
     public List<LightBeacon> BeaconList { get; set; } = [];

adas-core.Domain/Models/DTO/PumpDto.cs

@@ -2,6 +2,9 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for conveying pump-related information between application layers.
+/// </summary>
 public class PumpDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/RecordingAlertDto.cs

@@ -2,6 +2,9 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to convey information about a recording alert between application layers or services.
+/// </summary>
 public class RecordingAlertDto
 {
     public string? PatientNumber { get; set; }

adas-core.Domain/Models/DTO/TreatmentDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object for conveying treatment information between application layers.
+/// </summary>
 public class TreatmentDto
 {
     public string PatientNumber { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/UnitInfoDto.cs

@@ -4,6 +4,9 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object that encapsulates information about a unit.
+/// </summary>
 public class UnitInfoDto
 {
     [JsonConstructor]

adas-core.Domain/Models/DTO/UpdateListNameAndDescriptionDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to update the name and description of a list.
+/// </summary>
 public class UpdateListNameAndDescriptionDto
 {
     public string? Name { get; set; }

adas-core.Domain/Models/DTO/UpdateMasterListDetailsDto.cs

@@ -2,6 +2,9 @@ using adas_core.Domain.Models.Masters;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to transfer updated master list details between application layers.
+/// </summary>
 public class UpdateMasterListDetailsDto
 {
     public bool? CanAddElement { get; set; }

adas-core.Domain/Models/DTO/UpdateObservationDto.cs

@@ -2,6 +2,9 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to update an existing observation.
+/// </summary>
 public class UpdateObservationDto
 {
     public ConfigObservation? OldConfigObservationItem { get; set; }

adas-core.Domain/Models/DTO/UpdateOptionMasterListDto.cs

@@ -2,6 +2,9 @@ using adas_core.Domain.Models.Masters;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to update an option master list.
+/// </summary>
 public class UpdateOptionMasterListDto
 {
     public OptionList? UpdatedOption { get; set; }

adas-core.Domain/Models/DTO/UpdatePasswordDto.cs

@@ -1,5 +1,8 @@
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to encapsulate the information required to update a user's password.
+/// </summary>
 public class UpdatePasswordDto
 {
     public string OldPassword { get; set; } = string.Empty;

adas-core.Domain/Models/DTO/UpdateUnitIdListDto.cs

@@ -3,36 +3,51 @@ using MongoDB.Bson;
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to update a list of unit identifiers.
+/// </summary>
 public class UpdateUnitIdListDto
 {
     public ObjectId UnitId { get; set; }
 
     public List<MasterListData> MasterListData { get; set; } = [];
 
+    /// <summary>
+    /// Returns a string representation of the <see cref="UpdateUnitIdListDto"/> instance, including the formatted entries of its <c>MasterListData</c> collection.
+    /// </summary>
+    /// <returns>A string in the format <c>UpdateUnitIdListDto[...</c> containing the concatenated <c>MasterListData</c> values.</returns>
     public override string ToString()
-    {
-        List<string> items = [];
-
-        items.AddRange(MasterListData.Select(masterListData => $", MasterListData: {masterListData}"));
-
-
-        return "UpdateUnitIdListDto[" + string.Join(", ", items) + "]";
-    }
+        {
+            List<string> items = [];
+    
+            items.AddRange(MasterListData.Select(masterListData => $", MasterListData: {masterListData}"));
+    
+    
+            return "UpdateUnitIdListDto[" + string.Join(", ", items) + "]";
+        }
 }
 
+/// <summary>
+/// Represents a data container for a master list, serving as a centralized collection of items used for reference or aggregation purposes.
+/// </summary>
 public class MasterListData
 {
     public ObjectId? MasterListId { get; set; }
     public MasterListType? MasterListType { get; set; }
 
+    /// <summary>
+    /// Returns a string representation of the master list, formatted with its identifier and type enclosed in square brackets.
+    /// Handles null values for <c>MasterListId</c> and <c>MasterListType</c> by displaying them as "Null" and "null" respectively.
+    /// </summary>
+    /// <returns>A formatted string containing the identifier and type of the master list.</returns>
     public override string ToString()
-    {
-        List<string> items =
-        [
-            MasterListId != null ? $"identifier: {MasterListId.ToString()}" : "identifier: Null",
-            MasterListType != null ? $"type: {MasterListType.ToString()}" : "type: null"
-        ];
-
-        return "[" + string.Join(", ", items) + "]";
-    }
+        {
+            List<string> items =
+            [
+                MasterListId != null ? $"identifier: {MasterListId.ToString()}" : "identifier: Null",
+                MasterListType != null ? $"type: {MasterListType.ToString()}" : "type: null"
+            ];
+    
+            return "[" + string.Join(", ", items) + "]";
+        }
 }

adas-core.Domain/Models/DTO/UpdateUserWithAuthDto.cs

@@ -2,6 +2,12 @@
 
 namespace adas_core.Domain.Models.DTO;
 
+/// <summary>
+/// Represents a data transfer object used to update a user along with their authentication details.
+/// </summary>
+/// <remarks>
+/// This DTO is typically used to transfer user account and authentication information in update operations.
+/// </remarks>
 public class UpdateUserWithAuthDto
 {
     public User User { get; set; } = new();