ERP لإدارة محل سيراميك

# CeramicPro — تطبيق سطح مكتب احترافي لإدارة محلات السيراميك

## نظرة عامة على المشروع

تطبيق سطح مكتب متكامل مصمم خصيصًا لإدارة محلات بيع السيراميك، يجمع بين البساطة في الاستخدام والاحترافية في التصميم والأداء. يعتمد المشروع على فلسفة "التصميم أولاً" مستوحاة من لغة تصميم Apple، مع بنية تقنية قوية تدعم العمل بدون إنترنت (Offline-First) وقابلية التوسع مستقبلًا للويب والموبايل.

---

## 1. الفكرة والهدف

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

---

## 2. المميزات الأساسية (Core Features)

### أ. إدارة المنتجات

- إضافة، تعديل، وحذف أصناف السيراميك (الاسم، السعر، الكمية).

- متابعة مستوى المخزون بشكل لحظي.

- تنبيهات حول الأصناف التي أوشكت على النفاد.

### ب. إدارة المبيعات

- تسجيل عمليات البيع مباشرة من الواجهة.

- خصم الكمية من المخزون تلقائيًا مع كل عملية بيع.

- أرشفة كاملة لسجل المبيعات لسهولة الرجوع إليه.

### ج. تحليلات ذكية للأداء

- تمييز المنتجات الأكثر مبيعًا (Best Sellers).

- رصد المنتجات الراكدة التي لا تحقق حركة بيع.

- رؤية تساعد صاحب المحل على اتخاذ قرارات شراء أدق وتقليل رأس المال الميت.

### د. المساعد الذكي (الشات الداخلي)

- مساعد محادثة مدمج يتحدث باللغة العربية.

- يجيب على استفسارات مباشرة مثل: "قولّي بعت إيه النهارده؟" أو "إيه المنتجات اللي مش بتتباع؟".

- يقدّم ملخصات فورية بأسلوب طبيعي بدلًا من تصفح الجداول والتقارير.

### هـ. نظام تقارير PDF احترافي بالرسوم البيانية

- توليد تقارير PDF تلقائية تشمل جداول ورسومًا بيانية معًا.

- أنواع رسوم مدعومة: أعمدة (Bar)، خطي (Line)، دائري (Pie)، Doughnut، ومساحي (Area).

- اختيار نوع الرسم البياني تلقائيًا حسب طبيعة البيانات (مثلًا: المبيعات عبر الزمن → رسم خطي، توزيع المنتجات → رسم دائري).

- كل رسم بياني يتضمن عنوانًا، تسميات محاور، مفتاح دلالة (Legend)، وتسميات بيانات.

- التزام كامل بهوية الألوان (أخضر وأزرق) في جميع الرسوم.

- دعم اتجاه RTL للتقارير العربية و LTR للتقارير الإنجليزية.

- تقارير عالية الدقة قابلة للطباعة، مع تقسيم صفحات ذكي لا يقطع الرسوم البيانية.

- عرض حالة "لا توجد بيانات كافية" بتصميم احترافي بدلًا من رسم فارغ.

- كل تقرير يشمل: شعار الشركة، عنوان التقرير، التاريخ والوقت، الفلاتر المطبقة، ملخص إحصائي، الرسوم البيانية، الجداول التفصيلية، وتذييل يحتوي على أرقام الصفحات.

---

## 3. الهوية البصرية وتجربة الاستخدام (UI/UX)

- **لوحة الألوان:** أخضر وأزرق مريحان للعين لتقليل الإجهاد البصري أثناء ساعات العمل الطويلة.

- **الأيقونات:** كبيرة وواضحة بأسلوب Apple-style يسهّل الاستخدام حتى لغير المتخصصين تقنيًا.

- **الانتقالات:** حركات وانتقالات سلسة بين القوائم والشاشات لتجربة استخدام حديثة وسلسة.

- **الخط:** استخدام خط Rubik من Google Fonts، وهو خط عربي/لاتيني حديث يدعم العربية بوضوح وأناقة.

- **دعم اللغة العربية الكامل:** واجهة RTL بالكامل مع تجربة استخدام مصممة خصيصًا للمستخدم العربي.

- **الهوية البصرية للمشروع:**

- تصميم شعار (Logo) احترافي مستقل عن أيقونة التطبيق.

- نسخة مبسّطة (Minimal) من الشعار للاستخدامات الرسمية.

- نسخة بالأبيض والأسود لأغراض الطباعة.

- نسخة من الشعار بدون نص لاستخدامها كأيقونة وفي منصات التواصل الاجتماعي.

- أيقونة تطبيق مصممة بعناصر ترمز للنشاط (فاتورة، آلة حاسبة، مخزون) بأسلوب Modern يتماشى مع تطبيقات حقيقية في المتاجر.

- صفحات غلاف احترافية (Cover Pages) للتوثيق والعرض التقديمي للمشروع.

---

## 4. البنية التقنية (Technical Architecture)

### قاعدة البيانات المحلية

- استخدام **Realm DB** كقاعدة بيانات محلية على الجهاز.

- تخزين آمن وسريع يعمل بالكامل بدون اتصال بالإنترنت (Offline-First).

- أداء عالٍ في القراءة والكتابة مناسب لطبيعة عمل المحل اليومية.

### التخطيط لقاعدة بيانات سحابية موسّعة (Supabase)

تم اعتماد منهجية توثيق صارمة قبل أي تنفيذ فعلي لقاعدة البيانات، تقوم على:

- عدم افتراض أو اختراع أي جدول أو عمود دون تحديد واضح من متطلبات النظام.

- استخراج وتوثيق كل من: الجداول، الأعمدة، أنواع البيانات، العلاقات (Foreign Keys)، القيود (Constraints)، قواعد التحقق (Validation Rules)، ومنطق العمل (Business Logic) لكل ميزة على حدة.

- بعد اكتمال جمع المتطلبات، يتم توليد مخطط قاعدة بيانات متكامل يشمل:

1. البنية المعمارية الكاملة لقاعدة البيانات.

2. جداول Supabase.

3. الأعمدة وأنواع البيانات.

4. العلاقات بين الجداول (Foreign Keys).

5. الفهارس (Indexes).

6. سياسات أمان الصفوف (RLS Policies).

7. بنية التخزين (Storage Structure).

8. متطلبات التحديث اللحظي (Realtime).

9. متطلبات المزامنة عبر ثلاث منصات: تطبيق الويب، تطبيق سطح المكتب (Electron)، وتطبيق أندرويد.

- هذا النهج يضمن قاعدة بيانات موثّقة بالكامل، قابلة للمراجعة والاعتماد قبل التنفيذ، وجاهزة للتوسع متعدد المنصات مستقبلًا.

---

## 5. خارطة الطريق والتوسع المستقبلي

| المرحلة | الوصف | الحالة |

|---|---|---|

| تصميم الهوية البصرية والشعار | ألوان، أيقونة، شعار بنسخه المختلفة | تم|

| تصميم واجهات الاستخدام (UI) | شاشات المنتجات، المبيعات، الشات، التقارير | تم |

| قاعدة البيانات المحلية (Realm) | تخزين offline-first على الجهاز | تم |

| قاعدة بيانات Supabase السحابية | توثيق كامل قبل أي تنفيذ | تم |

| نظام تقارير PDF بالرسوم البيانية | تقارير ذكية تلقائية التنسيق | مصمم بالكامل (Spec جاهز) |

| المزامنة متعددة المنصات | ويب، Electron، أندرويد | تم |

---

## 6. الفئة المستهدفة

أصحاب محلات السيراميك والمشاريع الصغيرة والمتوسطة الذين يبحثون عن أداة احترافية بسيطة تدير أعمالهم اليومية دون الحاجة لخبرة تقنية أو اتصال دائم بالإنترنت، مع إمكانية النمو مستقبلًا نحو حلول سحابية متكاملة.

---

## 7. ملخص القيمة المقدَّمة

هذا المشروع ليس مجرد واجهة جميلة، بل نظام تفكير متكامل لإدارة المحل: يبسّط تسجيل المبيعات، يمنع الأخطاء البشرية، يوفر رؤية تحليلية فورية عبر شات ذكي وتقارير بصرية احترافية، ويؤسس لبنية بيانات قابلة للتوسع من جهاز واحد محلي إلى منظومة متكاملة عبر الويب وسطح المكتب والموبايل.

## 8. الرابط

yassin-elkabeer.lovable.app

ADMIN PIN = 123098