دليل المستخدم الشامل لنظام SPA X

الدور الوظيفي / Role	حساب الدخول التجريبي / Demo Login	المهام اليومية والصلاحيات (عربي)	Daily Duties & Permissions (English)
1. مالك المنصة السحابية Platform Admin	[email protected] SpaX#2026!	إدارة الشركات المشتركة في المنصة (/Tenants)، تحديد باقات الاشتراك (Starter / Professional / Enterprise)، مراقبة حدود الفروع والمستخدمين وتجديد الاشتراكات.	Manages SaaS tenant companies (/Tenants), subscription plans, branch/user/booking quotas, and subscription renewals (`tenants.manage`).
2. مدير الشركة / المالك Company Admin	[email protected] SpaX#2026!	صلاحية كاملة على جميع فروع الشركة (41 صلاحية): لوحة التحكم، الفرع المباشر، الإعدادات، الفروع، المستخدمين والأدوار، التقارير الشاملة، سجل التدقيق، وكافة وحدات التشغيل والموارد البشرية والحسابات.	Full access across all company branches (41 permissions): Executive Dashboard, Live Branch, Settings, Branches, Users & Roles, Audit Log, Reports, Operations, HR, and Finance.
3. مدير الفرع Branch Manager	يُعيّن من شاشة المستخدمين Assigned via Users	الإشراف الكامل على فرعه: شاشة الفرع مباشر، إدارة الحجوزات والغرف والعملاء، تحصيل واسترداد المدفوعات، بيع وإدارة الباقات، جدول الورديات، الإجازات، المكافآت والجزاءات، المخازن وطلبات الشراء، والأجهزة والصيانة.	Supervises assigned branch(es): Live Branch, Bookings, Rooms, Customers, Payments & Refunds, Packages, Staff Roster, Leave Approvals, Payroll Adjustments, Inventory, and Maintenance Requests.
4. موظف الاستقبال والكاشير Reception & Cashier	[email protected] SpaX#2026!	المستخدم اليومي الأساسي في الاستقبال: فتح وإغلاق وردية الكاشير، تسجيل العملاء، إنشاء الحجوزات ومتابعة الجلسات، قائمة الانتظار، تحصيل الفواتير متعدد العملات في شاشة الكاشير (POS)، بيع الباقات، ورفع بلاغات الصيانة.	Front-desk daily operator: Opens/closes cash shifts, registers customers, creates & manages bookings, handles waitlist, collects multi-currency payments at POS, sells packages, and submits maintenance tickets.
5. الأخصائي / المعالج Therapist / Specialist	[email protected] SpaX#2026!	تسجيل الحضور والانصراف عبر شاشة البصمة الذكية (/Kiosk)، والدخول إلى بوابته الشخصية (/My) لمتابعة جدول جلساته اليومية والقادمة، تقديم طلبات الإجازة، ومتابعة عمولاته وكشف راتبه.	Punches in/out at the Biometric Kiosk (/Kiosk) and uses the personal portal (/My) to view assigned active/upcoming sessions, request leave, and check personal commissions and payslips.
6. مدير الموارد البشرية HR Manager	يُعيّن من شاشة المستخدمين Assigned via Users	إدارة الهيكل الوظيفي والمهارات، ملفات الموظفين والبيانات الحساسة المشفرة، مراقبة الحضور وصور البصمة، إدارة جدول الورديات، اعتماد الإجازات، المكافآت والجزاءات، وإصدار واعتماد مسير الرواتب الشهري.	Manages Organization & Skills, Employee profiles (including encrypted IDs/bank accounts), Attendance logs & verification photos, Shift Rosters, Leave approvals, Adjustments, and Monthly Payroll runs.
7. المحاسب المالي Accountant	يُعيّن من شاشة المستخدمين Assigned via Users	تحديث أسعار الصرف للعملات الأجنبية، مراجعة المدفوعات والاستردادات والورديات، اعتماد أوامر الشراء وسداد الموردين، إدارة مجموعات المبيعات والعمولات، مراجعة الرواتب، وتصدير قيود اليومية المحاسبية والتقارير المالية.	Manages Foreign Exchange rates, Payments & Refunds, Purchase Order approvals, Supplier payments, Sales & Commission groups, Payroll review, Chart of Accounts, Journal exports, and Financial Reports.
8. أمين المخزن Storekeeper	يُعيّن من شاشة المستخدمين Assigned via Users	إدارة دليل الأصناف والخامات، متابعة أرصدة المخازن وتواريخ صلاحية التشغيلات (FEFO)، إنشاء طلبات الشراء واستلام البضاعة (GRN)، تنفيذ التحويلات المخزنية بين الفروع، وصرف المستلزمات.	Manages Items catalog, Warehouse stock balances, FEFO expiry lots, Purchase Order creation, Goods Receipt Notes (GRN), and inter-branch Stock Transfers.
9. مهندس / فني الصيانة Maintenance Technician	[email protected] SpaX#2026!	استلام بلاغات الأعطال وتذاكر الصيانة الوقائية المسندة إليه في شاشة (/Requests)، تحديث حالة الإصلاح، كتابة التقارير الفنية، وتسجيل قطع الغيار المسحوبة من المخزن قبل انتهاء وقت الـ SLA.	Receives assigned maintenance tickets and preventive schedules (/Requests), updates repair status, logs technical comments, and records consumed spare parts within SLA deadlines.
10. موظف المبيعات والمندوب Sales & Field Agent	[email protected] SpaX#2026!	تفعيل جلسة العمل الميداني لإرسال الموقع الجغرافي المباشر على خريطة المندوبين (/Field/Map)، متابعة التارجت الشهري وشرائح العمولات المكتسبة من بوابته الذاتية (/My).	Starts outdoor field sessions for live GPS tracking (/Field/Map) and tracks monthly sales targets, commission tiers, and personal attendance via '/My'.

الخطوة 01 / Step 01 👤 جميع المستخدمين (كل حسب حسابه) | All Users (Role-Based Login)

/Account/Login

شاشة تسجيل الدخول الموحدة واختيار اللغة والمظهر

الهدف من الشاشة: بوابة الدخول الآمنة للنظام مع إمكانية التبديل الفوري بين اللغتين العربية (RTL) والإنجليزية (LTR) والوضع النهاري أو الليلي قبل أو بعد الدخول.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

حماية تلقائية ضد محاولات التخمين (إغلاق مؤقت بعد 5 محاولات خاطئة).
إجبار المستخدم الجديد على تغيير كلمة المرور المؤقتة فور أول تسجيل دخول.

Unified Sign-In Screen, Language & Theme Switcher

Screen Purpose: Secure authentication gateway supporting instant switching between Arabic (RTL) and English (LTR) as well as Light and Dark themes.

Step-by-Step Daily User Instructions:

Open the system URL on any desktop, tablet, or mobile browser and select your preferred language (Arabic / English).
Enter your assigned work email (e.g., [email protected] for Admin or [email protected] for Reception).
Enter your password; click the eye icon to reveal and verify your password if needed.
Click 'Sign in' to access your personalized workspace tailored strictly to your role permissions.

💡 Key Capabilities & Smart Rules:

Automatic brute-force lockout protection after 5 failed attempts.
Mandatory password change enforcement upon first login with a temporary password.

الواجهة العربية (Arabic RTL) — شاشة تسجيل الدخول الموحدة واختيار اللغة والمظهر /Account/Login

English Interface (LTR) — Unified Sign-In Screen, Language & Theme Switcher /Account/Login

الخطوة 02 / Step 02 👤 مدير الشركة / مدير النظام (Company Admin) | Company Admin / System Administrator

/Setup

دليل البدء السريع وقائمة التحقق الذكية (Getting Started)

الهدف من الشاشة: خارطة طريق تفاعلية ترشد مدير المركز خطوة بخطوة للتأكد من اكتمال كافة الإعدادات الأساسية قبل بدء استقبال العملاء.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

تمنع نسيان الإعدادات الحيوية مثل أسعار الصرف أو ربط الخدمات بالغرف قبل أول حجز.
تعمل كدليل تفاعلي حي يتحدث تلقائياً بمجرد إدخال البيانات.

Quick Setup & Operational Readiness Checklist

Screen Purpose: Interactive readiness checklist guiding the spa manager step-by-step to ensure all foundational data is configured before going live.

Step-by-Step Daily User Instructions:

Navigate to 'Getting started' under the System section in the sidebar.
Review the completion status of each operational prerequisite (Branches, FX Rates, Rooms, Services, Staff, Shifts).
Click the direct shortcut link next to any pending item to jump straight to its configuration screen.
Once all items show a green check, your spa center is 100% ready for live operations.

💡 Key Capabilities & Smart Rules:

Prevents overlooking critical prerequisites like exchange rates or service-to-room assignments.
Updates dynamically in real time as master data is populated.

الواجهة العربية (Arabic RTL) — دليل البدء السريع وقائمة التحقق الذكية (Getting Started) /Setup

English Interface (LTR) — Quick Setup & Operational Readiness Checklist /Setup

الخطوة 03 / Step 03 👤 مدير الشركة (Company Admin) | Company Admin

/Branches

إدارة الفروع والعملات الأساسية والمناطق الزمنية

الهدف من الشاشة: إضافة وإدارة فروع المركز (مثل فرع الإسكندرية وفرع الغردقة) وتحديد العملة الافتراضية والمنطقة الزمنية لكل فرع.

خطوات العمل للمستخدم اليومي:

انتقل إلى (الفروع) من قسم النظام والإعدادات.
أدخل كود الفرع المختصر (مثل ALX أو HRG) والاسم بالعربية والإنجليزية لظهوره في الفواتير وصفحة الحجز.
حدد عملة الفرع الأساسية والمنطقة الزمنية (مثل Africa/Cairo) لضمان دقة مواعيد الحجوزات والورديات.
يمكنك تفعيل أو إيقاف أي فرع مؤقتاً بضغطة زر دون فقدان بياناته التاريخية.

💡 مميزات وقواعد ذكية في هذه الشاشة:

عزل كامل أو مشترك لبيانات الفروع حسب صلاحية كل موظف (الموظف يرى الفروع المربوطة به فقط).
ترقيم مستقل للفواتير والحجوزات لكل فرع تلقائياً.

Branches, Base Currencies & Timezones Management

Screen Purpose: Configure and manage all company branches (e.g., Alexandria, Hurghada) with branch-specific currency, timezone, and contact details.

Step-by-Step Daily User Instructions:

Open 'Branches' under the System menu.
Enter the branch code (e.g., ALX, HRG) and bilingual names displayed on invoices and public booking pages.
Select the branch currency and timezone (e.g., Africa/Cairo) for accurate appointment scheduling.
Activate or deactivate branches at any time while preserving historical records.

💡 Key Capabilities & Smart Rules:

Strict branch-level data scoping based on user branch assignments.
Independent automatic numbering series for bookings and invoices per branch.

الواجهة العربية (Arabic RTL) — إدارة الفروع والعملات الأساسية والمناطق الزمنية /Branches

English Interface (LTR) — Branches, Base Currencies & Timezones Management /Branches

الخطوة 04 / Step 04 👤 مدير الشركة / المحاسب (Company Admin / Accountant) | Company Admin / Accountant

/ExchangeRates

إدارة العملات وأسعار الصرف اليومية (Multi-Currency FX)

الهدف من الشاشة: تحديث أسعار صرف العملات الأجنبية (الدولار USD، اليورو EUR، الريال السعودي SAR، الجنيه الإسترليني GBP) مقابل العملة الأساسية للتحصيل الفوري من السائحين.

خطوات العمل للمستخدم اليومي:

افتح شاشة (أسعار الصرف) من قسم الحسابات والمخزون.
اختر عملة الدفع (مثلاً USD) وعملة الأساس (مثلاً EGP) وأدخل سعر الصرف المعتمد وتاريخ السريان.
اضغط (حفظ) ليتم تطبيق السعر الجديد فوراً في شاشة الكاشير (POS) وشاشة تحصيل الحجوزات والباقات.
يحتفظ النظام بسجل تاريخي كامل لأسعار الصرف لضمان عدم تغير قيم الفواتير السابقة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يدعم التحصيل بأي عملة أجنبية أو تقسيم الفاتورة الواحدة بين أكثر من عملة في نفس اللحظة.
يحمي المركز من أخطاء الحساب اليدوي لفرق العملة على الكاشير.

Multi-Currency & Daily Exchange Rates Management

Screen Purpose: Manage foreign exchange rates (USD, EUR, SAR, GBP) against the base currency for seamless multi-currency checkout.

Step-by-Step Daily User Instructions:

Navigate to 'Exchange rates' under Accounting.
Select the source currency (e.g., USD), target base currency (e.g., EGP), rate, and effective date.
Click Save to immediately apply the rate across POS, Booking Payments, and Package Sales.
Historical payments retain their exact snapshot exchange rate for accurate financial auditing.

💡 Key Capabilities & Smart Rules:

Supports paying in any foreign currency or splitting a single invoice across multiple currencies.
Eliminates manual currency conversion errors at the reception desk.

الواجهة العربية (Arabic RTL) — إدارة العملات وأسعار الصرف اليومية (Multi-Currency FX) /ExchangeRates

English Interface (LTR) — Multi-Currency & Daily Exchange Rates Management /ExchangeRates

الخطوة 05 / Step 05 👤 مدير الشركة (Company Admin) | Company Admin

/Roles

مصفوفة الأدوار والصلاحيات الأمنية الدقيقة (42 صلاحية)

الهدف من الشاشة: التحكم الدقيق في صلاحيات كل مسمى وظيفي داخل النظام عبر 42 صلاحية مستقلة تغطي التشغيل، الموارد البشرية، الحسابات، المخازن، والبيانات الحساسة.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

فصل تام للصلاحيات الحساسة مثل (رؤية الهوية والحساب البنكي)، (اعتماد الرواتب)، و(رد المبالغ المالية Refund).
إخفاء الشاشات غير المصرح بها تلقائياً من القائمة الجانبية لكل مستخدم.

Role-Based Access Control (RBAC) Matrix — 42 Permissions

Screen Purpose: Granular control over role capabilities across 42 distinct permissions covering Operations, HR, Finance, Inventory, and Sensitive Data.

Step-by-Step Daily User Instructions:

Open 'Roles' under System to view predefined roles (CompanyAdmin, BranchManager, HRManager, Accountant, Reception, Therapist, Storekeeper, Technician).
Select any role to toggle individual permissions (e.g., allowing bookings while restricting payroll or sensitive ID access).
Create custom roles tailored to your organizational hierarchy.
Permission changes take effect automatically within ~1 minute via security stamp validation.

💡 Key Capabilities & Smart Rules:

Dedicated permissions for sensitive actions: viewing encrypted IDs/bank accounts, approving payroll, and issuing refunds.
Unauthorized menu items are automatically hidden from the user's sidebar.

الواجهة العربية (Arabic RTL) — مصفوفة الأدوار والصلاحيات الأمنية الدقيقة (42 صلاحية) /Roles

English Interface (LTR) — Role-Based Access Control (RBAC) Matrix — 42 Permissions /Roles

الخطوة 06 / Step 06 👤 مدير الشركة (Company Admin) | Company Admin

/Users

إدارة حسابات المستخدمين وربطهم بالفروع والأدوار

الهدف من الشاشة: إنشاء حسابات الدخول للموظفين والمديرين وتحديد الدور الوظيفي والفروع المسموح لكل مستخدم العمل عليها.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

ربط سلس بين حساب المستخدم وسجله الوظيفي في الموارد البشرية لتفعيل بوابة الموظف الذاتية (/My).
دعم تعدد الفروع للمديرين أو تقييد الموظف بفرع واحد.

System Users & Branch Access Management

Screen Purpose: Create user accounts for staff and managers, assign roles, and restrict access to specific branches.

Step-by-Step Daily User Instructions:

Go to 'Users' under System to create or manage user accounts.
Enter full name, email, assign a role, and check the branches the user is authorized to access.
Issue a temporary password when onboarding or resetting credentials; the user will be prompted to change it on login.
Deactivate any user account with a single click to revoke access immediately.

💡 Key Capabilities & Smart Rules:

Direct linking between user accounts and HR employee profiles to power the self-service portal (/My).
Supports multi-branch access for supervisors and single-branch restriction for local staff.

الواجهة العربية (Arabic RTL) — إدارة حسابات المستخدمين وربطهم بالفروع والأدوار /Users

English Interface (LTR) — System Users & Branch Access Management /Users

الخطوة 07 / Step 07 👤 مدير الشركة (Company Admin) | Company Admin

/Settings

إعدادات النظام المتقدمة والسياسات والربط المشفر

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الإعدادات) واستعرض المجموعات المصنفة (Booking, Invoice, Currency, HR, Cash, Package, Tax, Integrations).
يمكنك ضبط الإعداد على مستوى الشركة بالكامل، أو تخصيص قيمة مختلفة لفرع معين (مثلاً مواعيد عمل فرع الغردقة تختلف عن الإسكندرية).
اضبط وقت الراحة والتعقيم بين الجلسات (booking.buffer_minutes) ونسبة الخصم القصوى المسموحة للاستقبال.
جميع مفاتيح الربط السرية (مثل الفاتورة الإلكترونية ETA وبوابات الدفع وSMS) تُحفظ مشفرة تماماً ولا تظهر كنص مكشوف أبداً.

💡 مميزات وقواعد ذكية في هذه الشاشة:

أكثر من 70 إعداداً مرناً يغنيك عن أي تعديل برمجي عند تغيير سياسات المركز.
حماية قصوى للبيانات السرية ومفاتيح الربط الإلكتروني.

Advanced Company/Branch Settings & Encrypted Integrations

Screen Purpose: Centralized configuration hub for business rules (operating hours, buffer times, cancellation policies, HR penalties, tax/insurance formulas, and encrypted API keys).

Step-by-Step Daily User Instructions:

Open 'Settings' to browse categorized rules (Booking, Invoice, Currency, HR, Cash, Package, Tax, Integrations).
Set company-wide defaults or override specific settings per branch (e.g., custom operating hours for resort branches).
Configure room sanitization buffer minutes, maximum reception discount percentage, and cash variance thresholds.
All secret keys (ETA e-Invoice, Payment Gateways, SMTP, SMS, Hotel PMS) are encrypted at rest via ASP.NET Core DataProtection.

💡 Key Capabilities & Smart Rules:

Over 70 configurable parameters allowing policy changes without code modifications.
Enterprise encryption at rest for all integration secrets.

الواجهة العربية (Arabic RTL) — إعدادات النظام المتقدمة والسياسات والربط المشفر /Settings

English Interface (LTR) — Advanced Company/Branch Settings & Encrypted Integrations /Settings

الخطوة 08 / Step 08 👤 مدير الموارد البشرية / مدير الشركة (HR Manager / Admin) | HR Manager / Company Admin

/Org

الهيكل التنظيمي، الأقسام، المسميات الوظيفية، ومهارات الأخصائيين

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الهيكل الوظيفي) من قسم الموارد البشرية.
أضف الأقسام الإدارية والتشغيلية (مثل: التشغيل، الإدارة).
أضف المسميات الوظيفية وحدد هل الوظيفة مؤهلة لعمولات المبيعات (Commission Eligible) أو مندوب ميداني (Field Agent).
أضف المهارات الفنية (Skills) مثل (مساج علاجي، حمام مغربي، عناية بالبشرة) ليقوم محرك الحجز بترشيح الأخصائي المؤهل فقط لكل خدمة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يربط المهارات بين الأخصائي والخدمة لمنع حجز جلسة متخصصة لمعالج غير مدرب عليها.
يفعّل تلقائياً ميزات العمولات وتتبع الخريطة حسب المسمى الوظيفي.

Organization Structure: Departments, Positions & Therapy Skills

Screen Purpose: Define departments, job positions (including commission eligibility and field-agent tracking flags), and technical therapy skills.

Step-by-Step Daily User Instructions:

Navigate to 'Organization' under Human Resources.
Create operational and administrative departments.
Define job positions and toggle 'Commission Eligible' or 'Field Agent' flags as appropriate.
Register therapy skills (e.g., Deep Massage, Moroccan Bath, Facial Care) used by the booking engine to match qualified staff.

💡 Key Capabilities & Smart Rules:

Skill-matching prevents assigning specialized treatments to unqualified therapists.
Automatically enables commission calculation and GPS tracking based on position flags.

الواجهة العربية (Arabic RTL) — الهيكل التنظيمي، الأقسام، المسميات الوظيفية، ومهارات الأخصائيين /Org

English Interface (LTR) — Organization Structure: Departments, Positions & Therapy Skills /Org

الخطوة 09 / Step 09 👤 مدير الموارد البشرية / مدير الفرع (HR Manager / Branch Manager) | HR Manager / Branch Manager

/Employees

إدارة الموظفين والأخصائيين، المهارات، والبيانات المشفرة، ورمز البصمة

الهدف من الشاشة: ملف شامل لكل موظف وأخصائي يضم بيانات التعيين، الراتب الأساسي والبدلات، الفروع المكلف بها، المهارات الفنية، إعداد رمز الـ PIN وبصمة الوجه للكشك، والبيانات الحساسة المشفرة.

خطوات العمل للمستخدم اليومي:

انتقل إلى شاشة (الموظفون) واضغط لإضافة موظف أو أخصائي جديد.
أدخل الكود الوظيفي (مثل TH-01)، الاسم بالعربية والإنجليزية، الجنس (مهم جداً لمطابقة تفضيل العميل رجل/سيدة في الحجز)، والراتب الأساسي.
اربط الموظف بالفروع التي يعمل بها، وحدد المهارات الفنية التي يتقنها (Skills).
عيّن رمز PIN للبصمة وسجّل بصمة الوجه ليتمكن الموظف من تسجيل حضوره وانصرافه عبر شاشة الكشك الذكي (/Kiosk).

💡 مميزات وقواعد ذكية في هذه الشاشة:

تشفير أرقام الهوية وجوازات السفر والحسابات البنكية وحصر رؤيتها بصلاحية خاصة (employees.sensitive).
ربط الجنس والمهارات والفرع مباشرة بمحرك الحجز الذكي.

Employees & Therapists Directory, Skills, Kiosk PIN & Encrypted Data

Screen Purpose: Complete staff profiles covering hire details, base salary, branch assignments, therapy skills, Kiosk PIN/face descriptor, and encrypted ID/bank data.

Step-by-Step Daily User Instructions:

Open 'Employees' under HR to view or add staff members.
Enter employee code (e.g., TH-01), bilingual names, gender (used for customer therapist gender preferences), and salary details.
Assign primary/secondary branches and check all mastered therapy skills.
Set the employee's Kiosk PIN and face profile for biometric check-in, and store national ID/passport/bank numbers securely encrypted.

💡 Key Capabilities & Smart Rules:

National IDs, passports, and bank accounts are encrypted at rest and restricted to 'employees.sensitive' permission.
Therapist gender, skills, and branch assignments feed directly into the real-time booking engine.

الواجهة العربية (Arabic RTL) — إدارة الموظفين والأخصائيين، المهارات، والبيانات المشفرة، ورمز البصمة /Employees

English Interface (LTR) — Employees & Therapists Directory, Skills, Kiosk PIN & Encrypted Data /Employees

الخطوة 10 / Step 10 👤 مدير الفرع / مدير الشركة (Branch Manager / Admin) | Branch Manager / Company Admin

/Rooms

إدارة الغرف والأجنحة العلاجية وسعتها وحالتها

الهدف من الشاشة: تعريف غرف المساج، أجنحة الحمام المغربي، غرف العناية بالبشرة، وأجنحة الساونا والجاكوزي في كل فرع مع تحديد سعة كل غرفة وحالتها التشغيلية.

خطوات العمل للمستخدم اليومي:

افتح شاشة (الغرف) من قسم البيانات الأساسية.
أضف الغرف الخاصة بكل فرع مع كود مميز (مثل M1، B1، S1) والاسم بالعربية والإنجليزية.
حدد سعة الغرفة (Capacity) — مثلاً غرفة فردية (1) أو جناح زوجي/جاكوزي يتسع لشخصين (2).
في حال وجود صيانة طارئة بالغرفة، يمكنك تحويل حالتها إلى (صيانة / Out of Service) ليوقف النظام الحجز فيها فوراً.

💡 مميزات وقواعد ذكية في هذه الشاشة:

منع التداخل الزمني على نفس الغرفة ومراعاة وقت التنظيف والتعقيم بين كل جلسة وأخرى تلقائياً.
ظهور حالة الغرف حية في شاشة (الفرع مباشر).

Treatment Rooms, Suites, Capacity & Status Management

Screen Purpose: Manage massage rooms, Moroccan bath suites, facial rooms, and sauna/jacuzzi suites per branch with room capacity and availability status.

Step-by-Step Daily User Instructions:

Navigate to 'Rooms' under Basic Data.
Add rooms per branch with a short code (e.g., M1, B1, S1) and bilingual names.
Set room capacity (e.g., 1 for individual rooms, 2 for couples suites or jacuzzi).
Switch room status to Maintenance whenever a room is under repair to automatically block new bookings.

💡 Key Capabilities & Smart Rules:

Automatic conflict prevention and post-session sanitization buffer enforcement per room.
Real-time room status visibility on the Live Branch board.

الواجهة العربية (Arabic RTL) — إدارة الغرف والأجنحة العلاجية وسعتها وحالتها /Rooms

English Interface (LTR) — Treatment Rooms, Suites, Capacity & Status Management /Rooms

الخطوة 11 / Step 11 👤 مدير الشركة / مدير الفرع (Company Admin / Branch Manager) | Company Admin / Branch Manager

/Services

كتالوج الخدمات والجلسات، الأسعار، المهارات، والغرف، والخامات المستهلكة

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الخدمات) من قسم البيانات الأساسية.
أدخل اسم الخدمة والوصف بالعربية والإنجليزية، المدة بالدقائق (مثلاً 60 دقيقة)، والسعر الأساسي.
اربط الخدمة بـ (المهارات المطلوبة) و(الغرف المجهزة لها) في كل فرع.
حدد (مواد وخامات الخدمة) مثل 50 مل زيت أرجان أو 1 ليفة مغربية ليقوم النظام بخصمها تلقائياً من المخزن عند إتمام الجلسة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

ربط ثلاثي ذكي (الخدمة ↔ الغرفة ↔ مهارة الأخصائي ↔ خامات المخزن).
تظهر الخدمات المفعلة تلقائياً في صفحة الحجز الذاتي للعملاء عبر الـ QR.

Spa Services Catalog, Pricing, Required Skills, Rooms & Material BOM

Screen Purpose: Configure all spa services with duration, price, required staff count, compatible rooms, required therapist skills, and automatic inventory consumption.

Step-by-Step Daily User Instructions:

Open 'Services' under Basic Data.
Enter bilingual service names, descriptions, duration in minutes, price, and required therapist count.
Link each service to its required therapy skills and compatible treatment rooms.
Define Service Materials (Bill of Materials) so consumables like oils and soaps are automatically deducted from stock upon session completion.

💡 Key Capabilities & Smart Rules:

Smart 4-way linkage: Service ↔ Room ↔ Therapist Skill ↔ Warehouse Consumables.
Active services automatically publish to the public QR self-booking portal.

الواجهة العربية (Arabic RTL) — كتالوج الخدمات والجلسات، الأسعار، المهارات، والغرف، والخامات المستهلكة /Services

English Interface (LTR) — Spa Services Catalog, Pricing, Required Skills, Rooms & Material BOM /Services

الخطوة 12 / Step 12 👤 مدير الشركة / مدير الفرع (Company Admin / Branch Manager) | Company Admin / Branch Manager

/Packages

تصميم باقات الجلسات والعضويات (ملكي / عروسة / VIP)

الهدف من الشاشة: إنشاء باقات مجمعة تضم عدة جلسات من خدمات متنوعة بسعر تفضيلي وفترة صلاحية محددة لزيادة ولاء العملاء والمبيعات المقدمة.

خطوات العمل للمستخدم اليومي:

انتقل إلى شاشة (الباكدجات) من قسم البيانات الأساسية.
أدخل اسم الباقة بالعربية والإنجليزية، سعر البيع الإجمالي، العملة، وفترة الصلاحية بالأيام (مثلاً 90 أو 120 يوماً).
أضف بنود الباقة (الخدمات وعدد الجلسات لكل خدمة — مثلاً 3 جلسات مساج سويدي + 1 حمام مغربي).
احفظ الباقة لتصبح متاحة فوراً للبيع في شاشة (بيع باكدج) وشاشة (نقطة البيع POS).

💡 مميزات وقواعد ذكية في هذه الشاشة:

يدعم النظام الاعتراف بالإيراد عند البيع أو عند استخدام كل جلسة (الإيرادات المؤجلة Deferred Revenue).
متابعة دقيقة لرصيد الجلسات المتبقية لكل عميل وتاريخ انتهاء صلاحية الباقة.

Multi-Session Packages & Memberships Design

Screen Purpose: Create bundled multi-session packages (e.g., Royal Relaxation, Bridal VIP) with discounted pricing and validity periods.

Step-by-Step Daily User Instructions:

Go to 'Packages' under Basic Data.
Set bilingual package names, total package price, currency, and validity in days (e.g., 90 days).
Add package lines specifying each included service and number of sessions.
Save to make the package immediately available for sale at Reception and POS.

💡 Key Capabilities & Smart Rules:

Supports both 'on-sale' and 'on-use' (deferred revenue) accounting recognition.
Tracks remaining session balances per service and expiration dates automatically.

الواجهة العربية (Arabic RTL) — تصميم باقات الجلسات والعضويات (ملكي / عروسة / VIP) /Packages

English Interface (LTR) — Multi-Session Packages & Memberships Design /Packages

الخطوة 13 / Step 13 👤 مدير الشركة / مدير الفرع (Company Admin / Branch Manager) | Company Admin / Branch Manager

/Offers

إدارة العروض الترويجية والخصومات الموسمية

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

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

سقف أمان لإجمالي الخصومات المسموحة (offer.max_total_discount_percent) لحماية ربحية المركز.
تفعيل وإيقاف آلي للعروض حسب التاريخ دون تدخل يدوي.

Promotional Offers & Seasonal Discounts

Screen Purpose: Launch time-bound percentage discount campaigns on specific services or store-wide across all services.

Step-by-Step Daily User Instructions:

Open 'Offers' under Basic Data.
Specify bilingual offer titles, discount percentage, and validity date range (Valid From / Valid To).
Target a specific service or leave blank for a general promotion across all services.
Active offers automatically appear on the public QR booking page and during reception booking.

💡 Key Capabilities & Smart Rules:

Built-in discount cap protection via system settings to safeguard profit margins.
Automatic activation and expiration based on campaign dates.

الواجهة العربية (Arabic RTL) — إدارة العروض الترويجية والخصومات الموسمية /Offers

English Interface (LTR) — Promotional Offers & Seasonal Discounts /Offers

الخطوة 14 / Step 14 👤 مدير الفرع / مدير التسويق (Branch Manager) | Branch Manager / Marketing

/Locations

إنشاء روابط ورموز الاستجابة السريعة (QR Codes) للحجز الذاتي

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

خطوات العمل للمستخدم اليومي:

انتقل إلى شاشة (روابط QR) من قسم البيانات الأساسية.
اختر الفرع، أدخل كود الموقع المميز (مثل ALX-FOURSEASONS أو HRG-RESORT-SPA)، واسم الموقع ونوعه (فندق، كافيه، استقبال).
ينشئ النظام رابط حجز مباشر ورمز QR قابل للطباعة فوراً لوضعه في الغرف الفندقية أو الاستقبال.
عندما يحجز العميل من هذا الرمز، يعرف موظف الاستقبال تلقائياً من أي فندق أو موقع جاء الحجز.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يضاعف الحجوزات الواردة من الفنادق والمنتجعات السياحية بدون الحاجة لمكالمات هاتفية.
إمكانية إيقاف أو تفعيل أي رابط QR في أي وقت.

QR Code Self-Booking Links Generator

Screen Purpose: Generate custom QR codes for hotel rooms, resort lobbies, cafes, and reception desks enabling instant guest self-booking.

Step-by-Step Daily User Instructions:

Navigate to 'QR links' under Basic Data.
Select the branch, enter a unique location code, location name, and type (Hotel, Cafe, Reception).
Print or download the generated QR code to place on hotel room desks, lobby stands, or brochures.
Bookings originating from a QR code automatically tag the guest's source location for reception.

💡 Key Capabilities & Smart Rules:

Drives effortless self-service bookings from partner hotels and resorts.
Individual QR codes can be toggled active/inactive at any time.

الواجهة العربية (Arabic RTL) — إنشاء روابط ورموز الاستجابة السريعة (QR Codes) للحجز الذاتي /Locations

English Interface (LTR) — QR Code Self-Booking Links Generator /Locations

الخطوة 15 / Step 15 👤 مدير الفرع / مدير الموارد البشرية (Branch Manager / HR) | Branch Manager / HR Manager

/Roster

جدول توزيع الورديات الأسبوعي والشهري (Staff Roster)

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (جدول الورديات) من قسم الموارد البشرية.
عرّف قوالب الورديات القياسية (مثل: الوردية الصباحية 09:00-17:00، والوردية المسائية 15:00-23:00).
وزّع الموظفين والمعالجين على أيام الأسبوع والفروع بمرونة عالية.
يعتمد النظام على هذا الجدول لحساب دقائق التأخير والعمل الإضافي تلقائياً عند بصمة الحضور، وكذلك لمنع حجز معالج خارج وقت ورديته.

💡 مميزات وقواعد ذكية في هذه الشاشة:

ربط مباشر بين جدول الورديات وبين جهاز البصمة ومسير الرواتب ومحرك الحجوزات.
إمكانية تفعيل خيار (حصر الحجز داخل وقت وردية المعالج فقط) من الإعدادات.

Weekly & Monthly Staff Shift Roster

Screen Purpose: Define shift templates (Morning / Evening) and assign daily staff schedules across branches.

Step-by-Step Daily User Instructions:

Open 'Roster' under Human Resources.
Create shift templates with exact start and end times (supporting overnight shifts).
Assign employees to shifts and branches across the calendar.
Used automatically by the payroll engine to calculate late arrivals and overtime, and optionally by the booking engine to enforce shift availability.

💡 Key Capabilities & Smart Rules:

Direct integration between Roster, Biometric Attendance, Payroll late/overtime calculation, and Booking availability.
Optional strict enforcement so therapists can only be booked during their rostered shift.

الواجهة العربية (Arabic RTL) — جدول توزيع الورديات الأسبوعي والشهري (Staff Roster) /Roster

English Interface (LTR) — Weekly & Monthly Staff Shift Roster /Roster

الخطوة 16 / Step 16 👤 جميع الموظفين والأخصائيين (All Staff & Therapists) | All Employees & Therapists

/Kiosk

شاشة الكشك الذكي لتسجيل الحضور والانصراف ببصمة الوجه والـ PIN

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

خطوات العمل للمستخدم اليومي:

يقف الموظف أمام كاميرا شاشة الكشك (/Kiosk) عند وصوله للفرع في بداية الوردية.
يدخل كوده الوظيفي (مثل TH-01) ورمز الـ PIN السري الخاص به على لوحة الأرقام اللمسية.
تلتقط الكاميرا صورة فورية لوجه الموظف وتطابق البصمة الحيوية للوجه، ويسجل النظام حركة (حضور In) أو (انصراف Out) تلقائياً حسب آخر حركة.
تُحفظ صورة البصمة في مجلد آمن ومشفر للمراجعة من قِبل إدارة الموارد البشرية لمنع أي تلاعب بالحضور.

💡 مميزات وقواعد ذكية في هذه الشاشة:

ميزة قوية جداً: يجمع بين الكشك الذكي عبر الكاميرا وبين دعم أجهزة البصمة الفعلية (ZKTeco ProFace X و Suprema BioStation).
حماية ضد المحاولات الخاطئة المتكررة ومنع تسجيل بصمتين متتاليتين بالخطأ خلال 60 ثانية.

Biometric Face Recognition & PIN Attendance Kiosk

Screen Purpose: Dedicated full-screen touch kiosk where staff punch in and out using their Employee Code, PIN, and live camera face verification.

Step-by-Step Daily User Instructions:

Upon arriving at the branch, the employee stands in front of the Kiosk tablet camera (/Kiosk).
The employee enters their Employee Code and secret PIN on the touch keypad.
The live camera captures a verification photo and matches the face descriptor, automatically recording a Check-In or Check-Out punch.
Verification photos are stored securely in protected storage for HR audit, preventing buddy-punching.

💡 Key Capabilities & Smart Rules:

Killer Feature: Combines web/tablet AI camera face verification with hardware biometric terminals (ZKTeco / Suprema).
Built-in anti-passback (60s duplicate prevention) and automatic PIN lockout after 5 failed attempts.

الواجهة العربية (Arabic RTL) — شاشة الكشك الذكي لتسجيل الحضور والانصراف ببصمة الوجه والـ PIN /Kiosk

English Interface (LTR) — Biometric Face Recognition & PIN Attendance Kiosk /Kiosk

الخطوة 17 / Step 17 👤 مدير الموارد البشرية / مدير الفرع (HR Manager / Branch Manager) | HR Manager / Branch Manager

/Attendance

سجل الحضور والانصراف وإدارة أجهزة البصمة والتعرف على الوجه

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الحضور) من قسم الموارد البشرية.
استعرض حالة أجهزة البصمة المربوطة بكل فرع (مثل ZKTeco ProFace X و Suprema BioStation) وآخر ظهور لكل جهاز.
تصفح سجل الحركات اليومي لمعرفة وقت حضور وانصراف كل موظف بدقة، مع إمكانية عرض صورة الكاميرا الملتقطة.
تنتقل بيانات التأخير والغياب والإضافي تلقائياً من هذه الشاشة إلى مسير الرواتب الشهري دون أي إدخال يدوي.

💡 مميزات وقواعد ذكية في هذه الشاشة:

ربط آلي كامل بين البصمة وجدول الورديات ومسير الرواتب.
مراقبة حية لحالة اتصال أجهزة البصمة في جميع الفروع.

Attendance Logs, Verification Photos & Biometric Devices

Screen Purpose: Real-time monitoring of employee check-in/out records, verification photos, and connected biometric hardware status.

Step-by-Step Daily User Instructions:

Navigate to 'Attendance' under Human Resources.
Monitor connected biometric devices across branches and their last-seen heartbeat timestamps.
Review daily punch-in and punch-out logs and inspect captured verification photos (with attendance.photos permission).
Late minutes, absences, and overtime hours flow automatically from these logs into the monthly payroll calculator.

💡 Key Capabilities & Smart Rules:

Zero-touch integration between attendance punches, shift rosters, and payroll calculations.
Live health and connectivity monitoring for all branch biometric terminals.

الواجهة العربية (Arabic RTL) — سجل الحضور والانصراف وإدارة أجهزة البصمة والتعرف على الوجه /Attendance

English Interface (LTR) — Attendance Logs, Verification Photos & Biometric Devices /Attendance

الخطوة 18 / Step 18 👤 موظف الاستقبال والكاشير / مدير الفرع (Reception / Branch Manager) | Receptionist / Cashier / Branch Manager

/Shifts

فتح وإغلاق وردية الكاشير، جرد النقدية، وتوزيع البقشيش (Tips)

الهدف من الشاشة: إدارة عهدة صندوق الكاشير في بداية ونهاية كل وردية، مطابقة النقدية الفعلية بالرصيد الدفتري لكل عملة، وتسجيل وتوزيع إكراميات وبقشيش العملاء على الأخصائيين.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

جرد متعدد العملات في نفس الوردية (جنيه، دولار، يورو، ريال).
شفافية كاملة في تحصيل وتوزيع البقشيش على المعالجين.

Cashier Shift Opening/Closing, Cash Drawer Count & Tips Distribution

Screen Purpose: Manage cashier drawer shifts, reconcile physical cash counts per currency against system totals, and record/distribute staff tips.

Step-by-Step Daily User Instructions:

At the start of the shift, the receptionist opens 'Shift & cash' and clicks 'Open Shift' for their branch.
All payments and refunds collected during the shift are automatically linked to the active shift.
Record customer tips and split them among therapists; tip shares automatically appear on employee payslips.
At shift end, enter the physical cash count per currency; the system calculates any variance and alerts managers if it exceeds the threshold.

💡 Key Capabilities & Smart Rules:

Multi-currency cash drawer reconciliation (EGP, USD, EUR, SAR) within a single shift.
Automated tip pooling and direct attribution to therapist payslips.

الواجهة العربية (Arabic RTL) — فتح وإغلاق وردية الكاشير، جرد النقدية، وتوزيع البقشيش (Tips) /Shifts

English Interface (LTR) — Cashier Shift Opening/Closing, Cash Drawer Count & Tips Distribution /Shifts

الخطوة 19 / Step 19 👤 موظف الاستقبال / خدمة العملاء (Reception / CRM) | Reception / Customer Relations

/Customers

سجل العملاء (محليين وأجانب) وتفضيلات المعالجين وملف الزيارات

الهدف من الشاشة: قاعدة بيانات ذكية للعملاء والنزلاء تحفظ الاسم، الهاتف، الجنسية (مصري / أجنبي)، وتفضيل جنس الأخصائي (رجل / سيدة / لا يهم)، وسجل حجوزاتهم وباقاتهم.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

دعم كامل لبيانات السائحين والنزلاء الأجانب في الفنادق والمنتجعات.
احترام تفضيل العميل لجنس المعالج تلقائياً داخل محرك الحجز.

Customers Directory (Local & International) & Preferences

Screen Purpose: Centralized guest CRM storing contact info, nationality (Local/Foreign), therapist gender preference, booking history, and active packages.

Step-by-Step Daily User Instructions:

Open 'Customers' under Basic Data to search guests by name or phone number.
Add new customers with full name, phone, gender, guest type (Local / Foreign + Nationality), and preferred therapist gender.
Phone numbers are automatically normalized to prevent duplicate customer records.
Customer preferences are remembered and pre-applied during future bookings.

💡 Key Capabilities & Smart Rules:

Tailored for both local spa clients and international hotel/resort tourists.
Automatic enforcement of customer therapist gender preferences during slot matching.

الواجهة العربية (Arabic RTL) — سجل العملاء (محليين وأجانب) وتفضيلات المعالجين وملف الزيارات /Customers

English Interface (LTR) — Customers Directory (Local & International) & Preferences /Customers

الخطوة 20 / Step 20 👤 العميل / النزيل مباشرة من هاتفه (Customer / Hotel Guest) | Customer / Hotel Guest (Self-Service via QR)

/Book/ALX-RECEPTION

صفحة الحجز الذاتي الأونلاين للعميل عبر مسح رمز الـ QR

الهدف من الشاشة: واجهة عصرية مبسطة تفتح للعميل بمجرد مسح رمز الـ QR بهاتفه، تتيح له استعراض الخدمات والعروض، اختيار التاريخ وتفضيل المعالج، رؤية المواعيد المتاحة فعلياً، وتأكيد حجزه في أقل من دقيقة.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

لا يكشف أي بيانات لعملاء آخرين إطلاقاً ومزوّد بحماية ضد الطلبات الوهمية المتكررة (Rate Limiting).
يتزامن في نفس الثانية مع لوحة حجوزات الاستقبال لمنع أي تضارب.

Public Customer Online Self-Booking Portal via QR

Screen Purpose: Mobile-friendly public booking wizard where guests scan a QR code, pick a service, view real-time open time slots, and book instantly.

Step-by-Step Daily User Instructions:

The guest scans the QR code on their phone to open the branch's branded self-booking portal in Arabic or English.
The guest browses active promotional offers, selects a service, date, and therapist gender preference.
The conflict engine calculates and displays only genuinely available time slots where both a compatible room and qualified therapist are free.
The guest enters their name and phone to confirm; reception receives an instant real-time notification and the guest gets a private booking tracking link.

💡 Key Capabilities & Smart Rules:

Zero exposure of other customers' data and protected by IP rate-limiting.
Synchronizes instantaneously with the reception booking board.

الواجهة العربية (Arabic RTL) — صفحة الحجز الذاتي الأونلاين للعميل عبر مسح رمز الـ QR /Book/ALX-RECEPTION

English Interface (LTR) — Public Customer Online Self-Booking Portal via QR /Book/ALX-RECEPTION

الخطوة 21 / Step 21 👤 موظف الاستقبال / مدير الفرع (Reception / Branch Manager) | Receptionist / Branch Manager

/Bookings/New

إنشاء حجز جديد عبر محرك منع التعارض الآلي (Smart Booking Engine)

الهدف من الشاشة: شاشة الحجز السريع لموظف الاستقبال، تقوم بفحص توافر الغرف والأخصائيين المؤهلين والورديات في جزء من الثانية، وتدعم الحجز الفردي أو حجز عدة خدمات متتالية، مع تطبيق العروض أو الخصم من رصيد باقة العميل.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

يستحيل حدوث حجز مزدوج لنفس الغرفة أو نفس المعالج في نفس الوقت حتى لو ضغط موظفان في نفس اللحظة (Serializable Transaction Protection).
يحسب وقت التجهيز والتعقيم (Buffer Time) بعد كل جلسة تلقائياً.

Create New Booking with Zero-Conflict Engine

Screen Purpose: Reception booking wizard that automatically validates room capacity, therapist skill/gender/shift availability, promo offers, and package session redemption.

Step-by-Step Daily User Instructions:

Click 'New Booking', select the branch, service(s), date, and desired start time.
Search or select the customer; the system automatically detects if the customer holds an active package balance for the chosen service.
The engine filters rooms and therapists to show only those available during the slot (including post-session sanitization buffer time).
Select the room and therapist (or auto-assign), apply any promotional offer or package redemption, and click Confirm.

💡 Key Capabilities & Smart Rules:

Database-level serializable conflict protection prevents double-booking rooms or therapists under concurrent load.
Automatically reserves post-session sanitization buffer time after every booking.

الواجهة العربية (Arabic RTL) — إنشاء حجز جديد عبر محرك منع التعارض الآلي (Smart Booking Engine) /Bookings/New

English Interface (LTR) — Create New Booking with Zero-Conflict Engine /Bookings/New

الخطوة 22 / Step 22 👤 موظف الاستقبال / مدير الفرع (Reception / Branch Manager) | Receptionist / Branch Manager

/Bookings

لوحة إدارة الحجوزات اليومية ومتابعة حالات الجلسات

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الحجوزات) واختر الفرع وتاريخ اليوم لاستعراض خريطة الغرف والجلسات.
اضغط على أي حجز لفتح بطاقته التفصيلية، حيث يمكنك تأكيد الحجز، أو الضغط على (بدء الجلسة Start) عند دخول العميل للغرفة.
عند انتهاء الجلسة، اضغط (إتمام الجلسة Complete) ليقوم النظام بتسجيل وقت الانتهاء الفعلي، خصم خامات الجلسة من المخزن، وإصدار رابط التقييم للعميل.
يمكنك من نفس البطاقة تحصيل الدفعات بأي عملة أو طباعة الفاتورة الحرارية (Thermal 80mm) أو A4.

💡 مميزات وقواعد ذكية في هذه الشاشة:

تتبع كامل لدورة حياة الحجز (Pending → Confirmed → InProgress → Completed / Cancelled / NoShow).
تطبيق آلي لسياسة رسوم الإلغاء المتأخر أو عدم الحضور (No-Show) حسب إعدادات المركز.

Daily Bookings Board & Session Lifecycle Management

Screen Purpose: Visual room-by-room daily schedule board displaying all appointments, assigned therapists, session statuses, and payment progress.

Step-by-Step Daily User Instructions:

Open 'Bookings' and select the branch and date to view the room-by-room schedule board.
Click any appointment card to open its control panel, where you can Confirm, Start Session when the guest enters the room, or Complete Session.
Completing a session automatically triggers inventory material consumption and generates the customer's rating link.
Collect deposits/payments or print Thermal 80mm / A4 invoices directly from the booking details view.

💡 Key Capabilities & Smart Rules:

End-to-end lifecycle tracking (Pending → Confirmed → InProgress → Completed / Cancelled / NoShow).
Automated late-cancellation and no-show fee calculation when policy rules are enabled.

الواجهة العربية (Arabic RTL) — لوحة إدارة الحجوزات اليومية ومتابعة حالات الجلسات /Bookings

English Interface (LTR) — Daily Bookings Board & Session Lifecycle Management /Bookings

الخطوة 23 / Step 23 👤 موظف الاستقبال (Receptionist) | Receptionist

/Waitlist

قائمة الانتظار الذكية والتنبيه التلقائي عند خلو المواعيد

الهدف من الشاشة: تسجيل طلبات العملاء الذين رغبوا في الحجز في وقت مزدحم، ليقوم النظام بإرسال إشعار فوري للاستقبال بمجرد إلغاء أو تعديل أي حجز يوفر موعداً مناسباً لهم.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

يمنع ضياع أي فرصة بيع أو عميل بسبب ازدحام أوقات الذروة.
يعمل آلياً في الخلفية فور حدوث أي إلغاء.

Smart Customer Waitlist & Slot-Free Notifications

Screen Purpose: Log guests requesting unavailable peak slots; the system automatically alerts reception the moment a matching slot frees up.

Step-by-Step Daily User Instructions:

When a requested time slot is full, open 'Waitlist' and add a waitlist entry.
Select the customer, branch, service, date, and preferred time window (e.g., 17:00 to 20:00).
Whenever a booking is cancelled, the background engine scans the waitlist and sends an instant notification to reception if a match is found.
Reception contacts the guest and converts the waitlist entry into a confirmed booking.

💡 Key Capabilities & Smart Rules:

Maximizes room occupancy by immediately filling last-minute cancellations.
Automated background matching with instant SignalR reception alerts.

الواجهة العربية (Arabic RTL) — قائمة الانتظار الذكية والتنبيه التلقائي عند خلو المواعيد /Waitlist

English Interface (LTR) — Smart Customer Waitlist & Slot-Free Notifications /Waitlist

الخطوة 24 / Step 24 👤 الأخصائي / المعالج وكافة الموظفين (Therapists & All Employees) | Therapists, Specialists & All Staff Members

/My

البوابة الذاتية للموظف والأخصائي (بوابتي / My Portal)

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

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

خصوصية تامة: يرى كل موظف بياناته وجلساته هو فقط.
تغني الأخصائيين عن التزاحم أمام مكتب الاستقبال للسؤال عن جدول الجلسات.

Employee & Therapist Self-Service Portal (My Portal)

Screen Purpose: Personal workspace for every employee to view their assigned sessions, attendance punches, leave requests, commissions, and payslips.

Step-by-Step Daily User Instructions:

Staff members sign in and open 'My portal' (/My).
Therapists see their active and upcoming sessions for today, including room codes, service names, and start/end times.
Employees can submit new leave requests, track approval status, and review their personal attendance punches.
Displays personal sales targets, earned commissions, and approved monthly payslips.

💡 Key Capabilities & Smart Rules:

Strict privacy: each employee accesses only their own schedule and HR records.
Eliminates front-desk congestion by giving therapists live mobile access to their session queue.

الواجهة العربية (Arabic RTL) — البوابة الذاتية للموظف والأخصائي (بوابتي / My Portal) /My

English Interface (LTR) — Employee & Therapist Self-Service Portal (My Portal) /My

الخطوة 25 / Step 25 👤 المالك / مدير الشركة / مدير الفرع (Owner / Company Admin / Branch Manager) | Owner / Company Admin / Branch Manager

/Owner/Live

شاشة متابعة الفروع مباشر (Live Branch Monitor)

الهدف من الشاشة: غرفة عمليات حية تعرض للمالك ومدير الفرع حالة كل غرفة في هذه اللحظة (مشغولة / متاحة / صيانة)، الجلسات الجارية، الأخصائيين المتواجدين، وحركة الكاشير في كافة الفروع.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

تمنح المالك رؤية لحظية شاملة وكأنه متواجد داخل كل فرع بنفسه.
تساعد الاستقبال ومدير الفرع على التوجيه السريع للعملاء القادمين بدون موعد (Walk-ins).

Real-Time Live Branch Operations Monitor

Screen Purpose: Live command center displaying real-time room occupancy, in-progress treatments, therapists on duty, and active cash shifts across branches.

Step-by-Step Daily User Instructions:

Open 'Live branch' under Operations for a real-time bird's-eye view of the spa.
Monitor room cards color-coded by live state (Available vs. In-Progress session with remaining time).
Check which therapists have punched in today and who is currently occupied vs. free.
Switch between branches effortlessly to supervise multi-branch operations remotely.

💡 Key Capabilities & Smart Rules:

Gives owners complete remote visibility into live floor operations.
Helps branch managers immediately accommodate walk-in guests.

الواجهة العربية (Arabic RTL) — شاشة متابعة الفروع مباشر (Live Branch Monitor) /Owner/Live

English Interface (LTR) — Real-Time Live Branch Operations Monitor /Owner/Live

الخطوة 26 / Step 26 👤 موظف الاستقبال والكاشير / المحاسب (Reception / Cashier / Accountant) | Receptionist / Cashier / Accountant

/Pos

نقطة البيع والكاشير السريع والتحصيل متعدد العملات (POS & Cashier)

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (نقطة البيع والكاشير) لاستعراض الحجوزات الجارية أو المنتظرة السداد في الفرع.
اختر الحجز المطلوب تحصيله، وحدد وسيلة الدفع (كاش، بطاقة بنكية، إنستاباي، أو تحويل بنكي).
اختر عملة الدفع التي يدفع بها العميل (مثلاً USD أو EUR أو SAR أو EGP)؛ سيقوم النظام فوراً بحساب المعادل بالعملة الأساسية حسب سعر الصرف اليومي.
يمكنك تحصيل دفعة جزئية (عربون) أو تقسيم الفاتورة (مثلاً 200 كاش + 300 فيزا) وطباعة إيصال الدفع والفاتورة الضريبية فوراً.

💡 مميزات وقواعد ذكية في هذه الشاشة:

ميزة تنافسية كبرى للمراكز السياحية والفندقية: تحصيل متعدد العملات ومتعدد الوسائل في نفس الفاتورة.
يربط كل عملية تحصيل تلقائياً بوردية الكاشير المفتوحة وبنظام عمولات المبيعات.

POS & Multi-Currency Cashier Terminal

Screen Purpose: High-speed cashier terminal for settling bookings and packages, supporting foreign currencies (EGP, USD, EUR, SAR) and split payments across Cash, Card, Instapay, and Bank Transfer.

Step-by-Step Daily User Instructions:

Open 'POS & Cashier' to view all unsettled or partially paid bookings for the day.
Select a booking, choose the payment method (Cash, Card, Instapay, Transfer), and enter the amount.
Select the payment currency (EGP, USD, EUR, SAR); the system automatically converts the amount to base currency using the active FX rate.
Supports partial deposits, split payments across multiple methods/currencies, and instant receipt/invoice printing.

💡 Key Capabilities & Smart Rules:

Major advantage for tourist & hotel spas: seamless multi-currency and split-tender checkout.
Every payment automatically updates the open cash shift and triggers sales commission accrual.

الواجهة العربية (Arabic RTL) — نقطة البيع والكاشير السريع والتحصيل متعدد العملات (POS & Cashier) /Pos

English Interface (LTR) — POS & Multi-Currency Cashier Terminal /Pos

الخطوة 27 / Step 27 👤 موظف الاستقبال / مسؤول المبيعات (Reception / Sales) | Receptionist / Sales Agent

/Packages/Sell

بيع الباقات للعملاء ومتابعة أرصدة الجلسات المتبقية

الهدف من الشاشة: شاشة مخصصة لبيع باقات الجلسات للعملاء، تحصيل قيمتها بأي عملة، ومتابعة الرصيد المتبقي لكل عميل من الجلسات وتاريخ صلاحيتها، مع إمكانية نقل الباقة أو استردادها وفق سياسة المركز.

خطوات العمل للمستخدم اليومي:

انتقل إلى شاشة (بيع باكدج) من قسم التشغيل.
اختر العميل، الفرع، والباقة المطلوبة (مثل باقة الاسترخاء الملكي أو باقة العروسة VIP).
حصّل قيمة الباقة (نقداً أو بالبطاقة وبأي عملة)، فيصدر النظام رقم عقد باقة مميز (مثل PKG-1001) ويفتح رصيد جلسات للعميل.
عندما يحجز العميل أي جلسة لاحقاً، يظهر رصيده المتبقي تلقائياً ليتم الخصم من الباقة بدلاً من مطالبته بالدفع.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يدعم الدفع الكامل أو دفع عربون للباقة حسب إعدادات المركز، كما يدعم استرداد الرصيد المتبقي أو تحويل الباقة لعميل آخر.
يمنح موظف المبيعات عمولته تلقائياً فور تحصيل قيمة الباقة.

Sell Packages & Track Customer Session Balances

Screen Purpose: Sell multi-session packages to customers, collect multi-currency payments, and monitor remaining session balances and expiry dates.

Step-by-Step Daily User Instructions:

Navigate to 'Sell package' under Operations.
Select the customer, branch, and desired package.
Record the payment in any currency to issue a numbered package contract (e.g., PKG-1001) and credit the customer's session balances.
Future bookings for that customer automatically deduct sessions from their active package balance.

💡 Key Capabilities & Smart Rules:

Supports configurable minimum deposit rules, package balance refunds, and customer-to-customer transfers.
Automatically credits sales commissions upon package payment collection.

الواجهة العربية (Arabic RTL) — بيع الباقات للعملاء ومتابعة أرصدة الجلسات المتبقية /Packages/Sell

$بيع الباقات للعملاء ومتابعة أرصدة الجلسات المتبقية$

English Interface (LTR) — Sell Packages & Track Customer Session Balances /Packages/Sell

الخطوة 28 / Step 28 👤 مدير الفرع / مدير الشركة (Branch Manager / Company Admin) | Branch Manager / Company Admin

/Ratings

تقييمات وآراء العملاء للمكان والخدمة والأخصائيين

الهدف من الشاشة: استعراض تقييمات العملاء الحقيقية (من 1 إلى 5 نجوم) لمستوى نظافة وهدوء المكان، جودة الخدمة، وأداء الأخصائي، مع تعليقاتهم النصية بعد انتهاء الجلسة.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

تقييمات موثقة مرتبطة بحجوزات حقيقية مكتملة فقط لمنع أي تقييمات وهمية.
تقييم منفصل للمكان، للخدمة، ولكل معالج شارك في الجلسة.

Verified Customer Ratings & Reviews

Screen Purpose: Monitor verified post-session customer star ratings (1–5 stars) for venue ambiance, service quality, and individual therapist performance.

Step-by-Step Daily User Instructions:

Upon session completion, guests receive a unique time-limited rating link.
Guests rate the venue, service, and therapist from 1 to 5 stars and leave written feedback.
Managers open 'Ratings' to review feedback and track therapist quality scores.
Enables data-driven quality control and performance bonus rewards for top-rated therapists.

💡 Key Capabilities & Smart Rules:

100% verified reviews tied strictly to completed bookings.
Separate star ratings for Venue, Service, and Individual Therapist.

الواجهة العربية (Arabic RTL) — تقييمات وآراء العملاء للمكان والخدمة والأخصائيين /Ratings

English Interface (LTR) — Verified Customer Ratings & Reviews /Ratings

الخطوة 29 / Step 29 👤 أمين المخزن / مدير المشتريات (Storekeeper / Purchasing) | Storekeeper / Purchasing Manager

/Items

دليل الأصناف والخامات والزيوت ومستلزمات السبا

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الأصناف / Items) من داخل شاشة المخازن.
أضف الصنف بكود SKU مميز ورقم الباركود والاسم بالعربية والإنجليزية.
حدد وحدة القياس (زجاجة، كجم، قطعة، علبة) وحد الأمان الأدنى (Min Stock) لتنبيهك قبل نفاد الصنف.
يمكنك ربط الأصناف بالخدمات ليتم خصم الكمية المستهلكة تلقائياً مع كل جلسة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يدعم الباركود وتعدد وحدات القياس وتصنيف الخامات.
تنبيهات فورية عند وصول رصيد أي مخزن للحد الأدنى.

Inventory Items & Consumables Catalog

Screen Purpose: Master catalog of all spa consumables, oils, linens, and spare parts with SKU, barcode, unit of measure, and min/max stock thresholds.

Step-by-Step Daily User Instructions:

Open the Items catalog from the Inventory module.
Register each item with SKU, barcode, bilingual names, category, and unit of measure.
Set Minimum Stock alert thresholds so the system flags low-stock items automatically.
Link items to services for automatic per-session stock deduction.

💡 Key Capabilities & Smart Rules:

Supports barcode scanning, categorization, and min/max reorder alerts.
Seamless linkage to service Bill of Materials (BOM).

الواجهة العربية (Arabic RTL) — دليل الأصناف والخامات والزيوت ومستلزمات السبا /Items

English Interface (LTR) — Inventory Items & Consumables Catalog /Items

الخطوة 30 / Step 30 👤 أمين المخزن / المحاسب / مدير الفرع (Storekeeper / Accountant / Branch Manager) | Storekeeper / Accountant / Branch Manager

/Stock

أرصدة المخازن، تشغيلات الصلاحية (FEFO)، والتحويلات المخزنية

الهدف من الشاشة: متابعة الكميات المتوفرة وتكلفتها المتوسطة في كل مخزن (المخزن الرئيسي ومخزن المستهلكات بكل فرع)، تتبع تواريخ انتهاء الصلاحية للتشغيلات (Lots)، وإجراء التحويلات بين الفروع.

خطوات العمل للمستخدم اليومي:

انتقل إلى شاشة (المخازن) لاستعراض الأرصدة الحالية لكل صنف في مخازن الفروع وتكلفته المتوسطة.
يطبق النظام قاعدة (الأقرب انتهاءً يُصرف أولاً FEFO) على التشغيلات ذات تاريخ الصلاحية، وينبهك قبل انتهاء الصلاحية بـ 30 يوماً.
يمكن لأمين المخزن تسجيل إذن صرف، تسوية جردية، أو طلب تحويل بضاعة من فرع لآخر (/Transfers).
كل حركة مخزنية تُسجل في دفتر حركات غير قابل للحذف (Stock Movements Ledger) مع الرصيد بعد الحركة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

منع السحب بالسالب من المخزن (إلا إذا سمح المدير بذلك من الإعدادات).
حساب آلي للتكلفة المتوسطة المرجحة (Weighted Average Cost) لأغراض المحاسبة.

Warehouse Stock Balances, Expiry Lots (FEFO) & Transfers

Screen Purpose: Track real-time stock quantities, weighted-average costs, batch expiry dates (FEFO), and inter-branch stock transfers.

Step-by-Step Daily User Instructions:

Open 'Inventory' (/Stock) to view current quantities and weighted-average unit costs across branch warehouses.
Batches with expiry dates follow First-Expired-First-Out (FEFO) consumption and trigger expiry alerts in advance.
Execute stock issues, inventory adjustments, or cross-branch stock transfers (/Transfers) with ship/receive confirmation.
Every quantity change writes an immutable row in the Stock Movements ledger.

💡 Key Capabilities & Smart Rules:

Negative stock prevention (configurable) and automatic weighted-average cost calculation.
Full FEFO lot tracking for oils, serums, and perishable spa supplies.

الواجهة العربية (Arabic RTL) — أرصدة المخازن، تشغيلات الصلاحية (FEFO)، والتحويلات المخزنية /Stock

English Interface (LTR) — Warehouse Stock Balances, Expiry Lots (FEFO) & Transfers /Stock

الخطوة 31 / Step 31 👤 المحاسب / مدير المشتريات (Accountant / Purchasing) | Accountant / Purchasing Manager

/Suppliers

سجل الموردين وكشوف حساب الموردين وسداد المستحقات

الهدف من الشاشة: إدارة بيانات شركات التوريد، الرقم الضريبي، شروط السداد، ومتابعة كشف حساب كل مورد (فواتير التوريد مقابل الدفعات المسددة والرصيد المستحق).

خطوات العمل للمستخدم اليومي:

افتح شاشة (الموردون / Suppliers) من قسم المشتريات.
أضف بيانات المورد (الاسم، المسؤول، الهاتف، الرقم الضريبي، وفترة الائتمان بالأيام).
عند استلام أي بضاعة من المورد، يرتفع رصيد المديونية له تلقائياً في كشف حسابه.
عند سداد دفعة للمورد، يسجلها المحاسب فينخفض الرصيد المستحق ويظهر في قيود المحاسبة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

كشف حساب تفصيلي لكل مورد يوضح كل فاتورة توريد وكل دفعة مسددة.
تقييم جودة والتزام المورد (من 1 إلى 5 نجوم) عند كل استلام بضاعة.

Suppliers Directory & Accounts Payable Ledger

Screen Purpose: Manage supplier profiles, tax IDs, payment terms, and track supplier account balances (invoices vs. payments).

Step-by-Step Daily User Instructions:

Navigate to 'Suppliers' from the Purchasing module.
Add supplier contact details, tax registration number, and credit payment terms.
Goods receipts automatically credit the supplier's payable balance.
Record supplier payments to settle balances and generate corresponding accounting entries.

💡 Key Capabilities & Smart Rules:

Complete Accounts Payable sub-ledger per supplier.
Delivery quality and timeliness rating (1–5 stars) recorded on every goods receipt.

الواجهة العربية (Arabic RTL) — سجل الموردين وكشوف حساب الموردين وسداد المستحقات /Suppliers

English Interface (LTR) — Suppliers Directory & Accounts Payable Ledger /Suppliers

الخطوة 32 / Step 32 👤 أمين المخزن / مدير المشتريات / المحاسب (Storekeeper / Accountant) | Storekeeper / Purchasing / Accountant

/Purchases

أوامر الشراء، دورة الاعتماد، وأذون الاستلام المخزني (GRN)

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

خطوات العمل للمستخدم اليومي:

ينشئ أمين المخزن أو المشتريات (أمر شراء جديد) في شاشة (المشتريات) ويحدد المورد والمخزن والأصناف والكميات والأسعار.
يراجع المحاسب أو المدير أمر الشراء ويضغط (اعتماد Approve) — ويدعم النظام اشتراط اعتماد من شخص مختلف عن منشئ الطلب لمنع التلاعب.
عند وصول البضاعة، يسجل أمين المخزن (إذن استلام GRN) ويدخل الكميات المستلمة ورقم فاتورة المورد وتاريخ الصلاحية.
فور الاستلام، تزيد أرصدة المخزن تلقائياً وتتحدث التكلفة المتوسطة وكشف حساب المورد في خطوة واحدة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

رقابة داخلية صارمة: فصل بين منشئ طلب الشراء وبين معتمده (Segregation of Duties).
دعم الاستلام الجزئي على أكثر من دفعة لنفس أمر الشراء.

Purchase Orders, Dual Approval & Goods Receipt Notes (GRN)

Screen Purpose: End-to-end purchasing workflow from PO creation and financial approval to partial/full Goods Receipt (GRN) with lot/expiry entry.

Step-by-Step Daily User Instructions:

Create a new Purchase Order in 'Purchasing' specifying the supplier, target warehouse, items, quantities, and unit costs.
An authorized approver reviews and approves the PO (supports mandatory two-person segregation of duties).
Upon delivery, record a Goods Receipt Note (GRN) with received quantities, supplier invoice ref, and batch expiry dates.
Stock balances, weighted-average costs, and supplier payable ledgers update automatically upon receipt.

💡 Key Capabilities & Smart Rules:

Built-in Segregation of Duties (`purchase.require_second_approver`) preventing self-approval.
Supports partial deliveries and multiple GRNs per Purchase Order.

الواجهة العربية (Arabic RTL) — أوامر الشراء، دورة الاعتماد، وأذون الاستلام المخزني (GRN) /Purchases

English Interface (LTR) — Purchase Orders, Dual Approval & Goods Receipt Notes (GRN) /Purchases

الخطوة 33 / Step 33 👤 مهندس الصيانة / مدير الفرع (Maintenance Engineer / Branch Manager) | Maintenance Engineer / Branch Manager

/Equipment

سجل الأجهزة والمعدات والضمان وجداول الصيانة الوقائية الدورية

الهدف من الشاشة: حصر جميع أجهزة ومعدات السبا (مولدات البخار، الجاكوزي، وحدات الساونا، أجهزة الهايدرا فيشال، أسرّة المساج) ومتابعة فترة الضمان وجدولة الصيانة الوقائية الدورية.

خطوات العمل للمستخدم اليومي:

افتح شاشة (الأجهزة) من قسم البيانات الأساسية.
سجّل كل جهاز بالفرع والغرفة الموجود بها، الرقم التسلسلي (Serial)، تاريخ الشراء، وتاريخ انتهاء الضمان.
أضف (جدول صيانة وقائية) للجهاز (مثلاً: تنظيف فلاتر مولد البخار كل 30 يوماً، أو فحص مضخات الجاكوزي كل 15 يوماً).
يقوم النظام تلقائياً بفتح تذكرة صيانة وتنبيه مهندس الصيانة عند حلول موعد الصيانة الدورية قبل وقوع الأعطال!

💡 مميزات وقواعد ذكية في هذه الشاشة:

يحمي الأجهزة باهظة الثمن من الأعطال المفاجئة عبر الصيانة الوقائية المجدولة آلياً.
يربط الجهاز بالغرفة لتوضيح أثر أي عطل على جاهزية الغرفة.

Equipment Registry, Warranties & Preventive Maintenance Schedules

Screen Purpose: Track all spa machinery and equipment assets, serial numbers, warranty expiration dates, and automated preventive maintenance schedules.

Step-by-Step Daily User Instructions:

Open 'Equipment' under Basic Data.
Register each asset with branch, room location, serial number, purchase date, and warranty expiry.
Create Preventive Maintenance Schedules with recurring day intervals (e.g., every 15 or 30 days).
The background maintenance worker automatically generates maintenance tickets and alerts engineers when preventive service is due.

💡 Key Capabilities & Smart Rules:

Protects high-value spa equipment by automating recurring preventive maintenance tickets.
Links equipment directly to treatment rooms and spare-part inventory.

الواجهة العربية (Arabic RTL) — سجل الأجهزة والمعدات والضمان وجداول الصيانة الوقائية الدورية /Equipment

English Interface (LTR) — Equipment Registry, Warranties & Preventive Maintenance Schedules /Equipment

الخطوة 34 / Step 34 👤 موظف الاستقبال / مدير الفرع / مهندس الصيانة (All Branches & Maintenance) | Reception / Branch Manager / Maintenance Technician

/Requests

بلاغات الأعطال وطلبات الفروع ومتابعة مستوى الخدمة (SLA)

الهدف من الشاشة: نظام تذاكر مركزي لرفع بلاغات الأعطال وطلبات الفروع وتحديد أولويتها (حرجة، عالية، عادية)، إسنادها لمهندس الصيانة، صرف قطع الغيار، ومراقبة الالتزام بوقت الإصلاح المحدد (SLA).

خطوات العمل للمستخدم اليومي:

يرفع موظف الفرع طلب صيانة أو احتياج من شاشة (الطلبات والصيانة) ويحدد الجهاز المتعطل ودرجة الأهمية (Critical / High / Normal).
يحدد النظام تلقائياً الموعد النهائي للحل (SLA Due Time) — مثلاً 4 ساعات للأعطال الحرجة و24 ساعة للعالية.
يتلقى مهندس الصيانة إشعاراً فورياً، فيبدأ العمل على التذكرة، يضيف تعليقاته الميدانية، ويسجل أي قطع غيار تم سحبها من المخزن.
ترتب الشاشة الطلبات ذكياً حسب خطورة البلاغ وأهمية الفرع لضمان سرعة الاستجابة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

حساب آلي لمؤشرات الالتزام بوقت الإصلاح (SLA) وتنبيه الإدارة عند تأخر أي بلاغ حرج.
خصم قطع الغيار المستخدمة في الإصلاح مباشرة من المخزن.

Branch Requests, Maintenance Tickets & SLA Tracking

Screen Purpose: Centralized ticketing system for maintenance and branch requests with priority-based SLA timers, technician assignment, comments, and spare-part consumption.

Step-by-Step Daily User Instructions:

Branch staff open 'Requests & maintenance' to submit a ticket with priority level (Critical, High, Normal, Low) and affected equipment.
The system automatically computes the SLA deadline (e.g., 4 hours for Critical, 24 hours for High).
Maintenance engineers receive instant notifications, update ticket status to In-Progress, log field comments, and record consumed spare parts.
Tickets are prioritized by urgency and branch priority weight until resolved and closed.

💡 Key Capabilities & Smart Rules:

Automated SLA deadline tracking with overdue visual alerts.
Direct spare-part deduction from warehouse stock onto the maintenance ticket.

الواجهة العربية (Arabic RTL) — بلاغات الأعطال وطلبات الفروع ومتابعة مستوى الخدمة (SLA) /Requests

English Interface (LTR) — Branch Requests, Maintenance Tickets & SLA Tracking /Requests

الخطوة 35 / Step 35 👤 مدير المبيعات / مدير الشركة + المندوبون (Sales Manager & Field Agents) | Sales Manager / Company Admin & Field Agents

/Field/Map

خريطة تتبع المندوبين المباشرة عبر الـ GPS (Live Agents Map)

الهدف من الشاشة: خريطة تفاعلية حية تعرض مواقع مندوبي التسويق والمبيعات الخارجيين المتواجدين في الفنادق والمنتجعات السياحية لحظة بلحظة مع تنبيه فوري عند انقطاع إشارة الموقع.

خطوات العمل للمستخدم اليومي:

يبدأ المندوب الخارجي ورديته الميدانية من هاتفه، فيقوم المتصفح بإرسال إحداثيات موقعه الجغرافي (GPS) دورياً طالما الجلسة مفتوحة.
يفتح المدير شاشة (خريطة المندوبين) ليرى دبابيس (Pins) حية بموقع كل مندوب حالياً في الإسكندرية أو الغردقة ودقة الإشارة.
إذا توقف هاتف المندوب عن إرسال الموقع لأكثر من المدة المحددة (مثلاً 10 دقائق)، يظهر تنبيه للمشرف فوراً.
يحذف النظام سجل المواقع القديم تلقائياً بعد فترة الاحتفاظ المحددة حفاظاً على الخصوصية ومساحة القاعدة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

مثالي لمتابعة مندوبي تسويق السبا في الفنادق والشواطئ والمنتجعات السياحية.
يعمل مباشرة من متصفح الهاتف بدون الحاجة لتثبيت أجهزة تتبع خارجية.

Live Field Agents GPS Tracking Map

Screen Purpose: Interactive real-time map tracking on-duty outdoor marketing and sales agents across hotels and resorts with stale-signal alerts.

Step-by-Step Daily User Instructions:

Field agents start an active duty session on their phone to stream periodic GPS coordinates.
Supervisors open 'Agents map' (/Field/Map) to view live interactive markers showing each agent's location, accuracy, and last-seen time.
If an on-duty agent stops reporting location beyond `field.stale_minutes`, supervisors receive an automatic alert.
Location history is automatically purged after the configured retention period.

💡 Key Capabilities & Smart Rules:

Ideal for supervising outdoor hotel/resort spa promoters and sales representatives.
Works natively via mobile browser geolocation with automatic privacy retention cleanup.

الواجهة العربية (Arabic RTL) — خريطة تتبع المندوبين المباشرة عبر الـ GPS (Live Agents Map) /Field/Map

English Interface (LTR) — Live Field Agents GPS Tracking Map /Field/Map

الخطوة 36 / Step 36 👤 الموظفون / مدير الموارد البشرية / مدير الفرع (Staff / HR / Branch Manager) | Employees / HR Manager / Branch Manager

/Leave

إدارة طلبات الإجازات والاعتمادات (سنوية، مرضية، بدون أجر)

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

خطوات العمل للمستخدم اليومي:

يقدم الموظف طلب الإجازة من بوابته (/My) أو يضيفه مسؤول الموارد البشرية من شاشة (الإجازات).
يحسب النظام عدد أيام الإجازة الفعلية تلقائياً بعد استبعاد يوم الإجازة الأسبوعية للفرع (مثلاً الجمعة).
يراجع المدير الطلب ويضغط (موافقة Approve) أو (رفض Reject) مع كتابة ملاحظة القرار.
عند اعتماد إجازة لموظف، يمنع النظام حجز أي جلسات له في أيام إجازته، وإذا كانت الإجازة بدون أجر تُخصم تلقائياً في مسير الرواتب.

💡 مميزات وقواعد ذكية في هذه الشاشة:

تكامل ذكي: الإجازة المعتمدة توقف جدول الحجوزات للأخصائي في تلك الأيام وتسمح في الرواتب تلقائياً.
شفافية كاملة في أسباب القبول أو الرفض.

Employee Leave Requests & Approval Workflow

Screen Purpose: Submit, review, and approve/reject employee leave requests (Annual, Sick, Unpaid) with automatic working-day calculation.

Step-by-Step Daily User Instructions:

Employees request leave via '/My' or HR logs it in 'Leave' (/Leave) specifying type, date range, and reason.
The system automatically calculates working days excluding the branch's configured weekly off-day.
Managers approve or reject requests with a decision note.
Approved leaves automatically block therapist booking availability during those dates and deduct unpaid leave days in payroll.

💡 Key Capabilities & Smart Rules:

Smart integration: approved leave automatically blocks booking slots and feeds unpaid day deductions into payroll.
Full audit trail of request and decision notes.

الواجهة العربية (Arabic RTL) — إدارة طلبات الإجازات والاعتمادات (سنوية، مرضية، بدون أجر) /Leave

English Interface (LTR) — Employee Leave Requests & Approval Workflow /Leave

الخطوة 37 / Step 37 👤 مدير الموارد البشرية / مدير الفرع (HR Manager / Branch Manager) | HR Manager / Branch Manager

/Adjustments

المكافآت والحوافز والجزاءات والخصومات الشهرية

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (المكافآت والجزاءات) من قسم الموارد البشرية.
اختر الموظف، نوع التسوية (مكافأة Bonus / جزاء Penalty / خصم سلفة Deduction)، المبلغ، شهر الراتب، والسبب.
راجع التسويات المعلقة واضغط (اعتماد) لتدخل تلقائياً في حساب راتب الشهر المحدد.
بمجرد صرفها في مسير رواتب معتمد، تُغلق التسوية وتُربط برقم المسير لمنع تكرار صرفها أو خصمها.

💡 مميزات وقواعد ذكية في هذه الشاشة:

دورة اعتماد واضحة تمنع إضافة أي خصم أو مكافأة عشوائية بدون سبب موثق.
تظهر مفصلة في قسيمة راتب الموظف (Payslip).

Monthly Payroll Bonuses, Penalties & Deductions

Screen Purpose: Record and approve monthly employee bonuses, administrative penalties, and loan/advance deductions for automatic inclusion in payroll.

Step-by-Step Daily User Instructions:

Open 'Adjustments' under Human Resources.
Select the employee, adjustment kind (Bonus, Penalty, Deduction), amount, target payroll month, and reason.
Approve pending adjustments so the payroll calculator includes them automatically.
Once consumed by an approved payroll run, adjustments are locked and linked to that run ID.

💡 Key Capabilities & Smart Rules:

Approval workflow ensures all bonuses and penalties are documented and authorized.
Itemized clearly on the employee's monthly payslip.

الواجهة العربية (Arabic RTL) — المكافآت والحوافز والجزاءات والخصومات الشهرية /Adjustments

English Interface (LTR) — Monthly Payroll Bonuses, Penalties & Deductions /Adjustments

الخطوة 38 / Step 38 👤 مدير المبيعات / المحاسب / مدير الشركة (Sales Manager / Accountant / Admin) | Sales Manager / Accountant / Company Admin

/Sales

مجموعات المبيعات وشرائح العمولات التصاعدية والأهداف الشهرية

الهدف من الشاشة: إدارة نظام تحفيز المبيعات عبر تعريف مجموعات العمولات، شرائح تحقيق الهدف (Tiers)، تحديد التارجت الشهري لكل موظف، ومتابعة العمولات المكتسبة تلقائياً مع كل عملية تحصيل.

خطوات العمل للمستخدم اليومي:

افتح شاشة (المبيعات والعمولات) من قسم الحسابات.
أنشئ مجموعة مبيعات بنسبة عمولة أساسية (مثلاً 10%)، وحدد شرائح التحقيق (مثلاً: تحقيق 80% من التارجت يصرف 100% من العمولة، وتحقيق 100% يصرف 125% بونص!).
عيّن الهدف الشهري (Target) لكل موظف مبيعات أو أخصائي.
مع كل دفعة مالية تُحصل من العميل، يحسب النظام العمولة تلقائياً (ويخصمها عكسياً في حال الاسترداد Refund) ويحولها لمسير الرواتب.

💡 مميزات وقواعد ذكية في هذه الشاشة:

محرك عمولات ذكي يدعم الشرائح التصاعدية (Tiers) ويربط العمولة بالتحصيل الفعلي.
ينقل العمولات المستحقة تلقائياً إلى كشف راتب الموظف.

Sales Groups, Tiered Commission Rules & Monthly Targets

Screen Purpose: Configure sales groups, achievement-based payout tiers, and monthly employee targets, and track real-time commission accruals.

Step-by-Step Daily User Instructions:

Navigate to 'Sales & commission' under Accounting.
Create Sales Groups with a base commission % and configure achievement tiers (e.g., >=80% target pays 100% commission; >=100% target pays 125%!).
Assign monthly revenue targets per employee.
Every collected payment automatically accrues commission (and refunds automatically reverse it), flowing directly into monthly payroll.

💡 Key Capabilities & Smart Rules:

Tiered achievement multipliers motivate staff to exceed monthly revenue targets.
Strictly tied to collected cash/card payments with automatic reversal on refunds.

الواجهة العربية (Arabic RTL) — مجموعات المبيعات وشرائح العمولات التصاعدية والأهداف الشهرية /Sales

English Interface (LTR) — Sales Groups, Tiered Commission Rules & Monthly Targets /Sales

الخطوة 39 / Step 39 👤 مدير الموارد البشرية / المحاسب / مدير الشركة (HR / Accountant / Admin) | HR Manager / Accountant / Company Admin

/Payroll

مسير الرواتب الآلي وكشوف المرتبات التفصيلية (Automated Payroll)

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (الرواتب) واختر الفرع والشهر المطلوب واضغط (إنشاء مسير رواتب).
يقوم محرك الرواتب آلياً بجمع كافة بيانات الشهر من (جدول الورديات + سجل البصمة + الإجازات + المكافآت والجزاءات + العمولات + البقشيش).
اضغط على المسير لفتح (كشوف المرتبات التفصيلية Payslips) ومراجعة كل رقم لكل موظف بدقة.
بعد المراجعة، يعتمد المدير المالي المسير (Approve) ليصبح نهائياً وجاهزاً للصرف وتصدير قيده المحاسبي.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يوفر أياماً كاملة من الحسابات اليدوية على شيتات الإكسيل ويمنع الأخطاء البشرية.
يدعم الحساب الاختياري للتأمينات الاجتماعية وشرائح ضريبة الدخل حسب إعدادات محاسب الشركة.

Automated Monthly Payroll Run & Detailed Payslips

Screen Purpose: One-click monthly payroll generation combining basic salary, allowances, bonuses, commissions, tips, and overtime while deducting absences, late arrivals, penalties, social insurance, and income tax.

Step-by-Step Daily User Instructions:

Open 'Payroll', select the branch and month, and click to generate a new Payroll Run.
The PayrollCalculator automatically aggregates attendance punches, roster shifts, unpaid leaves, bonuses/penalties, tiered commissions, tips, and optional statutory tax/insurance.
Click into the run to inspect itemized employee Payslips (Basic, Allowances, Bonuses, Commissions, Tips, Deductions, Net Pay).
Approve the run (supports two-person approval rule) to lock the payslips and enable accounting journal export.

💡 Key Capabilities & Smart Rules:

Replaces error-prone spreadsheets with a single-click automated payroll engine.
Includes configurable statutory social insurance and progressive income tax bracket calculators.

الواجهة العربية (Arabic RTL) — مسير الرواتب الآلي وكشوف المرتبات التفصيلية (Automated Payroll) /Payroll

English Interface (LTR) — Automated Monthly Payroll Run & Detailed Payslips /Payroll

الخطوة 40 / Step 40 👤 المحاسب المالي / المدير المالي (Accountant / CFO) | Accountant / Financial Controller

/Accounting

دليل الحسابات وتصدير القيود المحاسبية اليومية (Accounting & Journals)

الهدف من الشاشة: إدخال شجرة الحسابات الخاصة بالشركة وتصدير قيود اليومية المحاسبية المجمعة (المبيعات، التحصيل، الباقات المؤجلة، تكلفة الخامات المستهلكة، المشتريات، والرواتب) بصيغة جاهزة لأي برنامج محاسبي.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

يغني المحاسب عن إعادة إدخال فواتير المبيعات والمخازن والرواتب يدوياً في البرامج المحاسبية.
يدعم محاسبة الإيرادات المؤجلة للباقات (Deferred Package Revenue) بدقة معيارية.

Chart of Accounts & Automated Accounting Journal Export

Screen Purpose: Manage your company's Chart of Accounts and export balanced double-entry journal vouchers for revenue, collections, deferred packages, COGS, purchasing, and payroll.

Step-by-Step Daily User Instructions:

Open 'Accounting (optional)' under the Accounting menu.
Define your Chart of Accounts codes and bilingual names (Asset, Liability, Equity, Revenue, Expense).
Select a date range to generate and export balanced journal entries covering cash/card collections, service revenue, package recognition, COGS, supplier invoices, and payroll runs.
Import the exported CSV/journal file directly into your external ERP or general ledger software.

💡 Key Capabilities & Smart Rules:

Eliminates manual re-keying of operational transactions into external accounting software.
Supports accrual-based deferred revenue recognition as package sessions are redeemed.

الواجهة العربية (Arabic RTL) — دليل الحسابات وتصدير القيود المحاسبية اليومية (Accounting & Journals) /Accounting

English Interface (LTR) — Chart of Accounts & Automated Accounting Journal Export /Accounting

الخطوة 41 / Step 41 👤 المالك / مدير الشركة / مدير الفرع (Owner / Company Admin / Branch Manager) | Owner / Company Admin / Branch Manager

/

لوحة التحكم التنفيذية ومؤشرات الأداء اللحظية (Executive Dashboard)

الهدف من الشاشة: الشاشة الرئيسية للإدارة العليا تعرض ملخصاً فورياً لإيرادات اليوم والشهر، عدد الحجوزات ومعدل الإشغال، التنبيهات العاجلة، وأداء الفروع في نظرة واحدة.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

تحديث لحظي للإشعارات عبر تقنية SignalR وWebPush حتى لو كان المتصفح في الخلفية.
تصميم متجاوب بالكامل يعمل على الشاشات الكبيرة واللابتوب والتابلت والهواتف الذكية.

Executive Dashboard & Real-Time KPIs

Screen Purpose: Executive home screen summarizing today's revenue, active/completed bookings, room utilization, alerts, and branch performance at a glance.

Step-by-Step Daily User Instructions:

Upon signing in, the Executive Dashboard presents real-time KPIs for the current day and month.
Review collected revenue, active/completed session counts, and operational alerts.
Click the top-bar Bell icon (#bell) to view instant SignalR notifications or enable WebPush device alerts.
Toggle between Light Mode and Luxury Dark Mode anytime using the top-bar theme button.

💡 Key Capabilities & Smart Rules:

Real-time SignalR and WebPush notifications keep managers informed on the go.
Fully responsive glassmorphic UI supporting both Light and Dark themes.

الواجهة العربية (Arabic RTL) — لوحة التحكم التنفيذية ومؤشرات الأداء اللحظية (Executive Dashboard) /

English Interface (LTR) — Executive Dashboard & Real-Time KPIs /

الخطوة 42 / Step 42 👤 المالك / مدير الشركة / المحاسب (Owner / Admin / Accountant) | Owner / Company Admin / Accountant

/Reports

التقارير المالية والتشغيلية والتحليلية الشاملة

الهدف من الشاشة: منظومة تقارير تفصيلية لتحليل الإيرادات حسب الفرع والخدمة والعملة ووسيلة الدفع، إنتاجية الأخصائيين، معدلات إشغال الغرف، وأرصدة الباقات المؤجلة.

خطوات العمل للمستخدم اليومي:

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

💡 مميزات وقواعد ذكية في هذه الشاشة:

أرقام دقيقة مستخرجة مباشرة من الحركات الفعلية المحصلة والجلسات المنفذة.
مقارنة شاملة لأداء الفروع والخدمات.

Comprehensive Financial, Operational & Utilization Reports

Screen Purpose: Analytical reporting suite covering revenue by branch/service/currency/payment method, therapist productivity, room utilization, and deferred package liabilities.

Step-by-Step Daily User Instructions:

Open 'Reports' under Accounting.
Filter by date range and branch to analyze operational and financial performance.
Inspect revenue breakdowns by payment method and currency, top-performing services and therapists, and deferred package balances.
Empowers management with actionable insights for pricing, staffing, and expansion decisions.

💡 Key Capabilities & Smart Rules:

Real-time aggregation directly from verified payments and completed bookings.
Cross-branch performance benchmarking.

الواجهة العربية (Arabic RTL) — التقارير المالية والتشغيلية والتحليلية الشاملة /Reports

English Interface (LTR) — Comprehensive Financial, Operational & Utilization Reports /Reports

الخطوة 43 / Step 43 👤 مدير الشركة / المراجع الداخلي (Company Admin / Internal Auditor) | Company Admin / Security Auditor

/Audit

سجل التدقيق والرقابة الأمنية غير القابل للتعديل (Security Audit Log)

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

خطوات العمل للمستخدم اليومي:

افتح شاشة (سجل التدقيق) من قسم النظام والإعدادات.
ابحث باسم الجدول/الوحدة (مثلاً Booking أو Payment أو Employee) أو راجع أحدث التعديلات.
شاهد من قام بالتعديل ومتى وما هي القيم التي تغيرت بالضبط.
لا يمكن لأي مستخدم (حتى المدير نفسه) حذف أو تعديل سجل التدقيق لضمان أعلى درجات الشفافية والرقابة.

💡 مميزات وقواعد ذكية في هذه الشاشة:

يعمل تلقائياً على مستوى قاعدة البيانات (EF Core AuditInterceptor) دون إمكانية تجاوزه.
يحجب القيم السرية تلقائياً من الظهور في السجل.

Immutable Security Audit Trail

Screen Purpose: Tamper-evident audit log automatically recording every create, update, and delete action across the system with user ID, timestamp, and JSON field diffs.

Step-by-Step Daily User Instructions:

Navigate to 'Audit log' under System.
Filter or browse chronological records of all entity creations, modifications, and deletions.
Inspect the exact user, UTC timestamp, entity name, and JSON change payload.
Append-only interceptor architecture ensures audit records cannot be altered or deleted.

💡 Key Capabilities & Smart Rules:

Powered by an EF Core SaveChanges interceptor that captures changes automatically.
Sensitive fields marked with `[AuditIgnore]` are automatically redacted.

الواجهة العربية (Arabic RTL) — سجل التدقيق والرقابة الأمنية غير القابل للتعديل (Security Audit Log) /Audit

English Interface (LTR) — Immutable Security Audit Trail /Audit

الخطوة 44 / Step 44 👤 مالك المنصة السحابية (Platform Super-Admin — [email protected]) | Platform Super-Admin ([email protected])

/Tenants

لوحة مالك المنصة السحابية — إدارة الشركات والباقات والاشتراكات (SaaS)

الهدف من الشاشة: شاشة خاصة بمالك منصة SPA X كنظام سحابي (SaaS) لإنشاء شركات ومراكز سبا جديدة، تحديد باقة الاشتراك لكل شركة (Starter / Professional / Enterprise)، ومراقبة حدود الفروع والمستخدمين وتواريخ التجديد.

خطوات العمل للمستخدم اليومي:

يسجل مالك المنصة الدخول بحساب ([email protected]) ليفتح شاشة (الشركات / Tenants).
يمكنه إنشاء شركة جديدة في ثوانٍ؛ فيقوم النظام تلقائياً بتأسيس فروعها الافتراضية ومخازنها وهيكلها الوظيفي وحساب مديرها.
يتحكم مالك المنصة في باقة الاشتراك (Plan) وحالة الاشتراك (فترة تجريبية Trial، نشط Active، موقوف Suspended) وتاريخ انتهاء الاشتراك.
تعمل بوابة الحماية (SubscriptionGate) على إيقاف دخول الشركة تلقائياً عند انتهاء اشتراكها مع الحفاظ الكامل على بياناتها لحين التجديد.

💡 مميزات وقواعد ذكية في هذه الشاشة:

بنية سحابية حقيقية متعددة الشركات (Multi-Tenant SaaS) بعزل تام لبيانات كل شركة في قاعدة البيانات.
إدارة مرنة للباقات والحدود القصوى وتجديد الاشتراكات.

Multi-Tenant SaaS Platform Administration (Tenants & Plans)

Screen Purpose: Super-admin console for managing multi-tenant SaaS organizations, subscription plans (Starter, Professional, Enterprise), quotas, and renewal dates.

Step-by-Step Daily User Instructions:

Sign in as Platform Admin (`[email protected]`) to access the 'Tenants' console.
Provision a new spa company in seconds with automatic seeding of default branches, warehouses, positions, and company admin user.
Manage subscription plans (Starter, Professional, Enterprise), quota limits (max branches/users/employees/bookings), and expiration dates.
The `SubscriptionGate` middleware automatically enforces subscription status and plan quotas across all tenants.

💡 Key Capabilities & Smart Rules:

True multi-tenant SaaS architecture with strict global query filter isolation per `TenantId`.
Built-in plan quota enforcement and subscription lifecycle management.

الواجهة العربية (Arabic RTL) — لوحة مالك المنصة السحابية — إدارة الشركات والباقات والاشتراكات (SaaS) /Tenants

English Interface (LTR) — Multi-Tenant SaaS Platform Administration (Tenants & Plans) /Tenants

SPA X — Comprehensive User Manual

أولاً: الغرض من النظام وأقوى المميزات التنافسية | 1. System Purpose & Core Killer Features

ما هو نظام SPA X وما الهدف منه؟

What is SPA X and What is Its Purpose?

ثانياً: دليل أنواع المستخدمين والأدوار والصلاحيات وبيانات الدخول | 2. User Roles, Permissions & Demo Accounts

ثالثاً: الفهرس المتسلسل لخطوات العمل (من البداية حتى النهاية) | 3. Chronological Workflow Index

المرحلة الأولى: التهيئة الأولية وإعداد النظام والبيانات الأساسية

شاشة تسجيل الدخول الموحدة واختيار اللغة والمظهر

Unified Sign-In Screen, Language & Theme Switcher

دليل البدء السريع وقائمة التحقق الذكية (Getting Started)

Quick Setup & Operational Readiness Checklist

إدارة الفروع والعملات الأساسية والمناطق الزمنية

Branches, Base Currencies & Timezones Management

إدارة العملات وأسعار الصرف اليومية (Multi-Currency FX)

Multi-Currency & Daily Exchange Rates Management

مصفوفة الأدوار والصلاحيات الأمنية الدقيقة (42 صلاحية)

Role-Based Access Control (RBAC) Matrix — 42 Permissions

إدارة حسابات المستخدمين وربطهم بالفروع والأدوار

System Users & Branch Access Management

إعدادات النظام المتقدمة والسياسات والربط المشفر

Advanced Company/Branch Settings & Encrypted Integrations

الهيكل التنظيمي، الأقسام، المسميات الوظيفية، ومهارات الأخصائيين

Organization Structure: Departments, Positions & Therapy Skills

إدارة الموظفين والأخصائيين، المهارات، والبيانات المشفرة، ورمز البصمة

Employees & Therapists Directory, Skills, Kiosk PIN & Encrypted Data

إدارة الغرف والأجنحة العلاجية وسعتها وحالتها

Treatment Rooms, Suites, Capacity & Status Management

كتالوج الخدمات والجلسات، الأسعار، المهارات، والغرف، والخامات المستهلكة

Spa Services Catalog, Pricing, Required Skills, Rooms & Material BOM

تصميم باقات الجلسات والعضويات (ملكي / عروسة / VIP)

Multi-Session Packages & Memberships Design

إدارة العروض الترويجية والخصومات الموسمية

Promotional Offers & Seasonal Discounts

إنشاء روابط ورموز الاستجابة السريعة (QR Codes) للحجز الذاتي

QR Code Self-Booking Links Generator

المرحلة الثانية: بداية يوم العمل، الورديات، والحضور ببصمة الوجه

جدول توزيع الورديات الأسبوعي والشهري (Staff Roster)

Weekly & Monthly Staff Shift Roster

شاشة الكشك الذكي لتسجيل الحضور والانصراف ببصمة الوجه والـ PIN

Biometric Face Recognition & PIN Attendance Kiosk

سجل الحضور والانصراف وإدارة أجهزة البصمة والتعرف على الوجه

Attendance Logs, Verification Photos & Biometric Devices

فتح وإغلاق وردية الكاشير، جرد النقدية، وتوزيع البقشيش (Tips)

Cashier Shift Opening/Closing, Cash Drawer Count & Tips Distribution

المرحلة الثالثة: رحلة العميل، الحجز الذكي، وتنفيذ الجلسات

سجل العملاء (محليين وأجانب) وتفضيلات المعالجين وملف الزيارات

Customers Directory (Local & International) & Preferences

صفحة الحجز الذاتي الأونلاين للعميل عبر مسح رمز الـ QR

Public Customer Online Self-Booking Portal via QR

إنشاء حجز جديد عبر محرك منع التعارض الآلي (Smart Booking Engine)

Create New Booking with Zero-Conflict Engine

لوحة إدارة الحجوزات اليومية ومتابعة حالات الجلسات

Daily Bookings Board & Session Lifecycle Management

قائمة الانتظار الذكية والتنبيه التلقائي عند خلو المواعيد

Smart Customer Waitlist & Slot-Free Notifications

البوابة الذاتية للموظف والأخصائي (بوابتي / My Portal)

Employee & Therapist Self-Service Portal (My Portal)

شاشة متابعة الفروع مباشر (Live Branch Monitor)

Real-Time Live Branch Operations Monitor

المرحلة الرابعة: التحصيل المالي، تعدد العملات، الباقات، والتقييم

نقطة البيع والكاشير السريع والتحصيل متعدد العملات (POS & Cashier)

POS & Multi-Currency Cashier Terminal

بيع الباقات للعملاء ومتابعة أرصدة الجلسات المتبقية

Sell Packages & Track Customer Session Balances

تقييمات وآراء العملاء للمكان والخدمة والأخصائيين

Verified Customer Ratings & Reviews

المرحلة الخامسة: المخازن، المشتريات، الصيانة، وتتبع المندوبين

دليل الأصناف والخامات والزيوت ومستلزمات السبا

Inventory Items & Consumables Catalog

أرصدة المخازن، تشغيلات الصلاحية (FEFO)، والتحويلات المخزنية

Warehouse Stock Balances, Expiry Lots (FEFO) & Transfers

سجل الموردين وكشوف حساب الموردين وسداد المستحقات

Suppliers Directory & Accounts Payable Ledger

أوامر الشراء، دورة الاعتماد، وأذون الاستلام المخزني (GRN)

Purchase Orders, Dual Approval & Goods Receipt Notes (GRN)

سجل الأجهزة والمعدات والضمان وجداول الصيانة الوقائية الدورية

Equipment Registry, Warranties & Preventive Maintenance Schedules

بلاغات الأعطال وطلبات الفروع ومتابعة مستوى الخدمة (SLA)

Branch Requests, Maintenance Tickets & SLA Tracking