इस प्रोजेक्ट के बारे में

مسارك (Masarak) एक अरबी वेब प्लेटफ़ॉर्म है जो RTL दिशा में काम करता है और यमन के हाई स्कूल छात्रों को लक्षित करता है। इसका उद्देश्य छात्रों को उनकी रुचियों का पता लगाने और उपलब्ध शैक्षणिक तथा व्यावसायिक विकल्पों को व्यवस्थित रूप से समझने में मदद करना है। प्लेटफ़ॉर्म विशेषज्ञताओं की एक गाइड और RIASEC मॉडल पर आधारित एक खोजपूर्ण अनुभव को जोड़ता है, फिर एक व्याख्यात्मक परिणाम और विशेषज्ञताओं से जुड़ी सिफारिशें प्रस्तुत करता है। दस्तावेज़ स्पष्ट रूप से बताते हैं कि प्लेटफ़ॉर्म एक मार्गदर्शन और खोज उपकरण है, न कि एक नैदानिक मनोवैज्ञानिक परीक्षण या छात्र, उनके परिवार और सलाहकारों के निर्णय का विकल्प। परियोजना द्वारा संबोधित समस्या हाई स्कूल छात्रों के लिए विश्वविद्यालय के प्रमुख को चुनने में कठिनाई है, जो विशेषज्ञताओं के बारे में सीमित ज्ञान, अस्पष्ट रुचियों, छापों या दूसरों की राय पर निर्भरता, विकल्पों की तुलना करने में कठिनाई और स्थानीय संदर्भ के लिए लक्षित सामग्री की कमी के कारण है। लक्षित उपयोगकर्ता दो श्रेणियों में हैं: छात्र जो विशेषज्ञताओं का पता लगाना चाहता है, अपनी रुचियों को जानना चाहता है, और सिफारिशें और व्याख्या प्राप्त करना चाहता है; और बिना पंजीकृत आगंतुक जो प्लेटफ़ॉर्म से परिचित होना चाहता है, विशेषज्ञताओं को ब्राउज़ करना चाहता है, और खाता बनाने से पहले उनकी तुलना करना चाहता है। लक्षित MVP का दायरा शामिल है: परियोजना के भीतर एक स्थिर शैक्षणिक विशेषज्ञता गाइड, विशेषज्ञता जानकारी ब्राउज़ करना और तुलना करना, खाता निर्माण, लॉगिन और लॉगआउट, छात्र प्रगति सहेजना, 18 स्थितियों × 4 विकल्पों का खोजपूर्ण मूल्यांकन, मूल्यांकन के दौरान उत्तर सहेजना, सर्वर पर RIASEC संकेतकों की गणना, गैर-नैदानिक मार्गदर्शन भाषा में परिणाम की व्याख्या, विशेषज्ञताओं से जुड़ी कई सिफारिशें, पिछले परिणामों को बनाए रखना, उत्तरदायी अरबी RTL इंटरफ़ेस, और विलय से पहले स्वचालित परीक्षण और बिल्ड जांच। वर्तमान MVP के दायरे से बाहर: प्रशासन पैनल, प्रशासनिक आँकड़े, सिस्टम के भीतर से विशेषज्ञताओं के प्रबंधन के लिए CRUD, स्वतंत्र सार्वजनिक API, स्वतंत्र मोबाइल ऐप, मनोवैज्ञानिक निदान या प्रमाणित साइकोमेट्रिक माप, और छात्र की ओर से अनिवार्य निर्णय लेना। दस्तावेज़ बताते हैं कि दायरे में किसी फ़ंक्शन की उपस्थिति का मतलब यह नहीं है कि इसे वर्तमान में लागू किया जाएगा, और कार्यान्वयन की स्थिति Issues, Pull Requests और main शाखा के माध्यम से ट्रैक की जाती है। अपनाई गई तकनीकें: PHP 8.2+ के साथ Laravel 12, MySQL 8.4.x डेटाबेस, Eloquent ORM, Blade इंटरफ़ेस, Tailwind CSS, JavaScript/Fetch, Cookies और CSRF के साथ Laravel Session प्रमाणीकरण, 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 पर चलता है और /up पर Health Check है। GitHub से एक वास्तविक Clean Clone परीक्षण एक साफ़ वातावरण में किया गया और सभी चरणों को पारित किया: रिपॉजिटरी संरचना, पर्यावरण जांच, डेटाबेस सेटअप, 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। परियोजना नियमों में main पर सीधे Push रोकना, .env या पासवर्ड, टोकन या रहस्य अपलोड करने से रोकना, composer.lock और package-lock.json को ट्रैक करना, सामान्य सेटअप के दौरान composer update या npm update का उपयोग न करना, बिना Issue और स्पष्ट निर्णय के दायरे से बाहर कोई सुविधा न जोड़ना, और उपयोग से पहले किसी भी AI-जनित कोड को समझना और AI_Log.md में प्रभावशाली उपयोग का दस्तावेजीकरण करना शामिल है। परियोजना की स्थिति: अब तक विचार और दायरे की स्वीकृति, बुनियादी दस्तावेज़ तैयार करना, रिपॉजिटरी बनाना और main सुरक्षा सेट करना, Issues और Pull Requests टेम्पलेट, Labels, Backlog → Ready → In Progress → In Review → Done स्थितियों वाला GitHub Project, पाँच Milestones, 15 Issues, स्वचालित सत्यापन के लिए GitHub Actions, पर्यावरण, सेटअप और सत्यापन स्क्रिप्ट, और Clean Clone पास करना पूरा हो चुका है। निष्पादन में: Batch 3 — Assessment Journey, Batch 4 — Results & Security, Batch 5 — Finalization & Release, शेष Issues बंद करना और अंतिम सत्यापन। सुरक्षा: रिपॉजिटरी में कोई स्थानीय क्रेडेंशियल नहीं है, .env केवल स्थानीय है और इसे अपलोड करना प्रतिबंधित है, Laravel सत्र, कुकीज़, CSRF सुरक्षा और पासवर्ड हैशिंग का उपयोग करता है, और दैनिक संचालन के लिए प्रशासनिक root डेटा का उपयोग नहीं किया जाता है।