# تثبيت TIJARA من الصفر (كود + قاعدة بيانات + تطبيق)

هذا **نفس مشروع TIJARA** جاهز لإعادة التثبيت بالكامل (ليس تطبيقاً منفصلاً).

---

## 1) تحميل الكود

من GitHub (الفرع الحالي):

https://github.com/stegeoflotte-dev/dev/archive/refs/heads/cursor/gestion-commerciale-maroc-6eed.zip

أو من الحزمة الجاهزة في المستودع: `releases/TIJARA-FRESH-INSTALL.zip`

بعد فك الضغط ستجد:

```
php/          ← الموقع + API
flutter_app/  ← تطبيق أندرويد
```

---

## 2) قاعدة بيانات جديدة (MySQL / Namecheap)

1. cPanel → **MySQL Databases**
2. أنشئ قاعدة جديدة + مستخدم + صلاحيات ALL
3. phpMyAdmin → اختر القاعدة الفارغة
4. **Import** بالترتيب:
   - اختياري إن كانت القاعدة قديمة: `php/sql/drop_all.mysql.sql`
   - ثم: `php/sql/schema_full.mysql.sql`  ← **كل الجداول دفعة واحدة**

---

## 3) رفع الملفات

الهيكل الموصى به:

```
/home/USER/tijara/
  includes/
  sql/
  storage/
  uploads/
  public/     ← Document Root للدومين / السابدومين
```

انسخ:

- محتوى `php/public/` → Document Root
- `php/includes/` و `php/sql/` و `php/storage/` و `php/uploads/` بجانب `public`

---

## 4) الإعدادات

```bash
cp includes/config.example.php includes/config.php
```

عدّل `includes/config.php`:

- `db_driver` => `mysql`
- اسم القاعدة / المستخدم / كلمة السر
- `app_url` => رابط موقعك
- `jwt_secret` => غيّره

---

## 5) تعبئة البيانات التجريبية (Seed)

### أ) عبر المتصفح (بدون SSH)

افتح:

```
https://VOTRE-DOMAINE/install_web.php?key=tijara-install-2026&fresh=1
```

`fresh=1` = مسح وإعادة تثبيت كامل.

**احذف `install_web.php` مباشرة بعد النجاح.**

### ب) عبر SSH

```bash
cd ~/tijara
php sql/fresh_install.php
```

---

## 6) الدخول

| الحساب | البريد | كلمة السر |
|--------|--------|-----------|
| Admin | admin@atlastech.ma | admin123 |
| Commercial | commercial@atlastech.ma | demo123 |
| Comptable | comptable@atlastech.ma | demo123 |
| Flotte | flotte@atlastech.ma | demo123 |
| Chauffeur | chauffeur@atlastech.ma | demo123 |

**غيّر كلمة سر الأدمن فوراً في الإنتاج.**

---

## 7) تطبيق Flutter (جديد على الهاتف)

```bash
cd flutter_app
flutter pub get
flutter build apk --dart-define=API_URL=https://VOTRE-DOMAINE
```

ثبّت ملف:

`flutter_app/build/app/outputs/flutter-apk/app-release.apk`

---

## ماذا يشمل التثبيت؟

- ERP تجاري (عملاء، عروض، فواتير، مدفوعات…)
- مشتريات / فواتير موردين / OCR / GED
- أسطول / سائقين / مهمات
- وحدات اختيارية (modules) قابلة للتفعيل لكل شركة
- عقود / GPS / مساعد IA (stubs)
- تمارين مالية + ترقيم
- i18n: FR / AR / EN

---

## إعادة تثبيت لاحقاً

1. نفّذ `drop_all.mysql.sql` أو أنشئ قاعدة جديدة فارغة  
2. استورد `schema_full.mysql.sql`  
3. شغّل `fresh_install.php` أو `install_web.php?key=…&fresh=1`