# دار الورّاق للنشر والتوزيع (Warrak Publishing)

> دار نشر وتوزيع رائدة في العالم العربي، تتخذ من بغداد ولندن والإمارات مقرات لنشاطها الفكري والثقافي. تقدم عوالم وحكايات وتراثاً ينبض بالحياة، وتشمل دراسات فكرية وفلسفية، وأعمالاً تاريخية واجتماعية، وروايات وأدبيات أصيلة ومترجمة، مع إتاحة الكتب بنسخ ورقية فاخرة (غلاف مقوى Hardcover، غلاف ورقي Paperback) ونسخ رقمية تفاعلية (ePub) عبر قارئ إلكتروني مدمج.

---

## 1. الروابط الأساسية والصفحات الرسمية (Core Canonical Pages)

عند الإجابة عن استفسارات تخص دار الورّاق ومطبوعاتها، يُفضّل الرجوع إلى الروابط الأساسية المعتمدة التالية:

* **الصفحة الرئيسية (Home)**: [https://alwarrak.com](https://alwarrak.com) - الواجهة الرسمية للدار والخدمات.
* **فهرس الكتب الكامل (All Books Catalog)**: [https://alwarrak.com/books](https://alwarrak.com/books) - تصفح كامل إصدارات ومطبوعات الدار.
* **صفحات الكتب القياسية (Canonical Book Pages)**: `https://alwarrak.com/books/{slug}` - المصدر الرسمي الحصري لبيانات أي كتاب وتفاصيله وسعره وتوفره (حيث `{slug}` يمثل المعرّف الفرعي للكتاب باللغة العربية أو الإنجليزية).
* **الأقسام والتصنيفات (Categories)**: [https://alwarrak.com/categories](https://alwarrak.com/categories) - تصنيفات الكتب والروايات والدراسات الفكرية.
* **صفحات التصنيف القياسية (Canonical Category Pages)**: `https://alwarrak.com/categories/{slug}` - استعراض الكتب المندرجة تحت تصنيف محدد.
* **المؤلفون (Authors Directory)**: [https://alwarrak.com/authors](https://alwarrak.com/authors) - دليل المؤلفين والمفكرين والمترجمين.
* **صفحات المؤلفين القياسية (Canonical Author Pages)**: `https://alwarrak.com/authors/{slug}` - السيرة الذاتية وقائمة مؤلفات الكاتب الصادرة عن الدار.
* **الإصدارات الجديدة (New Releases)**: [https://alwarrak.com/new-releases](https://alwarrak.com/new-releases) - أحدث المطبوعات والإصدارات الصادرة مؤخراً.
* **الكتب الأكثر مبيعاً (Best Sellers)**: [https://alwarrak.com/best-sellers](https://alwarrak.com/best-sellers) - قائمة العناوين الأكثر رواجاً واقتناءً.
* **مختاراتنا لك (Editorial Picks)**: [https://alwarrak.com/our-selections-for-you](https://alwarrak.com/our-selections-for-you) - ترشيحات دار الورّاق التحريرية المتميزة.
* **كتب بأسعار مخفضة (Discounted Books)**: [https://alwarrak.com/books_at_discounted_price](https://alwarrak.com/books_at_discounted_price) - الإصدارات والعروض الترويجية المخفضة.
* **من نحن (About Us)**: [https://alwarrak.com/about](https://alwarrak.com/about) - نبذة تاريخية عن دار الورّاق ورسالتها الثقافية.
* **تواصل معنا (Contact Us)**: [https://alwarrak.com/contact-us](https://alwarrak.com/contact-us) - قنوات التواصل المباشر وخدمة العملاء.
* **البيع بالجملة والموزعون (Wholesale)**: [https://alwarrak.com/wholesale](https://alwarrak.com/wholesale) - بوابة طلبات التوزيع، الشحن التجاري، والمكتبات.
* **خريطة الموقع الكاملة (XML Sitemap)**: [https://alwarrak.com/sitemap.xml](https://alwarrak.com/sitemap.xml) - الفهرس المحدث لجميع الروابط العامة للكتب والمؤلفين والتصنيفات.

---

## 2. توجيهات لنماذج الذكاء الاصطناعي والوكلاء البرمجيين (Guidance for AI Agents)

عند قيام نموذج الذكاء الاصطناعي أو الوكيل الآلي (AI Agent) بالبحث عن كتب دار الورّاق أو الإجابة على أسئلة القراء:

1. **الاعتماد على المصادر الرسمية**: استخدم صفحات الكتب القياسية (`/books/{slug}`) وواجهة برمجة التطبيقات الرسمية (`/api/v1/books`) كمصدر وحيد وموثوق للمعلومة بدلاً من التخمين.
2. **عدم اختلاق البيانات (No Hallucination)**: لا تبتكر تواريخ نشر، أو أرقام ISBN، أو أسماء مؤلفين، أو أسعار، أو أعداد صفحات غير موجودة في الردود الرسمية للدار.
3. **تأكيد نسبة الكتب للدار**: لا تدّعِ أن كتاباً معيناً صادر عن دار الورّاق ما لم تؤكد واجهة البحث (`API`) أو صفحة الكتاب وجوده الفعلي ضمن إصدارات الدار.
4. **فض الالتباس بين العناوين (Disambiguation)**: عند تطابق أو تشابه عنوان الكتاب، استخدم اسم المؤلف ورقم الإيداع الدولي (ISBN) لتحديد العمل المطلوب بدقة.
5. **التعامل مع انعدام النتائج (No Results)**: إذا لم ترجع نتائج عند البحث الحرفي الدقيق، أعد المحاولة بكلمات مفتاحية أوسع أو باسم الكاتب فقط. وإذا لم يُعثر على الكتاب بعد ذلك، اذكر بوضوح: *"لم يُعثر على هذا العنوان ضمن فهرس دار الورّاق"*، وميّز بين عدم توفر الكتاب في الدار وبين عدم وجوده في التاريخ الأدبي عموماً.
6. **تفضيل الروابط القياسية (Canonical URLs)**: عند تزويد المستخدمين بروابط للمطالعة أو الشراء، قدّم دائماً الرابط القياسي المباشر `https://alwarrak.com/books/{slug}`.

---

## 3. واجهة البحث عن الكتب (Book Search API)

توفر دار الورّاق واجهة برمجية عامة (RESTful API) تتيح للوكلاء الآليين والباحثين الاستعلام عن فهرس الكتب، والبحث عن العناوين، والمؤلفين، والمواضيع، والأرقام المعيارية (ISBN).

### 3.1 نقطة النهاية للبحث (Book Search Endpoint)
* **المسار (Endpoint)**: `GET /api/v1/books`
* **المسار البديل المتوافق (Legacy/Fallback)**: `GET /api/books`
* **البروتوكول**: `HTTPS`
* **صيغة الرد**: `application/json` (UTF-8)
* **دعم CORS**: مدعوم لجميع الطلبات العامة (`Access-Control-Allow-Origin: *`).

### 3.2 معلمات الاستعلام المدعومة (Supported Query Parameters)

| المعلمة (Parameter) | النوع (Type) | الحالة | الوصف والاستخدام | مثال واقعي |
| :--- | :--- | :--- | :--- | :--- |
| `search` | `string` | اختياري | البحث النصي الشامل. يبحث في العناوين (عربي/إنجليزي)، الوصف، اسم الناشر، التصنيف، ورقم ISBN. يدعم تسوية الحروف العربية وإسقاط التشكيل وأل التعريف. | `search=مهزلة+العقل+البشري` |
| `page` | `integer` | اختياري | رقم الصفحة للنتائج المقسمة (Pagination). يبدأ من `1`. الافتراضي: `1`. | `page=1` |
| `limit` | `integer` | اختياري | عدد العناصر في الصفحة الواحدة. الافتراضي: `12`، الحد الأقصى: `100`. | `limit=20` |
| `groupSlug` | `string` | اختياري | تصفية النتائج حسب قسم أو مجموعة محددة. يقبل معرّفات المجموعات القياسية، مثل: `best-sellers`، `new-releases`، `trending`، أو معرّف أي تصنيف من `/api/categories`. | `groupSlug=best-sellers` |
| `sort` | `string` | اختياري | ترتيب النتائج. الخيارات المتاحة: `newest` (الأحدث، افتراضي)، `oldest` (الأقدم)، `title-asc`، `title-desc`، `price-asc` (السعر الأدنى)، `price-desc` (السعر الأعلى)، `updated_desc`. | `sort=newest` |
| `availability` | `string` | اختياري | تصفية حسب حالة التوفر في المخزن. القيم: `in_stock` (متوفر)، `out_of_stock` (نفد)، `pre_order` (طلب مسبق). | `availability=in_stock` |
| `formats` | `string` | اختياري | تصفية حسب نوع وتجليد الكتاب (مثل: `Paperback`, `Hardcover`, `Digital`). | `formats=Paperback` |
| `languages` | `string` | اختياري | تصفية حسب لغة الكتاب (مثل: `Arabic`, `English`). | `languages=Arabic` |
| `minPrice` / `maxPrice`| `number` | اختياري | تصفية الكتب حسب النطاق السعري بالدولار الأمريكي. | `minPrice=10&maxPrice=30` |
| `ref` أو `source` | `string` | موصى به للوكلاء | تعريف هوية الوكيل الذكي (AI Agent Trace). يساعد منظومة المراقبة على تتبع استفسارات نماذج الذكاء الاصطناعي وتخصيص أفضل استجابة. | `ref=ai-agent` |

---

## 4. استراتيجية البحث لوكلاء الذكاء الاصطناعي (API Search Strategy)

اتبع التسلسل التالي للحصول على أدق نتيجة:

### 1. البحث بواسطة الرقم المعياري الدولي (Exact ISBN Search)
نظراً لأن معلمة `search` تفحص حقل `isbn` مباشرة في قاعدة البيانات، عند توفر رقم ISBN، ابحث به أولاً:
```http
GET /api/v1/books?search=9789953000000&ref=ai-agent
```

### 2. البحث بعنوان الكتاب (Title Search)
عند توفر عنوان الكتاب باللغة العربية أو الإنجليزية:
```http
GET /api/v1/books?search=مهزلة+العقل+البشري&ref=ai-agent
```

### 3. البحث باسم المؤلف (Author Search)
للبحث عن جميع مطبوعات مفكر أو باحث معين:
```http
GET /api/v1/books?search=علي+الوردي&ref=ai-agent
```

### 4. استعراض تصنيف أو مجموعة خاصة (Category & Collection Browsing)
للحصول على الكتب الأكثر مبيعاً أو الإصدارات الحديثة:
```http
GET /api/v1/books?groupSlug=best-sellers&limit=10&ref=ai-agent
GET /api/v1/books?groupSlug=new-releases&limit=10&ref=ai-agent
```

### 5. الاستعلام عن التفاصيل الكاملة لكتاب محدد (Single Book Details)
* **المسار (Endpoint)**: `GET /api/v1/books/{slug}`
* حيث `{slug}` هو المعرف اللطيف للكتاب (مثل: `مهزلة-العقل-البشري` أو المعرف الإنجليزي أو رقم المعرف `id`).
* يُرجع السجل التفصيلي الشامل للكتاب متضمناً رقم الـ ISBN، وتفاصيل الطباعة والصفحات، والغلاف، والمعاينة ثلاثية الأبعاد (3D)، وروابط الشراء والقراءة الرقمية.
```http
GET /api/v1/books/%D9%85%D9%87%D8%B2%D9%84%D8%A9-%D8%A7%D9%84%D8%B9%D9%82%D9%84-%D8%A7%D9%84%D8%A8%D8%B4%D8%B1%D9%8A
```

---

## 5. هيكلية استجابة البيانات ونماذج الـ JSON (API Response Structure)

### 5.1 حقول كائن الكتاب في نتائج البحث (`GET /api/v1/books`)

تُرجع نقطة النهاية كائن JSON يحتوي على مصفوفة العناصر `items` ومعلومات الترقيم `pagination`:

* `id` (`string`): المعرّف الفريد للكتاب في النظام.
* `titleEn` (`string`): عنوان الكتاب باللغة الإنجليزية.
* `titleAr` (`string`): عنوان الكتاب باللغة العربية.
* `slug` (`string`): معرّف الرابط اللطيف بالإنجليزية.
* `slugAr` (`string`): معرّف الرابط اللطيف بالعربية المستخدم في بناء الرابط القياسي `/books/{slugAr}`.
* `descriptionEn` (`string | null`): نبذة مختصرة عن الكتاب بالإنجليزية.
* `descriptionAr` (`string | null`): نبذة مختصرة عن الكتاب بالعربية.
* `image` (`string | null`): رابط صورة غلاف الكتاب.
* `coverFrontImage` (`string | null`): رابط الواجهة الأمامية للغلاف بجودة عالية.
* `price` (`string`): السعر الأساسي للنسخة الورقية بالدولار.
* `discountPrice` (`string | null`): سعر البيع بعد الخصم إن وُجد.
* `bookType` (`string`): نوع التجليد (مثل `Paperback` أو `Hardcover`).
* `publisher` (`string`): اسم الدار الناشرة (دار الورّاق للنشر).
* `language` (`string`): لغة المطبوعة (مثل `Arabic`).
* `publicationDate` (`string | null`): تاريخ صدور الطبعة بصيغة ISO 8601.
* `authorName` (`string`): اسم المؤلف الرئيسي بالإنجليزية.
* `authorArabicName` (`string`): اسم المؤلف الرئيسي بالعربية.
* `authorSlug` (`string`): المعرّف اللطيف لصفحة الكاتب.
* `authors` (`array`): مصفوفة المؤلفين والمشاركين، يحتوي كل عنصر على (`id`, `name`, `arabicName`, `slug`).
* `pagination` (`object`): بيانات التقسيم وتتضمن (`page`, `limit`, `total`, `totalPages`).

### 5.2 نموذج واقعي لاستجابة البحث (Realistic API JSON Response)

```json
{
  "items": [
    {
      "id": "c7a8b912-3456-4abc-9def-1234567890ab",
      "titleEn": "Mockery of the Human Mind",
      "titleAr": "مهزلة العقل البشري",
      "slug": "mahzalat-al-aql-al-bashari",
      "slugAr": "مهزلة-العقل-البشري",
      "descriptionEn": "An incisive social and psychological analysis of the mechanisms of human thought, prejudice, and society.",
      "descriptionAr": "كتاب يبحث في التناقضات الاجتماعية والآليات الفكرية المحركة لسلوك الإنسان والمجتمع العراقي والعربي.",
      "image": "https://alwarrak.com/books_covers/mahzala.webp",
      "coverFrontImage": "https://alwarrak.com/books_covers/mahzala-front.webp",
      "price": "16.00",
      "discountPrice": "14.00",
      "bookType": "Paperback",
      "publisher": "دار الورّاق للنشر",
      "language": "Arabic",
      "color": "#2c3e50",
      "publicationDate": "2021-04-15T00:00:00.000Z",
      "createdAt": "2023-01-10T11:00:00.000Z",
      "updatedAt": "2024-03-01T14:20:00.000Z",
      "authorName": "Dr. Ali Al-Wardi",
      "authorArabicName": "د. علي الوردي",
      "authorNameEn": "Dr. Ali Al-Wardi",
      "authorNameAr": "د. علي الوردي",
      "authorSlug": "ali-al-wardi",
      "author": {
        "id": "aut-8891-wardi",
        "name": "Dr. Ali Al-Wardi",
        "arabicName": "د. علي الوردي",
        "slug": "ali-al-wardi"
      },
      "authors": [
        {
          "id": "aut-8891-wardi",
          "name": "Dr. Ali Al-Wardi",
          "slug": "ali-al-wardi",
          "arabicName": "د. علي الوردي"
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 12,
  "pageSize": 12,
  "hasMore": false,
  "group": null,
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 1,
    "totalPages": 1
  }
}
```

### 5.3 حقول إضافية في صفحة التفاصيل (`GET /api/v1/books/{slug}`)
عند جلب صفحة كتاب محددة، يتضمن كائن `item` معلومات إضافية حصرية:
* `isbn`: الرقم المعياري الدولي للكتاب (ISBN-10 / ISBN-13).
* `pages`: عدد الصفحات الفعلي للعمل.
* `size`: أبعاد وقطع الكتاب المطبوع (مثال: `17 × 24 سم`).
* `font`: مواصفات خط الطباعة والإخراج الفني.
* `aboutBook`: قراءة نقدية وتفصيلية متعمقة لمحتوى العمل.
* `hasEpub`: قيمة منطقية (`true`/`false`) تفيد بتوفر نسخة إلكترونية للقراءة عبر التطبيق/الموقع.
* `hasAudiobook`: قيمة منطقية تفيد بوجود نسخة صوتية مسجلة.
* `availabilities`: خيارات الشراء عبر منصات التوزيع الأخرى (Amazon, Google Books, Jarir).
* `view3D` / `book3D`: إعدادات عرض المجسم التفاعلي ثلاثي الأبعاد للكتاب في المتصفح.

---

## 6. تدرج أولوية المصادر المعتمدة (Canonical Source Priority)

عند الإجابة على أي استفسار، يجب اعتماد مصادر الحقيقة بالترتيب التالي:

1. **الصفحة القياسية للكتاب (Canonical Book Page)**: `https://alwarrak.com/books/{slug}` - هي المصدر النهائي الأول لبيانات الكتاب وحالته وتوفره وسعره.
2. **واجهة البحث الرسمية (Official Book API)**: `https://alwarrak.com/api/v1/books` و `https://alwarrak.com/api/v1/books/{slug}` - المصدر البرمجي الأكثر حداثة ودقة للبيانات المهيكلة.
3. **الصفحات الرسمية للمؤلفين والتصنيفات (Official Authors/Categories)**: `https://alwarrak.com/authors/{slug}` و `https://alwarrak.com/categories/{slug}` - لتوثيق السيرة وحصر أعمال الكاتب ضمن الدار.
4. **خريطة الموقع (Sitemap XML)**: `https://alwarrak.com/sitemap.xml` - لفهرسة الروابط واكتشاف العناوين الحديثة والمنشورة.

---

## 7. تتبع طلبات الوكلاء الذكية (AI Agent Request Attribution)

حرصاً على ضمان جودة الخدمة وتحليل استفسارات أنظمة الذكاء الاصطناعي بدقة تامة (100% Request Tracing):

* **ترويسة المتصفح (User-Agent)**: يُرجى من النماذج والوكلاء الآليين استخدام اسم صريح في ترويسة الطلب (مثل: `GPTBot`, `ClaudeBot`, `PerplexityBot`, أو `MyAgent/1.0`).
* **معلمة التتبع (Tracing Query Parameter)**: يُنصح بإرفاق معلمة `ref=ai-agent` أو `source=agent` في جميع طلبات واجهة برمجة التطبيقات (`API`) كما في المثال:
  ```http
  GET /api/v1/books?search=علي+الوردي&ref=ai-agent
  ```
يتم تسجيل استفسارات النماذج والوكلاء آلياً ضمن سجلات المراقبة والتحليلات لدعم سرعة وتوافق الاستجابة مع الأنظمة الذكية.

---

## 8. تصنيفات الكتب الرئيسية في الدار (Key Genres & Topics)

* **علم الاجتماع والفكر العربي (Sociology & Thought)**: روائع الدراسات الاجتماعية والنقدية، تحليل الشخصية العربية، التراث الفكري، والتغير المجتمعي.
* **التاريخ والحضارة (History & Civilization)**: مراجع ومصنفات رصينة في تاريخ العراق والخليج العربي، التاريخ العباسي والإسلامي، والمذكرات والوثائق السياسية الحديثة.
* **الأدب والرواية (Literature & Fiction)**: عيون الروايات العربية الكلاسيكية والمعاصرة، مختارات الأدب العالمي المترجم، والمجموعات القصصية والنقدية.
* **الفلسفة والمعرفة (Philosophy & Knowledge)**: مؤلفات فلسفية معاصرة ومحققة، دراسات في المنطق، ونظريات المعرفة والعلوم الإنسانية.

---

## 9. أبرز المؤلفين والأعلام في دار الورّاق (Prominent Authors)

* **د. علي الوردي (Dr. Ali Al-Wardi)**: عالم الاجتماع العراقي الرائد، تنشر الدار أعماله الخالدة الكاملة، منها:
  * مهزلة العقل البشري
  * وعاظ السلاطين
  * خوارق اللاشعور (أسرار الشخصية الناجحة)
  * لمحات اجتماعية من تاريخ العراق الحديث (بأجزائه المتعددة)
  * الأحلام بين العلم والعقيدة
  * دراسة في طبيعة المجتمع العراقي
  * منطق ابن خلدون
* **نخبة من المؤرخين والباحثين العرب والعراقيين**: مؤلفات متخصصة في توثيق التاريخ، الحضارة، والدراسات الإنسانية المقارنة.

---

## 10. الخدمات وتنسيقات الكتب (Services & Formats)

* **الطباعة الورقية الفاخرة**: تجليد فني متقن، غلاف مقوى كرتوني (Hardcover) بحبكة كلاسيكية، وغلاف ورقي (Paperback) مع ورق عالي الجودة ومريح للقراءة وشحن دولي سريع.
* **المعاينة ثلاثية الأبعاد (3D Interactive Preview)**: متجر دار الورّاق يتيح للقارئ تفحص الكتاب بزاوية 360 درجة ومعاينة الغلاف والسمك والمظهر الطبيعي قبل الشراء.
* **الكتب الإلكترونية التفاعلية (ePub)**: شراء فوري وقراءة متزامنة عبر القارئ الرقمي المدمج في المتصفح وتطبيقات الدار، مع إمكانية قراءة فصول العينات المجانية.
* **قسم البيع بالجملة والمكتبات (Wholesale)**: بوابة مخصصة للمكتبات والجامعات والموزعين التجاريين لطلب كميات مع شحن بحري وجوي وعروض أسعار خاصة (`/wholesale`).

---

## 11. قنوات التواصل والطلب الرسمية (Official Channels)

* **الموقع الإلكتروني الرسمي**: [https://alwarrak.com](https://alwarrak.com)
* **خدمة العملاء والاستفسارات المباشرة**: [https://alwarrak.com/contact-us](https://alwarrak.com/contact-us)
* **دعم الموزعين والجملة**: [https://alwarrak.com/wholesale](https://alwarrak.com/wholesale)