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 SeibroSection Seibro { 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>장전 브리핑 자동 발행 배치 (DailyBriefingPublisher — d2 M3, 07:30 KST). Web.Api 전용, 기본 false (StockData 지수·공시 적재 가동 후 활성화).</summary>
        public bool DailyBriefing { 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, 3ep×백필)이 5분 슬롯을 넘을 수 있어 여유 두고 19:00</summary>
        public string DerivativeSyncTime { get; init; } = "19:00";

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

        /// <summary>일반상품 일별매매 수집 실행 시각 (KST, "HH:mm") — 파생상품 수집(19:00, 6ep×백필)이 무거워 여유 두고 19:15</summary>
        public string CommoditySyncTime { get; init; } = "19:15";

        /// <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") — 일반상품 수집(19:15) 뒤 여유 두고 19:30</summary>
        public string EsgSyncTime { get; init; } = "19:30";

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

    /// <summary>
    /// SEIBro OpenAPI(한국예탁결제원 seibro.or.kr) 수집 설정 (개미투자 D1). KRX/data.go.kr/OpenDART 와 별개 시스템 —
    /// 인증은 query param key, 응답은 XML(value 속성). 일일 호출 한도는 카테고리 단위(기업/주식/채권/파생/외화)로 관리되며
    /// 배치 예산(*Budget)은 실한도의 80% 헤드룸 (docs/SEIBro/readme.md §1). 모든 *Sync 플래그 기본 false —
    /// API 키 발급/운영 결정 후 활성화. tracked 파일엔 ApiKey 빈 값만 (실키는 gitignore 된 appsettings.Development.json / Jenkins Secret File).
    /// </summary>
    public class SeibroSection
    {
        /// <summary>SEIBro OpenAPI 인증 키 (key query param). 비어 있으면 배치는 로그만 남기고 skip.</summary>
        public string ApiKey { get; init; } = string.Empty;

        /// <summary>SEIBro OpenPlatform 엔드포인트 — https 연결 불가 시 SeibroHttp 가 http 로 1회 fallback</summary>
        public string BaseUrl { get; init; } = "https://seibro.or.kr/OpenPlatform/callOpenAPI.jsp";

        /// <summary>Wave 0 — 발행회사번호(ISSUCO_CUSTNO) 조인키 부트스트랩 + 종목 보강 배치 (SeibroIssuerSyncService)</summary>
        public bool IssuerSync { get; init; } = false;

        /// <summary>Wave 1 — 배당·권리 수집 배치</summary>
        public bool DividendSync { get; init; } = false;

        /// <summary>Wave 2 — 수급 이벤트(대차·보호예수·증감·유통변경·비상장) 수집 배치</summary>
        public bool SupplySync { get; init; } = false;

        /// <summary>Wave 3 — 기업행위(총회·상호변경·대금·단주·CB/BW 행사) 수집 배치</summary>
        public bool CorpActionSync { get; init; } = false;

        /// <summary>Wave 4 — 채권·단기금융 수집 배치</summary>
        public bool BondSync { get; init; } = false;

        /// <summary>Wave 5 — 파생결합증권(ELS/DLS) 수집 배치</summary>
        public bool DerivSync { get; init; } = false;

        /// <summary>Wave 6 — 외화증권 수집 배치</summary>
        public bool ForeignSync { get; init; } = false;

        /// <summary>호출 사이 지연(ms) — quota·서버 보호</summary>
        public int DelayMs { get; init; } = 200;

        /// <summary>백필 대상 기간(연) — 날짜 스윕 배치가 과거로 이만큼 채운다</summary>
        public int BackfillYears { get; init; } = 3;

        /// <summary>기업 정보 카테고리 일일 예산 (실한도 50,000 의 80%)</summary>
        public int CorpBudget { get; init; } = 40000;

        /// <summary>주식 카테고리 일일 예산 (실한도 10,000 의 80%) — getXrcStk*(CB/BW 행사)도 주식 소속</summary>
        public int StockBudget { get; init; } = 8000;

        /// <summary>채권 카테고리 일일 예산 (실한도 10,000 의 80%)</summary>
        public int BondBudget { get; init; } = 8000;

        /// <summary>파생결합증권 카테고리 일일 예산 (실한도 10,000 의 80%)</summary>
        public int DerivBudget { get; init; } = 8000;

        /// <summary>외화증권 카테고리 일일 예산 (실한도 20,000 의 80%)</summary>
        public int ForeignBudget { get; init; } = 15000;

        /// <summary>대차거래 3년 백필 대상 종목 수 (시가총액 상위 N) — 당일 수집은 전 상장종목</summary>
        public int LendingBackfillTopN { get; init; } = 300;

        /// <summary>외화증권 국가별 수집 대상 국가코드 (Wave 6)</summary>
        public string[] ForeignNations { get; init; } = ["US", "JP", "HK", "CN", "E1"];

        /// <summary>외화증권 종목별 수집 seed ISIN (기본 빈 = 국가별만 수집)</summary>
        public string[] ForeignIsins { get; init; } = [];

        /// <summary>발행회사번호 부트스트랩 실행 시각 (KST, "HH:mm") — SEIBro 는 T+1 새벽 갱신 추정, KRX(18시대)와 분리해 06:30</summary>
        public string IssuerSyncTime { get; init; } = "06:30";

        /// <summary>배당·권리 수집 실행 시각 (KST, "HH:mm") — IssuerSync(06:30) 다음 슬롯 06:40 (wave 당 10분 간격 스태거)</summary>
        public string DividendSyncTime { get; init; } = "06:40";
    }
}