문서

로컬 개발

• ·pnpm install 후 workers/requirements.txt 설치
• ·cp .env.example .env — DATABASE_URL, REDIS_URL, OPENAI_API_KEY
• ·pnpm db:up && pnpm db:push && pnpm db:setup
• ·pnpm dev:stack — API :3001, Web :3000

프로덕션 (Supabase + Railway + Vercel)

• ·Supabase: pgvector 확장, Auth Redirect에 Vercel URL 등록
• ·Railway: Dockerfile 배포, DATABASE_URL·CORS_ORIGIN·PORT=3001
• ·Vercel: Root Directory = apps/web, monorepo include ON
• ·Vercel env: API_URL, NEXT_PUBLIC_* Supabase 키

전략 추가

• ·strategies/<slug>/manifest.yaml, strategy.py, params.default.json
• ·pnpm db:setup 또는 API sync로 DB 반영
• ·POST /backtests 로 백테스트, POST /backtests/:id/replay 로 리플레이

데이터 파이프라인 (프로덕션)

• ·시세: Binance 공개 OHLCV → ccxt → DATA_ROOT/candles/.../15m.json
• ·백테스트: Python worker → results/{run_id}/ + Supabase BacktestRun(trades 포함)
• ·TradingView: Alert → /webhooks/tradingview → Signal(DB) + Paper(JSON)
• ·메모리: pgvector(Postgres) — OPENAI_API_KEY 있으면 시맨틱 검색
• ·Volume: Railway /app/data + DATA_ROOT — 재배포 후 캔들·페이퍼 유지
• ·전체 가이드: 저장소 USER-GUIDE.md

TradingView · 차트 (무료)

• ·Lightweight Charts: /app/charts · /app/signals · 백테스트 상세 (체결·시그널 마커)
• ·TradingView 딥링크: 시그널 가이드·백테스트에서 TV 차트 새 탭
• ·Alert URL + JSON 템플릿: /app/signals (price: {{close}} 필수)
• ·유료 Advanced Charts·이미지 캡처는 사용하지 않음

MCP (Cursor)

• ·pnpm exec turbo build --filter=@backwave/mcp-server...
• ·mcp.json에 BACKWAVE_API_URL = Railway API URL (선택 BACKWAVE_API_KEY)
• ·12개 도구 — 백테스트·캔들 sync·시그널·health 포함

MCP (Cursor)

MCP는 백테스트·캔들 sync·시그널 조회 등 API 래퍼입니다. Live 주문·Paper 체결은 REST/Webhook 파이프라인만 사용합니다.

빌드

• ·pnpm install
• ·pnpm exec turbo build --filter=@backwave/mcp-server...
• ·Cursor Settings → MCP → 위 JSON 붙여넣기 (또는 ~/.cursor/mcp.json)

mcp.json 예시

{
  "mcpServers": {
    "backwave": {
      "command": "node",
      "args": ["apps/mcp-server/dist/index.js"],
      "env": {
        "BACKWAVE_API_URL": "https://backwave-api-production.up.railway.app",
        "BACKWAVE_API_KEY": "<optional — Railway API key if enabled>"
      }
    }
  }
}

도구 목록