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