Initial commit

src/PowderCoating.Application/Interfaces/IJobPhotoService.cs

@@ -0,0 +1,45 @@
+using Microsoft.AspNetCore.Http;
+using PowderCoating.Core.Enums;
+
+namespace PowderCoating.Application.Interfaces;
+
+public interface IJobPhotoService
+{
+    /// <summary>
+    /// Saves a job photo to filesystem using a GUID-based filename for security
+    /// Stores in [ContentRoot]/media/{companyId}/job-photos/{jobId}/{guid}.{ext}
+    /// </summary>
+    /// <param name="file">The photo file to upload</param>
+    /// <param name="jobId">The job's ID</param>
+    /// <param name="companyId">The company's ID</param>
+    /// <param name="caption">Optional caption/note for the photo</param>
+    /// <param name="photoType">Type of photo (Before, Progress, After, etc.)</param>
+    /// <returns>Tuple with success status, relative file path, and error message if any</returns>
+    Task<(bool Success, string FilePath, string ErrorMessage)> SaveJobPhotoAsync(
+        IFormFile file,
+        int jobId,
+        int companyId,
+        string? caption = null,
+        JobPhotoType photoType = JobPhotoType.Progress);
+
+    /// <summary>
+    /// Deletes a job photo from filesystem
+    /// </summary>
+    /// <param name="filePath">Relative path to the photo file</param>
+    /// <returns>Tuple with success status and error message if any</returns>
+    Task<(bool Success, string ErrorMessage)> DeleteJobPhotoAsync(string filePath);
+
+    /// <summary>
+    /// Gets a job photo
+    /// </summary>
+    /// <param name="filePath">Relative path to the photo</param>
+    /// <returns>Tuple with success status, file bytes, content type, and error message</returns>
+    Task<(bool Success, byte[] FileContent, string ContentType, string ErrorMessage)> GetJobPhotoAsync(string filePath);
+
+    /// <summary>
+    /// Checks if a job photo exists
+    /// </summary>
+    /// <param name="filePath">Relative path to the photo</param>
+    /// <returns>True if exists, false otherwise</returns>
+    Task<bool> JobPhotoExistsAsync(string filePath);
+}