KrxEsgSyncService.cs 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195
  1. using Application.Abstractions.Data;
  2. using Application.Helpers;
  3. using Domain.Entities.Stocks;
  4. using Microsoft.EntityFrameworkCore;
  5. using Microsoft.Extensions.DependencyInjection;
  6. using Microsoft.Extensions.Logging;
  7. using Microsoft.Extensions.Options;
  8. using SharedKernel;
  9. namespace Infrastructure.StockData;
  10. /// <summary>
  11. /// ESG 데이터(ESG 증권상품 + ESG 지수 + 사회책임투자채권) 수집 — KRX OpenAPI (esg/esg_etp_info + esg_index_info + sri_bond_info).
  12. /// 세 엔드포인트 모두 basDd 파라미터로 그날 전량(스냅샷)을 반환하므로 공용 KrxBackfill 로 최근 BackfillYears(기본 3)년치를 endDate(직전 영업일)부터
  13. /// 과거로 훑으며 미적재일만 채운다. quota 보호를 위해 1회 실행당 BackfillMaxPerRun(기본 60)일까지만 fetch → 여러 날에 걸쳐 3년치를 메우고 이후엔 최신만 유지.
  14. /// 각 날짜는 3개 엔드포인트를 모두 수집해 EsgSecurity(UQ Name+TradeDate) / EsgIndexDailyPrice(UQ IndexName+TradeDate) / SriBond(UQ Code+TradeDate) upsert.
  15. /// 세 테이블 모두 해당 날짜가 있어야 "적재됨"으로 간주(부분 적재 방어). 기본 18:55 KST 실행(일반상품 18:50 뒤). ApiKey 미설정 시 skip.
  16. /// </summary>
  17. internal sealed class KrxEsgSyncService(
  18. IServiceScopeFactory scopeFactory,
  19. IHttpClientFactory httpClientFactory,
  20. IOptions<AppSettings> settings,
  21. ILogger<KrxEsgSyncService> logger
  22. ) : DailyScheduledService(logger)
  23. {
  24. private const string EtpPath = "/svc/apis/esg/esg_etp_info";
  25. private const string IndexPath = "/svc/apis/esg/esg_index_info";
  26. private const string SriBondPath = "/svc/apis/esg/sri_bond_info";
  27. protected override string JobName => "KrxEsgSync";
  28. protected override TimeOnly TargetTime => ParseTime(settings.Value.KRXCoKr.EsgSyncTime, new TimeOnly(18, 55));
  29. protected override int MaxRetryCount => 2;
  30. protected override TimeSpan RetryDelay => TimeSpan.FromHours(2);
  31. protected override async Task<bool> RunOnceAsync(DateOnly todayKst, CancellationToken ct)
  32. {
  33. var cfg = settings.Value.KRXCoKr;
  34. if (string.IsNullOrWhiteSpace(cfg.ApiKey))
  35. {
  36. Logger.LogWarning("[{Job}] KRXCoKr:ApiKey 미설정 — 수집 skip", JobName);
  37. return true;
  38. }
  39. using var scope = scopeFactory.CreateScope();
  40. var db = scope.ServiceProvider.GetRequiredService<IAppDbContext>();
  41. var client = httpClientFactory.CreateClient(KrxCoKrHttp.ClientName);
  42. var endDate = await MarketCalendar.GetPreviousBusinessDayAsync(db, todayKst.AddDays(1), ct);
  43. var years = cfg.BackfillYears > 0 ? cfg.BackfillYears : 3;
  44. var startDate = todayKst.AddYears(-years);
  45. var holidays = (await db.MarketHoliday.AsNoTracking()
  46. .Where(c => c.Date >= startDate && c.Date <= endDate)
  47. .Select(c => c.Date)
  48. .ToListAsync(ct)).ToHashSet();
  49. var maxPerRun = cfg.BackfillMaxPerRun > 0 ? cfg.BackfillMaxPerRun : 60;
  50. var fetched = await KrxBackfill.RunAsync(
  51. existsForDate: (day, token) => AllPresentForDateAsync(db, day, token),
  52. fetchAndUpsertForDate: (day, token) => FetchAndUpsertAsync(db, client, cfg.BaseUrl, cfg.ApiKey, day, token),
  53. startDate: startDate,
  54. endDate: endDate,
  55. holidays: holidays,
  56. maxPerRun: maxPerRun,
  57. delayMs: 300,
  58. ct: ct);
  59. Logger.LogInformation("[{Job}] 완료 — 창=[{Start}~{End}], 이번 실행 fetch={Fetched}일 (maxPerRun={Max})",
  60. JobName, startDate, endDate, fetched, maxPerRun);
  61. return true;
  62. }
  63. /// <summary>세 테이블 모두 해당 날짜가 적재되어 있는지 (부분 적재 시 refetch 하도록 AND 조건).</summary>
  64. private static async Task<bool> AllPresentForDateAsync(IAppDbContext db, DateOnly day, CancellationToken ct)
  65. {
  66. var etp = await db.EsgSecurity.AsNoTracking().AnyAsync(c => c.TradeDate == day, ct);
  67. var index = await db.EsgIndexDailyPrice.AsNoTracking().AnyAsync(c => c.TradeDate == day, ct);
  68. var sri = await db.SriBond.AsNoTracking().AnyAsync(c => c.TradeDate == day, ct);
  69. return etp && index && sri;
  70. }
  71. /// <summary>한 날짜에 대해 3개 ESG 엔드포인트를 모두 수집하고 각 테이블 upsert.</summary>
  72. private async Task FetchAndUpsertAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  73. {
  74. var trimmed = baseUrl.TrimEnd('/');
  75. await UpsertEsgSecuritiesAsync(db, client, trimmed, apiKey, day, ct);
  76. await UpsertEsgIndicesAsync(db, client, trimmed, apiKey, day, ct);
  77. await UpsertSriBondsAsync(db, client, trimmed, apiKey, day, ct);
  78. }
  79. private async Task UpsertEsgSecuritiesAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  80. {
  81. var url = $"{baseUrl}{EtpPath}?basDd={day:yyyyMMdd}";
  82. var json = await KrxCoKrHttp.GetStringWithRetryAsync(client, url, apiKey, Logger, ct);
  83. var rows = KrxEsgSecurityParser.ParseDaily(json);
  84. Logger.LogInformation("[{Job}] ESG증권상품 basDd={Day} rows={Rows}", JobName, day, rows.Count);
  85. if (rows.Count == 0)
  86. {
  87. return;
  88. }
  89. var existing = await db.EsgSecurity.Where(c => c.TradeDate == day).ToListAsync(ct);
  90. var existingByKey = existing.ToDictionary(c => c.Name);
  91. foreach (var row in rows)
  92. {
  93. if (existingByKey.TryGetValue(row.Name, out var entity))
  94. {
  95. entity.Update(row.Close, row.ChangeAmount, row.ChangeRate, row.ListedShares, row.Volume, row.TradeValue);
  96. }
  97. else
  98. {
  99. var created = EsgSecurity.Create(row.Name, row.TradeDate, row.Close, row.ChangeAmount, row.ChangeRate, row.ListedShares, row.Volume, row.TradeValue);
  100. await db.EsgSecurity.AddAsync(created, ct);
  101. existingByKey[row.Name] = created;
  102. }
  103. }
  104. await db.SaveChangesAsync(ct);
  105. }
  106. private async Task UpsertEsgIndicesAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  107. {
  108. var url = $"{baseUrl}{IndexPath}?basDd={day:yyyyMMdd}";
  109. var json = await KrxCoKrHttp.GetStringWithRetryAsync(client, url, apiKey, Logger, ct);
  110. var rows = KrxEsgIndexParser.ParseDaily(json);
  111. Logger.LogInformation("[{Job}] ESG지수 basDd={Day} rows={Rows}", JobName, day, rows.Count);
  112. if (rows.Count == 0)
  113. {
  114. return;
  115. }
  116. var existing = await db.EsgIndexDailyPrice.Where(c => c.TradeDate == day).ToListAsync(ct);
  117. var existingByKey = existing.ToDictionary(c => c.IndexName);
  118. foreach (var row in rows)
  119. {
  120. if (existingByKey.TryGetValue(row.IndexName, out var entity))
  121. {
  122. entity.Update(row.Close, row.ChangeVal, row.FlucRateBp, row.ConstituentCount, row.Volume, row.Value);
  123. }
  124. else
  125. {
  126. var created = EsgIndexDailyPrice.Create(row.IndexName, row.TradeDate, row.Close, row.ChangeVal, row.FlucRateBp, row.ConstituentCount, row.Volume, row.Value);
  127. await db.EsgIndexDailyPrice.AddAsync(created, ct);
  128. existingByKey[row.IndexName] = created;
  129. }
  130. }
  131. await db.SaveChangesAsync(ct);
  132. }
  133. private async Task UpsertSriBondsAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  134. {
  135. var url = $"{baseUrl}{SriBondPath}?basDd={day:yyyyMMdd}";
  136. var json = await KrxCoKrHttp.GetStringWithRetryAsync(client, url, apiKey, Logger, ct);
  137. var rows = KrxSriBondParser.ParseDaily(json);
  138. Logger.LogInformation("[{Job}] 사회책임투자채권 basDd={Day} rows={Rows}", JobName, day, rows.Count);
  139. if (rows.Count == 0)
  140. {
  141. return;
  142. }
  143. var existing = await db.SriBond.Where(c => c.TradeDate == day).ToListAsync(ct);
  144. var existingByKey = existing.ToDictionary(c => c.Code);
  145. foreach (var row in rows)
  146. {
  147. if (existingByKey.TryGetValue(row.Code, out var entity))
  148. {
  149. entity.Update(row.IssuerName, row.SriBondType, row.Name, row.ListDate, row.IssueDate, row.RedemptionDate, row.CouponRate, row.IssueAmount, row.ListAmount, row.BondType);
  150. }
  151. else
  152. {
  153. var created = SriBond.Create(row.Code, row.TradeDate, row.IssuerName, row.SriBondType, row.Name, row.ListDate, row.IssueDate, row.RedemptionDate, row.CouponRate, row.IssueAmount, row.ListAmount, row.BondType);
  154. await db.SriBond.AddAsync(created, ct);
  155. existingByKey[row.Code] = created;
  156. }
  157. }
  158. await db.SaveChangesAsync(ct);
  159. }
  160. }