설계: docs/multi_tenant_design.md / 검수: docs/multi_tenant_phase1_review.md (High 0, MT=False 배포 가능)
데이터·인프라
- user_kis_credentials(Fernet 암호화, PBKDF2 키 파생, key_version), stock_bans_v2 신설,
portfolio/trade_history/active_trades/trade_journals/trading_sessions 등 user_id nullable 추가
- alembic 0009~0011(idempotent, legacy owner 백필). main.py 기동 시 portfolio.user_id 스키마 검사(H1)
- Jenkinsfile: DB Migration 을 Deploy 앞으로, alembic 이력 없으면 stamp 0008 후 upgrade(N1)
- bootstrap: users 비어 있으면 BOOTSTRAP_ADMIN_* 로 관리자 시드 + .env KIS 자격증명 이관 + 백필(SAVEPOINT)
백엔드
- core/crypto.py, core/tenant_auth.py(get_current_user — 비활성 사용자 401, API 키→legacy owner,
deny_non_owner_session_when_mt), core/dt_utils.py
- services/tenant: context, kis_pool, registry(UserContextRegistry, 락 최소화·복호화 to_thread), risk_factory
- KoreaInvestmentAPI.for_user(사용자별 인스턴스, 토큰캐시 users/{id}/, 시세는 공용 위임)
- trade_executor.safe_place_order_v2(사용자별 락/세마포어, legacy ctx 는 기존 키)
- mdd_manager/loss_tracker _v2 + ban_until tz-aware/naive 경계 정규화(레거시 경로 버그 포함 수정)
- db_worker: payload user_id 옵션 필터, upsert_stock_ban_v2, legacy ActiveTrade 조회 LIMIT 1
- API: /account/credentials(등록·마스킹조회·삭제·연결테스트·자동매매), /auth/admin/tenant/*,
/portfolio/v2(조회·요약·sync·buy·sell), /trades/v2(+pending). PortfolioResponse Optional 수정
프론트
- /account 내 계좌 설정, useTenantMode(세션=v2 / API키=legacy, 미확정 시 쿼리·버튼 비활성),
계좌 미등록 인라인 안내, v2 매수/매도/거래이력 분기
테스트: tests/integration(격리 Postgres, KIS 전면 mock) 20 passed / 1 xfailed(0012 이전 제약)
2단계(스케줄러 사용자화·legacy 라우터 격리) 전까지 MULTI_TENANT_ENABLED=True 전환 금지
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
157 lines
6.7 KiB
Python
157 lines
6.7 KiB
Python
"""
|
|
API 라우터 통합 모듈
|
|
|
|
- 각 엔드포인트 라우터를 prefix/tag와 함께 등록
|
|
- 인증 정책:
|
|
- require_api_key: 매매 실행, 설정 변경, 관리 API (X-API-Key 필수)
|
|
- optional_api_key: 읽기 전용 조회 API (X-API-Key 선택)
|
|
"""
|
|
from fastapi import APIRouter, Depends
|
|
from app.core.security import require_api_key, optional_api_key
|
|
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,
|
|
adaptive_strategy, manual_buy, auth, kis_credentials,
|
|
)
|
|
|
|
api_router = APIRouter()
|
|
|
|
# ── 로그인 (인증 불필요 — 자체 자격 증명 검증) ───────────────────────────
|
|
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 (optional_api_key) ─────────────────────────────────────
|
|
api_router.include_router(
|
|
market_data.router, prefix="/market-data", tags=["market_data"],
|
|
dependencies=[Depends(optional_api_key)],
|
|
)
|
|
api_router.include_router(
|
|
analysis.router, prefix="/analysis", tags=["analysis"],
|
|
dependencies=[Depends(optional_api_key)],
|
|
)
|
|
api_router.include_router(
|
|
journals.router, prefix="/journals", tags=["journals"],
|
|
dependencies=[Depends(optional_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(optional_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(optional_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)],
|
|
)
|
|
|
|
# ── 시장 인텔리전스 (읽기 전용) ──────────────────────────────────────────
|
|
api_router.include_router(
|
|
market_intelligence.router, prefix="/market-intelligence", tags=["market_intelligence"],
|
|
dependencies=[Depends(optional_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)],
|
|
)
|
|
|
|
# ── 뉴스 감성 분석 (읽기 전용) ─────────────────────────────────────────
|
|
api_router.include_router(
|
|
news.router, prefix="/news", tags=["news"],
|
|
dependencies=[Depends(optional_api_key)],
|
|
)
|
|
|
|
# ── 적응형 전략 엔진 ────────────────────────────────────────────────────
|
|
# GET (조회)는 optional, POST (갱신)는 라우터 내부에서 require_api_key
|
|
api_router.include_router(
|
|
adaptive_strategy.router,
|
|
dependencies=[Depends(optional_api_key)],
|
|
)
|