diff --git a/README.md b/README.md
index b8e16f8b..0b5129e8 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
 
-**Languages:** [English](README.md) | [中文](docs/i18n/zh-CN/README.md) | [Українська](docs/i18n/uk/README.md) | [Русский](docs/i18n/ru/README.md) | [日本語](docs/i18n/ja/README.md)
+**Languages:** [English](README.md) | [中文](docs/i18n/zh-CN/README.md) | [Українська](docs/i18n/uk/README.md) | [Русский](docs/i18n/ru/README.md) | [日本語](docs/i18n/ja/README.md) | [한국어](docs/i18n/ko/README.md)
 
 **📚 Documentation:** [Docs Home](docs/README.md) | [Getting Started](docs/getting-started/README.md) | [Prompt Writing Guide](docs/prompt-guide.md) ([中文](docs/prompt-guide.zh-CN.md)) | [Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md) | [Security](SECURITY.md)
 
diff --git a/docs/i18n/ja/README.md b/docs/i18n/ja/README.md
index d5580f9e..41f38aeb 100644
--- a/docs/i18n/ja/README.md
+++ b/docs/i18n/ja/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
 
-**言語:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](README.md)
+**言語:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](README.md) | [한국어](../ko/README.md)
 
 ---
 
diff --git a/docs/i18n/ko/README.md b/docs/i18n/ko/README.md
new file mode 100644
index 00000000..504d8401
--- /dev/null
+++ b/docs/i18n/ko/README.md
@@ -0,0 +1,753 @@
+# 🤖 NOFX - Agentic Trading OS
+
+[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
+[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
+[![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
+
+**언어 / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](README.md)
+
+**📚 문서:** [문서 홈](../../README.md) | [시작 가이드](../../getting-started/README.md) | [커뮤니티](../../community/README.md) | [변경 로그](../../../CHANGELOG.md)
+
+---
+
+## 📑 목차
+
+- [🚀 범용 AI 트레이딩 운영 체제](#-범용-ai-트레이딩-운영-체제)
+- [👥 개발자 커뮤니티](#-개발자-커뮤니티)
+- [🆕 최신 업데이트](#-최신-업데이트)
+- [📸 시스템 스크린샷](#-시스템-스크린샷)
+- [✨ 현재 구현](#-현재-구현---암호화폐-시장)
+- [🔮 로드맵](#-로드맵---범용-시장-확장)
+- [🏗️ 기술 아키텍처](#️-기술-아키텍처)
+- [💰 바이낸스 계정 등록](#-바이낸스-계정-등록-수수료-절약)
+- [🔷 Hyperliquid 계정 등록](#-hyperliquid-거래소-사용)
+- [🔶 Aster DEX 계정 등록](#-aster-dex-거래소-사용)
+- [🚀 빠른 시작](#-빠른-시작)
+- [📖 AI 의사결정 흐름](#-ai-의사결정-흐름)
+- [🧠 AI 자가학습 예시](#-ai-자가학습-예시)
+- [📊 웹 인터페이스 기능](#-웹-인터페이스-기능)
+- [⚠️ 중요한 위험 경고](#️-중요한-위험-경고)
+- [🛠️ 일반적인 문제](#️-일반적인-문제)
+- [📈 성능 최적화 팁](#-성능-최적화-팁)
+- [🔄 변경 로그](#-변경-로그)
+- [📄 라이선스](#-라이선스)
+- [🤝 기여하기](#-기여하기)
+
+---
+
+## 🚀 범용 AI 트레이딩 운영 체제
+
+**NOFX**는 통합 아키텍처를 기반으로 구축된 **범용 Agentic Trading OS**입니다. 암호화폐 시장에서 **"멀티 에이전트 의사결정 → 통합 리스크 관리 → 저지연 실행 → 실제/모의 계정 백테스팅"** 루프를 성공적으로 완성했으며, 현재 이 기술 스택을 **주식, 선물, 옵션, 외환 및 모든 금융 시장**으로 확장하고 있습니다.
+
+### 🎯 핵심 기능
+
+- **범용 데이터 및 백테스팅 레이어**: 크로스 마켓, 크로스 타임프레임, 크로스 거래소 통합 표현 및 팩터 라이브러리, 전이 가능한 "전략 메모리" 축적
+- **멀티 에이전트 자가 대전 및 자가 진화**: 전략이 자동으로 경쟁하고 최고를 선택하며, 계정 수준 PnL과 리스크 제약을 기반으로 지속적으로 반복
+- **통합 실행 및 리스크 관리**: 저지연 라우팅, 슬리피지/리스크 관리 샌드박스, 계정 수준 제한, 원클릭 마켓 전환
+
+### 🏢 [Amber.ac](https://amber.ac) 후원
+
+### 👥 핵심 팀
+
+- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
+- **유일한 공식 트위터** - [@nofx_official](https://x.com/nofx_official)
+
+### 💼 시드 펀딩 라운드 진행 중
+
+현재 **시드 라운드** 자금을 조달 중입니다.
+
+**투자 문의**는 Twitter를 통해 **Tinkle**에게 DM을 보내주세요.
+
+---
+
+> ⚠️ **위험 경고**: 이 시스템은 실험적입니다. AI 자동 거래는 상당한 위험을 수반합니다. 학습/연구 목적 또는 소액 테스트용으로만 사용할 것을 강력히 권장합니다!
+
+## 👥 개발자 커뮤니티
+
+텔레그램 개발자 커뮤니티에 가입하여 토론하고, 아이디어를 공유하고, 지원을 받으세요:
+
+**💬 [NOFX 개발자 커뮤니티](https://t.me/nofx_dev_community)**
+
+---
+
+## 🆕 최신 업데이트
+
+### 🚀 다중 거래소 지원!
+
+NOFX는 이제 **세 개의 주요 거래소**를 지원합니다: Binance, Hyperliquid, Aster DEX!
+
+#### **Hyperliquid 거래소**
+
+고성능 탈중앙화 무기한 선물 거래소!
+
+**주요 기능:**
+- ✅ 완전한 거래 지원 (롱/숏, 레버리지, 손절/익절)
+- ✅ 자동 정밀도 처리 (주문 크기 및 가격)
+- ✅ 통합 트레이더 인터페이스 (원활한 거래소 전환)
+- ✅ 메인넷 및 테스트넷 모두 지원
+- ✅ API 키 불필요 - 이더리움 개인키만 필요
+
+**왜 Hyperliquid인가?**
+- 🔥 중앙화 거래소보다 낮은 수수료
+- 🔒 비수탁형 - 자산을 직접 관리
+- ⚡ 온체인 결제로 빠른 실행
+- 🌍 KYC 불필요
+
+**빠른 시작:**
+1. MetaMask 개인키 가져오기 (`0x` 접두사 제거)
+2. ~~config.json에서 `"exchange": "hyperliquid"` 설정~~ *웹 인터페이스를 통해 구성*
+3. `"hyperliquid_private_key": "your_key"` 추가
+4. 거래 시작!
+
+자세한 내용은 [구성 가이드](#-hyperliquid-거래소-사용)를 참조하세요.
+
+#### **Aster DEX 거래소** (신규! v2.0.2)
+
+바이낸스 호환 탈중앙화 무기한 선물 거래소!
+
+**주요 기능:**
+- ✅ 바이낸스 스타일 API (바이낸스에서 쉽게 마이그레이션)
+- ✅ Web3 지갑 인증 (안전하고 탈중앙화)
+- ✅ 자동 정밀도 처리와 완전한 거래 지원
+- ✅ CEX보다 낮은 거래 수수료
+- ✅ EVM 호환 (이더리움, BSC, 폴리곤 등)
+
+**왜 Aster인가?**
+- 🎯 **바이낸스 호환 API** - 최소한의 코드 변경 필요
+- 🔐 **API 지갑 시스템** - 보안을 위한 별도 거래 지갑
+- 💰 **경쟁력 있는 수수료** - 대부분의 중앙화 거래소보다 낮음
+- 🌐 **멀티체인 지원** - 선호하는 EVM 체인에서 거래
+
+**빠른 시작:**
+1. [Aster 추천 링크](https://www.asterdex.com/en/referral/fdfc0e)를 통해 등록 (수수료 할인 혜택!)
+2. [Aster API Wallet](https://www.asterdex.com/en/api-wallet) 방문
+3. 메인 지갑 연결 및 API 지갑 생성
+4. API Signer 주소와 개인키 복사
+5. config.json에서 `"exchange": "aster"` 설정
+6. `"aster_user"`, `"aster_signer"`, `"aster_private_key"` 추가
+
+---
+
+## 📸 시스템 스크린샷
+
+### 🏆 경쟁 모드 - 실시간 AI 배틀
+![경쟁 페이지](../../../screenshots/competition-page.png)
+*Qwen vs DeepSeek 실시간 거래 배틀을 보여주는 멀티 AI 리더보드와 실시간 성능 비교 차트*
+
+### 📊 트레이더 상세 - 완전한 거래 대시보드
+![상세 페이지](../../../screenshots/details-page.png)
+*자본 곡선, 실시간 포지션, 확장 가능한 입력 프롬프트와 사고 연쇄 추론이 포함된 AI 의사결정 로그가 있는 전문 거래 인터페이스*
+
+---
+
+> 📘 **참고**: 이것은 간소화된 한국어 버전 README입니다. 시스템 아키텍처, API 인터페이스 및 고급 구성을 포함한 전체 기술 문서는 [영문 버전](../../../README.md) 또는 [중문 버전](../zh-CN/README.md)을 참조하세요.
+
+---
+
+## ✨ 현재 구현 - 암호화폐 시장
+
+NOFX는 현재 다음과 같은 검증된 기능으로 **암호화폐 시장에서 완전히 운영**되고 있습니다:
+
+### 🏆 멀티 에이전트 경쟁 프레임워크
+- **실시간 에이전트 배틀**: Qwen vs DeepSeek 모델의 실시간 거래 경쟁
+- **독립적인 계정 관리**: 각 에이전트는 자체 의사결정 로그와 성능 지표 유지
+- **실시간 성능 비교**: 실시간 ROI 추적, 승률 통계, 1:1 분석
+- **자가 진화 루프**: 에이전트가 과거 성능에서 학습하여 지속적으로 개선
+
+### 🧠 AI 자가학습 및 최적화
+- **과거 피드백 시스템**: 각 의사결정 전 최근 20개 거래 주기 분석
+- **스마트 성능 분석**:
+  - 최고/최악 성과 자산 식별
+  - 실제 USDT 기준으로 승률, 손익비, 평균 수익 계산
+  - 반복되는 실수 회피 (연속 손실 패턴)
+  - 성공적인 전략 강화 (높은 승률 패턴)
+- **동적 전략 조정**: AI가 백테스트 결과를 기반으로 거래 스타일을 자율적으로 조정
+
+### 📊 범용 시장 데이터 레이어 (암호화폐 구현)
+- **멀티 타임프레임 분석**: 3분 실시간 + 4시간 트렌드 데이터
+- **기술적 지표**: EMA20/50, MACD, RSI(7/14), ATR
+- **미결제약정 추적**: 시장 심리, 자금 흐름 분석
+- **유동성 필터링**: 낮은 유동성 자산 자동 필터링 (<15M USD)
+- **크로스 거래소 지원**: 통합 데이터 인터페이스로 Binance, Hyperliquid, Aster DEX
+
+### 🎯 통합 리스크 관리 시스템
+- **포지션 제한**: 자산별 제한 (알트코인 ≤1.5x 자본, BTC/ETH ≤10x 자본)
+- **구성 가능한 레버리지**: 자산 클래스 및 계정 유형에 따라 1x에서 50x까지 동적 레버리지
+- **마진 관리**: 총 사용량 ≤90%, AI 제어 할당
+- **리스크-보상 강제**: 필수 ≥1:2 손절/익절 비율
+- **중복 방지**: 동일 자산/방향의 중복 포지션 방지
+
+### ⚡ 저지연 실행 엔진
+- **다중 거래소 API 통합**: Binance Futures, Hyperliquid DEX, Aster DEX
+- **자동 정밀도 처리**: 거래소별 스마트 주문 크기 및 가격 포맷팅
+- **우선순위 실행**: 기존 포지션 먼저 청산, 그 다음 신규 개설
+- **슬리피지 제어**: 실행 전 검증, 실시간 정밀도 체크
+
+### 🎨 전문 모니터링 인터페이스
+- **바이낸스 스타일 대시보드**: 실시간 업데이트가 있는 전문 다크 테마
+- **자본 곡선**: 과거 계정 가치 추적 (USD/백분율 전환)
+- **성능 차트**: 실시간 업데이트가 있는 멀티 에이전트 ROI 비교
+- **완전한 의사결정 로그**: 모든 거래에 대한 완전한 사고 연쇄(CoT) 추론
+- **5초 데이터 새로고침**: 실시간 계정, 포지션, P/L 업데이트
+
+---
+
+## 🔮 로드맵 - 범용 시장 확장
+
+NOFX의 미션은 모든 금융 시장을 위한 **범용 AI 트레이딩 OS**가 되는 것입니다.
+
+**비전:** 동일한 아키텍처. 동일한 에이전트 프레임워크. 모든 시장.
+
+**확장 시장:**
+- 📈 **주식 시장**: 미국 주식, A주, 홍콩 주식
+- 📊 **선물 시장**: 상품 선물, 지수 선물
+- 🎯 **옵션 거래**: 주식 옵션, 암호화폐 옵션
+- 💱 **외환 시장**: 주요 통화쌍, 교차 환율
+
+**예정된 기능:**
+- 향상된 AI 기능 (GPT-4, Claude 3, Gemini Pro, 유연한 프롬프트 템플릿)
+- 새로운 거래소 통합 (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
+- 프로젝트 구조 리팩토링 (높은 응집도, 낮은 결합도, SOLID 원칙)
+- 보안 강화 (API 키 AES-256 암호화, RBAC, 2FA 개선)
+- 사용자 경험 개선 (모바일 반응형, TradingView 차트, 알림 시스템)
+
+📖 **자세한 로드맵 및 일정은 다음을 참조하세요:**
+- **English:** [Roadmap Documentation](../../roadmap/README.md)
+- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
+
+---
+
+## 🏗️ 기술 아키텍처
+
+NOFX는 현대적이고 모듈화된 아키텍처로 구축되었습니다:
+
+- **백엔드:** Gin 프레임워크가 있는 Go, SQLite 데이터베이스
+- **프론트엔드:** React 18 + TypeScript + Vite + TailwindCSS
+- **다중 거래소 지원:** Binance, Hyperliquid, Aster DEX
+- **AI 통합:** DeepSeek, Qwen 및 사용자 정의 OpenAI 호환 API
+- **상태 관리:** 프론트엔드용 Zustand, 백엔드용 데이터베이스 기반
+- **실시간 업데이트:** 5-10초 폴링 간격의 SWR
+
+**주요 기능:**
+- 🗄️ 데이터베이스 기반 구성 (JSON 편집 불필요)
+- 🔐 선택적 2FA 지원이 있는 JWT 인증
+- 📊 실시간 성능 추적 및 분석
+- 🤖 실시간 비교가 있는 멀티 AI 경쟁 모드
+- 🔌 모든 구성 및 모니터링을 위한 RESTful API
+
+📖 **자세한 아키텍처 문서는 다음을 참조하세요:**
+- **English:** [Architecture Documentation](../../architecture/README.md)
+- **中文:** [架构文档](../../architecture/README.zh-CN.md)
+
+---
+
+## 💰 바이낸스 계정 등록 (수수료 절약!)
+
+이 시스템을 사용하기 전에 바이낸스 선물 계정이 필요합니다. **추천 링크를 사용하여 거래 수수료를 절약하세요:**
+
+**🎁 [바이낸스 등록 - 수수료 할인 받기](https://www.binance.com/join?ref=TINKLEVIP)**
+
+### 등록 단계:
+
+1. **위 링크를 클릭**하여 바이낸스 등록 페이지 방문
+2. 이메일/전화번호로 **등록 완료**
+3. **KYC 인증 완료** (선물 거래 필수)
+4. **선물 계정 활성화**:
+   - 바이낸스 홈페이지 → 파생상품 → USD-M 선물로 이동
+   - "지금 개설"을 클릭하여 선물 거래 활성화
+5. **API 키 생성**:
+   - 계정 → API 관리로 이동
+   - 새 API 키 생성, **"선물" 권한 활성화**
+   - API Key와 Secret Key 저장 (웹 인터페이스에 필요)
+   - **중요**: 보안을 위해 IP 주소를 화이트리스트에 추가
+
+### 수수료 할인 혜택:
+
+- ✅ **현물 거래**: 최대 30% 수수료 할인
+- ✅ **선물 거래**: 최대 30% 수수료 할인
+- ✅ **평생 유효**: 모든 거래에 대한 영구 할인
+
+---
+
+## 🚀 빠른 시작
+
+### 🐳 옵션 A: Docker 원클릭 배포 (가장 쉬움 - 초보자 권장!)
+
+**⚡ Docker로 3가지 간단한 단계로 거래 시작 - 설치 불필요!**
+
+Docker는 모든 종속성 (Go, Node.js, TA-Lib)과 환경 설정을 자동으로 처리합니다. 초보자에게 완벽합니다!
+
+#### 1단계: 구성 준비
+```bash
+# 구성 템플릿 복사
+cp config.json.example config.json
+
+# API 키를 입력하여 편집
+nano config.json  # 또는 원하는 편집기 사용
+```
+
+#### 2단계: 원클릭 시작
+```bash
+# 옵션 1: 편리한 스크립트 사용 (권장)
+chmod +x scripts/start.sh
+./scripts/start.sh start --build
+
+# 옵션 2: docker compose 직접 사용
+# 이 프로젝트는 Docker Compose V2 구문을 사용합니다 (공백 포함)
+# 이전 독립 실행형 `docker-compose`가 설치되어 있는 경우 Docker Desktop 또는 Docker 20.10+로 업그레이드하세요
+docker compose up -d --build
+```
+
+#### 3단계: 대시보드 접속
+브라우저에서 열기: **http://localhost:3000**
+
+**이게 전부입니다! 🎉** AI 트레이딩 시스템이 실행 중입니다!
+
+#### 시스템 관리
+```bash
+./scripts/start.sh logs      # 로그 보기
+./scripts/start.sh status    # 상태 확인
+./scripts/start.sh stop      # 서비스 중지
+./scripts/start.sh restart   # 서비스 재시작
+```
+
+**📖 자세한 Docker 배포 가이드, 문제 해결 및 고급 구성:**
+- **한국어**: Docker 문서 참조 (곧 제공 예정)
+- **English**: See [DOCKER_DEPLOY.en.md](../../getting-started/docker-deploy.en.md)
+- **中文**: 查看 [DOCKER_DEPLOY.md](../../getting-started/docker-deploy.zh-CN.md)
+
+---
+
+### 📦 옵션 B: 수동 설치 (개발자용)
+
+**참고**: 위의 Docker 배포를 사용한 경우 이 섹션을 건너뛰세요. 수동 설치는 코드를 수정하거나 Docker 없이 실행하려는 경우에만 필요합니다.
+
+### 1. 환경 요구 사항
+
+- **Go 1.21+**
+- **Node.js 18+**
+- **TA-Lib** 라이브러리 (기술적 지표 계산)
+
+#### TA-Lib 설치
+
+**macOS:**
+```bash
+brew install ta-lib
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get install libta-lib0-dev
+```
+
+**다른 시스템**: [TA-Lib 공식 문서](https://github.com/markcheno/go-talib) 참조
+
+### 2. 프로젝트 클론
+
+```bash
+git clone https://github.com/tinkle-community/nofx.git
+cd nofx
+```
+
+### 3. 종속성 설치
+
+**백엔드:**
+```bash
+go mod download
+```
+
+**프론트엔드:**
+```bash
+cd web
+npm install
+cd ..
+```
+
+### 4. AI API 키 가져오기
+
+시스템을 구성하기 전에 AI API 키를 가져와야 합니다. 다음 AI 제공업체 중 하나를 선택하세요:
+
+#### 옵션 1: DeepSeek (초보자 권장)
+
+**왜 DeepSeek인가?**
+- 💰 GPT-4보다 저렴 (약 1/10 비용)
+- 🚀 빠른 응답 시간
+- 🎯 우수한 거래 결정 품질
+- 🌍 VPN 없이 전 세계에서 작동
+
+**DeepSeek API 키 가져오는 방법:**
+
+1. **방문**: [https://platform.deepseek.com](https://platform.deepseek.com)
+2. **등록**: 이메일/전화번호로 가입
+3. **인증**: 이메일/전화 인증 완료
+4. **충전**: 계정에 크레딧 추가
+   - 최소: ~$5 USD
+   - 권장: 테스트용 $20-50 USD
+5. **API 키 생성**:
+   - API Keys 섹션으로 이동
+   - "새 키 생성" 클릭
+   - 키 복사 및 저장 (`sk-`로 시작)
+   - ⚠️ **중요**: 즉시 저장하세요 - 다시 볼 수 없습니다!
+
+**가격**: 약 100만 토큰당 $0.14 (매우 저렴!)
+
+#### 옵션 2: Qwen (Alibaba Cloud)
+
+**Qwen API 키 가져오는 방법:**
+
+1. **방문**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
+2. **등록**: Alibaba Cloud 계정으로 가입
+3. **서비스 활성화**: DashScope 서비스 활성화
+4. **API 키 생성**:
+   - API 키 관리로 이동
+   - 새 키 생성
+   - 복사 및 저장 (`sk-`로 시작)
+
+**참고**: 등록을 위해 중국 전화번호가 필요할 수 있습니다
+
+---
+
+### 5. 시스템 구성
+
+**두 가지 구성 모드 사용 가능:**
+- **🌟 초보자 모드**: 단일 트레이더 + 기본 코인 (권장!)
+- **⚔️ 전문가 모드**: 다중 트레이더 경쟁
+
+#### 🌟 초보자 모드 구성 (권장)
+
+**1단계**: 예제 구성 파일 복사 및 이름 변경
+
+```bash
+cp config.json.example config.json
+```
+
+**2단계**: `config.json` 편집 및 API 키 입력
+
+*이제 웹 인터페이스를 통해 구성하므로 JSON 파일 편집이 필요 없습니다*
+
+---
+
+## 📖 AI 의사결정 흐름
+
+각 의사결정 주기 (기본 3분)마다 시스템은 다음 프로세스를 실행합니다:
+
+### 1단계: 📊 과거 성능 분석 (최근 20주기)
+- ✓ 전체 승률, 평균 수익, 손익비 계산
+- ✓ 코인별 통계 (승률, USDT 평균 손익)
+- ✓ 최고/최악 성과 코인 식별
+- ✓ 정확한 손익이 포함된 최근 5개 거래 세부 정보 나열
+- ✓ 리스크 조정 성능에 대한 샤프 비율 계산
+- 📌 **신규 (v2.0.2)**: 레버리지를 고려한 정확한 USDT 손익
+
+**↓**
+
+### 2단계: 💰 계정 상태 가져오기
+- 총 자본 및 사용 가능 잔액
+- 미결 포지션 수 및 미실현 손익
+- 마진 사용률 (AI가 최대 90%까지 관리)
+- 일일 손익 추적 및 손실폭 모니터링
+
+**↓**
+
+### 3단계: 🔍 기존 포지션 분석 (있는 경우)
+- 각 포지션에 대해 최신 시장 데이터 가져오기
+- 실시간 기술적 지표 계산:
+  - 3분 K선: RSI(7), MACD, EMA20
+  - 4시간 K선: RSI(14), EMA20/50, ATR
+- 포지션 보유 기간 추적 (예: "2시간 15분")
+- 📌 **신규 (v2.0.2)**: 각 포지션의 보유 기간 표시
+- 표시: 진입 가격, 현재 가격, 손익%, 기간
+- AI 평가: 보유할지 청산할지?
+
+**↓**
+
+### 4단계: 🎯 새로운 기회 평가 (후보 코인)
+- 코인 풀 가져오기 (2가지 모드):
+  - 🌟 **기본 모드**: BTC, ETH, SOL, BNB, XRP 등
+  - ⚙️ **고급 모드**: AI500 (상위 20) + OI Top (상위 20)
+- 후보 코인 병합 및 중복 제거
+- 필터: 낮은 유동성 제거 (<15M USD OI 가치)
+- 시장 데이터 + 기술적 지표 일괄 가져오기
+- 변동성, 추세 강도, 거래량 급등 계산
+
+**↓**
+
+### 5단계: 🧠 AI 종합 의사결정 (DeepSeek/Qwen)
+- 과거 피드백 검토:
+  - 최근 승률 및 수익 요인
+  - 최고/최악 코인 성과
+  - 반복되는 실수 회피
+- 모든 원시 시퀀스 데이터 분석:
+  - 3분 가격 시퀀스, 4시간 K선 시퀀스
+  - 완전한 지표 시퀀스 (최신만이 아님)
+  - 📌 **신규 (v2.0.2)**: AI가 분석할 완전한 자유
+- 사고 연쇄(CoT) 추론 프로세스
+- 구조화된 의사결정 출력:
+  - 액션: `close_long` / `close_short` / `open_long` / `open_short`
+  - 코인 심볼, 수량, 레버리지
+  - 손절 및 익절 수준 (≥1:2 비율)
+- 의사결정: 대기 / 보유 / 청산 / 개설
+
+**↓**
+
+### 6단계: ⚡ 거래 실행
+- 우선순위: 기존 포지션 청산 → 그 다음 신규 개설
+- 실행 전 리스크 체크:
+  - 포지션 크기 제한 (알트코인 1.5x, BTC 10x)
+  - 중복 포지션 없음 (동일 코인 + 방향)
+  - 90% 한도 내 마진 사용
+- 바이낸스 LOT_SIZE 정밀도 자동 가져오기 및 적용
+- 바이낸스 선물 API를 통해 주문 실행
+- 청산 후: 모든 보류 주문 자동 취소
+- 실제 실행 가격 및 주문 ID 기록
+- 📌 기간 계산을 위한 포지션 개설 시간 추적
+
+**↓**
+
+### 7단계: 📝 완전한 로그 기록 및 성능 업데이트
+- 의사결정 로그를 `decision_logs/{trader_id}/`에 저장
+- 로그 포함 내용:
+  - 완전한 사고 연쇄(CoT)
+  - 모든 시장 데이터가 포함된 입력 프롬프트
+  - 구조화된 의사결정 JSON
+  - 계정 스냅샷 (잔액, 포지션, 마진)
+  - 실행 결과 (성공/실패, 가격)
+- 성능 데이터베이스 업데이트:
+  - `symbol_side` 키로 개설/청산 쌍 매칭
+  - 📌 **신규**: 롱/숏 충돌 방지
+  - 정확한 USDT 손익 계산:
+    - `손익 = 포지션 가치 × 가격 변화% × 레버리지`
+  - 📌 **신규**: 수량 + 레버리지 고려
+  - 저장: 수량, 레버리지, 개설 시간, 청산 시간
+  - 업데이트: 승률, 수익 요인, 샤프 비율
+- 성능 데이터가 다음 주기로 피드백
+
+**↓**
+
+**🔄 (3-5분마다 반복)**
+
+---
+
+## 🧠 AI 자가학습 예시
+
+### 과거 피드백 (프롬프트에 자동 추가)
+
+```markdown
+## 📊 과거 성능 피드백
+
+### 전체 성능
+- **총 거래**: 15건 (수익: 8 | 손실: 7)
+- **승률**: 53.3%
+- **평균 수익**: +3.2% | 평균 손실: -2.1%
+- **손익비**: 1.52:1
+
+### 최근 거래
+1. BTCUSDT LONG: 95000.0000 → 97500.0000 = +2.63% ✓
+2. ETHUSDT SHORT: 3500.0000 → 3450.0000 = +1.43% ✓
+3. SOLUSDT LONG: 185.0000 → 180.0000 = -2.70% ✗
+4. BNBUSDT LONG: 610.0000 → 625.0000 = +2.46% ✓
+5. ADAUSDT LONG: 0.8500 → 0.8300 = -2.35% ✗
+
+### 코인 성능
+- **최고**: BTCUSDT (승률 75%, 평균 +2.5%)
+- **최악**: SOLUSDT (승률 25%, 평균 -1.8%)
+```
+
+### AI가 피드백을 사용하는 방법
+
+1. **연속 손실 회피**: SOLUSDT에서 3번 연속 손절을 보고 AI가 회피하거나 더 신중해짐
+2. **성공적인 전략 강화**: BTC 돌파 롱이 75% 승률로 AI가 이 패턴을 계속함
+3. **동적 스타일 조정**: 승률 <40% → 보수적; 손익비 >2 → 공격적 유지
+4. **시장 상황 식별**: 연속 손실은 변동성 높은 시장을 나타낼 수 있으며 거래 빈도 감소
+
+---
+
+## 📊 웹 인터페이스 기능
+
+### 1. 경쟁 페이지
+
+- **🏆 리더보드**: 실시간 ROI 순위, 리더 강조 표시용 골드 테두리
+- **📈 성능 비교**: 듀얼 AI ROI 곡선 비교 (보라색 vs 파란색)
+- **⚔️ 1:1 대결**: 리드 마진을 보여주는 직접 비교
+- **실시간 데이터**: 총 자본, 손익%, 포지션 수, 마진 사용
+
+### 2. 상세 페이지
+
+- **자본 곡선**: 과거 추세 차트 (USD/백분율 전환)
+- **통계**: 총 주기, 성공/실패, 개설/청산 통계
+- **포지션 테이블**: 모든 포지션 세부 정보 (진입 가격, 현재 가격, 손익%, 청산 가격)
+- **AI 의사결정 로그**: 최근 의사결정 기록 (확장 가능한 CoT)
+
+### 3. 실시간 업데이트
+
+- 시스템 상태, 계정 정보, 포지션 목록: **5초마다 새로고침**
+- 의사결정 로그, 통계: **10초마다 새로고침**
+- 자본 차트: **10초마다 새로고침**
+
+---
+
+## ⚠️ 중요한 위험 경고
+
+### 거래 위험
+
+1. **암호화폐 시장은 극도로 변동성이 높습니다**, AI 의사결정이 수익을 보장하지 않습니다
+2. **선물 거래는 레버리지를 사용합니다**, 손실이 원금을 초과할 수 있습니다
+3. **극단적인 시장 상황**은 청산 위험으로 이어질 수 있습니다
+4. **펀딩 비율**은 보유 비용에 영향을 줄 수 있습니다
+5. **유동성 위험**: 일부 코인은 슬리피지를 경험할 수 있습니다
+
+### 기술적 위험
+
+1. **네트워크 지연**은 가격 슬리피지를 유발할 수 있습니다
+2. **API 속도 제한**은 거래 실행에 영향을 줄 수 있습니다
+3. **AI API 시간 초과**는 의사결정 실패를 유발할 수 있습니다
+4. **시스템 버그**는 예기치 않은 동작을 유발할 수 있습니다
+
+### 사용 권장 사항
+
+✅ **권장**
+- 테스트를 위해 손실을 감당할 수 있는 자금만 사용
+- 소액으로 시작 (100-500 USDT 권장)
+- 시스템 작동 상태를 정기적으로 확인
+- 계정 잔액 변화 모니터링
+- AI 의사결정 로그를 분석하여 전략 이해
+
+❌ **권장하지 않음**
+- 모든 자금 또는 빌린 돈 투자
+- 장기간 감독 없이 실행
+- AI 의사결정을 맹목적으로 신뢰
+- 시스템을 이해하지 않고 사용
+- 극단적인 시장 변동성 중 실행
+
+---
+
+## 🛠️ 일반적인 문제
+
+### 1. 컴파일 오류: TA-Lib을 찾을 수 없음
+
+**해결책**: TA-Lib 라이브러리 설치
+```bash
+# macOS
+brew install ta-lib
+
+# Ubuntu
+sudo apt-get install libta-lib0-dev
+```
+
+### 2. 정밀도 오류: 정밀도가 최대값을 초과
+
+**해결책**: 시스템이 바이낸스 LOT_SIZE에서 정밀도를 자동 처리합니다. 오류가 지속되면 네트워크 연결을 확인하세요.
+
+### 3. AI API 시간 초과
+
+**해결책**:
+- API 키가 올바른지 확인
+- 네트워크 연결 확인 (프록시가 필요할 수 있음)
+- 시스템 시간 초과는 120초로 설정됨
+
+### 4. 프론트엔드가 백엔드에 연결할 수 없음
+
+**해결책**:
+- 백엔드가 실행 중인지 확인 (http://localhost:8080)
+- 포트 8080이 사용 중인지 확인
+- 브라우저 콘솔에서 오류 확인
+
+### 5. 코인 풀 API 실패
+
+**해결책**:
+- 코인 풀 API는 선택 사항입니다
+- API가 실패하면 시스템은 기본 주류 코인을 사용합니다 (BTC, ETH 등)
+- 웹 인터페이스에서 구성 확인
+
+---
+
+## 📈 성능 최적화 팁
+
+1. **합리적인 의사결정 주기 설정**: 3-5분 권장, 과도한 거래 회피
+2. **후보 코인 수 제어**: 시스템 기본값은 AI500 상위 20 + OI Top 상위 20
+3. **로그 정기적으로 정리**: 과도한 디스크 사용 회피
+4. **API 호출 수 모니터링**: 바이낸스 속도 제한 트리거 회피
+5. **소액 자본으로 테스트**: 전략 검증을 위해 먼저 100-500 USDT로 테스트
+
+---
+
+## 🔄 변경 로그
+
+📖 **자세한 버전 기록 및 업데이트는 다음을 참조하세요:**
+
+- **한국어:** [CHANGELOG.zh-CN.md](../../../CHANGELOG.zh-CN.md)
+- **English:** [CHANGELOG.md](../../../CHANGELOG.md)
+
+**최신 릴리스:** v3.0.0 (2025-10-30) - 주요 아키텍처 변환
+
+**최근 하이라이트:**
+- 🚀 웹 기반 구성으로 전체 시스템 재설계
+- 🗄️ 데이터베이스 기반 아키텍처 (SQLite)
+- 🎨 JSON 편집 불필요 - 웹 인터페이스를 통한 모든 구성
+- 🔧 AI 모델을 모든 거래소와 혼합 및 매칭
+- 📊 포괄적인 엔드포인트가 있는 향상된 API 레이어
+- 🔐 JWT 인증 + 2FA 지원
+- 🌐 사용자 정의 API 지원 (OpenAI 호환)
+- 📈 원격 인증이 있는 프롬프트 템플릿 시스템
+
+**⚡ AI의 힘으로 정량적 거래의 가능성을 탐험하세요!**
+
+---
+
+## 📄 라이선스
+
+이 프로젝트는 **GNU Affero 일반 공중 라이선스 v3.0 (AGPL-3.0)** 하에 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
+
+**이것이 의미하는 바:**
+- ✅ 이 소프트웨어를 사용, 수정 및 배포할 수 있습니다
+- ✅ 수정 버전의 소스 코드를 공개해야 합니다
+- ✅ 서버에서 수정 버전을 실행하는 경우 사용자에게 소스 코드를 제공해야 합니다
+- ✅ 모든 파생물도 AGPL-3.0 하에 라이선스가 부여되어야 합니다
+
+상업적 라이선스 또는 질문이 있는 경우 유지 관리자에게 문의하세요.
+
+---
+
+## 🤝 기여하기
+
+Issue 및 Pull Request를 환영합니다!
+
+### 개발 가이드
+
+1. 프로젝트 포크
+2. 기능 브랜치 생성 (`git checkout -b feature/AmazingFeature`)
+3. 변경 사항 커밋 (`git commit -m 'Add some AmazingFeature'`)
+4. 브랜치에 푸시 (`git push origin feature/AmazingFeature`)
+5. Pull Request 열기
+
+---
+
+## 📬 연락처
+
+### 🐛 기술 지원
+- **GitHub Issues**: [Issue 제출](https://github.com/tinkle-community/nofx/issues)
+- **개발자 커뮤니티**: [텔레그램 그룹](https://t.me/nofx_dev_community)
+
+---
+
+## 🙏 감사의 말
+
+- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - 바이낸스 선물 API
+- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API
+- [Qwen](https://dashscope.console.aliyun.com/) - Alibaba Cloud Qwen
+- [TA-Lib](https://ta-lib.org/) - 기술적 지표 라이브러리
+- [Recharts](https://recharts.org/) - React 차트 라이브러리
+
+---
+
+**마지막 업데이트**: 2025-10-30 (v3.0.0)
+
+**⚡ AI의 힘으로 정량적 거래의 가능성을 탐험하세요!**
+
+---
+
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=tinkle-community/nofx&type=Date)](https://star-history.com/#tinkle-community/nofx&Date)
diff --git a/docs/i18n/ru/README.md b/docs/i18n/ru/README.md
index a87c4804..d73e55c9 100644
--- a/docs/i18n/ru/README.md
+++ b/docs/i18n/ru/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
 
-**Языки / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md)
+**Языки / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md)
 
 **📚 Документация:** [Главная](../../README.md) | [Начало работы](../../getting-started/README.md) | [Журнал изменений](../../../CHANGELOG.zh-CN.md) | [Сообщество](../../community/README.md)
 
diff --git a/docs/i18n/uk/README.md b/docs/i18n/uk/README.md
index 155273ea..cc590f85 100644
--- a/docs/i18n/uk/README.md
+++ b/docs/i18n/uk/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
 
-**Мови / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md)
+**Мови / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md)
 
 **📚 Документація:** [Головна](../../README.md) | [Початок роботи](../../getting-started/README.md) | [Спільнота](../../community/README.md) | [Журнал Змін](../../../CHANGELOG.md)
 
diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md
index 4d8885b4..74a8d86d 100644
--- a/docs/i18n/zh-CN/README.md
+++ b/docs/i18n/zh-CN/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](https://amber.ac)
 
-**语言 / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md)
+**语言 / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md)
 
 **📚 文档中心:** [文档首页](../../README.md) | [快速开始](../../getting-started/README.zh-CN.md) | [更新日志](../../../CHANGELOG.zh-CN.md) | [社区指南](../../community/README.md)