وصلة إكسبريس
منصة تشغيل لإدارة شركات الشحن في مصر: استلام وفرز الشحنات، إدارة الفروع والمخازن، خطوط سير المناديب، إثبات التسليم، والتحصيل النقدي وتسويات التجار، مع 6 نسخ تطبيق للإدارة والتاجر والمندوب والعميل
- الدور
- تصميم وتطوير كامل
- السنة
- 2025 – 2026
- المنصات
- Android · iOS · Windows · Web · Server
- 6 تطبيقات
- إدارة، تاجر، مندوب، عميل، فرع
- باركود
- فرز واستلام وبوليصة شحن
- COD
- تحصيل وعهد مناديب وتسويات
- إشعارات تلقائية للتجار والعملاء
فكرة المشروع
المشكلة واحتياج السوق
شركات الشحن في السوق المصري بتدير آلاف الشحنات يوميا بين فروع ومخازن ومناديب وتجار. لما التشغيل بيتوزع على شيتات إكسيل ورسائل واتساب يدوية، بتضيع حالة الشحنة، وتختلط عهدة المندوب بحساب التاجر، وتتعطل التسويات المالية
معمارية النظام
مكونات وطبقات النظام
كود Flutter واحد يبنى منه 6 نسخ (Full، Admin، Merchant، Customer، Courier، Employee) عبر compile-time defines و Android flavors، فوق قاعدة PostgreSQL/Supabase محمية بـ 230 migration و 19 Edge Function، مع خادم Node.js/Express مستقل لأتمتة إشعارات جروبات واتساب عبر WebSockets
Clients · Flutter (6 Variants)
تطبيقات الموبايل والويب وويندوز من كود واحد
- wasla_admin (Win/Mobile)
- wasla_merchant (Win/Mobile)
- wasla_courier
- wasla_customer
- wasla_employee
- Riverpod + GoRouter
Edge & Automation Services
منطق الخادم والأتمتة اللحظية
- 19 Supabase Edge Functions
- Outbox Notification Sender
- wasla-whatsapp-server (Node/WS)
- Ecommerce Webhooks & Partner API
Data & Ledger Core · PostgreSQL
عزل الشركات، حركات المخزن، والتسويات المالية
- 230 Declarative Migrations
- Strict Row Level Security
- RPCs (SECURITY DEFINER)
- Signed Release Manifests (SHA-256)
قاعدة البيانات
هيكل البيانات وأهم الجداول
مخطط علائقي متعدد الشركات يربط دورة حياة الشحنة من لحظة الإنشاء وطباعة البوليصة (AWB) مرورا بفرز المخازن وشيتات المناديب (Runsheets) حتى التحصيل النقدي والتسوية النهائية
| الجدول | الدور داخل النظام |
|---|---|
shipments / shipment_items | الشحنة، بنودها، إحداثيات العميل، ومبلغ الـ COD |
shipment_history | سجل زمني غير قابل للتعديل لكل انتقال حالة |
hubs / hub_transfers | الفروع والمخازن ومحاضر التسليم والفرز بينها |
runsheets / courier_location_events | شيتات خط سير المندوب وتتبع موقعه لحظيا |
financial_transactions | عهدة المندوب، تسويات التجار، والفواتير |
merchant_pricing_rules / awb_configs | تسعير مخصص لكل تاجر/منطقة وقوالب بوالص الشحن |
تفاصيل التنفيذ
أهم الحلول والقرارات التقنية
كود واحد لـ 6 تطبيقات عبر APP_VARIANT
بدل صيانة 5 مستودعات منفصلة تتفرع وتختلف مع الوقت، يعتمد النظام على `--dart-define=APP_VARIANT=...` مع سكربتات بناء تفصل اسم الحزمة والتوقيع ومخرجات كل دور (إدارة، تاجر، مندوب، عميل، موظف)، مع قصر توزيع ويندوز على الإدارة والتاجر فقط
ربط التسليم بالتسوية المالية في خطوة واحدة
تحديث حالة الشحنة إلى «تم التسليم» لا يغير نص الحالة فقط؛ بل ينشئ قيد عهدة نقدية على المندوب وقيد استحقاق للتاجر عبر دوال RPC محمية، مما يمنع تضارب الأرصدة
خادم واتساب مستقل بـ Rate Limiting و Session Store
فصل أتمتة رسائل جروبات الشحن في خدمة Node.js/Express مستقلة (`wasla-whatsapp-server`) تستخدم WebSockets و Supabase مع محدد معدل إرسال لكل جروب وحفظ الجلسات لمنع الحظر عند ضغط العمليات
مركز إصدارات موقع بـ SHA-256
توزيع التحديثات عبر مستودع `wasla-app-releases` بملف `manifest.json` و `checksums.sha256` وشهادة توقيع موحدة للتحقق من سلامة كل حزمة APK أو Windows قبل التثبيت
الأمان والصلاحيات
تأمين البيانات والصلاحيات
- التطبيق يستخدم المفتاح العام فقط؛ لا وجود لـ service_role في الكود العميل، وكل الصلاحيات تفرض داخل PostgreSQL عبر RLS
- تغليف العمليات الحساسة (التسويات، تغيير الأدوار، ترحيل الشيتات) داخل دوال RPC مقيدة ومفحوصة ضد التكرار (RLS recursion)
- 155 ملف اختبارات ومراجعات أداء (SQL benchmarks) وفهارس مفاتيح أجنبية صريحة لكل جدول تشغيلي
من داخل الكود
محدد معدل الإرسال وخفض الحمل في خادم واتساب وصلة
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 موثقة