# نظام استيراد العقود - دليل سريع

## 📖 نظرة عامة

نظام متكامل لاستيراد العقود من المنصة الحكومية بطريقتين:
1. **من قاعدة البيانات الخارجية** (الطريقة الأصلية)
2. **من ملف PDF** (جديد! ✨)

---

## 🚀 البدء السريع

### الطريقة 1: استيراد من قاعدة البيانات
1. افتح: `import_contracts.php`
2. اختر عقداً من القائمة
3. اضغط "تفاصيل" للمراجعة أو "استيراد" مباشرة

### الطريقة 2: استيراد من PDF
1. افتح: `import_contracts.php`
2. اضغط "قراءة عقد PDF"
3. ارفع ملف PDF
4. راجع البيانات
5. اضغط "حفظ واستيراد"

---

## 📂 الملفات الرئيسية

### للمستخدمين
- **`SUMMARY.md`** - ابدأ من هنا! ملخص سريع لكل شيء
- **`TESTING_GUIDE.md`** - دليل الاختبار خطوة بخطوة
- **`INSTALL_PDF_LIBRARY.md`** - تعليمات تثبيت مكتبة PDF

### للمطورين
- **`PDF_IMPORT_README.md`** - دليل فني شامل
- **`CONTRACT_PDF_IMPORT_COMPLETE.md`** - توثيق كامل بكل التفاصيل
- **`handle_legal_entities.php`** - دوال معالجة الكيانات القانونية

### الملفات التنفيذية
- **`import_contracts.php`** - الصفحة الرئيسية
- **`contract_readpdf.php`** - صفحة رفع PDF
- **`import_contracts_api.php`** - API الاستيراد
- **`import_contract_details.php`** - صفحة المراجعة

### قاعدة البيانات
- **`sql/create_legal_entities_tables.sql`** - إنشاء جداول الكيانات

---

## ⚡ متطلبات التشغيل

### إلزامية
- PHP 7.4+
- MySQL/MariaDB
- قاعدة بيانات `faradjwb_farsak`

### لاستيراد PDF
- مكتبة `smalot/pdfparser` (عبر Composer)
- **أو** أداة `pdftotext` (Poppler Utils)

---

## 🛠️ التثبيت

### 1. تثبيت مكتبة PDF
```bash
composer require smalot/pdfparser
```

### 2. إنشاء جداول الكيانات
```sql
-- في phpMyAdmin أو MySQL CLI
SOURCE sql/create_legal_entities_tables.sql;
```

### 3. اختبار النظام
- راجع `TESTING_GUIDE.md` للتفاصيل

---

## 🎯 الميزات

### ✅ استيراد شامل
- إنشاء/ربط المالك تلقائياً
- إنشاء/ربط المستأجر تلقائياً
- إنشاء/ربط العقار تلقائياً
- إنشاء العقد والسندات

### ✨ جديد: معالجة الكيانات القانونية
- اكتشاف تلقائي لـ 8 أنواع كيانات
- إنشاء/ربط الكيان بالعقار
- عرض معلومات الكيان في الواجهة

### 📄 جديد: استيراد من PDF
- رفع ملف PDF
- استخراج 106 حقل تلقائياً
- نفس إجراءات الاستيراد العادي

---

## 📚 التوثيق الكامل

| للمزيد عن... | اقرأ |
|-------------|------|
| كيفية البدء | `SUMMARY.md` |
| خطوات الاختبار | `TESTING_GUIDE.md` |
| تثبيت المكتبات | `INSTALL_PDF_LIBRARY.md` |
| التفاصيل الفنية | `PDF_IMPORT_README.md` |
| التوثيق الكامل | `CONTRACT_PDF_IMPORT_COMPLETE.md` |

---

## 🆘 المساعدة

**مشكلة في:**
- التثبيت؟ → `INSTALL_PDF_LIBRARY.md`
- الاختبار؟ → `TESTING_GUIDE.md`
- الفهم الفني؟ → `PDF_IMPORT_README.md`
- أي شيء آخر؟ → `CONTRACT_PDF_IMPORT_COMPLETE.md`

**السجلات:**
- `C:\xampp\apache\logs\error.log`
- ابحث عن: `[PDFImport]`, `[Entity]`, `[Import]`

---

## ✨ الحالة

**النظام**: ✅ مكتمل وجاهز  
**الاختبار**: ⏳ ينتظر التثبيت  
**التوثيق**: ✅ شامل  

---

**أنشئ بتاريخ**: 2025-11-11  
**النسخة**: 1.0.0
