02 / 05منصة حجز مواعيد للمنشآت الخدمية2026
وعدة
يحجز العميل من جواله بلا حساب، ومساعد الحضور يمنع الموعد من أن يبقى فارغاً.
- Laravel 12
- MySQL
- Vue 3.5
- Vite 6
- Tailwind 4
- Pinia
- PHPUnit
- Vitest
- Playwright
- PHP 8.2
- Sanctum
- REST API
- Chart.js

باختصار
01لمن بُني؟
- صاحب المنشأة: عيادة أو صالون أو مركز تدريب أو خدمة منزلية أو مطعم أو ملعب.
- فريق الاستقبال: ينقل المواعيد بالسحب، ويضيف الحجوزات، ويردّ على ما لم يفهمه مساعد الحضور.
- العميل: يحجز برقم جواله دون حساب، ويعدّل موعده أو يلغيه لاحقاً.
قبل المشروع
الخسارة الحقيقية لعيادة أو صالون ليست قلّة الحجوزات، بل الموعد الذي يُحجز ثم يبقى فارغاً لأن العميل لم يأتِ. والعميل لا يريد إنشاء حساب ليحجز موعداً واحداً، ويوم العمل في المنطقة له قواعده: دوام بعد منتصف الليل، وساعات رمضان، وأوقات الصلاة.
- وقت مدفوع يضيعالغياب يترك الموعد فارغاً بلا تعويض.
- حجزان للوقت نفسهحين يؤكّد شخصان الموعد نفسه في اللحظة نفسها.
- أدوات لا تعرف المنطقةلا دوام يعبر منتصف الليل، ولا رمضان، ولا أوقات الصلاة.
المنتج
المنتج كما يستعمله صاحبه
مرِّر لتمشي مع المستخدم خطوة خطوة، وكل خطوة على الشاشة التي تحدث فيها فعلاً.
صفحة المنشأة
تختار المنشأة قطاعها من ستة قطاعات جاهزة، فتُبنى صفحة الحجز الخاصة بها أمامها.
/register

الحجز من الجوال
يختار العميل الخدمة والمختص واليوم والوقت، ويؤكّد برقم جواله دون إنشاء حساب.
/b/alrayhan

اليوم على لوحة واحدة
عمود لكل مختص، وخط يشير إلى الآن، وقائمة بما يحتاج تصرّفاً، ونقل الموعد بالسحب.
/app

مساعد الحضور
يذكّر العميل فيردّ ١ للتأكيد أو ٢ للإلغاء أو ٣ للتأجيل، والموعد الملغى يُعرض على قائمة الانتظار.
/app/guard

الحجوزات والعملاء
جداول تُفرز وتُصفّى، وسجلّ كل عميل ونسبة غيابه.
/app/bookings

الشهر بالأرقام
الإشغال والإيراد ونسبة الغياب والإلغاء، والطلب موزّعاً على ساعات اليوم.
/app/analytics

كيف حُلّت
كيف بُني ليصمد
القرارات التي تجعل الوعود السابقة صحيحة، لا مجرّد شكل على الشاشة.
القفل حيث يهمّ
الـ API يقفل صف المورد ويفحص التداخل داخل المعاملة التي تكتب الحجز، فالثاني يخسر دائماً. والتداخل بفترات نصف مفتوحة: موعد ينتهي ١٠:٠٠ وآخر يبدأ ١٠:٠٠ لا يتعارضان. واختبار بجلستين متزامنتين حقيقيتين يثبت ذلك بدل تعليق في الكود.
ساعة المنشأة لا ساعة الزائر
المنشأة تحمل منطقتها الزمنية، وصفحات العميل تضع تواريخها على تلك الساعة، فالكود نفسه يحسب ويعرض أوقات المنشأة أينما كان الزائر، والأوقات تصل الخادم بصيغة UTC صريحة.
إثبات لا تخمين
رمز التحقق من الجوال كان يُصنع ويُفحص في المتصفح، فصار يصدره الخادم ويفحصه بحدّ للمحاولات. وإدارة الحجز تحتاج رابطاً سرّياً عشوائياً يُخزَّن مجزّأً، أو الرقم كاملاً مع إثباته، والإلغاء والتأجيل يطلبان الإثبات نفسه.
توضيحات تستحق الذكر
مساعد يصمد
قبل أن يحرّر موعداً لم يُرَدّ عليه يعيد قراءة الصف تحت قفل، ويتراجع إن أكّده العميل في الأثناء. وخطأ منشأة واحدة لا يوقف الجولة عن البقية، والنموذج اللغوي له مهلة ثماني ثوانٍ ثم يرجع لقوائم الكلمات.
السعر يحدده الخادم
سعر المدة وسعر الذروة المسائي يحسبهما الخادم، وأي سعر يرسله المتصفح يُتجاهل. والقاعدة مكتوبة في المتصفح والخادم معاً وتُختبر بالحالات نفسها، فالعرض التجريبي والخادم الحقيقي يتفقان.
مراجعة كاملة، وكل نتيجة باختبار
مُرِّر المشروع كله بمراجعة، وكل مشكلة حرجة أو عالية أُثبتت أولاً باختبار يفشل ثم أُصلحت حتى نجح، وبقيت الاختبارات فيه. اليوم ٢١٧ اختبار PHPUnit على MySQL حقيقية، و١٩٧ اختبار Vitest، وجولة Playwright على كل شاشة تفشل عند أي خطأ في الكونسول.
النتيجة
ما الذي سُلِّم
- 12
- شاشة في المنتج
- 16
- لقطة حقيقية
- 414
- اختبار آلي
- 2
- لغتان كاملتان
- تجربة حيّة بلا تسجيل، وزرّ يدخل لوحة التحكم بحساب تجريبي.
- ٢١٧ اختبار PHPUnit على قاعدة MySQL حقيقية، و١٩٧ اختبار Vitest، وجولة Playwright على كل شاشة.
- ستة قطاعات جاهزة، وحجب أوقات الصلاة لعشرين مدينة، وساعات رمضان بتقويم أم القرى.
- باقات مجانية وأساسية واحترافية مع تجربة ١٤ يوماً.
- PASSمشغّلان يؤكّدان الموعد نفسه في الثانية نفسها: الثاني يخسرbooking/tests/ConcurrentBookingTest.php
و413 اختباراً آخر في المستودع
كل الشاشات
كل شاشة، كما هي
لقطات حقيقية من المشروع وهو يعمل — لا صور تعبيرية.
كل صفحات المشروع
لقطات حقيقية من المشروع وهو يعمل — لا صور تعبيرية. · 16 شاشة





