3.3 KiB
3.3 KiB
자동매매 CLI 모델 선택 + AI 입력 데이터 흐름 보강 계획
[계획 문서 경로]
common-docs/improvement/plans/dev-plan-2026-02-26-autotrade-cli-model-selection.md
[요구사항 요약]
- 자동매매가 AI 판단 시 어떤 데이터를 전달하는지 쉽게 설명한다.
- Codex/Gemini CLI 모델을 공식 옵션 기준으로 선택 가능하게 만든다.
- 로그/응답에서 실제 사용된 vendor/model을 확인 가능하게 만든다.
[가정]
- 구독형 CLI는 서버(개발/운영)에 설치되어 있고 로그인/인증이 완료되어 있다.
- 모델 선택은 UI 입력보다 서버 환경변수 방식이 운영상 안전하다.
[영향 범위]
- 수정:
lib/autotrade/cli-provider.ts - 수정:
app/api/autotrade/strategies/compile/route.ts - 수정:
app/api/autotrade/signals/generate/route.ts - 수정:
features/autotrade/types/autotrade.types.ts - 수정:
features/autotrade/hooks/useAutotradeEngine.ts - 수정:
.env.example - 수정:
common-docs/features/autotrade-usage-security-guide.md - 수정:
common-docs/features/autotrade-prompt-flow-guide.md
[구현 단계]
- 1. CLI 실행 인자에 vendor별 모델 선택 환경변수를 반영한다. (근거:
lib/autotrade/cli-provider.ts) - 2. compile/signal 응답에
providerModel을 포함해 추적 가능하게 만든다. (근거:app/api/autotrade/strategies/compile/route.ts,app/api/autotrade/signals/generate/route.ts) - 3. 런타임 로그에 vendor/model을 함께 노출한다. (근거:
features/autotrade/hooks/useAutotradeEngine.ts) - 4. AI 입력 데이터(시세/전략) 흐름 설명을 문서에 보강한다. (근거:
common-docs/features/autotrade-usage-security-guide.md,common-docs/features/autotrade-prompt-flow-guide.md)
[사용할 MCP/Skills]
- Skills:
dev-auto-pipeline,dev-mcp-implementation,dev-refactor-polish,dev-test-gate,dev-plan-completion-checker - MCP: 없음(로컬 코드 수정 + 공식 문서 웹 근거 활용)
[참조 문서(common-docs)]
common-docs/features/trade-stock-sync.md(참고만, 변경 없음)common-docs/ui/GLOBAL_ALERT_SYSTEM.md(참고만, 변경 없음)
[주석/문서 반영 계획]
- 함수 주석: CLI 모델 선택 우선순위와 데이터 흐름 주석 보강
- 상태/로그 주석: vendor/model 로그 의미를 한 줄로 명시
- 흐름 문서: UI -> 훅 -> API -> route -> provider 단계 유지
[리스크/회귀 포인트]
- Codex CLI 모델명이 환경과 불일치하면 CLI 실패 후 fallback으로 전환될 수 있다.
- 응답 스키마 필드 추가(
providerModel)가 프론트 타입과 불일치하면 TS 오류가 날 수 있다.
[검증 계획]
- 1. 변경 파일 eslint 검사 통과 (결과: 코드 파일 오류 없음, md 파일은 lint 대상 아님 경고)
- 2.
npm run build통과 - 3. 문서의 환경변수/확인 절차가 실제 로그 포맷과 일치
[진행 로그]
- 2026-02-26: 계획 문서 생성
- 2026-02-26: CLI 모델 선택 환경변수(
AUTOTRADE_CODEX_MODEL,AUTOTRADE_GEMINI_MODEL,AUTOTRADE_SUBSCRIPTION_CLI_MODEL) 반영 - 2026-02-26: provider vendor/model 추적값 응답/로그 반영
- 2026-02-26: AI 입력 데이터(시세 스냅샷/전략 제약) 설명 문서 보강
- 2026-02-26:
npx eslint+npm run build검증 완료