# دليل نقل وحدة Quality Management كاملة

## محتويات الحزمة

```
quality_module_export/
├── erpnext/quality_management/     ← الوحدة الأساسية (56 ملف)
├── erpnext/stock/doctype/          ← فحص الجودة (من Stock)
├── erpnext/stock/services/         ← خدمة فحص الجودة
├── erpnext/manufacturing/report/   ← تقارير التصنيع
├── erpnext/manufacturing/dashboard_chart/
├── erpnext/manufacturing/number_card/
├── erpnext/workspace_sidebar/      ← القائمة الجانبية
├── erpnext/desktop_icon/         ← أيقونة الشاشة الرئيسية
├── erpnext/public/icons/           ← أيقونات SVG
├── integrations/                   ← ملاحظات الربط مع وحدات أخرى
├── MANIFEST.json
└── INSTALL_AR.md
```

---

## الطريقة 1: نقل إلى ERPNext آخر (الأسهل)

### 1. انسخ المجلدات
```bash
# من مجلد quality_module_export إلى bench الجديد
cp -r erpnext/quality_management /path/to/bench/apps/erpnext/erpnext/
cp -r erpnext/stock/doctype/quality_* /path/to/bench/apps/erpnext/erpnext/stock/doctype/
cp -r erpnext/stock/doctype/item_quality_inspection_parameter /path/to/bench/apps/erpnext/erpnext/stock/doctype/
cp erpnext/stock/services/quality_inspection_service.py /path/to/bench/apps/erpnext/erpnext/stock/services/
cp -r erpnext/manufacturing/report/quality_* /path/to/bench/apps/erpnext/erpnext/manufacturing/report/
cp -r erpnext/manufacturing/report/cost_of_poor_quality_report /path/to/bench/apps/erpnext/erpnext/manufacturing/report/
cp erpnext/workspace_sidebar/quality.json /path/to/bench/apps/erpnext/erpnext/workspace_sidebar/
cp erpnext/desktop_icon/quality.json /path/to/bench/apps/erpnext/erpnext/desktop_icon/
```

### 2. أضف الوحدة في modules.txt
```
Quality Management
```

### 3. ثبّت الـ DocTypes
```bash
cd /path/to/bench
bench --site yoursite migrate
bench --site yoursite clear-cache
```

### 4. استورد الـ Workspace والأيقونات
```bash
bench --site yoursite import-doc apps/erpnext/erpnext/quality_management/workspace/quality/quality.json
bench --site yoursite import-doc apps/erpnext/erpnext/workspace_sidebar/quality.json
bench --site yoursite import-doc apps/erpnext/erpnext/desktop_icon/quality.json
```

### 5. أنشئ دور Quality Manager
```bash
bench --site yoursite execute "frappe.get_doc({'doctype':'Role','role_name':'Quality Manager'}).insert(ignore_permissions=True)"
```

---

## الطريقة 2: Custom App مستقل

```bash
bench new-app quality_app
```

في `quality_app/hooks.py`:
```python
app_name = "quality_app"
app_title = "Quality Management"

# Fixtures
fixtures = [
    {"dt": "Workspace", "filters": [["module", "=", "Quality Management"]]},
    {"dt": "Workspace Sidebar", "filters": [["name", "=", "Quality"]]},
    {"dt": "Desktop Icon", "filters": [["name", "=", "Quality"]]},
    {"dt": "Report", "filters": [["module", "=", "Quality Management"]]},
    {"dt": "Dashboard Chart", "filters": [["module", "=", "Quality Management"]]},
]

scheduler_events = {
    "daily_maintenance": [
        "quality_app.quality_management.doctype.quality_review.quality_review.review"
    ]
}
```

---

## DocTypes الرئيسية

| DocType | الوصف |
|---------|-------|
| Quality Goal | أهداف الجودة |
| Quality Procedure | إجراءات الجودة (شجرة) |
| Quality Review | مراجعة الجودة |
| Quality Action | إجراءات تصحيحية/وقائية |
| Non Conformance | عدم المطابقة |
| Quality Feedback | ملاحظات الجودة |
| Quality Feedback Template | قالب الملاحظات |
| Quality Meeting | اجتماعات الجودة |
| Quality Inspection | فحص الجودة |
| Quality Inspection Template | قالب الفحص |
| Quality Inspection Parameter | معايير الفحص |

---

## التكامل مع وحدات أخرى

راجع مجلد `integrations/` — يحتوي على:
- حقول `quality_inspection` في Purchase Receipt, Delivery Note, Sales Invoice
- ربط Job Card و Work Order بفحص الجودة
- إعدادات Stock Settings للجودة
- كود Controllers (stock_controller, buying_controller, selling_controller)

---

## Scheduler

في `hooks.py` الأصلي:
```python
"erpnext.quality_management.doctype.quality_review.quality_review.review"
```
يعمل يومياً لإنشاء Quality Review تلقائياً من Quality Goal.

---

## التقارير

| التقرير | الموقع |
|---------|--------|
| Review | quality_management/report/review |
| Quality Inspection Summary | manufacturing/report/quality_inspection_summary |
| Cost of Poor Quality Report | manufacturing/report/cost_of_poor_quality_report |

---

## ملاحظات مهمة

1. **Quality Inspection** موجود في وحدة Stock وليس Quality Management — يجب نسخه معاً
2. بعض الحقول مدمجة في DocTypes أخرى (Item, Purchase Receipt Item...) — راجع integrations/
3. الدور **Quality Manager** مطلوب للصلاحيات
4. بعد النقل شغّل `bench migrate` ثم `bench clear-cache`