عن المشروع

Mistorias Web هو المستودع الذي يحتوي على كود المصدر لموقع ويب منصة Mistorias. تستخدم هذه المبادرة Astro كـ framework رئيسي لبناء الواجهة وتوليد الصفحات الثابتة أو الديناميكية. الهدف الأساسي من Mistorias هو تحويل التعليم من خلال الجمع بين القصص والبيانات والتأمل، مما يوفر تجربة مستخدم تركز على التعلم الهادف. إحدى السمات الأساسية لهندسة هذا المشروع هي الفصل الواضح بين منطق العرض والمحتوى التحريري. بينما يدير هذا المستودع هيكل الموقع والمكونات والإعدادات التقنية، يتم استضافة المحتوى الفعلي في مستودع مخصص يُسمى `mistorias-contenido`. يتم دمج هذا المستودع في المشروع الرئيسي كـ Git submodule، مما يسمح بإدارة مستقلة وتعاونية للموارد التعليمية دون التدخل في تطوير الكود الأساسي. بالنسبة للتطوير المحلي، يتطلب المشروع Node.js (مع إصدارات محددة في `.nvmrc`) وpnpm كـ package manager. تتضمن الأوامر الأساسية لبدء بيئة التطوير تثبيت التبعيات وتشغيل الخادم المحلي على المنفذ 4321. بالإضافة إلى ذلك، يتم تقديم دعم لبيئة تطوير متسقة باستخدام Dev Containers (Docker)، مما يسهل تكرار بيئة النشر ويقلل من مشكلات الإعداد على أجهزة المساهمين. الوثائق التقنية شاملة ومنظمة جيدًا. يمكن للمطورين الرجوع إلى `CONTRIBUTING.md` للحصول على إرشادات حول الإعداد والمساهمة، بالإضافة إلى إرشادات خاصة للتعامل مع المحتوى عبر submodules. لفهم القرارات الهندسية، يتم توفير سجلات قرارات الهندسة (ADR) في مجلد `docs/adr/`، إلى جانب معايير الكود وممارسات الـ commits في `docs/STANDARDS.md`. كما يوجد دليل سريع (`CLAUDE.md`) موجه نحو مساعدي الكود مثل Claude Code.