79 lines
5.2 KiB
Markdown
79 lines
5.2 KiB
Markdown
[계획 문서 경로]
|
|
- common-docs/improvement/plans/dev-plan-2026-03-05-autotrade-ai-context-layout-boxrange.md
|
|
|
|
[요구사항 요약]
|
|
- 자동매매 신호 생성 시 AI 판단 입력 데이터를 늘린다.
|
|
- 자동매매 설정창 높이 문제를 해결하고 레이아웃을 더 간결하게 정리한다.
|
|
- 유명기법을 선택하지 않아도 자동매매가 동작하도록 기본 동작을 완화한다.
|
|
- "당일 상승 후 박스권 횡보 단타" 기법을 새로 추가한다.
|
|
|
|
[가정]
|
|
- "유명기법 미선택 허용"은 시작 자체 허용 + 서버에서 기본 기법 자동 적용으로 해석한다.
|
|
- 박스권 단타 기법은 fallback 엔진(규칙 기반)에서 즉시 동작하도록 우선 구현한다.
|
|
- AI/CLI 모드에도 동일한 추가 스냅샷 데이터를 전달해 판단 품질을 함께 높인다.
|
|
|
|
[영향 범위]
|
|
- 수정:
|
|
- features/autotrade/types/autotrade.types.ts
|
|
- features/autotrade/components/AutotradeControlPanel.tsx
|
|
- features/autotrade/hooks/useAutotradeEngine.ts
|
|
- features/autotrade/apis/autotrade.api.ts
|
|
- lib/autotrade/strategy.ts
|
|
- lib/autotrade/openai.ts
|
|
- app/api/autotrade/strategies/compile/route.ts
|
|
- app/api/autotrade/signals/generate/route.ts
|
|
- 추가:
|
|
- 없음
|
|
- 삭제:
|
|
- 없음
|
|
|
|
[구현 단계]
|
|
- [x] 1. 타입/스키마 확장: 자동매매 스냅샷에 체결/호가/파생 지표 필드를 추가하고 클라이언트/서버 타입을 동기화했다. (`features/autotrade/types/autotrade.types.ts`, `features/autotrade/apis/autotrade.api.ts`, `app/api/autotrade/signals/generate/route.ts`)
|
|
- [x] 2. AI 입력 데이터 확장: `useAutotradeEngine`에서 추가 지표를 계산해 signal API로 전달하고, OpenAI 프롬프트 안내 문구를 업데이트했다. (`features/autotrade/hooks/useAutotradeEngine.ts`, `lib/autotrade/openai.ts`, `features/autotrade/components/AutotradeControlPanel.tsx`)
|
|
- [x] 3. 유명기법 미선택 허용: 시작 버튼 조건/사전 검증 제한을 완화하고, compile 라우트에서 기본 기법 자동 적용을 넣었다. (`features/autotrade/components/AutotradeControlPanel.tsx`, `features/autotrade/hooks/useAutotradeEngine.ts`, `app/api/autotrade/strategies/compile/route.ts`)
|
|
- [x] 4. 박스권 단타 기법 추가: 기법 목록에 항목을 추가하고 fallback 신호 로직에 박스권 왕복 단타 판단을 구현했다. (`features/autotrade/types/autotrade.types.ts`, `lib/autotrade/strategy.ts`)
|
|
- [x] 5. 자동매매창 레이아웃 개선: 모달 높이 잘림을 없애고(내부 스크롤), 섹션 구조를 간결화했다. (`features/autotrade/components/AutotradeControlPanel.tsx`)
|
|
|
|
[사용할 MCP/Skills]
|
|
- MCP: shell_command, apply_patch, playwright
|
|
- Skills: dev-auto-pipeline, dev-plan-writer, dev-mcp-implementation, dev-refactor-polish, dev-test-gate, dev-plan-completion-checker, nextjs-app-router-patterns, vercel-react-best-practices
|
|
|
|
[참조 문서(common-docs)]
|
|
- common-docs/api-reference/openapi_all.xlsx
|
|
- common-docs/api-reference/kis_api_reference.md
|
|
- common-docs/api-reference/kis-error-code-reference.md
|
|
- common-docs/features/trade-stock-sync.md
|
|
- common-docs/ui/GLOBAL_ALERT_SYSTEM.md
|
|
|
|
[주석/문서 반영 계획]
|
|
- 데이터 흐름 주석: "입력 데이터 확장" 구간에 [Step 1]/[Step 2]를 추가한다.
|
|
- UI 주석: 모달 섹션을 상단 요약/설정 본문/하단 액션으로 분리해 가독성을 유지한다.
|
|
- 박스권 기법 주석: 조건(상승폭, 박스 범위, 상하단 근접)과 신호 방향을 한글로 명확히 남긴다.
|
|
|
|
[리스크/회귀 포인트]
|
|
- 스냅샷 필드 확장 시 signal 라우트 zod 스키마 불일치가 발생할 수 있다.
|
|
- 유명기법 미선택 허용 이후에도 과도한 신호가 나오지 않게 fallback 신호 품질을 확인해야 한다.
|
|
- 설정 모달 레이아웃 변경 시 모바일에서 버튼 접근/스크롤 충돌이 생길 수 있다.
|
|
|
|
[검증 계획]
|
|
- [x] 1. lint: 타입/린트 오류 없이 통과 (`npm run lint` 통과)
|
|
- [x] 2. build: 프로덕션 빌드 통과 (`npm run build` 통과)
|
|
- [x] 3. 동작: 기법 미선택 허용 코드 경로 확인 (`canStartAutotrade` 조건 완화, `prepareStrategy` 필수 체크 제거, compile 기본 기법 자동 적용)
|
|
- [x] 4. 동작: 박스권 단타 기법이 목록/enum/fallback 로직에 반영됨을 코드 경로 확인
|
|
- [x] 5. 동작: 설정 화면 스모크에서 신규 체크박스/설정 UI 접근 및 콘솔 치명 오류 없음 확인 (Playwright). 자동매매 설정 모달은 KIS 미연결 환경으로 직접 실행 검증은 제한
|
|
|
|
[진행 로그]
|
|
- 2026-03-05: 계획 문서 작성.
|
|
- 2026-03-05: 자동매매 스냅샷 확장(체결/호가/파생 지표) 및 signal API 스키마 동기화 완료.
|
|
- 2026-03-05: 유명기법 미선택 허용(기본 기법 자동 적용) 반영 완료.
|
|
- 2026-03-05: "상승 후 박스권 단타" 기법 추가 및 fallback 신호 로직 구현 완료.
|
|
- 2026-03-05: 자동매매 설정 모달 레이아웃 간소화/높이 잘림 개선(내부 스크롤) 적용.
|
|
- 2026-03-05: `npm run lint`, `npm run build` 통과.
|
|
- 2026-03-05: Playwright 스모크(`/trade`, `/dashboard`, `/settings`) 확인, 콘솔 치명 오류 없음.
|
|
|
|
[계획 대비 완료체크]
|
|
- 완료: 구현 1~5, 검증 1~5
|
|
- 부분 완료: 없음
|
|
- 미완료: 없음
|
|
- 최종 판정: 배포 가능
|