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

مسارک (Masarak) ایک عربی RTL ویب پلیٹ فارم ہے جو یمن میں ثانوی مرحلے کے طلبہ کو نشانہ بناتا ہے اور ان کی دلچسپیوں کی کھوج اور دستیاب تعلیمی و پیشہ ورانہ اختیارات کو منظم انداز میں سمجھنے میں مدد کرتا ہے۔ پلیٹ فارم تخصصات کی گائیڈ اور RIASEC ماڈل پر مبنی exploratory تجربے کو یکجا کرتا ہے، پھر تشریحی نتیجہ اور تخصصات سے منسلک سفارشات پیش کرتا ہے۔ دستاویزات واضح کرتی ہیں کہ پلیٹ فارم رہنمائی اور کھوج کا آلہ ہے، تشخیصی نفسیاتی ٹیسٹ یا طالب علم، اس کے خاندان اور رہنماؤں کے فیصلے کا متبادل نہیں۔ پروجیکٹ جس مسئلے کو حل کرتا ہے وہ ثانوی طلبہ میں جامعہ کی تخصص کے انتخاب کی دشواری ہے، جس کی وجوہات تخصصات کے بارے میں محدود معلومات، دلچسپیوں کی غیر وضاحت، تاثرات یا دوسروں کی رائے پر انحصار، اختیارات کا موازنہ کرنے کی دشواری، اور مقامی سیاق و سباق کے مطابق مواد کی کمی ہیں۔ ہدف صارفین دو گروہ ہیں: وہ طالب علم جو تخصصات کی کھوج، اپنی دلچسپیوں کی معرفت، سفارشات اور تشریح حاصل کرنا چاہتا ہے، اور غیر رجسٹرڈ زائر جو اکاؤنٹ بنانے سے پہلے پلیٹ فارم کو جاننا، تخصصات دیکھنا اور موازنہ کرنا چاہتا ہے۔ ہدف MVP دائرہ کار میں شامل ہے: پروجیکٹ کے اندر مقرر تعلیمی تخصصات کی گائیڈ، تخصصات کی معلومات دیکھنا اور موازنہ کرنا، اکاؤنٹ بنانا اور لاگ ان/لاگ آؤٹ، طالب علم کی پیش رفت محفوظ کرنا، 18 صورتحال × 4 اختیارات پر exploratory جائزہ، جائزے کے دوران جوابات محفوظ کرنا، سرور پر RIASEC اشاریوں کا حساب، نتیجے کی غیر تشخیصی رہنمائی زبان میں تشریح، تخصصات سے منسلک متعدد سفارشات، سابقہ نتائج محفوظ رکھنا، عربی RTL responsive انٹرفیس، اور merge سے پہلے خودکار ٹیسٹ اور Build جانچ۔ موجودہ MVP سے باہر: انتظامی ڈیش بورڈ، انتظامی اعداد و شمار، نظام کے اندر سے تخصصات کے انتظام کے لیے CRUD، آزاد عوامی API، آزاد Mobile ایپ، نفسیاتی تشخیص یا منظور شدہ psychometric پیمائش، اور طالب علم کی جانب سے لازمی فیصلہ۔ دستاویزات اشارہ کرتی ہیں کہ دائرہ کار میں فعل کی موجودگی لازماً اس کی موجودہ تنفیذ نہیں، اور تنفیذ کی حالت Issues، Pull Requests اور main برانچ کے ذریعے ٹریک ہوتی ہے۔ منظور شدہ ٹیکنالوجیز: Laravel 12 مع PHP 8.2+، MySQL 8.4.x ڈیٹا بیس، Eloquent ORM، Blade انٹرفیس، Tailwind CSS، JavaScript/Fetch، Laravel Session authentication مع Cookies اور CSRF، Vite build ٹول، Node.js 24.x، Composer 2.x اور npm، اور PHPUnit/Laravel Tests۔ بنیادی تکنیکی فیصلے Laravel Monolith، Blade + Tailwind، JavaScript/Fetch، MySQL 8.4.x، session authentication، 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 پر۔ GitHub سے صاف ماحول میں حقیقی Clean Clone ٹیسٹ کیا گیا اور تمام مراحل پاس ہوئے: ریپوزٹری ڈھانچہ، ماحول کی جانچ، ڈیٹا بیس کی تیاری، Composer اور npm کی تنصیب، Laravel کی ترتیب، migrations، Laravel ٹیسٹ، Vite build، 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۔ پروجیکٹ کے قواعد میں main پر براہ راست Push کی ممانعت، .env یا پاس ورڈز یا ٹوکنز یا راز اپ لوڈ کرنے کی ممانعت، composer.lock اور package-lock.json کی ٹریکنگ، عام سیٹ اپ کے دوران composer update یا npm update نہ استعمال کرنا، واضح Issue اور فیصلے کے بغیر دائرہ کار سے باہر خصوصیت نہ شامل کرنا، AI سے پیدا شدہ کسی بھی کوڈ کو استعمال سے پہلے سمجھنا اور مؤثر استعمال 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 کی بندش اور حتمی تصدیق۔ سیکیورٹی: ریپوزٹری میں مقامی credentials نہیں، .env صرف مقامی ہے اور اپ لوڈ کرنا ممنوع، Laravel sessions، cookies، CSRF تحفظ اور پاس ورڈ hashing استعمال کرتا ہے، اور روزمرہ ایپلیکیشن چلانے کے لیے انتظامی root ڈیٹا استعمال نہیں ہوتا۔