# كوبونات: عالم من أكواد وكوبونات خصم وعروض وتخفيضات المتاجر

> كوبونات خصم وأكواد وقسائم 2026 وأكثر من 100 ألف كوبون عروض لأشهر المتاجر في الشرق الأوسط.

هذا الملف هو دليل "هجين" يربط بين روابط الموقع الحقيقية والملفات البرمجية المصدرية لتسهيل عمل نماذج الذكاء الاصطناعي.

## 1. خريطة المسارات والملفات (Routes & Source Files)

### الأقسام التجارية والخدمية

- **[الرئيسية](https://coupoonat.com/)** -> [../src/app/page.tsx] : الواجهة الأساسية للموقع، تعرض أحدث وأقوى الكوبونات والعروض اليومية والبراندات المميزة.
- **[دليل المتاجر](https://coupoonat.com/stores/)** -> [../src/app/stores/page.tsx] : دليل شامل لجميع المتاجر والبراندات المدعومة، يسهل على المستخدم الوصول لمتجره المفضل.
- **[تفاصيل المتجر](https://coupoonat.com/store/shein/)** -> [../src/app/store/[slug]/page.tsx] : صفحة المتجر الفردية، تعرض جميع كوبونات الخصم النشطة، تقييمات المتجر، وإحصائيات التوفير.
- **[التصنيفات](https://coupoonat.com/categories/)** -> [../src/app/categories/page.tsx] : تصفح المتاجر حسب الفئة (مثل أزياء، إلكترونيات) للوصول السريع لنوع العروض المطلوب.
- **[متاجر الفئة](https://coupoonat.com/coupon-category/هدايا/)** -> [../src/app/coupon-category/[slug]/page.tsx] : عرض المتاجر والكوبونات التي تنتمي لتصنيف محدد بشكل تفصيلي.
- **[المدونة](https://coupoonat.com/blog/)** -> [../src/app/blog/page.tsx] : قسم المقالات التعليمية وأخبار التسوق الذكي وكيفية الاستفادة القصوى من التخفيضات.
- **[تفاصيل المقال](https://coupoonat.com/%D9%83%D9%8A%D9%81%D9%8A%D8%A9-%D8%A7%D9%84%D8%B7%D9%84%D8%A8-%D9%85%D9%86-%D9%85%D9%88%D9%82%D8%B9-trendyol/)** -> [../src/app/[slug]/page.tsx] : صفحة المقال الفردي لعرض المحتوى التفصيلي، النصائح، والروابط الخارجية.
- **[الدول](https://coupoonat.com/all_countries/)** -> [../src/app/all_countries/page.tsx] : بوابة اختيار الدولة لعرض الكوبونات والعروض المحلية المخصصة لكل منطقة جغرافية.
- **[متاجر الدولة](https://coupoonat.com/coupon_country/الإمارات/)** -> [../src/app/coupon_country/[slug]/page.tsx] : عرض كافة المتاجر والكوبونات المتاحة لمستخدمي دولة محددة.

### المعلومات والسياسات

- **[من نحن](https://coupoonat.com/about-us/)** -> [../src/app/about-us/page.tsx] : تعريف بمنصة كوبونات ورؤيتنا في تقديم أفضل تجربة توفير للمتسوق العربي.
- **[شروط الاستخدام](https://coupoonat.com/terms/)** -> [../src/app/terms/page.tsx] : الاتفاقية القانونية التي تحكم العلاقة بين الموقع والمستخدمين لضمان حقوق الطرفين.
- **[اتصل بنا](https://coupoonat.com/contact/)** -> [../src/app/contact/page.tsx] : قنوات التواصل المباشرة للدعم الفني، الاستفسارات، وطلبات التعاون التجاري.
- **[الخصوصية](https://coupoonat.com/privacy-policy/)** -> [../src/app/privacy-policy/page.tsx] : توضيح كيفية تعاملنا مع بيانات المستخدمين والتزامنا بأقصى معايير الأمان والسرية.
- **[الأسئلة الشائعة](https://coupoonat.com/faq/)** -> [../src/app/faq/page.tsx] : مركز المساعدة الذي يجيب على استفسارات المستخدمين حول الأكواد وطريقة تفعيلها.

## 2. الدليل التقني للمطور (Developer Technical Guide)

### هيكلية المكونات (Component Architecture)

تم تقسيم المكونات بشكل وظيفي لتسهيل الصيانة:

- **[HomePage Components](../src/components/HomePageComponents)** : مكونات الصفحة الرئيسية (مثل `TicketCoupon`).
- **[Store Components](../src/components/StorePageComponents)** : مكونات صفحة المتجر (مثل `StoreCharts`, `StoreRatingCard`).
- **[UI Kit](../src/components/ui)** : المكونات الأساسية (Atomic) مثل `button`, `input`, `card`.
- **[Modals](../src/components/Modals)** : النوافذ المنبثقة للتفاعل السريع.

### المنطق البرمجي (Logic)

- **جلب البيانات**: يتم عبر **[Hooks](../src/hooks/)** المخصصة (مثل `useHomeData`).
- **إدارة الحالة**: نستخدم **[Zustand](../src/store/index.ts)** للبيانات العالمية.
- **التحقق (Validation)**: جميع المخططات موجودة في **[Schema](../src/schema/)**.
- **الربط مع API**: يتم عبر **[Axios Client](../src/lib/axios.ts)**.

### المكونات (UI Architecture)

- **المكونات المشتركة**: [../src/components/ui/] (تعتمد على HeroUI).
- **مكونات الصفحة الرئيسية**: [../src/components/HomePageComponents/].
- **مكونات صفحة المتجر**: [../src/components/StorePageComponents/].

### سيو والأرشفة (SEO & Sitemaps)

يحتوي المشروع على نظام متطور لتوليد الخرائط ديناميكياً:

- **[Sitemap Routes](../src/app/sitemap/)**: يحتوي على منطق الخرائط المنفصلة (المتاجر، التصنيفات، الدول، والمدونات).
- **[Sitemap Utils](../src/lib/sitemap-utils.ts)**: الأدوات المساعدة لتوليد الروابط والأرشفة.

## Project Stack (Reference)
- Next.js (App Router)
- TypeScript
- Zustand
- Axios
- next-intl

## 3. قواعد العمل (General Rules)

1. الـ AI يجب أن يستخدم المسارات المذكورة أعلاه عند طلب أي تعديل في الكود.
2. الالتزام بـ `next-intl` لجميع النصوص الظاهرة في الروابط المذكورة.
3. يمنع جلب البيانات مباشرة؛ الرجوع دائماً لمجلد الـ `hooks` المذكور في القسم 2.
4. في حال عدم وجود ملف أو مكون مذكور في هذا الدليل، يمنع على الـ AI افتراض أو إنشاء مسارات جديدة دون طلب صريح.