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

یہ ریپوزٹری ہر تعیناتی کے لیے ایک واحد اسکول کے لیے خود میزبان اسکول مینجمنٹ پلیٹ فارم ہے۔ یہ Laravel 13، PHP 8.3، MySQL 8 اور Redis 7 کے ساتھ بنایا گیا ہے، اور اس کے ساتھ Docker Compose اسٹیک (app، nginx، db، redis، MinIO، Horizon، scheduler) شامل ہے۔ ایڈمن انٹرفیس Laravel Blade اور Bootstrap 5 کے ساتھ سرور رینڈرڈ ہے۔ دائرہ کار اور ماڈیولز: README میں 26 ڈومین ماڈیولز بیان کیے گئے ہیں جو بنیادی پلیٹ فارم (اسکول، تعلیمی سال/کلاسز/سیکشنز/مضامین/روٹینز، صارفین اور تصدیق)، طالب علم لائف سائیکل (داخلہ، ترقی، منتقلی، آن لائن داخلہ، ڈیٹا درآمد)، تعلیمی امور (امتحانات، نمبرات، GPA/ٹیبیولیشن، سرٹیفکیٹس، RFID کے ساتھ حاضری)، مالیات (فیس آئٹمز، bKash/SSLCommerz/Stripe/PayPal کے ذریعے ادائیگیاں، چیک، ریفنڈز، تنخواہ، رپورٹس)، مواصلات (اعلانات، SMS بیچنگ، میسجنگ تھریڈز)، اور آپریشنز (عملہ، رخصت، لائبریری، ٹرانسپورٹ، شناختی کارڈز، LMS، ویب سائٹ CMS) میں گروپ کیے گئے ہیں۔ ایک لوکلائزیشن ماڈیول RTL معاونت کے ساتھ ڈیٹا بیس سے چلنے والے تراجم فراہم کرتا ہے۔ کرداروں میں سپر ایڈمن، ایڈمن، ٹیچر، اکاؤنٹنٹ، لائبریرین، ریسیپشنسٹ، طالب علم اور والدین شامل ہیں، جن کے لیے الگ الگ ایڈمن، اسٹاف اور طالب علم/سرپرست پورٹلز ہیں۔ اجازت کے لیے ویب UI میں Spatie Laravel Permission اور API کے لیے صلاحیتوں کے ساتھ Laravel Sanctum ٹوکنز استعمال ہوتے ہیں۔ فن تعمیر کے نوٹس: ایک دستاویزی 10 مرحلوں کا ماڈیول پیٹرن (migration، model، repository، service، observer، requests، resources، controller/routes، tests، style/docs)، ٹیگ پر مبنی کیشنگ کے ساتھ ریپوزٹری پیٹرن جو غیر Redis کیش اسٹورز پر بھی کام کرتا ہے، ڈیٹا بیس ٹرانزیکشنز میں لپٹی مالی تحریریں، اور school_id کے ذریعے محدود کوئریز۔ README میں بتایا گیا ہے کہ 206+ فیچر ٹیسٹس موجود ہیں اور PHPStan لیول 5 پر چلتا ہے۔ تعیناتی: seeded ڈیمو اسناد کے ساتھ Docker کوئیک اسٹارٹ، نیز مشترکہ cPanel ہوسٹنگ اور VPS انسٹالز کے لیے دستاویزی راستے جو ڈیٹا بیس سے چلنے والے کیش/قطار/سیشنز اور مقامی فائل اسٹوریج پر واپس آ جاتے ہیں۔ API دستاویزات Scribe کے ساتھ تیار کی جاتی ہیں۔ کثیر الملکی معاونت میں لوکل، کرنسی، ٹائم زون، ہفتے کے آخر کے دن، ملک کے مخصوص ادائیگی گیٹ ویز، اور کئی گریڈنگ ٹیمپلیٹس (بنگلہ دیش 5.0، امریکہ 4.0، برطانیہ 9-1، فیصد) شامل ہیں۔ README اس پروجیکٹ کو ایک شوق/R&D کوشش قرار دیتا ہے جو بڑی حد تک ایک AI کوڈنگ ایجنٹ کے ساتھ بنائی گئی، اور واضح طور پر اسے پیشہ ورانہ QA شدہ پروڈکٹ کے بجائے پروٹوٹائپنگ پلے گراؤنڈ کے طور پر بیان کرتا ہے۔ یہ AGPL-3.0 کے تحت لائسنس یافتہ ہے، جس کی نیٹ ورک استعمال کی شق نیٹ ورک سروس کے طور پر چلانے پر تبدیلیاں شائع کرنے کا تقاضا کرتی ہے۔