الإعدادات
كل ما يضبطه العقار موجود في الإعدادات (رمز الترس في الشريط الجانبي). لكل جزء من Kamra صفحته الخاصة، وكل صفحة توضح من يحق له تغييرها. كل تغيير يُفحص مقابل حدوده ويُسجَّل في سجل النشاط مع القيمة القديمة والجديدة.

ابحث عن إعداد
اكتب في البحث في الإعدادات (أو اضغط /) واختر النتيجة. تُفتح الصفحة الصحيحة وتنتقل إلى الإعداد.

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

ترى فقط الصفحات التي يحق لدورك تغييرها. سطر غيّره تحت عنوان كل صفحة يعرض تلك الأدوار، ويستطيع مدير الفندق تغييرها كلها.
الصفحات
| الصفحة | ما فيها | الدليل |
|---|---|---|
| العقار | الاسم، والاسم القانوني، والشعار، والدولة (التي تحدد حزمة الضرائب والفوترة)، والعملة، والمنطقة الزمنية، والعنوان، والرقم الضريبي | إعداد الدولة |
| سياسات الإقامة | أوقات تسجيل الوصول والمغادرة، والحد الأدنى للإقامة، ومهلة الإلغاء المجاني، ورسوم الإلغاء وعدم الحضور، والعربون | الحجوزات |
| الخصوصية والبيانات | مدة الاحتفاظ ببيانات الضيوف ورسائلهم، وجهة الاتصال للخصوصية | |
| الاستقبال | الوصول، والحجوزات المؤقتة، وعدم الحضور، وعرض اليوم | مكتب الاستقبال |
| التدبير المنزلي | مواعيد المهام النهائية، وتجهيز الغرف، وأسعار الغسيل | التدبير المنزلي |
| العمليات | مواعيد طلبات الضيوف النهائية حسب الأولوية | العمليات |
| المأكولات والمشروبات | القبول التلقائي لأمر المطبخ، وإيصالات الإبطال، ومهلة حجز الطاولات، وطابعات المطبخ، وفحص سرعة POS | المأكولات والمشروبات |
| المآدب والمجموعات | هوامش عروض الأسعار، ومراحل الدفع، والمتابعات | المآدب |
| الإيرادات | إلى أي حد يمكن للفندق البيع فوق السعة، والتسعير حسب الطلب | الإيرادات |
| المالية | ضريبة الغرف، والرسوم، وضوابط أمين الصندوق (PIN، وحدود الاسترداد النقدي) | الفوترة |
| محرك الحجز | صفحة /book العامة: تشغيل أو إيقاف، حجز فوري أو طلب حجز، طريقة دفع الضيوف | محرك الحجز |
صفحات أجزاء Kamra التي يمكنك إيقافها (التدبير المنزلي، والعمليات، والمأكولات والمشروبات، والمآدب، والإيرادات، ومحرك الحجز…) فيها مفتاح الوحدة مفعلة في الأعلى. مدير الفندق وحده يستطيع تشغيل الوحدات وإيقافها. الوحدة الموقوفة تختفي من الشريط الجانبي للجميع، وتُخفى أدواتها عن وكلاء الذكاء الاصطناعي.
أضف موظفين وامنحهم الوصول
الإعدادات → الموظفون والصلاحيات تعرض كل من يستطيع تسجيل الدخول، مع أدوارهم والعقارات التي يصلون إليها.

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

لتغيير بيانات شخص لاحقا، اضغط إدارة في صفه. من هناك تستطيع تغيير الأدوار والعقارات، أو إعادة تعيين PIN أمين الصندوق، أو تعطيله. الموظفون المعطّلون لا يستطيعون تسجيل الدخول، ويبقى سجلهم محفوظا. لا تستطيع تغيير وصولك أنت، ولا يغيّر وصول مسؤول تقنية المعلومات إلا تقنية المعلومات.
ماذا يستطيع كل دور
الأدوار حزم ثابتة: كل شاشة، واستدعاء API، وأداة ذكاء اصطناعي تفحصها على الخادم. تُسند الأدوار من الإعدادات → الموظفون والصلاحيات.
| الدور | العمل اليومي |
|---|---|
| مدير الفندق | يدير العقار: كل التطبيقات، وكل الإعدادات، والموظفون والوصول |
| الاستقبال | الحجوزات، وتسجيل الوصول والمغادرة، والضيوف، والفواتير، وصندوق أمين الصندوق |
| مدير الإيرادات | الأسعار، والمواسم، وحدود الأسعار، والقنوات، ومحرك الحجز، ومبيعات المآدب |
| المالية | الفوترة، والدفاتر، والتدقيق الليلي، والتصدير، وضوابط الضرائب وأمين الصندوق |
| مدقق ليلي | التدقيق الليلي: الوصول، والمغادرة، وإغلاق الصناديق، وحزمة التدقيق |
| مدير الأغذية والمشروبات | المنافذ، والقائمة، والنُدُل والطاولات، وشاشة المطبخ، وتقارير وإعدادات الأغذية والمشروبات، والموافقة على إلغاءات نقطة البيع. بلا فواتير ولا صندوق ولا مالية |
| مشرف التدبير المنزلي | لوحة الغرف، والفحص، ومواعيد المهام، وأسعار الغسيل |
| التدبير المنزلي | مهامهم، وحالة الغرف، والمفقودات، وغالبا على تطبيق الهاتف |
تقنية المعلومات (مدير النظام) تدير أيضا مفاتيح المطورين وتضيف العقارات.
أوقف الوحدات
الإعدادات → الوحدات تعرض كل وحدة مع مفتاحها، لتوقف ما لا يشغّله هذا العقار (دار ضيافة بلا مطعم توقف المأكولات والمشروبات). تخرج تطبيقاتها من المشغّل والبحث وأدوات وكيل الذكاء الاصطناعي للجميع. الاستقبال والإدارة مفعّلان دائما. لا يُحذف شيء، وإعادة تشغيل الوحدة تعيدها كما كانت.

التكاملات
المدفوعات: البوابة المستخدمة لروابط الدفع (الدفعات المقدمة، والتأمينات، وتسوية الفاتورة). البوابات المتاحة تعتمد على حزمة الدولة. راجع الفوترة.

مساعد الذكاء الاصطناعي: استخدم مفتاح الذكاء الاصطناعي الخاص بك (أي خدمة متوافقة مع OpenAI) لـ وكيل كامرا في الواجهة. تُزال حقول اتصال الضيف وهويته قبل إرسال أي شيء إلى النموذج.

وصول الذكاء الاصطناعي عبر MCP (تحت الوصول): من يحق له ربط Claude أو ChatGPT أو عميل MCP آخر (بلا وصول، أو MCP Read، أو MCP Manage، لكل شخص)، وهل وصول الذكاء الاصطناعي مفعّل هنا، وحظر أدوات الكتابة، والأدوات المحظورة منفردة، والعملاء المتصلون مع قطع الاتصال، وعناوين دخول OAuth إضافية (لتقنية المعلومات فقط). راجع من يمكنه استخدام MCP.

الفوترة الإلكترونية ZATCA: تظهر للسعودية فقط. راجع إعداد الدولة.
اللغات
الإعدادات → اللغات تعرض كل لغة يأتي بها Kamra. أوقف ما لا يستخدمه هذا الموقع. بعدها يعرض تسجيل الدخول وتطبيق الموظفين وصفحة الحجز وتسجيل الوصول الذاتي اللغات التي بقيت مفعّلة فقط. تبقى الإنجليزية مفعّلة. لمدير الفندق فقط.
الاختيار للموقع كله وليس لعقار واحد. اللغة التي توقفها تُحفظ: المتصفح الذي كانت محددة فيه يعود إليها إذا فعّلتها من جديد. إلى ذلك الحين يستخدم تطبيق الموظفين الإنجليزية. يعود الضيوف إلى لغة الحجز للعقار إذا كانت ما زالت مفعّلة، وإلا إلى الإنجليزية. اللغة التي تُضاف في إصدار لاحق تبقى مفعّلة إلى أن توقفها.
المظهر
الإعدادات → المظهر تحدد السمة (فاتحة، أو داكنة، أو حسب النظام) واللغة لهذا المتصفح فقط. القائمة هي اللغات المفعّلة في الإعدادات → اللغات. اللغة التي تُقرأ من اليمين إلى اليسار، مثل العربية، تقلب التخطيط.

معلومات مفيدة
- الإعدادات لكل عقار. إذا كان لديك عدة عقارات، بدّل العقار أعلى الشاشة قبل تغييرها.
- لا شيء آخر يكتب هذه القيم: التدقيق الليلي ومحرك الحجز ونقطة البيع تقرأ كلها الإعدادات نفسها، فيسري التغيير فورا.
- سجل النشاط (الإدارة → سجل النشاط) يعرض من غيّر أي إعداد، ومتى، ومن أي قيمة إلى أي قيمة.
- لمعرفة من سجّل الدخول إلى Kamra ومتى، اختر دخول الموظفين في عامل تصفية سجل النشاط. يعرض عمليات الدخول والخروج ومحاولات الدخول الفاشلة لموظفي هذا العقار. لمدير الفندق والمالية وتقنية المعلومات فقط.
للمطورين
الصفحات والقيم تأتي من سجل واحد في kamra/settings.py (settings_schema، save_settings)، والكود يقرأ القيمة باستخدام get_setting(property, key). الموظفون والأدوار في kamra/staff.py. راجع مرجع API.