refactor: reorganize project structure — consolidate Docker files, clean root
- Delete temp files: _tmp_analysis.py, nul, dashboard_screenshot.png - Move ea/ to archive/ea/ (deprecated) - Move 12 Docker helper scripts (.bat/.sh) to docker/scripts/ - Move 5 Docker docs to docker/docs/ - Move .env.docker.example, requirements-docker.txt to docker/ - Update all scripts with cd to project root for correct path resolution - Update all doc references to new paths - Update .gitignore with bot.pid, bot_output.log, *.png patterns - Update CLAUDE.md, README.md directory trees Root reduced from ~40 files to 12 essential files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,170 @@
|
||||
# Simple Start Guide - XAUBot AI Dashboard
|
||||
|
||||
## 🎯 Cara Tercepat (1 Command)
|
||||
|
||||
```cmd
|
||||
docker\scripts\start-all.bat
|
||||
```
|
||||
|
||||
Script ini akan:
|
||||
1. ✅ Check database Docker container
|
||||
2. 🚀 Start Trading API di http://localhost:8000
|
||||
3. 🚀 Start Dashboard di http://localhost:3000
|
||||
|
||||
Dua window akan terbuka otomatis!
|
||||
|
||||
## 📋 Manual Start (Jika Perlu)
|
||||
|
||||
### Option 1: Start Semua Sekaligus
|
||||
```cmd
|
||||
docker\scripts\start-all.bat
|
||||
```
|
||||
|
||||
### Option 2: Start Satu-satu
|
||||
|
||||
**Terminal 1: API**
|
||||
```cmd
|
||||
docker\scripts\start-api.bat
|
||||
```
|
||||
|
||||
**Terminal 2: Dashboard**
|
||||
```cmd
|
||||
docker\scripts\start-dashboard.bat
|
||||
```
|
||||
|
||||
## ✅ Pre-requisites
|
||||
|
||||
### 1. Database (Docker)
|
||||
Database harus sudah running:
|
||||
```cmd
|
||||
# Check status
|
||||
docker ps | findstr trading_bot_db
|
||||
|
||||
# Start jika belum running
|
||||
docker-compose up -d postgres
|
||||
```
|
||||
|
||||
### 2. Python Environment
|
||||
- Python 3.11+ installed
|
||||
- Virtual environment akan dibuat otomatis
|
||||
|
||||
### 3. Node.js
|
||||
- Node.js 18+ installed
|
||||
- npm dependencies akan diinstall otomatis
|
||||
|
||||
## 🌐 Access Points
|
||||
|
||||
Setelah start:
|
||||
- **Dashboard:** http://localhost:3000
|
||||
- **API:** http://localhost:8000
|
||||
- **API Docs:** http://localhost:8000/docs
|
||||
- **Health Check:** http://localhost:8000/api/health
|
||||
- **Status:** http://localhost:8000/api/status
|
||||
|
||||
## 🛑 Stop Services
|
||||
|
||||
Close kedua command windows atau tekan `Ctrl+C` di masing-masing window.
|
||||
|
||||
## 🔍 Troubleshooting
|
||||
|
||||
### API Error: "Module not found"
|
||||
|
||||
Install dependencies:
|
||||
```cmd
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### Dashboard Error: "Module not found"
|
||||
|
||||
Install dependencies:
|
||||
```cmd
|
||||
cd web-dashboard
|
||||
npm install
|
||||
```
|
||||
|
||||
### Port Already in Use
|
||||
|
||||
**Change API Port:**
|
||||
Edit `web-dashboard/api/main.py` line terakhir:
|
||||
```python
|
||||
uvicorn.run(app, host="0.0.0.0", port=8001) # Change 8000 to 8001
|
||||
```
|
||||
|
||||
**Change Dashboard Port:**
|
||||
Edit `web-dashboard/.env.local`:
|
||||
```
|
||||
NEXT_PUBLIC_API_URL=http://localhost:8001
|
||||
```
|
||||
|
||||
Then start dashboard on different port:
|
||||
```cmd
|
||||
cd web-dashboard
|
||||
set PORT=3001 && npm run dev
|
||||
```
|
||||
|
||||
### Database Not Running
|
||||
|
||||
Start database:
|
||||
```cmd
|
||||
docker-compose up -d postgres
|
||||
|
||||
# Check status
|
||||
docker ps
|
||||
```
|
||||
|
||||
## 📊 Architecture
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ Windows Host Machine │
|
||||
├─────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📊 Dashboard (Port 3000) │
|
||||
│ npm run dev │
|
||||
│ ↓ HTTP │
|
||||
│ 🔌 API (Port 8000) │
|
||||
│ uvicorn main:app │
|
||||
│ ↓ PostgreSQL │
|
||||
│ 🗄️ Database (Docker) │
|
||||
│ trading_bot_db │
|
||||
│ │
|
||||
└─────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 🎨 Features
|
||||
|
||||
Dashboard akan menampilkan:
|
||||
- ⏰ Real-time XAUUSD price
|
||||
- 💰 Account balance & equity
|
||||
- 📈 Price history chart
|
||||
- 🎯 Trading signals (SMC + ML)
|
||||
- 🌊 Market regime
|
||||
- ⚠️ Risk status
|
||||
- 📋 Open positions
|
||||
- 📝 Activity logs
|
||||
|
||||
## 💡 Tips
|
||||
|
||||
1. **Auto-start Database:**
|
||||
Tambahkan Docker Desktop ke Windows startup
|
||||
|
||||
2. **Keep API Running:**
|
||||
Minimize command windows, jangan close
|
||||
|
||||
3. **Monitor Logs:**
|
||||
Lihat output di command windows untuk debug
|
||||
|
||||
4. **Quick Restart:**
|
||||
Close windows dan run `docker\scripts\start-all.bat` lagi
|
||||
|
||||
## 📝 Files
|
||||
|
||||
```
|
||||
docker\scripts\start-all.bat # Start API + Dashboard
|
||||
docker\scripts\start-api.bat # Start API only
|
||||
docker\scripts\start-dashboard.bat # Start Dashboard only
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Super Simple!** Tinggal double-click `docker\scripts\start-all.bat` 🎉
|
||||
Reference in New Issue
Block a user