VCC لمنصة أتمتة للفنادق MERN Stack

1️⃣ وصف المشروع

نبحث عن مطور Senior Full Stack (MERN) لتطوير منصة أتمتة تعمل كطبقة وسيطة بين حساب توزيع أول وحساب توزيع ثانٍ متصل بنظام إدارة الفندق (PMS).

المنصة تقوم بما يلي:

استقبال الحجوزات من الحساب الأول (Webhook)

معالجة الحجز داخل Automation Engine:

خصم عمولة المنصة

تعديل السعر النهائي

إضافة رسوم إضافية إن وجدت

إصدار بطاقة دفع افتراضية (Virtual Credit Card)

إعادة إرسال الحجز المعدل إلى الحساب الثاني ليصل إلى الفندق النهائي

تدعم المنصة قنوات متعددة مثل:

Airbnb

Vrbo

Hotelbeds

وأي قنوات أخرى متصلة عبر نظام إدارة القنوات.

2️⃣ التدفق النهائي للنظام

Booking Source → Account A → Webhook → Automation Platform → Automation Engine → Virtual Card → Account B → PMS → الفندق

كل حجز يصل إلى المنصة عبر Webhook من الحساب الأول، تتم معالجته، ثم إرساله للحساب الثاني والفندق.

لا توجد حلقات تكرار أو تضارب لأنه الحساب الأول هو مصدر الحجز الوحيد.

3️⃣ Architecture Diagram (وصف بصري)

[Booking Source OTA]

│

▼

[Account A - Channel Manager]

│ Webhook

▼

[Automation Platform]

│

▼

[Automation Engine]

├─ Price Adjustment

├─ Commission Deduction

└─ Virtual Card Issuance

│

▼

[Account B - Channel Manager]

│ API

▼

[PMS / Hotel]

الخدمات Modules داخل المنصة:

Channel Data Sync Service

Listings Distribution Service

Booking Webhook Service

Automation Engine

Virtual Card Service

PMS Sync Service

4️⃣ Database Schema مبدئي (MongoDB)

Collections الرئيسية:

Collection Fields / Notes

Users userID, name, email, role

Properties propertyID, name, address, amenities

RoomTypes roomTypeID, propertyID, name, capacity

RatePlans ratePlanID, roomTypeID, price, currency

Listings listingID, propertyID, channel, status

Bookings bookingID, guestID, listingID, status, originalPrice, finalPrice, commission, VCCInfo, timestamps

Guests guestID, name, email, phone

VirtualCards cardID, bookingID, amount, currency, status

AutomationLogs logID, bookingID, action, timestamp, result

SystemLogs logID, module, message, level, timestamp

5️⃣ API Flow & Endpoints

Webhook Endpoints:

POST /webhook/new-booking → استقبال حجز جديد

POST /webhook/modify-booking → تعديل حجز

POST /webhook/cancel-booking → إلغاء حجز

Internal API Endpoints:

GET /bookings → عرض الحجوزات

GET /listings → عرض القوائم

POST /virtual-cards → إصدار بطاقة جديدة

POST /automation/execute → تنفيذ Automation Engine على حجز محدد

6️⃣ Automation Rules Example

Rule Action

Commission Fee خصم 10% من السعر الأصلي للحجز

Cleaning Fee إضافة 20$ لكل حجز

Price Adjustment تعديل السعر حسب الموسم أو العرض الخاص

Guest Info Update تعديل بيانات الضيف لتوافق PMS

Virtual Card Issuance إنشاء بطاقة افتراضية لكل حجز

يمكن إضافة قواعد جديدة مستقبلاً من لوحة التحكم.

7️⃣ لوحة التحكم (Dashboard)

Listings: إدارة القوائم

Bookings: عرض وإدارة الحجوزات

Virtual Cards: عرض البطاقات الافتراضية

Logs: سجل العمليات

Errors: عرض الأخطاء

Synchronization Status: حالة المزامنة

Settings: إعدادات النظام

8️⃣ متطلبات النظام

Event-driven Webhook Processing

Idempotent Webhook Handling

Scalable Architecture

Full Logging & Error Handling

MongoDB Database

REST APIs & React.js Dashboard

9️⃣ الاختبارات المطلوبة

API Testing

Integration Testing

End-to-End Testing (E2E)

? شروط التسليم النهائي

نجاح التدفق الكامل للحجز من المصدر → الحساب الأول → Automation Engine → VCC → الحساب الثاني → PMS → الفندق

لا أخطاء في أي خطوة من العملية

? المخرجات المطلوبة

Source Code كامل

Database Schema

API Documentation

تعليمات تشغيل النظام

اختبار عملي End-to-End

? مدة التنفيذ

45 – 60 يوم

? الميزانية

قابلة للنقاش حسب خبرة المطور وجودة التنفيذ