ANTOOZA-BACKEND/Application/Features/Api/Stocks/GetBondDetail/Response.cs

namespace Application.Features.Api.Stocks.GetBondDetail;

public sealed class Response
{
    /// <summary>종목코드 (ISIN)</summary>
    public required string Isin { get; init; }

    /// <summary>채권 마스터 (getBondStatInfo) — 없으면 null (KRX 일별시세만 있는 경우)</summary>
    public MasterInfo? Master { get; init; }

    /// <summary>이자지급 정보 (getIntPayInfo) — 없으면 null</summary>
    public InterestInfo? Interest { get; init; }

    /// <summary>KRX 일별매매 최신 시세 (BondDailyTrade) — 없으면 null</summary>
    public MarketInfo? Market { get; init; }

    public sealed class MasterInfo
    {
        public string? Name { get; init; }
        public int? IssucoCustno { get; init; }

        /// <summary>종목종류코드 (SECN_KACD)</summary>
        public string? SecnKacd { get; init; }

        public DateOnly? IssueDate { get; init; }

        /// <summary>만기일자 (XPIR_DT)</summary>
        public DateOnly? MaturityDate { get; init; }

        public string? Currency { get; init; }

        /// <summary>최초발행금액 (FIRST_ISSU_AMT)</summary>
        public decimal? FirstIssueAmount { get; init; }

        /// <summary>발행잔액 (ISSU_REMA)</summary>
        public decimal? IssueRemaining { get; init; }

        /// <summary>표면이자율 (COUPON_RATE)</summary>
        public decimal? CouponRate { get; init; }

        /// <summary>옵션구분코드 (OPTION_TPCD) — 9401CALL 9402PUT …</summary>
        public string? OptionTpcd { get; init; }

        /// <summary>강제조기상환여부 (FORC_ERLY_RED_YN)</summary>
        public bool? ForcedEarlyRedemption { get; init; }

        /// <summary>금리변동구분코드 (MR_CHG_TPCD) — 1고정 2변동 …</summary>
        public string? RateChangeTpcd { get; init; }

        /// <summary>보증구분코드 (GRTY_TPCD) — 1보증 2무보증 …</summary>
        public string? GuaranteeTpcd { get; init; }

        /// <summary>순위구분코드 (RANK_TPCD) — 1선순위 2후순위 …</summary>
        public string? RankTpcd { get; init; }

        /// <summary>이자지급방법구분코드 (INT_PAY_WAY_TPCD)</summary>
        public string? IntPayWayTpcd { get; init; }

        /// <summary>특이채권종류구분코드 (PARTICUL_BOND_KIND_TPCD) — 전환/교환/신주인수권 …</summary>
        public string? ParticularBondKindTpcd { get; init; }

        /// <summary>KIS 신용등급 코드 (발행당시)</summary>
        public string? KisGrade { get; init; }

        /// <summary>NICE 신용등급 코드</summary>
        public string? NiceGrade { get; init; }

        /// <summary>SCI(서울신용평가) 신용등급 코드</summary>
        public string? SciGrade { get; init; }

        /// <summary>KR(한국기업평가) 신용등급 코드</summary>
        public string? KrGrade { get; init; }

        /// <summary>전자증권여부 (ELTSC_YN)</summary>
        public bool? IsElectronicSecurity { get; init; }
    }

    public sealed class InterestInfo
    {
        /// <summary>표면이자율 (COUPON_RATE)</summary>
        public decimal? CouponRate { get; init; }

        /// <summary>이자지급방법구분코드 (INT_PAY_WAY_TPCD)</summary>
        public string? IntPayWayTpcd { get; init; }

        /// <summary>이자지급주기기간수 (INT_PAY_CYCLE_TERMS)</summary>
        public int? CycleTerms { get; init; }

        /// <summary>이자지급주기구분코드 (INT_PAY_CYCLE_TPCD) — 23개월 24분기 25반기 26년</summary>
        public string? CycleTpcd { get; init; }

        /// <summary>이자지급시기구분코드 (INT_PAY_TIMS_TPCD) — 01후급 02선급 …</summary>
        public string? PayTimingTpcd { get; init; }

        /// <summary>직전이표일 (BEFORE_DATE)</summary>
        public DateOnly? BeforeCouponDate { get; init; }

        /// <summary>차기이표일 (AFTER_DATE)</summary>
        public DateOnly? AfterCouponDate { get; init; }
    }

    public sealed class MarketInfo
    {
        /// <summary>거래일 (BAS_DD)</summary>
        public DateOnly TradeDate { get; init; }

        /// <summary>종가 (CLSPRC)</summary>
        public decimal Close { get; init; }

        /// <summary>만기수익률 % (CLSPRC_YD 종가수익률 = YTM) — 미체결 시 null</summary>
        public decimal? YieldToMaturity { get; init; }

        /// <summary>거래량 (ACC_TRDVOL)</summary>
        public long Volume { get; init; }
    }
}