using PowderCoating.Application.DTOs.Accounting;
using PowderCoating.Core.Enums;

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.
/// The <paramref name="method"/> parameter overrides the company's stored preference when
/// supplied; pass <c>null</c> to fall back to the company's configured accounting method.
/// </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, AccountingMethod? method = null);

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

    /// <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);

    /// <summary>Returns an AP Aging report bucketed at 0-30, 31-60, 61-90, and 90+ days past the bill due date.</summary>
    Task<ApAgingReportDto> GetApAgingAsync(int companyId, DateTime asOf);

    /// <summary>Returns a Trial Balance using current account balances as of the given date.</summary>
    Task<TrialBalanceDto> GetTrialBalanceAsync(int companyId, DateTime asOf);

    /// <summary>Looks up the accounting method configured for the given company. Returns Accrual if not found.</summary>
    Task<AccountingMethod> GetCompanyAccountingMethodAsync(int companyId);
}