🏢 MOLAK v2.0

المرجع الكامل والشامل للمشروع
📌 مرجع دائم
استخدم هذا الملف دائماً في أي محادثة عن المشروع
يحتوي على كل التفاصيل + خطة العمل الكاملة + Checklist جاهز للطباعة

📋 جدول المحتويات

  1. نظرة عامة على المشروع
  2. ملاحظات مهمة جداً
  3. إحصائيات المشروع
  4. الأقسام الرئيسية
  5. التفاصيل التقنية
  6. المراحل الزمنية
  7. قائمة المهام الكاملة (Checklist)
  8. القائمة النهائية

🎯 نظرة عامة على المشروع

MOLAK v2.0 هي منصة SaaS شاملة لإدارة العقارات في الإمارات العربية المتحدة، تربط بين:

🏢 أصحاب العقارات
الزبائن الأساسيين
🏠 المستأجرين
المستخدمين
🔧 مزودي الخدمة
الشركاء
👨‍💼 فريق الإدارة
أنت وفريقك

⚠️ ملاحظات مهمة جداً

💰 1. رسوم الخدمة (Service Charge)

رسوم المنصة على الصيانة: 3.1%

const SERVICE_CHARGE_RATE = 3.1; // 3.1% على كل معاملة صيانة // مثال على الحساب: قيمة الصيانة = 1,000 AED رسوم الخدمة (3.1%) = 31 AED المبلغ لمزود الخدمة = 969 AED المبلغ للمنصة = 31 AED

آلية العمل:

  • عند إنشاء عقد صيانة، يتم حساب رسوم الخدمة تلقائياً
  • يتم خصم الرسوم من المبلغ المدفوع قبل تحويله لمزود الخدمة
  • المالك يدفع المبلغ الكامل
  • مزود الخدمة يستلم المبلغ بعد خصم 3.1%
  • المنصة تحصل على 3.1% كإيراد

الأماكن المتأثرة في النظام:

  1. صفحة إنشاء طلب الصيانة (Owner Panel)
  2. صفحة قبول عرض السعر (Owner Panel)
  3. صفحة معالجة الدفع (Payment Processing)
  4. نظام المحفظة (Provider Wallet)
  5. التقارير المالية (Financial Reports)
  6. Cron Job لإطلاق Escrow

🌐 2. التعدد اللغوي (Bilingual System)

المشروع كامل يجب أن يدعم: العربية (AR) + الإنجليزية (EN)

المتطلبات:

  • ✅ واجهة المستخدم: كل النصوص والأزرار والقوائم
  • ✅ قاعدة البيانات: جداول الترجمة للمحتوى الديناميكي
  • ✅ الإشعارات: البريد الإلكتروني، SMS، In-App
  • ✅ التقارير: PDF والإكسل بكلا اللغتين
  • ✅ الوثائق: العقود والإيصالات
  • ✅ رسائل الخطأ: جميع رسائل النظام
  • ✅ RTL Support: دعم كامل للعربية
// بنية ملفات اللغة languages/ ├── ar.php # ملف الترجمة العربية └── en.php # ملف الترجمة الإنجليزية // مثال على الاستخدام function __($key) { global $lang; return $lang[$key] ?? $key; } echo __('dashboard'); // لوحة التحكم أو Dashboard

قاعدة البيانات:

-- كل جدول يحتوي محتوى للمستخدم يجب أن يحتوي على عمودين: CREATE TABLE example ( name_ar VARCHAR(100), -- العربية name_en VARCHAR(100), -- الإنجليزية desc_ar TEXT, desc_en TEXT );

📊 إحصائيات المشروع الإجمالية

📁 الكلاسات
~65
كلاس PHP
📄 الصفحات
~270
صفحة
🗄️ الجداول
~60
جدول
🔄 ملفات AJAX
~40
ملف
⏰ Cron Jobs
7
مهام مجدولة
⏱️ المدة
3.5-5
أشهر

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

المجال التقنية
BackendPHP 8.x (Pure PHP - No Framework)
FrontendHTML5, CSS3, JavaScript (Vanilla + jQuery)
قاعدة البياناتMySQL 8.0
CSS FrameworkBootstrap 5
الرسوم البيانيةChart.js
الجداولDataTables
القوائم المنسدلةSelect2
الأيقوناتFont Awesome / Lucide Icons

🏗️ الأقسام الرئيسية

1️⃣ قسم الإدارة الداخلية (Admin Panel)
الكلاسات
14
الصفحات
75

المسؤوليات الرئيسية:

  • ✅ الموافقة على الملاك الجدد
  • ✅ التحقق من مزودي الخدمة (KYC/KYB)
  • ✅ التحقق من هوية المستأجرين (KYC)
  • ✅ إدارة الاشتراكات والفواتير
  • ✅ مراجعة إعلانات السوق
  • ✅ حل النزاعات
  • ✅ الدعم الفني
  • ✅ التقارير والتحليلات
  • ✅ إعدادات النظام

الكلاسات الرئيسية:

InternalAdmin.php - كلاس المدير الداخلي
AdminAuth.php - مصادقة المدراء
AdminPermissions.php - صلاحيات المدراء
OwnerManagement.php - إدارة الملاك
TenantManagement.php - إدارة المستأجرين
ProviderManagement.php - إدارة المزودين
SubscriptionManagement.php - إدارة الاشتراكات
MarketplaceModeration.php - مراجعة السوق
DisputeResolution.php - حل النزاعات
SupportTickets.php - تذاكر الدعم
Analytics.php - التحليلات
Reports.php - التقارير
SystemSettings.php - إعدادات النظام
AuditLog.php - سجل التدقيق
2️⃣ قسم المالك (Owner Panel)
الكلاسات
17
الصفحات
82

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

  • 🏢 إدارة المباني والوحدات
  • 📝 إدارة المستأجرين والعقود
  • 💰 إدارة المدفوعات والأقساط
  • 🔧 نظام طلبات الصيانة (RFQ)
  • 📢 إعلانات السوق للوحدات الشاغرة
  • 👥 فريق عمل متعدد بصلاحيات مختلفة
  • 📊 تقارير مالية شاملة
  • 💳 نظام الاشتراكات

الكلاسات الرئيسية:

Owner.php - كلاس المالك الرئيسي
OwnerAuth.php - مصادقة المالك
OwnerPermissions.php - صلاحيات فريق المالك
Building.php - إدارة المباني
Unit.php - إدارة الوحدات
Contract.php - إدارة العقود
Installment.php - إدارة الأقساط
Payment.php - إدارة المدفوعات
Receipt.php - إدارة الإيصالات
Tenant.php - إدارة المستأجرين
Maintenance.php - إدارة الصيانة
MarketplaceListing.php - إعلانات السوق
Inquiry.php - استفسارات السوق
Team.php - فريق العمل
Subscription.php - الاشتراك
Reports.php - التقارير
Notification.php - الإشعارات
3️⃣ قسم المستأجر (Tenant Panel)
الكلاسات
8
الصفحات
37

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

  • 📝 عرض العقد والوثائق
  • 💳 الدفع الأونلاين للأقساط
  • 🔧 طلبات الصيانة
  • 🏠 البحث عن وحدات في السوق
  • 📞 الاستفسار عن العقارات
  • 🆔 KYC والتحقق من الهوية

الكلاسات الرئيسية:

TenantUser.php - كلاس المستأجر
TenantAuth.php - مصادقة المستأجر
TenantContract.php - عقد المستأجر
TenantPayment.php - مدفوعات المستأجر
TenantMaintenance.php - صيانة المستأجر
TenantInquiry.php - استفسارات السوق
OnlinePayment.php - الدفع الأونلاين (Stripe)
KYCVerification.php - التحقق من الهوية
4️⃣ قسم مزود الخدمة (Service Provider Panel)
الكلاسات
9
الصفحات
48

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

  • 📥 استلام RFQs من الملاك
  • 💼 تقديم عروض أسعار
  • 🔨 إدارة أوامر العمل
  • 💰 نظام المحفظة والسحوبات
  • 🔒 نظام Escrow للحماية (مع رسوم 3.1%)
  • ⭐ التقييمات والمراجعات
  • 📋 التحقق من الوثائق

الكلاسات الرئيسية:

ServiceProvider.php - كلاس المزود الرئيسي
ProviderAuth.php - مصادقة المزود
ProviderRFQ.php - طلبات عروض الأسعار
ProviderQuote.php - عروض الأسعار
ProviderWorkOrder.php - أوامر العمل
ProviderWallet.php - المحفظة (مع 3.1%)
ProviderPayout.php - السحوبات
ProviderRating.php - التقييمات
ProviderVerification.php - التحقق

📅 المراحل الزمنية

المرحلة المدة الأسابيع التراكمية المخرجات
1. البنية الأساسية1-2 أسابيع1-2Config, DB, Auth, Classes الأساسية
2. قسم الإدارة2-3 أسابيع3-514 كلاس، 75 صفحة
3. قسم المالك3-4 أسابيع6-917 كلاس، 82 صفحة
4. قسم المستأجر2 أسابيع8-118 كلاسات، 37 صفحة
5. قسم المزود2-3 أسابيع10-149 كلاسات، 48 صفحة
6. الميزات المتقدمة2-3 أسابيع12-17Notifications, Disputes, Analytics
7. الأتمتة والتحسينات1-2 أسابيع13-197 Cron Jobs, Optimization
8. الاختبار والإطلاق1-2 أسابيع14-21Testing, Documentation, Launch

📊 المدة الإجمالية المتوقعة

14-21 أسبوع (3.5-5 أشهر)

📋 قائمة المهام الكاملة (Complete Checklist)

🖨️ جاهز للطباعة

اطبع هذا القسم وأشّر على كل مهمة عند الانتهاء منها

استخدم الرمز ☐ للمهام غير المنجزة والرمز ☑ للمهام المنجزة

🎯 المرحلة 1: البنية الأساسية (Foundation)

1.1 إعداد البيئة

تثبيت PHP 8.x
تثبيت MySQL 8.0
تثبيت Apache/Nginx
تثبيت Composer
اختبار بيئة PHP

1.2 إنشاء هيكل المشروع

إنشاء مجلد molak_v2/
إنشاء مجلد config/
إنشاء مجلد includes/
إنشاء مجلد classes/
إنشاء مجلد admin/
إنشاء مجلد owner/
إنشاء مجلد tenant/
إنشاء مجلد service-provider/
إنشاء مجلد auth/
إنشاء مجلد assets/ (css, js, images)
إنشاء مجلد uploads/
إنشاء مجلد languages/ (ar.php, en.php)
إنشاء مجلد cron/

1.3 ملفات الإعدادات (config/)

إنشاء config/database.php
إنشاء config/app.php (مع SERVICE_CHARGE_RATE = 3.1)
إنشاء config/mail.php
إنشاء config/stripe.php
إنشاء config/twilio.php

1.4 قاعدة البيانات

إنشاء قاعدة بيانات molak_v2
تنفيذ molak_v2_schema.sql
تنفيذ molak_v2_seed.sql
التحقق من جميع الجداول (~60 جدول)
اختبار البيانات التجريبية

1.5 الكلاسات الأساسية

إنشاء classes/Database.php
إنشاء classes/Auth.php
إنشاء classes/User.php
إنشاء classes/Permission.php
اختبار جميع الكلاسات

1.6 ملفات اللغة

إنشاء languages/ar.php (جميع الترجمات)
إنشاء languages/en.php (جميع الترجمات)
إنشاء دالة __($key) للترجمة
اختبار تبديل اللغة
اختبار RTL للعربية

1.7 نظام المصادقة (auth/)

إنشاء auth/login.php
إنشاء auth/register-owner.php
إنشاء auth/register-tenant.php
إنشاء auth/register-provider.php
إنشاء auth/forgot-password.php
إنشاء auth/reset-password.php
إنشاء auth/verify-email.php
إنشاء auth/logout.php
اختبار جميع صفحات المصادقة

1.8 اختبارات المرحلة 1

اختبار الاتصال بقاعدة البيانات
اختبار تسجيل الدخول لجميع الأنواع
اختبار التسجيل
اختبار إعادة تعيين كلمة المرور
اختبار تبديل اللغة (AR/EN)
اختبار RTL
اختبار CSRF Protection
مراجعة الأمان
🎯 المرحلة 2: قسم الإدارة الداخلية (Admin Panel)

2.1 كلاسات قسم الإدارة (14 كلاس)

InternalAdmin.php - كلاس المدير
AdminAuth.php - مصادقة المدراء
AdminPermissions.php - الصلاحيات
OwnerManagement.php - إدارة الملاك
TenantManagement.php - إدارة المستأجرين
ProviderManagement.php - إدارة المزودين
SubscriptionManagement.php - الاشتراكات
MarketplaceModeration.php - مراجعة السوق
DisputeResolution.php - النزاعات
SupportTickets.php - الدعم
Analytics.php - التحليلات
Reports.php - التقارير
SystemSettings.php - الإعدادات
AuditLog.php - سجل التدقيق

2.2 صفحات قسم الإدارة (75 صفحة)

admin/dashboard.php - لوحة التحكم
admin/owners/ (10 صفحات)
admin/tenants/ (8 صفحات)
admin/providers/ (9 صفحات)
admin/subscriptions/ (7 صفحات)
admin/marketplace/ (6 صفحات)
admin/disputes/ (5 صفحات)
admin/support/ (8 صفحات)
admin/analytics/ (5 صفحات)
admin/reports/ (4 صفحات)
admin/settings/ (7 صفحات)
admin/admins/ (6 صفحات)

2.3 اختبارات المرحلة 2

اختبار تسجيل دخول المدراء
اختبار الصلاحيات لكل دور
اختبار الموافقة على ملاك
اختبار التحقق من KYC
اختبار إدارة الاشتراكات
اختبار دعم اللغتين (AR/EN)
مراجعة الأمان
🎯 المرحلة 3: قسم المالك (Owner Panel)

3.1 كلاسات قسم المالك (17 كلاس)

Owner.php - كلاس المالك
OwnerAuth.php - المصادقة
OwnerPermissions.php - الصلاحيات
Building.php - المباني
Unit.php - الوحدات
Contract.php - العقود
Installment.php - الأقساط
Payment.php - المدفوعات
Receipt.php - الإيصالات
Tenant.php - المستأجرين
Maintenance.php - الصيانة
MarketplaceListing.php - الإعلانات
Inquiry.php - الاستفسارات
Team.php - فريق العمل
Subscription.php - الاشتراك
Reports.php - التقارير
Notification.php - الإشعارات

3.2 صفحات قسم المالك (82 صفحة)

owner/dashboard.php
owner/buildings/ (12 صفحة)
owner/units/ (14 صفحة)
owner/contracts/ (15 صفحة)
owner/tenants/ (8 صفحات)
owner/payments/ (7 صفحات)
owner/maintenance/ (10 صفحات)
owner/marketplace/ (8 صفحات)
owner/team/ (6 صفحات)
owner/reports/ (6 صفحات)
owner/subscription/ (5 صفحات)
owner/settings/ (7 صفحات)

3.3 اختبارات المرحلة 3

اختبار إضافة مبنى ووحدات
اختبار إنشاء عقد وأقساط
اختبار نظام الصيانة الكامل (RFQ)
اختبار حساب رسوم الخدمة 3.1%
اختبار إعلانات السوق
اختبار التقارير (PDF/Excel)
اختبار دعم اللغتين
مراجعة الأمان
🎯 المرحلة 4: قسم المستأجر (Tenant Panel)

4.1 كلاسات قسم المستأجر (8 كلاسات)

TenantUser.php
TenantAuth.php
TenantContract.php
TenantPayment.php
TenantMaintenance.php
TenantInquiry.php
OnlinePayment.php (Stripe)
KYCVerification.php

4.2 صفحات قسم المستأجر (37 صفحة)

tenant/home.php
tenant/contract/ (5 صفحات)
tenant/payments/ (8 صفحات)
tenant/maintenance/ (7 صفحات)
tenant/unit/ (3 صفحات)
tenant/marketplace/ (8 صفحات)
tenant/kyc/ (4 صفحات)
tenant/profile/ (2 صفحات)

4.3 اختبارات المرحلة 4

اختبار عرض العقد
اختبار الدفع الأونلاين (Stripe)
اختبار Apple Pay و Google Pay
اختبار طلب صيانة
اختبار البحث عن وحدات
اختبار رفع وثائق KYC
اختبار دعم اللغتين
مراجعة الأمان
🎯 المرحلة 5: قسم مزود الخدمة (Service Provider)

5.1 كلاسات قسم المزود (9 كلاسات)

ServiceProvider.php
ProviderAuth.php
ProviderRFQ.php
ProviderQuote.php
ProviderWorkOrder.php
ProviderWallet.php (مع رسوم 3.1%)
ProviderPayout.php
ProviderRating.php
ProviderVerification.php

5.2 صفحات قسم المزود (48 صفحة)

service-provider/dashboard.php
service-provider/verification/ (3 صفحات)
service-provider/rfqs/ (5 صفحات)
service-provider/quotes/ (7 صفحات)
service-provider/work-orders/ (9 صفحات)
service-provider/wallet/ (5 صفحات)
service-provider/ratings/ (4 صفحات)
service-provider/profile/ (4 صفحات)
service-provider/settings/ (7 صفحات)

5.3 اختبارات المرحلة 5

اختبار استلام RFQs
اختبار إنشاء عرض سعر
اختبار أوامر العمل
اختبار المحفظة
اختبار حساب رسوم الخدمة 3.1%
اختبار Escrow
اختبار طلب سحب
اختبار التقييمات
اختبار دعم اللغتين
مراجعة الأمان
🎯 المرحلة 6: الميزات المتقدمة

6.1 نظام الإشعارات

إنشاء كلاس Notification.php
قوالب البريد (ar/ و en/)
تكامل Twilio للـ SMS
In-App Notifications
اختبار جميع القنوات
اختبار باللغتين

6.2 السوق العام

public/browse.php
public/search.php
public/listing.php
اختبار البحث والفلاتر

6.3 النزاعات والدعم

اختبار نظام النزاعات
اختبار نظام التذاكر
اختبار تعيين المهام
🎯 المرحلة 7: الأتمتة والتحسينات

7.1 المهام المجدولة (7 Cron Jobs)

cron/payment_reminders.php
cron/contract_status_update.php
cron/escrow_release.php (مع 3.1%)
cron/subscription_renewal.php
cron/monthly_reports.php
cron/session_cleanup.php
cron/database_backup.php
إعداد Crontab
اختبار جميع المهام

7.2 التحسينات

تحسين الاستعلامات البطيئة
إضافة Indexes للجداول
Caching للبيانات المتكررة
Lazy Loading للصور
Minification للـ CSS/JS
ضغط الصور

7.3 الأمان النهائي

مراجعة جميع نقاط الإدخال
اختبار SQL Injection
اختبار XSS
اختبار CSRF
Rate Limiting على APIs
مراجعة الصلاحيات
Audit Log كامل
فحص الثغرات الأمنية
🎯 المرحلة 8: الاختبار والإطلاق

8.1 الاختبار الشامل

اختبار جميع سيناريوهات الاستخدام
اختبار على Desktop/Mobile
اختبار المتصفحات (Chrome, Firefox, Safari, Edge)
اختبار الأداء
اختبار الأمان
اختبار العربية (RTL)
اختبار الإنجليزية
اختبار Stripe Integration
اختبار Twilio SMS

8.2 التوثيق

دليل المستخدم (Owner) - AR
دليل المستخدم (Owner) - EN
دليل المستخدم (Tenant) - AR
دليل المستخدم (Tenant) - EN
دليل المستخدم (Provider) - AR
دليل المستخدم (Provider) - EN
دليل الإدارة
التوثيق التقني (API)

8.3 الإطلاق

إعداد السيرفر الحقيقي
إعداد قاعدة البيانات
إعداد SSL/HTTPS
إعداد النطاق (Domain)
إعداد البريد الإلكتروني
إعداد Stripe (Live Mode)
إعداد Twilio (Live)
رفع الملفات
الإعدادات النهائية (production mode)
اختبار نهائي كامل
الإطلاق التجريبي (Beta)
جمع الملاحظات وإصلاح المشاكل
الإطلاق الرسمي 🚀

✅ القائمة النهائية للمراجعة

الوظائف الأساسية
تسجيل الدخول لجميع الأنواع
التسجيل لجميع الأنواع
2FA يعمل
إعادة تعيين كلمة المرور
رفع الملفات آمن
تبديل اللغة يعمل (AR/EN)
RTL للعربية يعمل بشكل صحيح
قسم الإدارة
الموافقة على ملاك
التحقق من KYC للمستأجرين
الموافقة على مزودين
إدارة الاشتراكات
مراجعة الإعلانات
النزاعات والدعم
التحليلات والتقارير
قسم المالك
إضافة مباني ووحدات
إنشاء عقود وأقساط
تسجيل مدفوعات
نظام الصيانة الكامل (RFQ → Quote → Work Order)
رسوم الخدمة 3.1% تعمل بشكل صحيح
إعلانات السوق
فريق العمل والصلاحيات
التقارير (PDF و Excel)
قسم المستأجر
عرض العقد
الدفع الأونلاين (Stripe - Card, Apple Pay, Google Pay)
طلبات الصيانة
البحث عن وحدات
KYC والتحقق من الهوية
قسم المزود
استلام RFQs
تقديم عروض
أوامر العمل
المحفظة (مع رسوم 3.1%)
Escrow
السحوبات
التقييمات
الأتمتة
Cron Jobs تعمل (7 مهام)
إرسال التذكيرات
تحديث الحالات
إطلاق Escrow (مع 3.1%)
النسخ الاحتياطي
الأمان
HTTPS مفعل
CSRF Protection
XSS Prevention
SQL Injection Prevention
File Upload Security
Rate Limiting
Audit Logging
الأداء
سرعة تحميل مقبولة
Indexes في الجداول
Caching
Minification (CSS/JS)
Image Optimization
التعدد اللغوي
جميع الصفحات بالعربية
جميع الصفحات بالإنجليزية
الإشعارات باللغتين
التقارير باللغتين
RTL يعمل بشكل صحيح
تبديل اللغة سلس
التوثيق
دليل المستخدم (جميع الأنواع)
التوثيق التقني
أدلة بالعربية والإنجليزية
الإطلاق
السيرفر جاهز ومحمي
قاعدة البيانات جاهزة
SSL مثبت
النطاق مربوط
Stripe Live Mode
Twilio Live
اختبار نهائي كامل
الإطلاق! 🚀

🎉 مبروك!

تم إطلاق MOLAK v2.0 بنجاح!

✅ جميع الوظائف تعمل
✅ الأمان محكم
✅ الأداء ممتاز
✅ دعم كامل للعربية والإنجليزية
✅ رسوم الخدمة 3.1% تعمل بشكل صحيح
✅ المستخدمون راضون
✅ الإيرادات تتدفق
🎊 مبروك النجاح! 🎊