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

using System.ComponentModel.DataAnnotations;

namespace Domain.Entities.Stocks;

/// <summary>
/// SEIBro 주식관련사채 행사내역 (getXrcStkOptionXrcInfo) — CB/BW/EB 권리행사 내역 (Wave 3).
/// 날짜 스윕(권리행사일 RGT_STD_DT) → 권리행사일 window delete+insert 로 반영.
/// 반환된 DISTINCT BondIsin 이 ConvertibleBondTarget(getXrcStkStatInfo)의 발견 소스가 된다.
/// ⚠️ getXrcStkOptionXrcInfo 실샘플이 result="0"(0행) 이라 필드 매핑은 주식.md 스펙 기준 — 운영 첫 수집 시 로그로 확인 필요.
/// </summary>
public class ConvertibleExercise
{
    [Key]
    public int ID { get; private set; }

    /// <summary>채권 종목코드 (BOND_ISIN)</summary>
    public string BondIsin { get; private set; } = default!;

    /// <summary>채권 한글종목명 (BOND_KOR_SECN_NM)</summary>
    public string? BondKorSecnNm { get; private set; }

    /// <summary>채권종류코드 (BOND_KIND_NM) — EB/CB/BW</summary>
    public string? BondKindNm { get; private set; }

    /// <summary>행사주식 종목코드 (XRC_STK_ISIN)</summary>
    public string? XrcStkIsin { get; private set; }

    /// <summary>행사주식명 (STK_KOR_SECN_NM)</summary>
    public string? StkKorSecnNm { get; private set; }

    /// <summary>권리행사일 (RGT_STD_DT)</summary>
    public DateOnly RgtStdDt { get; private set; }

    /// <summary>행사시작일 (XRC_POSS_BEGIN_DT)</summary>
    public DateOnly? XrcPossBeginDt { get; private set; }

    /// <summary>행사종료일 (XRC_POSS_EXPRY_DT)</summary>
    public DateOnly? XrcPossExpryDt { get; private set; }

    /// <summary>행사금액 (XRC_AMT)</summary>
    public decimal? XrcAmt { get; private set; }

    /// <summary>행사주수 (XRC_QTY)</summary>
    public decimal? XrcQty { get; private set; }

    /// <summary>행사가격 (XRC_PRICE)</summary>
    public decimal? XrcPrice { get; private set; }

    /// <summary>주식상장일 (LIST_DT)</summary>
    public DateOnly? ListDt { get; private set; }

    public DateTime UpdatedAt { get; private set; } = DateTime.UtcNow;

    private ConvertibleExercise() { }

    public static ConvertibleExercise Create(
        string bondIsin,
        string? bondKorSecnNm,
        string? bondKindNm,
        string? xrcStkIsin,
        string? stkKorSecnNm,
        DateOnly rgtStdDt,
        DateOnly? xrcPossBeginDt,
        DateOnly? xrcPossExpryDt,
        decimal? xrcAmt,
        decimal? xrcQty,
        decimal? xrcPrice,
        DateOnly? listDt)
    {
        if (string.IsNullOrWhiteSpace(bondIsin))
        {
            throw new ArgumentException("bondIsin required", nameof(bondIsin));
        }

        return new ConvertibleExercise
        {
            BondIsin = bondIsin.Trim(),
            BondKorSecnNm = Trimmed(bondKorSecnNm),
            BondKindNm = Trimmed(bondKindNm),
            XrcStkIsin = Trimmed(xrcStkIsin),
            StkKorSecnNm = Trimmed(stkKorSecnNm),
            RgtStdDt = rgtStdDt,
            XrcPossBeginDt = xrcPossBeginDt,
            XrcPossExpryDt = xrcPossExpryDt,
            XrcAmt = xrcAmt,
            XrcQty = xrcQty,
            XrcPrice = xrcPrice,
            ListDt = listDt
        };
    }

    private static string? Trimmed(string? value)
    {
        return string.IsNullOrWhiteSpace(value) ? null : value.Trim();
    }
}