# نظام المخزن — دليل التثبيت والاستخدام

## المتطلبات

- استضافة PHP ‏8.2 أو أحدث، إصدار 64 بت، مع إضافة pdo_mysql ودعم جلسات PHP.
- MySQL ‏8.0 أو أحدث، أو MariaDB ‏10.6 أو أحدث، مع InnoDB.
- بيانات مستخدم MySQL أو MariaDB واسم قاعدة مخصصة للنظام. ينشئ المثبّت القاعدة إذا كانت غير موجودة وكان المستخدم يملك صلاحية CREATE عليها. يحتاج المثبّت أيضًا إلى CREATE وREFERENCES للجداول، ويحتاج التشغيل إلى SELECT وINSERT وUPDATE.
- رابط HTTPS، وإذن مؤقت لمستخدم PHP بالكتابة في مجلد النظام حتى يحفظ إعدادات الاتصال.

## التثبيت

1. جهّز بيانات مستخدم MySQL أو MariaDB واختر اسمًا لقاعدة مخصصة للنظام. لو حسابك يسمح بإنشاء القواعد، يكفي إدخال الاسم في المثبّت. لو الاستضافة تقيّد ذلك، أنشئ قاعدة فارغة من لوحة الاستضافة واربط المستخدم بها. استخدم الأسماء الكاملة بما فيها أي بادئة تضيفها لوحة الاستضافة.
2. ارفع ملف ZIP وفكّه في مجلد مخصص داخل جذر موقعك، مثل public_html/inventory. تأكد أن index.php موجود مباشرة في المجلد الذي ستفتحه، واحذف نسخة ZIP من مجلد الويب بعد الفك.
3. افتح رابط HTTPS للمجلد، مثل https://example.com/inventory/ . عند إعداد عنوان عام، قيّد الوصول إلى المجلد من لوحة الاستضافة أثناء التثبيت حتى تنشئ حساب المدير.
4. أدخل مضيف قاعدة البيانات والمنفذ والاسم والمستخدم وكلمة المرور، ثم اسم المدير وكلمة مروره. المضيف الشائع localhost والمنفذ الشائع 3306. اضغط «تثبيت النظام».
5. سجّل الدخول بحساب المدير. يُغلق معالج التثبيت تلقائيًا بعد إنشاء config.local.php. حافظ على قراءة ملف الإعدادات من جانب PHP، وأزل إذن الكتابة المؤقت من مجلد النظام بعد التثبيت. لا ترفع نسخة من ملف الإعدادات إلى مكان عام.

## بدء العمل

- من «المخازن»، أضف مخزنًا واحدًا أو أكثر.
- من «الأصناف»، أدخل الرمز والاسم والوحدة وحد التنبيه لكل مخزن.
- من «الحركات»، سجّل التوريد أو الصرف أو التحويل. لتصحيح رصيد بعد جرد فعلي، يسجّل المدير «تسوية جرد» ويدخل الرصيد الفعلي الكامل وسبب التسوية.
- راجع الرصيد حسب المخزن من «الأرصدة»، أو اعرض الأصناف عند حد التنبيه أو أقل. يمكنك تنزيل الأرصدة وسجل الحركات بصيغة CSV حسب الفلاتر المحددة. أوقات السجل بتوقيت UTC.
- من «المستخدمون»، ينشئ المدير حسابات أمناء المخازن والمشاهدين، ويوقف الحسابات أو يعيد تعيين كلمات مرورها. أمين المخزن يسجّل التوريد والصرف والتحويل. المشاهد يستطيع الاطلاع والتصدير.
- احتفظ بنسخ احتياطية من قاعدة البيانات وملف config.local.php في مكان خاص. لاستعادة النسخة، استورد القاعدة واستعد ملفات النظام والإعدادات مع تحديث بيانات الاتصال عند الحاجة.

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