أداة محلية بسيطة لإدارة العقارات والملاك والمستأجرين وعقود الإيجار وتحصيل الدفعات. تعمل بـ Node وحده — بدون Docker، بدون PHP، وبدون أي حزم خارجية.
cd ~/Projects/eqar
node server.mjsثم افتح http://localhost:5050
لتغيير المنفذ (المنفذ 5000 محجوز في macOS لـ AirPlay):
PORT=5060 node server.mjsCtrl+C في نفس النافذة، أو:
kill $(lsof -nP -iTCP:5050 -sTCP:LISTEN -t)الترتيب الطبيعي لإدخال البيانات:
- مالك — الاسم والجوال والآيبان (لتحويل مستحقاته).
- عقار — يُربط بالمالك.
- وحدات — أرقام الشقق داخل العقار وإيجارها الاسترشادي.
- مستأجر — الاسم والجوال والهوية.
- عقد — يربط وحدة بمستأجر.
عند حفظ العقد تُنشأ كل الدفعات تلقائيًا حسب عدد الأقساط المختار (شهري ١٢ / ربع سنوي ٤ / نصف سنوي ٢ / سنوي ١)، بتواريخ استحقاق محسوبة من تاريخ البداية.
بعدها تتابع كل شيء من صفحة التحصيل: كل دفعة تظهر بحالتها (متأخرة / مستحقة / قادمة / محصّلة) وتُسجّل التحصيل بضغطة واحدة.
عند التحصيل يُفتح نموذج بالمبلغ المتبقّي جاهزًا — اكتب أقل منه لتسجيل دفعة جزئية. كل مبلغ مستلَم يُحفظ إيصالًا مستقلًا، فيبقى المتبقّي ظاهرًا والدفعة متأخرة حتى تكتمل. زر «تراجع» يلغي آخر إيصال فقط لا كل ما سُدّد.
كل ما تنفقه على عقار (صيانة، نظافة، حارس، مصعد…) يُسجَّل في شاشة المصروفات، ويُخصم من صافي المالك في كشفه إن كان محمَّلًا عليه. المصروف الموسوم «على حسابك» يُسجَّل للمتابعة دون أن يُخصم من المالك.
بدون هذا كان الكشف مضلّلًا: يعرض ما حُصّل ولا يخصم ما أُنفق.
زر تعديل على أي عقد. لو غيّرت الإيجار أو التواريخ أو عدد الأقساط:
- كل دفعة استُلم عليها مبلغ (ولو جزئيًا) تُجمَّد كما هي — لأنها تمثّل نقودًا دخلت فعلًا ولها إيصالات.
- الدفعات التي لم يُستلم عليها شيء تُحذف ويُعاد توليدها بالشروط الجديدة، للفترة اللاحقة لآخر دفعة مجمَّدة.
مثال: عقد 12,000 على 12 قسط، حُصّلت ثلاثة بـ1,000. رفعت الإيجار إلى 13,200 ← الثلاثة تبقى 1,000، والتسعة الباقية تصير 1,100.
تعديل لا يمسّ الشروط المالية (ملاحظة، رقم عقد إيجار) لا يعيد بناء شيء. ولا يُسمح بتقصير العقد إلى ما قبل دفعة محصّلة.
زر تجديد على العقد النشط: يُنهي القديم ويُنشئ خلفًا يبدأ اليوم التالي لنهايته، مع إمكانية رفع الإيجار. سجلّ دفعات العقد القديم يبقى محفوظًا، والعقد الجديد يحمل إشارة إلى سلفه.
عند إضافة عقار حدّد أتعاب الإدارة: إمّا نسبة من المحصّل أو رسم شهري ثابت (الرسم الثابت يُحتسب عن الأشهر التي جرى فيها تحصيل فعلي، لا عن أشهر التقويم).
شاشة كشوف الملاك تعرض لكل مالك: كم حُصّل، وكم أُنفق على عقاره، وكم أتعابك، وكم الصافي المستحق له مع رقم آيبانه — جاهزة للطباعة أو الحفظ PDF وإرسالها له. وفي أعلاها دخلك أنت موزّعًا على أتعاب الإدارة وعمولات التأجير (حقل «عمولتك» في العقد).
كل دفعة غير محصّلة عليها زر تذكير يفتح واتساب برسالة عربية جاهزة تحمل اسم المستأجر والوحدة والمبلغ وتاريخ الاستحقاق ومدة التأخير. الرسالة لا تُرسل تلقائيًا — تراجعها وتضغط إرسال بنفسك.
- حالة الوحدة (شاغرة/مؤجرة) تتبع عقدها — لا تُضبط يدويًا إلا لوضعها في «صيانة».
- إنهاء العقد يُرجع الوحدة «شاغرة» فورًا.
- نموذج العقد الجديد يعرض الوحدات الشاغرة فقط.
- لوحة التحكم تُنبّه على العقود المنتهية خلال شهرين.
كل شيء في ملف واحد: data/eqar.db (SQLite).
نسخة تلقائية — تُكتب نسخة JSON كاملة إلى backups/ عند كل تشغيل ثم كل
24 ساعة، ويُحتفظ بآخر 14 نسخة وتُحذف الأقدم. لا تُكتب نسخة لقاعدة فارغة.
EQAR_BACKUPS=off node server.mjs # تعطيلها
EQAR_BACKUP_DIR=~/Dropbox/eqar node server.mjs # وجهة أخرىنسخة يدوية — زر «حفظ نسخة احتياطية» أسفل الشريط الجانبي ينزّل كل بياناتك بصيغة JSON. أو انسخ ملف قاعدة البيانات مباشرة:
cp ~/Projects/eqar/data/eqar.db ~/Desktop/eqar-backup-$(date +%Y-%m-%d).dbالتحديث — عند تشغيل نسخة أحدث من الأداة تُضاف الأعمدة الجديدة تلقائيًا لقاعدتك القائمة دون فقد أي بيانات.
بداية من الصفر — احذف الملف وأعد تشغيل الخادم:
rm ~/Projects/eqar/data/eqar.dbعند أول تشغيل تظهر شاشة «أنشئ حسابك» — الحساب الأول هو حسابك، وبعده يُغلق
باب الإنشاء نهائيًا. كلمات المرور مُعمّاة بـ scrypt، والجلسة في كوكي HttpOnly
تنتهي بعد 14 يومًا، وبعد 6 محاولات دخول فاشلة يُقفل العنوان ربع ساعة.
لا شيء تحفظه. اضغط «نسيت كلمة المرور؟» في شاشة الدخول، وشغّل الأمر الذي يظهر لك على الجهاز الذي تعمل عليه الأداة:
node server.mjs reset-passwordيطبع كلمة مرور مؤقتة، ويُبطل كل الجلسات السابقة. ادخل بها ثم غيّرها.
الضمان الأمني هنا أن تنفيذ الأمر يتطلب وصولًا إلى الجهاز أو الخادم نفسه. لو رفعتها لاحقًا وبعتها لعملاء، سيحتاجون إعادة تعيين بالبريد — وهذا يُبنى حينها.
بحث سريع بضغطة ⌘K (أو Ctrl+K): يبحث في المستأجرين والوحدات والعقارات
والملاك والشاشات، وينقلك مباشرة. الأسهم للتنقّل وEnter للاختيار وEsc للإغلاق.
التاريخ الهجري يظهر بجانب الميلادي أعلى الشاشة وتحت كل تاريخ استحقاق ونهاية
عقد. محسوب بتقويم أم القرى عبر Intl المدمج في المتصفح — بلا مكتبات.
مؤشرات الاتجاه (↑ ↓) تقارن آخر 30 يومًا بالثلاثين التي قبلها للتحصيل، وتعيد تقييم المتأخرات والإشغال عند تاريخ سابق. مقام الإشغال هو محفظتك اليوم في الحالتين، أي «كم من وحداتي الحالية كانت تعمل حينها».
الخط Almarai مضمّن داخل public/font.css كـ data URI — يعمل بلا إنترنت.
167 اختبارًا تغطي توليد الدفعات، حالات الوحدات، الحذف والعلاقات، رفض المدخلات الفاسدة، منع الحجز المزدوج، حساب أتعاب الإدارة، الدفعات الجزئية، المصروفات، تعديل العقود وتجديدها، النسخ الاحتياطي، مؤشرات الاتجاه، المصادقة وحماية CSRF. تعمل على قاعدة بيانات مؤقتة ولا تلمس بياناتك:
rm -f /tmp/eqar-test.db && EQAR_DB=/tmp/eqar-test.db PORT=5099 node server.mjs & sleep 2 && node test.mjsشغّلها بعد أي تعديل على server.mjs.
| الملف | الدور |
|---|---|
server.mjs |
الخادم وقاعدة البيانات وواجهة الـ API |
public/index.html |
هيكل الصفحة |
public/style.css |
التصميم (يدعم الوضع الفاتح والداكن) |
public/font.css |
خط Almarai مضمّن (75 ك.ب) |
public/app.js |
منطق الواجهة |
test.mjs |
مجموعة الاختبارات |
DEPLOY.md |
دليل الرفع على الإنترنت |
data/eqar.db |
بياناتك (يُنشأ تلقائيًا) |
backups/ |
النسخ التلقائية اليومية |
- الأداة تعمل على جهازك فقط ولا ترسل أي بيانات لأي جهة.
- مستخدم واحد فقط ولا صلاحيات. لبيعها لعملاء، كل عميل يحتاج نسخة وقاعدة بيانات مستقلة.
- توثيق عقود الإيجار رسميًا يتم عبر منصة إيجار الحكومية؛ هذه الأداة للمتابعة الداخلية، وفيها حقل لحفظ رقم عقد إيجار لكل عقد للربط بينهما.