Files
2026-05-23 15:11:48 +09:00

45 KiB
Raw Permalink Blame History

GoldenChart 사용자 매뉴얼

버전: 2026-05-21 기준
스택: Spring Boot + Ta4j (백엔드) · React + TypeScript + lightweight-charts (프론트엔드)


목차

  1. 앱 개요 및 시작
  2. 상단 메뉴바
  3. 실시간 차트 화면
  4. 투자전략 화면
  5. 백테스팅 이력 화면
  6. 설정 화면
  7. 드로잉 툴 상세 사용법
  8. 키보드 단축키 모음
  9. 미구현 기능 안내

1. 앱 개요 및 시작

GoldenChart는 업비트 암호화폐 거래소의 실시간 시세를 기반으로 차트 분석·투자전략 수립·백테스팅을 지원하는 웹 기반 트레이딩 도구입니다.

지원 데이터 소스

구분 방식 설명
업비트 마켓 REST (초기 300봉) + WebSocket (실시간 틱) KRW·BTC 마켓
기타 심볼 시뮬레이션 데이터 테스트용

초기 화면

앱 진입 시 실시간 차트 화면이 기본으로 표시됩니다. 상단 메뉴에서 다른 화면으로 전환할 수 있습니다.


2. 상단 메뉴바

화면 최상단에 항상 표시되는 글로벌 내비게이션 바입니다.

메뉴 항목 기능
GoldenChart (로고) 홈(실시간 차트)으로 이동
대시보드 미구현 (메뉴만 존재)
실시간차트 실시간 차트 화면으로 이동
투자전략 투자전략 빌더 화면으로 이동
백테스팅 백테스팅 이력 대시보드로 이동
설정 설정 화면으로 이동
테마 토글 (☀/🌙) 다크 → 블루 → 라이트 테마 순환, DB에 자동 저장
로그인 UI 버튼만 구현 (실제 인증 미연동)

3. 실시간 차트 화면

앱의 핵심 화면으로, 차트·지표·드로잉·백테스팅·실시간 전략 기능을 모두 포함합니다.


3.1 상단 툴바

좌측 컨트롤

버튼 기능
종목 검색 업비트 마켓 코드 검색 및 선택 (예: KRW-BTC)
워치리스트 관심종목 패널 펼치기/접기
타임프레임 1m / 3m / 5m / 15m / 30m / 1h / 4h / 1D / 1W / 1M 선택
차트 유형 캔들스틱 / 바 / 라인 / 영역 / 기준선
지표 추가 (Ind) 지표 선택 패널 열기 → 카테고리 탐색 또는 검색 후 클릭으로 추가
Undo / Redo 드로잉 되돌리기 / 다시 실행
자석 모드 크로스헤어 스냅 ON/OFF — ON 시 OHLCV 값에 자동 흡착
드로잉 전체 삭제 차트 위 모든 드로잉 오브젝트 제거
통계 패널 가격 통계 플로팅 창 열기
자동 피보나치 고점·저점 자동 피보나치 라인 표시 토글
그리드 차트 격자 표시 토글

차트 모드 전환

버튼 기능
차트뷰 기본 분석 모드 — 드로잉 툴 비활성, 스크롤/줌 최적화
트레이딩뷰 드로잉 모드 — 좌측 드로잉 툴바 활성화

백테스팅 버튼 그룹

⚠️ 싱글 차트 레이아웃 + 실시간 차트 페이지에서만 사용 가능합니다.

버튼 기능
백테스팅 전략 드롭다운 열기 — 전략 이름과 실행 버튼 목록 표시
설정 (⚙) 백테스팅 옵션 설정 모달 열기
결과 (📊) 마지막 백테스트 결과 대시보드 팝업
마커 삭제 (🗑) 차트에 표시된 매수/매도 마커 모두 제거
  • 전략 실행: 드롭다운에서 전략 우측 실행 버튼 클릭 → 현재 차트 캔들 데이터와 함께 백엔드로 전송 → 결과 마커 표시
  • 결과 자동 팝업: 설정 → 백테스팅에서 ON 시 실행 후 결과 팝업이 자동 열림

실시간 전략 체크 버튼

버튼 기능
LiveStrategy () 실시간 전략 체크 패널 열기/닫기

우측 컨트롤

버튼 기능
좌측 패널 토글 마켓 패널 접기/펼치기
돋보기 차트 돋보기(확대경) 오버레이 팝업
레이아웃 (⊞) 멀티 차트 레이아웃 선택 및 동기화 설정
맞춤 (F) 차트 전체 데이터 범위에 맞게 뷰 조정
실시간 스크롤 최신 캔들로 자동 따라가기 ON/OFF
가격 알림 (🔔) 가격 알림 추가·관리
스크린샷 차트 영역 이미지 저장
전체화면 브라우저 전체화면 전환

3.2 드로잉 툴바 (좌측)

트레이딩뷰 모드에서만 활성화됩니다.

툴바는 그룹별로 구성되며, 각 그룹 아이콘을 호버하면 하위 툴 플라이아웃이 펼쳐집니다.

드로잉 공통 조작

조작 설명
클릭 앵커 포인트 배치
더블클릭 / Enter 드로잉 완료 확정 (다중 점 툴)
Escape 현재 드로잉 취소
클릭 후 드래그 완성된 드로잉 이동
앵커 포인트 드래그 형태 조절
우클릭 설정·삭제 컨텍스트 메뉴

그룹 목록 및 하위 툴

그룹 주요 하위 툴
커서 선택/이동 (기본 탐색 모드)
라인 추세선, 확장선(Ray), 화살표, 수평선, 수직선, 수평 채널, 오름/내림 채널, 선형 회귀, 예측 조정
피보나치 되돌림, 확장, 채널, 타임존, 피치포크(중간·수정·쉬프), 갠 박스, 갠 팬
패턴 XABCD, 헤드앤숄더, 엘리엇 파동(ABC/WXYXZ), 사이퍼, 사이클 삼각형
프로젝션 롱/숏 포지션, 예측, 앵커드 VWAP, 고정 볼륨 프로파일, 바 패턴, 지그재그, 고스트 피드
도형 사각형, 회전 사각형, 원, 타원, 삼각형, 평행사변형, 다각형, 호
브러시 자유 붓, 하이라이터, 방향 화살표(위/아래)
텍스트 & 노트 텍스트, 노트(핀), 가격 노트, 콜아웃(말풍선), 고정 텍스트, 가격 라벨
측정 날짜·가격 범위, 데이터 창
확대/축소 돋보기(확대 뷰)

하단 고정 버튼

버튼 기능
자석 크로스헤어 스냅 강도 (끄기 / 약 / 강 / 지표 스냅)
잠금 완성된 드로잉 이동 불가 고정
눈 (가시성) 드로잉 숨김 / 지표 숨김 / 전체 숨김 토글
되돌리기 마지막 드로잉 작업 취소 (Ctrl+Z)
삭제 드로잉 삭제 / 지표 삭제 / 전체 삭제
레이어 오브젝트 트리 팝업 열기 (드로잉 목록 관리)

3.3 차트 본체 및 지표

기본 차트 조작

조작 설명
스크롤 좌우 시간축 이동 (왼쪽: 과거 데이터 자동 추가 로드)
마우스 휠 줌인/줌아웃
오른쪽 드래그 가격축 스케일 조절
F 키 데이터 전체 맞춤
L 키 로그 스케일 전환

무한 스크롤 (과거 데이터)

차트를 왼쪽으로 스크롤하여 맨 첫 번째 캔들에 도달하면 자동으로 과거 데이터를 요청합니다.

  • 인메모리(최근 300봉) 범위 → 즉시 반환
  • 인메모리 초과 → 업비트 REST API 프록시 조회

지표 추가 방법

  1. 상단 툴바 Ind 버튼 클릭
  2. 카테고리 탐색 또는 검색창에 지표 이름 입력
  3. 원하는 지표 클릭 → 차트에 즉시 추가

지표 설정

방법 설명
pane 호버 → 설정 아이콘 지표 파라미터·색상·선 스타일 설정
지표 pane 우클릭 설정·숨김·삭제 메뉴
더블클릭 (지표 pane) 설정 모달 바로 열기

지표 설정 항목

  • 기간: 이동평균 기간, 오실레이터 기간 등
  • 색상: 선 색상, 히스토그램 색상
  • 선 스타일: 실선, 점선, 대시
  • 선 굵기: 1~4px
  • 과열선 / 중앙선 / 침체선: 기준값·색상·스타일·굵기 개별 설정

지표 설정은 DB에 저장되어 앱 재실행 시에도 유지됩니다.

지원 지표 카테고리 (126개+)

카테고리 대표 지표
이동평균 SMA(5/8/20/60/120), EMA(12/26), WMA, DEMA, TEMA, HMA, VWMA 등
오실레이터 RSI, CCI, Stochastic, MACD, MFI, CMO, Williams %R, DPO, Aroon 등
추세 ADX, DMI, Parabolic SAR, 일목균형표, TRIX 등
변동성 볼린저 밴드, ATR, 켈트너 채널, Donchian 채널, Mass Index 등
거래량 OBV, Volume Oscillator, VWAP, Force Index, Chaikin MF 등
캔들 패턴 도지, 해머, 역망치, 봉선, 십자성, 삼병 등 44종

차트 범례 (Legend)

크로스헤어를 차트 위에 올리면 각 pane에 현재 바의 값이 표시됩니다.

  • 메인 pane: 날짜·시간, O/H/L/C, 거래량, 등락률
  • 지표 pane: 지표명, 계산된 값

3.4 멀티 차트 레이아웃

상단 툴바 우측 레이아웃(⊞) 버튼에서 분할 방식을 선택합니다.

레이아웃 설명
1분할 단일 차트 (기본)
2분할 (가로/세로) 좌우 또는 상하 2개
3~8분할 다양한 그리드 구성

슬롯 관리

  • 분할된 각 차트 슬롯을 클릭하여 활성화 (파란 테두리 표시)
  • 활성 슬롯에서 종목·타임프레임·지표 변경 가능
  • 슬롯 전체보기 버튼: 해당 슬롯을 싱글 화면으로 확대

동기화 옵션

옵션 설명
심볼 동기화 모든 슬롯이 같은 종목을 표시
인터벌 동기화 모든 슬롯이 같은 타임프레임 유지
크로스헤어 동기화 한 슬롯의 크로스헤어가 모든 슬롯에 연동
시간축 동기화 모든 슬롯의 시간 범위 동기화

3.5 좌측 마켓 패널

종목 목록과 실시간 호가를 표시합니다.

마켓 탭

표시 내용
원화 (KRW) KRW 마켓 전체 종목, 현재가·등락률·거래량
BTC BTC 마켓 (USD 환산 가격 포함)
보유 localStorage에 저장된 보유 종목
관심 즐겨찾기(★) 등록 종목
  • 종목 클릭: 활성 슬롯의 심볼 변경
  • ★ 버튼: 관심종목 등록/해제 (DB 동기화)
  • 가격 플래시: 가격 변동 시 녹색(상승)/빨강(하락) 배경 깜빡임

호가창 (OrderbookPanel)

패널 하단에 실시간 업비트 WebSocket 호가 데이터 표시.

영역 내용
매도 호가 가격(빨강), 잔량 바
현재가 중앙 강조 표시
매수 호가 가격(파랑), 잔량 바
스프레드 최우선 매도/매수 가격 차이

3.6 우측 패널

우측 접기/펼치기 버튼으로 개폐합니다.

상태
알림 UI 구조만 구현 (기능 미구현)
매수 UI 구조만 구현 (실제 주문 미연동)
매도 UI 구조만 구현 (실제 주문 미연동)

3.7 백테스팅 (차트 내)

투자전략 빌더에서 만든 전략을 현재 차트 데이터로 즉시 테스트합니다.

실행 방법

  1. 상단 툴바 백테스팅 버튼 클릭 → 전략 드롭다운 표시
  2. 원하는 전략 우측 실행 버튼 클릭
  3. 차트에 매수(▲ 초록), 매도(▼ 빨강) 마커 표시
  4. 결과 뱃지(시그널 수·승률·수익·MDD)가 상단에 표시

결과 확인

방법 설명
상단 뱃지 간략 결과 (거래 수, 승률, 총 수익률, MDD)
결과 버튼(📊) 상세 대시보드 팝업 (종합 지표·거래 이력·차트)
백테스팅 이력 메뉴 과거 실행 결과 이력 대시보드

상세 결과 지표

지표 설명
총 거래 수 전체 매수·매도 쌍의 수
승률 수익 발생 거래 비율
총 수익률 초기 자본 대비 최종 수익
최대 낙폭 (MDD) 고점 대비 최대 손실
평균 수익/손실 수익/손실 거래의 평균
Profit Factor 총 이익 / 총 손실
Sharpe Ratio 위험 조정 수익률
보유 기간 평균 포지션 유지 봉 수

마커 표시 옵션

  • 매수 마커: "매수" 한글 표시 (설정에서 금액 추가 표시 ON 시: "매수 : 1,000,000")
  • 매도 마커: "매도" 한글 표시
  • 마커 삭제: 툴바 🗑 버튼으로 전체 제거

3.8 실시간 전략 체크

선택한 전략 조건을 실시간으로 모니터링하여 매수/매도 시그널을 차트에 표시합니다.

패널 열기

상단 툴바 버튼 클릭 → LiveStrategyPanel 팝업 표시

설정 항목

항목 설명
실시간 체크 ON/OFF 토글 — ON 시 STOMP WebSocket 구독 시작
전략 선택 드롭다운에서 모니터링할 전략 선택
체크 방식 봉 마감 (CANDLE_CLOSE): 캔들 확정 시 판정 / 실시간 틱 (REALTIME_TICK): 3초 주기 판정
시그널 모드 보유 자산 기준 (LONG_ONLY): 매수 이력 있을 때만 매도 허용 / 순수 지표 기준 (SIGNAL_ONLY): 포지션 무관, 지표 충족 시 즉시 매도

마커 특징

  • 중복 방지: 동일 타임스탬프에 마커 무한 생성 방지 (Lock 메커니즘)
  • REALTIME_TICK: 같은 봉 내 동일 시그널 중복 표시 안 함

LONG_ONLY vs SIGNAL_ONLY

모드 매수 조건 매도 조건
LONG_ONLY 진입 규칙 충족 + 포지션 없을 때 청산 규칙 충족 + 포지션 있을 때
SIGNAL_ONLY 진입 규칙 충족 (포지션 무관) 청산 규칙 충족 (포지션 무관)

SIGNAL_ONLY 모드에서는 매도 시그널이 이전 매수 없이도 발생하므로 더 많은 마커가 표시됩니다.


3.9 매매 알림 팝업

실시간 전략 체크에서 BUY/SELL 시그널 발생 시 화면에 팝업을 표시합니다.

활성화 조건

설정화면 → 전략 설정 → 매매 알림 팝업 ON

팝업 구성

영역 내용
헤더 시그널 유형(매수/매도), 종목, 시각
요약 가격, 전략명, 실행 방식
매수 탭 주문 유형(지정가/시장가/예약), 가격·수량 입력, 비율 버튼
매도 탭 동일 구성
간편주문 탭 미구현 안내
거래내역 탭 미구현 안내

⚠️ 주문 탭의 주문 버튼은 실제 거래소 API와 연동되지 않습니다. 프로토타입 UI입니다.

팝업은 화면 어디서나 드래그하여 이동 가능합니다.


3.10 기타 플로팅 패널

오브젝트 트리

드로잉 툴바 하단 레이어 버튼 → 드로잉 오브젝트 목록 팝업

  • 드로잉 이름 목록 표시
  • 눈 아이콘으로 개별 표시/숨김
  • 휴지통 아이콘으로 개별 삭제

통계 패널 (StatsPanel)

상단 툴바 통계 버튼 → 가격 통계 플로팅 창

  • 선택 기간 OHLCV 통계 표시

관심종목 (WatchList)

  • 즐겨찾기 등록 종목 목록
  • 현재가·등락률 표시
  • 클릭 시 차트 심볼 변경
  • DB에 동기화

가격 알림 (AlertManager)

상단 툴바 🔔 → 알림 패널

  • 특정 가격 도달 시 알림 설정
  • 현재 알림 목록 관리 (추가/삭제)
  • 차트에 수평선 표시

3.11 화면 내 설정·모달

실시간 차트 화면에서 설정 화면(메뉴 → 설정) 이 아닌, 차트 위에서 바로 열리는 설정 UI입니다.

설정 열기 방법 요약

설정 종류 열기 방법
메인 차트(캔들) 색상 차트 우클릭 → 설정, 또는 메인 pane 설정
지표 지표 pane 호버 → ⚙ / 우클릭 → 설정 / pane 더블클릭
드로잉 완성된 드로잉 우클릭 → 설정
피보나치 타임존 피보나치 TZ 드로잉 우클릭 → 설정
백테스팅 (빠른) 툴바 백테스팅 ⚙ → 모달 (설정 화면과 동일 DB 연동)
실시간 전략 툴바 LiveStrategyPanel (설정 화면 전략 탭과 DB 공유)
가격 알림 툴바 🔔AlertManager
멀티 레이아웃 동기화 툴바 ⊞ → 레이아웃 팝업 내 동기화 체크박스

메인 차트 설정 (MainChartSettingsModal)

항목 설명 저장
몸통 (Body) 상승봉·하락봉 몸통 색 (좌=상승, 우=하락) DB (gc_app_settings.mainChartStyle)
테두리 (Borders) 캔들 테두리 색 동일
심지 (Wick) 꼬리(심지) 색 동일
기본값 앱 기본 캔들 색으로 복원
확인 / 취소 적용 또는 변경 취소

설정 화면 차트 설정의 색상 항목과 별도입니다. 차트 설정 탭은 현재 로컬 상태만이며, 실제 차트에 반영되는 캔들 색은 이 모달·DB 값이 우선합니다.


지표 설정 (IndicatorSettingsModal)

탭: 입력값 · 스타일 · 가시성

항목 설명 저장
입력값 기간·소스 등 지표별 params (예: RSI 기간 14, 소스 close) DB (지표별 설정)
입력값 SMA 전용 MA1~MA8 각각 ON/OFF + 기간, 공통 소스 DB
입력값 일목 전용 전환선·기준선·선행스팬 기간 등 DB
스타일 플롯 선 색·굵기·유형(선/히스토그램/영역 등) DB
스타일 수평선 과열선·중앙선·침체선 가격·색·선형·굵기·표시 여부 DB
스타일 일목 구름 상승/하락 구름 색·투명도 DB
가시성 플롯별 개별 선/히스토그램 표시 ON/OFF DB
기본값 지표 레지스트리 기본값으로 복원

소스(src) 옵션: close, open, high, low, hl2, hlc3, ohlc4

전략 빌더에서 지표를 추가할 때, 현재 차트에 적용된 지표 설정값(기간·과열/침체선 포함)이 전략 조건의 기본값으로 복사됩니다.


드로잉 설정 (DrawingSettingsModal)

항목 설명 비고
색상 프리셋 20색 + 커스텀 컬러 피커 모든 드로잉 공통
선 굵기 1~4px text·measure 유형 제외
선 스타일 실선 / 파선 / 점선 text·measure 제외
텍스트 표시 문구 (text 타입만)

드로잉 데이터는 차트·종목·타임프레임별로 저장됩니다.


피보나치 타임존 설정 (FibTZSettingsModal)

항목 설명
레벨 목록 각 피보나치 비율(%)·표시 여부·색·선형·굵기
기준선 0%/100% 기준선 스타일
확장 TZ 구간 연장 옵션

백테스팅 빠른 설정 (BacktestSettingsModal)

차트 툴바 ⚙ 로 열리는 모달입니다. 설정 화면 → 백테스팅과 동일한 BacktestSettingsDto를 DB에 저장합니다. 각 필드에 ? 도움말(상세 설명)이 붙어 있습니다.

구역 항목 요약
표시 결과 자동 팝업 실행 후 결과 대시보드 자동 오픈 (AppSettings, DB)
표시 매수/매도 금액 표시 마커 문구에 금액 포함 여부 (AppSettings, DB)
자본 초기 자본·거래 규모 시뮬레이션 자금·비율/고정금액
비용 수수료·슬리피지 LINEAR/ZERO, 체결 가격 미끄럼
가격 진입/청산/방향 종가 vs 다음봉 시가, LONG/SHORT/BOTH
리스크 손절·익절·트레일링 Ta4j 규칙 연동
기타 재진입·분할청산·포지션 모드 6.3절 참고

실시간 전략 패널 (LiveStrategyPanel)

설정 화면 전략 설정 → 실시간 전략 체크동일 DB(gc_live_strategy_settings, 종목별)를 사용합니다. 한쪽에서 변경하면 다른 쪽에도 반영됩니다.

항목 설명
실시간 체크 ON 시 백엔드 STOMP 구독·시그널 평가 시작
전략 선택 투자전략 빌더에 저장된 전략 ID
실행 방식 봉 마감 직후 / 실시간 틱(3초) — 설정 화면의 체크 방식과 동일
시그널 모드 Long-Only / Signal-Only — 설정 화면 포지션 종속성 모드와 동일

설정 변경 시 기존 차트 마커는 자동 초기화됩니다.


가격 알림 (AlertManager)

항목 설명 저장
가격 알림을 받을 목표가 (숫자) 세션/앱 상태
메모 선택 라벨 동일
추가 목록에 알림 등록, 차트 수평선 표시
삭제 항목별 ✕

설정 화면 알림 설정의 가격 알림 토글과는 아직 연동되지 않았습니다. 실제 알림 발송은 미구현입니다.


멀티 차트 레이아웃 동기화

툴바 팝업에서 설정합니다. AppSettings.syncOptions에 DB 저장됩니다.

옵션 동작
심볼 동기화 모든 슬롯 종목 통일
인터벌 동기화 타임프레임 통일
크로스헤어 동기화 커서 위치 연동
시간축 동기화 보이는 시간 범위 연동

테마

상단 메뉴바 ☀/🌙 클릭 시 다크 → 블루 → 라이트 순환. AppSettings.defaultTheme에 DB 저장됩니다.


4. 투자전략 화면

전략 조건을 시각적으로 구성하고 DB에 저장하는 빌더 화면입니다.

화면 구성

[좌: 전략 목록] | [중: 조건 편집기] | [우: 팔레트/미리보기]

전략 목록 (좌측)

기능 설명
새 전략 빈 전략 생성
전략 선택 클릭 시 편집기에 로드
정렬 이름 / 날짜 정렬
삭제 체크박스로 선택 후 삭제
저장 편집 내용 DB 저장

전략은 DB에 저장되며, 로컬스토리지(gc_strat_v2) 백업도 유지됩니다.

조건 편집기 (중앙)

논리 트리 구조

노드 타입 설명
AND 모든 하위 조건 동시 충족
OR 하위 조건 중 하나라도 충족
NOT 하위 조건 부정
CONDITION 실제 지표 비교 조건

조건 타입

타입 설명
비교 (GREATER/LESS/EQUAL) A > B, A < B, A == B
상향 돌파 (CROSS_UP) A가 B를 아래에서 위로 교차
하향 돌파 (CROSS_DOWN) A가 B를 위에서 아래로 교차
N일 유지 조건이 N봉 동안 연속 충족
기울기 (SLOPE_UP/DOWN) 지표값이 상승/하강 추세
일목 구름 (KUMO_ABOVE/BELOW) 가격이 구름 위/아래

조건 편집

  • 드래그앤드롭: 조건 순서 변경
  • 노드 추가: AND/OR/NOT/CONDITION 노드 추가 버튼
  • 우클릭: 조건 삭제
  • 매수/매도 탭: 각각 별도 조건 트리 구성

컴포넌트 팔레트 (우측)

내용
지표 팔레트 사용 가능한 지표 목록, 클릭 또는 드래그로 편집기에 추가
전략 목록 저장된 전략 목록
템플릿 골든크로스, RSI 과매도 등 자동 생성 템플릿
미리보기 구성한 조건의 수식 텍스트 미리보기

지표 파라미터

전략에서 지표를 추가하면 현재 차트 지표 설정값이 기본값으로 적용됩니다.

  • 예: 차트 CCI 기간이 15이면 전략 CCI 기간도 15로 초기화
  • 과열선/중앙선/침체선 설정값도 반영

4.1 화면 내 설정

투자전략 화면 자체에는 별도의 “환경설정” 메뉴가 없습니다. 대신 아래 항목이 전략 데이터·차트 설정과 연동됩니다.

기능 설정·연동 내용 저장 위치
지표 파라미터 조건 노드에 붙은 지표는 차트 지표 설정(DB)을 초기값으로 사용 gc_indicator_settings
전략 저장 매수/매도 조건 트리, 이름 DB + localStorage 백업
템플릿 적용 골든크로스·RSI 등 프리셋 조건 일괄 생성 — (저장 전까지 메모리)
정렬 이름/날짜 — UI만, 데이터 변경 없음

백테스팅·실시간 체크에 쓰이는 포지션 모드·수수료·체크 방식 등은 6.3·6.4에서 설정합니다.


5. 백테스팅 이력 화면

상단 메뉴 백테스팅 클릭 → 백테스팅 실행 이력 대시보드

화면 구성

[좌: 이력 목록] | [우: 선택된 결과 대시보드]

이력 목록 (좌측)

기능 설명
목록 표시 실행 일시, 전략명, 종목, 시그널 수, 승률
체크박스 다중 선택
삭제 선택 항목 삭제
전체 삭제 전체 이력 삭제
새로고침 목록 갱신

결과 대시보드 (우측)

이력 목록에서 항목 클릭 시 오른쪽에 상세 결과가 카드 형태로 표시됩니다.

카드 표시 내용
기본 정보 전략명, 종목, 실행 시각, 기간
핵심 지표 총 거래 수, 승률, 총 수익률
손익 분석 평균 수익, 평균 손실, Profit Factor
리스크 지표 MDD, Sharpe Ratio, Calmar Ratio
거래 통계 최대 연속 이익/손실, 평균 보유 기간

6. 설정 화면

상단 메뉴 설정 클릭 → macOS 스타일 2열 레이아웃 (좌: 카테고리 / 우: 설정 패널).

카테고리 주요 내용
일반 설정 언어·시작 화면·UI 동작
차트 설정 캔들 색·격자·자석·가격축
백테스팅 시뮬레이션 자본·비용·리스크·포지션 모드
전략 설정 실시간 체크·알림 팝업·리스크·백테스트 기본값(UI)
알림 설정 알림 채널·조건 (미연동)
네트워크 API·WebSocket·연결 테스트

6.0 설정 화면 개요 및 저장 범위

설정값이 어디에 저장되는지에 따라 앱을 재시작해도 유지되는 항목이 달라집니다.

저장 위치 적용 항목 재시작 후
DB (gc_app_settings) 테마, 백테스트 팝업/마커 표시, 매매 알림 팝업, 멀티차트 동기화, 메인 차트 스타일 유지
DB (gc_backtest_settings) 백테스팅 시뮬레이션 전 항목 유지
DB (gc_live_strategy_settings, 종목별) 실시간 체크·전략·체크 방식·포지션 모드 유지
DB (지표별) 지표 입력값·스타일 유지
컴포넌트 상태만 (일반·차트·알림·네트워크 탭 대부분) 언어, 차트 색(설정 탭), 알림 토글 등 초기화
localStorage 전략 백업, deviceId, 일부 앱 상태 유지

변경 시 자동 저장되는 패널: 백테스팅(저장 중/✓ 저장됨 표시), 실시간 전략(토글·선택 즉시 API 호출).


6.1 일반 설정

⚠️ 이 탭의 값은 React 컴포넌트 내부 상태만 갱신합니다. DB·localStorage에 저장되지 않아 페이지 새로고침 시 초기값으로 돌아갑니다.

언어 및 지역

항목 UI 컨트롤 선택값 상세 설명
언어 드롭다운 한국어 / English / 日本語 UI 문자열 언어(현재 다국어 리소스 연동은 제한적).
날짜 형식 드롭다운 YYYY-MM-DD, DD/MM/YYYY, MM/DD/YYYY 차트 축·팝업 등 날짜 표기 형식.
시간대 드롭다운 Asia/Seoul, UTC, America/New_York 차트 시간·알림 기준 시간대.

시작 화면

항목 선택값 상세 설명
시작 페이지 대시보드 / 실시간 차트 / 투자 전략 / 백테스팅 앱 최초 진입 시 열릴 화면(라우팅 연동 미완 — UI만).

UI 동작

항목 컨트롤 상세 설명
애니메이션 토글 화면 전환·차트 업데이트 애니메이션 사용 여부.
툴팁 표시 토글 버튼·지표에 마우스 오버 시 설명 툴팁 표시.

6.2 차트 설정

⚠️ 캔들 색상은 이 탭보다 3.11 메인 차트 설정 모달(DB 저장)이 실제 차트에 반영됩니다.
자석 모드만 앱 전역(magnetMode)과 연동되어 즉시 적용됩니다.

캔들 색상

항목 컨트롤 기본값 예 상세 설명
상승 캔들 색상 컬러 피커 + HEX #26a69a 양봉 몸통 색(설정 탭 — 로컬만).
하락 캔들 색상 컬러 피커 #ef5350 음봉 몸통 색.
배경 색상 컬러 피커 #131722 차트 plot 배경.

차트 표시 옵션

항목 컨트롤 상세 설명
격자선 표시 토글 수평·수직 격자선 ON/OFF. 툴바 그리드 버튼과 유사 목적.
거래량 표시 토글 하단 volume pane 표시.
크로스헤어 모드 드롭다운: 기본 / 마그넷 / 숨기기 십자선 표시 방식.
자석모드 (Magnet Mode) 토글 ON → strong, OFF → off. 십자선이 OHLC에 스냅되어 드로잉·분석 정밀도 향상. 드로잉 툴바 하단 자석(끄기/약/강/지표)과 별도 — 여기는 단순 ON/OFF.

가격축

항목 선택값 상세 설명
가격축 위치 우측 / 좌측 / 양쪽 가격 눈금자 배치.
소수점 자리수 0 / 2 / 4 / 8자리 Y축·범례 가격 소수 표시. BTC 등 고가·저가 코인에 8자리 유용.

6.3 백테스팅 설정

DB (gc_backtest_settings)에 자동 저장됩니다. 차트 툴바에서 백테스팅 실행 시 이 설정이 백엔드 BacktestingService에 전달됩니다. 차트 ⚙ 모달과 동일 데이터입니다.

시스템 기본값 (초기화 시):

항목 기본값
초기 자본 10,000,000원
수수료 LINEAR 0.15% (0.0015)
슬리피지 0.05% (0.0005)
진입/청산 가격 종가(CLOSE)
포지션 방향 LONG
거래 규모 자본 100%
포지션 모드 LONG_ONLY

표시 설정

항목 저장 상세 설명
결과 팝업 자동 표시 AppSettings.btAutoPopup (DB) ON: 실행 완료 후 결과 대시보드 자동 오픈. OFF: 툴바 결과(📊) 수동 클릭.
매수/매도 금액 표시 AppSettings.btShowPrice (DB) ON: 마커 "매수 : 1,234,000" 형식. OFF: "매수" / "매도"만.

자본 · 거래 규모

항목 입력 범위 상세 설명
초기 자본 (원) 최소 100,000, step 1,000,000 시뮬레이션 시작 자금. 총 수익률·최종 자산 계산 기준.
거래 규모 유형 CAPITAL_PCT / FIXED_AMOUNT 비율: 복리 반영. 고정: 매 거래 동일 원화.
사용 자본 비율 (%) 1~100 (비율 모드) 예: 50 → 가용 자본의 절반만 매수에 사용.
거래당 금액 (원) (고정 모드) 예: 1,000,000 → 매 신호마다 100만원 규모 체결 가정.

비용 모델

항목 상세 설명
수수료 유형 LINEAR 체결금액 × 수수료율. 매수·매도 각 1회 차감.
수수료 유형 ZERO 수수료 없음. 순수 전략 성과만 비교할 때.
수수료율 (%) UI는 % 입력, 내부는 소수 저장. 업비트 현물 약 0.05% 권장.
슬리피지 (%) 매수는 더 비싸게, 매도는 더 싸게 체결되는 가정. 변동성·유동성 반영용.

거래 가격 기준

항목 옵션 상세 설명
진입 가격 기준 CLOSE / NEXT_OPEN CLOSE: 신호 봉 종가 즉시 진입(단순, look-ahead 논란 가능). NEXT_OPEN: 다음 봉 시가 — 실매매에 가깝게.
청산 가격 기준 CLOSE / NEXT_OPEN 매도 신호 시 청산 가격 동일 논리.
포지션 방향 LONG / SHORT / BOTH LONG: 매수→매도. SHORT: 공매도 시뮬. BOTH: 신호에 따라 양방향.

리스크 관리 (Ta4j 규칙)

전략 매도 조건보다 먼저 손절·익절·트레일링이 발동하면 해당 규칙으로 청산됩니다.

항목 활성화 시 상세 설명
손절 활성화 + 손절 비율 (%) StopLossRule 진입가 대비 N% 하락 시 강제 청산. 예: 2% → 100만원 매수 후 98만원 이하.
익절 활성화 + 익절 비율 (%) StopGainRule 진입가 대비 N% 상승 시 이익 실현.
트레일링 스탑 + 비율 (%) TrailingStop 보유 중 최고가 대비 N% 하락 시 청산. 추세 추종형 손절.

재진입 · 분할 청산

항목 상세 설명
재진입 대기 봉 수 매도 후 N봉 동안 신규 매수 금지. 0 = 즉시 재진입 허용.
최대 동시 포지션 동시 보유 포지션 상한(현재 엔진은 단일 포지션 중심).
분할 청산 활성화 첫 매도 신호에 포지션 일부만 청산.
1차 청산 비율 (%) 분할 청산 시 첫 번에 팔 비율(기본 50%).

포지션 종속성 모드 (백테스팅)

가로 2열 카드 라디오로 선택합니다.

모드 매수 시그널 매도 시그널 권장 용도
보유 자산 기준 (Long-Only) 진입 규칙 + 포지션 없음 청산 규칙 + 포지션 있음 실제 롱 포지션 추적, 수익률·승률 해석
순수 지표 기준 (Signal-Only) 진입 규칙 (포지션 무관) 청산 규칙 (포지션 무관) 지표 신호 전부 차트에 표시, 알림·분석용

Signal-Only 선택 시 경고 문구: 「매도 시그널이 이전 매수 없이도 발생합니다」

백테스팅·실시간 체크·StrategySignalDeterminer가 동일 개념을 공유합니다. 자세한 동작은 백테스팅 시그널 동작방식.md 참고.


6.4 전략 설정

실시간 체크·알림 팝업은 DB 저장. 리스크 관리·백테스팅 기본값 카드는 UI만(백테스팅 탭 DB 설정과 아직 미연동).


실시간 전략 체크 (gc_live_strategy_settings, 종목별)

항목 컨트롤 상세 설명
실시간 체크 토글 ON: 백엔드가 선택 전략을 지속 평가, STOMP로 BUY/SELL 푸시, 차트 마커 표시. OFF: 평가 중단. 변경 시 기존 마커 삭제.
모니터링 종목 읽기 전용 텍스트 현재 실시간 차트 활성 종목(예: KRW-BTC). 종목 바꾸면 해당 종목 설정 레코드 로드.
전략 선택 드롭다운 투자전략 빌더에 저장된 전략. 미선택 시 모니터링 대기 상태.
체크 방식 가로 2열 라디오 아래 표 참고.
모니터링 상태 바 (체크 ON 시) 선택 전략명 + 펄스 표시.

체크 방식

라벨 동작
CANDLE_CLOSE 봉 마감 직후 완성된 직전 봉 기준, 봉당 최대 1회 판정. 확정 신호에 적합.
REALTIME_TICK 실시간 틱 (3초) 진행 중인 봉 포함, 약 3초마다 재판정. 같은 봉·같은 방향 중복 마커 방지.

포지션 종속성 모드 (실시간)

동작 요약
LONG_ONLY 매수 이력(포지션) 있을 때만 매도 마커
SIGNAL_ONLY 지표 청산 규칙만 충족해도 매도 마커 (매수 없이도 가능)

LiveStrategyPanel과 설정·DB가 동일합니다. 3.11절 참고.


매매 알림 팝업

항목 저장 상세 설명
알림 팝업 AppSettings.tradeAlertPopup (DB) ON: 실시간 체크 BUY/SELL 시 TradeAlertModal 자동 표시. OFF: 마커만 표시.

팝업 내 주문 탭은 UI 프로토타입이며 실제 거래소 API 미연동.


리스크 관리 (2열 카드)

⚠️ 입력값은 화면 상태만 유지. 백테스팅 DB·실시간 엔진에 아직 반영되지 않습니다.

항목 설명
기본 리스크 비율 (%) 진입 시 자본 대비 리스크 비율(계획 값).
최대 동시 포지션 동시 보유 포지션 수 상한.
트레일링 스탑 수익 구간에서 손절선 상향 조정 여부.
재진입 허용 청산 후 동일 조건 재진입 허용.

백테스팅 기본값 (2열 카드)

⚠️ 백테스팅 카테고리(6.3)의 DB 설정과 별개 UI입니다. 현재 저장 API 없음.

항목 설명
수수료율 (%) 표시용 기본 수수료.
슬리피지 (%) 표시용 기본 슬리피지.
성과 지표 기준 샤프 비율 / 총 손익률 / 승률 / 최대 낙폭 — 전략 비교 기준(미연동).

6.5 알림 설정

⚠️ UI만 구현. 토글·이메일·쿨다운 변경은 저장되지 않으며, 실제 소리·푸시·이메일 발송 로직 없음.
차트 가격 알림(🔔) 은 별도 패널로 동작(목록·수평선만, 발송 없음).

알림 방식

항목 상세 설명
사운드 알림 조건 충족 시 효과음(미구현).
브라우저 알림 Notification API OS 푸시(미구현).
이메일 알림 ON 시 이메일 주소 입력 행 표시. SMTP 발송(미구현).

알림 조건

항목 상세 설명
가격 알림 목표가 도달 알림 허용 플래그(미연동).
매매 신호 알림 전략 BUY/SELL 시 알림(미연동 — 팝업은 6.4 알림 팝업 사용).
알림 재발송 대기 (초) 동일 조건 반복 방지 쿨다운. 0~3600.

6.6 네트워크 설정

⚠️ 입력값은 컴포넌트 상태만. 실제 backendApi base URL은 빌드·환경 변수에 따르며, 이 화면 변경이 API 클라이언트에 자동 반영되지 않을 수 있습니다. 연결 테스트만 입력 URL로 fetch합니다.

API 서버

항목 기본값 예 상세 설명
서버 주소 http://localhost:8080 REST API 호스트(포트 포함).
연결 상태 ● 연결됨/끊김 배지 UI 표시용(자동 갱신 제한적).
연결 테스트 버튼 {서버주소}/actuator/health GET → 성공/실패 alert.

WebSocket

항목 기본값 예 상세 설명
WebSocket 주소 ws://localhost:8080/ws 실시간 시세·전략 시그널 STOMP 엔드포인트.

연결 설정

항목 상세 설명
연결 타임아웃 (ms) 응답 없을 때 요청 중단 시간. 기본 10000.
재시도 횟수 실패 시 재시도 상한. 0~10.
프록시 URL 비우면 직접 연결. 예: http://proxy:8888

7. 드로잉 툴 상세 사용법

모든 드로잉 툴은 트레이딩뷰 모드에서만 동작합니다.

라인 그룹

클릭 횟수 설명
추세선 2클릭 두 점을 연결하는 선, 양쪽 무한 연장 없음
확장선 (Ray) 2클릭 한 방향으로 무한 연장
화살표 2클릭 끝점에 화살촉 표시
수평선 1클릭 클릭한 가격에 수평선
수직선 1클릭 클릭한 시간에 수직선
채널 (수평/오름/내림) 3클릭 평행한 두 선으로 채널 구성
선형 회귀 2클릭 지정 구간의 최소자승 추세선

피보나치 그룹

클릭 횟수 설명
피보나치 되돌림 2클릭 0%~100% 사이 피보나치 레벨 (23.6, 38.2, 50, 61.8, 78.6%)
피보나치 확장 3클릭 추세 연장 목표가 레벨
피보나치 채널 3클릭 대각선 기반 피보나치 채널
피보나치 타임존 2클릭 시간축 기반 피보나치 구간
피치포크 3클릭 앤드류 피치포크 메디안 라인
갠 박스 2클릭 갠 이론 기반 사각형 격자
갠 팬 2클릭 갠 각도 팬 라인 (1×1, 1×2, 2×1 등)

패턴 그룹

클릭 횟수 설명
XABCD 패턴 5클릭 하모닉 XABCD 패턴
헤드앤숄더 7클릭 머리어깨 패턴
엘리엇 파동 (ABC) 4클릭 엘리엇 3파 조정
엘리엇 파동 (WXYXZ) 6클릭 엘리엇 복합 조정

프로젝션 그룹

설명
롱 포지션 진입가·목표가·손절가로 수익/손실 시각화 (초록 영역/빨강 영역)
숏 포지션 숏 방향 포지션 시각화
앵커드 VWAP 지정 시점부터의 거래량 가중 평균 가격
고정 볼륨 프로파일 지정 구간의 가격대별 거래량 분포
지그재그 고점·저점을 연결하는 지그재그 패턴

도형 그룹

클릭 횟수 설명
사각형 2클릭 대각선 두 점으로 사각형
회전 사각형 3클릭 회전 각도 조절 가능 사각형
2클릭 중심점 + 반지름 원
타원 2클릭 타원
삼각형 3클릭 삼각형
평행사변형 3클릭 평행사변형
다각형 N클릭 + 더블클릭 자유 다각형
3클릭 원호

텍스트 & 노트 그룹

설명
텍스트 차트 위 자유 텍스트
노트(핀) 핀 아이콘 + 메모 텍스트
가격 노트 가격축에 연결된 노트
콜아웃 말풍선 형태의 주석
가격 라벨 특정 가격을 라벨로 표시

측정 그룹

설명
날짜·가격 범위 드래그 구간의 가격 변동량·기간·비율 표시
데이터 창 클릭 지점의 OHLCV 데이터 팝업 표시

확대/축소 그룹

설명
돋보기 차트 일부를 확대한 오버레이 팝업 표시

돋보기 팝업은 팝업 어디서나 드래그하여 이동할 수 있습니다.


8. 키보드 단축키 모음

단축키 기능
F 차트 전체 맞춤 (Fit)
L 로그 스케일 전환
Escape 현재 드로잉 취소 / 선택 해제
Ctrl + Z 드로잉 되돌리기 (Undo)
Ctrl + Y 드로잉 다시 실행 (Redo)
Delete 선택된 드로잉 삭제
Alt + S 차트 스크린샷 저장
Enter 다중 점 드로잉 확정

9. 미구현 기능 안내

현재 UI는 구성되어 있지만 기능이 완전히 구현되지 않은 항목입니다.

기능 상태 비고
대시보드 메뉴 UI 없음 상단 메뉴에만 존재
로그인/회원가입 버튼만 실제 인증 미연동
우측 패널 알림/매수/매도 플레이스홀더 실제 거래소 API 미연동
TradeAlertModal 주문 UI 프로토타입 실제 주문 API 미연동
알림 설정 (설정 화면) UI만 발송·저장 미구현
일반 설정 로컬 상태만 DB 저장 미구현
차트 설정 탭(색상 등) 로컬 상태만 실제 캔들 색은 메인 차트 설정 모달·DB
전략 설정 — 리스크/백테스트 기본값 카드 UI만 백테스팅 DB와 미연동
네트워크 설정 UI만 API 클라이언트 자동 반영 제한적
멀티차트 백테스팅 비활성 싱글 레이아웃에서만 동작

문서 최종 업데이트: 2026-05-21
프로젝트: GoldenChart (/Users/macbook/dev/goldenChart)