rama creada apartir de master en j

adas-core.Application/Services/FileService.cs

@@ -11,6 +11,9 @@ using Serilog;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Provides a concrete implementation of the <see cref="IFileService"/> contract for performing file-related operations.
+/// </summary>
 public class FileService : IFileService
 {
     private readonly string? _assetsDirectory;
@@ -32,6 +35,12 @@ public class FileService : IFileService
     }
 
 
+    /// <summary>
+    /// Copies the provided uploaded files into the configured update directory, creating each file on disk.
+    /// Returns false if the update directory is not configured (null, empty, or whitespace); otherwise returns true after all files have been copied.
+    /// </summary>
+    /// <param name="files">The collection of uploaded form files to be written to the update directory.</param>
+    /// <returns>A task that resolves to true when every file is successfully copied, or false when the update directory is not configured.</returns>
     public async Task<bool> CopyUpdateFiles(ICollection<IFormFile> files)
     {
         if (string.IsNullOrWhiteSpace(_updateDirectory)) return false;
@@ -45,6 +54,12 @@ public class FileService : IFileService
         return true;
     }
 
+    /// <summary>
+    /// Asynchronously uploads a collection of asset files into a directory organized by the specified theme. If the assets directory is not configured, the method returns false; otherwise, it ensures the target directory exists, writes each file to disk, and returns true.
+    /// </summary>
+    /// <param name="files">The collection of uploaded form files to persist to the assets directory.</param>
+    /// <param name="themeParse">The asset theme used to determine the subdirectory in which the files will be stored.</param>
+    /// <returns>A task that resolves to <c>true</c> when the files are successfully written, or <c>false</c> when the assets directory path is not configured.</returns>
     public async Task<bool> UploadAssetFiles(ICollection<IFormFile> files, FileEnum.AssetTheme themeParse)
     {
         if (string.IsNullOrWhiteSpace(_assetsDirectory)) return false;
@@ -60,6 +75,12 @@ public class FileService : IFileService
         return true;
     }
 
+    /// <summary>
+    /// Retrieves all asset files from the subdirectory that matches the specified theme, creating the subdirectory if it does not exist.
+    /// Returns an empty list when the assets directory is not configured or when an error occurs while reading the files.
+    /// </summary>
+    /// <param name="themeParse">The theme used to locate the corresponding subdirectory within the assets directory.</param>
+    /// <returns>A list of <see cref="AssetDto"/> objects containing the name, extension, and full path of each file found; an empty list if the assets directory is not configured or an error occurs.</returns>
     public List<AssetDto> GetAllAssetFile(FileEnum.AssetTheme themeParse)
     {
         try
@@ -91,6 +112,13 @@ public class FileService : IFileService
         }
     }
 
+    /// <summary>
+    /// Retrieves the list of file paths contained in the specified directory.
+    /// If the directory does not exist, a warning is logged and an empty list is returned;
+    /// if an error occurs during retrieval, it is logged and an empty list is returned.
+    /// </summary>
+    /// <param name="directoryPath">The path of the directory to search for files.</param>
+    /// <returns>A list of file paths found in the directory, or an empty list if the directory does not exist or an error occurs.</returns>
     public List<string> GetFilesInDirectory(string directoryPath)
     {
         List<string> fileList = [];