MAINHACK

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 مفعّل (للإنتاج)
- [ ] النسخ الاحتياطي جاهز
- [ ] تم اختبار الوظائف الأساسية

---

## 🎉 تهانينا!

نظامك جاهز للعمل! استمتع بإدارة مبيعاتك بسهولة وكفاءة.

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: DEPLOYMENT_GUIDE.md

Server Info

System Features

User Info