설계: 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>
72 lines
3.0 KiB
Python
72 lines
3.0 KiB
Python
"""사용자 스코프 리스크 매니저 팩토리 (설계 문서 §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}")
|