# شرح الربط بقاعدة البيانات

## ✅ تم إنشاء نظام قاعدة البيانات SQLite

### الملفات الجديدة:

1. **server/db.js**
   - إعداد قاعدة البيانات SQLite
   - إنشاء الجداول (Users, Branches, Employees, Suppliers, Categories, Products, Sales, Inventory)
   - تفعيل WAL mode للأداء الأفضل

2. **server/routes.js**
   - جميع API endpoints للتطبيق
   - CRUD operations لكل جدول
   - معالجة الأخطاء

3. **server/server-new.js**
   - خادم Express بسيط وفعال
   - middleware للـ CORS و Body Parser
   - routing للـ API

---

## 🚀 كيفية التثبيت والتشغيل

### 1. تثبيت المتطلبات
```bash
cd server
npm install
```

### 2. تشغيل الخادم
```bash
npm start
```

### 3. التحقق من الاتصال
تفتح المتصفح وتذهب إلى:
```
http://localhost:3000/api/health
```

يجب أن ترى:
```json
{"status":"ok","message":"Server is running"}
```

---

## 📊 جداول قاعدة البيانات

### 0. **Users** (المستخدمين)
- id, username (فريد), password, name, email
- role (admin/user), status (نشط/غير نشط), last_login
- timestamps: created_at, updated_at

### 1. **Branches** (الفروع)
- id, code, name, contact, phone, email, address, active
- timestamps: created_at, updated_at

### 2. **Employees** (الموظفين)
- id, code, name, fileNumber, nationalId, email, phone, position
- nationality, workLocation, appointmentDate, residenceEndDate, permitEndDate
- salary, active
- timestamps: created_at, updated_at

### 3. **Suppliers** (الموردين)
- id, code, company, representative, phone, email, address, categories, active
- timestamps: created_at, updated_at

### 4. **Categories** (التصنيفات)
- id, code, name, active
- timestamps: created_at, updated_at

### 5. **Products** (المنتجات)
- id, code, name, barcode, categoryId, supplierId, price, cost
- description, unit, package, active
- Foreign Keys: categoryId, supplierId
- timestamps: created_at, updated_at

### 6. **Sales** (المبيعات)
- id, code, customerName, total, items, paymentMethod, notes
- timestamps: created_at, updated_at

### 7. **Inventory** (المخزون)
- id, productId, quantity, minStock, branchId, updated_at
- Foreign Keys: productId, branchId

---

## 🔗 API Endpoints

### Users
- `GET /api/users` - الحصول على جميع المستخدمين
- `GET /api/users/:id` - الحصول على مستخدم معين
- `POST /api/users` - إضافة مستخدم جديد
- `PUT /api/users/:id` - تعديل مستخدم
- `DELETE /api/users/:id` - حذف مستخدم
- `POST /api/users/login` - تسجيل دخول
- `PUT /api/users/:id/login` - تحديث آخر دخول

### Branches
- `GET /api/branches` - الحصول على جميع الفروع
- `POST /api/branches` - إضافة فرع جديد
- `PUT /api/branches/:id` - تعديل فرع
- `DELETE /api/branches/:id` - حذف فرع

### Employees
- `GET /api/employees` - الحصول على جميع الموظفين
- `POST /api/employees` - إضافة موظف جديد
- `PUT /api/employees/:id` - تعديل موظف
- `DELETE /api/employees/:id` - حذف موظف

### Suppliers
- `GET /api/suppliers` - الحصول على جميع الموردين
- `POST /api/suppliers` - إضافة مورد جديد
- `PUT /api/suppliers/:id` - تعديل مورد
- `DELETE /api/suppliers/:id` - حذف مورد

### Categories
- `GET /api/categories` - الحصول على جميع التصنيفات
- `POST /api/categories` - إضافة تصنيف جديد
- `PUT /api/categories/:id` - تعديل تصنيف
- `DELETE /api/categories/:id` - حذف تصنيف

### Products
- `GET /api/products` - الحصول على جميع المنتجات
- `POST /api/products` - إضافة منتج جديد
- `PUT /api/products/:id` - تعديل منتج
- `DELETE /api/products/:id` - حذف منتج

### Sales
- `GET /api/sales` - الحصول على جميع المبيعات
- `POST /api/sales` - إضافة مبيعة جديدة

### Inventory
- `GET /api/inventory` - الحصول على بيانات المخزون
- `POST /api/inventory` - إضافة منتج للمخزون
- `PUT /api/inventory/:id` - تحديث كمية المخزون

---

## 📝 مثال على استخدام API

### إضافة مورد جديد
```javascript
fetch('http://localhost:3000/api/suppliers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    code: 'SUP001',
    company: 'شركة النور',
    representative: 'أحمد علي',
    phone: '0501234567',
    email: 'info@noor.com',
    address: 'الكويت',
    categories: 5,
    active: true
  })
})
.then(res => res.json())
.then(data => console.log('تم الإضافة:', data))
.catch(err => console.error('خطأ:', err));
```

---

## ⚙️ ملاحظات مهمة

1. **Better-sqlite3** يتطلب الكمبايل - قد تحتاج مكتبات الكمبايل على جهازك
   - على Windows: تحتاج Visual Studio Build Tools
   - إذا حدثت مشاكل، استخدم sqlite3 بدلاً منه

2. البيانات تُحفظ في `server/data/supermarket.db`

3. يمكنك استعراض قاعدة البيانات باستخدام:
   - DB Browser for SQLite (تطبيق سطح المكتب)
   - DBeaver

4. جميع التواريخ تُحفظ بصيغة ISO 8601

---

## 🔄 الخطوات التالية

بمجرد تثبيت المتطلبات:

1. `npm install` في مجلد server
2. `npm start` لتشغيل الخادم
3. اختبر الـ API من المتصفح أو Postman
4. التطبيق سيحفظ البيانات تلقائياً في SQLite
