[
MAINHACK
]
Mail Test
BC
Config Scan
HOME
Create...
New File
New Folder
Viewing / Editing File: DEPLOYMENT_GUIDE.md
# دليل النشر السريع # Quick Deployment Guide --- ## 📦 محتويات الحزمة تحتوي هذه الحزمة على نظام **حسابات عربية بن فريش** الكامل - نظام إدارة المبيعات الآجلة باللغة العربية. ### الملفات المُنشأة: 26 ملف ``` ✅ ملفات PHP: 20 ملف ✅ قاعدة البيانات: 1 ملف SQL ✅ ملفات CSS: 1 ملف ✅ ملفات JavaScript: 1 ملف ✅ ملفات توثيق: 3 ملفات ✅ ملف Apache config: 1 ملف ``` --- ## 🚀 النشر في 5 دقائق ### الخطوة 1: رفع الملفات (دقيقة واحدة) **للاستضافة المحلية (XAMPP/WAMP):** ``` انسخ المجلد بالكامل إلى: C:\xampp\htdocs\hesabat_arabia\ ``` **للاستضافة على الإنترنت:** ``` ارفع جميع الملفات عبر FTP إلى: /public_html/hesabat_arabia/ ``` --- ### الخطوة 2: إنشاء قاعدة البيانات (دقيقتان) 1. افتح phpMyAdmin 2. انقر **Import** (استيراد) 3. اختر ملف `database.sql` 4. انقر **Go** **✅ تم! قاعدة البيانات جاهزة مع:** - 10 جداول - حساب مدير افتراضي - إعدادات أولية --- ### الخطوة 3: تعديل الإعدادات (دقيقة واحدة) **افتح:** `config/database.php` ```php define('DB_HOST', 'localhost'); // غيّر إذا لزم الأمر define('DB_USER', 'root'); // اسم مستخدم MySQL define('DB_PASS', ''); // كلمة مرور MySQL define('DB_NAME', 'hesabat_arabia'); // اسم قاعدة البيانات ``` **افتح:** `config/config.php` ```php define('BASE_URL', 'http://localhost/hesabat_arabia'); ``` **أمثلة:** ```php // محلي 'http://localhost/hesabat_arabia' // استضافة 'https://yourdomain.com' // دومين فرعي 'https://hesabat.yourdomain.com' ``` --- ### الخطوة 4: اختبار النظام (دقيقة واحدة) 1. افتح المتصفح 2. اذهب إلى رابط موقعك 3. يجب أن تظهر صفحة تسجيل الدخول **بيانات الدخول الافتراضية:** ``` رقم الهاتف: +201000000000 كلمة المرور: admin123 ``` --- ### الخطوة 5: الإعدادات الأولية (اختياري) 1. سجل دخول كمدير 2. غيّر كلمة المرور (مهم جداً!) 3. اذهب إلى **الإعدادات** 4. أدخل معلومات الشركة 5. إذا أردت تفعيل واتساب، أدخل API credentials --- ## 🎯 الوظائف الجاهزة للاستخدام ### ✅ جاهزة تماماً: | الوظيفة | الحالة | الملاحظات | |---------|--------|-----------| | تسجيل الدخول/الخروج | ✅ جاهز | مع حماية الجلسات | | لوحة التحكم | ✅ جاهز | إحصائيات حية | | إضافة عملاء | ✅ جاهز | مع التحقق من الهاتف | | عرض العملاء | ✅ جاهز | مع البحث والتصفح | | إنشاء فواتير | ✅ جاهز | حساب آلي للمديونيات | | تحصيل أموال | ✅ جاهز | تطبيق تلقائي على الفواتير | | عرض الفواتير | ✅ جاهز | مع التصفية والبحث | | عرض المدفوعات | ✅ جاهز | تاريخ كامل | | الورديات | ✅ جاهز | عرض القائمة | | المرتجعات | ✅ جاهز | عرض القائمة | | التقارير | ✅ جاهز | صفحة الاختيار | | الإعدادات | ✅ جاهز | واتساب + معلومات الشركة | | واتساب API | ✅ جاهز | جاهز للربط | --- ## ⚠️ ملفات إضافية مطلوبة (اختياري) لإكمال النظام 100%، ستحتاج إلى إنشاء: ### للعملاء: - `customers/edit.php` - تعديل عميل - `customers/view.php` - عرض تفاصيل عميل - `customers/delete.php` - حذف عميل ### للفواتير: - `invoices/view.php` - عرض تفاصيل فاتورة (مع طباعة) ### للورديات: - `shifts/request.php` - طلب وردية جديدة - `shifts/approve_start.php` - موافقة على البدء - `shifts/request_end.php` - طلب إغلاق - `shifts/approve_end.php` - موافقة على الإغلاق - `shifts/view.php` - عرض تفاصيل وتقرير ### للمرتجعات: - `returns/create.php` - إضافة مرتجع - `returns/approve.php` - الموافقة - `returns/reject.php` - الرفض - `returns/view.php` - عرض التفاصيل ### للتقارير: - `reports/daily_sales.php` - المبيعات اليومية - `reports/cash_flow.php` - التدفق النقدي - `reports/debts.php` - المديونيات - `reports/customer_statement.php` - كشف حساب - `reports/returns_report.php` - تقرير المرتجعات - `reports/shifts_report.php` - تقرير الورديات ### للإعدادات: - `settings/users.php` - إدارة المستخدمين **ملاحظة:** النظام يعمل بدون هذه الملفات، لكنها تضيف وظائف متقدمة. --- ## 🔒 الأمان والحماية ### ✅ تم تطبيق: - تشفير كلمات المرور (bcrypt) - حماية من SQL Injection - التحقق من الصلاحيات - تنظيف المدخلات - سجل جميع العمليات - حماية ملفات الإعدادات ### 🛡️ يُنصح بتطبيق: 1. **HTTPS:** احصل على شهادة SSL مجانية من Let's Encrypt 2. **النسخ الاحتياطي:** نسخة يومية لقاعدة البيانات 3. **تحديث PHP:** استخدم PHP 8.0+ للأداء والأمان 4. **Firewall:** فعّل جدار الحماية على السيرفر 5. **المراقبة:** راقب سجل الأخطاء بانتظام --- ## 📊 معلومات تقنية ### المتطلبات: ``` ✅ PHP 7.4+ (يُفضل 8.0+) ✅ MySQL 5.7+ (يُفضل 8.0+) ✅ Apache 2.4+ أو Nginx 1.18+ ✅ مساحة: 50 MB ✅ Extensions: PDO, mysqli, curl, mbstring, json ``` ### قاعدة البيانات: ``` 📊 عدد الجداول: 10 📊 التشفير: UTF-8 (utf8mb4_unicode_ci) 📊 المحرك: InnoDB 📊 العلاقات: Foreign Keys مفعّلة ``` --- ## 🎨 الواجهة والتصميم ``` ✅ Bootstrap 5 RTL - إطار العمل ✅ Arabic Language - اللغة العربية فقط ✅ Right-to-Left - التوجيه من اليمين لليسار ✅ Responsive Design - متجاوب مع الجوال ✅ Bootstrap Icons - 1000+ أيقونة ✅ Clean UI - واجهة نظيفة وبسيطة ``` --- ## 📱 اختبار على الأجهزة تأكد من اختبار النظام على: | الجهاز | المتصفح | الحالة | |--------|---------|--------| | Desktop | Chrome | ✅ | | Desktop | Firefox | ✅ | | Desktop | Edge | ✅ | | Mobile | Chrome | ✅ | | Tablet | Safari | ✅ | --- ## 🆘 الدعم السريع ### مشكلة: لا يمكن الاتصال بقاعدة البيانات **الحل:** 1. تحقق من تشغيل MySQL 2. راجع بيانات `config/database.php` 3. تأكد من وجود قاعدة البيانات ### مشكلة: الصفحة بيضاء **الحل:** 1. فعّل عرض الأخطاء في `config/config.php` 2. تحقق من `logs/php_error.log` 3. تأكد من صلاحيات المجلدات ### مشكلة: الأنماط لا تظهر **الحل:** 1. تحقق من `BASE_URL` في `config/config.php` 2. تأكد من وجود مجلد `assets/` 3. امسح الكاش --- ## 📞 الموارد المفيدة ``` 📖 دليل المستخدم: README.md 🔧 دليل التثبيت: INSTALLATION.md 📝 قائمة الملفات: FILES_LIST.md 🚀 هذا الدليل: DEPLOYMENT_GUIDE.md ``` --- ## ✅ قائمة التحقق النهائية قبل الإطلاق، تحقق من: - [ ] قاعدة البيانات مستوردة بنجاح - [ ] إعدادات الاتصال صحيحة - [ ] BASE_URL محدث - [ ] يمكن تسجيل الدخول - [ ] تم تغيير كلمة المرور الافتراضية - [ ] معلومات الشركة محدثة - [ ] واتساب API مفعّل (إن وُجد) - [ ] HTTPS مفعّل (للإنتاج) - [ ] النسخ الاحتياطي جاهز - [ ] تم اختبار الوظائف الأساسية --- ## 🎉 تهانينا! نظامك جاهز للعمل! استمتع بإدارة مبيعاتك بسهولة وكفاءة. © 2025 حسابات عربية بن فريش - جميع الحقوق محفوظة
Save Changes
Cancel / Back
Close ×
Server Info
Hostname: premium320.web-hosting.com
Server IP: 66.29.153.54
PHP Version: 8.2.29
Server Software: LiteSpeed
System: Linux premium320.web-hosting.com 4.18.0-553.50.1.lve.el8.x86_64 #1 SMP Thu Apr 17 19:10:24 UTC 2025 x86_64
HDD Total: 97.87 GB
HDD Free: 76.85 GB
Domains on IP: N/A (Requires external lookup)
System Features
Safe Mode:
Off
disable_functions:
None
allow_url_fopen:
On
allow_url_include:
Off
magic_quotes_gpc:
Off
register_globals:
Off
open_basedir:
None
cURL:
Enabled
ZipArchive:
Enabled
MySQLi:
Enabled
PDO:
Enabled
wget:
Yes
curl (cmd):
Yes
perl:
Yes
python:
Yes (py3)
gcc:
Yes
pkexec:
No
git:
Yes
User Info
Username: aoneqssk
User ID (UID): 1285
Group ID (GID): 1290
Script Owner UID: 1285
Current Dir Owner: 1285