عن المشروع

مسارك (Masarak) منصة ويب عربية باتجاه RTL تستهدف طلاب المرحلة الثانوية في اليمن، وتهدف إلى مساعدتهم على استكشاف ميولهم وفهم الخيارات الأكاديمية والمهنية المتاحة بصورة منظمة. تجمع المنصة بين دليل للتخصصات وتجربة استكشافية تعتمد على نموذج RIASEC، ثم تعرض نتيجة تفسيرية وتوصيات مرتبطة بالتخصصات. وتوضح الوثائق صراحة أن المنصة أداة توجيه واستكشاف وليست اختباراً نفسياً تشخيصياً أو بديلاً عن قرار الطالب وأسرته والمرشدين. المشكلة التي يعالجها المشروع هي صعوبة اختيار التخصص الجامعي لدى طلاب الثانوية بسبب محدودية المعرفة بالتخصصات، وعدم وضوح الميول، والاعتماد على الانطباعات أو آراء الآخرين، وصعوبة مقارنة الخيارات، ونقص المحتوى الموجه للسياق المحلي. المستخدمون المستهدفون فئتان: الطالب الذي يريد استكشاف التخصصات ومعرفة ميوله والحصول على توصيات وتفسير، والزائر غير المسجل الذي يريد التعرف على المنصة وتصفح التخصصات ومقارنتها قبل إنشاء حساب. نطاق الـMVP المستهدف يشمل: دليل تخصصات أكاديمية ثابت داخل المشروع، تصفح ومقارنة معلومات التخصصات، إنشاء حساب وتسجيل دخول وخروج، حفظ تقدم الطالب، تقييم استكشافي من 18 موقفاً × 4 خيارات، حفظ الإجابات أثناء التقييم، حساب مؤشرات RIASEC على الخادم، تفسير النتيجة بلغة توجيهية غير تشخيصية، توصيات متعددة مرتبطة بالتخصصات، الاحتفاظ بالنتائج السابقة، واجهة عربية RTL متجاوبة، واختبارات آلية وفحوص Build قبل الدمج. خارج نطاق الـMVP الحالي: لوحة إدارة، إحصائيات إدارية، CRUD لإدارة التخصصات من داخل النظام، API عامة مستقلة، تطبيق Mobile مستقل، التشخيص النفسي أو القياس السيكومتري المعتمد، واتخاذ قرار إلزامي نيابة عن الطالب. وتشير الوثائق إلى أن وجود الوظيفة في النطاق لا يعني بالضرورة تنفيذها حالياً، وأن حالة التنفيذ تتابع عبر Issues وPull Requests والفرع main. التقنيات المعتمدة: Laravel 12 مع PHP 8.2+، قاعدة بيانات MySQL 8.4.x، Eloquent ORM، واجهات Blade، Tailwind CSS، JavaScript/Fetch، مصادقة Laravel Session مع Cookies وCSRF، أداة البناء Vite، Node.js 24.x، Composer 2.x وnpm، واختبارات PHPUnit/Laravel Tests. القرارات التقنية الأساسية هي Laravel Monolith وBlade + Tailwind وJavaScript/Fetch وMySQL 8.4.x ومصادقة الجلسات وroutes/web.php وكتالوج تخصصات ثابت ومعالجة RIASEC على الخادم. ويذكر المشروع صراحة أنه لا يعتمد في الـMVP على React أو Vue أو SPA أو Laravel Breeze أو Sanctum أو JWT أو API Tokens أو SQLite أو MariaDB. بيانات التخصصات تُحفظ في ملف ثابت داخل المشروع: resources/data/specializations.json، ولا توجد في الـMVP الحالي جداول قاعدة بيانات للتخصصات ولا لوحة CRUD ولا لوحة إدارة محتوى. يتضمن المستودع وثائق لإدارة المشروع وتتبع العمل، منها Mini-SRS/Requirements وProject Brief وTeam Roles وAI Usage Log وDeliverables Checklist وTechnical Decisions وSystem Architecture وSystem Workflows وUse Cases، مع ملفات مثل AI_Log.md وDELIVERABLES_CHECKLIST.md ومجلد docs. طريقة العمل تعتمد على GitHub Issues والفروع والـCommits والـPull Requests وCode Review وGitHub Projects، مع مسار: Issue ثم Branch ثم Implementation ثم Commit ثم Push ثم Pull Request ثم Review ثم Squash Merge ثم حذف الفرع. الفرع الدائم الوحيد هو main ولا يتم التطوير المباشر عليه. التشغيل يتطلب Git 2.x وPHP 8.2+ وComposer 2.x وNode.js 24.x وnpm وMySQL 8.4.x، مع سكربتات جاهزة على Windows: check-environment.bat وsetup-database.bat وsetup-project.bat وverify-project.bat وstart-project.bat. ويوجد أيضاً مسار تشغيل يدوي عبر composer install وnpm ci وphp artisan config:clear وmigrate وtest وnpm run build، ثم php artisan serve وnpm run dev. التطبيق يعمل على http://127.0.0.1:8000 مع Health Check على /up. تم إجراء اختبار Clean Clone فعلي من GitHub على بيئة نظيفة واجتاز جميع المراحل: بنية المستودع، فحص البيئة، إعداد قاعدة البيانات، تثبيت Composer وnpm، تهيئة Laravel، الترحيلات، اختبارات Laravel، بناء Vite، الاتصال بـMySQL، التحقق الكامل، وفحص أمان Git. بيئة الاختبار المذكورة: Laravel 12.69.1 وPHP 8.2.12 وComposer 2.9.5 وNode.js 24.13.1 وnpm 11.8.0 وMySQL 8.4.11 وGit 2.50.1. قواعد المشروع تشمل منع Push المباشر إلى main، ومنع رفع .env أو كلمات المرور أو الرموز أو الأسرار، وتتبع composer.lock وpackage-lock.json، وعدم استخدام composer update أو npm update أثناء الإعداد الطبيعي، وعدم إضافة ميزة خارج النطاق دون Issue وقرار واضح، وفهم أي كود مولد بالذكاء الاصطناعي قبل استخدامه وتوثيق الاستخدام المؤثر في AI_Log.md. حالة المشروع: مكتمل حتى الآن اعتماد الفكرة والنطاق، وإعداد الوثائق الأساسية، وإنشاء المستودع وضبط حماية main، وقوالب Issues وPull Requests، والـLabels، وGitHub Project بحالات Backlog → Ready → In Progress → In Review → Done، وخمسة Milestones، و15 Issue، وGitHub Actions للتحقق الآلي، وسكربتات البيئة والإعداد والتحقق، واجتياز Clean Clone. وقيد التنفيذ: Batch 3 — Assessment Journey وBatch 4 — Results & Security وBatch 5 — Finalization & Release وإغلاق Issues المتبقية والتحقق النهائي. الأمان: لا يحتوي المستودع على بيانات اعتماد محلية، و.env محلي فقط وممنوع رفعه، ويستخدم Laravel الجلسات والكوكيز وحماية CSRF وتجزئة كلمات المرور، ولا تستخدم بيانات root الإدارية لتشغيل التطبيق اليومي.