حل متكامل ومتقدم صُمم خصيصاً لإدارة المبيعات السريعة، الورش الفنية، صيانة الأجهزة والشبكات وكاميرات المراقبة، الحسابات والديون، والمخزون بدقة متناهية.
English Documentation • دليل التثبيت • الميزات الرئيسية • الأمان والنسخ الاحتياطي
- نبذة عامة عن المشروع
- الوحدات والمميزات الرئيسية
- شاشة نقطة البيع والكاشير السريع (POS)
- إدارة قسم الصيانة واستقبال الأجهزة (Maintenance Workshop)
- المخزون والأصناف والباركود (Inventory & Barcodes)
- العملاء، المديونيات وكشوفات الحساب (Customers & Receivables)
- الموردين وفواتير المشتريات (Suppliers & Purchasing)
- المصروفات والرواتب التشغيلية (Operating Expenses)
- التقارير المالية والتحليلات البيانية (Reports & Financial BI)
- إدارة الفنيين والموظفين والعمولات (Technicians & Performance)
- المستخدمين ومصفوفة الصلاحيات الدقيقة (Users & Granular RBAC)
- سجل التدقيق والحركات (Audit Trail Log)
- محرك الأنشطة المتعددة والقوالب الجاهزة
- الأمان والتصفير الآمن (Zero-Wipe Engine)
- دليل التثبيت والتشغيل السريع
- اختصارات لوحة المفاتيح السريعة
- الهيكل البرمجي للمشروع (Architecture)
- English Documentation Summary
نظام إدارة الأعمال ونقاط البيع والصيانة هو منصة رقمية متكاملة (Enterprise Web Application) تم بناؤها باستخدام أحدث تقنيات الويب الحديثة (React 19 + TypeScript + Tailwind CSS 4 + Vite).
النظام مُهيأ ليعمل بنمط العمل السحابي والمحلي في آن واحد مع واجهة عربية أصيلة بنظام الكتابة من اليمين لليسار (RTL)، ومُجهز بقوالب سريعة تخدم مختلف الأنشطة:
- متاجر وشركات الكمبيوتر وملحقاته والشبكات.
- شركات ومؤسسات كاميرات المراقبة والأنظمة الأمنية الذكية.
- مراكز وورش صيانة اللابتوبات، الهواتف الذكية، والإلكترونيات.
- متاجر التجزئة والجملة المتنوعة مع دعم البدء من الصفر بقاعدة بيانات نظيفة.
- دعم كامل لقارئ الباركود: مسح فوري للباركود والبحث اللحظي بالاسم، الكود، أو القسم.
- خيارات دفع متعددة ومتنوعة: نقد، بطاقة بنكية (مدى / فيزا)، آجل على حساب العميل مع فحص السقف الائتماني، تقسيط، أو دفع مقسم.
- تعليق واسترجاع الفواتير (Hold / Park Invoices): حفظ سلة العميل مؤقتاً لخدمة عميل آخر والعودة إليها بنقرة واحدة.
- الخصومات والضرائب: دعم إضافة خصم بقيمة ثابتة أو نسبة مئوية مع احتساب الضريبة تلقائياً.
- الطباعة المتعددة:
- طباعة حرارية سريعة مقاس 80mm (Thermal Receipts).
- طباعة رسمية بنظام A4 Invoice تتضمن شعار المؤسسة، بيانات الضريبة، ورمز الاستجابة السريع QR Code.
- مرتجعات المبيعات: نظام متكامل لاسترجاع المبيعات وتحديث أرصدة المخزون وحسابات العملاء تلقائياً.
- استقبال كروت الصيانة: تسجيل نوع الجهاز (كمبيوتر، لابتوب، كاميرا، هاتف، NVR)، الرقم التسلسلي (Serial Number)، العطل المشخص، والملحقات المستلمة (شاحن، كابل، حقيبة).
- تتبع الحالات بدقة: (قيد الفحص 🔍 • بانتظار الموافقة ⏳ • بانتظار قطع الغيار 📦 • قيد الصيانة ⚙️ • تم الإصلاح بنجاح ✅ • جاهز للتسليم 🎁 • تم التسليم 🤝 • غير قابل للإصلاح ❌).
- إدراج قطع الغيار المستهلكة من المخزون: سحب قطع الغيار المستخدمة أثناء الصيانة من المستودع آلياً مع ربط تكلفة القطع وأجور يد الفني في فاتورة واحدة.
- بطاقات تتبع وإيصالات استلام: طباعة إيصال استلام احترافي للعميل مع رمز باركود للتتبع وملصق باركود صغير يُلصق على الجهاز.
- إدارة المنتجات والأقسام: تنظيم هرمي مرن للأقسام والتصنيفات الفرعية.
- تنبيهات المخزون الحرج: إشعارات فورية عن المنتجات التي وصلت للحد الأدنى للمخزون لمنع انقطاع البضاعة.
- مولد وطباعة ملصقات الباركود: إنشاء ملصقات باركود قياسية للمنتجات متضمنة الاسم، السعر، الباركود، وشعار المتجر.
- أسعار التكلفة وهامش الربح: حساب هوامش الربح بدقة وتقديم حماية ضد البيع بأقل من سعر التكلفة.
- ملف شامل لكل عميل: بيانات الاتصال، العنوان، الرقم الضريبي، والرصيد الحالي.
- كشف حساب مالي تفصيلي: استعراض تاريخ المشتريات، الدفعات، فواتير الصيانة، والأرصدة المتبقية مع إمكانية التصدير والطباعة.
- سندات القبض والدفع: تسجيل سداد الديون بنقرة واحدة وتحديث رصيد العميل فورياً.
- إدارة الموردين: تسجيل بيانات الموردين، شروط الدفع، وحجم التعاملات.
- فواتير الشراء: تسجيل فواتير الشراء وتحديث كميات وأسعار التكلفة في المخزون فورياً.
- كشوفات حساب الموردين: تتبع الالتزامات المالية والمدفوعات الآجلة.
- تصنيف المصروفات: (إيجار، كهرباء، فواتير إنترنت، رواتب، أدوات صيانة وقطع مستهلكة، ضيافة، نثريات).
- الربط المالي التلقائي: خصم المصروفات تلقائياً من إجمالي الأرباح لاحتساب صافي الربح الفعلي بدقة.
- تقارير المبيعات والأرباح: رسوم بيانية تفاعلية لحركة المبيعات اليومية، الأسبوعية، الشهرية، والسنوية.
- تحليل تكلفة البضاعة المباعة (COGS): حساب دقيق للأرباح الإجمالية والصافية.
- الأصناف الأكثر مبيعاً والأعلى ربحية: مؤشرات بيانية لتوجيه قرارات الشراء والتسويق.
- تصدير وطباعة: إمكانية تصدير التقارير إلى ملفات Excel / CSV وطباعتها مباشرة.
- كفاءة الفنيين: تتبع عدد الأجهزة المصلحة، الأجهزة المعلقة، والأجهزة المرفوضة لكل فني.
- حساب نسب وعمولات الصيانة: احتساب مستحقات الفنيين بناءً على النسبة المحددة لكل عملية إصلاح.
- أدوار مجهزة مسبقاً: مدير عام (Admin) • كاشير (Cashier) • موظف مبيعات (Sales) • فني صيانة (Technician) • أمين مستودع (Inventory).
- مصفوفة صلاحيات مفصلة:
- صلاحية البيع وإصدار الفواتير.
- صلاحية منح الخصومات وتعديل الأسعار.
- صلاحية إدارة وحذف المنتجات والمخزون.
- صلاحية إدارة كروت وورشة الصيانة.
- صلاحية رؤية التكاليف والأرباح والتقارير المالية.
- صلاحية تغيير النشاط التجاري وتصفير البيانات (محصورة حصرياً بالمدير العام).
- توثيق زمني وأمني غير قابل للتعديل لكل عملية حساسة تتم في المنظومة (تسجيل بيع، تعديل سعر، حذف صنف، استلام جهاز، تصفير بيانات) موثقة باسم المستخدم وتوقيت الإجراء.
يتضمن النظام محرك قوالب ذكي يمكن تفعيله بنقرة زر واحدة من الإعدادات:
| النشاط التجاري | الأقسام الافتراضية | نماذج المنتجات والمخزون | تخصص الصيانة |
|---|---|---|---|
| كمبيوتر وشبكات 💻 | لابتوبات، كمبيوترات تجميع، شاشات، سويتشات وراوترات، ملحقات | معالجات، كروت شاشة، أقراص SSD، كابلات شبكة | صيانة مذربورد، ترقية رام، تنصيب برامج |
| كاميرات مراقبة وأمن 📹 | كاميرات IP، كاميرات انالوج، أجهزة NVR/DVR، أقراص تخزين، محولات | كاميرات 5MP و 4K، سويتشات PoE، كوابل RG59 | إصلاح باور NVR، ضبط عدسات، فحص شبكة |
| ورشة صيانة وإلكترونيات 🔧 | قطع غيار لابتوب، شاشات بديلة، أدوات لحام، بطاريات، شواحن | آيسيهات، شاشات LCD، باور سبلاي، كابلات فلكس | إصلاح شاشات، ريبولينج BGA، استبدال دوائر شحن |
| هواتف ذكية وأجهزة لوحية 📱 | هواتف ذكية، كفرات وحماية، شواحن وسماعات، قطع غيار شاشات | شاشات أصلية، بطاريات، كابلات Type-C وLightning | استبدال شاشة، تبديل بطارية، صيانة سوفتوير |
| نشاط مخصص وعام (من الصفر) 🚀 | قاعدة بيانات نظيفة تماماً بدون أي أصناف مسبقة لتأسيس النشاط بحرية | 0 منتجات (جاهز للإدخال المباشر) | متاح للتخصيص الكامل |
صُمم النظام ليوفر أقصى درجات الأمان وحماية البيانات الاستثمارية للشركات:
- النسخ الاحتياطي الإلزامي التلقائي (Mandatory Backup Guarantee):
- عند قيام المدير العام باختيار نشاط جديد أو طلب تصفير المنظومة، يقوم النظام تلقائياً وبشكل إجباري بتوليد وتنزيل ملف نسخة احتياطية كاملة (
.json) على جهاز الكمبيوتر قبل إجراء أي مسح للبيانات. - يتم الاحتفاظ بنسخة موازية سريعة داخل المتصفح، تظهر كشريط أخضر في الإعدادات يتيح إعادة تحميلها فوراً.
- عند قيام المدير العام باختيار نشاط جديد أو طلب تصفير المنظومة، يقوم النظام تلقائياً وبشكل إجباري بتوليد وتنزيل ملف نسخة احتياطية كاملة (
- التصفير الشامل والبدء من الصفر:
- تفريغ حسابات العملاء، الديون، فواتير المبيعات والمشتريات، والمصروفات.
- إزالة المستخدمين الإضافيين مع الإبقاء حصرياً على حساب المدير العام (Admin).
- حصر الصلاحيات الخطرة بالمدير العام:
- تم إخفاء وحجب أزرار تغيير النشاط، التصفير، واستعادة البيانات عن أي حساب لا يحمل صلاحية المدير العام لحماية المنظومة من عبث الموظفين.
- بيئة تشغيل Node.js (الإصدار 18 أو أحدث)
- مدير الحزم npm أو bun
# 1. استنساخ المشروع أو الانتقال للمجلد
git clone https://github.com/your-repo/pos-maintenance-erp.git
cd pos-maintenance-erp
# 2. تثبيت الحزم والمكتبات
npm install
# 3. تشغيل خادم التطوير المحلي
npm run devافتح متصفحك على الرابط:
http://localhost:3000
# فحص الأنواع والأخطاء البرمجية
npm run lint
# بناء نسخة الإنتاج المحسنة
npm run build
# معاينة نسخة الإنتاج
npm run previewلزيادة سرعة الكاشير وموظفي الاستقبال، تدعم المنظومة مفاتيح الوصول السريع:
| الاختصار | الوظيفة |
|---|---|
Ctrl + K أو Cmd + K |
فتح البحث الشامل الذكي في كامل النظام (منتج، عميل، تذكرة صيانة، فاتورة) |
F1 |
الانتقال الفوري لشاشة المبيعات والكاشير (POS) |
F2 |
الانتقال لقسم الصيانة واستقبال الأجهزة |
F10 |
فتح نافذة الدفع السريع وإتمام الفاتورة في الكاشير |
Esc |
إغلاق النوافذ المنبثقة والعودة للشاشة السابقة |
├── index.html # مدخل صفحة الويب وتنسيق الخطوط
├── metadata.json # بيانات وهوية التطبيق
├── package.json # التبعيات والأدوات المستخدمة
├── vite.config.ts # إعدادات Vite ومكونات Tailwind
├── public/
│ └── banner.svg # الصورة التوضيحية الرسمية للواجهة والمنظومة
└── src/
├── main.tsx # نقطة الانطلاق الرئيسية لتطبيق React
├── App.tsx # موجه الشاشات والتنقل والتهيئة
├── types.ts # التعريفات البرمجية والأنواع (TypeScript Interfaces)
├── index.css # تنسيقات Tailwind CSS والقواعد البصرية
├── context/
│ └── AppContext.tsx # محرك الحالة الشاملة، إدارة البيانات، التخزين والنسخ
├── data/
│ ├── initialData.ts # البيانات الأولية الافتراضية
│ └── industryTemplates.ts # قوالب الأنشطة التجارية المتخصصة
├── components/
│ ├── Header.tsx # الترويسة العلوية وبيانات المستخدم النشط
│ ├── Sidebar.tsx # القائمة الجانبية والصلاحيات الحركية
│ ├── OnboardingModal.tsx # نافذة تخصيص النشاط والتهيئة الأولية
│ ├── PrintModal.tsx # محرك طباعة الفواتير والإيصالات A4 وحراري
│ └── GlobalSearchModal.tsx # محرك البحث الفوري السريع
└── views/
├── DashboardView.tsx # لوحة القيادة والمؤشرات الحيوية
├── POSView.tsx # نقطة البيع والكاشير
├── MaintenanceView.tsx # ورشة الصيانة واستقبال الأجهزة
├── ProductsView.tsx # المنتجات، المخزون، والباركود
├── CategoriesView.tsx # الأقسام والتصنيفات
├── CustomersView.tsx # العملاء، كشوفات الحساب والمديونيات
├── PurchasesView.tsx # الموردين وفواتير الشراء
├── ExpensesView.tsx # المصروفات والرواتب
├── ReportsView.tsx # التقارير والتحليلات المالية
├── TechniciansView.tsx # الفنيين والعمولات
├── UsersView.tsx # المستخدمين والصلاحيات
├── AuditView.tsx # سجل تدقيق العمليات
└── SettingsView.tsx # إعدادات المتجر، القوالب، والتصفير الآمن
The Enterprise Point of Sale, Inventory & Workshop Maintenance ERP is a full-featured management web application crafted with React 19, TypeScript, Tailwind CSS 4, and Vite. Designed for IT suppliers, computer repair centers, CCTV installers, phone maintenance shops, and general retailers.
- Touchscreen & Barcode POS: Lightning-fast barcode scanner checkout, split/credit/cash payments, parking orders, and 80mm thermal/A4 tax invoice printing with QR code.
- Workshop & Repair Management: Customer device intake tickets, serial tracking, spare parts auto-deduction from stock, technician task dispatch, status updates, and printable device tags.
- Inventory & Barcode Labeling: Real-time stock alerts, low-stock threshold monitors, multi-tiered categories, margin calculation, and on-demand barcode label printer.
- Customer Ledgers & Debt Tracking: Complete statement of account, credit limits, debt payments, and payment receipt generation.
- Suppliers & Procurement: Purchase orders, supplier credit balances, and automated stock revaluation.
- Financial Reporting & BI: Visual charts for revenues, COGS (Cost of Goods Sold), net margins, top-selling inventory, and Excel/CSV exporting.
- Granular RBAC & User Management: Strict roles (Admin, Cashier, Sales, Tech, Stock Keeper) with granular permission toggles.
- Zero-Wipe & Industry Engine: 1-click industry template switching (Computers, CCTV, Maintenance, Phones, Clean Custom Slate). Enforces automated, mandatory JSON backup download before any wipe or reset, restricted exclusively to the Admin.
# Clone & install
git clone https://github.com/your-repo/pos-maintenance-erp.git
cd pos-maintenance-erp
npm install
# Run locally
npm run devنظام إدارة الأعمال ونقاط البيع والصيانة • تم البناء والتطوير بأعلى معايير الجودة والأداء
Built for reliability, speed, data safety, and peak business productivity.