BookingHash
قرارات التوفر والحجوزات المؤقتة والحجوزات وأحداث دورة الحياة، كلٌّ منها يُسجَّل حدثاً في سلسلة تجزئة SHA-256 لكل حجز يمكن لأنظمتك التحقق منها عند الطلب.
دورة الحياة آلة حالات. كل واقعة تكتب حدث صندوق صادر في معاملة قاعدة البيانات نفسها، فلا يمكن للسجل وتاريخه أن يفترقا.
يطلب العميل سعة: غرفة، أو طاولة، أو موعداً، أو قطعة معدّات.
تقرّر وصفة نقية تعمل في الذاكرة. ليست حالة مخزَّنة؛ لا يُكتب شيء حتى يوضَع حجز مؤقت.
حجز مؤقت نشط يحفظ السعة لمدة محدودة.
يتحول الحجز المؤقت إلى حجز: مطلوب وبانتظار الموافقة، أو مؤكَّد.
بدء، إكمال، إلغاء، عدم حضور، تعديل. كلٌّ منها حدث في السلسلة.
كل حدث صف في سلسلة تجزئة SHA-256 لكل كيان: تغطي التجزئة المستأجر، وتجزئة الحدث السابق، والمعرّف، والكيان، والتسلسل، والنوع، والوقت، والحمولة القياسية. الرأس هو GENESIS، والتسلسل بلا فجوات، والتجزئات المزوّرة تُرفض عند الإدراج، والتحديث أو الحذف محظور بمحفّزات قاعدة البيانات.
كل حدث يُجزَّأ مع التجزئة السابقة (SHA-256). غيّر حدثاً واحداً، وسيفشل كل رابط لاحق في التحقق.
اختياري: يمكن كتابة خلاصة يومية لكل مستأجر إلى تخزين بقفل الكائنات في وضع الامتثال (إرساء بكتابة واحدة)، ويُفعَّل لكل مستأجر.
يعيد GET /v1/bookings/{id}/history اليوميات مع chainValid. تمشي قاعدة البيانات على السلسلة وتعيد حساب كل تجزئة؛ وأي حدث سابق مُعدَّل ينتج CHAIN_BROKEN عند ذلك الصف.
أرسل Idempotency-Key مع كل كتابة. الطلب المُعاد يعيد النتيجة الأصلية بدلاً من إنشاء نسخة مكرّرة.
مفاتيح البيئة التجريبية تبدأ بـ bh_test_، والمفاتيح الحية بـ bh_live_. المفتاح هو عنوان المستأجر؛ والمفتاح المجهول يتلقى استجابة 401 موحّدة.
خلاصة يومية لكل مستأجر ويوم، مسلسلة يوماً بيوم، يمكن كتابتها إلى تخزين بقفل الكائنات في وضع الامتثال. يُفعَّل الإرساء لكل مستأجر، وليس للتحقق من الخزنة نقطة HTTP عامة.
أي عملية تحجز سعة مؤقتاً ثم تؤكدها: غرف وليالٍ، طاولات وجلسات، مواعيد، تأجير، معدّات. يسجّل BookingHash القرار واليوميات؛ ومنتجك يملك التجربة.
سجّل في البوابة، وأنشئ مؤسسة، وافتح بيئة تجريبية. وعندما تحتاج إلى الإنتاج، انضم إلى قائمة الانتظار.
البيئات التجريبية تعمل على بيئة التهيئة (staging) ببيانات اختبار. الوصول إلى الإنتاج يتم عبر قائمة الانتظار.