MAINHACK

Viewing / Editing File: README.md

# حسابات عربية بن فريش
# Arabic Credit Sales Management System

نظام إدارة المبيعات الآجلة باللغة العربية لشركة بن فريش المصرية

## المتطلبات التقنية

- PHP 7.4 أو أحدث
- MySQL 5.7 أو أحدث
- خادم ويب (Apache أو Nginx)
- PHP Extensions المطلوبة:
  - PDO
  - pdo_mysql
  - curl
  - mbstring
  - json

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

### 1. تحميل الملفات

قم بتحميل جميع ملفات المشروع إلى مجلد الخادم الخاص بك (مثل `htdocs` أو `public_html`)

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

1. افتح phpMyAdmin أو أي أداة إدارة قواعد بيانات
2. قم باستيراد ملف `database.sql`
3. سيتم إنشاء قاعدة بيانات باسم `hesabat_arabia` تلقائياً

### 3. تعديل إعدادات الاتصال

افتح ملف `config/database.php` وعدّل البيانات التالية حسب إعدادات خادمك:

```php
define('DB_HOST', 'localhost');      // عنوان قاعدة البيانات
define('DB_USER', 'root');           // اسم المستخدم
define('DB_PASS', '');               // كلمة المرور
define('DB_NAME', 'hesabat_arabia'); // اسم قاعدة البيانات
```

### 4. تعديل الرابط الأساسي

افتح ملف `config/config.php` وعدّل الرابط الأساسي:

```php
define('BASE_URL', 'http://localhost/hesabat_arabia');
```

غيّر `http://localhost/hesabat_arabia` إلى رابط موقعك الفعلي

### 5. تسجيل الدخول الأول

- **رقم الهاتف:** +201000000000
- **كلمة المرور:** admin123

⚠️ **مهم:** قم بتغيير كلمة المرور بعد تسجيل الدخول الأول!

## الصلاحيات والأدوار

### 1. المدير (Manager)
- الوصول الكامل لجميع الوظائف
- الموافقة على الورديات
- الموافقة على المرتجعات
- إدارة المستخدمين
- الإعدادات العامة

### 2. المحاسب (Accountant)
- الموافقة على الورديات
- الموافقة على المرتجعات
- عرض جميع التقارير
- إدارة الفواتير والمدفوعات

### 3. المندوب (Representative)
- إنشاء الفواتير
- تحصيل المدفوعات
- إدارة العملاء
- طلب الورديات
- إضافة المرتجعات

## إعداد واتساب (اختياري)

لتفعيل إرسال رسائل واتساب التلقائية:

1. اذهب إلى **الإعدادات** من القائمة الرئيسية
2. أدخل رابط API الخاص بواتساب
3. أدخل رمز API Token
4. احفظ الإعدادات

سيتم إرسال رسائل واتساب تلقائياً عند:
- إنشاء فاتورة جديدة
- تحصيل دفعة من العميل

## البنية الأساسية للنظام

```
hesabat_arabia/
├── config/              # ملفات الإعدادات
├── includes/            # ملفات الرأس والتذييل
├── lib/                 # المكتبات المساعدة
├── assets/
│   ├── css/            # ملفات الأنماط
│   └── js/             # ملفات JavaScript
├── customers/          # إدارة العملاء
├── invoices/           # إدارة الفواتير
├── payments/           # تحصيل الأموال
├── shifts/             # إدارة الورديات
├── returns/            # المرتجعات
├── reports/            # التقارير
├── settings/           # الإعدادات
├── login.php           # صفحة تسجيل الدخول
├── logout.php          # تسجيل الخروج
├── dashboard.php       # لوحة التحكم
└── database.sql        # ملف قاعدة البيانات
```

## كيفية الاستخدام

### إنشاء وردية جديدة (للمندوب)

1. اذهب إلى **الورديات** > **طلب وردية جديدة**
2. أدخل المخزون الأولي والرصيد الأولي
3. أرسل الطلب
4. انتظر موافقة المدير أو المحاسب
5. بعد الموافقة، ستصبح الوردية نشطة

### إنشاء فاتورة جديدة

1. تأكد من وجود وردية نشطة
2. اذهب إلى **الفواتير** > **إضافة فاتورة جديدة**
3. اختر العميل
4. أضف المنتجات والكميات والأسعار
5. احفظ الفاتورة
6. سيتم إرسال رسالة واتساب للعميل تلقائياً

### تحصيل الأموال

1. اذهب إلى **تحصيل الأموال**
2. اختر العميل
3. أدخل المبلغ المحصل
4. احفظ التحصيل
5. سيتم تطبيق المبلغ على أقدم الفواتير تلقائياً
6. سيتم إرسال رسالة واتساب للعميل

### إغلاق الوردية

1. اذهب إلى **الورديات** > **الوردية النشطة**
2. اضغط على **طلب إغلاق الوردية**
3. أدخل المخزون المتبقي والرصيد النهائي
4. أرسل الطلب
5. انتظر موافقة المدير أو المحاسب
6. بعد الموافقة، سيتم إغلاق الوردية وإنشاء تقرير التدفق النقدي

## المرتجعات

1. لإضافة مرتجع، اذهب إلى **المرتجعات** > **إضافة مرتجع**
2. اختر الفاتورة والمنتج المرتجع
3. أرسل الطلب
4. سينتظر المرتجع موافقة المدير أو المحاسب
5. بعد الموافقة، سيتم خصم قيمة المرتجع من الوردية تلقائياً

## التقارير المتاحة

1. **تقرير المبيعات اليومية** - حسب المندوب والتاريخ
2. **تقرير التدفق النقدي** - لكل وردية
3. **تقرير المديونيات** - جميع العملاء المدينين
4. **كشف حساب العميل** - تفصيلي لكل عميل
5. **تقرير المرتجعات** - حسب الحالة والتاريخ

## الأمان

- جميع المدخلات محمية ضد هجمات SQL Injection
- كلمات المرور مشفرة باستخدام bcrypt
- التحقق من الصلاحيات على مستوى كل صفحة
- تسجيل جميع العمليات في سجل النشاطات

## استكشاف الأخطاء

### خطأ الاتصال بقاعدة البيانات

تأكد من:
- صحة بيانات الاتصال في `config/database.php`
- أن خادم MySQL يعمل
- أن قاعدة البيانات `hesabat_arabia` موجودة

### لا تظهر الأنماط أو JavaScript

تأكد من:
- صحة `BASE_URL` في ملف `config/config.php`
- أن مجلد `assets` في المكان الصحيح

### رسائل واتساب لا تُرسل

- تأكد من إعداد API الخاص بواتساب في الإعدادات
- تحقق من صحة رابط API ورمز Token
- تأكد من أن PHP Extension `curl` مفعّل

## الدعم الفني

للحصول على الدعم أو الإبلاغ عن مشكلة، يرجى التواصل مع فريق التطوير.

## الترخيص

هذا النظام مصمم خصيصاً لشركة بن فريش المصرية.

---

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: README.md

Server Info

System Features

User Info