auto-stock/backend/app/api/__init__.py

"""
API 라우터 통합 모듈

- 각 엔드포인트 라우터를 prefix/tag와 함께 등록
- 인증 정책:
  - require_api_key: 매매 실행, 설정 변경, 관리 API, **계좌·손익·리스크 상태를 반환하는 조회**,
    **KIS/외부 호출을 일으키는 조회** (X-API-Key 필수)
  - optional_api_key: 공개 시장 데이터만 (`/market/indices`)
  - require_admin_for_listed_routes: api_router 전역 — `security.ADMIN_ONLY_ROUTES` 에 등록된
    위험 쓰기(MDD 리셋·전략설정 변경·DT 전량청산/수동실행·서킷브레이커·debug·MCP 도구 호출)는
    관리자(API 키 또는 활성 관리자 세션)만.

[2026-10-02 H-1] 이전에는 journals·analysis·market_intelligence·market_data·ml_ensemble·
news·adaptive_strategy 가 optional_api_key 라 키 없이 계좌 총자산·가용현금·손익·MDD·밴 목록이
운영(https://stock.shium.net)에서 그대로 응답했고, market_data/ml_ensemble 은 인증 없이 KIS 호출을
일으켰다. 프론트는 로그인 게이트 + axios 인터셉터로 모든 요청에 X-API-Key 를 싣는다.
"""
from fastapi import APIRouter, Depends
from app.core.security import require_api_key, optional_api_key, require_admin_for_listed_routes
from app.core.tenant_auth import deny_non_owner_session_when_mt
from app.api.endpoints import (
    trading_rules, trades, trades_v2, portfolio, portfolio_v2, market_data, mcp, recommendations,
    monitoring, tensorflow_predictions, debug, risk_management, ml_ensemble,
    journals, day_trading, strategy_config, backtest, analysis,
    swing_portfolio, daytrading_v2, us_trading, kr_backtest,
    market_intelligence, market_playbook, news, market_indices,
    adaptive_strategy, manual_buy, auth, kis_credentials,
)

# H-2: 위험 쓰기는 라우터 파일을 건드리지 않고 여기서 일괄 관리자 확인 (목록: security.ADMIN_ONLY_ROUTES)
api_router = APIRouter(dependencies=[Depends(require_admin_for_listed_routes)])

# ── 로그인 (인증 불필요 — 자체 자격 증명 검증) ───────────────────────────
api_router.include_router(auth.router, prefix="/auth", tags=["auth"])

# ── 매매 실행 / 설정 변경 API (require_api_key) ───────────────────────────
# portfolio_v2/trades_v2 는 반드시 기존 portfolio/trades 라우터보다 먼저 등록한다
# (라우트는 등록 순서대로 매칭되므로, 이렇게 해야 "/portfolio/v2..."·"/trades/v2..."가
# 기존 동적 경로(예: /trades/{trade_id})에 먼저 잡히지 않는다).
api_router.include_router(
    portfolio_v2.router, prefix="/portfolio/v2", tags=["portfolio_v2"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    trades_v2.router, prefix="/trades/v2", tags=["trades_v2"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    trading_rules.router, prefix="/rules", tags=["trading_rules"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    portfolio.router, prefix="/portfolio", tags=["portfolio"],
    dependencies=[Depends(require_api_key), Depends(deny_non_owner_session_when_mt)],
)
api_router.include_router(
    manual_buy.router, prefix="/portfolio", tags=["portfolio"],
    dependencies=[Depends(require_api_key), Depends(deny_non_owner_session_when_mt)],
)
api_router.include_router(
    kis_credentials.router, prefix="/account", tags=["account"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    recommendations.router, prefix="/recommendations", tags=["recommendations"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    risk_management.router, prefix="/risk", tags=["risk_management"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    day_trading.router, prefix="/daytrading", tags=["day_trading"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    strategy_config.router, prefix="/strategy-config", tags=["strategy_config"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    swing_portfolio.router, prefix="/swing", tags=["swing"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    daytrading_v2.router, prefix="/daytrading-v2", tags=["daytrading_v2"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    us_trading.router, tags=["us_trading"],
    dependencies=[Depends(require_api_key)],
)

# ── 조회 API — 계좌/KIS 관련은 require_api_key, 공개 시장지수만 optional ──────
api_router.include_router(
    market_data.router, prefix="/market-data", tags=["market_data"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    market_indices.router, prefix="/market", tags=["market_indices"],
    dependencies=[Depends(optional_api_key)],
)
api_router.include_router(
    analysis.router, prefix="/analysis", tags=["analysis"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    journals.router, prefix="/journals", tags=["journals"],
    dependencies=[Depends(require_api_key)],
)

# ── 내부/인프라 API ───────────────────────────────────────────────────────
api_router.include_router(
    trades.router, prefix="/trades", tags=["trades"],
    dependencies=[Depends(require_api_key), Depends(deny_non_owner_session_when_mt)],
)
api_router.include_router(
    mcp.router, prefix="/mcp", tags=["mcp"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    monitoring.router, prefix="/monitoring", tags=["monitoring"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    tensorflow_predictions.router, prefix="/ml", tags=["ml"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    debug.router, prefix="/debug", tags=["debug"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    ml_ensemble.router, prefix="/ml-ensemble", tags=["ml_ensemble"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    backtest.router, prefix="/backtest", tags=["backtest"],
    dependencies=[Depends(require_api_key)],
)
api_router.include_router(
    kr_backtest.router, prefix="/kr-backtest", tags=["kr_backtest"],
    dependencies=[Depends(require_api_key)],
)

# ── 시장 인텔리전스 — /dashboard 가 총자산·가용현금·손익·MDD·밴·kis_mode 를 반환하므로 인증 필수 ──
api_router.include_router(
    market_intelligence.router, prefix="/market-intelligence", tags=["market_intelligence"],
    dependencies=[Depends(require_api_key)],
)

# ── 시장 이벤트 플레이북 ──────────────────────────────────────────────────
# GET (조회)는 optional, POST/DELETE (제어)는 require_api_key
# 라우터 내부에서 GET은 인증 없이, POST/DELETE는 api/__init__ 의존성으로 보호
api_router.include_router(
    market_playbook.router, prefix="/playbook", tags=["playbook"],
    dependencies=[Depends(require_api_key)],
)

# ── 뉴스 감성 분석 — 종목별 조회가 외부 수집/AI 호출을 일으키므로 인증 필수 ──
api_router.include_router(
    news.router, prefix="/news", tags=["news"],
    dependencies=[Depends(require_api_key)],
)

# ── 적응형 전략 엔진 ────────────────────────────────────────────────────
# 조회도 인증 필수(전략 내부 상태). POST (갱신)는 라우터 내부에서도 require_api_key
api_router.include_router(
    adaptive_strategy.router,
    dependencies=[Depends(require_api_key)],
)