feat: 멀티테넌트 1단계 — 사용자별 KIS 계좌·포트폴리오·수동매매 (MULTI_TENANT_ENABLED 기본 OFF)

설계: 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>

backend/app/services/tenant/risk_factory.py

@@ -0,0 +1,71 @@
+"""사용자 스코프 리스크 매니저 팩토리 (설계 문서 §5.6).
+
+`UserContextRegistry`(dev-team/trading-agent 조립 담당)가 사용자 컨텍스트를
+만들 때 이 팩토리로 `MDDManager`/`ConsecutiveLossTracker` 인스턴스를 새로
+생성하고 영속화 상태(Redis `mdd:state:{user_id}`, `stock_bans_v2`)를 복원한다.
+
+기존 전역 싱글톤(`app.services.mdd_manager.mdd_manager`,
+`app.services.loss_tracker.loss_tracker`)은 legacy 컨텍스트 전용으로 그대로
+남겨두고 이 모듈에서 재사용하지 않는다 — 여러 사용자가 동일 인스턴스를 공유하면
+peak_balance/연속손실 카운트가 뒤섞이기 때문이다.
+"""
+import logging
+
+from app.services.mdd_manager import MDDManager
+from app.services.loss_tracker import ConsecutiveLossTracker
+
+logger = logging.getLogger(__name__)
+
+
+def create_mdd_manager_for_user(user_id: int) -> MDDManager:
+    """사용자 전용 `MDDManager` 신규 인스턴스 생성.
+
+    peak_balance/is_paused 등은 기본값(0/False)에서 시작 — 실제 복원은
+    `load_user_risk_state()`가 `load_from_redis_v2(user_id)`로 수행한다.
+    """
+    return MDDManager()
+
+
+def create_loss_tracker_for_user(user_id: int) -> ConsecutiveLossTracker:
+    """사용자 전용 `ConsecutiveLossTracker` 신규 인스턴스 생성.
+
+    `ban_count`/`ban_calendar_days`는 전역 설정(§CLAUDE.md 5.1: 3연패/42일)을
+    그대로 따른다 — 사용자별 오버라이드는 이번 범위 밖.
+    인스턴스의 `user_id` 속성을 세팅해 두면 호출 측(스케줄러/엔드포인트)이
+    `ctx.loss_tracker.save_to_db_v2(ctx.loss_tracker.user_id, stock_code)`처럼
+    컨텍스트에서 user_id를 다시 꺼낼 필요 없이 인스턴스에서 바로 참조할 수 있다.
+    """
+    try:
+        from app.core.config import settings
+        tracker = ConsecutiveLossTracker(
+            ban_count=settings.CONSECUTIVE_LOSS_BAN_COUNT,
+            ban_calendar_days=42,
+        )
+    except Exception:
+        tracker = ConsecutiveLossTracker()
+    tracker.user_id = user_id
+    return tracker
+
+
+async def load_user_risk_state(
+    ctx_user_id: int,
+    mdd: MDDManager,
+    tracker: ConsecutiveLossTracker,
+    db,
+) -> None:
+    """사용자 컨텍스트 생성 직후 1회 호출 — Redis(MDD) + DB(ban) 상태 복원.
+
+    두 복원 모두 실패해도 예외를 전파하지 않는다(각 `_v2` 메서드 내부에서
+    이미 try/except 처리됨) — 신규 사용자는 그냥 초기 상태로 시작한다.
+    """
+    try:
+        restored = await mdd.load_from_redis_v2(ctx_user_id)
+        if not restored:
+            logger.debug(f"[risk_factory] user={ctx_user_id} MDD 상태 없음 — 초기값으로 시작")
+    except Exception as e:
+        logger.warning(f"[risk_factory] user={ctx_user_id} MDD 복원 실패: {e}")
+
+    try:
+        await tracker.load_from_db_v2(db, ctx_user_id)
+    except Exception as e:
+        logger.warning(f"[risk_factory] user={ctx_user_id} loss_tracker 복원 실패: {e}")