SYSTEM BLUEPRINT

방어형 자동매매
운영 화면 설계

제안서의 중앙 주문 큐, 킬스위치, 동면, 백테스트 전략이 실제 화면에서 어떻게 동작하는지 증명하는 설계도입니다.

운용자 시나리오

평시 리밸런싱 운용 흐름

운용자는 자산 상태를 확인하고, 바구니 판단을 검토한 뒤 중앙 큐를 통해 안전하게 주문을 예약합니다. 데모 1단계와 2단계로 이어집니다.

1. 현황 확인

총 자산과 모드
위험 알림 확인

2. 바구니 판단

비중 이탈과
주문 후보 검토

3. 큐 예약

TWAP 조건과
API 토큰 확인

4. 보고 수신

텔레그램으로
판단 근거 확인

5. 로그 보관

체결과 장애
검수 자료 저장

운용자 | 화면 01

운용 현황 대시보드

https://trading-control.poc/operator/dashboard
방어 운용 상황판
총 평가 자산 18.4억
🛡️
현재 모드
평시
API 상태
정상
오늘 주문
12건
위험 알림
0건
SOXL 바구니
주식 64% / 현금 36%

목표 60%, 매도 후보

TQQQ 바구니
주식 58% / 현금 42%

허용 범위 안

FNGU 바구니
주식 61% / 현금 39%

감시 유지

오늘의 판단 근거
QQQ 전일 대비-1.8%
VIX18.4
월봉 과열미발동
중앙 주문 큐대기 2건
상징 요소: 방패와 실시간 계기판을 전면 배치해 자산 보호형 자동매매라는 목적을 즉시 보여줍니다.

[화면 개요 및 목적]

제안서의 “수익보다 실패 모드 우선” 전략을 첫 화면에서 증명합니다. 운용자는 총 자산, 현재 모드, API 상태, 바구니별 비중을 한눈에 확인합니다. 데모의 평시 리밸런싱 시작 화면과 연결됩니다.

[핵심 기능 로직]

잔고, 시세, 큐 상태, 위험 조건을 같은 주기로 동기화하고 현재 시스템 모드를 계산합니다. 판단은 바구니별로 분산하지만 화면은 통합 관제 형태로 제공합니다.

  • FastAPI 상태 집계, Redis 실시간 캐시
  • PostgreSQL 주문 로그, 바구니별 비중 계산
운용자 | 화면 02

바구니 상세 및 주문 예약

https://trading-control.poc/operator/basket/soxl
SOXL 주문 예약
⚙️
목표 비중60%
현재 비중64%
이탈 폭+4.0%p
주문 방식TWAP 40분
슬리피지 상한0.35%
큐 전송 전 확인

독립 바구니가 판단하되 주문은 중앙 큐에서 속도를 통제합니다.

예상 매도 수량128주
주문 간격30초
동시 주문 차단켜짐
API 토큰 잔여8 / 10
판단예약큐 대기체결 확인

[화면 개요 및 목적]

독립 바구니와 중앙 주문 큐의 균형을 시각화합니다. SOXL 바구니는 자체 판단을 내리지만 실제 매도 예약은 중앙 큐를 거쳐 호출 제한 안에서 처리됩니다. 데모의 API 제한 대응 단계와 연결됩니다.

[핵심 기능 로직]

목표 비중, 현재 비중, 허용 이탈, 슬리피지 상한, TWAP 시간을 계산해 주문 후보를 만들고 중앙 큐에 전달합니다. 큐 전송 전 API 토큰과 동시 주문 잠금을 확인합니다.

  • 중앙 주문 큐, 토큰 버킷 호출 제한
  • TWAP 주문 예약, 슬리피지 상한 검증
운용자 | 화면 03

일일 보고 및 알림 이력

텔레그램 보고 미리보기
일일 마감 보고

현재 모드: 평시
SOXL 비중: 64%, 매도 예약 필요
API 상태: 정상
내일 감시: VIX 22 이상, QQQ 200일선 이탈

📨
보고 생성 근거
잔고 동기화완료
체결 로그12건 수집
큐 처리 결과실패 0건
위험 조건미발동
관리자 확인불필요
알림은 단순 문자 발송이 아니라 시스템 판단 근거를 남기는 운영 보고서로 설계됩니다.

[화면 개요 및 목적]

텔레그램 알림이 단순 통지가 아니라 판단 근거가 담긴 운영 보고서임을 보여줍니다. 운용자는 마감 보고와 장애 알림의 생성 근거를 함께 확인합니다.

[핵심 기능 로직]

잔고 동기화, 체결 로그, 큐 처리 결과, 위험 조건을 보고 템플릿에 자동 반영합니다. 같은 내용이 로그로 저장되어 추후 검수 자료로 활용됩니다.

  • Telegram Bot API, 알림 템플릿
  • 주문 로그 기반 일일 리포트 생성
리스크 관리자 시나리오

킬스위치와 동면 전환 흐름

위험 조건이 감지되면 신규 주문을 막고, 매도와 현금 확인, 이체, 동면 진입을 순차 상태로 관리합니다. 데모 3단계와 4단계로 이어집니다.

1. 위험 감지

QQQ 낙폭과
추세 이탈 확인

2. 주문 차단

신규 매수 잠금
큐 우선순위 변경

3. 매도 실행

전량 매도와
체결 확인

4. 자산 격리

현금 확인 후
A계좌 이체

5. 동면 감시

재진입 조건
후보만 생성

리스크 관리자 | 화면 01

킬스위치 상황판

https://trading-control.poc/risk/kill-switch
킬스위치 발동 후보
QQQ 급락 조건 감지
🚨
상태 기계 진행
위험 감지
신규 주문 차단
전량 매도
현금 확인
A계좌 이체
동면 진입

전량 매도 요청 단계. 체결 확인 전까지 이체와 동면 진입은 잠금 처리됩니다.

QQQ 낙폭-6.2%
200일선이탈
신규 매수차단
관리자 알림발송

[화면 개요 및 목적]

킬스위치가 버튼 하나가 아니라 상태 기계라는 제안서의 핵심을 증명합니다. 위험 감지부터 동면 진입까지 단계와 잠금 상태가 분리되어 보입니다. 데모의 킬스위치 발동 장면과 연결됩니다.

[핵심 기능 로직]

위험 조건 충족 시 신규 매수를 잠그고 매도, 체결 확인, 현금 확인, 이체, 동면 진입을 독립 상태로 관리합니다. 각 상태는 성공, 지연, 실패, 관리자 확인 요청으로 나뉩니다.

  • 상태 기계 기반 리스크 모드 전환
  • 주문 차단 플래그, 체결 확인 워커
리스크 관리자 | 화면 02

동면 해제 및 재진입 감시

https://trading-control.poc/risk/re-entry
동면 해제 조건판
🌙
VIX19.8 통과
주봉 MACD미통과
QQQ 60일선회복
RSI48 대기
재진입은 즉시 매수가 아닙니다

후보 생성, 관리자 확인, 소액 시험 주문, 정상 리밸런싱 복귀 순서로 분리합니다.

후보 생성 완료관리자 승인 대기매수 주문 잠금
화면 목적: 동면 해제 기준이 왜 아직 완성되지 않았는지 운용자가 한눈에 판단합니다.

[화면 개요 및 목적]

동면 해제가 즉시 매수가 아니라 조건 검증과 승인 흐름이라는 점을 보여줍니다. VIX, MACD, 이동평균, RSI 조건별 통과 여부를 분리해 재진입 후보만 생성합니다.

[핵심 기능 로직]

거시 지표와 기술 지표를 조건별로 계산하고 모든 조건이 충족되어도 관리자 확인 전에는 매수 주문을 잠급니다. 재진입은 후보 생성, 승인, 시험 주문, 정상 복귀로 나뉩니다.

  • 지표 계산 워커, 조건별 상태 저장
  • 재진입 승인 플로우, 매수 잠금 제어
리스크 관리자 | 화면 03

장애와 재시도 추적

https://trading-control.poc/risk/retry-log
장애와 재시도 추적
🔁
증권사 점검 감지03:52 시작
주문 큐 보관7건
다음 재시도120초 뒤
재시도 방식지수 백오프
주문 누락0건
장애 타임라인
03:52 주문 실패
03:52 큐 보관
03:53 텔레그램 경고
03:55 재시도 예정
실패를 숨기지 않고 주문 보관, 재시도, 관리자 개입 필요 여부를 분리해 보여줍니다.

[화면 개요 및 목적]

새벽 주문 지연과 증권사 점검 시간이 겹칠 때도 주문이 사라지지 않는 구조를 설명합니다. 큐 보관, 다음 재시도, 관리자 알림이 함께 표시됩니다.

[핵심 기능 로직]

주문 실패가 발생하면 큐에 보관하고 지수 백오프로 재시도합니다. 장애 상태와 재시도 예정 시각은 텔레그램과 화면에 동시에 남습니다.

  • Data Aggregation & Visualization
  • 지수 백오프, 큐 영속화, 장애 알림
시스템 관리자 시나리오

설정, 검수, 운영 관리 흐름

관리자는 하드코딩 없이 변수를 조정하고, 백테스트와 보안 설정을 관리하며 검수 리포트로 결과를 증명합니다. 데모의 리포트 화면과 연결됩니다.

1. 변수 조정

종목과 비중
킬스위치 기준 수정

2. 영향 계산

예상 주문과
백테스트 영향 확인

3. 검수 실행

10년 데이터와
전진 분석 실행

4. 보안 관리

API 키와 권한
로그 보관 설정

5. 인수 자료

테스트 리포트
운영 문서 출력

시스템 관리자 | 화면 01

변수 제어판

admin.trading-control.poc/variables
변수 제어판
SOXL 목표 비중60%
허용 이탈3%p
TWAP 시간40분
주문 간격30초
슬리피지 상한0.35%
🎚️
하드코딩 금지 증명

종목, 비중, 킬스위치, 재진입 조건을 운영 화면에서 조정합니다. 변경 전에는 백테스트 영향과 예상 주문 수를 미리 보여줍니다.

[화면 개요 및 목적]

매매 로직 하드코딩 금지 요구를 화면으로 증명합니다. 목표 비중, 허용 이탈, TWAP 시간, 킬스위치 기준을 관리자가 직접 조정할 수 있습니다.

[핵심 기능 로직]

변수 변경 전 예상 주문 수와 백테스트 영향도를 계산하고 승인 후 적용합니다. 변경 이력은 로그로 저장되어 검수와 장애 분석에 사용됩니다.

  • 변수 버전 관리, 변경 이력 저장
  • 적용 전 영향 계산, 승인 워크플로우
시스템 관리자 | 화면 02

백테스트 센터

admin.trading-control.poc/backtest
백테스트 센터
📈
데이터 기간
10년
전진 분석
36회
MDD
-18.6%
슬리피지
반영
분봉 데이터캐시 완료
틱 데이터인덱싱 완료
수수료0.25% 반영
체결 지연평균 1.2초
검수 리포트내려받기 가능
백테스트 수치가 관리자 변수와 연결되어 실전 운용과 검수 리포트의 단절을 줄입니다.

[화면 개요 및 목적]

백테스트와 실전 운용의 단절을 줄이는 화면입니다. 10년 치 분봉과 틱 데이터, 슬리피지, 수수료, 전진 분석 결과를 검수 리포트로 연결합니다.

[핵심 기능 로직]

데이터를 로컬 DB에 캐싱하고 파라미터, 데이터 버전, 실행 결과를 함께 저장합니다. 같은 조건의 결과를 재현할 수 있어 인센티브 조건 검증에 활용됩니다.

  • PostgreSQL 시계열 인덱스, 데이터 버전
  • 전진 분석, MDD, 슬리피지 리포트
시스템 관리자 | 화면 03

운영 설정과 보안

admin.trading-control.poc/security
운영 설정과 보안
🔐
하나증권 키****-****-9132
텔레그램 봇연결됨
관리자 권한2명
로그 보관180일
운영 안전 장치

비밀값은 마스킹하고, 변경 이력과 헬스 체크를 남겨 장애 원인을 추적합니다.

서버 헬스 체크정상
마지막 백업오늘 05:00
모의 운용 모드꺼짐
점검 시간 캘린더등록됨

[화면 개요 및 목적]

장기 운영을 위한 보안과 관측 가능성을 보여줍니다. API 키, 권한, 로그 보관, 헬스 체크, 점검 시간 캘린더를 한 화면에서 관리합니다.

[핵심 기능 로직]

민감 정보는 마스킹하고 서버 환경 변수 또는 비밀 관리 도구로 분리합니다. 헬스 체크와 로그 보관 정책을 통해 장애 원인과 운영 책임 범위를 추적합니다.

  • 비밀값 마스킹, 권한 분리, 헬스 체크
  • Issue Tracking & Status Management