hadihz.me
شخصيصعب

hadihz.me

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

— نظرة عامة

نظرة عامة على البنية

AWS

apps/admin · Strapi 5

apps/web · Astro 7، بناء ثابت

عميل مُولَّد

HTML مُعدّ مسبقًا

الوسائط

نموذج التواصل، تسجيل الدخول

محمّلات المحتوى
مرحلة المزامنة، أربع لغات

مخزن محتوى Astro

الصفحات + جزر React 19

واجهة REST + عميل مُنمَّط

PostgreSQL

S3

CloudFront

الزائر

هذا هو الموقع الذي تقرؤه الآن: معرض أعمال بأربع لغات (الإنجليزية والعربية والفرنسية والألمانية، ومن اليمين إلى اليسار في العربية) مبنيّ بـAstro ويغذّيه نظام إدارة محتوى Strapi. الغاية منه أن يكون جميلًا وسريع التحميل، لذا كل صفحة HTML مُعدّ مسبقًا يُقدَّم من شبكة توزيع محتوى (CDN)، ولا يُستخدم JavaScript إلا حيث يتطلّبه تفاعل ما.

والموقع يوثّق نفسه أيضًا. تعرض صفحة هذا الموقع شجرة ملفات المستودع، مولَّدةً من git ls-files وقت البناء، مع ملاحظات على المسارات المهمة مكتوبة في نظام إدارة المحتوى باللغات الأربع. وهذه الصفحة هي الجولة المختصرة.

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

لا تحدّد إعدادات Astro أي محوّل (adapter)، وهذا الإغفال وحده يشكّل كل ما عداه. لا يوجد خادم وقت الطلب، لذا تجري كل قراءة وقت البناء، في مرحلة مزامنة تعمل مرة واحدة قبل عرض أي صفحة.

S3 + CloudFrontمخزن المحتوىStrapiالعميل المُولَّدبناء Astroتعمل محمّلات المحتوى مرة واحدةجلب كل مجموعة بأربع لغاتمستندات مُنمَّطةالتحقق والتخزينتقرأ الصفحات المخزن ولا تقرأ Strapi أبدًارفع HTML المُعدّ مسبقًا
  • أي تعديل على المحتوى يتطلّب بناءً جديدًا، ولهذا يضمّ نظام إدارة المحتوى زر Deploy: إضافة صغيرة لـStrapi تطلق نشر الموقع وتعرض عمليات تشغيله داخل لوحة الإدارة.
  • لا تصل الأسرار إلى المتصفح أبدًا، لأن عملية البناء وحدها تحملها. رمز نظام إدارة المحتوى متغيّر بيئة في Astro مخصّص للخادم فقط.
  • استثناءان، كلاهما بلا أسرار. يرسل نموذج التواصل إلى نظام إدارة المحتوى، ويحمي نفسه بمصيدة (honeypot) وحدّ لمعدّل الطلبات بدل الرمز، ويردّ على الزائر بالبريد الإلكتروني باللغة التي كتب بها. أما تسجيل الدخول الاختياري، بالبريد وكلمة المرور أو عبر GitHub، فيحفظ بيانات اعتماده في ملف تعريف ارتباط httpOnly على نطاق نظام إدارة المحتوى، ورمز الوصول القصير العمر في الذاكرة لا في أي مخزن.
  • بالقياس لا بالافتراض. كان الوضع الداكن يُظهر ألوان الوضع الفاتح مدة 532 ميلي ثانية مقيسة قبل أن يُطبَّق صنف CSS؛ وصار الآن استعلام وسائط prefers-color-scheme يُحسم قبل أول رسم، وهو ما حذف كودًا بدل أن يضيفه.

داخل تطبيق الويب

يتألّف apps/web/src من أربع طبقات، والمهم هو اتجاه الاعتماد بينها.

features/
15 وحدة للمجال: المشاريع، المدوّنة، نبذة، التواصل، البحث...

shell/
الترويسة، التذييل، SEO، التحليلات

design-system/
عناصر أساسية + أنماط، بلا معرفة بالمجال

core/
المتحكّمات، عميل Strapi، المحمّلات

  • أسماء الملفات أدوار. داخل الميزة، repository.ts هو طبقة الجلب التي يستدعيها محمّل المحتوى، وservice.ts يقرأ النتيجة من مخزن المحتوى؛ ولا تصل ميزة إلى أخرى إلا عبر service.ts الخاص بها. والملف الذي يصعب تسميته غالبًا ما يؤدي مهمتين.
  • لا ملفات تجميع (barrels)، عن قصد. يتتبّع اختبارٌ كل استيراد ثابت وديناميكي من كل نقطة دخول في المتصفح، ويفشل إذا بلغ astro:content أو متغيّرًا مخصّصًا للخادم، فلا يمكن لوحدة خادم أن تتسلّل إلى حزمة المتصفح.
  • أربع لغات ومجلد صفحات واحد. يمرّ تكامل Astro مكتوب داخل المستودع على src/pages/ ويضيف مسار /{locale} لكل لغة غير الإنجليزية، مع روابط مترجمة من بيان واحد يغذّي أيضًا أنماط روابط Paraglide. تبقى الإنجليزية بلا بادئة، والرابط إلى صفحة أُعيدت تسميتها خطأٌ عند الترجمة البرمجية.
  • البحث ملف ثابت لكل لغة، يُجمَّع وقت البناء من المشاريع والمقالات وعناصر السيرة الزمنية والوسوم. وتُولَّد صور Open Graph لكل صفحة وقت البناء أيضًا.

نظام إدارة المحتوى

يعمل Strapi 5 تطبيقًا مستقلًا على منظومة React خاصة به، ولا يشارك الموقع شيئًا سوى البيانات.

apps/admin

زر Deploy

19 نوع محتوى
المشاريع، المدوّنة، السيرة الزمنية، ملاحظات الملفات...

الإضافات
ترجمة بالذكاء الاصطناعي، نشر الموقع، مصمّم البريد

pnpm generate
عميل مُنمَّط

apps/web

GitHub Actions

  • عقد واحد مُولَّد. يقرأ pnpm --filter admin generate المخطّط من Strapi قيد التشغيل ويكتب عميلًا مُنمَّطًا داخل تطبيق الويب. عدّل نوع محتوى، وأعد التوليد، فتخبرك أخطاء الأنواع بما يجب إصلاحه.
  • مصمّم لأربع لغات. تترجم strapi-plugin-ai-translate، وهي حزمة في هذا المستودع، أي مُدخل إلى اللغات الأخرى بنموذج لغوي كبير من شاشة التحرير، ويُضبط الموجّه والنموذج من لوحة الإدارة. وقوالب البريد العشرة، ومنها ردود نموذج التواصل، مكتوبة يدويًا.
  • محتوى يدير الموقع: المشاريع، والمقالات، والسيرة الزمنية للخبرات والدراسة، والشهادات، وبيانات المساهمات على GitHub، وملاحظات الملفات خلف الصفحة التي توثّق نفسها.

التكامل والنشر المستمران (CI/CD)

تصل التغييرات إلى dev عبر طلبات الدمج، وطلب دمج من dev إلى master ينشرها. الفحوص وعمليات النشر مسارا عمل منفصلان، وهذا الفصل وحده ما يُبقي كليهما بسيطًا.

من الفرع إلى شبكة التوزيع

تغيّرت لوحة الإدارة

فرع العمل

طلب دمج إلى dev

Checks

dev

طلب دمج إلى master

Checks

master

مسار عمل النشر

نشر نظام إدارة المحتوى

نشر الموقع

دورة حياة طلب الدمج

S3 + CloudFrontمسار عمل النشرذاكرة Turborepo المؤقتةمهمة ChecksGitHubالمطوّرفتح طلب الدمج1التشغيل على commit الدمج2شجرة المستودع محدّثة، Prettier3lint والأنواع والاختبارات، وإعادة ما نجح4بناء الموقع كاملًا5فحص إلزامي واحد6الدمج، ثم نقل dev إلى master7دفع إلى master8مزامنة البناء وإبطال الذاكرة المؤقتة9الموقع يجيب بـ20010
  • مهمة فحص واحدة، عن قصد. كانت ثلاث مهام وبوابة تجميع، وكانت كل منها تدفع ثمن تثبيت كامل لـAstro وStrapi معًا. مهمة واحدة تدفعه مرة واحدة، بينما يشغّل Turborepo داخلها lint والأنواع والاختبارات جنبًا إلى جنب، مع --continue كي يظهر كل فشل في تشغيل واحد.
  • يعمل Prettier أولًا، والترتيب مهم. فهو لا يقرأ إلا ملف الاستثناءات الخاص به، لذا يجب أن يعمل قبل أن يكتب أي شيء ملفات مُولَّدة في شجرة العمل.
  • يُبنى الموقع كاملًا في كل طلب دمج، لأن فحص الأنواع لا يعرض أي صفحة: المكوّن الذي ينهار عند حقل ناقص في نظام إدارة المحتوى يجتاز الفحص ويُفشل البناء. أما نظام إدارة المحتوى فلا يُبنى هناك، لأن ذلك يسلّم أسرار الإنتاج لكل طلب دمج.
  • لا يعمل CI إلا على طلبات الدمج. يُفحص طلب الدمج على نتيجة دمجه مع الفرع الأساسي، فالشجرة التي تصل إلى master هي نفسها التي فُحصت، وتمنع حماية الفروع الفرعَ الأساسي من التغيّر تحته.
  • نشر الموقع لا يُصفّى أبدًا. تُبنى الصفحة التي توثّق نفسها من كل ملف متتبَّع في المستودع، فحتى الـcommit الذي لا يمسّ إلا التوثيق يغيّر صفحة منشورة. أما نشر نظام إدارة المحتوى، وهو صورة بحجم 1 غيغابايت وإعادة تشغيل، فلا يعمل إلا حين تتغيّر مساراته.
  • ذاكرة مؤقتة على ثلاثة مستويات: مخزن pnpm، وذاكرة Turborepo البعيدة بقطع موقّعة، وذاكرة البناء في Astro. ولا يفتح Renovate تحديثًا إلا بعد مرور أسبوع على الإصدار.

الإطلاق

نشر الموقع

نشر نظام إدارة المحتوى

فشل

بناء صورة Strapi

إرسالها عبر SSH
إلى أمر مفروض

إعادة إنشاء الحاوية

فحص الصحة

إعادة الصورة السابقة

astro build

مزامنة إلى S3
الملفات المجزّأة أولًا

إبطال ذاكرة CloudFront

200 خلال 40 ثانية؟

  • يُشحن نظام إدارة المحتوى حاويةً إلى خادم 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.

— التقنيات
AstroStrapiDevOpsTurborepo