# ⛏️ Crypto Mining Profitability System

نظام ويب متكامل لحساب أرباح تعدين العملات الرقمية بدقة عالية.

## 🏗️ المكونات

| المكون | التقنية |
|--------|---------|
| Backend | Python FastAPI |
| Frontend | React + Tailwind CSS |
| Database | MySQL |
| AI | OpenRouter (GPT-4o-mini) |
| Prices | CoinGecko API |

## 🚀 التشغيل السريع

### Windows
```bat
start.bat
```

### Linux / Mac
```bash
chmod +x start.sh && ./start.sh
```

## ⚙️ الإعداد اليدوي

### 1. قاعدة البيانات
```bash
mysql -u root -p < database/schema.sql
```

### 2. Backend
```bash
cd backend
cp .env.example .env
# عدّل .env وضع مفاتيح API الخاصة بك

python -m venv venv
source venv/bin/activate       # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload
```

### 3. Frontend
```bash
cd frontend
npm install
npm run dev
```

## 🔑 متغيرات البيئة (.env)

```env
# MySQL
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=crypto_mining

# OpenRouter AI (https://openrouter.ai)
OPENROUTER_API_KEY=sk-or-...
OPENROUTER_MODEL=openai/gpt-4o-mini

# CoinGecko (اختياري - مجاني يكفي)
COINGECKO_API_KEY=

# أمان التطبيق
API_SECRET_KEY=change-me-in-production
APP_ENV=development
```

## 📡 API Endpoints

| Method | Endpoint | الوصف |
|--------|----------|-------|
| GET | `/miners/` | قائمة كل الأجهزة |
| GET | `/miners/search?q=` | بحث للاقتراح التلقائي |
| GET | `/miners/stats/summary` | إحصائيات عامة |
| POST | `/calculate/` | حساب الأرباح |
| POST | `/calculate/compare` | مقارنة أجهزة متعددة |
| POST | `/ai/recommend` | توصية الذكاء الاصطناعي |
| POST | `/seed/miners/sync` | تعبئة قاعدة البيانات |
| GET | `/seed/status` | حالة الـ Seeder |
| GET | `/health` | فحص صحة النظام |
| GET | `/docs` | Swagger UI |

## 🧮 معادلة الحساب

```
# الكهرباء
kWh / يوم = (الواط ÷ 1000) × 24
تكلفة يومية (ر.س) = kWh × سعر الكهرباء

# الإيراد
حصة المعدّن = Hashrate الجهاز ÷ Hashrate الشبكة
عملات / يوم = (86400 ÷ وقت البلوك) × مكافأة البلوك × الحصة
إيراد / يوم (USD) = عملات × سعر العملة

# الربح
صافي الربح = الإيراد - التكلفة
```

## 🛡️ الأمان

- Rate Limiting: 60 طلب/دقيقة
- API Key Authentication (production)
- CORS محدود للنطاقات المسموحة
- Unique Index يمنع تكرار البيانات

## 📁 هيكل المشروع

```
crypto-mining-system/
├── backend/
│   ├── app/
│   │   ├── main.py            # FastAPI app
│   │   ├── config.py          # Settings
│   │   ├── database.py        # SQLAlchemy
│   │   ├── models/miner.py    # Miner model
│   │   ├── routers/
│   │   │   ├── miners.py      # GET/search miners
│   │   │   ├── calculate.py   # Profit calculator
│   │   │   ├── ai.py          # AI recommendations
│   │   │   └── seed.py        # DB seeder
│   │   └── services/
│   │       ├── openrouter.py  # AI integration
│   │       ├── coingecko.py   # Price fetching
│   │       ├── mining_calculator.py
│   │       └── seeder.py      # Smart seeder logic
│   └── requirements.txt
├── frontend/
│   └── src/
│       ├── pages/             # Dashboard, Calculator, Compare
│       ├── components/        # Form, Results, Charts
│       ├── services/api.js    # Axios client
│       └── hooks/useMiners.js
├── database/schema.sql
├── start.bat                  # Windows launcher
└── start.sh                   # Linux/Mac launcher
```