مشروع بناء منصة وتطبيقات لادارة المجمعات السكنية

1 — لمحة عامة

نظام إدارة المجمعات السكنية (ويب/لوحة إدارة + تطبيق أندرويد + تطبيق iOS) يهدف لإدارة المجمع، الساكنين، عقود الإيجار/الملكية، الفوترة والدفع الإلكتروني للخدمات (كهرباء، ماء، إنترنت، حراسة...)، وإدارة السكن والتسكين، مع مرونة في تعريف معادلات احتساب الفواتير لاحقًا.

2 — المستخدمون والأدوار (Roles)

مالك النظام / شركة الإدارة (Super Admin)

مدير المجمع / مدير إدارة (Manager)

محاسب (Accountant)

صاحب الوحدة/مالك (Owner)

مؤجر (Landlord) — إن كان مختلف عن المالك (نموذج: المالك يملك الوحدة، المالك يؤجرها لمؤجر)

ساكن / مستأجر (Tenant/Resident)

حارس / أمن (Guard)

فني صيانة (Technician)

زائر/مورد (Visitor/Supplier) — عرض/إدارة مؤقتة

مستخدم قراءة فقط / مراجعة (Auditor)

3 — الكيانات الأساسية وحقول مقترحة (موجز)

(ليس كود، فقط نموذج بيانات لفهم البنية)

المجمع (Complex): اسم، موقع جغرافي، تعريفات ضريبية، عملة، إعدادات مركزيّة.

المبنى/المرحلة (Building/Phase): اسم، طوابق، خرائط.

الوحدة (Unit/Apartment): رقم، الطابق، المساحة، نوع (شقة/فيلا/محل)، حالة (فارغة/مؤجرة/مملوكة).

المستخدم (User): اسم، دور، هوية، هاتف، بريد، وثائق مرفقة، حالة التحقق.

العلاقة مالك/مؤجر/ساكن: ربط بين User و Unit مع نوع العلاقة وتواريخ (من/إلى).

عقد (Contract): طرفان، نوع (إيجار/بيع/خدمات)، تاريخ بداية/نهاية، شروط، إرفاقات (PDF)، بنود دفع، ضمان/تأمين.

خدمة (Service): كهرباء/ماء/إنترنت/حراسة/تنظيف...، طريقة احتساب، جدول رسوم.

معادلة/تعرفة (TariffFormula): نوع (ثابت، تنازلي، تصاعدي، استهلاك × سعر)، معاملات قابلة للتعديل (سنقوم باتفاق لاحقًا).

قراءة عداد (MeterReading): تاريخ، قيمة، نوع عداد، مُدخل يدوي/آلي.

فاتورة (Invoice): رقم، وحدة، تاريخ إصدار، استحقاق، بنود مفصلة، الضرائب، الخصومات، حالة (مستحقة/مدفوعة/متأخرة).

دفعة (Payment): طريقة، مُعرّف معاملة، مبلغ، رسوم معالجة، حالة، وسيلة دفع (بطاقة، حوالة بنكية، محفظة داخلية).

محفظة/رصيد (Wallet): رصيد المقيمين/المالكين إن كان مطلوباً.

طلب صيانة/شكوى (Maintenance/Complaint): رقم، وصف، صور، حالة، فني مكلّف، تكاليف.

تصريح زائر / إدارة بوابة (VisitorAccess): اسم الزائر، وقت دخول/خروج، رمز QR.

سجلات التدقيق (AuditLog): كل تغيّر مهم مع من ومتى ولماذا.

4 — الوظائف الرئيسية (Features) — مختصر وواضح للمبرمج

إدارة المجمع والمباني

أنشاء/تعديل/حذف مجمعات ومباني ووحدات.

تحميل مخطط الوحدة وملف الصور وملفات الملكية.

تعيين مسؤولين لكل مجمع/مبنى.

إدارة المستخدمين والأدوار

تسجيل مستخدمين (بريد/هاتف) + التحقق (OTP/Email).

لوحة تحكم لتعيين الأدوار وصلاحيات قابلة للتهيئة (RBAC).

ملفات تعريف تحتوي على وثائق (جواز/هوية/عقد).

عقود وتسكين

إنشاء العقود عبر قوالب (قابلة للتعديل) وتخزين PDF.

توقيع إلكتروني مبسط (عرض/قبول من الطرفين) أو رفع توقيع.

دورة حياة الساكن: طلب سكن -> موافقة -> توقيع عقد -> تسكين -> تفريغ.

تحديد من هو مالك ومن هو مؤجر في بيانات الوحدة.

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

تعريف بنود الفاتورة (إيجار ثابت، استهلاك، خدمات مشتركة، رسوم خدمة).

دعم معادلات مرنة لكل خدمة (مثال: فاتورة كهرباء = (قراءة جديدة - قراءة سابقة) × سعر/وحدة + رسوم ثابتة).

إنشاء فواتير أوتوماتيكية مجدولة (شهري/ربع سنوي/سنوي).

مصادقة/مراجعة الفواتير قبل الإصدار (دور المحاسب).

إدارة العدادات والقراءات

إدخال قراءات يدوية أو استيراد دفعات قراءات (CSV) أو ربط بواجهات عدادات ذكية لاحقًا.

مقارنة قراءات وإظهار استهلاك وسجل شهري.

الدفع الإلكتروني

تكامل مع بوابات دفع متعددة (بطاقات، تحويل بنكي، محفظة محلية، سداد / فواتير).

تحصيل جزئي/كلي، ضبط رسوم معالجة، تسجيل معاملات.

محفظة داخل النظام (اختياري) مع سحب/إيداع للمالكين (تقاسم إيرادات).

إصدار إيصالات دفع رقمية و reconcilliation تلقائي مع الفواتير.

إدارة المتأخرات والتحصيل

سياسات تأخير (نسبة/مبلغ ثابت)، تنبيهات أوتوماتيكية قبل وبعد الاستحقاق.

قوائم مديونية، محاولات دفع آلية (auto-retry).

إمكانية تجميد الخدمات عند التأخر (تنبيه/تحكم جزئي — تنفيذ فعلي عبر أنظمة خارجية).

حراسة وزيارات وأمن

سجل دخول/خروج الزوار، توليد QR مؤقت للدخول.

واجهة للحرس لاستعراض الزوار، ملاحظات الحراسة، وبلاغات أمنية.

تكامل مع أنظمة البوابة (واجهات API) لاحقًا.

صيانة وورش عمل

إنشاء طلبات صيانة مع أولويات، جداول مقاولين، وتتبع التكلفة والمدة.

تقارير صيانة دورية وذاكرة أعمال سابقة.

إشعارات وتذكيرات

إشعارات دفع، تذكير عقود منتهية، إشعارات صيانة، تنبيهات أمنية.

قنوات: بريد إلكتروني، SMS (تكامل SMS Gateway)، إشعارات Push للتطبيق.

تقارير ولوحات معلومات

لوحة إجمالية للمدير: إشغال، إيرادات، فواتير مستحقة، شكاوى مفتوحة.

تقارير محاسبية: حركة نقدية، كشف حساب لكل وحدة، ملخص تقاسم الإيرادات للمالك.

إمكانية تصدير CSV/PDF.

إدارة المستندات والملفات

أرشيف عقود، فواتير، أوراق ملكية، محاضر اجتماعات، قابلية البحث وحماية بالوصول.

5 — المتطلبات غير الوظيفية (NFRs)

دعم اللغة العربية (RTL) كلغة أساسية؛ واجهة قابلة للترجمة لاحقًا (i18n).

أمان: مصادقة JWT/OAuth2، تشفير بيانات حساسة بالـ rest، حماية ضد XSS/CSRF/SQL injection.

متطلبات الدفع: الامتثال لـ PCI-DSS عند التعامل مع بيانات البطاقات (أو استخدام tokenization عبر بوابة دفع).

أداء: قدرة على التعامل مع آلاف الوحدات، استجابات لوحة < 300-500ms للعمليات الشائعة.

توافر: نسخ احتياطي يومي وقابلية استرجاع.

سجلات تدقيق كاملة لجميع التغييرات المهمة.

قابلية التوسع (multi-tenant إن تطلب الأمر لاحقًا).

6 — واجهات مستخدم مقترحة (مختصر للشاشات الأساسية)

لوحة إدارة (ويب): قائمة مجمعات، لوحة كل مجمع، إدارة المباني والوحدات، إدارة العقود، فواتير، دفعات، شكاوى، صيانة، مستخدمون، إعدادات التعرفة، تقارير.

شاشة إنشاء/تحرير فاتورة (مع اختيار معادلة/تعرفة).

شاشة المحاسب: مراجعة الفواتير، تسويات، تصدير محاسبي.

تطبيق الساكن (Android/iOS): ملف الساكن، الفواتير، دفع الآن، محفظتي، طلب صيانة، إشعارات، وثائق العقد، تذاكر الدعم.

تطبيق الحارس: قائمة الزوار اليوم، مصادقة دخول، سجل الحوادث.

صفحة عامة (حاسوب/ويب) للدفع بدون تسجيل (رابط الفاتورة، إدخال رمز/معرّف).

7 — تكاملات مقترحة (APIs و Gateways)

بوابات دفع: Stripe/PayPal أو بوابة محلية حسب بلد المستخدم (يترك للمناقشة).

بوابة SMS/Email (Twilio/SendGrid أو بدائل محلية).

أنظمة محاسبية (QuickBooks أو ملفات تصدير / واجهة CSV).

أنظمة عدادات ذكية (MQTT/REST) — كخيار لاحق.

خدمات تخزين ملفات (S3 أو بديل محلي).

8 — سيناريوهات / تدفقات رئيسية (Use-cases مختصر)

تسجيل وحدة ورفع مخطط → إضافة مالك → إنشاء عقد إيجار → تسكين ساكن → إصدار فاتورة أولى → إرسال إشعار → ساكن يدفع إلكترونيًا → تسجيل دفعة وإصدار إيصال.

إدخال قراءة عداد → النظام يحسب الاستهلاك وفق المعادلة → إنشاء بند فاتورة خدمة → إشعار ساكن → دفع/تسوية.

ساكن يقدم طلب صيانة → يتم تعيين فني → تتبع حالة → إغلاق وتسجيل التكلفة.

حارس يسجل زائر ويصدر QR → زائر يدخل ويُسجل وقت الخروج.

9 — قواعد عمل مالية / أمثلة معادلات (قابلة للتعديل لاحقًا)

فاتورة كهرباء = (قراءة_جديدة − قراءة_قديمة) × سعر_لكل_وحدة + رسم_خدمة ثابت.

رسوم الخدمات المشتركة = (مجموع_تكاليف_الشهر ÷ عدد_الوحدات_المؤهلة) × معامل_تقسيم (مثلاً حسب المساحة أو حسب وحدة ثابتة).

الإيجار = إيجار_أساسي − خصم/حسم + ضريبة + رسوم خدمة.

ضع واجهة إدارة معادلات تسمح بإدخال معادلات وصيغ (ثابتة/نِسب/صيغ تعتمد على حقول).

10 — متطلبات التسليم للمبرمج (قابل للقياس)

وثيقة متطلبات chức final (هذه الوثيقة مع أي تعديل).

نموذج ERD مختصر وقائمة الجداول + الحقول المهمة.

ملفات واجهات (wireframes) للشاشات الأساسية (لوحة إدارة، تطبيق ساكن، تطبيق حارس).

API spec (REST/GraphQL) مع مسارات أساسية: auth, users, units, contracts, invoices, payments, meter-readings, maintenance, visitors.

سيناريوهات اختبار (Acceptance Criteria) لكل ميزة أساسية.

دليل نشر (deployment) وإعدادات البيئة (env vars، بوابات الدفع، مفاتيح).

دليل أمني (تشفير/نسخ احتياطية/إدارة المفاتيح).

وثائق اختبارات (تغطية يدوية/أوتوماتيكية إن وُجد).

11 — خواص إضافية مقترحة (تزيد من قيمة النظام)

لوحة تقاسم إيرادات للمالكين (صرف شهري/ربع سنوي مع تقرير).

محفظة داخلية للسكان لتسريع الدفع.

جدولة غرف الضيوف/مرافق (مسبح، قاعة احتفالات).

تنبيهات ذكية بالاعتماد على ML بسيطة: كشف استهلاك غير طبيعي، توقع رسوم مستقبلية.

دعم تعدد المجمعات في نفس النظام (multi-complex).

واجهات CSV/Excel لاستيراد/تصدير دفعات ضخمة.

واجهة مخصصة للـowner payout (تحويلات دورية للمالكين).

تكامل مع نظام بوابة ذكي لفتح الأبواب عبر QR.

12 — اعتبارات قانونية وبيانات خاصة

حفظ العقود والوثائق مع توقيت وسجل تدقيق.

الامتثال لقوانين الخصوصية المحلية (تخزين بيانات الهوية، مدة الاحتفاظ).

شروط الاستخدام وسياسة الخصوصية يجب أن تُدمج كجزء من عملية التسجيل.

13 — معايير قبول مُبسطة (مثال)

تسجيل مستخدم جديد + تسجيل وحدة + إنشاء فاتورة دفع يعمل من البداية إلى النهاية بدون أخطاء.

دفع عبر بوابة دفع تجريبية يتم تسجيله ويقفل الفاتورة كـ «مدفوعة».

إنشاء عقد ورفعه PDF وعرضه للساكن والتوقيع المبسّط.

إرسال إشعار دفع تلقائي قبل الاستحقاق بثلاثة أيام.

عند تنفيذ هذه النقاط يُعتبر MVP جاهزًا للاختبار.

14 — ملاحظات أخيرة للمبرمج

لا تفرض معادلات مالية ثابتة في البداية: صمّم نظام تعريفة مرن يسمح بإنشاء صيغ متعددة وتعيينها للوحدات/الخدمات.

فصل طبقات العرض (frontend)، الخدمات (backend)، وبيانات (DB) بحيث يكون النظام قابلًا للتوسع.

صمّم RESTful API مع توثيق (OpenAPI/Swagger) منذ البداية.

جهّز بيئة اختبارية (sandbox) لبوابة الدفع وSMS.