# جدول المستخدمين - دليل سريع

## ✅ ما تم إنشاؤه

### 1. **جدول قاعدة البيانات** (Users Table)
- معرّف فريد (id)
- اسم المستخدم (username) - فريد
- كلمة السر (password)
- الاسم (name)
- البريد الإلكتروني (email)
- الدور (role) - admin أو user
- الحالة (status) - نشط (1) أو غير نشط (0)
- آخر دخول (last_login)
- تواريخ الإنشاء والتحديث

### 2. **API Routes** (الـ واجهات البرمجية)

```
✓ 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    - تحديث آخر دخول
```

### 3. **واجهة المستخدم** (HTML)
- صفحة `public/users.html` لإدارة المستخدمين
- واجهة جميلة وسهلة الاستخدام
- إضافة/تعديل/حذف مستخدمين
- بحث وتصفية
- إحصائيات سريعة

---

## 🚀 البدء السريع

### 1. تشغيل الخادم
```bash
cd server
npm start
```

### 2. فتح صفحة إدارة المستخدمين
```
http://localhost:3000/users.html
```

### 3. إضافة مستخدم جديد
- املأ النموذج بالبيانات
- اضغط على "إضافة مستخدم"

---

## 📋 الملفات المعدلة والمضافة

### الملفات المضافة:
- ✅ `public/users.html` - صفحة إدارة المستخدمين
- ✅ `USERS_TABLE_GUIDE.md` - دليل شامل
- ✅ `USERS_QUICK_GUIDE.md` - هذا الملف

### الملفات المعدلة:
- ✅ `server/db.js` - أضيف جدول users
- ✅ `server/routes.js` - أضيفت جميع الـ routes
- ✅ `DATABASE_SETUP.md` - تحديث الوثائق

---

## 💻 أمثلة الاستخدام

### إضافة مستخدم عبر JavaScript
```javascript
fetch('http://localhost:3000/api/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'ahmed',
    password: 'password123',
    name: 'أحمد محمد',
    email: 'ahmed@example.com',
    role: 'user',
    status: true
  })
})
.then(r => r.json())
.then(data => console.log('تم الإضافة:', data));
```

### تسجيل الدخول
```javascript
fetch('http://localhost:3000/api/users/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'ahmed',
    password: 'password123'
  })
})
.then(r => r.json())
.then(data => {
  if (data.id) {
    console.log('تسجيل دخول ناجح:', data);
  }
});
```

### تعديل مستخدم
```javascript
fetch('http://localhost:3000/api/users/1', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'أحمد محمود',
    role: 'admin',
    status: true
  })
})
.then(r => r.json())
.then(data => console.log('تم التحديث:', data));
```

---

## 🔒 ملاحظات الأمان

⚠️ **ملاحظات مهمة:**
1. كلمة السر تُحفظ بدون تشفير حالياً
   - تحتاج إلى استخدام bcrypt لتشفير
   
2. لا توجد حماية JWT حالياً
   - أضفِ JWT tokens للأمان

3. لا توجد تحقق من الصلاحيات
   - أضفِ middleware للتحقق من الأدوار

---

## 📊 استخدام جدول المستخدمين

### الدخول كمسؤول
```javascript
// مثال: إضافة مستخدم بصلاحيات admin
{
  username: 'admin',
  password: 'admin123',
  name: 'مدير النظام',
  role: 'admin',
  status: true
}
```

### الدخول كمستخدم عادي
```javascript
// مثال: إضافة مستخدم عادي
{
  username: 'user1',
  password: 'user123',
  name: 'محمد علي',
  role: 'user',
  status: true
}
```

---

## 🧪 اختبار الـ API

### باستخدام cURL

```bash
# إضافة مستخدم
curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{
    "username": "testuser",
    "password": "test123",
    "name": "مستخدم اختبار"
  }'

# تسجيل دخول
curl -X POST http://localhost:3000/api/users/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "testuser",
    "password": "test123"
  }'

# الحصول على جميع المستخدمين
curl http://localhost:3000/api/users

# تعديل مستخدم
curl -X PUT http://localhost:3000/api/users/1 \
  -H "Content-Type: application/json" \
  -d '{"name": "اسم جديد"}'

# حذف مستخدم
curl -X DELETE http://localhost:3000/api/users/1
```

---

## ✨ الخطوات التالية

1. ✅ جدول المستخدمين تم إنشاؤه
2. ✅ API routes تم إضافتها
3. ✅ واجهة المستخدم تم إنشاؤها
4. ⏭️ أضفِ تشفير كلمة السر (bcrypt)
5. ⏭️ أضفِ JWT tokens
6. ⏭️ أضفِ middleware التحقق من الصلاحيات

---

## 📚 ملفات المرجع

- `USERS_TABLE_GUIDE.md` - دليل شامل مع أمثلة متقدمة
- `DATABASE_SETUP.md` - معلومات قاعدة البيانات
- `public/users.html` - واجهة الإدارة

---

**تم الإنشاء بنجاح! ✅**

النظام جاهز للاستخدام الآن.
