initial commit

Services/IPdfService.cs

@@ -0,0 +1,25 @@
+using HC_APTBS.Models;
+
+namespace HC_APTBS.Services
+{
+    /// <summary>
+    /// Generates PDF test reports from completed pump test data.
+    /// The implementation uses QuestPDF.
+    /// </summary>
+    public interface IPdfService
+    {
+        /// <summary>
+        /// Generates a PDF report for the completed test and saves it to <paramref name="outputFolder"/>.
+        /// </summary>
+        /// <param name="pump">Pump definition with populated test results.</param>
+        /// <param name="operatorName">Name of the operator to appear in the report header.</param>
+        /// <param name="clientName">Client/customer name to appear in the report header.</param>
+        /// <param name="outputFolder">Directory where the PDF file will be saved.</param>
+        /// <returns>Full path to the generated PDF file.</returns>
+        string GenerateReport(
+            PumpDefinition pump,
+            string operatorName,
+            string clientName,
+            string outputFolder);
+    }
+}