ManageX ERP & POS
نظام مخزون وحسابات ونقطة بيع يشتغل محليا على شبكة الشركة: إدارة المشتريات والمبيعات والكاشير، جرد المخزون بالمستندات، الخزينة وحسابات العملاء والموردين، وصلاحيات المستخدمين
- الدور
- تصميم وتطوير كامل
- السنة
- 2026
- المنصات
- Windows · Web · Server
- كاشير POS
- مبيعات سريعة وطباعة فواتير
- مخازن وخزينة
- جرد أصناف وحسابات موردين
- عربي / EN
- واجهة كاملة بلغتين
- LAN
- يعمل على الشبكة المحلية بدون إنترنت
فكرة المشروع
المشكلة واحتياج السوق
الشركات التجارية والمخازن اللي بتشتغل على شبكة داخلية (LAN) بتحتاج نظام سريع لا يتوقف لو الإنترنت فصل، وفي نفس الوقت يمنع التلاعب في الأرصدة أو تعديل الفواتير النقدية بدون أثر
معمارية النظام
مكونات وطبقات النظام
نظام محلي (Local-First) يعمل على ويندوز عبر الشبكة الداخلية: خادم FastAPI + قاعدة PostgreSQL لا يصل إليها إلا الخادم، وواجهة تشغيل ثنائية اللغة (عربي/إنجليزي) تدعم الكاشير والباركود والطباعة الحرارية 80مم وفواتير A4
Operations UI · Desktop & Mobile LAN
شاشات المخزن والمشتريات ونقطة البيع والخزينة
- Bilingual UI (AR / EN)
- Barcode POS Session
- A4 & 80mm Receipt Preview
- Responsive 390px LAN View
Application Server · FastAPI (Python)
منطق الأعمال، الصلاحيات، والطباعة، والترخيص
- FastAPI REST Services
- 6-Role RBAC Catalog
- Server-Side Print Templates
- Digitally Signed License Verifier
Persistence · PostgreSQL (Server-Only)
دفتر المخزون، الذمم، الخزينة، وسجل التدقيق
- Document-Backed Stock Ledger
- Append-Only Cash Treasury
- Customer & Supplier Sub-Ledgers
- Immutable Security Audit Log
قاعدة البيانات
هيكل البيانات وأهم الجداول
التصميم المالي والمخزني قائم على مبدأ القيد الموثق: لا توجد شاشة لتعديل رقم الرصيد مباشرة؛ الرصيد هو دائما مجموع الحركات الموثقة بمستند
| الجدول | الدور داخل النظام |
|---|---|
products / warehouses | الكتالوج (اسم عربي/إنجليزي، باركود، وحدات، سعرين) والمخازن |
stock_ledger_entries | دفتر حركات المخزون المرتبط إلزاميا بمستند شراء/بيع/تحويل/جرد |
purchase_orders / sales_orders / pos_sessions | فواتير الشراء والبيع وجلسات الكاشير |
treasury_entries / partner_balances | دفتر الخزينة والبنك وذمم العملاء والموردين |
roles / permissions / audit_logs | كتالوج الصلاحيات وسجل التدقيق الإلزامي لكل عملية |
تفاصيل التنفيذ
أهم الحلول والقرارات التقنية
دفتر مخزون ونقدية لا يقبل قيدا بلا مستند (Append-Only Ledger)
أي زيادة أو نقص في المخزون أو الخزينة لازم يمر عبر ترحيل مستند رسمي (فاتورة شراء، بيع، تحويل، أو تسوية جرد)، مما يجعل مراجعة أي فرق حسابي مسألة تتبع مستندات لا تخمين
قوالب طباعة A4 و 80مم تبنى على الخادم وتسجل في التدقيق
توليد الفواتير والإيصالات الحرارية يتم على خادم FastAPI بالعربية والإنجليزية لضمان تطابق الأرقام والترويسة، مع تسجيل كل عملية طباعة في `audit_logs`.
ترخيص موقع رقميا يعمل أونلاين وأوفلاين
حماية النسخة المحلية بنظام ترخيص موقع رقميا يرتبط بالجهاز ويدعم التفعيل بدون إنترنت مع نسخ احتياطي واستعادة مدمجين
الأمان والصلاحيات
تأمين البيانات والصلاحيات
- قاعدة بيانات PostgreSQL معزولة محليا لا يقبل الاتصال بها إلا خادم FastAPI
- 6 أدوار جاهزة بكتالوج صلاحيات تفصيلي يحمي التقارير المالية والخصومات وإدارة المستخدمين
- سجل تدقيق إجباري يوثق تسجيل الدخول، تغيير الصلاحيات، ترحيل الفواتير، والطباعة
من داخل الكود
قاعدة عدم قبول حركة مخزنية بلا مستند مرجعي
ALLOWED_SOURCES = {"purchase_invoice", "sales_invoice", "pos_receipt", "stock_transfer", "inventory_count"}
def record_stock_movement(*, sku_id: int, warehouse_id: int, qty_delta: Decimal,
source_type: str, source_id: int, actor_id: int) -> LedgerEntry:
if source_type not in ALLOWED_SOURCES or not source_id:
raise ValueError("Stock movement rejected: a posted source document is required")
if qty_delta == 0:
raise ValueError("Zero-quantity movement is not permitted")
return LedgerEntry(sku_id=sku_id, warehouse_id=warehouse_id, qty_delta=qty_delta,
source_type=source_type, source_id=source_id, created_by=actor_id) واجهات النظام
لقطات شاشة من داخل النظام
واجهات الويب ولوحات الإدارة
شاشات تطبيق الموبايل
ملخص المشروع
النتيجة وحالة التشغيل
يعمل كتثبيت محلي لفريق كامل على ويندوز، ويغطي الدورة الكاملة من الكتالوج والشراء إلى نقطة البيع والخزينة والتقارير