fix: EDGAR 컬럼명 DART 통일 — account→snakeId, category→분류, metric→계정명

DART와 EDGAR Company가 동일한 컬럼 구조를 반환하도록 통일.
- EDGAR IS/BS/CF: account → snakeId + 계정명 컬럼 추가
- EDGAR ratios: category → 분류, metric → 계정명
- 테스트 업데이트 (test_show_ratios_returns_data)

Author: eddmpython

src/dartlab/providers/edgar/_finance_accessor.py

@@ -48,9 +48,15 @@ def _stmtDf(self, stmtKey: str) -> pl.DataFrame | None:
             self._company._cache[cacheKey] = None
             return None
 
+        from dartlab.core.finance.labels import get_korean_labels
+
+        krLabels = get_korean_labels()
         rows = []
         for snakeId, values in stmtData.items():
-            row: dict[str, Any] = {"account": snakeId}
+            row: dict[str, Any] = {
+                "snakeId": snakeId,
+                "계정명": krLabels.get(snakeId, snakeId),
+            }
             for i, year in enumerate(years):
                 row[str(year)] = values[i] if i < len(values) else None
             rows.append(row)
@@ -61,8 +67,8 @@ def _stmtDf(self, stmtKey: str) -> pl.DataFrame | None:
 
         result = pl.DataFrame(rows)
         # 기간 컬럼 역순 정렬
-        periodCols = [c for c in result.columns if c != "account"]
-        result = result.select(["account"] + periodCols[::-1])
+        periodCols = [c for c in result.columns if c not in ("snakeId", "계정명")]
+        result = result.select(["snakeId", "계정명"] + periodCols[::-1])
         self._company._cache[cacheKey] = result
         return result
 

src/dartlab/providers/edgar/company.py

@@ -354,8 +354,8 @@ def _ratioSeriesToDataFrame(
             if not values or not any(v is not None for v in values):
                 continue
             row: dict[str, Any] = {
-                "category": _RATIO_CATEGORY_LABELS.get(category, category),
-                "metric": _RATIO_FIELD_LABELS.get(fieldName, fieldName),
+                "분류": _RATIO_CATEGORY_LABELS.get(category, category),
+                "계정명": _RATIO_FIELD_LABELS.get(fieldName, fieldName),
                 "_field": fieldName,
             }
             for idx, year in enumerate(years):
@@ -2599,10 +2599,10 @@ def capital(self, view: str | None = None) -> pl.DataFrame | None:
         if pcols:
             latest = pcols[0]
             for row in equity.iter_rows(named=True):
-                rows[0][row["account"]] = row.get(latest)
+                rows[0][row["snakeId"]] = row.get(latest)
             if divs is not None:
                 for row in divs.iter_rows(named=True):
-                    rows[0][row["account"]] = row.get(latest)
+                    rows[0][row["snakeId"]] = row.get(latest)
         return pl.DataFrame(rows)
 
     def debt(self, view: str | None = None) -> pl.DataFrame | None:
@@ -2637,5 +2637,5 @@ def debt(self, view: str | None = None) -> pl.DataFrame | None:
         if pcols:
             latest = pcols[0]
             for row in debt_accts.iter_rows(named=True):
-                rows[0][row["account"]] = row.get(latest)
+                rows[0][row["snakeId"]] = row.get(latest)
         return pl.DataFrame(rows)

tests/test_edgarDocs_foundation.py

@@ -1288,11 +1288,12 @@ def test_show_ratios_returns_data(self):
         # ratios는 블록 1개 → auto unwrap으로 바로 데이터 반환 (DART 정합)
         df = c.show("ratios")
         assert isinstance(df, pl.DataFrame)
-        assert "category" in df.columns
+        assert "분류" in df.columns
+        assert "계정명" in df.columns
         # block=0 명시도 동일 결과
         df2 = c.show("ratios", 0)
         assert isinstance(df2, pl.DataFrame)
-        assert "category" in df2.columns
+        assert "분류" in df2.columns
 
     def test_show_docs_topic_returns_dataframe(self):
         from dartlab.providers.edgar.company import Company