نظام متكامل لإدارة الأعمال وحجز الخدمات (SaaS Marketplace)
روزال هي منصة ويب تقدمية (PWA) تعمل كسوق متعدد التجار (Multi-Tenant Marketplace) يربط بين مقدمي الخدمات والزبائن في الجزائر.
توفر المنصة واجهتين: تطبيق للزبائن لحجز المواعيد، ولوحة تحكم شاملة لأصحاب الأعمال لإدارة الحجوزات، العملاء، والمدفوعات.
تعاني الشركات الخدمية الصغيرة والمتوسطة في الجزائر من غياب أدوات رقمية محلية وبأسعار معقولة لتنظيم أعمالها. يعتمد الغالبية على الورق والقلم، مما يؤدي إلى:
بناء منصة مركزية قوية تعتمد على أحدث تقنيات الويب، توفر حلاً شاملاً:
تم اختيار التقنيات لضمان السرعة، الأمان، وقابلية التوسع (Scalability):
| المجال | التقنيات المستخدمة |
|---|---|
| Frontend | React 18, TypeScript, Tailwind CSS, Shadcn/ui |
| State Management | TanStack Query (React Query), Context API |
| Backend & DB | Supabase (PostgreSQL), Edge Functions |
| Security | Row Level Security (RLS), Supabase Auth |
| Maps | Leaflet, OpenStreetMap (بديل مجاني لـ Google Maps) |
| PWA | Vite PWA Plugin (Offline Support) |
واحدة من أعقد المشكلات كانت حساب الوقت المتاح بناءً على خدمات متعددة بمدد زمنية مختلفة. الخوارزمية تحسب "وقت الخدمة + وقت التنظيف" وتقوم بإنشاء Slots ديناميكية مع منع التضارب في الوقت الفعلي.
بما أن النظام "Multi-Tenant"، كان الأمان أولوية قصوى. استخدمت PostgreSQL Row Level Security (RLS) لضمان أن كل صاحب عمل يرى بياناته فقط، مع عزل البيانات تماماً على مستوى قاعدة البيانات.
نظام مالي مخصص للسوق الجزائري يدعم تسجيل المدفوعات النقدية (Cash) وإدارة طرق الدفع المحلية (CCP, Baridimob) مع توليد إيصالات PDF تلقائياً باستخدام مكتبة jsPDF.
تطبيق ويب تقدمي (PWA) يعمل كبرنامج أصلي على الهاتف مع Optimistic Updates باستخدام React Query وتقسيم الكود (Code Splitting) لتقليل حجم التحميل الأولي.
مقتطف يوضح كيفية التعامل مع تعارض المواعيد (Conflict Detection) في قاعدة البيانات:
-- وظيفة SQL للتحقق من توفر الوقت قبل الحجز
CREATE OR REPLACE FUNCTION check_slot_availability(
business_id uuid,
check_date date,
check_time time,
duration_minutes integer
)
RETURNS boolean AS $$
DECLARE
conflict_count integer;
BEGIN
-- التحقق من وجود أي حجز مؤكد يتقاطع مع الوقت المطلوب
SELECT COUNT(*) INTO conflict_count
FROM pro_bookings
WHERE pro_business_id = business_id
AND booking_date = check_date
AND status = 'confirmed'
AND (
(booking_time <= check_time
AND booking_time + (duration_minutes || ' minutes')::interval > check_time)
);
RETURN conflict_count = 0;
END;
$$ LANGUAGE plpgsql;