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

    /// <summary>Returns a dated activity statement for a customer showing opening balance, all transactions in the period, and closing balance.</summary>
    Task<CustomerStatementDto> GetCustomerStatementAsync(int companyId, int customerId, DateTime from, DateTime to);

    /// <summary>Returns a dated activity statement for a vendor showing opening balance, all transactions in the period, and closing balance.</summary>
    Task<VendorStatementDto> GetVendorStatementAsync(int companyId, int vendorId, DateTime from, DateTime to);

    /// <summary>
    /// Returns a Cash Flow Statement for the period using the direct (cash-basis) method for
    /// operating activities. Investing and Financing sections are derived from account-level data.
    /// BeginningCash is computed from all cash/bank account credits and debits prior to
    /// <paramref name="from"/>; EndingCash adds the net change during the period.
    /// </summary>
    Task<CashFlowStatementDto> GetCashFlowStatementAsync(int companyId, DateTime from, DateTime to);
}