عمل مشروع برنامج محاسبي مثل برامج odoo و zoho

# وصف عام

هذا مستند متطلبات برنامج محاسبة ومخزون **أونلاين** يدعم نظام اشتراكات، باركود، متعدد الفروع، وربط مع المتجر الإلكتروني. المستند مُوجَّه للمبرمجين وفرق التطوير لتأسيس نطاق العمل والـ SRS.

---

# 1. الأهداف

* نظام سحابي (ويب) لإدارة الحسابات، المبيعات، المشتريات، والمخزون.

* دعم نظام اشتراكات (مدفوعات دورية، مستويات خطة مختلفة).

* دعم الباركود للمنتجات وإدارة المسح الضوئي.

* متعدد الفروع مع تحكم مركزي وتقارير مجمعة وفرعية.

* تكامل (API / Webhooks) مع متجر إلكتروني (مثل WooCommerce / Shopify / متجر مخصص).

---

# 2. المستخدمون والأدوار

* **المدير العام (Super Admin)**: إعدادات النظام، خطط الاشتراك، إدارة الفروع، إدارة المستخدمين.

* **مدير فرع**: إدارة مبيعات الفرع، مخزون الفرع، تقارير فرعية.

* **محاسب**: قيود محاسبية، تقارير مالية، تسويات بنكية.

* **مشغل مبيعات / كاشير**: فواتير مبيعات، استلام مدفوعات، مسح باركود.

* **مخزن**: استلام بضاعة، تحركات مخزون، جرد.

* **عميل (للوحة العملاء/فاتورة إلكترونية)**: عرض فواتير ودفع عبر بوابة.

صلاحيات قابلة للتخصيص لكل دور.

---

# 3. الموديولات والوظائف الرئيسية

## 3.1 إدارة المنتجات والمخزون

* تعريف منتج: كود، باركود (EAN/UPC/Code128)، اسم، وصف، فئة، وحدة قياس، سعر شراء، سعر بيع، تكلفة متوسطة/FIFO/LIFO (اختياري).

* تعدد الأسعار (بيع جملة/تفصيل/خصومات حسب العميل أو الخطة).

* عدَّة مخازن/فروع: رصيد لكل مخزن.

* حركات المخزون: وارد (استلام)، صادر (مبيعات/تحويل بين مخازن)، تعديل رصيد، جرد.

* إعداد حد إعادة الطلب وتنبيه عبر الإشعارات/البريد.

* دعم مسح الباركود في شاشة نقاط البيع واستلام البضاعة.

## 3.2 المبيعات ونقاط البيع (POS)

* إنشاء فاتورة مبيعات (نقدي، بطاقة، شيك، تحويل بنكي، رصيد عميل، تحصيل جزئي).

* ربط الفاتورة بتحديث رصيد المخزون تلقائيًا.

* شاشة POS سريعة مع دعم مسح باركود وطباعة إيصال/فاتورة.

* خصومات على مستوى الفاتورة أو على منتج.

* إدارة إرجاع / مبالغ مسترجعة.

## 3.3 المشتريات والوردات

* أوامر شراء واستلام بضاعة وربط بالفواتير.

* إدارة موردين، فواتير شراء، وتسويات.

* تحديث مخزون تلقائي عند تأكيد الاستلام أو الفاتورة.

## 3.4 الحسابات والمالية

* شجرة حسابات مرنة.

* قيود يومية آلية (مبيعات، مشتريات، تحصيلات، مصروفات).

* دفتر الأستاذ، ميزان المراجعة، قائمة دخل وميزانية.

* إدارة الضرائب (VAT/GST) مع إعداد معدلات متعددة.

* تسويات بنكية واستيراد كشف حساب.

## 3.5 العملاء والموردين

* بيانات كاملة (اتصال، عنوان، شروط دفع، رصيد مفتوح).

* أرصدة وأعمار الديون وتنبيهات تحصيل.

## 3.6 الاشتراكات والفوترة

* خطط اشتراك (مجانية، أساسية، برو، مخصص) مع تحديد (عدد المستخدمين، سعة تخزين، ميزات متاحة).

* بوابة دفع (Stripe / PayPal / PayFort / mada أو بوابات محلية حسب البلد).

* فواتير دورية (شهري/سنوي) وتجديد تلقائي/يدوي.

* إدارة قسائم خصم وتجهيز فترات تجريبية.

* لوحة إدارة للاشتراكات، إلغاء، ترقيات/تخفيضات.

## 3.7 تقارير

* تقارير مبيعات حسب فترة/منتج/فرع/عميل.

* تقارير مشتريات ومصروفات.

* تقرير حركة مخزون، تكلفة البضاعة المباعة.

* تقارير مالية (قوائم مالية) وصادرات CSV/PDF/Excel.

## 3.8 تكامل المتجر الإلكتروني

* مزامنة المنتجات، المخزون، والطلبات بين النظام والمتجر.

* Webhooks لاستقبال أوامر شراء من المتجر وتوليد فواتير/خصم من المخزون.

* دعم WooCommerce/Shopify/REST API للمتاجر المخصصة.

# 6. واجهات API مقترحة (أمثلة)

* POST /api/v1/products -> إضافة منتج

* GET /api/v1/products?branch= -> جلب المنتجات مع الرصيد في الفرع

* POST /api/v1/pos/sale -> إنشاء فاتورة من POS وتوليد حركة مخزون

* POST /api/v1/webhook/shopify -> استقبال طلب جديد

* POST /api/v1/subscription/charge -> معالجة دفعة اشتراك

---

# 7. الأمان والامتثال

* تشفير بيانات حساسة في قاعدة البيانات.

* استخدام HTTPS لجميع الاتصالات.

* صلاحيات دقيقة (RBAC) لكل صلاحية.

* سجلات نشاط (Audit logs) للعمليات الحرجة.

* نسخ احتياطي يومي وتخزين النسخ خارج الموقع.

---

# 8. اختبارات وقبول المنتج (Acceptance Criteria)

* POS ينشئ فاتورة ويحدث رصيد المنتج في نفس اللحظة.

* مزامنة المتجر تنقل الطلب وتخصم المخزون دون تكرار.

* اشتراك جديد يفعّل المزايا المخصصة للخطة فور الدفع.

* تقارير صحيحة (مقارنة يدوية مع المعاملات المفردة).

---

# 9. متطلبات إضافية وتجارية

* واجهة عربية/إنجليزية (RTL support للعرض بالعربي).

* لوحة إعدادات الخدمة (تخصيص شعار الشركة، فاتورة ضريبية).

* دعم طابعات الفواتير الحرارية (ESC/POS) في شاشة POS.

---

# 10. خطة تسليم مقترحة (مراحل)

1. تصميم واجهات UX/UI ونماذج البيانات.

2. بناء API الأساسي ونموذج المنتج/مخزون.

3. شاشة POS ووصل الباركود.

4. موديولات المشتريات والمحاسبة.

5. نظام الاشتراكات وبوابة الدفع.

6. تكامل المتجر الإلكتروني والتقارير.

7. اختبارات (Unit, Integration, UAT).

8. نشر وإطلاق تجريبي (Beta) ثم إطلاق عام.

---