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

এই রিপোজিটরি প্রতি ডিপ্লয়মেন্টে একটি একক স্কুলের জন্য একটি সেলফ-হোস্টেড স্কুল ব্যবস্থাপনা প্ল্যাটফর্ম। এটি Laravel 13, PHP 8.3, MySQL 8 এবং Redis 7 দিয়ে তৈরি, এবং এতে একটি Docker Compose স্ট্যাক (app, nginx, db, redis, MinIO, Horizon, scheduler) রয়েছে। অ্যাডমিন ইন্টারফেসটি Laravel Blade এবং Bootstrap 5 দিয়ে সার্ভার-রেন্ডার করা। পরিধি ও মডিউল: README-তে ২৬টি ডোমেইন মডিউল বর্ণনা করা হয়েছে, যা গ্রুপ করা হয়েছে কোর প্ল্যাটফর্ম (স্কুল, একাডেমিক বছর/ক্লাস/সেকশন/বিষয়/রুটিন, ব্যবহারকারী ও auth), শিক্ষার্থী লাইফসাইকেল (ভর্তি, প্রমোশন, ট্রান্সফার, অনলাইন ভর্তি, ডেটা ইমপোর্ট), একাডেমিকস (পরীক্ষা, মার্কস, GPA/ট্যাবুলেশন, সার্টিফিকেট, RFID সহ উপস্থিতি), ফিন্যান্স (ফি আইটেম, bKash/SSLCommerz/Stripe/PayPal-এর মাধ্যমে পেমেন্ট, চেক, রিফান্ড, পেরোল, রিপোর্ট), যোগাযোগ (ঘোষণা, SMS ব্যাচিং, মেসেজিং থ্রেড), এবং অপারেশনস (স্টাফ, ছুটি, লাইব্রেরি, পরিবহন, ID কার্ড, LMS, ওয়েবসাইট CMS) হিসেবে। একটি লোকালাইজেশন মডিউল RTL সমর্থনসহ ডেটাবেস-ব্যাকড অনুবাদ প্রদান করে। রোলের মধ্যে রয়েছে সুপার অ্যাডমিন, অ্যাডমিন, শিক্ষক, অ্যাকাউন্ট্যান্ট, লাইব্রেরিয়ান, রিসেপশনিস্ট, শিক্ষার্থী এবং অভিভাবক, সাথে আলাদা অ্যাডমিন, স্টাফ এবং শিক্ষার্থী/অভিভাবক পোর্টাল। ওয়েব UI-এর জন্য অনুমোদন Spatie Laravel Permission ব্যবহার করে এবং API-এর জন্য Laravel Sanctum টোকেন ও abilities ব্যবহার করে। আর্কিটেকচার নোট: একটি ডকুমেন্টেড ১০-ধাপের মডিউল প্যাটার্ন (migration, model, repository, service, observer, requests, resources, controller/routes, tests, style/docs), ট্যাগ-ভিত্তিক ক্যাশিংসহ repository প্যাটার্ন যা নন-Redis ক্যাশ স্টোরেও কাজ করে, ডেটাবেস ট্রানজেকশনে মোড়ানো ফিন্যান্সিয়াল রাইট, এবং school_id দ্বারা স্কোপ করা কোয়েরি। README-তে বলা হয়েছে ২০৬+ ফিচার টেস্ট রয়েছে এবং PHPStan লেভেল ৫-এ চলে। ডিপ্লয়মেন্ট: সিড করা ডেমো ক্রেডেনশিয়ালসহ Docker কুইক স্টার্ট, সাথে শেয়ারড cPanel হোস্টিং এবং VPS ইনস্টলের জন্য ডকুমেন্টেড পথ, যা ডেটাবেস-ব্যাকড ক্যাশ/কিউ/সেশন এবং লোকাল ফাইল স্টোরেজে ফলব্যাক করে। API ডকুমেন্টেশন Scribe দিয়ে জেনারেট করা। বহু-দেশ সমর্থন কভার করে লোকেল, কারেন্সি, টাইমজোন, সপ্তাহান্তের দিন, দেশ-নির্দিষ্ট পেমেন্ট গেটওয়ে, এবং কয়েকটি গ্রেডিং টেমপ্লেট (বাংলাদেশ ৫.০, US ৪.০, UK ৯-১, পার্সেন্টেজ)। README-তে প্রকল্পটিকে একটি শখ/R&D প্রচেষ্টা হিসেবে বর্ণনা করা হয়েছে যা মূলত একটি AI কোডিং এজেন্ট দিয়ে তৈরি, এবং স্পষ্টভাবে এটিকে পেশাদারভাবে QA-করা পণ্যের বদলে একটি প্রোটোটাইপিং প্লেগ্রাউন্ড হিসেবে চিহ্নিত করা হয়েছে। এটি AGPL-3.0-এর অধীনে লাইসেন্সপ্রাপ্ত, যার নেটওয়ার্ক-ব্যবহার ক্লজ নেটওয়ার্ক সেবা হিসেবে চালালে পরিবর্তন প্রকাশ করা বাধ্যতামূলক করে।