প্রকল্প সম্পর্কে

مسارك (Masarak) একটি আরবি RTL ওয়েব প্ল্যাটফর্ম যা ইয়েমেনের উচ্চ মাধ্যমিক শিক্ষার্থীদের লক্ষ্য করে তৈরি। এর উদ্দেশ্য শিক্ষার্থীদের নিজেদের আগ্রহ আবিষ্কার করতে এবং উপলব্ধ একাডেমিক ও পেশাগত বিকল্পগুলোকে সুসংগঠিতভাবে বুঝতে সাহায্য করা। প্ল্যাটফর্মটি বিষয়ভিত্তিক গাইড এবং RIASEC মডেলের উপর ভিত্তি করে একটি অনুসন্ধানমূলক অভিজ্ঞতা একত্রিত করে, তারপর ব্যাখ্যামূলক ফলাফল এবং বিষয়ের সাথে সম্পর্কিত সুপারিশ উপস্থাপন করে। নথিতে স্পষ্টভাবে উল্লেখ করা হয়েছে যে প্ল্যাটফর্মটি একটি দিকনির্দেশনা ও অনুসন্ধানের হাতিয়ার, এটি একটি মনস্তাত্ত্বিক ডায়াগনস্টিক পরীক্ষা নয় এবং শিক্ষার্থী, তার পরিবার এবং পরামর্শদাতাদের সিদ্ধান্তের বিকল্পও নয়। প্রকল্পটি যে সমস্যার সমাধান করে তা হলো উচ্চ মাধ্যমিক শিক্ষার্থীদের বিশ্ববিদ্যালয়ের বিষয় নির্বাচনের অসুবিধা, কারণ বিষয় সম্পর্কে সীমিত জ্ঞান, অস্পষ্ট আগ্রহ, ছাপ বা অন্যের মতামতের উপর নির্ভরতা, বিকল্প তুলনা করতে অসুবিধা এবং স্থানীয় প্রেক্ষাপটের জন্য নির্দেশিত সামগ্রীর অভাব। লক্ষ্যযুক্ত ব্যবহারকারী দুই শ্রেণীর: শিক্ষার্থী যারা বিষয় অন্বেষণ করতে, নিজের আগ্রহ জানতে এবং সুপারিশ ও ব্যাখ্যা পেতে চায়; এবং নিবন্ধনহীন দর্শক যারা অ্যাকাউন্ট তৈরি করার আগে প্ল্যাটফর্ম সম্পর্কে জানতে, বিষয় ব্রাউজ করতে এবং তুলনা করতে চায়। লক্ষ্যযুক্ত MVP সুযোগের মধ্যে রয়েছে: প্রকল্পের মধ্যে একটি স্থির একাডেমিক বিষয় গাইড, বিষয়ের তথ্য ব্রাউজ ও তুলনা, অ্যাকাউন্ট তৈরি ও লগইন/লগআউট, শিক্ষার্থীর অগ্রগতি সংরক্ষণ, ১৮টি পরিস্থিতি × ৪টি বিকল্পের অনুসন্ধানমূলক মূল্যায়ন, মূল্যায়নের সময় উত্তর সংরক্ষণ, সার্ভারে RIASEC সূচক গণনা, অ-ডায়াগনস্টিক দিকনির্দেশনামূলক ভাষায় ফলাফলের ব্যাখ্যা, বিষয়ের সাথে সম্পর্কিত একাধিক সুপারিশ, পূর্ববর্তী ফলাফল ধরে রাখা, প্রতিক্রিয়াশীল আরবি RTL ইন্টারফেস এবং একীভূতকরণের আগে স্বয়ংক্রিয় পরীক্ষা ও বিল্ড চেক। বর্তমান MVP সুযোগের বাইরে: অ্যাডমিন প্যানেল, প্রশাসনিক পরিসংখ্যান, সিস্টেমের ভিতর থেকে বিষয় পরিচালনার জন্য CRUD, স্বাধীন পাবলিক API, স্বাধীন মোবাইল অ্যাপ, অনুমোদিত মনস্তাত্ত্বিক ডায়াগনোসিস বা সাইকোমেট্রিক পরিমাপ এবং শিক্ষার্থীর পক্ষ থেকে বাধ্যতামূলক সিদ্ধান্ত নেওয়া। নথিতে উল্লেখ করা হয়েছে যে সুযোগের মধ্যে একটি বৈশিষ্ট্যের উপস্থিতি অগত্যা এর বর্তমান বাস্তবায়ন বোঝায় না এবং বাস্তবায়নের অবস্থা Issues, Pull Requests এবং main শাখার মাধ্যমে পর্যবেক্ষণ করা হয়। নির্ভরযোগ্য প্রযুক্তি: Laravel 12 সাথে PHP 8.2+, 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_Log.md-এ প্রভাবশালী ব্যবহার নথিভুক্ত করার আগে AI-উত্পন্ন যেকোনো কোড বোঝা। প্রকল্পের অবস্থা: এখন পর্যন্ত সম্পন্ন হয়েছে ধারণা ও সুযোগ অনুমোদন, মৌলিক নথি প্রস্তুতি, রিপোজিটরি তৈরি ও main সুরক্ষা সেটআপ, Issues ও Pull Requests টেমপ্লেট, Labels, Backlog → Ready → In Progress → In Review → Done অবস্থাসহ GitHub Project, পাঁচটি Milestone, ১৫টি Issue, স্বয়ংক্রিয় যাচাইয়ের জন্য GitHub Actions এবং পরিবেশ, সেটআপ ও যাচাইকরণ স্ক্রিপ্ট এবং Clean Clone পাস। চলমান: Batch 3 — Assessment Journey, Batch 4 — Results & Security, Batch 5 — Finalization & Release এবং অবশিষ্ট Issues বন্ধ ও চূড়ান্ত যাচাইকরণ। নিরাপত্তা: রিপোজিটরিতে স্থানীয় শংসাপত্র নেই, .env শুধুমাত্র স্থানীয় এবং আপলোড নিষিদ্ধ, Laravel সেশন, কুকিজ, CSRF সুরক্ষা এবং পাসওয়ার্ড হ্যাশিং ব্যবহার করে এবং দৈনন্দিন অ্যাপ্লিকেশন চালানোর জন্য প্রশাসনিক root ডেটা ব্যবহার করা হয় না।