using PowderCoating.Application.DTOs.Accounting;

namespace PowderCoating.Application.Interfaces;

/// <summary>
/// Read-only service for financial aggregate reports. All methods query the database
/// with AsNoTracking and return pre-shaped DTOs — no tracked entities are returned.
/// Implemented in Infrastructure; uses ApplicationDbContext directly.
/// </summary>
public interface IFinancialReportService
{
    /// <summary>Returns a Profit &amp; Loss report for the given company and date range.</summary>
    Task<ProfitAndLossDto> GetProfitAndLossAsync(int companyId, DateTime from, DateTime to);

    /// <summary>Returns a Balance Sheet snapshot as of the given date.</summary>
    Task<BalanceSheetDto> GetBalanceSheetAsync(int companyId, DateTime asOf);

    /// <summary>Returns an AR Aging report bucketed at 0-30, 31-60, 61-90, and 90+ days.</summary>
    Task<ArAgingReportDto> GetArAgingAsync(int companyId, DateTime asOf);

    /// <summary>Returns a Sales &amp; Income report for the given company and date range.</summary>
    Task<SalesIncomeReportDto> GetSalesAndIncomeAsync(int companyId, DateTime from, DateTime to);

    /// <summary>Returns an invoice-basis Sales Tax Liability report for the given company and date range.</summary>
    Task<SalesTaxReportDto> GetSalesTaxReportAsync(int companyId, DateTime from, DateTime to);
}