منصوبے کے بارے میں

مستوریاس ویب مستوریاس پلیٹ فارم کی ویب سائٹ کے لیے سورس کوڈ کی ریپوزٹری ہے۔ یہ Astro کا استعمال کرتا ہے، جو کہ ایک جدید ویب فریم ورک ہے، تاکہ انٹرایکٹو اور پرفارمنس-بنیاد والے تعلیمی تجربات بنائے جائیں۔ پلیٹ فارم کا مقصد کہانی، ڈیٹا، اور عکاسی کو یکجا کرکے تعلیم کو تبدیل کرنا ہے، جس سے طلباء کو زیادہ معنی خیز سیکھنے کا موقع ملتا ہے۔ اس منصوبے کی ایک اہم خصوصیت اس کا ماڈیولر ڈھانچہ ہے۔ جبکہ یہ ریپوزٹری (mistorias-web) سائٹ کے بصری اور تکنیکی پہلوؤں کو سنبھالتی ہے، اصل تعلیمی مواد (جیسے کہ مضامین، کوئزز، اور ڈیٹا سیٹس) ایک الگ ریپوزٹری میں رکھا جاتا ہے جسے "mistorias-contenido" کہا جاتا ہے۔ یہ مواد کی ریپوزٹری ایک Git سب-ماڈیول کے طور پر اس مرکزی ریپوزٹری میں شامل کی گئی ہے، جس سے مواد کے تخلیق کاروں اور ویب ڈویلپرز کو آزادانہ طور پر کام کرنے کی اجازت ملتی ہے، لیکن پھر بھی ایک مربوط نظام میں۔ لوکل ڈویلپمنٹ کے لیے، اس منصوبے کو Node.js (ورژن 18 یا 20) اور pnpm کی ضرورت ہے۔ ڈویلپرز کو سب-ماڈیول کو شروع کرنے، انحصار کو انسٹال کرنے، اور پھر Astro کی ترقیاتی سرور کو چلانے کی ضرورت ہے، جو کہ ڈیفالٹ طور پر پورٹ 4321 پر چلتا ہے۔ اس کے علاوہ، Dev Containers (Docker) کے لیے سپورٹ موجود ہے، جو کہ ایک مستقل اور قابلِ نقل ڈویلپمنٹ ماحول فراہم کرتا ہے، جس سے مختلف مشینز پر سیٹ اپ کے مسائل کم ہوتے ہیں۔ دستاویزی مواد بہت جامع ہے۔ "CONTRIBUTING.md" میں سیٹ اپ اور تعاون کے لیے گائیڈز موجود ہیں، جبکہ "docs/adr/" میں معماری کے فیصلے (ADRs) شامل ہیں جو کہ ڈیزائن کے انتخاب کی وضاحت کرتے ہیں۔ "docs/STANDARDS.md" میں کوڈنگ کے معیارات اور کمٹ کنونشنز کی تفصیل دی گئی ہے، اور "CLAUDE.md" میں AI-بنیاد والے کوڈ اسسٹنٹس کے لیے مخصوص ہدایات موجود ہیں۔