الرئيسية
دليل تشغيل النظام

دليل المالك · الإصدار الأول · سبتمبر ٢٠٢٦

دليل تشغيل النظام

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

01

إيه هو النظام

تلات مفاهيم بس — لو فهمتهم، فهمت النظام كله.

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

١ · الفرعجدار العزلكل صف بيانات بينتمي لفرع واحدوالموظف بيشوف فرعه بس — مش إخفاءفي الشاشة، ده مفروض في الداتابيز٢ · التذكرةرحلة الجهازمن الاستلام للتسليم، ٨ حالاتبتربط الفني بالقطع بالفاتورةوبتحدد عمولة الفني في الآخر٣ · الورديةوعاء الفلوسمفيش بيعة من غير وردية مفتوحةكل قرش بينتمي لورديةوالإقفال بيقارن المعدود بالمتوقعالمخزون والعملاء والموظفين والرواتب والتقارير — كلهم بيتعلقوا على التلاتة دول
لو حاجة مش شغالة، غالباً واحد من التلاتة ناقص: الموظف مش على الفرع الصح، أو التذكرة لسه في حالة مش سامحة، أو مفيش وردية مفتوحة.

إيه اللي بيشتغل عليه

النظام موقع بيتفتح من المتصفح — مفيش حاجة تتثبّت على أجهزة الفروع. عندك عنوانين:

  • العنوان الرئيسي — للمالك (السوبر أدمن). من هنا بتدير الفروع كلها.
  • عنوان لكل فرع — على شكل اسم-الفرع.النطاق. موظفو الفرع لازم يدخلوا من عنوان فرعهم، مش من العنوان الرئيسي.

البيانات كلها على سيرفر واحد مركزي. الطباعة دلوقتي من المتصفح (مقاس ٨٠مم) — الطابعة الحرارية المباشرة محتاجة برنامج صغير في كل فرع، وده مؤجَّل.

02

التأسيس — الترتيب إجباري

١٢ خطوة. الرسمة بتوضّح ليه الترتيب ده مش اقتراح.

١ · إعدادات المؤسسةالعملة · المنطقة الزمنية٢ · الفروعكل فرع بياخد عنوانه٣ · الأدوارتلاتة جاهزين أو أدوار من عندك٤ · الموظفونلازم فرع + دور٥ · حسابات الدخولحساب لكل موظف محتاج يدخل٦ · إعدادات كل فرعبادئة التذاكر والفواتير · الضريبةسعر الساعة · بداية الدوام٧ · كتالوج الأجهزةنوع · ماركة · موديل · لون٨ · المنتجات والموردونقطع الغيار والخدمات٩ · الأسعار والرصيدسعر لكل فرع + إدخال المخزونجاهز للتشغيلتفتح تذكرة ✓تفتح وردية وتبيع ✓تقفل وتطلع تقرير ✓
أكتر خطوتين بينساهم الناس: العملة (خطوة ١) — لو اتأجلت هتلاقي كل الأرقام بعملة غلط وهتصلّحها في كل شاشة. وأسعار الفرع (خطوة ٩) — من غيرها البيع بيقف عند أول صنف.
  1. 1

    ادخل بحساب المالكالعنوان الرئيسي

    حساب المالك (سوبر أدمن) موجود من التركيب. بيدخل من العنوان الرئيسي بدون اسم فرع.

    مهم: غيّر كلمة السر من /profile قبل أي حاجة تانية.

  2. 2

    الإعدادات العامة/settings

    العملة · المنطقة الزمنية. الاتنين دول بس — واسم المؤسسة مكانه الخطوة اللي بعدها.

    العملة والمنطقة الزمنية بيأثّروا على كل شاشة فيها فلوس أو وقت — اضبطهم الأول.

  3. 3

    هوية المؤسسة/settings/organization

    الاسم اللي بيظهر في القائمة الجانبية، والشعار، وبيانات ظهور الموقع في محركات البحث.

  4. 4

    أنشئ الفروع/branches

    لكل فرع اسم ومعرّف مختصر — والمعرّف ده هو اللي بيبقى عنوان دخول الفرع.

    اختاره بعناية: ده اللي موظفينك هيكتبوه كل يوم.

  5. 5

    راجع الأدوار/settings/roles

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

    انتبه: ولا واحد من التلاتة فيه صلاحيات موارد بشرية — راجع القسم ٠٤.

  6. 6

    أضف الموظفين/employees

    كل موظف بينتمي لفرع وله دور. الرقم القومي والتليفون مطلوبين، والكود بيتولّد تلقائياً.

  7. 7

    اعمل حسابات الدخول/employees/[الموظف]

    الموظف اللي محتاج يدخل النظام بتعمله حساب من صفحته. الموظف اللي مش بيدخل (زي عامل) بيفضل بغير حساب.

    ذكّرهم: بيدخلوا من عنوان فرعهم، والدخول من العنوان الرئيسي هيترفض.

  8. 8

    إعدادات كل فرع/settings/branch

    بادئة التذاكر · بادئة الفواتير · نسبة الضريبة · بداية الدوام بصيغة HH:MM (اللي بيتحسب عليها التأخير في تقارير الحضور) · وساعات العمل كوصف حر للعرض.

    الضريبة لو سيبتها فاضية بتاخد قيمة المؤسسة العامة.

  9. 9

    كتالوج الأجهزة/settings/catalog

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

  10. 10

    المنتجات والموردون/settings/inventory/products

    قطع الغيار والخدمات. حدّد الأصناف القابلة للبيع — دي اللي هتظهر في نقطة البيع.

  11. 11

    أسعار الفرع/settings/inventory/pricing

    السعر بيتحدد لكل فرع على حدة. لو سيبت الخانة فاضية، الفرع بياخد السعر الافتراضي للمنتج — والخانة الفاضية دي حالة صحيحة مش نسيان.

  12. 12

    أدخِل الرصيد الافتتاحي/inventory/purchase-orders

    أنشئ طلب شراء واستلمه، فالكميات تدخل المخزون بحركة مسجّلة. الرصيد بيظهر في /inventory/stock.

قبل ما تسيب الشاشة

لو حد هيشتغل على الحضور أو الرواتب، لازم تديله صلاحية الموارد البشرية من /settings/roles — مفيش دور جاهز فيه الصلاحية دي. من غيرها صفحات الموارد البشرية هتبقى مقفولة عليه.

03

الموديولات

كل موديول: بيعمل إيه، وشاشاته فين.

الصيانة

مين بيستخدمه: الاستقبال · الفني · مدير الفرع

قلب النظام. تذكرة لكل جهاز داخل، بتمشي في ٨ حالات من الاستلام للتسليم. بتسجّل حالة الجهاز وقت الاستلام (وده بيحميك من خلاف «الشاشة دي كانت مكسورة»)، وبتتربط بالفني، وبتسحب قطع من المخزون، وبتطلع فاتورة.

/tickets/tickets/new/tickets/[id]/customers

نقطة البيع والمالية

مين بيستخدمه: الكاشير · مدير الفرع

شاشة الكاشير خارج شكل النظام — ملء الشاشة بدون قوائم جانبية، عشان تتستخدم والعميل واقف مستني. بتبيع قطع وخدمات، بتقبض بأكتر من طريقة، وبتطلع إيصال.

وراها الفواتير والورديات: كل بيعة بتنتمي لوردية، والإقفال بيقارن النقدية المعدودة بالمتوقعة ويسجّل الفرق بدل ما يرفضه.

/pos/finance/invoices/finance/cash-sessions

المخزون

مين بيستخدمه: أمين المخزن · مدير الفرع

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

/inventory/stock/inventory/purchase-orders/inventory/transfers/inventory/movements

الموارد البشرية والرواتب

مين بيستخدمه: مدير الفرع · المحاسب · وكل موظف لنفسه

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

دورة الرواتب بتجمع الأساسي والعمولة والتسويات، ولما تتعتمد بتتقفل نهائياً — أي تصحيح بعد كده بيبقى بند في الدورة اللي بعدها.

/hr/attendance/hr/commission-rules/hr/payroll

التقارير والتدقيق

مين بيستخدمه: المالك · مدير الفرع

صورة موحّدة: التذاكر، المبيعات والمحصَّل، المخزون، والموارد البشرية — مع تصدير CSV. وسجل التدقيق بيجاوب على «مين عمل إيه وامتى» لأي تغيير في النظام.

/reports/settings/audit-logs
04

مين بيعمل إيه

الأدوار الجاهزة وصلاحياتها الفعلية — زي ما هي في النظام دلوقتي.

المالك — سوبر أدمنكل الفروع · الإدارة والإعدادات · كل صلاحية بحكم الهوية مش بحكم الدورمدير الفرعفرعه كامل: تذاكر · عملاء · موظفون · إعدادات · تقارير — بدون نقطة البيع والمخزونالكاشيركل ما عند المدير + نقطة البيع والوردياتالفني — التذاكر وحضوره فقط
لاحظ إن مدير الفرع مفيهوش نقطة بيع. ده مقصود — اللي بيقبض مش اللي بيعيّن. والمخزون للمالك وحده في الأدوار الجاهزة؛ لو عايز مدير الفرع يشوفه، اعمله دور فيه صلاحيات المخزون.
القدرةالمالكمدير فرعكاشيرفني
تذاكر الصيانة✓✓✓✓
العملاء✓✓✓—
نقطة البيع والورديات والفواتير✓—✓—
الموظفون والحسابات والأدوار✓✓✓—
كتالوج الأجهزة✓✓✓✓
أسعار الفرع✓✓✓—
المخزون: الرصيد والحركات والشراء والتحويلات✓———
إعدادات الفرع والطابعة✓✓✓—
التقارير وسجل التدقيق✓✓✓—
الحضور: تسجيل نفسه✓✓✓✓
الحضور والعمولات والرواتب: إدارة✓———
الفروع وإعدادات المؤسسة✓———
يشوف فروع تانية✓———
لازم تعمله بإيدك

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

مفيش دور جاهز فيه صلاحيات الموارد البشرية. يعني الحضور والعمولات والرواتب مقفولين على الكل ما عدا المالك. قبل أول شهر رواتب، روح /settings/roles وزوّد الصلاحيات دي على دور المحاسب أو مدير الفرع.

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

حاجة كل موظف بيعملها بدون أي صلاحية

تسجيل حضوره وانصرافه. ده مش امتياز — ده أول حاجة بيعملها لما يقعد. وبيشوف سجله هو بس؛ سجلات زمايله محتاجة صلاحية.

05

السيناريوهات اليومية

أربع رحلات بتغطّي ٩٠٪ من الشغل اليومي.

سيناريو ١ — جهاز داخل صيانة، من الباب للباب

الاستقباليفتح تذكرة ويوثّق الحالةالفنيتشخيص ← إصلاحقطع الغيارتتخصم من المخزونالفاتورةوالعميل يدفعالبوابة — التسليم مرفوض والرصيد > صفرمفيش طريقة تتخطاها من الشاشةالتسليم ✓والفني يستحق عمولته من هنالو العميل مش هيدفع دلوقتي — بتقبض عربون، والباقي بيفضل مستحق والجهاز عندك
البوابة دي أهم حاجة تشرحها لموظفينك. مش عطل ومش تعنّت — دي اللي بتمنع أقدم مشكلة في المحلات: جهاز خرج والحساب لسه مفتوح ومحدش فاكر.

سيناريو ٢ — يوم كاشير كامل

  1. 1

    افتح الوردية/finance/cash-sessions

    اكتب النقدية اللي في الدرج دلوقتي (الرصيد الافتتاحي). من غير وردية مفتوحة مفيش بيع.

  2. 2

    بِع من شاشة الكاشير/pos

    اختار الأصناف، طبّق خصم لو ليك صلاحية، اقبض، واطبع الإيصال.

  3. 3

    لو فيه مرتجع

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

  4. 4

    اقفل الوردية واطبع تقرير Z

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

سيناريو ٣ — موظف جديد من الصفر

  1. 1

    أضف الموظف/employees

    البيانات الأساسية + الفرع + الدور.

  2. 2

    اعمله حساب دخول

    من صفحة الموظف. اديله اسم مستخدم وكلمة سر مؤقتة، وقوله يغيّرها من /profile أول ما يدخل.

  3. 3

    لو هياخد عمولة/hr/commission-rules

    قاعدة على الدور بتغطي كل اللي فيه، وقاعدة على الشخص بتغلب قاعدة الدور. مفيش قاعدة = مفيش عمولة (مش خطأ).

  4. 4

    لو له راتب أساسي/employees/[الموظف]

    الأساسي بيتصوّر في كشف الراتب لحظة توليد الدورة.

سيناريو ٤ — شهر رواتب كامل

١ · ولّد مسودةأساسي + حضور + عمولة٢ · راجعوزوّد تسويات٣ · اعتمِدالأرقام بتتقفل نهائي٤ · أشّر الصرفتوثيق، مش حركة درجأي تصحيح بعد الاعتماد → الدورة اللي بعدها
قبل الاعتماد تقدر تعيد التوليد زي ما تحب — الأرقام بتتحدّث والتسويات بتفضل. بعد الاعتماد مفيش رجوع، وده مقصود: كشف اتصرف مايتعادش كتابته.
نصيحة تشغيل

قبل ما تعتمد، افتح /reports وقارن إجمالي العمولات بالمبيعات في نفس الفترة. لو فيه فرق كبير، غالباً موظف شغّال من غير قاعدة عمولة — وصفحة معاينة الاستحقاق بتعلّم عليه صراحةً.

06

قائمة التحقق قبل التشغيل

امشي عليها بالترتيب. لو كلها ✓ — النظام جاهز يستقبل أول جهاز.

وبعدين

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

07

اختبار النظام

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

قبل أي خطوة

موظف الفرع لازم يتجرّب من ساب‑دومين فرعه مش من الدومين الرئيسي — النظام بيعرف الفرع من العنوان، ومن الدومين الرئيسي مش هيعرفه. ولو شفت سلوك غريب، أول سؤال: أنا على أنهي دومين؟

اختبار المنع ليه نصّان

إخفاء اللينك راحة للمستخدم مش حماية. كل منع لازم يتجرّب تاني بكتابة العنوان في المتصفح. لو الشاشة فتحت — ده بلاغ حتى لو اللينك كان مخفي.

التقدّم0 من 169 خطوة

أ · التأسيس

من نظام فاضي لفرع شغّال.

ب · الأمان والصلاحيات

المجموعة اللي لو فشلت، الباقي مش مهم.

ج · التشغيل اليومي

الشغل اللي بيحصل كل يوم في الفرع.

د · المخزون

من الشراء للرصيد للتحويل بين الفروع.

هـ · البيع

الوردية والفاتورة والمرتجع.

و · الموارد البشرية

الحضور والعمولة والراتب.

ز · المراجعة

التقارير وسجل التدقيق.

ح · المتانة

الحاجات اللي بتكسر النظم.

لما تلاقي عيب

اكتب: الدومين بالظبط · اليوزر والدور · عملت إيه · توقعت إيه · حصل إيه · الوقت · وصورة للشاشة كاملة مع شريط العنوان. وافتح أدوات المطوّر (F12) ← تبويب Console وصوّر أي سطر أحمر — ده بيختصر نص وقت التشخيص.

حاجات معروفة — مش محتاجة بلاغ

ساب‑دومين فرع جديد ممكن يدّي تحذير شهادة لحد ١٥ دقيقة · أول فتحة بعد سكون بتاخد تانيتين · المخزون والرواتب لمدير النظام بس افتراضياً، وتحتاج تضيفهم لدور عشان تختبرهم بدور تاني.