ANTOOZA-BACKEND/Domain/Entities/Stocks/ExchangeRate.cs

using System.ComponentModel.DataAnnotations;

namespace Domain.Entities.Stocks;

/// <summary>
/// 일별 환율 (한국수출입은행 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 원문 그대로 보존한다.
/// </summary>
public class ExchangeRate
{
    [Key]
    public long ID { get; private set; }

    /// <summary>통화 코드 (cur_unit) — 예: USD, JPY(100), EUR. "(100)" 단위 표기 포함 원문 보존</summary>
    public string CurrencyUnit { get; private set; } = default!;

    /// <summary>통화명 (cur_nm) — 예: 미국 달러, 일본 옌</summary>
    public string CurrencyName { get; private set; } = default!;

    /// <summary>거래일 (searchdate)</summary>
    public DateOnly TradeDate { get; private set; }

    /// <summary>매매기준율 (deal_bas_r)</summary>
    public decimal DealBasRate { get; private set; }

    /// <summary>전신환(송금) 받으실 때 (ttb) — 미제공 시 null</summary>
    public decimal? Ttb { get; private set; }

    /// <summary>전신환(송금) 보내실 때 (tts) — 미제공 시 null</summary>
    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
        };
    }

    /// <summary>동일 (CurrencyUnit, TradeDate) 재수집 시 값 갱신 (upsert)</summary>
    public void Update(string currencyName, decimal dealBasRate, decimal? ttb, decimal? tts)
    {
        CurrencyName = currencyName.Trim();
        DealBasRate = dealBasRate;
        Ttb = ttb;
        Tts = tts;
    }
}