ERP لإدارة مكتبة
تفاصيل العمل
# مكتبتي — نظام إدارة المكتبات والمكتبات القرطاسية الشامل
نظام متكامل لإدارة المكتبات ومحلات القرطاسية، مبني بالكامل بواجهة عربية (RTL) واحترافية، يغطي كل ما يحتاجه صاحب المكتبة يومياً: من البيع في نقطة البيع، لإدارة المخزون، للفواتير، للعروض، للتقارير، وحتى مساعد ذكاء اصطناعي يجاوب على أسئلة صاحب المتجر عن بياناته الحقيقية لحظياً.
---
## نظرة عامة
"مكتبتي" ليس مجرد نظام كاشير، بل منصة إدارة متكاملة تجمع بين:
- **البساطة في الاستخدام** — واجهة عربية بالكامل (RTL) بخط Cairo وتصميم أخضر هادئ يناسب طبيعة المكتبات.
- **القوة في الخلفية** — بنية تقنية حديثة (React + Express + PostgreSQL) تضمن السرعة والاستقرار.
- **الذكاء** — مساعد ذكاء اصطناعي مدرّب على بيانات المتجر نفسه، وليس إجابات عامة.
---
## المميزات الكاملة
### 1. لوحة التحكم (Dashboard)
- نظرة شاملة لحظية على أداء المكتبة: الإيرادات (اليوم/الشهر)، عدد المنتجات، عدد العملاء، عدد الفواتير.
- تنبيهات المخزون المنخفض في جدول مباشر.
- عدد الحجوزات والطلبات قيد الانتظار.
- مخطط بياني يوضح توزيع المبيعات حسب الفئة (كتب / قرطاسية / أخرى).
### 2. إدارة المنتجات والمخزون
- عمليات إضافة / تعديل / حذف كاملة (CRUD) لكل منتج.
- دعم بيانات خاصة بالكتب: ISBN، اسم المؤلف، الناشر.
- تصنيف كل منتج ضمن فئة، مع بحث وفلترة سريعة.
- شارات تنبيه تلقائية للمنتجات التي وصلت للحد الأدنى من المخزون أو نفدت.
### 3. إدارة الفئات
- تصنيف المنتجات إلى: كتب، قرطاسية، فئات أخرى مخصصة.
- سهولة الفلترة بها في كل الصفحات المرتبطة (المنتجات، المبيعات، التقارير).
### 4. المبيعات ونقطة البيع (POS) والفواتير
- شاشة بيع سريعة على طراز الكاشير: بحث عن المنتج بالاسم أو ISBN، إضافة للسلة، تعديل الكميات مباشرة.
- ربط الفاتورة بعميل مسجّل أو تسجيلها كـ"عميل عام".
- دعم طرق دفع متعددة: نقدي، بطاقة ائتمان، تحويل بنكي.
- تحديث المخزون تلقائياً عند إتمام كل عملية بيع.
- فاتورة احترافية قابلة للطباعة مباشرة، مع رقم فاتورة فريد وتفاصيل كاملة.
- إلغاء الفاتورة يُرجع الكمية المباعة تلقائياً إلى المخزون.
### 5. العروض والخصومات (نظام متقدم)
نظام عروض احترافي متعدد الأنواع، وليس مجرد نسبة خصم بسيطة:
- **خصم بنسبة مئوية** — مثال: خصم 15% على كامل الفاتورة.
- **خصم بمبلغ ثابت** — مثال: خصم 20 جنيه لكل الفواتير.
- **عرض "اشترِ X واحصل على Y مجاناً" (BOGO)** — يُحتسب تلقائياً بحيث يُخصم سعر القطع الأرخص في السلة عند تحقق الشرط.
- **أكواد خصم (Coupon Codes)** — يمكن للعميل إدخال كود خاص عند الدفع للحصول على خصمه.
- **حد أدنى لقيمة الطلب** — لتفعيل العرض فقط عند تجاوز مبلغ معيّن.
- **حد أقصى لعدد مرات الاستخدام** — مع عدّاد استخدام تلقائي وشريط تقدّم بصري، ويتوقف العرض تلقائياً عند الوصول للحد.
- **تواريخ بداية ونهاية** — لجدولة العروض الموسمية (مثل عروض بداية العام الدراسي).
- تفعيل/إيقاف أي عرض بضغطة واحدة دون حذفه.
### 6. إدارة العملاء
- سجل كامل لبيانات كل عميل (الاسم، رقم الهاتف، البريد الإلكتروني).
- تتبّع تاريخ مشتريات كل عميل وربطها بفواتيره.
### 7. الحجوزات
- حجز كتب أو منتجات غير متوفرة حالياً لعملاء محددين.
- تتبّع حالة كل حجز (قيد الانتظار / مكتمل) مع تنبيه تلقائي عند تأخر معالجة الحجز أكثر من 3 أيام.
### 8. طلبات التوريد
- إنشاء طلبات شراء من الموردين لتجديد المخزون.
- تحديث المخزون تلقائياً فور تأكيد استلام الطلب.
- تنبيه عند تأخر استلام طلب لأكثر من أسبوع.
### 9. التقارير والتحليلات
- مخطط بياني لاتجاه المبيعات بثلاثة عروض زمنية: يومي (آخر 30 يوم)، أسبوعي (آخر 12 أسبوع)، شهري (آخر 12 شهر).
- بطاقات مقارنة سريعة: إيرادات اليوم، الأسبوع، الشهر الحالي، والشهر الماضي.
- جدول "الأكثر مبيعاً" و"الأقل مبيعاً" لمعرفة المنتجات الرائجة.
- قائمة المنتجات التي لم تُبَع إطلاقاً، لمساعدتك على اتخاذ قرارات تسويقية أو تصفية مخزون راكد.
### 10. نظام الإشعارات الذكي
- جرس إشعارات مركزي يجمع كل التنبيهات المهمة في مكان واحد:
- نفاد أو انخفاض المخزون.
- حجوزات متأخرة لم تُعالج.
- طلبات توريد متأخرة لم تُستلم.
- تصنيف كل إشعار حسب الأولوية (عالية / متوسطة / منخفضة) بألوان مميزة.
- تحديث تلقائي دوري وربط مباشر بالصفحة المعنية عند الضغط على الإشعار.
### 11. المساعد الذكي (AI Assistant)
- مساعد محادثة باللغة العربية مبني على نماذج ذكاء اصطناعي حديثة (Google Gemini).
- **الميزة الأهم:** المساعد "يقرأ" بيانات المتجر الحقيقية لحظياً قبل الإجابة — إجمالي المنتجات، الإيرادات، أفضل المنتجات مبيعاً، المخزون المنخفض، العروض النشطة — فلا يعطي إجابات عشوائية بل حقائق من قاعدة بياناتك.
- مخصص حصرياً لأسئلة إدارة المكتبة، ويعتذر بأدب عن أي سؤال خارج نطاق عمل المتجر.
- تشغيل عبر البنية التحتية السحابية بدون الحاجة لإدارة مفاتيح API يدوياً.
### 12. الإعدادات
- تخصيص اسم المتجر، العنوان، رقم الهاتف، والعملة المستخدمة في كل الفواتير والتقارير (افتراضياً: ج.م).
---
## البنية التقنية (Tech Stack)
| الطبقة | التقنية |
|---|---|
| الواجهة الأمامية | React + Vite (TypeScript) |
| التصميم | Tailwind CSS + مكوّنات UI مخصصة، خط Cairo، واجهة RTL كاملة |
| الخلفية (API) | Express 5 (Node.js) |
| قاعدة البيانات | PostgreSQL + Drizzle ORM |
| التحقق من البيانات | Zod (schema validation) على مستوى العميل والخادم |
| توليد الواجهات البرمجية | OpenAPI + Orval (عقود API موثّقة تلقائياً) |
| الذكاء الاصطناعي | Google Gemini عبر بنية تكامل سحابية آمنة |
| الرسوم البيانية | Recharts |
هذه البنية تضمن:
- **أماناً في البيانات** — تحقق صارم من كل مُدخل قبل وصوله لقاعدة البيانات.
- **قابلية للتوسّع** — إضافة ميزات جديدة أو فروع أو مستخدمين لاحقاً دون إعادة هيكلة النظام.
- **أداءً عالياً** — بنية حديثة (React + Express) تدعم مئات العمليات المتزامنة دون بطء.
---
## قاعدة البيانات
النظام يدير 9 جداول مترابطة بعلاقات محكمة:
`categories`, `products`, `customers`, `sales`, `sale_items`, `reservations`, `orders`, `order_items`, `promotions`, `settings`
كل عملية بيع أو استلام طلب تُحدّث المخزون تلقائياً بشكل متسق (لا تعارض بين البيانات).
---
## لمن يناسب هذا النظام؟
- مكتبات بيع الكتب (عامة، دينية، تعليمية، أطفال).
- محلات القرطاسية والمستلزمات المدرسية والمكتبية.
- أي نشاط تجاري صغير أو متوسط يحتاج نظام كاشير + مخزون + عملاء + تقارير في منصة واحدة متكاملة، بدون تعقيد الأنظمة العالمية الجاهزة وتكلفتها.
---
## لماذا هذا المشروع مختلف؟
1. **عربي 100% من الداخل** — ليس ترجمة لنظام أجنبي، بل مُصمَّم من الأساس بعقلية RTL في كل تفصيلة (المحاذاة، التنسيق، حتى تنسيق التاريخ والعملة).
2. **عروض وخصومات احترافية** — نادراً ما تجد في الأنظمة المشابهة دعماً حقيقياً لعروض BOGO وأكواد الخصم وحدود الاستخدام في نظام واحد متكامل.
3. **ذكاء اصطناعي حقيقي لا شكلي** — المساعد يتعامل مع بيانات حيّة من قاعدة البيانات، وليس نصوصاً جاهزة أو ردود عشوائية.
4. **تنبيهات استباقية** — النظام لا ينتظر منك تفقّد كل صفحة؛ هو يخبرك بالمشكلة (نفاد مخزون، حجز متأخر، طلب لم يصل) قبل أن تسأل.
5. **جاهز للنمو** — بنية الكود منظمة ومعزولة (frontend/backend/شيّفرات مشتركة) بما يسمح بإضافة ميزات مستقبلية (فروع متعددة، صلاحيات مستخدمين، تطبيق موبايل) بسهولة.
---
## ملخص تنفيذي (للعرض السريع)
> **مكتبتي** هو نظام إدارة مكتبات وقرطاسية متكامل بواجهة عربية احترافية، يضم: لوحة تحكم تحليلية، إدارة كاملة للمنتجات والفئات والعملاء، نقطة بيع مع فواتير قابلة للطباعة، نظام عروض متقدم (نسبة/ثابت/BOGO/أكواد خصم)، حجوزات وطلبات توريد بتنبيهات تلقائية، تقارير مبيعات بمخططات بيانية تفاعلية، ومساعد ذكاء اصطناعي يجيب من بيانات المتجر الحقيقية مباشرة. مبني بأحدث التقنيات (React، Express، PostgreSQL) لضمان الأداء والأمان وقابلية التوسّع.
---
## رابط