Hostel Management System Using Flask

نظام إدارة بيت الشباب

هذا تطبيق ويب يعتمد على القارورة لإدارة نزل. ويشمل وظائف لتسجيل الطلاب ، والغرف الإدارة ، ونفقات التتبع ، والمزيد.

سمات

• تسجيل الطلاب مع التفاصيل بما في ذلك الاسم والرسوم ورقم الغرفة والصورة.
• إدارة الغرف ومعرفة الطلاب الذين تم تعيينهم إلى الغرف.
• تتبع النفقات الشهرية عن طريق إضافة العناصر وأسعارها.
• عرض قائمة بجميع الطلاب والغرف.
• تصميم متجاوب باستخدام bootstrap.

التقنيات المستخدمة

• بيثون
• قارورة
• Sqlalchemy
• Flask-WTF
• bootstrap
• sqlite
• pipenv

أدوات DEV الموصى بها

• مقابل الكود
• التنسيق الأسود

الإعداد والتركيب

1. استنساخ المستودع:

   git clone https://github.com/yourusername/Hostel-Management-System-Using-Flask.git
   cd Hostel-Management-System-Using-Flask

2. قم بإنشاء بيئة افتراضية وتفعيلها (اسم دليل البيئة الافتراضية IS .venv ):

   python3 -m venv .venv
   source .venv/bin/activate  # On Windows use `.venvScriptsactivate`

3. قم بتثبيت pipenv Package Manager

   pip install pipenv

4. تثبيت التبعيات:

   pipenv install

5. تهيئة قاعدة البيانات:

   flask db init
   flask db upgrade

6. تشغيل التطبيق:

   flask run

7. افتح متصفحك وانتقل إلى http://127.0.0.1:5000 .

هيكل التطبيق

• app.py : ملف التطبيق الرئيسي يحتوي على طرق ومنطق.
• models.py : نماذج قاعدة البيانات للطالب والغرفة والمصروفات.
• forms.py : نماذج لتسجيل الطلاب وإضافة النفقات.
• templates/ : قوالب HTML لصفحات التطبيق.
• static/ : ملفات ثابتة بما في ذلك CSS والصور.
• migrations/ : ملفات ترحيل قاعدة البيانات.

الطرق

• / : الصفحة الرئيسية مع روابط للتسجيل وعرض الطلاب وعرض الغرف وإدارة النفقات.
• /enroll : نموذج لتسجيل طالب جديد.
• /students : قائمة بجميع الطلاب المسجلين.
• /rooms : قائمة بجميع الغرف والطلاب المعينين.
• /expenses : شكل لإضافة النفقات وعرض إجمالي النفقات الشهرية.

رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص لمزيد من التفاصيل.

المساهمة

المساهمات مرحب بها! يرجى فتح مشكلة أو إرسال طلب سحب.

اتصال

للحصول على أي أسئلة أو اقتراحات ، يرجى الاتصال بـ [email protected].