머니페니 f818bd3290 feat: add walk-forward analysis for backtests
- Add WalkForwardResult model with train/test window metrics
- Create WalkForwardEngine that reuses existing BacktestEngine
  with rolling train/test window splits
- Add POST/GET /api/backtest/{id}/walkforward endpoints
- Add Walk-forward tab to backtest detail page with parameter
  controls, cumulative return chart, and window results table
- Add Alembic migration for walkforward_results table
- Add 8 unit tests for window generation logic (100 total passed)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-18 22:33:41 +09:00

128 lines
4.5 KiB
Python

"""
Backtest related models.
"""
from datetime import datetime
from sqlalchemy import (
Column, Integer, String, Numeric, DateTime, Date,
Text, ForeignKey, JSON, Enum as SQLEnum
)
from sqlalchemy.orm import relationship
import enum
from app.core.database import Base
class BacktestStatus(str, enum.Enum):
PENDING = "pending"
RUNNING = "running"
COMPLETED = "completed"
FAILED = "failed"
class RebalancePeriod(str, enum.Enum):
MONTHLY = "monthly"
QUARTERLY = "quarterly"
SEMI_ANNUAL = "semi_annual"
ANNUAL = "annual"
class Backtest(Base):
__tablename__ = "backtests"
id = Column(Integer, primary_key=True, index=True)
user_id = Column(Integer, ForeignKey("users.id"), nullable=False)
strategy_type = Column(String(50), nullable=False)
strategy_params = Column(JSON, default={})
start_date = Column(Date, nullable=False)
end_date = Column(Date, nullable=False)
rebalance_period = Column(SQLEnum(RebalancePeriod), default=RebalancePeriod.QUARTERLY)
initial_capital = Column(Numeric(20, 2), nullable=False)
commission_rate = Column(Numeric(10, 6), default=0.00015)
slippage_rate = Column(Numeric(10, 6), default=0.001)
benchmark = Column(String(20), default="KOSPI")
top_n = Column(Integer, default=30)
status = Column(SQLEnum(BacktestStatus), default=BacktestStatus.PENDING)
created_at = Column(DateTime, default=datetime.utcnow)
completed_at = Column(DateTime, nullable=True)
error_message = Column(Text, nullable=True)
# Relationships
result = relationship("BacktestResult", back_populates="backtest", uselist=False)
equity_curve = relationship("BacktestEquityCurve", back_populates="backtest")
holdings = relationship("BacktestHolding", back_populates="backtest")
transactions = relationship("BacktestTransaction", back_populates="backtest")
walkforward_results = relationship("WalkForwardResult", back_populates="backtest")
class BacktestResult(Base):
__tablename__ = "backtest_results"
backtest_id = Column(Integer, ForeignKey("backtests.id"), primary_key=True)
total_return = Column(Numeric(10, 4))
cagr = Column(Numeric(10, 4))
mdd = Column(Numeric(10, 4))
sharpe_ratio = Column(Numeric(10, 4))
volatility = Column(Numeric(10, 4))
benchmark_return = Column(Numeric(10, 4))
excess_return = Column(Numeric(10, 4))
backtest = relationship("Backtest", back_populates="result")
class BacktestEquityCurve(Base):
__tablename__ = "backtest_equity_curve"
backtest_id = Column(Integer, ForeignKey("backtests.id"), primary_key=True)
date = Column(Date, primary_key=True)
portfolio_value = Column(Numeric(20, 2))
benchmark_value = Column(Numeric(20, 2))
drawdown = Column(Numeric(10, 4))
backtest = relationship("Backtest", back_populates="equity_curve")
class BacktestHolding(Base):
__tablename__ = "backtest_holdings"
backtest_id = Column(Integer, ForeignKey("backtests.id"), primary_key=True)
rebalance_date = Column(Date, primary_key=True)
ticker = Column(String(20), primary_key=True)
name = Column(String(100))
weight = Column(Numeric(10, 4))
shares = Column(Integer)
price = Column(Numeric(12, 2))
backtest = relationship("Backtest", back_populates="holdings")
class BacktestTransaction(Base):
__tablename__ = "backtest_transactions"
id = Column(Integer, primary_key=True, index=True)
backtest_id = Column(Integer, ForeignKey("backtests.id"), nullable=False)
date = Column(Date, nullable=False)
ticker = Column(String(20), nullable=False)
action = Column(String(10), nullable=False) # buy/sell
shares = Column(Integer, nullable=False)
price = Column(Numeric(12, 2), nullable=False)
commission = Column(Numeric(12, 2), nullable=False)
backtest = relationship("Backtest", back_populates="transactions")
class WalkForwardResult(Base):
__tablename__ = "walkforward_results"
id = Column(Integer, primary_key=True, index=True)
backtest_id = Column(Integer, ForeignKey("backtests.id"), nullable=False)
window_index = Column(Integer, nullable=False)
train_start = Column(Date, nullable=False)
train_end = Column(Date, nullable=False)
test_start = Column(Date, nullable=False)
test_end = Column(Date, nullable=False)
test_return = Column(Numeric(10, 4), nullable=True)
test_sharpe = Column(Numeric(10, 4), nullable=True)
test_mdd = Column(Numeric(10, 4), nullable=True)
backtest = relationship("Backtest", back_populates="walkforward_results")