# خدمة SMTP API - نظام إرسال البريد الإلكتروني

نظام متكامل لإرسال البريد الإلكتروني عبر REST API باستخدام بيانات SMTP الخاصة بك.

**الموقع**: https://easy-orders.co.uk

![SMTP API Service](preview.png)

## 🌟 المميزات

- **🔐 نظام مصادقة آمن** - مصادقة基于 JWT
- **🔑 إدارة مفاتيح API** - إنشاء وإدارة مفاتيح متعددة
- **📧 إعدادات SMTP** - دعم خوادم SMTP متعددة
- **📨 إرسال البريد** - إرسال بريد عبر API أو الواجهة الرسومية
- **📊 لوحة تحكم** - تتبع استخدام البريد والإحصائيات
- **📚 توثيق API** - توثيق كامل مع أمثلة
- **🎨 واجهة عصرية** - تصميم نظيف ومتجاوب

## 🚀 البدء السريع

### المتطلبات

- Python 3.8+
- Nginx (للإنتاج)

### التثبيت

```bash
# نسخ المستودع
git clone https://github.com/yourusername/smtp-api-service.git
cd smtp-api-service

# تشغيل المثبت
chmod +x install-easy-orders.sh
sudo ./install-easy-orders.sh
```

سيكون الموقع متاحاً على: **https://easy-orders.co.uk**

## 📖 طريقة الاستخدام

### 1. إنشاء حساب

1. افتح https://easy-orders.co.uk
2. اضغط "سجل الآن" وأنشئ حسابك
3. سجل الدخول للوصول للوحة التحكم

### 2. إعداد SMTP

1. اذهب إلى "إعدادات SMTP"
2. اضغط "إضافة إعدادات"
3. أدخل بيانات خادم SMTP

### 3. إنشاء مفتاح API

1. اذهب إلى "مفاتيح API"
2. اضغط "إنشاء مفتاح جديد"
3. انسخ المفتاح واحتفظ به

### 4. إرسال بريد عبر API

```bash
curl -X POST https://easy-orders.co.uk/api/v1/public/send-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "to_email": "recipient@example.com",
    "subject": "Hello",
    "body": "This is a test email"
  }'
```

## 🔌 نقاط النهاية

| النقطة | الطريقة | الوصف |
|--------|---------|-------|
| `/api/v1/auth/register` | POST | تسجيل مستخدم جديد |
| `/api/v1/auth/login` | POST | تسجيل دخول |
| `/api/v1/api-keys` | GET/POST | إدارة مفاتيح API |
| `/api/v1/smtp-configs` | GET/POST | إدارة إعدادات SMTP |
| `/api/v1/emails/send` | POST | إرسال بريد |
| `/api/v1/public/send-email` | POST | نقطة النهاية العامة |

التوثيق الكامل: https://easy-orders.co.uk/docs

## 🛠️ التقنيات المستخدمة

### Backend
- **FastAPI** - إطار عمل Python
- **SQLAlchemy** - ORM
- **SQLite** - قاعدة البيانات
- **JWT** - المصادقة

### Frontend
- **HTML5/CSS3/JavaScript**
- **Tailwind CSS** - التصميم

## 🔒 الأمان

- استخدم HTTPS في الإنتاج
- احتفظ بمفاتيح API في مكان آمن
- استخدم App Passwords لـ Gmail
- قم بتدوير المفاتيح بانتظام

## 📄 الترخيص

MIT License

---

**الموقع**: https://easy-orders.co.uk
