ANTOOZA-BACKEND/SharedKernel/AppSetting.cs

namespace SharedKernel;

public sealed class AppSettings
{
    public AppSection App { get; init; } = new();
    public ConnectionStringsSection ConnectionStrings { get; init; } = new();
    public RedisSection Redis { get; init; } = new();
    public SmtpSection SMTP { get; init; } = new();
    public JwtSection JWT { get; init; } = new();
    public ForwardedHeadersSection ForwardedHeaders { get; init; } = new();
    public CorsPolicySection CorsPolicy { get; init; } = new();
    public YouTubeSection YouTube { get; init; } = new();
    public BackgroundJobsSection BackgroundJobs { get; init; } = new();
    public EncryptionSection Encryption { get; init; } = new();
    public FeaturesSection Features { get; init; } = new();
    public StockDataSection StockData { get; init; } = new();
    public KRXCoKrSection KRXCoKr { get; init; } = new();
    public OpenDartSection OpenDart { get; init; } = new();
    public KoreaEximSection KoreaExim { get; init; } = new();
    public OAuthSection OAuth { get; init; } = new();

    public sealed class AppSection
    {
        public string Name { get; init; } = string.Empty;
        public string Company { get; init; } = string.Empty;
        public string BaseURL { get; init; } = string.Empty;
        public string ApiURL { get; init; } = string.Empty;
        public string FrontURL { get; init; } = string.Empty;
    }

    public sealed class ConnectionStringsSection
    {
        public string DefaultConnection { get; init; } = string.Empty;
        public int Timeout { get; init; }
    }

    public class RedisSection
    {
        public string DefaultConnection { get; init; } = string.Empty;
        public string CachePrefix { get; init; } = string.Empty;
        public string AuthTicketPrefix { get; init; } = string.Empty;
        public string DataProtectionKey { get; init; } = string.Empty;
        public TimeSpan DefaultKeyLifetime { get; init; }
    }

    public class SmtpSection
    {
        public string Host { get; init; } = default!;
        public int Port { get; init; } = 587;
        public string? User { get; init; }
        public string? Password { get; init; }
        public bool UseStartTls { get; init; } = true;
        public string FromEmail { get; init; } = default!;
        public string FromName { get; init; } = "no-reply";
    }

    public class JwtSection
    {
        public string SecretKey { get; init; } = string.Empty;
        public string Issuer { get; init; } = string.Empty;
        public string Audience { get; init; } = string.Empty;
        public int AccessTokenExpiration { get; init; }
        public int RefreshTokenExpiration { get; init; }
    }

    public class ForwardedHeadersSection
    {
        public int? ForwardLimit { get; init; } = default;
        public List<string> KnownProxies { get; init; } = [];
        public List<string> KnownNetworks { get; init; } = [];
    }

    public class CorsPolicySection
    {
        public string Name { get; init; } = string.Empty;
        public long PreflightMaxAgeSeconds { get; init; } = 0;
        public List<string> AllowedOrigins { get; init; } = [];
    }

    public class YouTubeSection
    {
        public string HubUrl { get; init; } = "https://pubsubhubbub.appspot.com/subscribe";
        public string CallbackUrl { get; init; } = string.Empty;
        public string HmacSecret { get; init; } = string.Empty;
        public int FeedPollingIntervalMinutes { get; init; } = 3;
    }

    public class BackgroundJobsSection
    {
        public bool LiveChat { get; init; } = true;
        public bool PubSubRenewal { get; init; } = true;
        public bool FeedPolling { get; init; } = true;
        public bool LiveViewerPoller { get; init; } = true;
        public bool ChannelCacheRefresh { get; init; } = true;
        public bool YouTubeDailyAggregator { get; init; } = true;
        public bool YouTubeStaleDataPurge { get; init; } = true;

        /// <summary>결제 자동 대사 배치 (Toss NeedsReconciliation 재확인 — PaymentReconcileService). Features:Channel 게이트와 무관.</summary>
        public bool PaymentReconcile { get; init; } = true;

        /// <summary>모의투자 체결·스냅샷 배치 (PaperFillService — d4 M2). Features:Channel 게이트와 무관, 기본 false (StockData 적재 가동 후 활성화).</summary>
        public bool PaperFill { get; init; } = false;

        /// <summary>예측 채점 배치 (PredictionSettlementService — d2 M4). Web.Api 전용, 기본 false (StockData T+1 종가 적재 가동 후 활성화).</summary>
        public bool PredictionSettlement { get; init; } = false;
    }

    /// <summary>
    /// 기능 단위 활성화 플래그. 코드/스키마는 보존하고 노출만 차단하는 soft-off 스위치.
    /// Channel=false 시 채널/스튜디오/YouTube 관련 API 와 백그라운드 서비스 전체 비활성 (기본 false).
    /// </summary>
    public class FeaturesSection
    {
        public bool Channel { get; init; } = false;
    }

    /// <summary>
    /// 회원 PII(주소/연락처 등) 필드 암호화에 사용하는 AES-GCM 키 묶음.
    /// Keys 딕셔너리는 KeyVersion -> Base64(32바이트) 매핑. CurrentKeyVersion 은 신규 암호화에 사용할 버전.
    /// 키 회전 시 Keys 에 새 버전 추가 + CurrentKeyVersion 갱신. 복호화는 row 의 KeyVersion 컬럼으로 매핑하여 과거 키 사용.
    /// </summary>
    public class EncryptionSection
    {
        public int CurrentKeyVersion { get; init; } = 1;
        public Dictionary<string, string> Keys { get; init; } = new();
    }

    /// <summary>
    /// 소셜 로그인 OAuth 설정 (개미투자 D5 — Naver/Kakao). 키는 각 개발자센터 발급 후 채움 (빈 값이면 해당 provider 로그인 비활성).
    /// Google 은 DB Config(External.GoogleClientId) 현행 유지 — 여기 포함하지 않는다.
    /// </summary>
    public class OAuthSection
    {
        public OAuthProviderSection Naver { get; init; } = new();
        public OAuthProviderSection Kakao { get; init; } = new();

        public class OAuthProviderSection
        {
            /// <summary>네이버: Client ID / 카카오: REST API 키</summary>
            public string ClientId { get; init; } = string.Empty;

            /// <summary>네이버: Client Secret(필수) / 카카오: 콘솔에서 활성화한 경우만 (빈 값이면 미전송)</summary>
            public string ClientSecret { get; init; } = string.Empty;

            /// <summary>기본 redirect URI — 요청에서 미전달 시 사용. 개발자센터에 등록한 값과 일치해야 함</summary>
            public string RedirectUri { get; init; } = string.Empty;

            /// <summary>
            /// 카카오 Admin 키 — "연결 끊기(unlink)" webhook 요청의 Authorization 헤더 대조에 사용.
            /// 카카오 개발자콘솔의 앱 Admin 키를 그대로 넣는다 (빈 값이면 disconnect 검증 비활성 → 항상 거부).
            /// 네이버는 사용하지 않음.
            /// </summary>
            public string AdminKey { get; init; } = string.Empty;
        }
    }

    /// <summary>
    /// 주식 데이터 수집 배치 설정 (개미투자 D1). 플래그 기본 false — API 키 발급/운영 결정 후 활성화.
    /// Features:Channel 게이트와 무관하게 별도 등록 (AddStockDataServices).
    /// </summary>
    public class StockDataSection
    {
        /// <summary>종목 마스터 동기화 배치 (StockMasterSyncService) 활성화</summary>
        public bool MasterSync { get; init; } = false;

        /// <summary>T+1 일별 시세 수집 배치 (DailyPriceSyncService) 활성화</summary>
        public bool DailyPriceSync { get; init; } = false;

        /// <summary>마스터 동기화 실행 시각 (KST, "HH:mm")</summary>
        public string MasterSyncTime { get; init; } = "07:30";

        /// <summary>일별 시세 수집 실행 시각 (KST, "HH:mm") — 금융위 API 는 영업일+1 13시 이후 반영</summary>
        public string DailyPriceSyncTime { get; init; } = "13:10";

        public DataGoKrSection DataGoKr { get; init; } = new();

        /// <summary>공공데이터포털 (data.go.kr) 금융위 API</summary>
        public class DataGoKrSection
        {
            /// <summary>서비스 키 (Decoding 원본 키 — 요청 시 URL 인코딩). 비어 있으면 배치는 로그만 남기고 skip.</summary>
            public string ServiceKey { get; init; } = string.Empty;

            public string BaseUrl { get; init; } = "https://apis.data.go.kr";

            /// <summary>페이지당 행 수 (numOfRows)</summary>
            public int PageSize { get; init; } = 1000;
        }
    }

    /// <summary>
    /// KRX 한국거래소 OpenAPI (data-dbg.krx.co.kr) 지수 데이터 수집 설정 (개미투자 D1).
    /// data.go.kr(StockDataSection)과는 별개 시스템 — 별도 API 키 + AUTH_KEY 헤더 인증.
    /// IndexSync 기본 false — API 키 발급/운영 결정 후 활성화. Features:Channel 게이트와 무관하게 AddStockDataServices 에서 등록.
    /// </summary>
    public class KRXCoKrSection
    {
        /// <summary>KRX OpenAPI 인증 키 (AUTH_KEY 헤더). 비어 있으면 배치는 로그만 남기고 skip. tracked 파일엔 빈 값만.</summary>
        public string ApiKey { get; init; } = string.Empty;

        public string BaseUrl { get; init; } = "https://data-dbg.krx.co.kr";

        /// <summary>지수 일별시세 수집 배치 (IndexPriceSyncService) 활성화 — KOSPI/KOSDAQ/KRX + 파생상품지수(idx/drvprod_dd_trd) 4개 엔드포인트 한 배치</summary>
        public bool IndexSync { get; init; } = false;

        /// <summary>지수 수집 실행 시각 (KST, "HH:mm") — KRX 지수는 장 마감(15:30) 이후 확정, 여유 두고 18:30</summary>
        public string IndexSyncTime { get; init; } = "18:30";

        /// <summary>채권지수 일별시세 수집 배치 (BondIndexPriceSyncService, idx/bon_dd_trd) 활성화 — 응답 shape 이 지수와 달라 별도 배치</summary>
        public bool BondIndexSync { get; init; } = false;

        /// <summary>채권지수 수집 실행 시각 (KST, "HH:mm") — 지수 수집(18:30) 뒤 여유 두고 18:35</summary>
        public string BondIndexSyncTime { get; init; } = "18:35";

        /// <summary>주식(종목) 마스터 + 일별매매 수집 배치 (KrxStockMasterSyncService/KrxDailyPriceSyncService) 활성화 — D1 KRX 주식 데이터 수집</summary>
        public bool StockSync { get; init; } = false;

        /// <summary>종목 마스터 동기화 실행 시각 (KST, "HH:mm") — 장 시작 전 07:40</summary>
        public string MasterSyncTime { get; init; } = "07:40";

        /// <summary>주식 일별매매 수집 실행 시각 (KST, "HH:mm") — KRX 일별매매는 장 마감(15:30) 이후 확정, 여유 두고 18:10</summary>
        public string StockSyncTime { get; init; } = "18:10";

        /// <summary>증권상품(ETF/ETN/ELW) 일별매매 수집 배치 (KrxEtpSyncService) 활성화 — KRX 증권상품(ETF/ETN/ELW) 수집</summary>
        public bool EtpSync { get; init; } = false;

        /// <summary>증권상품(ETF/ETN/ELW) 일별매매 수집 실행 시각 (KST, "HH:mm") — 장 마감(15:30) 이후 확정, 주식 수집(18:10) 뒤 여유 두고 18:20</summary>
        public string EtpSyncTime { get; init; } = "18:20";

        /// <summary>신주인수권증권/증서 일별매매 수집 배치 (KrxWarrantSyncService) 활성화 — sw_bydd_trd(증권)+sr_bydd_trd(증서)</summary>
        public bool WarrantSync { get; init; } = false;

        /// <summary>신주인수권증권/증서 일별매매 수집 실행 시각 (KST, "HH:mm") — 증권상품 수집(18:20) 뒤 여유 두고 18:25</summary>
        public string WarrantSyncTime { get; init; } = "18:25";

        /// <summary>채권(국채전문유통/일반채권/소액채권) 일별매매 수집 배치 (KrxBondSyncService) 활성화 — kts/bnd/smb_bydd_trd 3개 엔드포인트</summary>
        public bool BondSync { get; init; } = false;

        /// <summary>채권 일별매매 수집 실행 시각 (KST, "HH:mm") — 신주인수권 수집(18:25) 뒤 여유 두고 18:40</summary>
        public string BondSyncTime { get; init; } = "18:40";

        /// <summary>파생상품(선물 3 + 옵션 3) 일별매매 수집 배치 (KrxDerivativeSyncService) 활성화 — fut/eqsfu/eqkfu + opt/eqsop/eqkop 6개 엔드포인트</summary>
        public bool DerivativeSync { get; init; } = false;

        /// <summary>파생상품 일별매매 수집 실행 시각 (KST, "HH:mm") — 채권 수집(18:40) 뒤 여유 두고 18:45</summary>
        public string DerivativeSyncTime { get; init; } = "18:45";

        /// <summary>일반상품(석유/금/배출권) 일별매매 수집 배치 (KrxCommoditySyncService) 활성화 — gen/oil+gold+ets_bydd_trd 3개 엔드포인트</summary>
        public bool CommoditySync { get; init; } = false;

        /// <summary>일반상품 일별매매 수집 실행 시각 (KST, "HH:mm") — 파생상품 수집(18:45) 뒤 여유 두고 18:50</summary>
        public string CommoditySyncTime { get; init; } = "18:50";

        /// <summary>ESG 데이터(ESG 증권상품 + ESG 지수 + 사회책임투자채권) 수집 배치 (KrxEsgSyncService) 활성화 — esg/esg_etp_info+esg_index_info+sri_bond_info 3개 엔드포인트</summary>
        public bool EsgSync { get; init; } = false;

        /// <summary>ESG 데이터 수집 실행 시각 (KST, "HH:mm") — 일반상품 수집(18:50) 뒤 여유 두고 18:55</summary>
        public string EsgSyncTime { get; init; } = "18:55";

        /// <summary>백필 대상 기간(연) — endDate 로부터 과거로 이만큼 채운다 (기본 3년). KrxBackfill 공용 헬퍼가 사용</summary>
        public int BackfillYears { get; init; } = 3;

        /// <summary>1회 실행당 최대 백필 fetch 수 — quota 보호용 상한 (기본 60). 여러 날에 걸쳐 나눠 채운다</summary>
        public int BackfillMaxPerRun { get; init; } = 60;
    }

    /// <summary>
    /// OpenDART(전자공시, opendart.fss.or.kr) 공시 수집 설정 (개미투자 D1). KRX/data.go.kr 과는 별개 시스템 —
    /// 인증은 query param crtfc_key (헤더 아님). DisclosureSync 기본 false — API 키 발급/운영 결정 후 활성화.
    /// Features:Channel 게이트와 무관하게 AddStockDataServices 에서 등록. tracked 파일엔 ApiKey 빈 값만.
    /// </summary>
    public class OpenDartSection
    {
        /// <summary>OpenDART 인증 키 (crtfc_key query param). 비어 있으면 배치는 로그만 남기고 skip.</summary>
        public string ApiKey { get; init; } = string.Empty;

        public string BaseUrl { get; init; } = "https://opendart.fss.or.kr";

        /// <summary>공시 목록 수집 배치 (DisclosureSyncService) 활성화</summary>
        public bool DisclosureSync { get; init; } = false;

        /// <summary>공시 수집 실행 시각 (KST, "HH:mm") — 전영업일 공시 반영 여유 두고 08:30</summary>
        public string DisclosureSyncTime { get; init; } = "08:30";

        /// <summary>백필 대상 기간(일) — today 로부터 과거로 이만큼 접수일 범위를 훑는다 (기본 30일 — 공시는 건수가 많아 최근 30일 권장)</summary>
        public int BackfillDays { get; init; } = 30;
    }

    /// <summary>
    /// 한국수출입은행(koreaexim.go.kr) OpenAPI 거시·환율 수집 설정 (개미투자 D1). KRX/data.go.kr/OpenDART 와 별개 시스템 —
    /// 인증은 query param authkey, 데이터 종류별(AP01 환율/AP02 대출금리/AP03 국제금리)로 별도 키가 발급된다.
    /// MacroSync 기본 false — API 키 발급/운영 결정 후 활성화. Features:Channel 게이트와 무관하게 AddStockDataServices 에서 등록.
    /// tracked 파일엔 각 키 빈 값만 (실키는 gitignore 된 appsettings.Development.json / Jenkins Secret File).
    /// 주의(koreaexim quirk): 주말/공휴일과 영업일 오전 ~11시 이전엔 빈 배열([])을 반환하고, 키 오류·만료 시 result 코드 2~4 또는 빈 응답이 온다 → 파서가 안전하게 0건 처리.
    /// </summary>
    public class KoreaEximSection
    {
        /// <summary>현재환율(AP01) 인증 키 (authkey query param). 비어 있으면 환율 수집 skip.</summary>
        public string ExchangeKey { get; init; } = string.Empty;

        /// <summary>대출금리(AP02) 인증 키. 비어 있으면 대출금리 수집 skip.</summary>
        public string LoanRateKey { get; init; } = string.Empty;

        /// <summary>국제금리(AP03) 인증 키. 비어 있으면 국제금리 수집 skip.</summary>
        public string IntlRateKey { get; init; } = string.Empty;

        public string BaseUrl { get; init; } = "https://www.koreaexim.go.kr/site/program/financial/exchangeJSON";

        /// <summary>거시·환율 수집 배치 (MacroDataSyncService) 활성화</summary>
        public bool MacroSync { get; init; } = false;

        /// <summary>수집 실행 시각 (KST, "HH:mm") — koreaexim 은 영업일 ~11시 이후 반영되므로 여유 두고 11:30</summary>
        public string MacroSyncTime { get; init; } = "11:30";

        /// <summary>백필 대상 기간(일) — today 로부터 과거로 이만큼 훑으며 미적재 영업일을 채운다 (기본 30일)</summary>
        public int MacroBackfillDays { get; init; } = 30;

        /// <summary>1회 실행당 최대 백필 fetch 수 — quota 보호용 상한 (기본 60). 여러 날에 걸쳐 나눠 채운다</summary>
        public int BackfillMaxPerRun { get; init; } = 60;
    }
}