namespace IBKRTrader.Core.Trading;

/// <summary>
/// Buchführung über offene Positionen und Ausführungen (core_position, core_trade_history).
/// Externer Seam gegenüber der Datenbank: in Tests gemockt.
/// </summary>
public interface IPortfolioService
{
    /// <summary>Summe des offenen Nominalwerts eines Moduls.</summary>
    Task<decimal> GetModuleExposureAsync(string module, CancellationToken ct = default);

    /// <summary>Gehaltene Stückzahl eines Moduls für ein Symbol (0, wenn keine Position).</summary>
    Task<int> GetPositionQuantityAsync(string module, string symbol, CancellationToken ct = default);

    /// <summary>Verbucht einen Fill: aktualisiert Position, Budget und Trade-Historie.</summary>
    Task RecordFillAsync(
        string module, string symbol, TradeSide side,
        int quantity, decimal price, string? orderId, CancellationToken ct = default);

    /// <summary>Alle offenen Positionen eines Moduls.</summary>
    Task<IReadOnlyList<Position>> GetPositionsAsync(string module, CancellationToken ct = default);
}