أحمد الصعيديProduct & Systems Engineer
← كل المشاريع البرمجية
نظام مخزون ومحاسبة ونقاط بيع محلي
مشروع عميل

ManageX ERP & POS

نظام مخزون وحسابات ونقطة بيع يشتغل محليا على شبكة الشركة: إدارة المشتريات والمبيعات والكاشير، جرد المخزون بالمستندات، الخزينة وحسابات العملاء والموردين، وصلاحيات المستخدمين

الدور
تصميم وتطوير كامل
السنة
2026
المنصات
Windows · Web · Server
كاشير POS
مبيعات سريعة وطباعة فواتير
مخازن وخزينة
جرد أصناف وحسابات موردين
عربي / EN
واجهة كاملة بلغتين
LAN
يعمل على الشبكة المحلية بدون إنترنت
لوحة التشغيل اليومية ومؤشرات المخزون والمبيعات والذمم في نظام ManageX
لوحة التشغيل اليومية ومؤشرات المخزون والمبيعات والذمم في نظام ManageX اضغط لتكبير الصورة ⤢

فكرة المشروع

المشكلة واحتياج السوق

الشركات التجارية والمخازن اللي بتشتغل على شبكة داخلية (LAN) بتحتاج نظام سريع لا يتوقف لو الإنترنت فصل، وفي نفس الوقت يمنع التلاعب في الأرصدة أو تعديل الفواتير النقدية بدون أثر

معمارية النظام

مكونات وطبقات النظام

نظام محلي (Local-First) يعمل على ويندوز عبر الشبكة الداخلية: خادم FastAPI + قاعدة PostgreSQL لا يصل إليها إلا الخادم، وواجهة تشغيل ثنائية اللغة (عربي/إنجليزي) تدعم الكاشير والباركود والطباعة الحرارية 80مم وفواتير A4

مخطط معماري لمنظومتي ورقة وقلم وManageX للتجارة الموحدة والكاشير الأوفلاينARCHITECTURE BLUEPRINT · OMNICHANNEL & OFFLINE POS120 TABLES · 572 TESTS · 80MM THERMALONLINE STOREFRONTWarqa w Qalam Web52 Public Web RoutesCart · Checkout · OrdersRTL Mobile + DesktopIN-STORE & OFFLINE LANBarcode POS & ManageX• Works Without Internet• USB Barcode Scanner• 58/80mm Thermal & A4Signed Offline LicenseERP & RBAC ENGINELaravel 12 / FastAPI• 184 RBAC Staff APIs• 6-Role Permission Guard• Supplier Purchase Orders• Server Print PDF Engine• Margin & Sales Analytics572 PHPUnit Tests7,786 Assertions + E2EIMMUTABLE LEDGER DBPostgreSQL (120 Tables)Stock LedgerDocument-Backed OnlyCash TreasuryAppend-Only ShiftsPartner Sub-LedgersSuppliers & CustomersMandatory Audit TrailNo silent balance edits
L1

Operations UI · Desktop & Mobile LAN

شاشات المخزن والمشتريات ونقطة البيع والخزينة

  • Bilingual UI (AR / EN)
  • Barcode POS Session
  • A4 & 80mm Receipt Preview
  • Responsive 390px LAN View
L2

Application Server · FastAPI (Python)

منطق الأعمال، الصلاحيات، والطباعة، والترخيص

  • FastAPI REST Services
  • 6-Role RBAC Catalog
  • Server-Side Print Templates
  • Digitally Signed License Verifier
L3

Persistence · PostgreSQL (Server-Only)

دفتر المخزون، الذمم، الخزينة، وسجل التدقيق

  • Document-Backed Stock Ledger
  • Append-Only Cash Treasury
  • Customer & Supplier Sub-Ledgers
  • Immutable Security Audit Log
التقنيات — الأدوات والتقنيات المستخدمة:
  • FastAPI
  • Python
  • PostgreSQL

قاعدة البيانات

هيكل البيانات وأهم الجداول

التصميم المالي والمخزني قائم على مبدأ القيد الموثق: لا توجد شاشة لتعديل رقم الرصيد مباشرة؛ الرصيد هو دائما مجموع الحركات الموثقة بمستند

الجدول الدور داخل النظام
products / warehouses الكتالوج (اسم عربي/إنجليزي، باركود، وحدات، سعرين) والمخازن
stock_ledger_entries دفتر حركات المخزون المرتبط إلزاميا بمستند شراء/بيع/تحويل/جرد
purchase_orders / sales_orders / pos_sessions فواتير الشراء والبيع وجلسات الكاشير
treasury_entries / partner_balances دفتر الخزينة والبنك وذمم العملاء والموردين
roles / permissions / audit_logs كتالوج الصلاحيات وسجل التدقيق الإلزامي لكل عملية

تفاصيل التنفيذ

أهم الحلول والقرارات التقنية

01

دفتر مخزون ونقدية لا يقبل قيدا بلا مستند (Append-Only Ledger)

أي زيادة أو نقص في المخزون أو الخزينة لازم يمر عبر ترحيل مستند رسمي (فاتورة شراء، بيع، تحويل، أو تسوية جرد)، مما يجعل مراجعة أي فرق حسابي مسألة تتبع مستندات لا تخمين

02

قوالب طباعة A4 و 80مم تبنى على الخادم وتسجل في التدقيق

توليد الفواتير والإيصالات الحرارية يتم على خادم FastAPI بالعربية والإنجليزية لضمان تطابق الأرقام والترويسة، مع تسجيل كل عملية طباعة في `audit_logs`.

03

ترخيص موقع رقميا يعمل أونلاين وأوفلاين

حماية النسخة المحلية بنظام ترخيص موقع رقميا يرتبط بالجهاز ويدعم التفعيل بدون إنترنت مع نسخ احتياطي واستعادة مدمجين

الأمان والصلاحيات

تأمين البيانات والصلاحيات

  • قاعدة بيانات PostgreSQL معزولة محليا لا يقبل الاتصال بها إلا خادم FastAPI
  • 6 أدوار جاهزة بكتالوج صلاحيات تفصيلي يحمي التقارير المالية والخصومات وإدارة المستخدمين
  • سجل تدقيق إجباري يوثق تسجيل الدخول، تغيير الصلاحيات، ترحيل الفواتير، والطباعة

من داخل الكود

قاعدة عدم قبول حركة مخزنية بلا مستند مرجعي

managex/domain/ledger.py · PY
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)

ملخص المشروع

النتيجة وحالة التشغيل

يعمل كتثبيت محلي لفريق كامل على ويندوز، ويغطي الدورة الكاملة من الكتالوج والشراء إلى نقطة البيع والخزينة والتقارير

المشروع التالي مغسلتي → سوق خدمات الغسيل والتوصيل

جلسة تقييم تقنية · مصر / الخليج / عن بُعد

محتاج تبني نظام تشغيل، تنقذ مشروع AI، أو تبدأ عقد تطوير شهــــــــــري؟

حدد نوع المطلوب ومرحلة المشروع والميزانية التقريبية في نموذج التقييم خلال 30 ثانية عشان نبدأ الكلام بخطة معمارية عملية مباشرة.