Files
stock_chart_site/backend/app/api/refresh.py
tkrmagid 296bd6dccd fix(seed): SEED 10종목 항상 보장 + KRX 실패 graceful degrade + 수동 reseed API
문제: 빌드/기동은 성공했는데 종목 검색 결과 빈 화면. 원인은 시드 트랜잭션
구조 — `_fetch_market_listing(KRX)` 가 `with engine.begin()` 블록 *밖*에서
호출되고, 컨테이너에서 KRX 서버 접근이 실패하거나 단일 ticker 처리 중
한 곳이라도 예외가 나면 전체 트랜잭션이 롤백되어 SEED_TICKERS 10개조차
들어가지 않음.

수정:
- `_upsert_seed_tickers()` 분리. SEED 10종목 전용 트랜잭션. 네트워크 무관.
- `seed_symbols()` 가 (1) SEED 먼저 → (2) KRX 시장별 fetch (try-per-market)
  → (3) 전 종목 bulk upsert (별도 트랜잭션) 순서로 동작. KRX fetch 실패해도
  SEED 는 살아남음.
- `main.py` lifespan bootstrap 이 SEED upsert 를 매 부팅마다 무조건 실행
  (10회, ms 단위, idempotent). count <= 10 일 때만 KRX 전 종목 fetch.
- 새 admin 엔드포인트 `POST /api/refresh/seed/symbols` — 컨테이너 재기동
  없이 시드 재시도 가능.

이번 사례 (사금향 PC) 의 복구 절차:
    curl -X POST http://localhost:8000/api/refresh/seed/symbols
이후 검색에 SEED 10 종목은 즉시 떠야 함. KRX 가 막힌 환경이면 markets={0,0}
가 응답에 찍히고, 그래도 SEED 만으로 핵심 동작은 가능.
2026-05-21 02:31:49 +09:00

57 lines
1.7 KiB
Python

"""검증용 수동 갱신 API.
POST /api/refresh/{code}
body: 없음
query: ?lookback_days=7 (기본)
resp: refresh_one.RefreshReport.to_dict()
POST /api/refresh/seed/symbols
symbols 테이블 강제 재시드 (SEED 10 + KRX 전 종목). 부팅 시 시드가 실패한
경우 컨테이너 재기동 없이 복구하기 위한 admin 엔드포인트.
"""
from __future__ import annotations
from fastapi import APIRouter, HTTPException, Query
from sqlalchemy import text
from app.db.connection import get_engine
from app.fetch.symbols_seed import seed_symbols
from app.pipelines.refresh_one import refresh_code
router = APIRouter(prefix="/api", tags=["refresh"])
def _resolve_name(code: str) -> str | None:
eng = get_engine()
with eng.connect() as conn:
row = conn.execute(text("SELECT name FROM symbols WHERE code = :code"), {"code": code}).first()
return row[0] if row else None
@router.post("/refresh/{code}")
def refresh_endpoint(
code: str,
lookback_days: int = Query(default=7, ge=1, le=365),
) -> dict:
name = _resolve_name(code)
if not name:
raise HTTPException(status_code=404, detail=f"unknown code: {code} (symbols 테이블에 없음. 시드 필요)")
report = refresh_code(code, name, lookback_days=lookback_days)
return report.to_dict()
@router.post("/refresh/seed/symbols")
def reseed_symbols() -> dict:
"""symbols 테이블 강제 재시드.
호출 예 (Windows cmd):
curl -X POST http://localhost:8000/api/refresh/seed/symbols
"""
report = seed_symbols()
return {
"inserted": report.inserted,
"updated": report.updated,
"seed_marked": report.seed_marked,
"markets": report.markets,
}