릴리즈 노트

v3.9.0.7 Source Candidate 1 — 레퍼럴 귀속 권한·AI 전략 OS·운영 KPI (2026-08-05)

• 사용자별 귀속: 레퍼럴 회원은 운영자가 Affiliate Portal에서 UID를 verified로 승인한 활성 거래소만 공식 클라이언트에서 사용할 수 있습니다.
• AI 커스텀 검증: 지식 구조화·검증·승인·선택적 실행·복기를 연결하되 NoahAI 금융·재테크 OS 안의 한 핵심 기술로 구분합니다.
• 사이트 역할 분리: 회사 사이트는 비전·철학·기술·운영 근거를 설명하며, 가입·플랜·제휴 전환은 DALTrading 운영 화면과 문서에서 관리합니다.
• 기술 실증 KPI: 최근 30일 기술 운영 이벤트, 처리 안정성, AI 추론과 학습 데이터 기록만 공개하며 사용자·거래·거래소·수익 정보는 내부 BI로 유지합니다.

전체 회귀는 1,336 passed, 6 skipped, 0 failed입니다. 공개 Windows 설치본은 v3.9.0.5 Fix Patch 1이며 v3.9.0.7은 Windows·daltrading 배포·Affiliate UID·사용자 환경 E2E 전에는 배포 완료가 아닙니다.

v3.9.0.6 Source Candidate 2 — 체결 동기화·통화 경계·AI 전략 운영체제 (2026-08-04)

• API 호출 최적화: 10초마다 최근 200건을 강제로 조회하던 경로를 제거하고, LIVE 저빈도 복구·마지막 체결 이후 증분 조회·미확정 주문 ID 확인으로 분리했습니다.
• 리포트 통화 경계: KRW·USDT 손익과 수수료를 환산 없이 합산하지 않으며 거래소 원본 심볼을 보존합니다.
• 초기 거래 순환 차단: 학습 데이터가 많아질수록 완료 거래가 없는 종목의 첫 거래가 막히던 조건을 제거했습니다.
• AI 커스텀 대표 제품: 배우기·제작·검증·실행·개선·공유를 연결하는 AI 전략 운영체제로 정의하고 현재 제공·고도화·생태계를 구분했습니다.
• 8개 제품 계층: AI 멘토, 멀티모달 제작소, 안전 전략 언어, 검증 연구소, 국면 오케스트레이터, 실행 OS, 전략 여권, 신뢰·법무 계층으로 로드맵을 재구성했습니다.

v3.9.0.5 Fix Patch 5 작업 소스 — 갱신 생존성·체결 원장·권한 정합 (2026-08-01)

• 대시보드 갱신: 탭을 벗어났다가 돌아와도 포지션·잔고 조회가 자동 복구되도록 갱신 작업의 수명주기를 정리했습니다.
• 확정 체결 원장: Binance 네이티브 경로와 CCXT 거래소의 LIVE 진입·청산, Bithumb 실제 체결을 공통 원장과 거래 통계·AI 리포트 조회로 연결했습니다.
• PAPER 가시성: PAPER 포지션·관련 잔고·PnL을 대시보드에 표시하고 LIVE 상태와 혼동되지 않도록 구분합니다.
• 사용자 DB 보존: 구형 DB 마이그레이션은 기존 미청산 행과 거래소 식별자를 보존하며, 준비 실패 시 거래 초기화를 차단합니다.
• 증권 실행 권한: PAPER/LEARNING/LIVE와 전역·증권사별 권한을 함께 확인하는 AND 구조 및 공식 API 계약을 기준으로 정리했습니다.

v3.9.0.4 출시 후보 — AI 커스텀 역할·공통 실행 계약 (2026-07-30)

• 일반 모드: 사용자 고정 종목과 NoahAI 자동 후보를 분석하고, 기본 AI 후보를 AI 커스텀 전략이 정확히 한 번 확인합니다.
• 고급 모드: 사용자 고정 종목과 StrategyUniversePolicy로 후보를 만들며 사용자 전략이 방향·TP/SL·청산을 독립 결정합니다. NoahAI 기본 AI의 동의를 요구하지 않습니다.
• 전략 무결성: 전략 손절값을 몰래 좁히지 않습니다. 공통 위험예산을 넘으면 수량을 축소하고, 그래도 안전하지 않으면 요청값·허용값·차단 사유를 표시합니다.
• 종목·국면: 각 거래소·증권사는 자기 지원 종목과 데이터로 후보를 만들고, 국면 범위는 전체 시장·종목·둘 다·사용 안 함 중 명시합니다.
• 다중 실행: 사용자는 선택 대상에서 각각 실행·총위험 분할·우선순위 한 곳을 선택합니다. 정상적인 동일 종목 다중 실행은 하나의 기회로 묶어 통합 위험과 결과를 관리합니다.
• 실행 모드: LEARNING은 전체 판단·기록 후 외부 상태 변경과 신규 주문만 차단하고, PAPER와 LIVE도 같은 후보·위험 계약을 사용합니다.
• 설명 계약: 기본 AI 판단, AI 커스텀 역할·전략 버전, 후보 출처, 위험예산, 동적 청산값, 거래소 보험 주문값과 최종 사유를 구분해 기록합니다.

소스 전체 회귀는 1,219 passed, 6 skipped, 0 failed입니다. 당시 Windows 사용자 배포본은 v3.9.0.2였으며, v3.9.0.4는 별도 배포 없이 이후 v3.9.0.5에 통합되었습니다. 상세 공개 계약은 v3.9.0.4 실행·위험관리 기준에서 확인할 수 있습니다.

v3.9.0.3 출시 후보 — AI 커스텀 고급모드·멀티 AI·업데이트 안정성 (2026-07-28)

• AI 커스텀 고급모드: EMA·SMA·RSI·ATR 기간 2~500, 조건별 1분~1일 시간봉, AND/OR 진입·전체청산과 요청값·계산값 비교를 제공합니다.
• 작업별 멀티 AI: OpenAI·DeepSeek·Claude·Gemini를 {provider, model} 단위로 배치하며 기존 OpenAI 설정은 자동 이전합니다.
• 독립 음성 전사: 전략 분석 엔진과 별도로 OpenAI 전사 프로필을 사용하고, 텍스트·JSON·사용량·오류·전사를 실제 API 기능 검증에서 확인합니다.
• 모델 수명주기: 권장·계정 확인·미리보기·비권장·종료를 구분합니다. Kimi K3·K2.6은 실제 키 E2E 전까지 어시스턴트 시험 연동입니다.
• 안정성과 주문 경계: 숨은 탭의 반복 작업을 중지하고 Binance UTC 시각을 정규화했습니다. 화면·학습 대상과 실제 주문 대상을 분리하며 빈 주문 대상은 신규 주문을 차단합니다.
• 안전 업데이트: 열린 포지션·주문·제출 중에는 기본 연기하고, SHA·Windows 서명·DB flush·재시작 health check·실패 시 이전 EXE 복원을 검증합니다.

소스 전체 회귀는 1,135 passed, 6 skipped, 0 failed입니다. Windows 사용자 배포본은 v3.9.0.2이며, 이 v3.9.0.3 후보는 별도 배포하지 않고 위 v3.9.0.4 후보에 통합되었습니다. AlphaArena 멀티 엔진 실거래 연결과 TradingView webhook·부분익절·추적손절·재진입·사용자 지표 샌드박스는 후속 단계입니다.

v3.9.0.2 — AI 커스텀 XAI·시장국면 추천·NoahAI 어시스턴트 안전성 (2026-07-26)

핵심 변경

• 초보자 도움: 처음 사용법과 현재 분석 결과를 전략명·입력 형식·누락 조건과 함께 NoahAI 어시스턴트에 전달합니다.
• 시장국면 추천: 상승·하락·횡보·고변동·저변동이 원문에 명시된 경우만 추천하고, 진입 제외·회피 문맥은 별도로 표시합니다.
• XAI: 원문 근거, 전략 역할, 적용 범위·시장국면·우선순위, 실행 엔진 적용값과 승인 전 미적용 상태를 설명합니다.
• 강제 확인: 과거 AI 자동적용 설정도 사용자 최종확인으로 변환하고 채팅 적용과 최종 확인을 모두 요구합니다.
• 위험 확대 차단: 시장·최근 성과·포지션 정보가 부족하거나 손실 구간·열린 포지션이면 레버리지·노출 확대를 차단합니다.
• 적용 시점 재검증: 제안 생성, 적용 클릭, 저장 직전에 데이터를 다시 확인해 대화 도중 바뀐 상태를 반영합니다.

검증과 배포 상태

macOS/Python 3.13 소스 전체 회귀는 1043 passed, 6 skipped, 0 failed이며, AI 커스텀·어시스턴트 집중 회귀는 74건을 통과했습니다. v3.9.0.2는 당시 Windows 배포 파일이며, 위 항목들은 이후 버전에 누적 통합되었습니다.

TradingView·Pine 전략 자동화와 시장국면 운용 상세 보기 →

v3.9.0.1 — 포지션 KPI·AI 커스텀·금융 인텔리전스 (2026-07-24)

핵심 변경

• 포지션 KPI: 주문 실행과 진입·부분청산·전량청산을 분리하고, 검증된 시각 차이만 보유시간에 포함합니다.
• 실제 실행 집계: 비즈니스 KPI에서 mock·demo·paper·test를 제외하고, 평균 보유시간은 유효 종료 이벤트 전까지 수집 대기로 표시합니다.
• AI 커스텀: 거래당 허용손실·손절거리·최대 증거금·레버리지 상한으로 실제 레버리지를 계산하고, 국면 이탈 동작은 사용자가 선택합니다.
• 금융 인텔리전스: 시장·섹터·이벤트·뉴스·재무·가치평가·스크리너·기술지표·성과·백테스트를 하나의 분석 흐름으로 연결합니다.
• 화면·사용성: 공용 아이콘, 탭 시각 계층, 본문 스크롤, 인앱 업데이트·사용법 동선을 정비했습니다.

검증과 공개 원칙

전체 회귀는 1030 passed, 6 skipped, 0 failed입니다. 웹사이트 공개 스냅샷은 기술 운영 이벤트, 처리 신뢰성, AI 추론, 학습 데이터 기록으로 제한하고 사용자·거래·성과 BI는 내부 관리합니다.

v3.8.9.29 - 다중 거래소/AI 커스텀 실운용 안정화 및 승인형 전략 운용 고도화 (2026-07-19)

구조 변경 배경

v3.8.9.28까지는 정책/동의/배포 표준화가 중심이었다면, v3.8.9.29는 실제 운용 단계에서의 전략 안전성, 거래소 분기 정합, 사용자 전략 승인 게이트를 한 번에 고정하는 데 초점을 맞췄습니다.

운영 구조 변경

• AI 커스텀 실운용화: 텍스트/Pine/PDF/OCR/영상/YouTube/TradingView 입력을 전략 규칙으로 구조화하고 승인 전 실거래 반영을 차단했습니다.
• 전략 상태머신 고정: 생성 → 검토 → 승인 → 실행검증 → 활성화 → 롤백 경로를 명시해 우회 적용을 방지했습니다.
• 다중 거래소 정합 보강: 거래소별 컨텍스트 분리와 PnL 임계값 분리로 경로 혼선을 줄였습니다.
• 신규 사용자 보호: 최소 단위 포지션/레버리지 제한을 기본값으로 적용해 콜드스타트 리스크를 낮췄습니다.
• 운영 UI 개선: 거래소 통계/상태 가시성, 시작-중지 동기화, 안전 종료 경로를 강화했습니다.

검증 및 운영 원칙

회귀 검증은 967 passed, 6 skipped, 0 failed를 기준으로 기록되었고, 원칙은 기능 확장이 아니라 승인 없는 실행 0건, 가드레일 우회 0건, 추적 가능한 복기입니다.

v3.8.9.27 — 자동업데이트 경로/가시성 정합 및 거래소 검증 UX 강화 (2026-07-06)

구조 변경 배경

업데이트 파일 경로 혼선과 진행률 가시성 부족, 거래소 검증 실패 시 원인 파악 난이도가 운영상 반복 이슈로 확인되었습니다. 이에 따라 업데이트 경로 정책·진행 이벤트·검증 가이드 동선을 하나의 사용자 흐름으로 정합화했습니다.

운영 구조 변경

• 업데이트 경로 정책: 설치 위치 우선 캐시 경로 사용, 불가 시 LocalAppData/TEMP 폴백.
• 진행률 가시화: 설정 업데이트 탭에서 다운로드 시작/진행률(%)·수신량(MB)·완료/실패 상태 실시간 표시.
• 완료 경로 안내: 다운로드 파일 경로/적용 대상 EXE/캐시 경로를 완료 즉시 안내.
• 캐시 누적 정리: 오래된 auto_updater 버전 폴더/스크립트 자동 정리(최신 2개 유지).
• 거래소 검증 UX: Bitget/Bybit/OKX 검증 실패 시 권한/IP/passphrase 계열 원인별 조치 가이드 제공.

검증 및 운영 원칙

자동업데이트 회귀 테스트는 5 passed로 확인되었고, 원칙은 기능 추가보다 사용자가 실패 원인과 다음 조치를 즉시 이해할 수 있는 운영 동선을 우선하는 것입니다.

v3.8.9.22 — 한국투자증권(KIS) 브로커 추가 및 4개 증권사 기준 동기화 (2026-06-16)

구조 변경 배경

ETF/주식 서비스가 키움·신한·미래에셋 중심으로 운영되던 상태에서, 한국투자증권 KIS REST 경로를 기존 어댑터 패턴에 동일하게 편입해 4개 증권사 공통 검증 구조로 확장했습니다.

운영 구조 변경

• 브로커 추가: 한국투자증권 KIS REST 어댑터를 팩토리/설정/UI/점검 스크립트에 연결했습니다.
• 사용자 동선 동기화: 설정 화면, 대시보드 소스 선택, 연결 점검 팝업, 사용자 매뉴얼 문구를 4개 증권사 기준으로 정렬했습니다.
• 배포 경로 반영: 빌드 hidden import와 검증 스크립트 기본 브로커 목록도 함께 갱신했습니다.

검증 및 운영 원칙

mock 기준 4개 증권사 공통 검증은 모두 통과했고, 핵심 원칙은 브로커 수 확대보다 동일한 운영 규칙과 회귀 검증 경로를 유지하는 것입니다.

릴리즈 노트의 목적

이 릴리즈 노트는 기능 추가나 개선 사항을 나열하는 것이 아니라, 서비스 구조 변경과 운영 정책 변경을 기록하는 것을 목적으로 합니다.

각 버전에서 무엇이 바뀌었는지보다, 왜 그런 구조로 변경되었는지, 어떤 운영 원칙이 적용되었는지를 중심으로 기록합니다.

v3.8.9.20 — AI 애널리스트 중복 UI 제거 및 상단 화면 고도화 (2026-06-05)

구조 변경 배경

기존 운영 화면에서 Quick Actions의 "AI 분석 패널"과 상단 "AI 애널리스트" 메뉴가 기능적으로 중복되어, 사용자 입장에서 "열고 닫아도 변화가 적고 진입 경로가 분산된다"는 피드백이 확인되었습니다. 이에 따라 중복 경로를 제거하고 상단 AI 애널리스트를 단일 진입점으로 고정했습니다.

운영 구조 변경

• 중복 패널 제거: Quick Actions의 "AI 분석 패널" 버튼과 우측 드로어(열기/닫기/리사이즈) 경로를 제거했습니다.
• 단일 진입점 유지: AI 분석 기능은 상단 "AI 애널리스트" 메뉴 중심으로 통합했습니다.
• 상단 화면 고도화: 종료 거래 수/승률/누적 손익/리스크 가드 스냅샷 카드 추가.
• 즉시 이동 액션: 요약 리포트 탭, 시나리오 점검 탭, AI 어시스턴트로 빠르게 이동 가능한 버튼 추가.
• 프리뷰 강화: AI 요약 리포트·시나리오 점검 미리보기 및 새로고침 경로 추가.

검증 및 운영 원칙

회귀 테스트는 99 passed로 확인되었고, 핵심 원칙은 기능 확장이 아니라 중복 제거 후 핵심 동선의 체감 품질을 높이는 것입니다. 즉, AI 분석 기능은 "더 많이 노출"이 아니라 "하나의 명확한 경로"로 안내합니다.

운영 런북 공개 — 키움 OpenAPI+ Windows 진단 절차 (2026-05-11)

구조 변경 배경

ETF/주식 조건부 베타 실연동 검증 단계에서 키움 OpenAPI+ 연결 실패 원인 분리가 환경마다 달라 재현성과 대응 속도에 편차가 있었습니다. 이를 해결하기 위해 Windows 기준 표준 진단 런북을 정식화했습니다.

운영 구조 변경

• 표준 실행 절차: PowerShell 환경에서 가상환경 활성화 후 검증 스크립트를 실행하는 단계별 절차를 고정했습니다.
• 원인 분리 기준: control_ok, has_OnReceiveTrData, python_bits, os 값을 기준으로 ActiveX/이벤트/계정 이슈를 구분합니다.
• 결과 수집 템플릿: 콘솔 전체 출력, JSON Step 0 블록, API 연결 FAIL detail 3종을 필수 제출 항목으로 정의했습니다.

검증 보조 지표

스크립트 회귀 확인 기준으로 Mac 개발 환경 사전 검증을 병행했으며, 관련 테스트는 13 passed, 4 skipped, 60 deselected를 기록했습니다.

운영 원칙

증권사 실연결 검증은 결과 성공 여부보다 실패 원인의 구조적 분리와 재현 가능성이 우선입니다. 런북 기반 진단으로 환경 편차를 줄이고, 후속 대응의 품질을 일정하게 유지합니다.

v3.8.9.19 — 대시보드 탭 고도화 및 한국 시장 연동 (2026-05-06)

구조 변경 배경

자산 통합·생활금융·AI애널리스트 서비스의 탭이 텍스트 목록 수준으로만 제공되어, 사용자가 실질적인 판단 정보를 얻기 어려웠습니다. 시각화 엔진을 직접 구현하여 탭별 기능을 실질적으로 고도화하고, 주식 서비스의 시장 트렌드 데이터를 한국 시장 기준으로 전환했습니다.

운영 구조 변경

1. 자산 배분 진단 탭 — 시각화 엔진 구현

• 비중 바차트: 암호화폐/주식/기타 자산군 비중을 컬러 막대로 시각화 (tkinter Canvas)
• HHI 집중도 미터: 허쉬만-허핀달 지수 0~100 게이지 바 + 3구간 색상 (분산/주의/위험)
• 상관계수 히트맵: 자산군 간 2×2 히트맵 — 동조화 낮음=녹색, 높음=빨강
• 리밸런싱 권고 카드: AssetCorrelationService 기반 고상관 경고 + 분산 권고

2. 시나리오 점검 탭 — DB 백테스트 엔진

• 실거래 기반 시뮬레이션: DB trade_log 최근 200건으로 3개 전략 비교
• 전략 비교: 보수(포지션 ×0.7) / 현재 / 공격(포지션 ×1.3)
• 지표: 승률, 누적 손익, 최대 드로우다운, 건당 평균 자동 계산

3. 리스크 브리핑 탭 — 손실 시뮬레이션

• 손실 추정 테이블: -5%/-10%/-20%/-30%/-50% 하락 시 자산군별 손실 계산
• 위험 카드: 집중도/상관계수/누적손익 3가지 위험 수준 색상 카드
• 즉시 대응 액션: 헤지/익절/분산 등 권장 액션 목록

4. 보안 경고 탭 신규 — 생활금융

• 자동 이상 탐지: DB trade_log → fraud_detection_service → 이상 패턴 감지
• 종합 리스크 점수: low/medium/high/critical 4단계 등급
• 자가진단 체크리스트: 보이스피싱·스미싱 5가지 체크리스트

5. 세금 계산 탭 신규 — 생활금융

• 연말정산: 급여/카드/의료/교육/기부금 → 납부세액/실효세율 계산
• 금투세: 주식 양도차익 기반 금융투자소득세 계산
• 절세 계좌 비교: ISA/연금저축/IRP 절세 혜택 비교
• 절세 팁: 개인화된 절세 최적화 팁 5가지 자동 생성

6. 주식 시장 트렌드 한국화

• 네이버 금융 공개 API 연동: API 키 불필요, KOSPI/KOSDAQ 실시간 지수
• 종목 시세: 삼성전자/SK하이닉스/NAVER/카카오/현대차/LG에너지솔루션
• 섹터 흐름: IT·반도체 / 인터넷·플랫폼 / 자동차 / 2차전지 업종별 강세/약세

운영 원칙

판단 인프라는 숫자를 보여주는 데서 끝나지 않습니다.사용자가 "내 포트폴리오가 얼마나 분산되어 있는가", "만약 시장이 20% 빠지면?", "내 거래에 이상 패턴이 있는가"를 즉시 확인할 수 있어야 비로소 의사결정 인프라의 역할을 합니다. 이번 릴리스는 텍스트 안내에서 시각화·계산 엔진으로의 전환을 의미합니다.

배포 검증

메뉴 회귀 테스트 51 passed (0 failed) · 구문 오류 0건 · 변경 파일 5개 · 신규 함수 12개

v3.8.9.11 — TP/SL -2021 오류 근본 수정 및 재테크 플랫폼 확장 (2026-01-25)

구조 변경 배경

GALA, JASMY 등 저가 알트코인에서 TP(Take Profit) 주문이 실패하는 문제가 발생했습니다. 오류 메시지는 `-2021: Order would immediately trigger`였으며, 이는 단순한 버그가 아니라가격 정밀도 처리와 TP 방향 검증의 구조적 문제였습니다.

동시에, 암호화폐 실전 검증을 통해 검증된 금융 AI 운영 엔진을ETF/주식으로 확장하는 작업이 진행되었습니다. 이는 특정 자산에 종속되지 않는 자산 중립적 금융 AI 플랫폼으로 발전하기 위한 중요한 단계입니다.

운영 구조 변경

1. TP/SL -2021 오류 근본 수정

• 키 이름 호환성 처리: `price_precision`과 `pricePrecision` 두 가지 형식을 모두 지원하도록 수정. 이전에는 키 이름 불일치로 인해 가격 정밀도가 항상 2로 고정되어 저가 코인에서 정확한 가격 계산이 불가능했습니다.
• 저가 코인 자동 감지 및 정밀도 조정: 가격이 0.001~0.02 범위에 있는 코인을 자동으로 감지하고, 적절한 가격 정밀도를 강제로 적용하여 TP/SL 주문이 정확하게 실행되도록 보장합니다.
• TP 방향 검증 추가: LONG 포지션에서는 TP가 현재가보다 높아야 하고, SHORT 포지션에서는 TP가 현재가보다 낮아야 합니다. 이전에는 이 검증이 누락되어 잘못된 방향의 TP 주문이 생성될 수 있었습니다.

2. 재테크 금융 AI 플랫폼 확장

• StockExchange 인터페이스 생성: `trading/exchanges/interfaces/stock_exchange.py`를 생성하여 증권 거래소와 암호화폐 거래소를 동일한 인터페이스로 처리할 수 있는 구조를 마련했습니다. 이는 자산 중립적 금융 AI 운영 엔진의 핵심 설계 원칙입니다.
• 국내 증권사 어댑터 기본 구조: `trading/exchanges/adapters/kiwoom_stock_adapter.py`를 생성하여 증권사 API를 금융 AI 시스템에 통합할 수 있는 기본 구조를 완성했습니다.
• 대시보드 확장: 주식/증권 서비스 탭과 증권사별 하위 탭을 구현하여 사용자가 암호화폐와 주식을 하나의 인터페이스에서 관리할 수 있도록 했습니다.

운영 원칙

모든 자산 유형에서 동일한 안전장치가 작동해야 합니다.저가 알트코인이든 고가 코인이든, 암호화폐든 주식이든, TP/SL과 같은 안전장치는 정확하게 작동해야 하며, 가격 정밀도나 자산 유형에 따라 달라지면 안 됩니다.

또한, 특정 자산에 종속되지 않는 자산 중립적 설계를 통해 새로운 자산 유형을 추가할 때도 기존의 안전장치와 운영 구조를 그대로 재사용할 수 있어야 합니다. 이번 ETF/주식 확장은 이러한 설계 원칙의 첫 번째 실전 적용 사례입니다.

v3.8.9.9 — Binance Algo Order API 완전 구현 (2025-12-27)

구조 변경 배경

Binance 정책 변경(2025-12-09)으로 조건부 주문(TP/SL)이 Algo Service로 강제 분류되었습니다. 이는 단순한 기능 추가가 아니라, 거래소 API 정책 변화에 따른 운영 구조 재설계입니다.

운영 구조 변경

• 서명 생성 규칙 통일: query string 기반 서명 생성으로 모든 파라미터를 일관된 방식으로 처리
• 가격 정밀도 처리 표준화: tickSize 우선 적용, 부동소수점 오차 제거로 안정성 확보
• 조건부 주문 분기 간소화: 복잡한 로직 제거(160줄 → 55줄)로 유지보수성 향상
• 응답 형식 통일: Algo Order 응답을 일반 주문과 동일한 형식으로 변환하여 기존 코드와 호환성 유지

운영 원칙

거래소 정책 변경에 대응할 때는 기존 코드와의 호환성을 유지하면서 새로운 요구사항을 충족하는 구조로 변경합니다. 모든 모듈에 자동 적용되도록 설계하여 추가 수정을 최소화합니다.

v3.8.9.7 — Binance API 규칙 준수 및 설정 구조 개선 (2025-01-26)

구조 변경 배경

Binance API 공식 규칙을 완벽히 준수하고, 하드코딩된 설정을 사용자 제어 가능한 구조로 변경했습니다.

운영 구조 변경

• API 규칙 준수: closePosition=True일 때 quantity 파라미터 제거, reduceOnly와 closePosition 동시 사용 금지
• 설정 파일 구조화: 백업 TP/SL 설정을 settings.json으로 이동하여 AI가 시장 상황에 따라 자동 조정 가능
• 경로 자동 감지: 하드코딩된 경로 제거, 패키지 환경에서도 올바른 경로 자동 감지
• TP/SL 역할 명확화: 실시간 모니터링(주력)과 백업 TP/SL(보험) 역할 분리

운영 원칙

거래소 API 규칙은 절대적으로 준수하며, 사용자 제어 가능한 설정은 파일로 분리하여 AI가 동적으로 조정할 수 있도록 합니다.

v3.8.9.5 — TP/SL 검증 및 원자성 보장 강화 (2025-01-26)

구조 변경 배경

TP/SL 검증 실패 시에도 거래가 진행되는 문제를 해결하고,원자성 보장을 통해 안전성을 강화했습니다.

운영 구조 변경

• TP/SL 필수 보장: 검증 실패 시 포지션 즉시 청산, 거래 실패로 처리
• 원자성 보장: TP/SL 중 하나라도 실패 시 둘 다 롤백, 재설정 시에도 원자성 유지
• 검증 로직 통일: 모든 검증 로직에서 동일한 주문 타입 필터링 사용
• 모듈화 준비: TpSlManager 기반으로 TP/SL 관련 책임 집중, 재사용 가능한 구조

운영 원칙

안전장치(TP/SL)는 절대적으로 필수입니다. 설정되지 않으면 거래가 실행되지 않으며, 원자성 보장을 통해 부분 실패 상황을 방지합니다.

v3.8.9.3 — 통합잔고 및 거래통계 구조 개선 (2025-11-29)

구조 변경 배경

여러 거래소를 동시 운영할 때 통합 관리가 가능하도록 잔고와 거래 통계 구조를 개선했습니다.

운영 구조 변경

• 통합잔고 합계 표시: 여러 거래소 USDT/KRW 잔고 합계 계산 및 표시
• 거래통계 통합 조회: exchange_trade_stats 우선 조회, trade_log 폴백으로 정확도 향상
• TP/SL 청산 기록: TP/SL 청산 시에도 trade_log 업데이트하여 통계 정확도 향상
• 수수료 고려 청산: 수수료를 고려한 최소 수익 임계값으로 수수료 회수 보장

운영 원칙

다중 거래소 운영 시 통합 관점이 필수입니다. 개별 거래소뿐만 아니라 전체 자산과 성과를 한눈에 파악할 수 있어야 합니다.

v3.8.9.2 — 스마트 점진적 학습 시스템 (2025-11-29)

구조 변경 배경

신규 사용자와 기존 사용자 모두에게 적절한 조건을 적용하기 위해점진적 학습 시스템을 도입했습니다.

운영 구조 변경

• 거래 이력 기반 임계값 조정: 전체 첫 거래(0회)부터 정상 거래(11회 이상)까지 단계적 완화
• 코인별 첫 거래 처리: 새로운 코인 거래 시에도 완화된 임계값 적용
• AI 종합 판단 신뢰: 약한 시그널이라도 시장 조건이 좋으면 AI 판단 존중
• 시그널 강도별 조정: 시그널 강도에 따라 AI 신뢰도 자동 조정

운영 원칙

학습은 점진적으로 이루어집니다. 초기에는 완화된 조건으로 시작하고, 거래 이력이 쌓일수록 정상 임계값으로 전환합니다. AI의 종합 판단을 신뢰하여 시그널 강도만으로 판단하지 않습니다.

v3.8.9 — 포지션 동기화 시스템 강화 (2025-11-21)

구조 변경 배경

앱 재시작 후에도 정확한 상태를 유지하고, 실제 거래소와 메모리 상태를 동기화하는 구조를 강화했습니다.

운영 구조 변경

• 실제 거래소와 메모리 동기화: 매 거래 사이클 시작 시 실제 포지션 조회
• 청산된 포지션 자동 제거: 메모리 정리로 정확한 포지션 수 인식
• 실제 포지션 자동 복구: 앱 재시작 대응으로 상태 유지
• 거래 사이클 안정화: 포지션 수 정확한 인식으로 거래 루프 정상화

운영 원칙

메모리 상태는 항상 실제 거래소 상태와 일치해야 합니다. 동기화를 통해 앱 재시작이나 네트워크 오류 후에도 정확한 상태를 유지합니다.

v3.8.8.8 — 거래 차단 문제 해결 및 설정 보존 강화 (2025-11-14)

구조 변경 배경

첫 거래가 실행되지 않는 순환 문제(Chicken and Egg Problem)를 해결하고, 사용자 설정값이 영구 보존되도록 구조를 개선했습니다.

운영 구조 변경

• 첫 거래 허용 로직: 전체 거래 이력이 0인 경우 완화된 조건 적용
• 데이터 부족 시 임계값 완화: user_signal_threshold 기반 동적 조정
• 설정값 보존 강화: 중첩 딕셔너리 재귀 처리로 2단계 이상 중첩도 완벽 처리
• 보호된 설정 항목: 중요한 설정 항목 명시적 보호로 템플릿 병합 시에도 사용자 값 우선

운영 원칙

순환 문제는 구조적으로 해결해야 합니다. 첫 거래를 허용하여 데이터가 쌓이도록 하고, 사용자가 수정한 설정값은 항상 보존되어야 합니다.

v3.8.8.6 — Alpha Arena 모드 추가 (2025-11-07)

구조 변경 배경

LLM 기반 자율 거래 모드를 추가하여다양한 거래 전략을 지원하는 구조로 확장했습니다.

운영 구조 변경

• 독립 거래 모드: 기존 자동매매 파이프라인과 완전 분리된 Alpha Arena 모드
• LLM 기반 자율 거래: AI가 직접 거래 결정을 내리고 실행하는 구조
• 검증된 전략 적용: Alpha Arena 벤치마크에서 검증된 승리 알고리즘 적용
• 가드레일 자동 적용: 레버리지 범위, TP/SL 필수, 쿨다운 등 안전장치 내장

운영 원칙

새로운 거래 모드는 기존 시스템과 독립적으로 운영되며, 각 모드별로 적절한 가드레일이 자동 적용됩니다. 사용자가 선택한 모드에 따라 다른 전략이 적용됩니다.

v0.1 — 웹사이트 서비스 구조 공개 (2025-12)

서비스 페이지 구조 정리

NoahAI Labs 웹사이트의 서비스 영역을 다음과 같이 구조화했습니다:

• Services (/product): 현재 사용 가능한 개인용 금융 AI 서비스에 집중
• 자율형 금융 어시스턴트 (/product/assistant): 통합 재테크 / 금융 AI / 자율형 금융 어시스턴트의 상위 개념과 확장 비전
• Technology (/technology): 금융 AI 엔진과 운영 스택 설명
• Enterprise (/enterprise): B2B/기관용 운영 스택 설명

구조 변경의 이유

기존에는 코인 중심 서비스 설명에 집중되어 있었으나, NoahAI Labs가 지향하는 것은 특정 자산이 아닌 통합 금융 판단 AI입니다.

코인은 "최초의 실전 검증 자산"이라는 위치로만 언급하고, 전체 금융 AI의 확장 가능한 구조를 명확히 하기 위해 자율형 금융 어시스턴트 전용 페이지를 추가했습니다.

운영 원칙

• 개별 코인 전략, 수익률 숫자, 단기 성과 강조를 하지 않습니다.
• 판단 → 실행(선택적) → 기록 → 복기 → 설명(XAI) 구조를 중심으로 설명합니다.
• 투자 자문·수익 보장 표현을 금지합니다.
• 기술 과장 없이 '플랫폼', '엔진', '운영 구조' 같은 표현을 사용합니다.

향후 계획

향후 릴리즈 노트는 다음과 같은 구조 변경을 기록할 예정입니다:

• 자산 범위 확장 (코인 → 증권/ETF/부동산)
• 리스크 해석 능력 고도화
• 판단 설명 범위 확대
• 실행 범위 확장
• 운영 정책 변경
• 거래소 API 정책 변경 대응
• 안전장치 구조 개선

기능 추가나 성과 숫자는 기록하지 않으며, 구조와 운영 원칙의 변경만 기록합니다.