# نظام ركائز المالي — نسخة PHP لـ cPanel

الإصدار: 3.0.0

## متطلبات الاستضافة

- PHP 8.1 أو أحدث.
- MySQL 5.7 أو MySQL 8 / MariaDB 10.4 أو أحدث.
- إضافات PHP: `pdo_mysql`, `session`, `json`, `openssl`, `fileinfo`.
- خادم Apache مع دعم `.htaccess`، وهو الافتراضي في أغلب استضافات cPanel.
- لا يحتاج Composer أو Node.js بعد رفع الملفات.

## خطوات الرفع والتثبيت

1. من cPanel افتح **MySQL Databases**.
2. أنشئ قاعدة بيانات جديدة ومستخدمًا جديدًا.
3. اربط المستخدم بالقاعدة واختر **ALL PRIVILEGES**.
4. من phpMyAdmin استورد الملف `matchsys_finan.sql` الموجود داخل الحزمة في قاعدة البيانات الجديدة.
5. فك ضغط ملفات النظام داخل `public_html` أو داخل مجلد فرعي مثل `public_html/rakaez`.
6. افتح رابط النظام في المتصفح؛ سيتم تحويلك تلقائيًا إلى مجلد `install`.
7. أدخل اسم قاعدة البيانات ومستخدمها وكلمة المرور وبيانات الشركة وحساب المدير.
8. بعد نجاح التثبيت سجّل الدخول، ثم احذف أو أعد تسمية مجلد `install` كإجراء احترازي إضافي.

مثال إذا رفعت النظام داخل مجلد `rakaez`:

```text
https://your-domain.com/rakaez/
```

## عند ظهور خطأ في كتابة ملف الإعداد

تأكد أن صلاحية مجلد `config` هي `755`. يمكن إنشاء `config/config.php` يدويًا بنسخ `config/config.example.php` وتعديل بياناته.

## الحماية المضمنة

- تشفير كلمات المرور باستخدام `password_hash`.
- استعلامات PDO محضرة ضد حقن SQL.
- رموز CSRF لكل عمليات الحفظ.
- تجديد معرف الجلسة عند الدخول.
- انتهاء الجلسة بعد ساعتين من عدم النشاط.
- حماية مجلدي `app` و`config` بواسطة `.htaccess`.
- سجل تدقيق لعمليات الدخول والتعديل الأساسية.

## الوحدات المتاحة في هذا الإصدار

- لوحة القيادة المالية.
- تثبيت الشركة والفرع والسنة المالية.
- تسجيل الدخول والخروج.
- إدارة بيانات الشركة والفرع.
- إضافة المستخدمين وربطهم بالأدوار والفروع.
- فتح وإقفال الفترات المالية.
- شجرة الحسابات وإضافة حسابات الحركة والأبعاد.
- القيود اليومية المتوازنة مع الاعتماد والترحيل.
- دفتر الأستاذ وميزان المراجعة من القيود المرحلة.
- إنشاء المشاريع والعملاء ومراكز التكلفة المرتبطة بها.
- ربط القيود اليومية بالمشروع ومركز التكلفة.
- سجل الموردين وأوامر الشراء متعددة البنود.
- احتساب ضريبة وقيمة أمر الشراء وربطه بالمشروع.
- اعتماد أمر الشراء وتحويله إلى حالة مرسل.
- إدارة المستودعات والأصناف.
- الاستلام الجزئي والكامل لأوامر الشراء.
- تحديث أرصدة المخزون ومتوسط التكلفة وحالة أمر الشراء.
- عقود العملاء وعقود مقاولي الباطن.
- مستخلصات العملاء ومقاولي الباطن مع الاحتجاز واسترداد المقدم والضريبة.
- تقديم المستخلصات واعتمادها وفق حالتها.
- الحسابات البنكية والصناديق النقدية.
- سندات القبض والصرف وربطها بالمستخلصات.
- اعتماد وترحيل حركات الخزينة.
- لوحة مالية فعلية من القيود والسندات المرحلة.
- ربحية المشاريع والتنبيهات المطلوب اعتمادها.
- تصحيح الربط المرجعي بين الأطراف والعملاء والموردين.
- فواتير العملاء من المستخلصات المعتمدة.
- فواتير الموردين من أوامر الشراء المستلمة.
- احتساب الضريبة ودورة اعتماد وإصدار أو ترحيل الفاتورة.
- تطبيق الصلاحيات التفصيلية على الوحدات.
- إدارة صلاحيات الأدوار وسجل التدقيق.
- تنزيل نسخة احتياطية SQL كاملة من داخل النظام.
- أكواد التكلفة ونسخ موازنات المشاريع.
- اعتماد الموازنة ومقارنة الفعلي والارتباطات والمتبقي.
- تصنيفات الأصول والمعدات وربطها بالمشاريع.
- احتساب الإهلاك الدوري وتحديث القيمة الدفترية.
- محرك قيود آلية موحد مع منع التكرار وعدم التوازن.
- ترحيل فواتير العملاء والموردين وسندات الخزينة آليًا.
- قائمة الدخل والمركز المالي والتدفق النقدي.
- سجل الموظفين ومسيرات الرواتب واعتمادها.
- إصدار العهد وتسويتها بالمصروفات والمبالغ المعادة.
- طلبات شراء داخلية متعددة البنود مرتبطة بالمشروع وكود التكلفة.
- تقديم طلب الشراء واعتماده أو رفضه.
- سجل التدقيق الأساسي.
- طلبات عروض الأسعار ودعوة الموردين والمقارنة والترسية الآلية.
- المطابقة الثلاثية بين أمر الشراء والاستلام وفاتورة المورد.
- سداد فواتير الموردين وتحصيل فواتير العملاء جزئيًا أو كليًا.
- استيراد كشوف البنك CSV والمطابقة الآلية والتسويات البنكية.
- سجل الشيكات الصادرة والواردة وحالات الإيداع والصرف والارتجاع.
- قوائم إقفال الفترات والإقفال المبدئي والنهائي.
- إعداد ومراجعة واعتماد إقرار ضريبة القيمة المضافة.
- أعمار ديون العملاء والموردين والتدفق النقدي المتوقع.
- المناقصات والمطالبات وأوامر التغيير وآثار التكلفة والمدة.
- تشغيل المعدات والوقود والصيانة وساعات التوقف.
- مركز التنبيهات والمرفقات والأرشفة الآمنة.
- البحث العام ونماذج الطباعة والحفظ PDF.
- تجهيز UUID وXML وQR للفواتير الإلكترونية ومتابعة نتيجة الربط.

## تحديث نسخة قائمة

ارفع حزمة التحديث داخل مجلد النظام وفك الضغط مع **Overwrite**. لا تحذف `config/config.php` ولا تستورد SQL مرة أخرى إذا كانت القاعدة الكاملة مستخدمة بالفعل.

## الفاتورة الإلكترونية

تجهيز XML وQR متاح داخل النظام. الإرسال المباشر لهيئة الزكاة والضريبة يتطلب شهادة جهاز ومفتاحًا خاصًا صادرين للشركة، ولا يتضمن النظام بيانات اعتماد افتراضية حفاظًا على الأمان.
