CompanyManagementDB

نظام إدارة الرواتب

نظام شامل لإدارة الرواتب مصمم باستخدام Python وStreamlit وMySQL. يقوم النظام بإدارة سجلات الموظفين والإدارات والمشاريع وتفاصيل الرواتب.

مخطط قاعدة البيانات

1. جدول الموظفين

• emp_no : INT (المفتاح الأساسي)
• first_name : فارتشار
• last_name : VARCHAR
• job_title : VARCHAR
• basic_salary : عشري
• department_id : INT (المفتاح الخارجي)

2. جدول الأقسام

• department_id : INT (المفتاح الأساسي)
• department_name : VARCHAR
• manager_id : INT (المفتاح الخارجي للموظفين)

3. جدول المشاريع

• project_id : INT (المفتاح الأساسي)
• project_name : VARCHAR
• start_date : DATE
• end_date : التاريخ
• department_id : INT (المفتاح الخارجي للأقسام)

4. جدول مشروع_الموظف (علاقة متعدد بمتعدد)

• emp_no : INT (المفتاح الخارجي للموظفين)
• project_id : INT (المفتاح الخارجي للمشاريع)
• hours_worked : عشري

5. جدول الرواتب

• emp_no : INT (المفتاح الخارجي للموظفين)
• salary_date : التاريخ
• basic_salary : عشري
• da : عشري
• hra : عشري
• gross_salary : عشري
• tax : عشري
• net_salary : عشري

سمات

الاتصال بقاعدة البيانات وإعدادها

• يؤسس الاتصال بقاعدة بيانات MySQL.
• تحديد قاعدة بيانات CompanyManagementDB للعمليات.
• يسرد الجداول المتوفرة ( employees ، departments ، projects ، employee_project ، salaries ).

وظائف معالجة البيانات

• إدراج البيانات في الجداول

  • يسمح بإدراج السجلات في جداول مثل employees departments projects employee_project salaries .
  • يقوم تلقائيًا بحساب DA وHRA والراتب الإجمالي والضريبة وصافي الراتب بناءً على صيغ محددة مسبقًا لإدراج الراتب.

• تحديث البيانات في الجداول

  • يوفر وظيفة لتحديث السجلات الموجودة في جداول مثل employees departments projects employee_project salaries .
  • يسمح بتحديث أعمدة محددة حددها المستخدم.

• حذف البيانات من الجداول

  • تمكين حذف السجلات من الجداول مثل employees departments projects employee_project salaries .
  • يطالب بتحديد الهوية باستخدام المفاتيح الأساسية ( emp_no , department_id , project_id , وما إلى ذلك).

توليد قسيمة الدفع

• إنشاء قسيمة الدفع
  • جلب وعرض تفاصيل كشوف المرتبات لموظف محدد وتاريخ الراتب.
  • حساب وعرض مكونات مثل الراتب الأساسي، DA، HRA، الراتب الإجمالي، الضريبة، وصافي الراتب في جدول منسق باستخدام مكتبة tabulate .

واجهة المستخدم

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

تثبيت

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

   git clone https://github.com/PhenomSG/Payroll-Management-System.git

2. انتقل إلى دليل المشروع:

    cd Payroll-Management-System

3. تثبيت الحزم المطلوبة:

   pip install -r requirements.txt

4. قم بتكوين اتصال قاعدة بيانات MySQL في البرنامج النصي.

الاستخدام

1. قم بتشغيل تطبيق Streamlit:

   streamlit run streamlit_app.py

2. افتح متصفح الويب الخاص بك وانتقل إلى عنوان URL المقدم للتفاعل مع التطبيق.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT.