# 🚀 دليل التثبيت السريع - نظام سندات الصرف

## ⚡ 3 خطوات فقط!

---

## 📥 **الخطوة 1: إضافة عمود office_id**
```
http://localhost/0f/users/office/receipts/add_office_id_column.php
```

**ماذا يفعل:**
- يضيف عمود `office_id` لجدول `receipts_voucher`
- يضيف فهرس `idx_office_id`

**المدة:** 2 ثانية

**الناتج المتوقع:**
```
✅ تم إضافة العمود office_id بنجاح
```

---

## 📥 **الخطوة 2: إنشاء جدول الكيانات**
```
http://localhost/0f/users/office/receipts/install_office_entities.php
```

**ماذا يفعل:**
- ينشئ جدول `office_entities`
- يحفظ الشركات/المؤسسات/الأفراد لكل مكتب

**المدة:** 2 ثانية

**الناتج المتوقع:**
```
✅ تم إنشاء الجداول بنجاح
جدول office_entities موجود
```

---

## 📥 **الخطوة 3: إنشاء جدول البنوك**
```
http://localhost/0f/users/office/receipts/install_bank_table.php
```

**ماذا يفعل:**
- ينشئ جدول `bank`
- يضيف 20 بنك سعودي

**المدة:** 2 ثانية

**الناتج المتوقع:**
```
✅ تم إنشاء جدول البنوك بنجاح
عدد البنوك: 20
```

---

## 🎉 **جاهز!**

افتح الصفحة:
```
http://localhost/0f/users/office/receipts/add_sand_new.php
```

---

## ✅ قائمة التحقق

بعد التثبيت، تأكد من:

- [ ] جدول `receipts_voucher` يحتوي على عمود `office_id`
- [ ] جدول `office_entities` موجود
- [ ] جدول `bank` موجود ويحتوي على بنوك
- [ ] صفحة `add_sand_new.php` تفتح بدون أخطاء
- [ ] يمكنك اختيار مؤجر
- [ ] يمكنك فتح Modal الكيانات
- [ ] يمكنك إضافة كيان جديد

---

## 🐛 حل المشاكل

### **المشكلة: "Column 'office_id' not found"**
```
الحل: نفذ الخطوة 1 (add_office_id_column.php)
```

### **المشكلة: "Table 'office_entities' doesn't exist"**
```
الحل: نفذ الخطوة 2 (install_office_entities.php)
```

### **المشكلة: "لا تظهر البنوك"**
```
الحل: نفذ الخطوة 3 (install_bank_table.php)
```

---

## 📞 دعم

إذا واجهت أي مشاكل:
1. تحقق من error_log في XAMPP
2. افتح Console في المتصفح (F12)
3. تأكد من تشغيل Apache و MySQL

---

## ⏱️ المدة الإجمالية

```
الخطوة 1: 2 ثانية
الخطوة 2: 2 ثانية
الخطوة 3: 2 ثانية
───────────────────
الإجمالي: 6 ثواني فقط!
```

---

## 🎯 بعد التثبيت

### **جرب النظام:**
```
1. افتح صفحة السندات
2. اختر "سند صرف عام"
3. نوع الكيان: شركة
4. اسم الكيان: انقر 📋
5. اضغط "+ إضافة كيان جديد"
6. املأ البيانات
7. احفظ الكيان
8. اختر الكيان المحفوظ
9. أكمل السند
10. احفظ السند ✓
```

---

## 🎊 مبروك!

**نظام سندات الصرف المتكامل جاهز الآن!**

---

**آخر تحديث:** 2025-10-26  
**الإصدار:** 5.0.0  
**الحالة:** جاهز للإنتاج ✓

