using System.Globalization;
using System.Text.Json;
namespace Infrastructure.StockData;
///
/// OpenDART 공시검색(list.json) 응답 파서 — 순수 C# (System.Text.Json).
/// 응답 골격: { "status", "message", "page_no", "page_count", "total_count", "total_page", "list":[ {...} ] }.
/// status: "000" 정상, "013" 조회된 데이터 없음(정상 빈결과), "010"/"011" 키 오류, "020" 요청 제한(쿼터) 초과,
/// "100" 파라미터 오류 등 — 전체 라벨은 DescribeStatus 참고. list 항목의 모든 값은 문자열.
/// - stock_code 는 6자리 단축코드(상장) 또는 "" (비상장) → 빈 값은 null.
/// - rcept_dt 는 YYYYMMDD → DateOnly. rm(비고)은 없거나 "" → null.
/// list.json 이 stock_code 를 이미 포함하므로 corpCode.xml 매핑 없이 종목별 조회가 가능하다.
///
public static class DartDisclosureParser
{
/// 공시 1행 (list.json 항목). stock_code 빈 값은 null, rcept_dt 는 DateOnly.
public sealed record DisclosureRow(
string RceptNo,
string CorpCode,
string CorpName,
string? StockCode,
string CorpCls,
string ReportNm,
string FlrNm,
DateOnly RceptDt,
string? Rm
);
/// 파싱 결과 — status/총페이지 등 메타와 파싱된 행. status != "000" 이면 Rows 는 빈 목록.
public sealed record ParseResult(
string Status,
string Message,
int PageNo,
int TotalPage,
int TotalCount,
IReadOnlyList Rows
);
public static ParseResult Parse(string json)
{
using var doc = JsonDocument.Parse(json);
var root = doc.RootElement;
var status = GetString(root, "status");
var message = GetString(root, "message");
var pageNo = GetInt(root, "page_no");
var totalPage = GetInt(root, "total_page");
var totalCount = GetInt(root, "total_count");
var rows = new List();
if (status != "000" || !root.TryGetProperty("list", out var list) || list.ValueKind != JsonValueKind.Array)
{
return new ParseResult(status, message, pageNo, totalPage, totalCount, rows);
}
foreach (var item in list.EnumerateArray())
{
var rceptNo = GetString(item, "rcept_no");
var corpCode = GetString(item, "corp_code");
var reportNm = GetString(item, "report_nm");
var rceptDt = ParseDate(GetString(item, "rcept_dt"));
if (rceptNo.Length == 0 || corpCode.Length == 0 || reportNm.Length == 0 || rceptDt is null)
{
continue;
}
rows.Add(new DisclosureRow(
rceptNo,
corpCode,
GetString(item, "corp_name"),
ToNull(GetString(item, "stock_code")),
GetString(item, "corp_cls"),
reportNm,
GetString(item, "flr_nm"),
rceptDt.Value,
ToNull(GetString(item, "rm"))
));
}
return new ParseResult(status, message, pageNo, totalPage, totalCount, rows);
}
///
/// OpenDART 공통 status 코드 라벨 (개발가이드 메시지 설명 기준).
/// 주의: "020" 은 '요청 제한(쿼터) 초과'다 — 키 오류("010"/"011")와 혼동 금지 (일 20,000건 한도).
///
public static string DescribeStatus(string status)
{
return status switch
{
"000" => "정상",
"010" => "등록되지 않은 키",
"011" => "사용할 수 없는 키 (사용중지/삭제)",
"012" => "접근할 수 없는 IP",
"013" => "조회된 데이터 없음",
"014" => "파일이 존재하지 않음",
"020" => "요청 제한(쿼터) 초과",
"021" => "조회 가능한 회사 개수 초과 (최대 100건)",
"100" => "필드의 부적절한 값 (파라미터 오류)",
"101" => "부적절한 접근",
"800" => "시스템 점검으로 서비스 중지",
"900" => "정의되지 않은 오류",
"901" => "계정 개인정보 보유기간 만료로 사용할 수 없는 키",
_ => "알 수 없는 상태"
};
}
private static string GetString(JsonElement element, string name)
{
if (!element.TryGetProperty(name, out var value))
{
return string.Empty;
}
return value.ValueKind switch
{
JsonValueKind.String => value.GetString()?.Trim() ?? string.Empty,
JsonValueKind.Number => value.GetRawText(),
_ => string.Empty
};
}
private static int GetInt(JsonElement element, string name)
{
if (!element.TryGetProperty(name, out var value))
{
return 0;
}
return value.ValueKind switch
{
JsonValueKind.Number => value.TryGetInt32(out var n) ? n : 0,
JsonValueKind.String => int.TryParse(value.GetString(), NumberStyles.Integer, CultureInfo.InvariantCulture, out var s) ? s : 0,
_ => 0
};
}
/// 빈 문자열/"-" 은 null, 나머지는 trim 값
private static string? ToNull(string raw)
{
return raw.Length == 0 || raw == "-" ? null : raw;
}
private static DateOnly? ParseDate(string raw)
{
return DateOnly.TryParseExact(raw, "yyyyMMdd", CultureInfo.InvariantCulture, DateTimeStyles.None, out var date) ? date : null;
}
}