سيستم مكتب القدس - إدارة تخليص الورق الحكومي والمصاريف
====================================================

المتطلبات
---------
- Windows مع XAMPP أو استضافة تدعم PHP 8.0 أو أحدث وMySQL/MariaDB.
- تفعيل PDO MySQL في PHP.
- الاتصال بالإنترنت لعرض Bootstrap والأيقونات والخط من CDN. النظام يعمل من جهة PHP/MySQL محليًا.

طريقة التثبيت على XAMPP
-----------------------
1) فك ضغط مجلد takhlees_system داخل:
   C:\xampp\htdocs\takhlees_system

2) افتح XAMPP وشغّل Apache وMySQL.

3) افتح:
   http://localhost/phpmyadmin

4) من تبويب Import استورد الملف database.sql الموجود داخل مجلد النظام.
   الملف ينشئ قاعدة البيانات takhlees_system ويضيف مديرًا افتراضيًا وبعض الأصناف والمصاريف التوضيحية.

5) افتح الملف:
   config/config.php
   وتأكد من بيانات الاتصال:
   DB_HOST = 127.0.0.1
   DB_NAME = takhlees_system
   DB_USER = root
   DB_PASS = ''
   لو عندك كلمة مرور لـ MySQL، اكتبها في DB_PASS.

6) افتح:
   http://localhost/takhlees_system/login.php

بيانات الدخول الأولية
---------------------
اسم المستخدم: admin
كلمة المرور: admin12345

مهم: غيّر كلمة المرور بعد أول تسجيل دخول من صفحة المستخدمين، عبر تعديل حساب مدير النظام وإدخال كلمة مرور جديدة لا تقل عن 8 أحرف.

طريقة الاستخدام
----------------
1) أضف بيانات العملاء من صفحة «العملاء».
2) راجع الأصناف وأسعار الخدمات من صفحة «الأصناف والخدمات».
3) أضف المصاريف المتكررة من صفحة «المصاريف الجاهزة» مثل «توريد خزينة - 400 جنيه».
4) من «عمليات التخليص» سجّل العملية، واختر العميل والخدمة واضغط أزرار المصاريف المطلوبة.
5) تُحفظ العملية أولًا بحالة «تحت التنفيذ». هذا ليس اعتمادًا نهائيًا للفاتورة.
6) بعد انتهاء الخدمة غيّر الحالة إلى «جاهزة للتسليم».
7) بعد التحقق من انتهاء الخدمة اضغط «اعتماد الفاتورة النهائية». عندها فقط يظهر رقم الفاتورة النهائي وتدخل ضمن تقارير الفواتير المعتمدة.
8) اطبع الفاتورة من صفحة تفاصيل العملية بعد الاعتماد.

ملاحظات عن الحسابات
-------------------
- تحفظ نسخة من اسم الخدمة وسعرها واسم كل مصروف وقيمته داخل العملية وقت تسجيلها، حتى لا يؤدي تغيير السعر الافتراضي إلى تغيير السجلات القديمة.
- يمكن تسجيل مصروف خاص بعملية واحدة من دون إضافته إلى قائمة المصاريف الجاهزة.
- لا تظهر العمليات تحت التنفيذ أو الجاهزة للتسليم ضمن إجمالي الفواتير المعتمدة.
- حذف العملاء أو الأصناف أو المصاريف الجاهزة المستخدمة في عمليات سابقة ممنوع للحفاظ على تاريخ السجلات.
- «المصاريف» في النظام هي المبالغ المرتبطة بخدمة العميل. مصاريف تشغيل المكتب مثل الإيجار والكهرباء ليست مضافة في هذا الإصدار.

مجلدات وملفات مهمة
------------------
- database.sql             قاعدة البيانات والجداول.
- config/config.php        إعدادات اتصال قاعدة البيانات واسم النظام.
- assets/css/style.css     التصميم والألوان المتجاوبة والأزرار التفاعلية للخدمات والمصاريف.
- actions.php              عمليات الحفظ والتحديث مع حماية CSRF واستعلامات PDO.
