<?php
/**
 * database.php - اتصال قاعدة بيانات نظام AUTO TESTER
 * 
 * هذا الملف مسؤول عن إنشاء وإدارة الاتصال بقاعدة البيانات
 * يدعم PDO و MySQLi مع خيارات متعددة
 */

// =====================================================
// إعدادات قاعدة البيانات
// =====================================================

// إعدادات البيئة (يمكن نقلها إلى ملف .env في الإنتاج)
define('DB_HOST', 'localhost');           // عنوان الخادم
define('DB_NAME', 'auto_tester_db');      // اسم قاعدة البيانات
define('DB_USER', 'root');                 // اسم المستخدم
define('DB_PASS', '');                     // كلمة المرور
define('DB_CHARSET', 'utf8mb4');           // الترميز

// إعدادات إضافية
define('DB_PORT', 3306);                   // منفذ MySQL الافتراضي
define('DB_SOCKET', null);                 // Socket (اختياري)

// =====================================================
// فئة إدارة قاعدة البيانات (PDO)
// =====================================================

class Database {
    private static $instance = null;
    private $connection;
    private $connected = false;
    
    /**
     * منع الإنشاء المباشر (Singleton Pattern)
     */
    private function __construct() {
        $this->connect();
    }
    
    /**
     * الحصول على نسخة واحدة من الاتصال (Singleton)
     * @return Database
     */
    public static function getInstance() {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
    
    /**
     * إنشاء اتصال PDO بقاعدة البيانات
     */
    private function connect() {
        try {
            // بناء DSN
            $dsn = "mysql:host=" . DB_HOST . 
                   ";dbname=" . DB_NAME . 
                   ";charset=" . DB_CHARSET .
                   ";port=" . DB_PORT;
            
            // خيارات PDO لتحسين الأداء والأمان
            $options = [
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,      // رمي الاستثناءات عند الأخطاء
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // جلب البيانات كمصفوفة ترابطية
                PDO::ATTR_EMULATE_PREPARES => false,              // استخدام prepared statements حقيقية
                PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES " . DB_CHARSET,
                PDO::ATTR_PERSISTENT => false                      // اتصال عادي (غير دائم)
            ];
            
            // إنشاء الاتصال
            $this->connection = new PDO($dsn, DB_USER, DB_PASS, $options);
            $this->connected = true;
            
            // تعيين الترميز والوقت
            $this->connection->exec("SET NAMES '" . DB_CHARSET . "' COLLATE '" . DB_CHARSET . "_unicode_ci'");
            $this->connection->exec("SET time_zone = '+03:00'"); // توقيت مصر
            $this->connection->exec("SET SESSION sql_mode = ''"); // إلغاء strict mode
        
        } catch (PDOException $e) {
            $this->connected = false;
            $this->handleConnectionError($e);
        }
    }
    
    /**
     * معالجة أخطاء الاتصال
     */
    private function handleConnectionError($e) {
        $errorMessage = "خطأ في الاتصال بقاعدة البيانات: ";
        
        switch ($e->getCode()) {
            case 1045:
                $errorMessage .= "اسم المستخدم أو كلمة المرور غير صحيحة.";
                break;
            case 1049:
                $errorMessage .= "قاعدة البيانات غير موجودة. يرجى إنشاؤها أولاً.";
                break;
            case 2002:
                $errorMessage .= "لا يمكن الاتصال بخادم قاعدة البيانات. تأكد من أن MySQL يعمل.";
                break;
            default:
                $errorMessage .= $e->getMessage();
        }
        
        // تسجيل الخطأ في السجل
        error_log($errorMessage . " - " . date('Y-m-d H:i:s'), 3, __DIR__ . '/../logs/db_errors.log');
        
        // في بيئة التطوير، عرض الخطأ؛ في الإنتاج، تسجيل فقط
        if ($this->isDevelopment()) {
            die($errorMessage);
        } else {
            die("عذراً، حدث خطأ في النظام. يرجى المحاولة لاحقاً.");
        }
    }
    
    /**
     * التحقق من بيئة التطوير
     */
    private function isDevelopment() {
        return $_SERVER['SERVER_NAME'] === 'localhost' || 
               $_SERVER['SERVER_ADDR'] === '127.0.0.1' ||
               strpos($_SERVER['SERVER_NAME'], '.test') !== false;
    }
    
    /**
     * الحصول على اتصال PDO
     * @return PDO
     */
    public function getConnection() {
        if (!$this->connected) {
            $this->connect();
        }
        return $this->connection;
    }
    
    /**
     * بدء معاملة (Transaction)
     */
    public function beginTransaction() {
        if ($this->connected) {
            return $this->connection->beginTransaction();
        }
        return false;
    }
    
    /**
     * تأكيد المعاملة (Commit)
     */
    public function commit() {
        if ($this->connected) {
            return $this->connection->commit();
        }
        return false;
    }
    
    /**
     * التراجع عن المعاملة (Rollback)
     */
    public function rollback() {
        if ($this->connected) {
            return $this->connection->rollBack();
        }
        return false;
    }
    
    /**
     * إعداد جملة محضرة (Prepared Statement)
     */
    public function prepare($sql) {
        return $this->getConnection()->prepare($sql);
    }
    
    /**
     * تنفيذ استعلام مباشر
     */
    public function query($sql) {
        return $this->getConnection()->query($sql);
    }
    
    /**
     * الحصول على آخر ID تم إدراجه
     */
    public function lastInsertId() {
        return $this->getConnection()->lastInsertId();
    }
    
    /**
     * تعداد الصفوف المتأثرة
     */
    public function rowCount($statement) {
        return $statement->rowCount();
    }
    
    /**
     * إغلاق الاتصال
     */
    public function close() {
        $this->connection = null;
        $this->connected = false;
    }
    
    /**
     * منع الاستنساخ
     */
    private function __clone() {}
    
    /**
     * منع إلغاء التسلسل
     */
    public function __wakeup() {}
}

// =====================================================
// دوال مساعدة للاستخدام السريع
// =====================================================

/**
 * الحصول على اتصال قاعدة البيانات (دالة مساعدة)
 * @return PDO
 */
function getDatabaseConnection() {
    return Database::getInstance()->getConnection();
}

/**
 * تنفيذ استعلام وجلب جميع النتائج
 * @param string $sql استعلام SQL
 * @param array $params معاملات الاستعلام
 * @return array
 */
function dbQueryAll($sql, $params = []) {
    $db = Database::getInstance();
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->fetchAll();
}

/**
 * تنفيذ استعلام وجلب صف واحد
 * @param string $sql استعلام SQL
 * @param array $params معاملات الاستعلام
 * @return array|null
 */
function dbQueryOne($sql, $params = []) {
    $db = Database::getInstance();
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->fetch();
}

/**
 * تنفيذ استعلام وجلب قيمة واحدة
 * @param string $sql استعلام SQL
 * @param array $params معاملات الاستعلام
 * @return mixed
 */
function dbQueryValue($sql, $params = []) {
    $db = Database::getInstance();
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->fetchColumn();
}

/**
 * تنفيذ استعلام تعديل (INSERT, UPDATE, DELETE)
 * @param string $sql استعلام SQL
 * @param array $params معاملات الاستعلام
 * @return int عدد الصفوف المتأثرة
 */
function dbExecute($sql, $params = []) {
    $db = Database::getInstance();
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->rowCount();
}

/**
 * إدراج بيانات في جدول
 * @param string $table اسم الجدول
 * @param array $data مصفوفة البيانات (column => value)
 * @return int|false آخر ID تم إدراجه أو false في حالة الفشل
 */
function dbInsert($table, $data) {
    $db = Database::getInstance();
    $columns = array_keys($data);
    $placeholders = array_fill(0, count($columns), '?');
    
    $sql = "INSERT INTO `$table` (`" . implode('`, `', $columns) . "`) VALUES (" . implode(', ', $placeholders) . ")";
    $stmt = $db->prepare($sql);
    
    $values = array_values($data);
    if ($stmt->execute($values)) {
        return $db->lastInsertId();
    }
    return false;
}

/**
 * تحديث بيانات في جدول
 * @param string $table اسم الجدول
 * @param array $data مصفوفة البيانات (column => value)
 * @param string $where شرط التحديث
 * @param array $whereParams معاملات الشرط
 * @return int عدد الصفوف المتأثرة
 */
function dbUpdate($table, $data, $where, $whereParams = []) {
    $db = Database::getInstance();
    $set = [];
    $params = [];
    
    foreach ($data as $column => $value) {
        $set[] = "`$column` = ?";
        $params[] = $value;
    }
    
    $params = array_merge($params, $whereParams);
    $sql = "UPDATE `$table` SET " . implode(', ', $set) . " WHERE $where";
    
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->rowCount();
}

/**
 * حذف بيانات من جدول
 * @param string $table اسم الجدول
 * @param string $where شرط الحذف
 * @param array $params معاملات الشرط
 * @return int عدد الصفوف المتأثرة
 */
function dbDelete($table, $where, $params = []) {
    $db = Database::getInstance();
    $sql = "DELETE FROM `$table` WHERE $where";
    $stmt = $db->prepare($sql);
    $stmt->execute($params);
    return $stmt->rowCount();
}

// =====================================================
// التحقق من الاتصال وإنشاء الجداول إذا لزم الأمر
// =====================================================

/**
 * التحقق من وجود الجداول الأساسية وإنشاؤها إذا لزم الأمر
 */
function ensureDatabaseTables() {
    try {
        $db = Database::getInstance()->getConnection();
        
        // التحقق من وجود جدول users
        $result = $db->query("SHOW TABLES LIKE 'users'");
        if ($result->rowCount() === 0) {
            // إنشاء الجداول الأساسية تلقائياً
            $sql = "
                CREATE TABLE IF NOT EXISTS `users` (
                    `id` INT PRIMARY KEY AUTO_INCREMENT,
                    `full_name` VARCHAR(150) NOT NULL,
                    `email` VARCHAR(100) UNIQUE NOT NULL,
                    `phone` VARCHAR(20) UNIQUE NOT NULL,
                    `password` VARCHAR(255) NOT NULL,
                    `role` ENUM('admin', 'supervisor', 'inspector', 'client', 'trainee') DEFAULT 'client',
                    `status` ENUM('active', 'inactive', 'suspended') DEFAULT 'active',
                    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
                    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
                ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
                
                CREATE TABLE IF NOT EXISTS `admin_sessions` (
                    `id` INT PRIMARY KEY AUTO_INCREMENT,
                    `user_id` INT NOT NULL,
                    `token` VARCHAR(255) UNIQUE NOT NULL,
                    `expires_at` DATETIME NOT NULL,
                    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
                    FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON DELETE CASCADE
                ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
            ";
            
            $db->exec($sql);
            
            // إضافة مستخدم admin افتراضي
            $passwordHash = password_hash('Admin@123', PASSWORD_DEFAULT);
            $stmt = $db->prepare("INSERT IGNORE INTO `users` (`full_name`, `email`, `phone`, `password`, `role`) VALUES (?, ?, ?, ?, ?)");
            $stmt->execute(['مدير النظام', 'admin@autotester.com', '01000000000', $passwordHash, 'admin']);
            
            return true;
        }
        return true;
    } catch (PDOException $e) {
        error_log("Error ensuring tables: " . $e->getMessage());
        return false;
    }
}

// =====================================================
// تهيئة الاتصال عند تحميل الملف
// =====================================================

// إنشاء مجلد السجلات إذا لم يكن موجوداً
if (!is_dir(__DIR__ . '/../logs')) {
    mkdir(__DIR__ . '/../logs', 0755, true);
}

// محاولة الاتصال والتحقق من الجداول
try {
    $database = Database::getInstance();
    $conn = $database->getConnection();
    ensureDatabaseTables();
} catch (Exception $e) {
    // لا نقوم بإيقاف التنفيذ هنا، بل نترك معالجة الأخطاء للدالة الرئيسية
}

// تصدير الدوال للاستخدام
return [
    'getConnection' => 'getDatabaseConnection',
    'queryAll' => 'dbQueryAll',
    'queryOne' => 'dbQueryOne',
    'queryValue' => 'dbQueryValue',
    'execute' => 'dbExecute',
    'insert' => 'dbInsert',
    'update' => 'dbUpdate',
    'delete' => 'dbDelete'
];
?>