using System.ComponentModel.DataAnnotations;
namespace Domain.Entities.Stocks;
///
/// 일별 환율 (한국수출입은행 OpenAPI AP01 현재환율) — (CurrencyUnit, TradeDate) UNIQUE.
/// koreaexim AP01 응답 필드 매핑:
/// - cur_unit(통화코드, 예: USD / JPY(100) / EUR) → CurrencyUnit, cur_nm(통화명) → CurrencyName.
/// - deal_bas_r(매매기준율) → DealBasRate, ttb(전신환 받으실때) → Ttb, tts(전신환 보내실때) → Tts.
/// 값은 천단위 콤마 문자열로 오므로 파서에서 콤마 제거. JPY(100)/IDR(100) 등 "(100)" 단위 통화는 cur_unit 원문 그대로 보존한다.
///
public class ExchangeRate
{
[Key]
public long ID { get; private set; }
/// 통화 코드 (cur_unit) — 예: USD, JPY(100), EUR. "(100)" 단위 표기 포함 원문 보존
public string CurrencyUnit { get; private set; } = default!;
/// 통화명 (cur_nm) — 예: 미국 달러, 일본 옌
public string CurrencyName { get; private set; } = default!;
/// 거래일 (searchdate)
public DateOnly TradeDate { get; private set; }
/// 매매기준율 (deal_bas_r)
public decimal DealBasRate { get; private set; }
/// 전신환(송금) 받으실 때 (ttb) — 미제공 시 null
public decimal? Ttb { get; private set; }
/// 전신환(송금) 보내실 때 (tts) — 미제공 시 null
public decimal? Tts { get; private set; }
public DateTime CreatedAt { get; private set; } = DateTime.UtcNow;
private ExchangeRate() { }
public static ExchangeRate Create(
string currencyUnit,
string currencyName,
DateOnly tradeDate,
decimal dealBasRate,
decimal? ttb,
decimal? tts
) {
if (string.IsNullOrWhiteSpace(currencyUnit))
{
throw new ArgumentException("currencyUnit required", nameof(currencyUnit));
}
return new ExchangeRate
{
CurrencyUnit = currencyUnit.Trim(),
CurrencyName = currencyName.Trim(),
TradeDate = tradeDate,
DealBasRate = dealBasRate,
Ttb = ttb,
Tts = tts
};
}
/// 동일 (CurrencyUnit, TradeDate) 재수집 시 값 갱신 (upsert)
public void Update(string currencyName, decimal dealBasRate, decimal? ttb, decimal? tts)
{
CurrencyName = currencyName.Trim();
DealBasRate = dealBasRate;
Ttb = ttb;
Tts = tts;
}
}