🛒 متجر الأجهزة الذكية - Smart Devices Store

📋 نظرة عامة

متجر إلكتروني متكامل لبيع الأجهزة الذكية مع نظام إدارة شامل، مطور باستخدام PHP و MySQL مع واجهة مستخدم حديثة ومتجاوبة.

🌟 الميزات الرئيسية

• ✅ واجهة مستخدم حديثة - تصميم متجاوب وجذاب
• ✅ نظام مستخدمين متكامل - تسجيل، دخول، ملفات شخصية
• ✅ إدارة منتجات ديناميكية - فئات، علامات تجارية، مواصفات
• ✅ نظام تسوق متقدم - سلة، طلبات، دفع
• ✅ نظام نقاط ومكافآت - نقاط الولاء وعجلة الحظ
• ✅ نظام تقييمات - مراجعات وتقييمات المنتجات
• ✅ لوحة إدارة شاملة - إدارة كاملة للمتجر
• ✅ أمان عالي - حماية من الثغرات الشائعة

---

🛠️ التقنيات المستخدمة

Backend

• PHP 7.4+ - لغة البرمجة الخلفية
• MySQL 5.7+ - قاعدة البيانات
• PDO - للتفاعل مع قاعدة البيانات
• JSON - لتخزين البيانات المعقدة

Frontend

• HTML5 & CSS3 - هيكل وتصميم الصفحات
• Bootstrap 5 - إطار عمل CSS
• JavaScript (ES6+) - التفاعل والديناميكية
• jQuery - مكتبة JavaScript
• Font Awesome - الأيقونات

أدوات التطوير

• phpMyAdmin - إدارة قاعدة البيانات
• Apache/Nginx - خادم الويب
• Git - نظام التحكم في الإصدارات

---

📁 هيكل المشروع

smart-store/
├── 📁 htmlpage/              # صفحات الواجهة الأمامية
│   ├── home.html            # الصفحة الرئيسية
│   ├── pageApple.html       # صفحة منتجات Apple
│   ├── pageSAMSING.html     # صفحة منتجات Samsung
│   ├── pageHuawie.html      # صفحة منتجات Huawei
│   ├── pageMSI.html         # صفحة منتجات MSI
│   ├── services.html        # صفحة الخدمات
│   ├── login.html           # صفحة تسجيل الدخول
│   └── ...                 # صفحات أخرى
├── 📁 backend/              # الجزء الخلفي
│   ├── 📁 config/          # ملفات التكوين
│   │   ├── database.php    # إعدادات قاعدة البيانات
│   │   └── config.php      # الإعدادات العامة
│   ├── 📁 models/          # نماذج البيانات
│   │   ├── User.php        # نموذج المستخدم
│   │   ├── Product.php     # نموذج المنتج
│   │   └── ...            # نماذج أخرى
│   ├── 📁 controllers/     # المتحكمات
│   ├── 📁 api/            # واجهات برمجة التطبيقات
│   └── 📁 uploads/        # الملفات المرفوعة
├── 📁 database/            # ملفات قاعدة البيانات
│   └── store_db.sql       # هيكل قاعدة البيانات
├── 📁 cssfile/            # ملفات CSS
├── 📁 javascript/         # ملفات JavaScript
├── 📁 img/               # الصور والوسائط
├── 📁 logs/              # ملفات السجلات
├── test_connection.php    # اختبار الاتصال
└── README.md             # هذا الملف

---

🚀 التثبيت والإعداد

المتطلبات الأساسية

• PHP 7.4 أو أحدث
• MySQL 5.7 أو MariaDB 10.3 أو أحدث
• Apache أو Nginx
• phpMyAdmin (اختياري لإدارة قاعدة البيانات)

خطوات التثبيت

1. تحميل المشروع

git clone https://github.com/your-username/smart-store.git
cd smart-store

2. إعداد قاعدة البيانات

-- في phpMyAdmin أو MySQL CLI
CREATE DATABASE store_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE store_db;
SOURCE database/store_db.sql;

3. تكوين الإعدادات

// في backend/config/database.php
define('DB_HOST', 'localhost');
define('DB_NAME', 'store_db');
define('DB_USER', 'your_username');
define('DB_PASS', 'your_password');

4. إعداد الصلاحيات

# إعطاء صلاحيات الكتابة للمجلدات
chmod 755 backend/uploads/
chmod 755 logs/
chmod 755 cache/

5. اختبار التثبيت

افتح المتصفح واذهب إلى:
http://localhost/smart-store/test_connection.php

---

🗄️ قاعدة البيانات

الجداول الرئيسية

الجدول	الوصف	العلاقات
users	بيانات المستخدمين	-
categories	فئات المنتجات	Self-referencing
brands	العلامات التجارية	-
products	المنتجات	categories, brands
orders	الطلبات	users
order_items	تفاصيل الطلبات	orders, products
cart	سلة التسوق	users, products
reviews	التقييمات	users, products
user_points	نقاط المستخدمين	users
coupons	كوبونات الخصم	-
notifications	الإشعارات	users

البيانات الافتراضية

• مستخدم إداري: admin@smartstore.ps / password
• فئات أساسية: الهواتف، اللابتوبات، الأجهزة اللوحية، إلخ
• علامات تجارية: Apple, Samsung, Huawei, MSI, إلخ

---

🔧 الاستخدام

للمطورين

إنشاء نموذج جديد

<?php
require_once '../config/config.php';

class NewModel {
    private $db;
    private $table = 'table_name';

    public function __construct() {
        $this->db = getDB();
    }

    public function getAll() {
        return $this->db->select("SELECT * FROM {$this->table}");
    }
}
?>

إنشاء API endpoint

<?php
require_once '../config/config.php';
require_once '../models/NewModel.php';

header('Content-Type: application/json');

if ($_SERVER['REQUEST_METHOD'] === 'GET') {
    $model = new NewModel();
    $data = $model->getAll();
    echo json_encode(['success' => true, 'data' => $data]);
}
?>

للمستخدمين

1. التسجيل: إنشاء حساب جديد
2. تسجيل الدخول: الدخول للحساب
3. تصفح المنتجات: استعراض الفئات والمنتجات
4. إضافة للسلة: إضافة المنتجات المرغوبة
5. إتمام الطلب: إجراء عملية الشراء
6. تتبع الطلبات: متابعة حالة الطلبات

---

🔒 الأمان

الحماية المطبقة

• SQL Injection: استخدام Prepared Statements
• XSS: تنظيف البيانات قبل العرض
• CSRF: رموز الحماية للنماذج
• Password Hashing: تشفير كلمات المرور
• Session Security: إدارة آمنة للجلسات
• Input Validation: التحقق من صحة البيانات

---

📊 الميزات المتقدمة

نظام النقاط

• نقاط التسجيل: 50 نقطة
• نقاط المراجعة: 10 نقاط
• نقاط الشراء: 1 نقطة لكل دولار
• استخدام النقاط: خصم من المشتريات

عجلة الحظ

• 3 مرات يومياً لكل مستخدم
• جوائز متنوعة: نقاط، خصومات، منتجات
• فترة انتظار: 8 ساعات بين المحاولات

نظام التقييمات

• تقييم بالنجوم: من 1 إلى 5
• مراجعات نصية: تعليقات مفصلة
• التحقق من الشراء: مراجعات موثقة
• إدارة المراجعات: موافقة الإدارة

---

🧪 الاختبار

اختبار الاتصال

# افتح في المتصفح
http://localhost/smart-store/test_connection.php

---

📈 خارطة الطريق

الإصدار الحالي (v1.0)

• ✅ نظام المستخدمين الأساسي
• ✅ إدارة المنتجات
• ✅ نظام التسوق
• ✅ نظام النقاط

الإصدارات القادمة

v1.1

• 🔄 نظام الدفع الإلكتروني
• 🔄 تطبيق الهاتف المحمول
• 🔄 نظام التوصيل

v1.2

• 📋 تحليلات متقدمة
• 📋 نظام CRM
• 📋 تكامل مع وسائل التواصل

---

تم تطوير هذا المشروع بـ ❤️ في فلسطين 🇵🇸