═══════════════════════════════════════════════════════════════
                    SMTP API Service
              خدمة إرسال البريد الإلكتروني عبر API
═══════════════════════════════════════════════════════════════

🌐 الموقع: https://easy-orders.co.uk
📚 API Docs: https://easy-orders.co.uk/docs
🔌 API Base: https://easy-orders.co.uk/api/v1

═══════════════════════════════════════════════════════════════

📁 هيكل المشروع:
─────────────────
smtp-api-service/
├── backend/              ← Python FastAPI Backend
│   ├── main.py          ← نقطة الدخول الرئيسية
│   ├── auth.py          ← نظام المصادقة
│   ├── database.py      ← نماذج قاعدة البيانات
│   ├── email_service.py ← خدمة إرسال البريد
│   ├── api_key_service.py ← إدارة مفاتيح API
│   ├── schemas.py       ← نماذج البيانات
│   ├── config.py        ← الإعدادات
│   ├── requirements.txt ← المتطلبات
│   └── .env             ← إعدادات البيئة
│
├── frontend/            ← الواجهة الأمامية
│   └── index.html       ← تطبيق HTML/JavaScript
│
├── nginx/               ← إعدادات Nginx
│   └── easy-orders.conf
│
├── install-easy-orders.sh  ← سكريبت التثبيت التلقائي
├── docker-compose.yml   ← Docker Compose
├── DEPLOY_EASY_ORDERS.md   ← دليل النشر
├── README.md            ← التوثيق بالإنجليزية
├── README_AR.md         ← التوثيق بالعربية
└── INFO.txt             ← هذا الملف


═══════════════════════════════════════════════════════════════

🚀 طريقة النشر السريع:
────────────────────────

1. انسخ الملفات للسيرفر:
   scp -r smtp-api-service root@YOUR_SERVER_IP:/opt/

2. شغل سكريبت التثبيت:
   cd /opt/smtp-api-service
   chmod +x install-easy-orders.sh
   ./install-easy-orders.sh

3. افتح المتصفح:
   https://easy-orders.co.uk


═══════════════════════════════════════════════════════════════

📖 خطوات الاستخدام:
───────────────────
1. أنشئ حساباً من https://easy-orders.co.uk
2. أضف إعدادات SMTP الخاصة بك
3. أنشئ مفتاح API
4. ابدأ بإرسال البريد!


═══════════════════════════════════════════════════════════════

🔌 API Endpoints:
─────────────────
POST https://easy-orders.co.uk/api/v1/auth/register
POST https://easy-orders.co.uk/api/v1/auth/login
GET  https://easy-orders.co.uk/api/v1/auth/me

GET  https://easy-orders.co.uk/api/v1/api-keys
POST https://easy-orders.co.uk/api/v1/api-keys

GET  https://easy-orders.co.uk/api/v1/smtp-configs
POST https://easy-orders.co.uk/api/v1/smtp-configs

POST https://easy-orders.co.uk/api/v1/emails/send
GET  https://easy-orders.co.uk/api/v1/emails/logs

POST https://easy-orders.co.uk/api/v1/public/send-email


═══════════════════════════════════════════════════════════════

📧 إعدادات SMTP شائعة:
──────────────────────
Gmail:
  Host: smtp.gmail.com
  Port: 587
  TLS: Yes
  Note: يتطلب App Password

Outlook:
  Host: smtp.office365.com
  Port: 587
  TLS: Yes

Yahoo:
  Host: smtp.mail.yahoo.com
  Port: 587
  TLS: Yes


═══════════════════════════════════════════════════════════════

🔧 أوامر الصيانة:
─────────────────

# إعادة تشغيل الخدمة
sudo systemctl restart smtp-api

# عرض السجلات
sudo journalctl -u smtp-api -f

# نسخ احتياطي
sudo cp /opt/smtp-api-service/backend/data/smtp_api.db /backup/

# تحديث
sudo apt update && sudo apt upgrade -y


═══════════════════════════════════════════════════════════════

⚠️ ملاحظات أمان مهمة:
──────────────────────
• غيّر SECRET_KEY في backend/.env
• استخدم HTTPS فقط في الإنتاج
• احتفظ بمفاتيح API في مكان آمن
• فعّل جدار الحماية (UFW)
• حدّث النظام بانتظام


═══════════════════════════════════════════════════════════════

📞 دعم:
────────
للمساعدة، راجع:
- DEPLOY_EASY_ORDERS.md - دليل النشر الكامل
- README.md - التوثيق
- سجلات الأخطاء: sudo journalctl -u smtp-api -f


═══════════════════════════════════════════════════════════════
صُنع بـ ❤️ للمطورين
الموقع: https://easy-orders.co.uk
═══════════════════════════════════════════════════════════════
