HC_APTBS/Services/IPdfService.cs

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>
        /// <param name="clientInfo">Optional multi-line client address/contact info shown under the client name in the header.</param>
        /// <param name="observations">Optional free-text operator observations rendered in a dedicated section near the bottom of the report.</param>
        /// <returns>Full path to the generated PDF file.</returns>
        string GenerateReport(
            PumpDefinition pump,
            string operatorName,
            string clientName,
            string outputFolder,
            string? clientInfo = null,
            string? observations = null);
    }
}