auto-trade/common-docs/improvement/plans/dev-plan-2026-03-05-autotrade-observability-momentum-scalp.md

[계획 문서 경로]

• common-docs/improvement/plans/dev-plan-2026-03-05-autotrade-observability-momentum-scalp.md

[요구사항 요약]

• 자동매매 로그에 AI 진행상태/응답 근거/주요 수치가 보이도록 개선한다.
• 자동매매에서 AI로 보내는 데이터 항목을 코드 기준으로 명확히 보여준다(로그/설명 근거 강화).
• 1분봉 상승구간 단타(눌림-재돌파) 기법을 새로 추가한다.

[가정]

• "좋은 데이터 로그"는 사용자 화면에서 즉시 확인 가능한 런타임 로그 품질 개선(단계, 공급자, 핵심 수치, AI 근거)으로 해석한다.
• AI 전송 데이터 "상세" 요구는 코드 반영(진단 로그) + 최종 보고에서 필드 목록/흐름 설명으로 충족한다.
• 신규 전략은 규칙 기반 fallback에서 즉시 동작하고, OpenAI/CLI 프롬프트 가이드에도 동일 기법명을 반영한다.

[영향 범위]

• 수정:
  • features/autotrade/types/autotrade.types.ts
  • features/autotrade/stores/use-autotrade-engine-store.ts
  • features/autotrade/hooks/useAutotradeEngine.ts
  • features/autotrade/components/AutotradeControlPanel.tsx
  • lib/autotrade/strategy.ts
  • lib/autotrade/openai.ts
  • app/api/autotrade/signals/generate/route.ts (필요 시)
  • common-docs/improvement/plans/dev-plan-2026-03-05-autotrade-observability-momentum-scalp.md
• 추가:
  • 없음
• 삭제:
  • 없음

[구현 단계]

• 1. 로그 타입 확장: 런타임 로그에 단계(stage)와 상세 데이터(detail)를 담을 수 있게 타입/스토어를 확장한다. (features/autotrade/types/autotrade.types.ts, features/autotrade/stores/use-autotrade-engine-store.ts)
• 2. 엔진 로그 강화: compile/signal/risk/order 흐름에서 "요청 전송", "AI 응답", "주문 차단/실행"을 구조화 로그로 남긴다. (features/autotrade/hooks/useAutotradeEngine.ts)
• 3. 로그 UI 개선: 상단 최근 로그 영역에서 단계/레벨/상세 데이터를 읽기 쉽게 표시한다. (features/autotrade/components/AutotradeControlPanel.tsx)
• 4. 상승구간 단타 기법 추가: 기법 enum/옵션 추가 + fallback 로직(추세 필터, 눌림 구간, 재돌파, 거래량 확인) 구현. (features/autotrade/types/autotrade.types.ts, lib/autotrade/strategy.ts)
• 5. OpenAI 가이드 반영: 신규 기법 설명과 판단 제약을 프롬프트에 반영한다. (lib/autotrade/openai.ts)

[사용할 MCP/Skills]

• MCP: shell_command, apply_patch, tavily-remote, playwright
• Skills: dev-auto-pipeline, dev-plan-writer, dev-mcp-implementation, dev-refactor-polish, dev-test-gate, dev-plan-completion-checker, 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

[외부 근거(전략 설계)]

• Investopedia Flag Pattern: 상승 추세 + 조정 중 거래량 축소 + 돌파 시 거래량 확인
• Investopedia Low Volume Pullback: 저거래량 눌림 후 추세 재개 확률
• Fidelity Technical Analysis(학습 PDF): 이동평균 기반 추세/눌림 해석, 거래량/모멘텀 보조 확인

[주석/문서 반영 계획]

• 함수 주석: [목적]/[데이터 흐름] 유지
• 상태 주석: 로그 stage/detail 도입 영향 표시
• 복잡 로직: 신규 상승구간 단타 판단 함수를 [Step 1~3] 주석으로 분리
• JSX 구역 주석: 로그 카드 영역을 단계/상세 구분 렌더링으로 분리

[리스크/회귀 포인트]

• 로그 데이터가 과도하면 UI 가독성이 저하될 수 있어 길이 제한/요약이 필요하다.
• 신규 전략이 기존 박스권 단타와 동시에 점수를 높여 과매수 신호가 늘 수 있어 임계값을 보수적으로 둔다.
• 타입 확장 시 기존 appendLog 호출과의 호환성을 유지해야 한다.

[검증 계획]

• 1. lint: 타입/린트 오류 없는지 확인 (npm run lint 통과)
• 2. build: Next 빌드 통과 확인 (npm run build 통과)
• 3. 동작: 자동매매 로그에 stage/detail이 표시되는지 코드 경로/UI 확인 (useAutotradeEngine 로그 작성 + AutotradeControlPanel 렌더 반영)
• 4. 동작: 신규 기법이 목록과 fallback 로직에 반영됐는지 확인 (intraday_breakout_scalp enum/옵션/룰 추가)
• 5. 동작: /trade 화면 스모크에서 콘솔 오류 없이 렌더링 확인 (Playwright). 비로그인 환경으로 /login 리다이렉트 확인, 콘솔 error 없음

[진행 로그]

• 2026-03-05: 계획 문서 작성.
• 2026-03-05: 런타임 로그 구조(stage/detail) 확장 및 로그 UI 상세표시 반영.
• 2026-03-05: 로그 UI를 기본 접힘(차트 가림 최소화) + 쉬운 문장 요약 + 개발자 상세 토글 + 라이브 커서 표시로 개선.
• 2026-03-05: AI 신호 요청/응답/리스크게이트/주문실행 흐름 구조화 로그 반영.
• 2026-03-05: 상승구간 눌림-재돌파 단타(intraday_breakout_scalp) 기법 추가.
• 2026-03-05: AI 신호 사유 한글 강제(프롬프트 + 서버 후처리) 반영.
• 2026-03-05: 상단 예산 카드에 검증 전 입력 기준 예산 표시 추가.
• 2026-03-05: 신호 API 호출을 in-flight 순차 처리로 변경(이전 응답 완료 전 재호출 차단).
• 2026-03-05: 상단 로그를 입력 -> 답변 1쌍 고정 표시로 개선(응답 대기 상태 포함).
• 2026-03-05: npm run lint, npm run build 통과.
• 2026-03-05: Playwright 스모크(/trade, /dashboard, /settings) 실행, 비로그인 리다이렉트 경로에서 콘솔 error 없음.

[계획 대비 완료체크]

• 완료: 구현 15, 검증 15
• 부분 완료: 없음
• 미완료: 없음
• 최종 판정: 배포 가능