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

وصلة إكسبريس

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

الدور
تصميم وتطوير كامل
السنة
2025 – 2026
المنصات
Android · iOS · Windows · Web · Server
6 تطبيقات
إدارة، تاجر، مندوب، عميل، فرع
باركود
فرز واستلام وبوليصة شحن
COD
تحصيل وعهد مناديب وتسويات
WhatsApp
إشعارات تلقائية للتجار والعملاء
المنصة الرسمية لنظام وصلة إكسبريس للشحن والعمليات اللوجستية
المنصة الرسمية لنظام وصلة إكسبريس للشحن والعمليات اللوجستية اضغط لتكبير الصورة ⤢

فكرة المشروع

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

شركات الشحن في السوق المصري بتدير آلاف الشحنات يوميا بين فروع ومخازن ومناديب وتجار. لما التشغيل بيتوزع على شيتات إكسيل ورسائل واتساب يدوية، بتضيع حالة الشحنة، وتختلط عهدة المندوب بحساب التاجر، وتتعطل التسويات المالية

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

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

كود Flutter واحد يبنى منه 6 نسخ (Full، Admin، Merchant، Customer، Courier، Employee) عبر compile-time defines و Android flavors، فوق قاعدة PostgreSQL/Supabase محمية بـ 230 migration و 19 Edge Function، مع خادم Node.js/Express مستقل لأتمتة إشعارات جروبات واتساب عبر WebSockets

مخطط معماري لمنظومة وصلة إكسبريس للشحن والتسويات المالية وأتمتة واتسابARCHITECTURE BLUEPRINT · MULTI-COMPANY LOGISTICS6 APPS · 230 MIGRATIONS · COD LEDGERSINGLE FLUTTER CODEBASE · 6 COMPILE-TIME VARIANTS (ANDROID · iOS · WINDOWS · WEB)AdminWin / MobileMerchantBulk + AWBCourierQR + PODCustomerLive TrackBranch HubSort & ScanFull OpsRiverpodEDGE & PARTNER APIs19 Supabase Edge FunctionsE-Commerce Webhooks · Outbox Queue · Signed ReleasesREALTIME AUTOMATION SERVERNode.js / Express + WebSocketsAutomated WhatsApp Merchant Groups & Delivery AlertsPOSTGRESQL CORE · 230 MIGRATIONS · MULTI-COMPANY ROW LEVEL SECURITYshipments & immutable history · hub_transfers & runsheets · COD courier custody & merchant settlements · 155 test files
L1

Clients · Flutter (6 Variants)

تطبيقات الموبايل والويب وويندوز من كود واحد

  • wasla_admin (Win/Mobile)
  • wasla_merchant (Win/Mobile)
  • wasla_courier
  • wasla_customer
  • wasla_employee
  • Riverpod + GoRouter
L2

Edge & Automation Services

منطق الخادم والأتمتة اللحظية

  • 19 Supabase Edge Functions
  • Outbox Notification Sender
  • wasla-whatsapp-server (Node/WS)
  • Ecommerce Webhooks & Partner API
L3

Data & Ledger Core · PostgreSQL

عزل الشركات، حركات المخزن، والتسويات المالية

  • 230 Declarative Migrations
  • Strict Row Level Security
  • RPCs (SECURITY DEFINER)
  • Signed Release Manifests (SHA-256)
التقنيات — الأدوات والتقنيات المستخدمة:
  • Flutter
  • Dart
  • Riverpod
  • Supabase
  • PostgreSQL
  • Row Level Security
  • Edge Functions (Deno)
  • Node.js
  • Express
  • WebSockets
  • Docker
  • Railway
  • Codemagic

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

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

مخطط علائقي متعدد الشركات يربط دورة حياة الشحنة من لحظة الإنشاء وطباعة البوليصة (AWB) مرورا بفرز المخازن وشيتات المناديب (Runsheets) حتى التحصيل النقدي والتسوية النهائية

الجدول الدور داخل النظام
shipments / shipment_items الشحنة، بنودها، إحداثيات العميل، ومبلغ الـ COD
shipment_history سجل زمني غير قابل للتعديل لكل انتقال حالة
hubs / hub_transfers الفروع والمخازن ومحاضر التسليم والفرز بينها
runsheets / courier_location_events شيتات خط سير المندوب وتتبع موقعه لحظيا
financial_transactions عهدة المندوب، تسويات التجار، والفواتير
merchant_pricing_rules / awb_configs تسعير مخصص لكل تاجر/منطقة وقوالب بوالص الشحن

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

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

01

كود واحد لـ 6 تطبيقات عبر APP_VARIANT

بدل صيانة 5 مستودعات منفصلة تتفرع وتختلف مع الوقت، يعتمد النظام على `--dart-define=APP_VARIANT=...` مع سكربتات بناء تفصل اسم الحزمة والتوقيع ومخرجات كل دور (إدارة، تاجر، مندوب، عميل، موظف)، مع قصر توزيع ويندوز على الإدارة والتاجر فقط

02

ربط التسليم بالتسوية المالية في خطوة واحدة

تحديث حالة الشحنة إلى «تم التسليم» لا يغير نص الحالة فقط؛ بل ينشئ قيد عهدة نقدية على المندوب وقيد استحقاق للتاجر عبر دوال RPC محمية، مما يمنع تضارب الأرصدة

03

خادم واتساب مستقل بـ Rate Limiting و Session Store

فصل أتمتة رسائل جروبات الشحن في خدمة Node.js/Express مستقلة (`wasla-whatsapp-server`) تستخدم WebSockets و Supabase مع محدد معدل إرسال لكل جروب وحفظ الجلسات لمنع الحظر عند ضغط العمليات

04

مركز إصدارات موقع بـ SHA-256

توزيع التحديثات عبر مستودع `wasla-app-releases` بملف `manifest.json` و `checksums.sha256` وشهادة توقيع موحدة للتحقق من سلامة كل حزمة APK أو Windows قبل التثبيت

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

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

  • التطبيق يستخدم المفتاح العام فقط؛ لا وجود لـ service_role في الكود العميل، وكل الصلاحيات تفرض داخل PostgreSQL عبر RLS
  • تغليف العمليات الحساسة (التسويات، تغيير الأدوار، ترحيل الشيتات) داخل دوال RPC مقيدة ومفحوصة ضد التكرار (RLS recursion)
  • 155 ملف اختبارات ومراجعات أداء (SQL benchmarks) وفهارس مفاتيح أجنبية صريحة لكل جدول تشغيلي

من داخل الكود

محدد معدل الإرسال وخفض الحمل في خادم واتساب وصلة

wasla-whatsapp-server/rateLimiter.js · JS
export class GroupRateLimiter {
  constructor({ windowMs = 60_000, maxPerGroup = 12 } = {}) {
    this.windowMs = windowMs;
    this.maxPerGroup = maxPerGroup;
    this.buckets = new Map();
  }
  allow(groupId, now = Date.now()) {
    const recent = (this.buckets.get(groupId) ?? []).filter((t) => now - t < this.windowMs);
    if (recent.length >= this.maxPerGroup) return { ok: false, retryAfterMs: this.windowMs - (now - recent[0]) };
    recent.push(now);
    this.buckets.set(groupId, recent);
    return { ok: true, remaining: this.maxPerGroup - recent.length };
  }
}

ملخص المشروع

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

نظام حي على `wasla-system.site` يشغل دورة الشحن كاملة عبر 5 تطبيقات أندرويد/iOS وتطبيقي ويندوز وواجهة ويب، بقاعدة بيانات تضم 230 migration موثقة

المشروع التالي ورقة وقلم → متجر إلكتروني + كاشير + مخزن

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

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

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