Kapitalmodell rechnet Waehrungen um, statt sie zu addieren

Solange jedes Instrument in USD notierte, war die Frage gegenstandslos. Mit
waehrungsfaehigen Instrumenten ist sie es nicht mehr: CapitalService summierte
BoundCapital ueber alle Positionen unabhaengig von deren Waehrung und verglich
das Ergebnis mit NetLiquidation in Kontobasiswaehrung. Dasselbe galt fuer die
Konzentration je Basiswert und fuer die offenen Reservierungen, die von einer
Groesse in Basiswaehrung abgezogen wurden.

Auf dem Testkonto ist die Basis EUR und USD steht bei 0,8611: jede USD-Position
ging bisher rund 16 Prozent zu hoch in das verteilbare Kapital ein. Die Richtung
des Fehlers wechselt mit dem Kurs - bei einer starken Fremdwaehrung wird die
Auslastung unterschaetzt und ein Buch darf mehr aufmachen als es soll.

Die Kurse kommen aus dem Ledger des Brokers ($LEDGER:ALL, Tag ExchangeRate),
nicht aus einer eigenen Quelle. Das ist Absicht: NetLiquidation und
TotalCashValue sind mit genau diesen Kursen gebildet. Mit einem fremden Kurs
verglichen wir den Positionswert gegen eine Kontogroesse, die anders gerechnet
wurde. Fuer die Buchhaltung gilt das Gegenteil - dort ist der amtliche
Tageskurs der richtige, das ist ein anderer Zweck (#321).

Fehlt ein Kurs, wird nicht geraten: der Snapshot meldet FxComplete=false, der
Positionswert gilt als Untergrenze, und der Kauf wird angehalten. Schliessen
bleibt moeglich. Eine Reservierung ohne Kurs wird dagegen roh angesetzt statt
uebersprungen - sie zu ignorieren hiesse, gebundenes Geld als frei zu fuehren.

Gemessen am Paper-Gateway: "Konto: Umrechnungskurse EUR 1, USD 0.8611
(Basis EUR)". 388 Tests gruen.

Behebt #480.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-09-05 12:17:19 +02:00
co-authored by Claude Opus 5
parent b221e0447b
commit b042396f2d
8 changed files with 305 additions and 19 deletions
@@ -156,11 +156,14 @@ public class CapitalModelTests
new Position("CT", InstrumentRef.ForStock("MSFT"), 10, 200m)
};
CapitalPool.SymbolExposure(positions, "AAPL").Should().Be(5_000m);
CapitalPool.SymbolExposure(positions, "aapl").Should().Be(5_000m);
CapitalPool.SymbolExposure(positions, "MSFT").Should().Be(2_000m);
CapitalPool.SymbolExposure(positions, "AAPL", AsIs).Value.Should().Be(5_000m);
CapitalPool.SymbolExposure(positions, "aapl", AsIs).Value.Should().Be(5_000m);
CapitalPool.SymbolExposure(positions, "MSFT", AsIs).Value.Should().Be(2_000m);
}
/// <summary>Umrechnung als Identität – für Fälle, in denen alles in einer Währung notiert.</summary>
private static decimal? AsIs(Position p) => p.BoundCapital;
[Fact]
public void SymbolExposure_OfAShortPut_CountsTheObligation()
{
@@ -168,6 +171,84 @@ public class CapitalModelTests
var positions = new[] { new Position("OW", InstrumentRef.ForOption(spec), -1, 2.50m) };
// Nicht 250 (Praemie), sondern 15.000 (Verpflichtung).
CapitalPool.SymbolExposure(positions, "AAPL").Should().Be(15_000m);
CapitalPool.SymbolExposure(positions, "AAPL", AsIs).Value.Should().Be(15_000m);
}
// ─── Konzentration über Währungen hinweg (#480) ──────────────────────────────
[Fact]
public void SymbolExposure_ConvertsForeignCurrency_BeforeAdding()
{
// Derselbe Basiswert in zwei Währungen: die EUR-Notierung und die USD-Notierung. Ohne
// Umrechnung stünden hier 2.000 "Einheiten", die es so nicht gibt.
var positions = new[]
{
new Position("OW", InstrumentRef.ForStock("SAP", currency: "EUR"), 10, 100m),
new Position("CT", InstrumentRef.ForStock("SAP", currency: "USD"), 10, 100m)
};
// EUR steht bei 1,10 zur Basiswährung USD.
var account = new AccountState(
NetLiquidation: 100_000m, AvailableFunds: 50_000m, TotalCashValue: 50_000m,
CashByCurrency: null,
ExchangeRates: new Dictionary<string, decimal> { ["EUR"] = 1.10m, ["USD"] = 1m },
BaseCurrency: "USD");
var (value, complete) = CapitalPool.SymbolExposure(
positions, "SAP", p => account.ToBase(p.BoundCapital, p.Instrument.Currency));
value.Should().Be(2_100m, "1.000 EUR sind 1.100 USD, dazu 1.000 USD");
complete.Should().BeTrue();
}
[Fact]
public void SymbolExposure_WithoutRate_ReportsIncomplete()
{
var positions = new[]
{
new Position("OW", InstrumentRef.ForStock("SAP", currency: "EUR"), 10, 100m),
new Position("CT", InstrumentRef.ForStock("SAP", currency: "USD"), 10, 100m)
};
// Der Broker hat für EUR keinen Kurs geliefert.
var account = new AccountState(
NetLiquidation: 100_000m, AvailableFunds: 50_000m, TotalCashValue: 50_000m,
CashByCurrency: null,
ExchangeRates: new Dictionary<string, decimal> { ["USD"] = 1m },
BaseCurrency: "USD");
var (value, complete) = CapitalPool.SymbolExposure(
positions, "SAP", p => account.ToBase(p.BoundCapital, p.Instrument.Currency));
value.Should().Be(1_000m, "der EUR-Teil fehlt – das Ergebnis ist eine Untergrenze");
complete.Should().BeFalse("und genau das muss der Aufrufer erfahren");
}
// ─── Umrechnung selbst ──────────────────────────────────────────────────────
[Fact]
public void ToBase_UsesTheBrokersRate_AndAnswersNullWhenUnknown()
{
var account = new AccountState(
NetLiquidation: 0m, AvailableFunds: 0m, TotalCashValue: 0m,
CashByCurrency: null,
ExchangeRates: new Dictionary<string, decimal> { ["EUR"] = 1.10m, ["USD"] = 1m },
BaseCurrency: "USD");
account.ToBase(100m, "EUR").Should().Be(110m);
account.ToBase(100m, "eur").Should().Be(110m, "Währungskürzel sind nicht schreibungsabhängig");
account.ToBase(100m, "USD").Should().Be(100m);
account.ToBase(100m, "CHF").Should().BeNull("ohne Kurs gibt es kein Ergebnis, nur eine Lücke");
account.ToBase(100m, null).Should().BeNull();
}
[Fact]
public void ToBase_WithoutAnyRates_KnowsOnlyTheBaseCurrency()
{
// Ein Konto, das nur in einer Währung geführt wird: der Broker liefert dann keine Kurse.
var account = new AccountState(NetLiquidation: 1_000m, AvailableFunds: 1_000m);
account.ToBase(100m, "USD").Should().BeNull(
"ohne Basiswährung und ohne Kurse ist keine Umrechnung belegbar");
}
}
@@ -269,4 +269,37 @@ public class ReservationServiceTests
(await sut.RecoverAsync([])).Should().BeEmpty();
}
// ─── Offene Betraege je Waehrung (#480) ──────────────────────────────────────
[Fact]
public async Task OpenAmounts_AreGroupedByCurrency_NotSummedAcrossThem()
{
var sut = CreateSut(out _);
var sap = InstrumentRef.ForStock("SAP", "EUR");
await sut.ReserveAsync(Ow, Aapl, TradeSide.Buy, 10, "USD", "sig-1", Bind(1_000m));
await sut.ReserveAsync(Ow, sap, TradeSide.Buy, 5, "EUR", "sig-2", Bind( 500m));
await sut.ReserveAsync(Ow, Aapl, TradeSide.Buy, 2, "USD", "sig-3", Bind( 200m));
var byCurrency = await sut.GetOpenAmountByCurrencyAsync();
byCurrency.Should().HaveCount(2);
byCurrency["USD"].Should().Be(1_200m);
byCurrency["EUR"].Should().Be(500m);
// Die alte Gesamtsumme addiert weiterhin ueber Waehrungen hinweg - genau deshalb darf
// sie nicht mehr als Geldbetrag verwendet werden.
(await sut.GetOpenAmountAsync()).Should().Be(1_700m);
}
[Fact]
public async Task ClosedReservations_DoNotShowUpPerCurrency()
{
var sut = CreateSut(out _);
var result = await sut.ReserveAsync(Ow, Aapl, TradeSide.Buy, 10, "USD", "sig-1", Bind(1_000m));
await sut.CancelAsync(result.Reservation!.Id, "Test");
(await sut.GetOpenAmountByCurrencyAsync()).Should().BeEmpty();
}
}