# 🤖 الذكاء الاصطناعي — دوال النشر

في **دالتين** AI:
1. `ai-match-item` — ربط أصناف فواتير المبيعات (صفحة الطلبات الواردة).
2. `ai-stock-alternative` — **محرّك البدائل الذكي** (صفحة الجرد + الرئيسية): تطلب موديل/مواصفة، يطلعلك أقرب بديل متوفر فعلياً بمخزونك.

كل دالة تنشرها بنفس طريقة `ai-stock-assistant` (من داخل Supabase → Edge Functions → Deploy a new function → Via Editor → الصق كود الملف → Deploy).

| الدالة | ملف الكود | الصلاحية المطلوبة |
|---|---|---|
| `ai-match-item` | `supabase/functions/ai-match-item/index.ts` | out أو orders |
| `ai-stock-alternative` | `supabase/functions/ai-stock-alternative/index.ts` | stock أو out |

> كلاهما يستخدم نفس `OPENAI_API_KEY` الموجود (لا حاجة لإضافة مفاتيح).
> ⚠️ `ai-stock-alternative` يحتاج دالة `mt_match_candidates` → تأكد إنك شغّلت `SQL_sales_integration_v2.sql`.

---

# 🤖 نشر مطابقة الأصناف بالذكاء الاصطناعي (ai-match-item)

> اختياري. المطابقة الذكية (تطبيع + ضبابي + ذاكرة) تشتغل **بدون** الـ AI. الـ AI بس للحالات الصعبة (أسماء وصفية بالعربي / فروقات كبيرة) وزر "ربط ذكي للكل".

الـ Edge Function تستخدم **نفس مفاتيح** `ai-stock-assistant` الموجودة عندك (OpenAI). يعني غالباً المفاتيح مضبوطة أصلاً.

## خطوات النشر (مرّة واحدة)

من جهازك (محتاج Supabase CLI مثبّت ومربوط بالمشروع):

```bash
# 1) تأكد من المفاتيح (لو ai-stock-assistant شغّالة فهي مضبوطة)
supabase secrets set OPENAI_API_KEY=sk-xxxxx
supabase secrets set SUPABASE_SERVICE_ROLE_KEY=xxxxx
# اختياري:
supabase secrets set OPENAI_MODEL=gpt-4o-mini

# 2) انشر الدالة
supabase functions deploy ai-match-item
```

> ملف الدالة موجود في: `supabase/functions/ai-match-item/index.ts`

## التحقق
بعد النشر، افتح صفحة "طلبات واردة" → افتح فاتورة فيها صنف غير مربوط → اضغط **🤖 ربط ذكي للكل**. لو اشتغل وربط الأصناف، تمام ✅.

لو طلعت رسالة "AI غير متاح" → الدالة مش منشورة أو المفاتيح ناقصة. (الربط اليدوي والاقتراحات التلقائية بتظل شغّالة عادي.)

## كيف بتشتغل؟
1. لكل بند غير مربوط، النظام بيجيب أقرب مرشّحين من المخزون (تشابه ضبابي).
2. بيبعتهم للـ AI مع المطلوب بالفاتورة.
3. الـ AI بيختار الأنسب **من ضمن المرشّحين فقط** (ما بيخترع أصناف) + نسبة ثقة + سبب.
4. الثقة ≥ 80% → "مطابق". أقل → "تأكّد" (تراجعه أنت قبل الخصم).
5. لو فعّلت "🧠 تذكّر الربط"، المرة الجاية بتتطابق تلقائياً بدون AI.