رحلة

رحلة هي منصة متكاملة لحجز وإدارة الرحلات السياحية، صُممت خصيصاً لوكالات السفر وعملائها. تتيح المنصة للوكالات استخدام لوحة تحكم عبر الويب لإدارة الرحلات والحجوزات والعملاء والموظفين والشؤون المالية، بينما يستخدم العملاء تطبيق جوال مخصص لاكتشاف الرحلات والمقارنة بينها وحجزها. تم بناء المنصة كـ Monorepo حديث باستعمال TypeScript مع التركيز الشديد على أمان الأنواع (Type safety)، الأمان، سهولة الاستخدام، والفصل الواضح بين المسؤوليات عبر أجزاء النظام المختلفة.

المشكلة

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

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

الأهداف والغايات

تمثل الهدف الرئيسي في إنشاء منصة متكاملة لإدارة الرحلات تلبي الاحتياجات التشغيلية لوكالات السفر، وتضمن في الوقت ذاته تجربة حجز ممتازة للعملاء.

• توفير نظام مركزي للوكالات لإدارة الرحلات، الحجوزات، العملاء، الموظفين، والتقارير المالية.
• توفير تجربة جوال سلسة للعملاء لاستكشاف الرحلات وحجزها.
• دمج معالجة المدفوعات للعمليات المختلفة، مثل الحجز، الاسترداد، والسحب الآلي عبر Paymob.
• حماية البيانات الحساسة مثل أرقام الهوية الوطنية باستخدام التشفير التراكمي الشامل (End-to-End Encryption) المعتمد على كلمة مرور الجذر.
• الحفاظ على سلامة أمان الأنواع (Type safety) والفصل المنطقي بين طبقات الواجهة الأمامية، الخلفية، نطاق العمل (Domain)، وقاعدة البيانات.
• جعل النظام سهلاً ومتاحاً للمستخدمين ذوي الخبرة التقنية المحدودة عبر وثائق ومستندات توضيحية ثنائية اللغة.

مراحل التطوير

تم تطوير المشروع كـ Monorepo متعدد الأجزاء باستخدام TypeScript، مع تقسيم النظام إلى تطبيقات وحزم نطاقات (Domain packages) منفصلة. أتاح هذا الهيكل تنظيم لوحة تحكم الوكالة، تطبيق الجوال للعملاء، واجهات برمجة التطبيقات (APIs)، منطق الأعمال، وطبقة قاعدة البيانات بشكل مستقل مع مشاركة القواعد والأنواع البرمجية والأدوات المساعدة.

يعتمد المعمار البرمجي على التفكير القائم على النطاق (Domain-Driven Design) مع حدود واضحة بين نطاقات الإدارة والعملاء والنواة الأساسية للنظام. تستخدم طبقة الـ API عقد oRPC وHono على بيئة Cloudflare Workers، مما يسمح للواجهتين الأمامية والخلفية بمشاركة التوصيفات وقواعد التحقق عبر كامل التطبيق.

تم تطوير جانب الوكالة كتطبيق ويب باستعمال React يتضمن ميزات إدارة الرحلات، الحجوزات، العملاء، الموظفين، التحليلات، والتقارير المالية. بالتوازي مع ذلك، تم تطوير تطبيق React Native مخصص للعملاء باستعمال Expo يوفر ميزات اكتشاف الرحلات، تصفيتها، الحجز، تسجيل الدخول، والتدفق المالي.

تم دمج معالجة المدفوعات مع Paymob لدعم الحجوزات، عمليات الاسترداد، والسحب الآلي. كما تمت حماية بيانات الهوية الوطنية الحساسة باستخدام التشفير الشامل المعتمد على كلمة مرور يتم التحكم فيها من قبل مدير النظام.

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

المعمارية البرمجية (Architecture)

تم تنظيم مشروع رحلة كـ Monorepo مع فصل واضح بين التطبيقات، واجهات الـ API، منطق النطاق، وطبقة حفظ البيانات. تحتوي القاعدة البرمجية على تسع حزم عمل، تغطي لوحة تحكم الويب للوكالة، تطبيق الجوال للعملاء، طبقات الـ API، طبقات النطاق، والوصول لقواعد البيانات.

تعتمد المعمارية على منهجية العقود الأولية للـ APIs (Contract-first APIs)، التنظيم القائم على الميزات، أمان الأنواع الشامل من البداية للنهاية، واستخدام العناصر الأساسية المشتركة. توفر بيئة Cloudflare Workers مشغل الواجهة الخلفية، بينما يُستخدم PostgreSQL مع Prisma لتخزين البيانات العلاقاتية، وCloudflare R2 لتخزين الملفات، وExpo EAS لنشر وتحديث تطبيق الجوال.

النتائج

تطور مشروع رحلة ليصبح منصة إدارة سفر متكاملة تغطي المسار التشغيلي للوكالة وتجربة الحجز للعميل على حد سواء. يدعم النظام الحالي إدارة الرحلات، الحجوزات، المدفوعات، إدارة العملاء، التحكم في صلاحيات الموظفين، التحليلات، التقارير المالية، والتعامل الآمن مع البيانات الحساسة.

بالإضافة إلى البرمجية نفسها، يشتمل المشروع على دليل مستخدم ثنائي اللغة وعرض تقديمي احترافي مكون من ۲۰ شريحة يتضمن نماذج أولية ولقطات شاشة للمنصة، وقد تم إعداد هذه المواد لتسهيل عرض النظام، فهمه، واعتماده في العمل.

لقطات الشاشة

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

• إدارة الرحلات: يمكن للوكالات إنشاء، تعديل، جدولة، وإدارة الرحلات مع ميزات التحكم الكاملة (CRUD).
• إدارة الحجوزات: متابعة وإدارة الحجوزات ومراقبة حالتها عبر جميع مراحل الدورة التشغيلية.
• إدارة العملاء: الاحتفاظ بسجلات تفصيلية للعملاء وإدارة بياناتهم من مكان واحد.
• إدارة الموظفين والتحكم بالصلاحيات (RBAC): تمكين الوكالات من إدارة الموظفين والتحكم في وصولهم لأجزاء النظام بناءً على أدوارهم.
• التسعير الجماعي وأكواد الخصم: أدوات تسعير مرنة تدعم الخصومات التشجيعية والتسعير المخصص المعتمد على المجموعات.
• التقارير المالية: متابعة النشاط المالي للوكالة من خلال تحليلات وتقارير تفصيلية.
• الربط مع Paymob: تدعم المنصة معالجة المدفوعات، عمليات الاسترداد، والسحب الآلي عبر Paymob.
• تطبيق الجوال للعملاء: تصفح وتصفية الرحلات، إنشاء الحجوزات، إدارة الملف الشخصي، وإتمام المدفوعات عبر تطبيق React Native أصلي.
• الحجز الآلي: يربط مسار حجز العميل بين الحجز ومعالجة الدفع، مما يقلل من الجهد اليدوي المطلوب من الوكالة.
• التشفير الشامل (End-to-End Encryption): حماية بيانات الهوية الوطنية الحساسة باستخدام نظام تشفير يعتمد على كلمة مرور الجذر.
• سجلات التدقيق (Audit Logging): تتبع الإجراءات والعمليات الهامة لزيادة الشفافية والمساءلة التشغيلية.
• مصادقة Google OAuth: إمكانية تسجيل الدخول عبر حساب Google مع الحفاظ على مسارات وصول منفصلة لأجزاء النظام المختلفة.
• توثيق ثنائي اللغة: دليل مستخدم تفصيلي يقع في ۷۰ صفحة باللغتين العربية والإنجليزية يوضح كافة ميزات الواجهة والنظام.

الخلاصة والدروس المستفادة

أتاح بناء مشروع رحلة اكتساب خبرة عميقة في تصميم وإدارة Monorepo واسع النطاق باستخدام TypeScript عبر الويب، الجوال، الواجهة الخلفية، طبقة النطاق، وقواعد البيانات. تطلب المشروع ما هو أكثر من مجرد تطبيق ميزات منفردة، حيث أُولِيَ اهتمام خاص للمعمارية البرمجية، عقود الـ APIs، الأمان، المدفوعات، التوثيق، والتفاعل بين عدة تطبيقات في وقت واحد.

كما أكد المشروع على أهمية تصميم البرمجيات حول احتياجات مستخدميها؛ فقد صُمم الدليل ثنائي اللغة، وتجربة العميل الميسرة، والفصل بين تطبيقات الوكالة والعميل كلها لجعل النظام أسهل في الفهم والتشغيل على أرض الواقع.