Shafei Vehicle Management App

English

Shafei — Vehicle Import/Export & Fleet Management Platform

Shafei is a full-stack management system built for a vehicle import/export company to digitize and centralize their entire operation — from customer onboarding to fleet tracking and compliance reporting.

The platform supports multi-role access control (Admins, Super Admins, and standard Users), each with tailored permissions and dashboards, ensuring sensitive operations like financial reviews and admin management stay restricted to authorized roles.

Core Features:

Customer & Request Management – centralized customer records with request tracking and status workflows

Fleet Management – full vehicle (car) registry alongside a dedicated Private Cars module with owner tracking and import type classification

Operational Reporting – structured reports for Triptik documents, Licenses, and Storage, built for quick auditing and compliance

Billing Oversight – an "Unreviewed Bills" queue to ensure no invoice goes unchecked

Real-time Notifications – live in-app alerts keep admins and staff instantly updated on new requests, bills, and status changes

Resource Management – supporting modules for Referrers, Ports, Clubs, Gallery, and Countries to manage the full ecosystem around each shipment/transaction

Tech Highlights:

Built as a Turborepo monorepo with Next.js 15 (React 19) frontend and Express.js 5 backend

PostgreSQL + Drizzle ORM for type-safe database operations

Better Auth for secure, role-based authentication

Redis + BullMQ for background job processing (notifications, async tasks)

AWS S3 for file/document storage, SendGrid & Twilio for email/SMS notifications

Fully internationalized (i18n) UI with next-intl for multi-language support

Deployed via Railway with a clean, scalable monorepo architecture

This project demonstrates strong full-stack capability across complex business logic, role-based security, real-time systems, and operational reporting tools — tailored to real-world logistics/import-export workflows.

العربية

شافعي — منصة إدارة استيراد وتصدير السيارات والأسطول

شافعي هو نظام إدارة متكامل (Full-Stack) تم بناؤه لشركة استيراد وتصدير سيارات، بهدف رقمنة وتنظيم العملية بالكامل — من تسجيل العملاء وحتى تتبع الأسطول وإعداد تقارير الالتزام.

تدعم المنصة نظام صلاحيات متعدد الأدوار (مدير، مدير عام، ومستخدم عادي)، حيث يحصل كل دور على لوحة تحكم وصلاحيات مخصصة، لضمان أن العمليات الحساسة مثل مراجعة الفواتير وإدارة الحسابات تبقى محصورة بالأدوار المخوّلة فقط.

أهم المميزات:

إدارة العملاء والطلبات – سجلات عملاء مركزية مع تتبع حالة الطلبات بشكل كامل

إدارة الأسطول – سجل شامل للسيارات بالإضافة إلى وحدة مخصصة لـالسيارات الخاصة مع تتبع الملاك وتصنيف نوع الاستيراد

التقارير التشغيلية – تقارير منظمة لوثائق الترانزيت (Triptik)، الرخص، والتخزين لتسهيل المراجعة والالتزام

مراقبة الفواتير – قائمة "فواتير غير مراجعة" لضمان عدم تجاهل أي فاتورة

إشعارات لحظية (Real-time) – تنبيهات فورية داخل النظام لإبقاء الإدارة والموظفين على اطلاع بأي طلب أو فاتورة أو تغيير في الحالة

إدارة الموارد المساندة – وحدات لإدارة المُحيلين (Referrers)، الموانئ، الأندية، معرض الصور، والدول لتغطية كل تفاصيل العملية

أبرز التقنيات المستخدمة:

بنية Monorepo باستخدام Turborepo، بواجهة أمامية Next.js 15 (React 19) وخلفية Express.js 5

PostgreSQL مع Drizzle ORM لعمليات قاعدة بيانات آمنة من ناحية الأنواع (Type-safe)

Better Auth لنظام مصادقة آمن قائم على الأدوار

Redis و BullMQ لمعالجة المهام الخلفية (الإشعارات والعمليات غير المتزامنة)

AWS S3 لتخزين الملفات والمستندات، وSendGrid وTwilio للإشعارات بالبريد الإلكتروني والرسائل النصية

واجهة مدعومة بتعدد اللغات (i18n) باستخدام next-intl

تم نشر المشروع عبر Railway بهيكلية Monorepo قابلة للتوسّع

يعكس هذا المشروع قدرة قوية على بناء أنظمة Full-Stack معقدة، تتضمن منطق أعمال متقدم، أمان قائم على الأدوار، أنظمة لحظية (Real-time)، وأدوات تقارير تشغيلية — مصممة خصيصًا لتناسب سير عمل شركات الشحن والاستيراد والتصدير.