Skip to content
ahmothPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

عقار — أداة إدارة الأملاك وعقود الإيجار

أداة محلية بسيطة لإدارة العقارات والملاك والمستأجرين وعقود الإيجار وتحصيل الدفعات. تعمل بـ Node وحده — بدون Docker، بدون PHP، وبدون أي حزم خارجية.

التشغيل

cd ~/Projects/eqar
node server.mjs

ثم افتح http://localhost:5050

لتغيير المنفذ (المنفذ 5000 محجوز في macOS لـ AirPlay):

PORT=5060 node server.mjs

الإيقاف

Ctrl+C في نفس النافذة، أو:

kill $(lsof -nP -iTCP:5050 -sTCP:LISTEN -t)

طريقة العمل

الترتيب الطبيعي لإدخال البيانات:

  1. مالك — الاسم والجوال والآيبان (لتحويل مستحقاته).
  2. عقار — يُربط بالمالك.
  3. وحدات — أرقام الشقق داخل العقار وإيجارها الاسترشادي.
  4. مستأجر — الاسم والجوال والهوية.
  5. عقد — يربط وحدة بمستأجر.

عند حفظ العقد تُنشأ كل الدفعات تلقائيًا حسب عدد الأقساط المختار (شهري ١٢ / ربع سنوي ٤ / نصف سنوي ٢ / سنوي ١)، بتواريخ استحقاق محسوبة من تاريخ البداية.

بعدها تتابع كل شيء من صفحة التحصيل: كل دفعة تظهر بحالتها (متأخرة / مستحقة / قادمة / محصّلة) وتُسجّل التحصيل بضغطة واحدة.

الدفعات الجزئية

عند التحصيل يُفتح نموذج بالمبلغ المتبقّي جاهزًا — اكتب أقل منه لتسجيل دفعة جزئية. كل مبلغ مستلَم يُحفظ إيصالًا مستقلًا، فيبقى المتبقّي ظاهرًا والدفعة متأخرة حتى تكتمل. زر «تراجع» يلغي آخر إيصال فقط لا كل ما سُدّد.

المصروفات

كل ما تنفقه على عقار (صيانة، نظافة، حارس، مصعد…) يُسجَّل في شاشة المصروفات، ويُخصم من صافي المالك في كشفه إن كان محمَّلًا عليه. المصروف الموسوم «على حسابك» يُسجَّل للمتابعة دون أن يُخصم من المالك.

بدون هذا كان الكشف مضلّلًا: يعرض ما حُصّل ولا يخصم ما أُنفق.

تعديل العقد

زر تعديل على أي عقد. لو غيّرت الإيجار أو التواريخ أو عدد الأقساط:

  • كل دفعة استُلم عليها مبلغ (ولو جزئيًا) تُجمَّد كما هي — لأنها تمثّل نقودًا دخلت فعلًا ولها إيصالات.
  • الدفعات التي لم يُستلم عليها شيء تُحذف ويُعاد توليدها بالشروط الجديدة، للفترة اللاحقة لآخر دفعة مجمَّدة.

مثال: عقد 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/ النسخ التلقائية اليومية

ملاحظات

  • الأداة تعمل على جهازك فقط ولا ترسل أي بيانات لأي جهة.
  • مستخدم واحد فقط ولا صلاحيات. لبيعها لعملاء، كل عميل يحتاج نسخة وقاعدة بيانات مستقلة.
  • توثيق عقود الإيجار رسميًا يتم عبر منصة إيجار الحكومية؛ هذه الأداة للمتابعة الداخلية، وفيها حقل لحفظ رقم عقد إيجار لكل عقد للربط بينهما.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages