نظام إدارة العقارات

نظام شامل لإدارة العقارات والمستأجرين والمالكين مع تتبع المدفوعات والإيجارات.

المميزات الرئيسية

🏠 إدارة العقارات

• إضافة وتعديل وحذف العقارات
• عرض بطاقة مستقلة لكل عقار تحتوي على:
  • رقم العقار
  • اسم العقار
  • بيانات العقار (النوع، الموقع، المساحة، عدد الغرف)
  • حالة الإيجار (مؤجر/غير مؤجر)

👤 إدارة المستأجرين

• إضافة وتعديل بيانات المستأجرين
• معلومات شاملة تشمل:
  • البيانات الشخصية (الاسم، الهاتف، البريد الإلكتروني، رقم الهوية)
  • تفاصيل الإيجار (تاريخ البداية والنهاية)
  • المبالغ المالية (الإيجار قبل الضريبة، نسبة الضريبة، القيمة النهائية)
  • نوع العقد (سنوي أو شهري)
  • طريقة الدفع وتوزيع الدفعات

💰 نظام الدفعات المتقدم

• توليد جدول الدفعات تلقائياً عند حفظ بيانات المستأجر
• للعقود السنوية: خيارات متعددة (دفعة واحدة، دفعتين، ثلاث دفعات، أربع دفعات)
• للعقود الشهرية: توزيع على 12 دفعة شهرية
• جدول شامل يحتوي على:
  • رقم الدفعة
  • تاريخ الاستحقاق
  • مبلغ الدفعة
  • تاريخ الدفع الفعلي
  • المبلغ المدفوع
  • الرصيد المتبقي
  • حالة الدفعة (مستحق، مدفوع، متأخر، مدفوع جزئياً)

🏢 إدارة المالكين

• إضافة وإدارة بيانات المالكين
• تحديد نسبة الملكية لكل مالك
• ربط العقارات بالمالكين
• كشوفات حسابات مفصلة لكل مالك

📊 كشوفات المالكين

• عرض جميع المدفوعات المرتبطة بعقارات المالك
• حساب نصيب المالك من كل دفعة حسب نسبة الملكية
• تفاصيل شاملة تشمل:
  • تاريخ الدفعة
  • العقار المرتبط
  • اسم المستأجر
  • المبلغ المدفوع
  • نصيب المالك

📱 تكامل واتساب

• إرسال تذكيرات الدفع عبر واتساب
• رسائل تلقائية تحتوي على تفاصيل الدفعة
• رقم الهاتف مأخوذ من بيانات المستأجر

📎 المرفقات والملفات

• إمكانية إرفاق ملفات مع كل دفعة
• توثيق المدفوعات بالمستندات

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

• React 18 - مكتبة واجهة المستخدم
• Material-UI (MUI) - مكتبة المكونات والتصميم
• React Router - التنقل بين الصفحات
• Vite - أداة البناء والتطوير
• Electron - لتحويل التطبيق إلى تطبيق سطح مكتب
• date-fns - معالجة التواريخ
• UUID - توليد المعرفات الفريدة
• LocalStorage - حفظ البيانات محلياً

هيكل المشروع

src/
├── components/          # مكونات React
│   ├── Dashboard.jsx    # لوحة التحكم الرئيسية
│   ├── AddProperty.jsx  # إضافة عقار جديد
│   ├── PropertyCard.jsx # بطاقة العقار
│   ├── PropertyDetails.jsx # تفاصيل وتعديل العقار
│   ├── TenantDetails.jsx   # بيانات المستأجر
│   ├── PaymentsTable.jsx   # جدول الدفعات
│   ├── OwnersManagement.jsx # إدارة المالكين
│   └── OwnerStatements.jsx  # كشوفات المالكين
├── context/             # إدارة الحالة
│   └── PropertyContext.jsx # سياق البيانات الرئيسي
├── App.jsx             # المكون الرئيسي
├── main.jsx           # نقطة الدخول
└── index.css          # الأنماط العامة

كيفية التشغيل

للتطوير

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

npm install

2. تشغيل الخادم المحلي:

npm run dev

3. فتح المتصفح على:

http://localhost:3005

لتشغيل إصدار سطح المكتب

npm run electron

لبناء إصدار الإنتاج

npm run electron-pack

كيفية التثبيت على جهاز الكمبيوتر

المتطلبات الأساسية

• نظام تشغيل Windows 10 أو أحدث
• مساحة حرة على القرص: 200 ميجابايت
• صلاحيات مسؤول (Administrator) لتثبيت التطبيق

خطوات التثبيت

1. بناء التطبيق للإنتاج:

   • افتح موجه الأوامر (Command Prompt) أو PowerShell

   • انتقل إلى مجلد المشروع

   • قم بتثبيت الحزم المطلوبة:

     npm install
     

   • قم ببناء التطبيق:

     npm run electron-pack
     

2. بعد الانتهاء من البناء، سيتم إنشاء ملف التثبيت في المجلد:

   • dist-electron\كودر لمحاسبة العقارات Setup 1.0.0.exe

3. قم بتشغيل ملف التثبيت واتبع التعليمات على الشاشة:

   • انقر نقرًا مزدوجًا على ملف التثبيت
   • اتبع معالج التثبيت
   • اختر مجلد التثبيت (افتراضي: C:\Program Files\كودر لمحاسبة العقارات)
   • اختر إنشاء اختصار على سطح المكتب
   • انقر على "تثبيت" وانتظر حتى ينتهي التثبيت

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

   • يمكنك تشغيل التطبيق من خلال اختصار سطح المكتب
   • سيتم إنشاء أيقونة للتطبيق باسم "كودر لمحاسبة العقارات"
   • جميع البيانات سيتم حفظها محليًا على جهازك

الاستخدام

إضافة عقار جديد

1. انقر على زر "إضافة عقار جديد" في لوحة التحكم
2. املأ البيانات المطلوبة (رقم العقار، الاسم، النوع، الموقع، المساحة)
3. احفظ البيانات

إضافة مستأجر

1. من بطاقة العقار، انقر على "إضافة مستأجر"
2. املأ بيانات المستأجر الشخصية
3. حدد تفاصيل الإيجار (التواريخ، المبلغ، نوع العقد)
4. اختر طريقة الدفع وعدد الدفعات
5. احفظ البيانات (سيتم توليد جدول الدفعات تلقائياً)

إدارة الدفعات

1. من بطاقة العقار، انقر على "الدفعات"
2. في جدول الدفعات، يمكنك:
   • تعديل حالة الدفعة
   • تسجيل المبلغ المدفوع وتاريخ الدفع
   • إرسال تذكير واتساب
   • إرفاق ملفات

إدارة المالكين

1. انتقل إلى صفحة "المالكين"
2. أضف مالك جديد مع تحديد نسبة الملكية
3. اربط العقارات بالمالك
4. اعرض كشف حساب المالك لرؤية نصيبه من المدفوعات

حفظ البيانات

يستخدم النظام LocalStorage لحفظ البيانات محلياً في المتصفح. البيانات تُحفظ تلقائياً عند كل تغيير ولا تحتاج لخادم أو قاعدة بيانات خارجية.

الدعم والتطوير

النظام مصمم ليكون قابلاً للتوسع والتطوير. يمكن إضافة المزيد من المميزات مثل:

• تقارير مالية مفصلة
• تصدير البيانات
• تنبيهات الاستحقاق
• نظام النسخ الاحتياطي
• تكامل مع أنظمة الدفع الإلكتروني

الترخيص

هذا المشروع مطور خصيصاً لإدارة العقارات ويمكن استخدامه وتعديله حسب الحاجة.