سجل التغييرات: اعرف مين غيّر إيه في المنيو وإمتى

مين لمس المنيو وإنت مش واقف جنبه

عندك فرعين ومش واقف في الكاونتر في أي منهم النهاردة. مدير غيّر سعر صنف وإنت في الفرع التاني، وبعد ساعة حد علّم طبق إنه خلص (sold out)، وقبل ما يخلص اليوم لاحظت إن قايمة الكوبونات مش زي ما فاكرها. تسأل في جروب الواتساب "حد غيّر حاجة في المنيو النهاردة؟" مش نظام يتعتمد عليه. صفحة سجل التغييرات على /admin/audit-log هي النظام، وبتفتح بالجملة دي بالظبط: "كل تغيير قمت به أنت أو المديرون، الأحدث أولاً."

كل سجل بيوريك إيه بالظبط

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

تضييق البحث لتغيير واحد بس

فوق الجدول فيه شريط فلترة: خانة للمستخدم (بريد أو معرف)، قايمة للإجراء، قايمة للنوع، وحقلين تاريخ "من" و"إلى"، وزرار مسح يرجّع كل حاجة زي ما كانت. اختار بريد مدير معيّن مع فترة تاريخ محددة والجدول بيضيق على يومه بس. القوايم وحقول التاريخ بتفلتر أول ما تغيّرها، خانة المستخدم بس هي اللي بتستنى جزء من ثانية بعد ما توقف عن الكتابة، عشان مش كل حرف بتكتبه في إيميل يبعت طلب لوحده للخادم.

فتح تفاصيل التغيير نفسه

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

إيه اللي أبدًا مش هيوصل للسجل

قبل ما أي سجل يتكتب، كل حقل فيه بيتفحص باسمه. أي حاجة اسمها يوحي إنها رقم تليفون ضيف أو واتساب أو إيميل أو اسم أو عنوان بتتحول لكلمة [redacted]. أي حاجة اسمها يوحي إنها كلمة سر أو مفتاح API أو رقم كارت أو CVV أو IBAN أو توكن جلسة بتاخد نفس المعاملة. الفحص ده بيحصل على اسم الحقل نفسه، مش على القيمة اللي جواه، فبيمسك الحقل بنفس الطريقة كل مرة أيًا كان اللي اتكتب فيه.

روابط الدعوة ليها حماية لوحدها: الرابط نفسه مفتاح دخول شغال، أي حد ماسكه يقدر يستخدم الدعوة ويبقى عضو، فالسجل مش بيخزنه خالص. بيخزن بصمة (hash) في اتجاه واحد بدل منه، كفاية إنها تربط بين سجل الدعوة وسجل إلغائها بعدين، ومفيش فايدة منها لحد حاول يطلع الرابط الحقيقي منها. ولو تغيير واحد نتج عنه فرق كبير جدًا في الحجم، زي استيراد قالب كامل مثلًا، السجل بيخزن رقم الحجم بس بدل المحتوى كله، عشان السجل نفسه ما يكبرش من غير حد معقول.

مش هيوقفك عن شغلك

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

للمالك بس، ومطبّق مرتين

لو مدير حاول يفتح /admin/audit-log بيترجّع على طول لصفحة الداشبورد الرئيسية، بس الفحص ده على مستوى الصفحة نفسها، مش الحماية الحقيقية. الـ API اللي وراها بيتحقق من صلاحية اللي طالب البيانات في كل مرة، وبيرفض أي حد دوره مش "مالك" بشكل مباشر، حتى لو حاول يوصل للرابط بنفسه. الفرق ده مهم بالظبط للسبب اللي السجل موجود علشانه: لو المدير يقدر يقرا (أو الأسوأ، يتأكد إن سجل معيّن عن تعديله هو مش موجود أصلًا) هيبقى السجل موثوق بقد الشخص اللي المفروض بيراقبه بس. لمزيد عن الفرق بين صلاحيات المالك وصلاحيات المدير اليومية، شوف مين يقدر يعدّل إيه.

السجلات دي جاية منين فعلاً

مش سجل لميزة واحدة بس، هو بيغطي معظم لوحة التحكم: أصناف المنيو والأقسام، مجموعات الإضافات، الكوبونات، إنشاء فرع جديد ونسخ المنيو بينه وبين فرع تاني، دعوات الفريق وإلغاء صلاحياتهم، تغيير النطاق المخصص، إعدادات بوابة الدفع، إعدادات كود QR، تعديلات الثيم وشريط العروض، وبيانات المطعم. نشر وإلغاء نشر ونسخ واستيراد القوالب في منشئ القوالب بتظهر هنا كمان، بس ده سجل مختلف تمامًا عن نسخ التصميم (Snapshots) جوه المنشئ نفسه، اللي بتتبع تجارب الألوان والخطوط، مش مين نشر إيه وإمتى. لو اللي إنت دوّر عليه هو التراجع عن تعديل تصميم بالذات، ده موضوع نسخ تصميم المنيو (Version History)، مش الصفحة دي.

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