auto-trade/common-docs/improvement/plans/dev-plan-2026-02-26-autotrade-cash-balance-fix.md

자동매매 가용자산 0원 차단 보완 계획

[계획 문서 경로]

• common-docs/improvement/plans/dev-plan-2026-02-26-autotrade-cash-balance-fix.md

[요구사항 요약]

• 자동매매 검증에서 가용 자산 0원으로 차단되는 문제를 보완한다.
• 내 계좌 기준으로 매수가능금액을 추가 조회해 검증 금액에 반영한다.
• 기존 리스크 검증/주문 흐름은 유지한다.

[가정]

• KIS 인증/계좌번호는 이미 설정되어 있다.
• selectedStock의 종목코드와 가격 정보는 자동매매 시작 시점에 확보 가능하다.

[영향 범위]

• 수정: features/autotrade/hooks/useAutotradeEngine.ts
• 수정: features/trade/apis/kis-stock.api.ts
• 수정: features/trade/types/trade.types.ts
• 수정: lib/kis/trade.ts
• 추가: app/api/kis/domestic/orderable-cash/route.ts

[구현 단계]

• 1. KIS 매수가능금액 조회 서버 라우트 추가
• 2. 프론트 API 클라이언트/타입 추가
• 3. 자동매매 prepareStrategy에서 cashBalance 0원 보정 로직 추가
• 4. 로그/주석 보강

[사용할 MCP/Skills]

• Skills: dev-auto-pipeline, dev-mcp-implementation, dev-refactor-polish, dev-test-gate, dev-plan-completion-checker

[참조 문서(common-docs)]

• common-docs/api-reference/kis_api_reference.md
• common-docs/api-reference/kis-error-code-reference.md

[리스크/회귀 포인트]

• 매수가능금액 조회 실패 시 기존 cashBalance만 사용하도록 폴백 필요
• 종목가격이 0 또는 비정상일 때 조회 파라미터 보정 필요

[검증 계획]

• 1. lint 통과
• 2. build 통과
• 3. autotrade smoke 테스트 통과

[진행 로그]

• 2026-02-26: 계획 문서 생성
• 2026-02-26: /api/kis/domestic/orderable-cash 라우트 및 executeInquireOrderableCash 구현
• 2026-02-26: 자동매매 prepareStrategy에서 cashBalance 0원 시 매수가능금액 보정 로직 반영
• 2026-02-26: npx eslint ... 통과
• 2026-02-26: npm run build 통과
• 2026-02-26: smoke 테스트는 현재 3001 실행 프로세스가 dev bypass를 허용하지 않는 환경으로 로그인 필요 응답 확인(추가 환경 정리 후 재실행 필요)