# Claude handoff: مزامنة تحسين autocomplete داخل المتجر

## ما تغير في الخادم

عند إرسال `shop_id` إلى:

```http
GET /api/v2/search/suggestions?q=anker&shop_id=18
```

يرجع الخادم:

- `products`: منتجات المتجر المطابقة.
- `categories`: تصنيفات موجودة في المتجر.
- `brands`: ماركات موجودة في المتجر.
- `keywords`: مصفوفة فارغة دائمًا داخل المتجر.

مثال:

```json
{
  "keywords": [],
  "products": [],
  "categories": [],
  "brands": [],
  "success": true,
  "status": 200
}
```

سبب إفراغ `keywords`: بيانات الكلمات الرائجة عامة وليست مرتبطة بمتجر. التحقق من كل كلمة مقابل منتجات المتجر كان يضيف عدة استعلامات عند الكاش البارد. المنتجات والتصنيفات والماركات توفر autocomplete صحيحًا داخل المتجر دون هذه الكلفة.

البحث العام من دون `shop_id` لم يتغير، ويستمر بإرجاع `keywords`:

```http
GET /api/v2/search/suggestions?q=anker
```

## المطلوب في التطبيق

1. استمر بإرسال `shop_id = shop.id` مع autocomplete داخل المتجر.
2. لا تحذف حقل `keywords` من موديل الاستجابة؛ يبقى موجودًا لكنه فارغ داخل المتجر.
3. إذا كانت `keywords.isEmpty` فلا تعرض عنوان قسم الكلمات ولا مساحة فارغة له.
4. ترتيب العرض داخل المتجر: المنتجات، ثم التصنيفات، ثم الماركات.
5. لا تنشئ كلمات مقترحة محليًا من أسماء المنتجات.
6. لا تنفذ طلب autocomplete عام كبديل عندما تكون `keywords` فارغة.
7. عند الضغط على منتج أو تصنيف أو ماركة، حافظ على `shopId` عند فتح النتائج.
8. استمر بإرسال `shop_id` إلى `/products/search` و`/filter/options`.
9. خارج المتجر، اترك عرض الكلمات وسلوك autocomplete الحاليين كما هما.

## اختبارات التطبيق المطلوبة

- طلب متجر يحتوي `q` و`shop_id`.
- استجابة متجر فيها `keywords: []` تُحلل دون خطأ.
- قسم الكلمات لا يظهر عندما تكون القائمة فارغة.
- المنتجات ثم التصنيفات ثم الماركات تظهر بالترتيب المعتمد.
- الضغط على أي اقتراح يحافظ على `shopId` في شاشة النتائج.
- عدم وجود اقتراحات لا يؤدي إلى طلب عام دون `shop_id`.
- البحث العام من دون `shop_id` ما زال يعرض الكلمات المقترحة.

## دليل التسليم المطلوب من Claude

- أسماء ملفات التطبيق المعدلة.
- نتائج اختبارات API client وإدارة الحالة والواجهة.
- Network request داخل متجر يحتوي `shop_id`.
- لقطة أو اختبار يثبت اختفاء قسم الكلمات الفارغ داخل المتجر.
- تأكيد أن autocomplete العام ما زال يعرض `keywords`.