# 💰 بوت فواتير PayPal مع نظام لوقات كامل – By Ghlais

بوت ديسكورد احترافي لإدارة فواتير PayPal من داخل السيرفر  
يدعم تعدد الملاك (Owners) والمدراء (Managers) مع نظام لوقات تلقائي كامل 🔥  

---

## 🚀 المميزات

- 🧾 إنشاء فواتير PayPal فورية برابط دفع جاهز.
- 💼 دعم كل عملات PayPal المدعومة.
- ⚙️ إدارة منتجات (إضافة / حذف / عرض).
- 👑 صلاحيات متقدمة للملاك والمدراء.
- 🧱 نظام لوقات تلقائي ينشئ القنوات تلقائيًا عند أول تشغيل:
  - **log-invoices** → يسجل كل فاتورة جديدة.
  - **log-products** → يسجل أي تعديل أو حذف منتج.
  - **log-admin** → يسجل العمليات الإدارية (إضافة / إزالة أونر أو مسؤول).
  - **log-errors** → يسجل أي خطأ داخل البوت.

---

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

- Node.js 18 أو أحدث.
- حساب PayPal فيه بريد أعمال (Business Email) أو بريد مفعّل للاستلام.
- صلاحيات إنشاء قنوات داخل السيرفر.

---

## ⚙️ التثبيت والتشغيل

1. فك الضغط عن ملف المشروع  
2. افتح مجلد البوت وثبّت الحزم:
   ```bash
   npm install

3. انسخ الملف .env.example إلى .env وعدّل القيم داخله:

   DISCORD_TOKEN=توكن_البوت
   PREFIX=!
   PAYPAL_BUSINESS_EMAIL=بريدك@paypal.com
   DEFAULT_CURRENCY=USD
   STORE_NAME=X3 Hosting
   STORE_URL=https://discord.gg/x3hosting
   
   # لوقات
   LOG_CATEGORY_NAME=x3-logs
   LOG_CHANNEL_INVOICES=log-invoices
   LOG_CHANNEL_PRODUCTS=log-products
   LOG_CHANNEL_ADMIN=log-admin
   LOG_CHANNEL_ERRORS=log-errors
   
   # رتب المدراء (اختياري)
   MANAGER_ROLE_IDS=123456789012345678,987654321012345678

4. لتعيين نفسك كأونر أول مرة:

   • افتح الملف src/index.js

   • داخل الجزء:

     if (process.argv.includes('--init')) {
       Owners.add('YOUR_ID_HERE');
     }

     غيّر YOUR_ID_HERE إلى الـ ID الخاص بك.

   • ثم شغّل:

     npm run init

   • بعدها شغّل البوت عادي:

     npm run start

---

🧠 الأوامر

👥 الأوامر العامة

الأمر	الوظيفة
!مساعدة	عرض قائمة الأوامر.
!المنتجات	عرض قائمة المنتجات المضافة.
!فاتورة <المبلغ> [الوصف]	إنشاء فاتورة مخصصة.
!شراء_منتج <المعرف> [الكمية]	إنشاء فاتورة لمنتج محدد.

---

⚙️ أوامر الإدارة (للملاك والمدراء)

الأمر	الوظيفة
!اضافة_منتج <الاسم> <السعر> - <الوصف>	إضافة منتج جديد.
!حذف_منتج <معرف>	حذف منتج.
!اضافة_مالك @مستخدم	إضافة مالك جديد.
!ازالة_مالك @مستخدم	إزالة مالك.
!قائمة_الملاك	عرض كل الملاك.
!اضافة_مسؤول @مستخدم	إضافة مسؤول.
!ازالة_مسؤول @مستخدم	إزالة مسؤول.
!قائمة_المسؤولين	عرض كل المسؤولين.

---

🧾 نظام اللوقات التلقائي

أول مرة يشتغل البوت، ينشئ تلقائيًا كاتيجوري باسم x3-logs يحتوي على القنوات التالية:

القناة	الوظيفة
log-invoices	تسجيل الفواتير الجديدة.
log-products	تسجيل إضافة / حذف المنتجات.
log-admin	تسجيل جميع العمليات الإدارية.
log-errors	تسجيل الأخطاء أثناء التشغيل.

القنوات كلها تكون خاصة (Private) ومخفية عن باقي الأعضاء بشكل تلقائي.

---

💡 نصائح

• استخدم npm run dev لتجربة سريعة أثناء التطوير.
• تأكد أن البوت عنده صلاحية Manage Channels لإنشاء قنوات اللوق.
• يمكنك تعديل أسماء القنوات أو الكاتيجوري من .env.

---

🧠 صُنع بحُب بواسطة Ghlais ❤️

🚀 استضافة متكاملة للألعاب والبوتات والمواقع 💬 Discord: https://discord.x3-hosting.xyz