# حزمة أدوات التاجر + مُثبت شامل

## التركيب السريع
1) انسخ الملفات إلى جذر مشروعك (نفس مكان `schema.sql` و`includes/` و`public/`).
2) افتح المتصفح على: `/install_full.php` وأدخل إعدادات قاعدة البيانات وBASE_URL.
3) بعد التثبيت سيتم تحويلك إلى صفحة تسجيل الدخول.

## ما الذي تمت إضافته؟
- `tools_schema.sql`: جداول `invoices`, `invoice_items`, `coupons`, `coupon_redemptions`, `payment_links`.
- `includes/tools.php`: دوال مساعدة للفواتير.
- صفحات تحت `public/tools/`:
  - `index.php` لوحة الأدوات.
  - `invoices.php` إنشاء/عرض الفواتير.
  - `invoice_view.php` عرض وتنزيل PDF.
  - `payment_qr.php` إنشاء QR لرابط دفع (مدى لينك/سداد/بوابة).
  - `barcode.php` توليد باركود SKU (JsBarcode).
  - `coupons.php` إنشاء قسائم وتصدير PDF (jsPDF + QRCode).

## إضافة رابط "أدوات التاجر" في القائمة (Navbar)
افتح `includes/lib.php` وابحث عن شيفرة عناصر القائمة داخل `page_header(...)`.
أضف عنصر قائمة جديد بعد رابط الرئيسية مثلاً:
<?php /* أضف السطر التالي في قائمة التنقل */ ?>
<li class="nav-item"><a class="nav-link" href="<?=h(url('tools/index.php'))?>">أدوات التاجر</a></li>

> إن لم تجد عنصر `<ul class="navbar-nav ...">` انسخ السطر أعلاه داخل أي مجموعة روابط مناسبة.

## ملاحظات
- إنشاء PDF يتم عميلًا عبر jsPDF لتجنب تعقيدات خوادم الإنتاج.
- لروابط الدفع: ضع رابط مدى لينك/سداد/بوابة الدفع لديك وسيُنشأ له QR تلقائيًا.
- يمكنك لاحقًا ربط حالة الفاتورة بالدفع عبر Webhooks لبوابتك.
