# 🆕 المزايا الجديدة — Jadwa AI Platform

> آخر تحديث: فبراير 2026

---

## 📋 نظرة عامة

تم إضافة مجموعتين رئيسيتين من المزايا الجديدة إلى منصة Jadwa AI:

| المجموعة | عدد المزايا | الحالة |
|----------|-------------|--------|
| النماذج الأولية والتصنيع | 8 مزايا | ✅ مكتمل |
| نظام الأدوار والإشعارات | 7 مزايا | ✅ مكتمل |

---

## 🏭 المجموعة الأولى: النماذج الأولية والتصنيع

نظام متكامل يربط أصحاب الأفكار بالمصانع السعودية لتحويل دراسة الجدوى إلى نموذج أولي حقيقي.

### 1. دليل المصانع (Factory Directory)
- دليل مصانع سعودية شامل مع بيانات تفصيلية
- بحث وتصفية حسب **القطاع** و**المدينة** و**التخصص**
- بيانات المصنع: الاسم، الموقع، التخصصات، التقييم، معلومات التواصل
- **الملفات**: `app/routes/prototyping.py` → `SEED_FACTORIES`, `app/models/services.py` → `FactoryPartner`

### 2. طلب نموذج أولي (Prototype Request)
- إرسال طلب نموذج أولي مباشرة للمصنع من داخل دراسة الجدوى
- تحديد **المواصفات**، **الكمية**، **الميزانية**، و**الموعد النهائي**
- ربط الطلب بتقرير دراسة الجدوى تلقائياً
- تتبع حالة الطلب: `draft` → `sent` → `quoted` → `accepted` → `in_production` → `completed`
- **الملفات**: `app/routes/prototyping.py` → `create_request()`, `app/templates/prototyping/request.html`

### 3. توليد مواصفات بالـ AI (AI Specs Generator)
- توليد مواصفات تقنية تفصيلية للمنتج تلقائياً من بيانات دراسة الجدوى
- يشمل: المواد، الأبعاد، المعايير التقنية، متطلبات الجودة
- إمكانية التعديل والتحسين قبل الإرسال للمصنع
- **API**: `POST /prototyping/api/generate-nda`

### 4. تقدير تكلفة بالـ AI (AI Cost Estimator)
- تقدير تلقائي لتكلفة النموذج الأولي يشمل:
  - **تكلفة المواد** (BOM Cost)
  - **تكلفة الوحدة** (Unit Cost)
  - **التكلفة الإجمالية** (Total Cost)
  - **المدة المتوقعة** (Lead Time)
  - **مقارنة الأسعار** مع بدائل السوق
- يُحفظ تلقائياً في قاعدة البيانات مع الطلب
- **API**: `POST /prototyping/api/estimate-cost`
- **الحقول**: `PrototypeRequest.cost_estimate_json`, `cost_estimate_generated_at`

### 5. اتفاقية NDA ذكية (Smart NDA Generator)
- توليد اتفاقية عدم إفشاء (NDA) بالذكاء الاصطناعي
- مخصصة لـ:
  - اسم المشروع ووصفه
  - بيانات المصنع المختار
  - نوع الملكية الفكرية
- تُحفظ كـ HTML في قاعدة البيانات
- إمكانية الطباعة والتصدير
- **API**: `POST /prototyping/api/generate-nda`
- **الحقول**: `PrototypeRequest.nda_html`, `nda_generated_at`

### 6. سير عمل موافقات NDA (NDA Approval Workflow)
سير عمل متعدد المراحل مع إشعارات في كل خطوة:

```
المستخدم يولّد NDA (draft)
    ↓
المستخدم يرسل للمدير (pending_admin)
    ↓
المدير يوافق ← يُرسل للمصنع (pending_factory)
المدير يرفض ← يعود للمستخدم (rejected)
    ↓
المصنع يوافق ← NDA معتمدة (approved) ✅
المصنع يرفض ← يعود للمستخدم (rejected)
```

- **حالات NDA**: `draft`, `pending_admin`, `pending_factory`, `approved`, `rejected`
- **APIs**:
  - `POST /prototyping/api/send-nda/<id>` — إرسال للمدير
  - `POST /prototyping/api/admin-approve-nda/<id>` — موافقة المدير
  - `POST /prototyping/api/admin-reject-nda/<id>` — رفض المدير
  - `POST /prototyping/api/factory-approve-nda/<id>` — موافقة المصنع
  - `POST /prototyping/api/factory-reject-nda/<id>` — رفض المصنع
- **الحقول**: `nda_status`, `nda_approved_at`

### 7. لوحة تحكم المصنع (Factory Dashboard)
- لوحة مخصصة لمستخدمي المصانع تعرض:
  - جميع الطلبات الواردة للمصنع
  - حالة كل طلب وتفاصيله
  - إمكانية عرض NDA والموافقة/الرفض
  - عرض تقدير التكلفة
- يتم توجيه مستخدم المصنع تلقائياً عند تسجيل الدخول
- **المسار**: `/prototyping/factory/dashboard`
- **القالب**: `app/templates/prototyping/factory_dashboard.html`

### 8. نظام عروض الأسعار (Quote System)
- المصنع يقدم عرض سعر يشمل:
  - **سعر الوحدة** و**السعر الإجمالي**
  - **العملة** (SAR افتراضياً)
  - **مدة التسليم** بالأيام
  - **ملاحظات** إضافية
- المستخدم يستقبل إشعار فوري بعرض السعر
- نظام محادثة مباشرة بين المستخدم والمصنع
- **API**: `POST /prototyping/factory/request/<id>/quote`
- **النموذج**: `PrototypeQuote`

---

## 👥 المجموعة الثانية: نظام الأدوار والإشعارات

نظام أدوار متعدد يتيح لكل نوع مستخدم تجربة مخصصة.

### 1. نظام أدوار المستخدمين (User Role System)
أربعة أنواع حسابات عند التسجيل:

| النوع | الوصف | الرمز |
|-------|-------|-------|
| صاحب فكرة | رائد أعمال يريد دراسة جدوى ونموذج أولي | `owner` |
| مستثمر | يبحث عن فرص استثمارية | `investor` |
| مصنع | يقدم خدمات تصنيع النماذج الأولية | `factory` |
| حاضنة أعمال | تدعم رواد الأعمال | `incubator` |

- يُحدد النوع عند التسجيل عبر Radio Buttons
- حقل **اسم الشركة** يظهر ديناميكياً لنوع المصنع
- حقل **الاهتمامات** (checkboxes) لتخصيص التجربة
- **الحقول**: `User.account_type`, `User.company_name`, `User.interests_json`
- **الملفات**: `app/routes/auth.py` → `register()`, `app/templates/auth/register.html`

### 2. لوحات تحكم حسب الدور (Role-Based Dashboards)
- **صاحب فكرة**: لوحة التحكم الرئيسية مع دراسات الجدوى والطلبات
- **مصنع**: يُوجَّه تلقائياً إلى `/prototyping/factory/dashboard`
- **مدير**: لوحة إدارة مع قائمة طلبات النماذج وموافقات NDA
- عند تسجيل مستخدم كـ `factory`، يُنشأ سجل `FactoryPartner` تلقائياً
- **الملفات**: `app/routes/dashboard.py` → `index()`

### 3. إشعارات ذكية متقدمة (Smart Notifications)
إشعارات فورية داخل التطبيق عند كل حدث مهم:

| الحدث | المستلم |
|-------|---------|
| طلب نموذج أولي جديد | المصنع |
| إرسال NDA للموافقة | المدير |
| موافقة/رفض المدير على NDA | المستخدم + المصنع |
| موافقة/رفض المصنع على NDA | المستخدم + المدير |
| عرض سعر جديد | المستخدم |
| رسالة جديدة في المحادثة | الطرف الآخر |

- كل إشعار يحتوي: **عنوان**، **وصف**، **رابط مباشر**، **تصنيف**
- **الدالة**: `notify(user_id, title, body, category, link)`
- **النموذج**: `Notification`

### 4. سوق المشاريع (Project Marketplace)
- عرض وبيع دراسات الجدوى والمشاريع الجاهزة
- تصفية حسب القطاع والسعر والتقييم
- نظام استفسارات ومراجعات
- **المسار**: `/marketplace`
- **الملفات**: `app/routes/marketplace.py`

### 5. مراقبة السوق (Market Monitor)
- تتبع المنافسين في الوقت الحقيقي
- تنبيهات السوق عند تغييرات مهمة
- تقارير مقارنة دورية
- **المسار**: `/market/<report_id>`
- **الملفات**: `app/routes/market_monitor.py`

### 6. مؤشرات الأداء KPIs (KPI Tracking)
- تعريف مؤشرات أداء مخصصة لكل مشروع
- تتبع القيم الفعلية مقابل المستهدفة
- رسوم بيانية وتقارير أداء
- **المسار**: `/kpis/<report_id>`
- **الملفات**: `app/routes/kpis.py`

### 7. خارطة طريق المشروع (Project Roadmap)
- معالم (Milestones) ومهام (Tasks) لكل مشروع
- تتبع التقدم والإنجاز بصرياً
- ربط المعالم بالتواريخ المستهدفة
- **المسار**: `/roadmap/<report_id>`
- **الملفات**: `app/routes/roadmap.py`

---

## 🗄️ التغييرات في قاعدة البيانات

### حقول جديدة في `User`:
| الحقل | النوع | الوصف |
|-------|-------|-------|
| `account_type` | `String(20)` | نوع الحساب: owner/investor/factory/incubator |
| `company_name` | `String(200)` | اسم الشركة (للمصانع) |
| `interests_json` | `JSON` | اهتمامات المستخدم |
| `factory_partner_id` | `Integer` | ربط بسجل المصنع |

### حقول جديدة في `PrototypeRequest`:
| الحقل | النوع | الوصف |
|-------|-------|-------|
| `nda_html` | `Text` | محتوى NDA المولّد |
| `nda_status` | `String(20)` | حالة NDA |
| `nda_generated_at` | `DateTime` | تاريخ توليد NDA |
| `nda_approved_at` | `DateTime` | تاريخ اعتماد NDA |
| `cost_estimate_json` | `JSON` | بيانات تقدير التكلفة |
| `cost_estimate_generated_at` | `DateTime` | تاريخ توليد التقدير |

### حقل جديد في `FactoryPartner`:
| الحقل | النوع | الوصف |
|-------|-------|-------|
| `user_id` | `Integer` | ربط المصنع بحساب مستخدم |

> **ملاحظة**: جميع الحقول الجديدة تُضاف تلقائياً عند تشغيل التطبيق عبر دالة `safe_migrate()` في `app/__init__.py` بدون الحاجة لـ Alembic.

---

## 🔗 APIs الجديدة

### Prototyping APIs:
| Method | Endpoint | الوصف |
|--------|----------|-------|
| `POST` | `/prototyping/api/generate-nda` | توليد NDA بالـ AI |
| `POST` | `/prototyping/api/estimate-cost` | تقدير التكلفة بالـ AI |
| `POST` | `/prototyping/api/send-nda/<id>` | إرسال NDA للمدير |
| `POST` | `/prototyping/api/admin-approve-nda/<id>` | موافقة المدير |
| `POST` | `/prototyping/api/admin-reject-nda/<id>` | رفض المدير |
| `POST` | `/prototyping/api/factory-approve-nda/<id>` | موافقة المصنع |
| `POST` | `/prototyping/api/factory-reject-nda/<id>` | رفض المصنع |
| `POST` | `/prototyping/factory/request/<id>/quote` | تقديم عرض سعر |
| `POST` | `/prototyping/api/send-message/<id>` | إرسال رسالة |

### Factory Routes:
| Method | Endpoint | الوصف |
|--------|----------|-------|
| `GET` | `/prototyping/factory/dashboard` | لوحة المصنع |
| `GET` | `/prototyping/factory/request/<id>` | تفاصيل طلب |

### Admin Routes:
| Method | Endpoint | الوصف |
|--------|----------|-------|
| `GET` | `/admin/prototype-requests` | قائمة الطلبات |
| `GET` | `/admin/prototype-requests/<id>` | تفاصيل طلب |

---

## 📁 الملفات المعدّلة والجديدة

### ملفات معدّلة:
- `app/models/user.py` — حقول الأدوار الجديدة
- `app/models/services.py` — حقول NDA والتكلفة و user_id
- `app/__init__.py` — safe_migrate للحقول الجديدة
- `app/routes/auth.py` — تسجيل مع نوع الحساب
- `app/routes/prototyping.py` — APIs جديدة + لوحة المصنع
- `app/routes/dashboard.py` — توجيه المصنع
- `app/routes/admin.py` — إدارة الطلبات و NDA
- `app/templates/auth/register.html` — نموذج تسجيل محدّث
- `app/templates/prototyping/request.html` — عرض NDA والتكلفة المحفوظة
- `app/templates/prototyping/view_request.html` — عرض NDA والتكلفة
- `app/templates/admin/prototype_requests.html` — عمود حالة NDA
- `app/i18n.py` — ترجمات المزايا الجديدة
- `app/templates/landing.html` — فئتان جديدتان بشارة NEW
- `app/templates/marketing/brochure.html` — قسمان جديدان + تصحيح الدومين

### ملفات جديدة:
- `app/templates/prototyping/factory_dashboard.html` — لوحة المصنع
- `app/templates/prototyping/factory_view_request.html` — تفاصيل الطلب للمصنع
- `app/templates/admin/prototype_detail.html` — تفاصيل الطلب للمدير

---

## 🧪 كيفية الاختبار

### اختبار نظام الأدوار:
1. سجّل حساب جديد واختر نوع **مصنع**
2. تأكد من ظهور حقل اسم الشركة
3. بعد التسجيل، تأكد من التوجيه إلى لوحة المصنع

### اختبار NDA Workflow:
1. أنشئ دراسة جدوى → اذهب لطلب نموذج أولي
2. ولّد NDA بالـ AI → تأكد من الحفظ
3. أرسل NDA للمدير → تحقق من الإشعار
4. سجّل كمدير → وافق على NDA → تحقق من الإشعار للمصنع
5. سجّل كمصنع → وافق على NDA → تحقق من الحالة `approved`

### اختبار عروض الأسعار:
1. سجّل كمصنع → افتح طلب وارد
2. قدّم عرض سعر → تحقق من الإشعار للمستخدم
3. أرسل رسالة في المحادثة → تحقق من الاستلام

---

*Jadwa AI — من الفكرة إلى التنفيذ*
*jadwaai.com*