AssetHub الوثائق

نظرة عامة

AssetHub هو نظام كامل لإدارة أصول تكنولوجيا المعلومات، مبني على Laravel 11 وVue 3 وTailwind CSS. يساعد المؤسسات في تتبّع دورة حياة المعدات، وإدارة الإسنادات، وجدولة الصيانة، وحساب الإهلاك، وإنشاء تقارير مفصّلة.

متطلبات الخادم

• PHP 8.2 أو أعلى
• MySQL 5.7+ أو MariaDB 10.3+
• Composer 2.x
• Node.js 18+ وnpm 9+
• خادم ويب: Apache أو Nginx

ملحقات PHP المطلوبة

• OpenSSL, PDO, PDO_MySQL, Mbstring, Tokenizer, XML, Ctype, JSON, GD, Fileinfo

مساحة القرص

200 ميغابايت على الأقل تقريبًا. خصّص مساحة إضافية لصور الأصول ومرفقات الوثائق.

التثبيت

الخيار A — المثبّت الويب (موصى به)

1. ارفع ملفات المشروع إلى خادم الويب الخاص بك.
2. وجّه document root للنطاق إلى public/.
3. اضبط الصلاحيات: يجب أن تكون storage/ وbootstrap/cache/ قابلة للكتابة (chmod 775).
4. انسخ .env.example إلى .env ونفّذ php artisan key:generate.
5. افتح https://yourdomain.com/install في متصفحك.
6. اتبع المعالج — Requirements ← Database ← Migrate ← Admin Account ← Done.

الخيار B — التثبيت عبر CLI

# 1. تثبيت الاعتماديات
composer install --no-dev --optimize-autoloader
npm install
npm run build

# 2. ضبط البيئة
cp .env.example .env
php artisan key:generate

# 3. تحرير .env لإعداد بيانات DB
# DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD

# 4. إنشاء جداول قاعدة البيانات وزرع البيانات الأولية
php artisan migrate --seed

# 5. إنشاء storage symlink للتحميلات
php artisan storage:link

# 6. تخزين مؤقت للإعدادات للإنتاج
php artisan config:cache
php artisan route:cache
php artisan view:cache

# 7. التعليم كمثبّت
echo "Installed" > storage/installed.lock

Wizard Step 2 — Database Configuration

When the wizard reaches Step 2, you must enter the MySQL connection details for the database you created in your hosting panel. The database must already exist (it can be empty — the next wizard step will create the tables).

Where to find these credentials by hosting panel

• Hostinger: hPanel → Databases → Management → click your database. The page shows name, username, and a "Show password" button.
• cPanel: cPanel → MySQL Databases. The database list shows names; users are listed below. Use "Change Password" if needed.
• Plesk: Plesk → Databases → click the database name. The detail page shows credentials and offers a password reset.
• DirectAdmin: DirectAdmin → MySQL Management → click the database. Credentials and password reset are on the database detail page.
• External / managed DB: AWS RDS, DigitalOcean Managed Database, etc. Use the custom hostname, port (often 3306 but verify), DB name, user, and password from your cloud console. Make sure the server's IP is whitelisted in the DB firewall.

Common errors and how to fix them

الجهاز المحلي (التطوير المحلي)

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

الخيار 1 — Laravel Herd (موصى به، macOS و Windows)

Laravel Herd هي البيئة المحلية الرسمية من فريق Laravel — مجانية، أصلية، بدون Docker. تتضمّن PHP 8.2/8.3/8.4 وNginx و(في Herd Pro) MySQL/Redis.

1. حمّل وثبّت Laravel Herd من herd.laravel.com.
2. ضع مجلد مشروع AssetHub داخل ~/Herd/ (macOS) أو %USERPROFILE%\Herd\ (Windows). يُنشئ Herd تلقائيًا نطاقًا بصيغة .test — مثلًا http://assethub.test.
3. افتح Herd ← Sites وتحقّق من أن إصدار PHP هو 8.2 أو 8.3. انقر بالزر الأيمن على الموقع ← Secure لتفعيل HTTPS (مطلوب لماسح QR).
4. أنشئ قاعدة بيانات MySQL. مع Herd Pro، استخدم Services ← MySQL ← Open in TablePlus. وإلا ثبّت MySQL Community أو استخدم SQLite (DB_CONNECTION=sqlite، touch database/database.sqlite).
5. انسخ .env.example إلى .env، املأ بيانات اعتماد قاعدة البيانات، ثم نفّذ php artisan key:generate من جذر المشروع.
6. افتح http://assethub.test/install في متصفحك واتبع معالج التثبيت.

الخيار 2 — XAMPP (Windows وmacOS وLinux)

XAMPP يجمع Apache وMySQL/MariaDB وPHP. مجاني ومتعدد المنصات. احرص على اختيار إصدار بـ PHP 8.2 أو أحدث.

1. حمّل XAMPP 8.2+ من apachefriends.org وثبّته.
2. انسخ مشروع AssetHub إلى C:\xampp\htdocs\AssetHub\ (Windows) أو /Applications/XAMPP/htdocs/AssetHub/ (macOS).
3. افتح XAMPP Control Panel وشغّل Apache وMySQL. إذا كانت المنافذ مشغولة، استخدم Config ← service.conf لتغيير Apache إلى 8080.
4. اذهب إلى http://localhost/phpmyadmin ← جديد ← أنشئ قاعدة بيانات باسم assethub بترتيب utf8mb4.
5. في مجلد المشروع: انسخ .env.example إلى .env، اضبط DB_DATABASE=assethub، DB_USERNAME=root، اترك DB_PASSWORD فارغًا (افتراضي XAMPP). نفّذ php artisan key:generate.
6. زر http://localhost/AssetHub/public/install لتشغيل معالج التثبيت.

الخيار 3 — Laragon (Windows)

Laragon بيئة Windows محمولة مصمّمة لـ Laravel — vhosts تلقائية، روابط نظيفة، MySQL/MariaDB وHeidiSQL مدمج.

1. حمّل Laragon Full من laragon.org وثبّته.
2. في Laragon: القائمة ← PHP ← Version — بدّل إلى PHP 8.2 أو 8.3.
3. انسخ مشروع AssetHub إلى C:\laragon\www\AssetHub\.
4. اضغط على Start All. ينشئ Laragon vhost تلقائيًا: http://assethub.test (يشير إلى مجلد public/).
5. افتح HeidiSQL (مدمج) ← أنشئ قاعدة البيانات assethub. بيانات الاعتماد الافتراضية: المستخدم root، كلمة المرور فارغة.
6. حرّر .env ببيانات اعتماد قاعدة البيانات، نفّذ php artisan key:generate، ثم زر http://assethub.test/install.

الخيار 4 — خادم PHP المدمج (لا حاجة لخادم ويب)

أبسط الخيارات: يأتي Laravel مع artisan serve الذي يشغّل خادم PHP للتطوير. لا حاجة لـ Apache أو Nginx. الأفضل للاختبار السريع.

# تثبيت الاعتماديات والتهيئة
cd /path/to/AssetHub
composer install
cp .env.example .env
php artisan key:generate

# تشغيل migration وبذر البيانات الأولية
php artisan migrate --seed

# تشغيل خادم التطوير
php artisan serve
# ثم زر: http://127.0.0.1:8000/install

مزالق شائعة في الجهاز المحلي

ماسح QR لا يفتح الكاميرا على http://

تتطلّب واجهات الكاميرا في المتصفح HTTPS، مع استثناء واحد: http://localhost وhttp://127.0.0.1 يُعامَلان كسياقات آمنة. إذا فتحت AssetHub عبر IP الشبكة المحلية (مثلًا http://192.168.1.10)، فسترفض الكاميرا. استخدم localhost للتطوير، أو فعّل HTTPS عبر Herd / mkcert.

Permission denied على storage (macOS / Linux)

إذا رأيت أخطاء كتابة عند محاولة التطبيق تسجيل أو التخزين المؤقّت، صحّح الصلاحيات: chmod -R 775 storage bootstrap/cache. على Windows ليس ضروريًا عادةً.

المنفذ مستخدم بالفعل

إذا كان المنفذ 8000 محجوزًا من تطبيق آخر، استخدم منفذًا مختلفًا:

php artisan serve --port=8001

اختبار البريد محليًا

SMTP الحقيقي غير متاح في معظم إعدادات الجهاز المحلي. خياران آمنان: (1) اضبط MAIL_MAILER=log في .env — تُكتب الرسائل في storage/logs/laravel.log بدلًا من إرسالها؛ أو (2) استخدم Mailtrap / MailHog لالتقاط البريد الصادر في صندوق وارد وهمي.

MAIL_MAILER=log
# كل الرسائل تُكتب في storage/logs/laravel.log

أصول الواجهة الأمامية (Vite / Tailwind)

واجهة Vue/Tailwind لـ AssetHub مبنية مسبقًا في الحزمة. إذا حرّرت مكوّنات Vue أو إعدادات Tailwind فستحتاج Node.js 18+:

npm install
npm run dev    # إعادة تحميل ساخنة أثناء التطوير
npm run build  # بناء الإنتاج (يُنفَّذ قبل النشر)

النشر على Hostinger Single (استضافة مشتركة)

هذا هو المسار الموصى به للمستخدمين الذين لا يملكون VPS أو خبرة تقنية. AssetHub متوافق تمامًا مع باقة Hostinger Single Web Hosting الأرخص (~$2.99/شهر). لا SSH ولا Composer ولا سطر أوامر — تتضمّن Single cron jobs أصلية وPHP 8.3 وSSL مجاني.

الخطوة 1 — تجهيز الاستضافة

1. سجّل الدخول إلى Hostinger hPanel.
2. اذهب إلى الاستضافة ← إدارة لنطاقك.
3. اضبط إصدار PHP إلى 8.2 أو 8.3 عبر المتقدّم ← إعدادات PHP.
4. تأكّد من تفعيل ملحقات PHP التالية (عادةً مفعّلة افتراضيًا):
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo

الخطوة 2 — إنشاء قاعدة بيانات MySQL

1. في hPanel، اذهب إلى قواعد البيانات ← MySQL Databases.
2. اضغط على إنشاء قاعدة بيانات جديدة.
3. دوّن هذه القيم الثلاث:
   • اسم قاعدة البيانات — مثلًا u123_AssetHub
   • اسم المستخدم — مثلًا u123_admin
   • كلمة المرور — تُولَّد تلقائيًا، احتفظ بها بأمان

الخطوة 3 — رفع الملفات

1. اذهب إلى الملفات ← File Manager في hPanel.
2. انتقل إلى public_html/ (هذا هو جذر نطاقك).
3. احذف أي index.html أو default.php افتراضي في هذا المجلد.
4. اضغط على رفع الملفات وارفع source.zip بأكمله من الحزمة.
   أو ارفع محتويات مجلد /source/ مباشرة عبر FTP إذا فضّلت.
5. إذا رفعت ZIP، انقر بالزر الأيمن ← استخراج. بعد الاستخراج، يجب أن تكون كل الملفات في جذر public_html/.
6. تأكّد من أن public_html/ يحتوي على: app/، public/، vendor/، .htaccess، index.php (في public/)، .env، إلخ.

الخطوة 4 — تشغيل المثبّت

1. افتح متصفحك واذهب إلى https://yourdomain.com/install.
2. ستظهر شاشة AssetHub Installer.
3. الخطوة 1: Requirements — يجب أن تنجح كل الفحوصات (خضراء). إذا فشل أيّ فحص، تواصل مع دعم Hostinger لتفعيل ملحق PHP المفقود.
4. الخطوة 2: Database — أدخل بيانات الاعتماد من الخطوة 2 أعلاه:
   • المضيف: localhost
   • المنفذ: 3306
   • قاعدة البيانات: u123_AssetHub
   • اسم المستخدم: u123_admin
   • كلمة المرور: (التي ولّدها Hostinger)
5. الخطوة 3: Migrate — اضغط على "Run Migrations & Seed". تستغرق ~10 ثوان. لا تُحدّث الصفحة.
6. الخطوة 4: Admin — أنشئ حساب المسؤول. استخدم كلمة مرور قوية.
7. تم! — سترى رابط Cron (احفظه!) وزر تسجيل الدخول.

الخطوة 5 — إعداد تنبيهات البريد التلقائية عبر Hostinger Cron

يستخدم AssetHub مجدّول Laravel لمهام الخلفية: تنبيهات الضمان، تذكيرات الصيانة، انتهاء الوثائق، تحديث الإهلاك، وعمليات الإخراج المتأخرة. اضبط cron job واحدًا في hPanel وسيقرّر Laravel أيّ مهمة تُنفَّذ ومتى.

1. في hPanel، اذهب إلى المتقدّم ← Cron Jobs.
2. اضغط على إنشاء Cron job.
3. اختر النوع: Custom (وليس "PHP" — نحتاج إلى تمرير وسيط).
4. للأمر، أدخل (استبدل uXXXXXX باسم مستخدم حسابك في Hostinger):

   /usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

   نصيحة: افتح File Manager، حدّد ملف artisan (جذر المشروع)، انقر بالزر الأيمن ← الخصائص لنسخ المسار الكامل.
5. اضبط الجدولة على كل دقيقة — كل الحقول الخمسة (الدقيقة، الساعة، اليوم، الشهر، يوم الأسبوع) على *.
6. اضغط على حفظ.

هذا كل شيء — يرسل AssetHub الآن تلقائيًا تذكيرات عمليات الإخراج المتأخرة، وتنبيهات الصيانة، وتنبيهات انتهاء الوثائق، وتنبيهات الضمان، ويُحدّث قيم إهلاك الأصول. يجدول Laravel داخليًا كل مهمة بترددها الصحيح (يوميًا 08:00، شهريًا، إلخ).

الخطوة 6 — إعداد البريد (SMTP)

يوفّر Hostinger حسابات بريد مع كل باقة. لاستخدامها في إشعارات AssetHub:

1. في hPanel، اذهب إلى البريد ← حسابات البريد وأنشئ حسابًا (مثلًا noreply@yourdomain.com).
2. حرّر ملف .env في public_html/ عبر File Manager:

   MAIL_MAILER=smtp
   MAIL_HOST=smtp.hostinger.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. احفظ الملف.
4. سجّل الدخول إلى AssetHub ← الإعدادات ← تبويب البريد ← إرسال بريد تجريبي. إذا استلمته فقد انتهيت.

المشكلات الشائعة على Hostinger Single

"500 Internal Server Error" بعد الرفع

• تحقّق من وجود .htaccess في جذر public_html/ واحتوائه على قواعد rewrite.
• تحقّق من ضبط إصدار PHP على 8.2 أو 8.3 في hPanel.
• افحص storage/logs/laravel.log عبر File Manager لمعرفة الخطأ الفعلي.

"Permission denied" عند التحميل

عادةً يضبط Hostinger الصلاحيات الصحيحة، وإلا:

• انقر بالزر الأيمن على storage/ في File Manager ← الصلاحيات ← اضبطها على 755 بشكل تكراري.
• ونفس الشيء لـ bootstrap/cache/.

ماسح QR لا يفتح الكاميرا

تتطلّب واجهات كاميرا المتصفح HTTPS. يوفّر Hostinger SSL مجاني عبر Let's Encrypt — فعّله في hPanel ضمن SSL ← إدارة.

رسائل البريد المجدولة لا تُرسَل

• في hPanel ← Cron Jobs ← تحقّق من عمود Last run في مدخل cron. إذا كان فارغًا فإن cron لا يعمل — تحقّق من صحة مسار artisan.
• اختبر الأمر يدويًا: افتح Terminal في hPanel (إن توفّر) ونفّذ أمر cron. إذا فشل، ستحدّد رسالة الخطأ المشكلة (إصدار PHP خاطئ، مسار خاطئ، إلخ).
• تحقّق من ضبط SMTP بشكل صحيح (الإعدادات ← البريد ← إرسال اختبار).
• افحص storage/logs/laravel.log لأخطاء المجدول.

أداء بطيء

Hostinger Single يستخدم CPU/RAM مشتركة. إذا كان فريقك يفوق 20 مستخدمًا، فكّر في:

• الترقية إلى Premium (~$3.99/شهر) — خوادم أسرع، موارد أكثر، قواعد بيانات متعدّدة.
• أو Business (~$5.99/شهر) — موارد مخصّصة، نسخ احتياطية يومية، بيئة staging.

الإعدادات

ملف .env

الإعدادات داخل التطبيق

معظم الخيارات غير الحسّاسة قابلة للضبط من المسؤول ← الإعدادات:

• عام: اسم/بريد/هاتف الشركة، بادئة asset tag
• البريد: إرسال بريد تجريبي للتحقّق من SMTP
• الإشعارات: عتبات تنبيه الضمان، نافذة تذكير الصيانة
• التوطين: المنطقة الزمنية، تنسيق التاريخ، العملة

دعم متعدد اللغات

يأتي AssetHub مع 10 لغات جاهزة للاستخدام، بما في ذلك العربية RTL. يقوم المستخدمون بتبديل اللغة عبر قائمة الأعلام المنسدلة في الزاوية اليمنى العلوية.

اللغات المضمنة

كيفية تبديل اللغة

1. انقر على أيقونة العلم في الزاوية اليمنى العلوية لفتح القائمة المنسدلة.
2. اختر لغتك من القائمة.
3. يتم إعادة تحميل الصفحة؛ وتتبدل جميع تسميات الواجهة والتواريخ وتنسيقات العملة.
4. يتم حفظ اختيارك في كل من حساب المستخدم وكوكي (سنة واحدة).

إضافة لغة مخصصة (المشرف)

المشرف → الإعدادات → الترجمات:

• انقر "إضافة لغة" — قدم رمزًا (مثل th للتايلاندية)، اسم العرض، الاسم الأصلي، العلم، الاتجاه، ولغة أساس لنسخ الترجمات.
• حرر الترجمات مباشرة في محرر الترجمات، أو عبر استيراد/تصدير CSV.
• الترجمات المخزنة في قاعدة البيانات تتجاوز تلقائيًا ترجمات الملفات.

اللغة الافتراضية لكل مستخدم

لكل مستخدم عمود locale. ترسل إشعارات البريد الإلكتروني تلقائيًا بلغة المستلم المفضلة بفضل عقد HasLocalePreference الخاص بـ Laravel.

قائمة الميزات

المستخدمون والأدوار

يأتي AssetHub مع 5 أدوار جاهزة:

تُخزَّن الصلاحيات كأدوار Spatie — يمكن للمسؤولين الضبط الدقيق لكل صلاحية عبر قاعدة البيانات.

إدارة الأصول

إنشاء الأصول

1. انتقل إلى الأصول ← أصل جديد.
2. املأ الاسم والفئة والعلامة التجارية والطراز والرقم التسلسلي.
3. أضف تاريخ الشراء والسعر (مطلوب للإهلاك).
4. ارفع الصور (يدعم ملفات متعدّدة، حد أقصى 5 ميغابايت لكل ملف).
5. احفظ — يُولَّد asset tag ورمز QR تلقائيًا.

تنسيق Asset Tag

افتراضيًا: {PREFIX}-{YEAR}-{NNNN}، مثلًا AS-2026-0001. قابل للضبط عبر الإعدادات ← عام ← بادئة Asset Tag.

استيراد جماعي

1. اضغط على استيراد في صفحة الأصول.
2. نزّل قالب Excel.
3. املأ بياناتك — الأعمدة المطلوبة: name، category_name.
4. ارفع الملف.

رموز QR

يتلقّى كل أصل رمز QR تلقائيًا عند الإنشاء. يُرمِّز QR رابط الأصل، لذا يأخذ المسحُ المستخدمَ مباشرةً إلى صفحة تفاصيل الأصل.

طباعة البطاقات

• بطاقة واحدة: اضغط على أيقونة الطابعة في أيّ صف أصل.
• صيغة PDF: A4، بطاقتان لكل صف، تشمل asset tag والاسم والعلامة والرقم التسلسلي.

المسح

اضغط على مسح QR في صفحة الأصول. اسمح بصلاحية الكاميرا. يستخدم الماسح html5-qrcode ويعمل على أيّ متصفح حديث. ملاحظة: يتطلّب الوصول إلى الكاميرا HTTPS أو localhost.

سير العمل

إسناد الأصل

1. افتح صفحة تفاصيل أصل.
2. اضغط على إسناد (يظهر إذا كان الأصل متاحًا).
3. اختر المستخدم وتاريخ الإرجاع الاختياري والملاحظات.
4. أرسل — تُنشأ المعاملة ويُرسَل إشعار البريد.

طلبات الأصول

يمكن للموظفين تقديم طلبات للأصول التي يحتاجونها. للطلبات 4 حالات: pending ← approved ← fulfilled، أو rejected. تُرسَل رسائل الموافقة تلقائيًا.

Check-in / Check-out

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

الإهلاك

يحسب AssetHub إهلاك الأصول بواحدة من ثلاث طرق:

تُرث الإعدادات الافتراضية من فئة الأصل. تُولَّد إدخالات الجدول شهريًا. تُحدَّث current_value للأصل تلقائيًا في أول كل شهر.

الحقول المخصصة

المسؤول ← الحقول المخصصة يتيح لك إضافة سمات مخصّصة بلا حدود للأصول:

• الأنواع: نص، رقم، تاريخ، اختيار (dropdown)، منطقة نص، ملف، مربع اختيار
• النطاق: تطبيق على كل الفئات أو فئة محدّدة
• إعادة الترتيب: اسحب المقبض
• يتم التحقّق من الحقول الإلزامية عند حفظ الأصل

التقارير

ثمانية تقارير مدمجة يمكن الوصول إليها من قائمة التقارير:

1. ملخّص الأصول — الإجماليات حسب الحالة والوضع والفئة والقسم
2. الإهلاك — فقد القيمة لكل فئة، أكثر الأصول إهلاكًا
3. المعاملات — نشاط الإسناد والإرجاع والنقل عبر الزمن
4. تكلفة الصيانة — الإنفاق حسب الشهر والفئة والنوع
5. انتهاء الضمان — الأصول التي تحتاج اهتمامًا خلال 30/60/180 يومًا
6. أصول الأقسام — توزيع الأصول واستخدام الميزانية حسب القسم
7. الأصول حسب المصدر — التوزيع بين الشراء والمشروع والتبرّع والنقل
8. ملخّص جرد المخزون — الفروقات بين دورات الجرد الدورية

تدعم كل التقارير التصدير إلى Excel وPDF عبر أزرار في رأس الصفحة.

Webhooks

يمكن لـ AssetHub إخطار الخدمات الخارجية عند الأحداث الرئيسية.

الأحداث المتاحة

• asset.created, asset.updated, asset.deleted
• asset.assigned, asset.returned, asset.transferred
• request.created, request.approved, request.rejected, request.fulfilled
• maintenance.scheduled, maintenance.started, maintenance.completed
• checkout.created, checkout.returned

صيغة Payload

{
  "event": "asset.assigned",
  "timestamp": "2026-05-05T08:00:00+00:00",
  "data": {
    "asset_id": 1,
    "asset_tag": "AS-2026-0001",
    "asset_name": "HP EliteDesk 800",
    "to_user_id": 4,
    "transaction_id": 12
  }
}

التحقّق من التوقيع

إذا ضُبط secret، تتضمّن الطلبات الترويسة X-AssetHub-Signature الحاوية على HMAC-SHA256 للـ payload body. تحقّق في طرفك:

$expected = hash_hmac('sha256', $rawBody, $secret);
if (hash_equals($expected, $request->header('X-AssetHub-Signature'))) {
  // صالح
}

سياسة إعادة المحاولة

يُعاد التسليم 3 مرات بفاصل 200 مللي ثانية عند الفشل. بعد 10 إخفاقات متتالية، يُعطَّل webhook تلقائيًا.

المهام المجدولة

يستخدم AssetHub مجدّول Laravel لمهام الخلفية. تحتاج فقط إلى مدخل cron واحد — يُوزّع Laravel داخليًا كل مهمة على الوقت الصحيح.

Hostinger / استضافة مشتركة (واجهة Cron Jobs في hPanel)

راجع قسم إعداد Hostinger ← الخطوة 5 للحصول على إرشادات بنمط لقطات الشاشة. باختصار: المتقدّم ← Cron Jobs ← Custom، الأمر:

/usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

الجدول: كل دقيقة (* في كل الحقول الخمسة).

VPS / خادم مخصّص (crontab)

نفّذ crontab -e كمستخدم الويب (غالبًا www-data) وأضف:

* * * * * cd /path/to/AssetHub && php artisan schedule:run >> /dev/null 2>&1

حلّ بديل: pinger URL خارجي

إذا لم يكن لدى مضيفك cron على الإطلاق، استخدم رابط Cron داخل التطبيق (الإعدادات ← تبويب النظام) مع cron-job.org (مجاني، كل 15 دقيقة).

المهام التي تعمل تلقائيًا

حل المشكلات

"Permission denied" على storage

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

ماسح QR لا يفتح الكاميرا

تتطلّب واجهات كاميرا المتصفح HTTPS. ثبّت شهادة SSL أو استخدم localhost للاختبار.

البريد لا يصل

افحص storage/logs/laravel.log بحثًا عن أخطاء. استخدم الإعدادات ← البريد ← إرسال بريد تجريبي للتحقّق من بيانات SMTP. تأكّد من أن خادم SMTP يسمح لـ IP المرسِل.

إعادة ضبط التثبيت

احذف storage/installed.lock وزر /install مجدّدًا. سيتم محو البيانات الموجودة إذا أعدت تشغيل الـ migrations.

الأداء — قائمة أصول بطيئة

نفّذ php artisan optimize لتخزين الإعدادات والمسارات والـ views مؤقتًا. تأكّد من وجود فهارس MySQL على assets.asset_tag، assets.serial_number، assets.status (تُنشأ تلقائيًا بواسطة الـ migrations).

سجل التغييرات

v1.0.0 — الإصدار الأول (2026-05)

• CRUD الأصول مع توليد QR تلقائيًا
• 5 أدوار مستخدمين (Admin، مدير IT، محاسب، مشرف، موظف) بصلاحيات دقيقة
• تتبّع مصدر الأصل (شراء مركزي، شراء لامركزي، مشروع استثماري، تبرّع، نقل داخلي)
• سير عمل الإسناد والإرجاع مع إشعارات بالبريد
• سير عمل الموافقة على النقل (pending ← approved/rejected) مع بوّابة الصلاحيات
• سير الموافقة على طلبات الأصول
• Check-in/check-out مع عرض التقويم
• جدولة الصيانة مع التجديد التلقائي
• مرفقات الوثائق مع تنبيهات الانتهاء
• الإهلاك بـ 3 طرق حساب + تنبيهات نهاية العمر
• وحدة جرد المخزون — جرد دوري مع تتبّع الفروقات
• الحقول المخصصة بـ 7 أنواع إدخال وفرز drag-drop
• 8 تقارير مع مخطّطات وتصدير Excel وPDF (تشمل الأصول حسب المصدر، ملخّص الجرد)
• سجل تدقيق عبر Spatie Activitylog مع عارض diff
• Webhooks مع توقيع HMAC وإعادة محاولة تلقائية
• واجهة متعدّدة اللغات: 10 لغات (en، vi، es، fr، de، zh، ja، pt-BR، ru، ar مع RTL)
• واجهة إعدادات للشركة والبريد والإشعارات والتوطين والترجمات
• معالج تثبيت قائم على الويب
• وضع داكن بلوحة ألوان emerald-teal

الاعتمادات

المكتبات مفتوحة المصدر المستخدمة

• Laravel 11 — MIT
• Vue 3 — MIT
• Inertia.js — MIT
• Tailwind CSS — MIT
• Spatie Permission, Media Library, Activitylog — MIT
• Phosphor Icons — MIT (duotone weight)
• ApexCharts — MIT
• html5-qrcode — Apache 2.0
• Simple QrCode — MIT
• Laravel Excel — MIT
• Laravel DomPDF — MIT