hadihz.me
هذا الموقع الإلكتروني الذي تزوره الآن يركز بشكل كامل على الجماليات والمرئيات والأداء، مع الحد الأدنى من استخدام جافا سكريبت، تم بناؤه باستخدام Astro 7، والواجهة الخلفية من Strapi!


نظرة عامة على البنية
هذا هو الموقع الذي تقرؤه الآن: معرض أعمال بأربع لغات (الإنجليزية والعربية والفرنسية والألمانية، ومن اليمين إلى اليسار في العربية) مبنيّ بـAstro ويغذّيه نظام إدارة محتوى Strapi. الغاية منه أن يكون جميلًا وسريع التحميل، لذا كل صفحة HTML مُعدّ مسبقًا يُقدَّم من شبكة توزيع محتوى (CDN)، ولا يُستخدم JavaScript إلا حيث يتطلّبه تفاعل ما.
والموقع يوثّق نفسه أيضًا. تعرض صفحة هذا الموقع شجرة ملفات المستودع،
مولَّدةً من git ls-files وقت البناء، مع ملاحظات على المسارات المهمة مكتوبة في نظام إدارة
المحتوى باللغات الأربع. وهذه الصفحة هي الجولة المختصرة.
ثابت من حيث التصميم
لا تحدّد إعدادات Astro أي محوّل (adapter)، وهذا الإغفال وحده يشكّل كل ما عداه. لا يوجد خادم وقت الطلب، لذا تجري كل قراءة وقت البناء، في مرحلة مزامنة تعمل مرة واحدة قبل عرض أي صفحة.
- أي تعديل على المحتوى يتطلّب بناءً جديدًا، ولهذا يضمّ نظام إدارة المحتوى زر Deploy: إضافة صغيرة لـStrapi تطلق نشر الموقع وتعرض عمليات تشغيله داخل لوحة الإدارة.
- لا تصل الأسرار إلى المتصفح أبدًا، لأن عملية البناء وحدها تحملها. رمز نظام إدارة المحتوى متغيّر بيئة في Astro مخصّص للخادم فقط.
- استثناءان، كلاهما بلا أسرار. يرسل نموذج التواصل إلى نظام إدارة المحتوى، ويحمي نفسه بمصيدة (honeypot) وحدّ لمعدّل الطلبات بدل الرمز، ويردّ على الزائر بالبريد الإلكتروني باللغة التي كتب بها. أما تسجيل الدخول الاختياري، بالبريد وكلمة المرور أو عبر GitHub، فيحفظ بيانات اعتماده في ملف تعريف ارتباط httpOnly على نطاق نظام إدارة المحتوى، ورمز الوصول القصير العمر في الذاكرة لا في أي مخزن.
- بالقياس لا بالافتراض. كان الوضع الداكن يُظهر ألوان الوضع الفاتح مدة 532 ميلي ثانية مقيسة
قبل أن يُطبَّق صنف CSS؛ وصار الآن استعلام وسائط
prefers-color-schemeيُحسم قبل أول رسم، وهو ما حذف كودًا بدل أن يضيفه.
داخل تطبيق الويب
يتألّف apps/web/src من أربع طبقات، والمهم هو اتجاه الاعتماد بينها.
- أسماء الملفات أدوار. داخل الميزة،
repository.tsهو طبقة الجلب التي يستدعيها محمّل المحتوى، وservice.tsيقرأ النتيجة من مخزن المحتوى؛ ولا تصل ميزة إلى أخرى إلا عبرservice.tsالخاص بها. والملف الذي يصعب تسميته غالبًا ما يؤدي مهمتين. - لا ملفات تجميع (barrels)، عن قصد. يتتبّع اختبارٌ كل استيراد ثابت وديناميكي من كل نقطة دخول
في المتصفح، ويفشل إذا بلغ
astro:contentأو متغيّرًا مخصّصًا للخادم، فلا يمكن لوحدة خادم أن تتسلّل إلى حزمة المتصفح. - أربع لغات ومجلد صفحات واحد. يمرّ تكامل Astro مكتوب داخل المستودع على
src/pages/ويضيف مسار/{locale}لكل لغة غير الإنجليزية، مع روابط مترجمة من بيان واحد يغذّي أيضًا أنماط روابط Paraglide. تبقى الإنجليزية بلا بادئة، والرابط إلى صفحة أُعيدت تسميتها خطأٌ عند الترجمة البرمجية. - البحث ملف ثابت لكل لغة، يُجمَّع وقت البناء من المشاريع والمقالات وعناصر السيرة الزمنية والوسوم. وتُولَّد صور Open Graph لكل صفحة وقت البناء أيضًا.
نظام إدارة المحتوى
يعمل Strapi 5 تطبيقًا مستقلًا على منظومة React خاصة به، ولا يشارك الموقع شيئًا سوى البيانات.
- عقد واحد مُولَّد. يقرأ
pnpm --filter admin generateالمخطّط من Strapi قيد التشغيل ويكتب عميلًا مُنمَّطًا داخل تطبيق الويب. عدّل نوع محتوى، وأعد التوليد، فتخبرك أخطاء الأنواع بما يجب إصلاحه. - مصمّم لأربع لغات. تترجم
strapi-plugin-ai-translate، وهي حزمة في هذا المستودع، أي مُدخل إلى اللغات الأخرى بنموذج لغوي كبير من شاشة التحرير، ويُضبط الموجّه والنموذج من لوحة الإدارة. وقوالب البريد العشرة، ومنها ردود نموذج التواصل، مكتوبة يدويًا. - محتوى يدير الموقع: المشاريع، والمقالات، والسيرة الزمنية للخبرات والدراسة، والشهادات، وبيانات المساهمات على GitHub، وملاحظات الملفات خلف الصفحة التي توثّق نفسها.
التكامل والنشر المستمران (CI/CD)
تصل التغييرات إلى dev عبر طلبات الدمج، وطلب دمج من dev إلى master ينشرها. الفحوص وعمليات
النشر مسارا عمل منفصلان، وهذا الفصل وحده ما يُبقي كليهما بسيطًا.
من الفرع إلى شبكة التوزيع
دورة حياة طلب الدمج
- مهمة فحص واحدة، عن قصد. كانت ثلاث مهام وبوابة تجميع، وكانت كل منها تدفع ثمن تثبيت كامل
لـAstro وStrapi معًا. مهمة واحدة تدفعه مرة واحدة، بينما يشغّل Turborepo داخلها lint والأنواع
والاختبارات جنبًا إلى جنب، مع
--continueكي يظهر كل فشل في تشغيل واحد. - يعمل Prettier أولًا، والترتيب مهم. فهو لا يقرأ إلا ملف الاستثناءات الخاص به، لذا يجب أن يعمل قبل أن يكتب أي شيء ملفات مُولَّدة في شجرة العمل.
- يُبنى الموقع كاملًا في كل طلب دمج، لأن فحص الأنواع لا يعرض أي صفحة: المكوّن الذي ينهار عند حقل ناقص في نظام إدارة المحتوى يجتاز الفحص ويُفشل البناء. أما نظام إدارة المحتوى فلا يُبنى هناك، لأن ذلك يسلّم أسرار الإنتاج لكل طلب دمج.
- لا يعمل CI إلا على طلبات الدمج. يُفحص طلب الدمج على نتيجة دمجه مع الفرع الأساسي، فالشجرة
التي تصل إلى
masterهي نفسها التي فُحصت، وتمنع حماية الفروع الفرعَ الأساسي من التغيّر تحته. - نشر الموقع لا يُصفّى أبدًا. تُبنى الصفحة التي توثّق نفسها من كل ملف متتبَّع في المستودع، فحتى الـcommit الذي لا يمسّ إلا التوثيق يغيّر صفحة منشورة. أما نشر نظام إدارة المحتوى، وهو صورة بحجم 1 غيغابايت وإعادة تشغيل، فلا يعمل إلا حين تتغيّر مساراته.
- ذاكرة مؤقتة على ثلاثة مستويات: مخزن pnpm، وذاكرة Turborepo البعيدة بقطع موقّعة، وذاكرة البناء في Astro. ولا يفتح Renovate تحديثًا إلا بعد مرور أسبوع على الإصدار.
الإطلاق
- يُشحن نظام إدارة المحتوى حاويةً إلى خادم VPS، بمفتاح لا يستطيع إلا تشغيل سكربت النشر، إلى جانب قاعدة PostgreSQL الخاصة به التي تُنسخ احتياطيًا كل ليلة. ويعيد فحص الصحة الفاشل الصورة السابقة.
- يُنشر الموقع بعد نظام إدارة المحتوى، كي لا يقرأ البناء مخطّطًا لا يقدّمه النظام بعد. يرفع الملفات المجزّأة قبل HTML الذي يشير إليها، ويُبطل ذاكرة CloudFront، ويفشل إن لم يُجب الموقع خلال 40 ثانية.
بُني بمساعدة وكلاء الذكاء الاصطناعي
المستودع مهيّأ لوكلاء البرمجة بقدر ما هو مهيّأ للبشر.
- توثيق يوجّه. يحيل ملف
AGENTS.mdقصير في الجذر إلى دليل لكل تطبيق وإلى ست مهارات (skills) كُتبت لهذا المستودع:feature-modules(أين يوضع الكود)، وclient-controllers(السلوك في المتصفح)، وdesign-system، وoutput-neutral-refactor(إعادة هيكلة لا يجوز أن تغيّر HTML الناتج)، وcms-annotations(إبقاء ملاحظات الملفات متوافقة مع الشجرة)، وdraft-content. - محتوى يصوغه وكيل وينشره إنسان. تبحث
draft-contentفي مستودع أو موضوع، وتصوغ صفحة مشروع أو مقالة بأربع لغات، وتحفظها في نظام إدارة المحتوى مسوّدات غير منشورة عبر نقطة MCP المدمجة في Strapi؛ وهكذا كُتبت هذه الصفحة ثم رُوجعت قبل نشرها. - مهارات للتصميم والحركة. ست عشرة مهارة من Emil Kowalski في الحركة والتفاعل والإتقان، مثبّتة في ملف قفل.
الميزات الرئيسية:
- أربع لغات بروابط مترجمة، من اليمين إلى اليسار في العربية، والإنجليزية بلا بادئة
- صفحات مُعدّة مسبقًا على S3 وCloudFront، ولا JavaScript إلا في الجزر التي تحتاجه
- انتقالات بين الصفحات، ووضع داكن بلا وميض، وكرة أرضية لأماكن تنفيذ المشاريع
- صفحة توثّق نفسها: شجرة المستودع الفعلية مع ملاحظات من نظام إدارة المحتوى
- بحث ثابت وصور Open Graph لكل صفحة، يُولَّدان وقت البناء
- نموذج تواصل يردّ بلغة الزائر، وتسجيل دخول اختياري بالبريد الإلكتروني أو GitHub
- لوحة إدارة Strapi مع ترجمة بالذكاء الاصطناعي وزر Deploy يعيد بناء الموقع
التقنيات المستخدمة:
- الويب: Astro 7، React 19، Tailwind v4، Paraglide، TypeScript، Embla، Mermaid، Shiki
- نظام إدارة المحتوى: Strapi 5، PostgreSQL، Resend، OpenRouter للترجمة
- البنية التحتية: AWS S3 وCloudFront، Docker على خادم VPS، نسخ احتياطية ليلية إلى Cloudflare R2
- الأدوات: Turborepo، pnpm، ESLint، Prettier، Vitest، Renovate، GitHub Actions
بالأرقام (تشرين الثاني/نوفمبر 2026): نحو 980 commit منذ نيسان/أبريل 2026، و151 طلب دمج مدموجًا، و61 ملف اختبار، و15 وحدة للمجال، و19 نوع محتوى، و5 مسارات عمل على GitHub Actions.