Waqar Ul Wahab
كل المشاريع/COMFORTABLE APARTMENTS — PROPERTY MANAGEMENT SAAS

نظرة عامة

يدير Comfortable Apartments أعمال الشقق الفندقية للإقامة القصيرة من البداية إلى النهاية. واجهة برمجية واحدة مبنيّة على Django 5 + DRF — 8 تطبيقات و11 نموذج بيانات و39 نقطة وصول — هي مصدر الحقيقة الوحيد، تتشارك فيها ثلاثة تطبيقات عميلة: لوحة تحكّم Next.js 14 للمكتب، وتطبيق React Native من عشرين شاشة للعمل الميداني، ونسخة Android مبنيّة بـCapacitor تُقدّم لوحة التحكّم كتطبيق قابل للتثبيت.

يغطّي النظام دورة التشغيل الكاملة: كتالوج غرف بإشغال وإيرادات لحظية، ودليل نزلاء، ودورة حياة الحجز (تسجيل الدخول والخروج، والمصادر، والحالة)، والفوترة بإجماليات تُحتسب تلقائيًا ومعاملة سريعة بنداء واحد للوافدين دون حجز مسبق، وفواتير PDF بهوية بصرية مخصّصة تُسلَّم عبر WhatsApp أو البريد الإلكتروني، ومصروفات مصنّفة، ومجموعة تقارير — لوحة مؤشرات، والإيرادات، والأرباح والخسائر، والإشغال ومتوسط السعر اليومي ADR، وتدقيق لكل غرفة، وتصدير Excel/CSV متعدّد الأوراق. تُسجَّل كل عملية في سجلّ تدقيق يُطلق كذلك إشعارات FCM الفورية، والوصول محكوم بنموذج RBAC من ثلاثة أدوار، ويُنشر النظام الخلفي بالكامل عبر مسار GitLab CI/CD قائم على حاويات Docker خلف Nginx مع TLS مُدار. وهو مضبوط على سوقه — التسعير بالروبية، وهوية النزيل بـCNIC، وEasyPaisa / JazzCash ضمن طرق الدفع المسجّلة.

جولة توضيحية

جولة قصيرة في Comfortable Apartments — Property Management SaaS.

01 / 0160-Second Showcase

التحدي

كان المشغّل يدير أعماله عبر الإيصالات والدفاتر ومحادثات الهاتف — بلا مصدر حقيقة واحد يبيّن من النزيل، وما المستحق، وهل كان الشهر مربحًا. كان المطلوب استبدال ذلك بـنظام واحد يستخدمه المالك وشريك وموظّفو الاستقبال جميعًا — من حاسوب في المكتب الخلفي أو من هاتف في الميدان — دون أن يتجاوز أحدهم صلاحيات الآخر.

وعنى ذلك واجهة برمجية واحدة تُغذّي لوحة تحكّم ويب وتطبيق جوال من البيانات والمصادقة نفسها؛ ونواة للحجز والفوترة يمكن تسجيل وافد دون حجز مسبق من خلالها بنقرة واحدة؛ وتقارير مالية حقيقية لا مجرّد دفتر قيود؛ وفواتير يستلمها النزيل على WhatsApp؛ وقصة تشغيلية تكفي فيها دفعة git واحدة لإعادة بناء النظام الخلفي القائم على الحاويات بالكامل وإعادة نشره.

تصميم النظام

كيف يعمل

01/04
01

نقرة واحدة تسجّل وافدًا دون حجز مسبق

كيف يتحوّل نزيل عند مكتب الاستقبال إلى حجز وفاتورة مدفوعة وغرفة مشغولة في نداء ذرّي واحد.

  1. 1يفتح الموظّف المعاملة السريعة على لوحة التحكّم أو تطبيق الجوال ويُدخل بيانات النزيل والمبلغ
  2. 2تُنشئ الواجهة البرمجية النزيل أو تعيد استخدامه، وتتحقّق من أن الغرفة ليست مشغولة في تلك التواريخ، ثم تفتح حجزًا
  3. 3يُنشأ سجلّ فوترة ويُعلَّم كمدفوع، مع احتساب الإجماليات على الخادم
  4. 4تُحوَّل الغرفة إلى مشغولة ويُعتمد التغيير كاملًا بصورة ذرّية — نداء واحد بلا حالات ناقصة
  5. 5تُكتب العملية في سجلّ التدقيق، الذي يُطلق إشعار FCM فوريًا إلى بقية الفريق
02

فاتورة تصل إلى النزيل على WhatsApp

كيف تتحوّل الفاتورة إلى ملف PDF بهوية بصرية مخصّصة يستلمه النزيل دون طابعة على الإطلاق.

  1. 1يُصدر الموظّف فاتورة من سجلّ الفوترة؛ ويُولّد الخادم ملف PDF بهوية بصرية مخصّصة مع الشعار المضمّن
  2. 2يُخزَّن ملف PDF في تخزين الكائنات السحابي ويُربط بالفاتورة
  3. 3يضغط الموظّف على الإرسال عبر WhatsApp؛ فتُعيد الواجهة البرمجية رابط wa.me مباشرًا يحمل تفاصيل الفاتورة
  4. 4يفتح النزيل الرسالة ويُنزّل ملف PDF عبر رابط موثَّق برمز يعمل في متصفّح عادي
03

معرفة ما إذا كان الشهر مربحًا

كيف تتحوّل الإيصالات المتناثرة إلى بيان أرباح وخسائر حقيقي يثق به المالك.

  1. 1يُسجَّل كل حجز ودفعة ومصروف مقابل غرفة وفئة لحظة حدوثه
  2. 2تُجمّع نقاط وصول التقارير الإيرادات والمصروفات على الخادم في تقارير الإيرادات والأرباح والخسائر والإشغال وADR
  3. 3تعرض لوحة التحكّم الأرقام في بطاقات مؤشرات أداء ورسوم بيانية؛ ويعرض تطبيق الجوال الأرقام نفسها في الميدان
  4. 4يُصدّر المالك كشفًا بصيغة Excel متعدّد الأوراق أو CSV عبر رابط موثَّق برمز ليُسلّمه إلى محاسبه
04

دفعة واحدة تنشر النظام الخلفي بالكامل

كيف تُعيد دفعة git واحدة بناء الواجهة البرمجية القائمة على الحاويات ونشرها دون أي خطوة يدوية.

  1. 1تُطلق أي دفعة إلى فرع main مسار GitLab CI/CD؛ وتُنفّذ مرحلة الاختبار فحوص النشر واختبارًا سريعًا للتأكّد من سلامة الترجمة البرمجية
  2. 2تبني مرحلة البناء صورة Docker متعدّدة المراحل موسومة برقم الـcommit وبالوسم latest
  3. 3تُشغّل مرحلة النشر الحاوية على الخادم، وتُنفّذ الترحيلات وتجمع الملفات الثابتة
  4. 4يخدم Nginx خلف TLS مُدار مع فحوص سلامة موصولة بالحاوية — والإصدار الجديد يصبح مباشرًا في مسار واحد

أبرز الميزات

  • واجهة REST واحدة وثلاثة تطبيقات عميلة — لوحة تحكّم Next.js، وتطبيق React Native (20 شاشة)، ونسخة Android مبنيّة بـCapacitor، تتشارك جميعها نموذج بيانات واحدًا ومصادقة JWT واحدة
  • كتالوج غرف بإشغال وإيرادات لحظية لكل غرفة تُحتسب داخل قاعدة البيانات، إضافة إلى تقويم توافر بنطاق تواريخ
  • معاملة سريعة بنقرة واحدة — نداء ذرّي واحد يسجّل وافدًا دون حجز مسبق: النزيل، والحجز، وفاتورة مدفوعة، وتحويل الغرفة إلى مشغولة، مع حماية من تداخل الحجوزات
  • دورة حياة حجز كاملة — المخطّط مقابل الفعلي في تسجيل الدخول والخروج، وعدد النزلاء، ومصدر الحجز وحالته — مع قيد في قاعدة البيانات يضمن أن يلي تسجيلُ الخروج تسجيلَ الدخول
  • الجانب المالي عنصر أساسي — إجماليات فوترة وحالة سداد تُحتسب تلقائيًا، وفواتير PDF بهوية بصرية مخصّصة تُولَّد على الخادم وتُسلَّم عبر WhatsApp أو البريد الإلكتروني
  • مجموعة تقارير مالية — لوحة مؤشرات، والإيرادات، والأرباح والخسائر، والإشغال وADR، وتدقيق لكل غرفة، وتصدير Excel/CSV متعدّد الأوراق
  • نموذج RBAC من ثلاثة أدوار (المالك · الشريك · الموظّف)، ومصادقة JWT برموز تحديث متجدّدة، وتحديد لمعدّل الطلبات على مستوى كل نقطة وصول، وتصفية وبحث في كل قائمة
  • سجلّ تدقيق يُسجّل كل عملية ويُطلق إشعارات FCM الفورية إلى الفريق، مع تسجيل رموز الأجهزة وإزالة الرموز القديمة
  • ملاءمة للسوق المحلي — التسعير بالروبية، وهوية النزيل بـCNIC، وEasyPaisa / JazzCash / Booking.com ضمن سبع طرق دفع مسجّلة
  • مسار GitLab CI/CD قائم على حاويات Docker (اختبار · بناء · نشر) خلف Nginx مع TLS مُدار وتخزين كائنات قابل للاستبدال على S3 / Cloudinary

Outcomes

  • استبدال الإيصالات والدفاتر ومحادثات الهاتف بمصدر حقيقة واحد — الغرف والنزلاء والحجوزات والفوترة والفواتير والمصروفات والتقارير في نظام واحد
  • تسليم المنتج كاملًا من البداية إلى النهاية بجهد مهندس واحد: واجهة برمجية واحدة تُشغّل لوحة تحكّم ويب وتطبيق جوال أصليًا ونسخة Android مبنيّة بـCapacitor
  • جعل الجانب المالي واضحًا — فوترة تُحتسب تلقائيًا، وفواتير PDF تُسلَّم عبر WhatsApp، وتقارير حقيقية للأرباح والخسائر والإشغال وADR مع تصدير Excel/CSV
  • إبقاء الفريق منسّقًا وآمنًا — نموذج RBAC من ثلاثة أدوار، وأثر تدقيق على كل تغيير، وإشعارات FCM الفورية من سجلّ النشاط
  • اختزال العمليات التشغيلية في دفعة git — مسار GitLab CI/CD قائم على حاويات Docker يبني ويشحن ويُرحّل ويخدم خلف Nginx مع TLS مُدار

أعمال أخرى

CureAxis preview
منصّة رعاية صحية

CureAxis

منصّة رعاية صحية متعدّدة المستأجرين بمعايير HIPAA

عرض المشروع
Riquid Platform preview
منظومة تجارة إلكترونية

Riquid Platform

منظومة متعدّدة الوحدات للتجارة بين الشركات والمتجر الإلكتروني والخدمات اللوجستية

عرض المشروع