# بلتاجي العز لإدارة الذهب والمعادن

نظام Laravel احترافي متعدد الفروع لإدارة الذهب والمعادن والمجوهرات، بواجهة عربية/إنجليزية متجاوبة وصلاحيات دقيقة وسجل تدقيق.

## التقنية

- Laravel 12.64 وPHP 8.2+
- Livewire 4 وAlpine.js
- Tailwind CSS 4 وVite
- Spatie Laravel Permission 6
- SQLite للتطوير السريع، مع تصميم قابل للنقل إلى PostgreSQL/MySQL

## التشغيل المحلي على XAMPP

1. شغّل Apache من لوحة XAMPP.
2. افتح `http://localhost/Gold/public/setup`.
3. أدخل بيانات المؤسسة والفرع وحساب مالك النظام. لا توجد كلمة مرور أو بيانات مدير افتراضية داخل الكود.

لبناء الواجهة بعد تعديل CSS أو JavaScript:

```powershell
$env:CI='true'
pnpm install
pnpm run build
```

عند عدم وجود pnpm في PATH يمكن استخدام المسار المرفق مع Codex، أو Node مباشرةً:

```powershell
node node_modules/vite/bin/vite.js build
```

## التحقق

```powershell
C:\xampp\php\php.exe artisan migrate
C:\xampp\php\php.exe artisan test
C:\xampp\php\php.exe vendor\bin\pint --test
```

## الوحدات المنفذة في الأساس الحالي

- معالج إعداد أول مرة آمن ومعاملة ذرية.
- تسجيل الدخول والخروج، تحديد المحاولات، الجلسات، وتعطيل الحساب.
- المؤسسات والفروع والمستودعات والمواقع التابعة.
- المستخدمون، الأدوار، الصلاحيات، ونطاق الفروع.
- سجل تدقيق للعمليات الحساسة.
- إعدادات العملة والمنطقة الزمنية ودقة الأوزان والمبالغ.
- المعادن والعيارات ووحدات الوزن والعملات وسجل أسعار تاريخي.
- خدمة حساب الوزن الصافي والخالص وقيمة المعدن باستخدام BCMath دون Float.
- واجهة فاخرة متجاوبة، RTL/LTR، وضع فاتح/داكن، وعربية/إنجليزية.
- اختبارات Feature لعزل المؤسسات والمصادقة والصلاحيات والعمليات الأساسية.

التحليل الكامل وخطة الوحدات موجودان في [docs/system-analysis-ar.md](docs/system-analysis-ar.md).

## مبادئ الأمان

- لا يحتوي المشروع على مستخدمين أو كلمات مرور افتراضية.
- كل استعلام إداري مقيد بالمؤسسة.
- التفويض يطبق في المسارات وForm Requests، وليس في إخفاء عناصر الواجهة فقط.
- العمليات الإدارية المهمة تسجل قبل/بعد مع IP والمتصفح.
- لا تستخدم بيانات التطوير في الإنتاج، ويجب ضبط `APP_DEBUG=false` وHTTPS وأسرار بيئة مستقلة عند النشر.
