الفصل الأول: مقدمة إلى Antigravity وهيكلة المشروع

بداية الرحلة نحو بناء متجرك الإلكتروني الأول

مرحباً بك في رحلة بناء متجر إلكتروني متكامل من الصفر. في هذا الفصل التأسيسي، سنتعرف على الإطار العملاق الذي سنبني عليه مشروعنا: Antigravity. سنفلسف سبب اختياره، ونغوص في فلسفته التصميمية، ثم ننتقل مباشرة إلى التطبيق العملي بإعداد بيئة التطوير وبناء هيكل المشروع الذي سيرافقنا طوال الدورة. لنبدأ.

1.1 ما هو Antigravity؟ ولماذا نختاره؟

Antigravity ليس مجرد إطار عمل (Framework) عادي لجافاسكريبت. إنه نظام شامل مصمم خصيصاً لتسريع بناء تطبيقات الويب المعقدة والغنية بالميزات (Feature-Rich). فكر فيه كمجموعة أدوات ذكية ومترابطة تعمل معاً بتناغم.

• غير رأيي (Opinionated): يقدم Antigravity هيكلاً وطريقة عمل واضحة. هذا يقلل من حيرة اتخاذ القرارات المعمارية ويضمن أفضل الممارسات من اليوم الأول.
• مبني على المكونات (Component-Based): قلب Antigravity هو نظام مكونات قوي يشبه React أو Vue، لكنه مدمج بشكل عميق مع بقية الأدوات.
• إدارة حالة متكاملة (State Management): يأتي مع نظامه الخاص لإدارة حالة التطبيق، مما يلغي الحاجة إلى مكتبات خارجية مثل Redux أو Vuex.
• توجيه (Routing) قوي: نظام توجيه يديوي وذكي يدعم المسارات المتداخلة، الحماية، وجلب البيانات.
• أداة بناء (Build Tool) مخصصة: لا يحتاج إلى Webpack أو Vite معقد. يأتي بأداة بناء مخصصة، ag-pack، بسيطة الإعداد وقوية الأداء.

1.2 إعداد بيئة التطوير

قبل أن ننشئ مشروعنا، نحتاج إلى التأكد من أن أدواتنا جاهزة. المتطلبات الأساسية بسيطة:

• Node.js: الإصدار 16 أو أحدث. هذا ضروري لتشغيل أداة البناء وخدمات التطوير.
• مدير الحزم npm: يأتي مرفقاً مع Node.js.
• محرر نصوص: نوصي بشدة باستخدام Visual Studio Code مع إضافة syntax highlighting لجافاسكريبت.
• متصفح حديث: مثل Chrome أو Firefox بأحدث إصدار.

التحقق من التثبيت

افتح طرفيتك (Terminal) أو موجه الأوامر (CMD/PowerShell) وتأكد من التثبيت:

# التحقق من إصدار Node.js
node --version
# يجب أن يظهر رقم إصدار مثل v18.12.0

# التحقق من إصدار npm
npm --version
# يجب أن يظهر رقم إصدار مثل 8.19.2
    

1.3 إنشاء مشروع Antigravity الأول

يقدم Antigravity أداة سطر أوامر (CLI) لبدء المشاريع الجديدة بسرعة. لننشئ مشروعنا الذي سنسميه gravity-store.

# استخدم الأمر التالي لإنشاء مشروع جديد
npx create-antigravity-app gravity-store

# أثناء التنفيذ، ستظهر لك بعض الخيارات:
# ? Select template: -> اختر "Basic Web App"
# ? Use TypeScript? -> اختر "No" للتبسيط (سنستخدم JavaScript)
# ? Install dependencies now? -> اختر "Yes"
    

سيقوم هذا الأمر بإنشاء مجلد جديد باسم gravity-store، ونسقالة المشروع الأساسية داخله، وتثبيت جميع الاعتمادات (dependencies) المطلوبة تلقائياً.

هيكل المجلدات المُنشأ

بعد اكتمال العملية، انتقل إلى مجلد المشروع واستعرض الهيكل التالي:

cd gravity-store
ls -la
# أو dir في ويندوز
    

سترى هيكلاً مشابهاً لهذا:

gravity-store/
├── node_modules/      # جميع المكتبات المعتمدة (يتم تثبيتها تلقائياً)
├── public/            # الملفات الثابتة (أيقونات، صور، إلخ)
├── src/               # **قلب المشروع - كل شيفرتنا ستكون هنا**
│   ├── components/    # مكونات واجهة المستخدم القابلة لإعادة الاستخدام
│   ├── layouts/       # تخطيطات الصفحات (مثل الهيدر والفوتر)
│   ├── pages/         # صفحات التطبيق الرئيسية
│   ├── router/        # تعريف مسارات التطبيق (الروابط)
│   ├── store/         # إدارة الحالة