من الصفر لأول صنف متزامن

هاد الدليل بيوصلك لأول مزامنة ناجحة — تركيب الباكج، تشغيل الـ Agent، وضبط Product Bridge.

المتطلبات

• مشروع Laravel 12 أو 13
• Filament v4 أو v5 مركّب على المشروع
• جهاز ويندوز عندو وصول لقاعدة بيانات برنامج المحاسبة (SQL Server)
• برنامج محاسبة مدعوم حالياً: الأمين، البيان — أو ربط يدوي لأي برنامج تاني

1. تركيب باكج Laravel

ثبّت الباكجين الأساسيين على مشروعك:

composer require sqlsync/laravel-sqlsync sqlsync/laravel-sqlsync-filament
php artisan migrate

سجّل الإضافة بلوحة الفيلامنت عندك (app/Providers/Filament/AdminPanelProvider.php):

->plugins([
    \SqlSync\FilamentSqlSync\SqlSyncFilamentPlugin::make(),
])

أضف الـ Secret الخاص بمصادقة الوكيل بملف .env:

SQLSYNC_AGENT_SECRET=

2. تشغيل الـ Windows Agent

حمّل وثبّت SqlSync Agent على جهاز المحاسبة، وافتح شاشة الإعدادات:

• SQL Connection: اسم السيرفر واسم قاعدة البيانات
• Sync Provider: اختر برنامج المحاسبة (Al-Ameen / Al-Bayan / Auto-detect)
• Agent Settings: رابط مشروعك (Base URL بدون مسار إضافي) ونفس الـ Secret

اضغط Save & Apply، وراقب حالة الوكيل من لوحة الفيلامنت (SqlSync → Agents) — لازم يظهر Online خلال ثواني.

3. ضبط Product Bridge

روح لـ SqlSync → Product Bridge وحدد:

• اسم موديل المنتج بمشروعك (App\Models\Product)
• عمود المطابقة (عادة barcode ↔ sku)
• تعيين الحقول: أي عمود بجدولك يعني السعر، الاسم، الخ
• (اختياري) التصنيف التلقائي إذا بدك الفئات تتخلق لحالها

فعّل الـ Toggle واحفظ — من هون وطالع، أي صنف يوصل من الـ Agent بينحدّث أو بينخلق تلقائياً بجدولك.

برامج المحاسبة المدعومة حالياً

• الأمين (Al-Ameen) — دعم كامل عبر vwMtPrices
• البيان (Al-Bayan) — دعم كامل عبر MatCard + Barcode
• يدوي (Manual) — لأي برنامج تاني، عبر تعيين جداول مخصص من الـ Agent نفسه

مشاكل شائعة

لو واجهتك مشكلة، أغلب الحالات الشائعة (Opcache، Queue، أعمدة الأسعار المتغيّرة حسب الشركة...) موثّقة بالتفصيل بملف TROUBLESHOOTING.md بمستودع الباكج الأساسي.