# SupplyX -- Complete Platform Reference
# This file is for AI crawlers and language models.
# Last updated: 2026-08-23

## Overview

SupplyX is an all-in-one operations platform for distribution, logistics, and delivery businesses. It manages the complete order lifecycle from customer acquisition through field sales, warehouse preparation, driver delivery, and financial settlement.

Core value proposition: One backend, four apps, zero data silos. Every department sees the same data in real time.

## System Architecture

### Technology Stack
- Frontend: React 19, TypeScript, Vite 6, Tailwind CSS v4
- Landing page: Next.js 16, deployed on Vercel
- Backend: Supabase (PostgreSQL + Auth + Row Level Security + Edge Functions + Realtime)
- Optional ERP: Odoo integration via Supabase Edge Functions (TypeScript/Deno)
- PWA: Service workers for offline capability on Sales, Driver, and Dispatcher apps

### Database Schema
- ~77 tables across public and private schemas
- ~193 Row Level Security policies
- ~210 SQL functions
- Single consolidated schema file: supabase/schema.sql
- Optional KPI schema for Odoo-synced analytics

### Deployment
- Vercel (multi-app deployment via vercel.json rewrites)
- Root domain: supplyx.space
- App routes: /sales, /driver, /dispatcher (PWA-style hash routing)
- Admin app: served from root

## The Four Applications in Detail

### 1. Admin Dashboard
URL: https://www.supplyx.space
Users: Owners, managers, back-office staff
Platform: Web (desktop)

Modules:
- Dashboard -- Real-time overview with tabs: Overview, Logistics, Telesales, Approvals, Sales. Shows revenue, orders, customers, visits, fleet KPIs, charts.
- Customers (CRM) -- Full customer profiles with search, filters (status, segment, assigned agent), view history (visits, orders, calls, tickets). Create/edit customers. VIP and SMB tiers.
- Orders -- Create, track, assign orders. Filter by status, date, delivery agent. Order detail shows items, status transitions, timeline.
- Visits -- Track field sales visits with check-in/out, duration, location, visit results. Audit view for supervisors.
- Calls -- Log and review call activities with duration, outcome, recordings, sentiment analysis.
- Customer Service (Tickets) -- Support ticket management with priority (urgent/high/medium/low), status, categories. Threaded conversations. Internal notes.
- Logistics -- Overview (fleet KPIs, shipment counts, driver status), Shipments (unassigned vs assigned queues), Plans (dispatcher workbench), Live Tracking Map.
- Finance -- Monthly revenue, expenses, net profit, accounts receivable, cash position, overdue invoices, pending settlements, journal entries, invoice management.
- Users and Access Control -- 8 predefined roles with granular permissions. Invite users, manage roles, view activity.
- Notifications -- Real-time notification center with read/unread, bulk mark-read.

### 2. Sales App (Mobile PWA)
URL: https://www.sales.supplyx.space
Users: Field sales representatives
Platform: Mobile PWA (installable, offline-capable)

Modules:
- Dashboard -- Time-aware greeting, today's stats, quick actions, recent visits, nearby customers.
- Customers -- Searchable/filterable customer list with actions: call, record call, WhatsApp, map, check-in.
- Check-in Visit Wizard (3 steps): Arrival and Timer, Visit Details, Visual Proof.
- Visits History -- All past visits with outcome, duration, geofence status, photo proof, CSV export.
- Route Optimization -- Nearest-neighbor route planning from current location.
- Calls -- Structured call recording with customer profile, reason, response, outcome, next action.
- Offline-First -- Works without signal, GPS tracking, geofence enforcement, camera proof.

### 3. Driver App (Mobile PWA)
URL: https://www.drivers.supplyx.space
Users: Delivery drivers
Platform: Mobile PWA (installable, offline-capable)

Modules:
- Dashboard -- Today's stats, progress bar, shift workflow stepper, live route map, quick actions.
- Deliveries List -- Route-gated shipment list with status badges.
- Shipment Detail -- Full info with actions: start delivery, confirm arrival, confirm delivery (POD), report failure.
- Route -- Plan cards with stop-by-stop timeline. Navigation to Google Maps.
- Load Confirmation -- Verify warehouse pick-up before departure.
- Collection -- Cash settlement hub with receipt photo and notes.
- Offline-First -- Service worker, queued actions sync, IndexedDB caching.

### 4. Dispatcher App (Mobile/Tablet PWA)
URL: https://www.inventory.supplyx.space
Users: Warehouse staff, dispatchers, warehouse supervisors/managers
Platform: Mobile/Tablet PWA (installable, offline-capable)

Modules:
- Dashboard -- Plan stats, quick actions, recent plans.
- Plans List -- Delivery plans with status. Print mode for A4 runsheets.
- Plan Detail and Preparation Flow -- Receive plan, confirm product quantities, flag shortages, complete preparation.
- Scanner -- Full-screen barcode tool with camera, keyboard wedge, manual entry.
- Inventory -- Read-only stock browser with product details.
- Returns -- Receive returned shipments, confirm full/partial receipt.

## Order Lifecycle

Customer > Sales (field visit / order creation) > Dispatcher (plan creation, driver assignment, warehouse preparation) > Driver (load confirmation, route execution, proof of delivery, cash collection) > Admin (settlement, invoicing, reporting)

### Logistics Status Flow
PENDING_ASSIGN > ASSIGNED > CHECK_IN/PICKUP > OUT_FOR_DELIVERY/ARRIVED > DELIVERED/FINISHED/SETTLED > CANCELLED

## Roles and Permissions

| Role | Access Level | Description |
|------|-------------|-------------|
| admin | Full system | Complete access to all modules and settings |
| manager | Management | Management-level visibility across modules |
| supervisor | Team oversight | Supervisory access to team performance |
| spv | Specialized | Specialized supervisor access |
| dispatcher | Dispatch operations | Warehouse prep, plan creation, driver assignment |
| driver | Delivery operations | Route execution, POD, cash collection |
| sales_agent | Field sales | Customer visits, orders, lead tracking |
| telesales | Phone sales | Call-based sales and customer management |

## Pricing Model

Custom pricing based on:
- Number of drivers/users
- Number of apps needed (all 4 or select)
- Odoo integration (optional add-on)
- Support level

Contact: info@supplyx.space

## API Endpoints (Landing Page)

- POST /api/book-meeting -- Book a demo meeting (params: name, email, company, fleetSize, date, time, message)
- POST /api/contact -- Send a contact inquiry (params: name, email, company, fleetSize, message)
- POST /api/chat -- AI chatbot endpoint
- GET /api/search -- Search endpoint

## Competitors

- Oracle SCM Cloud
- SAP Integrated Business Planning
- Zoho Inventory
- Odoo (standalone)
- Fleet management: Samsara, Verizon Connect, KeepTruckin
- MENA-specific: TruKKer, Careem (delivery), HungerStation (logistics)

## Target Keywords (English)

logistics management platform, delivery management software, fleet management Saudi Arabia, operations management MENA, delivery driver app, warehouse management, field sales app, distribution management, Odoo ERP alternative, PWA delivery app, route optimization software, proof of delivery app, dispatcher software, sales force automation MENA

## Target Keywords (Arabic)

منصة إدارة اللوجستيات, نظام إدارة التوصيل, إدارة أسطول التوصيل, تطبيق سائق التوصيل, نظام إدارة المبيعات الميدانية, إدارة المستودع, برنامج توزيع المنتجات, بديل اودو, نظام إثبات التوصيل, إدارة خطة التوصيل, تطبيق مندوب المبيعات, برنامج محاسبة التوصيل

---

# مرجع كامل لمنصة سبلاي إكس
# هذا الملف مخصص لcrawl AI ونماذج اللغة.
# آخر تحديث: 2026-08-23

## نظرة عامة

سبلاي إكس منصة متكاملة لإدارة العمليات للشركات في مجالات التوزيع واللوجستيات والتوصيل. تدير دورة حياة الطلب الكاملة من اكتساب العملاء من خلال المبيعات الميدانية一直到تحضير المستودع وتوصيل السائق والتسوية المالية.

قيمة مقترحة: خلفية واحدة، أربعة تطبيقات، صفر فواصل بيانات. كل قسم يرى نفس البيانات في الوقت الحقيقي.

## البنية التقنية

### حزمة التقنية
- الواجهة الأمامية: React 19, TypeScript, Vite 6, Tailwind CSS v4
- صفحة الهبوط: Next.js 16, مستضافة على Vercel
- الخلفية: Supabase (PostgreSQL + Auth + Row Level Security + Edge Functions + Realtime)
- ERP اختياري: تكامل Odoo عبر Supabase Edge Functions (TypeScript/Deno)
- PWA: عمال خدمة للعمل بدون اتصال على تطبيقات المبيعات والسائق والموزع

### مخطط قاعدة البيانات
- ~77 جدول عبر المخططات العامة والخاصة
- ~193 سياسة أمان على مستوى الصف
- ~210 دالة SQL
- ملف مخطط موحد واحد: supabase/schema.sql
- مخطط KPI اختياري لتحليلات Odoo المتزامنة

## التطبيقات الأربعة بالتفصيل

### 1. لوحة التحكم الإدارية
الرابط: https://www.supplyx.space
المستخدمون: أصحاب الأعمال والمديرين وموظفو المكتب الخلفي
المنصة: ويب (سطح المكتب)

الوحدات:
- لوحة تحكم -- نظرة عامة في الوقت الحقيقي مع تبويبات: نظرة عامة، لوجستيات، مبيعات هاتفية، موافقات، مبيعات. تظهر الإيرادات والطلبات والعملاء والزيارات ومؤشرات أداء الأسطول والرسوم البيانية.
- العملاء (CRM) -- ملفات تعريف كاملة للعملاء مع بحث وفلاتر (الحالة، الشريحة، المندوب المعين)، سجل التاريخ (الزيارات، الطلبات، المكالمات، التذاكر). إنشاء/تعديل العملاء. فئات VIP وSMB.
- الطلبات -- إنشاء وتتبع وتعيين الطلبات. فلترة حسب الحالة والتواريخ ومندوب التوصيل. تفاصيل الطلب تظهر العناصر وتحولات الحالة والجدول الزمني.
- الزيارات -- تتبع زيارات المبيعات الميدانية مع تسجيل الوصول/المدة والمدة والموقع ونتائج الزيارة. عرض التدقيق للمشرفين.
- المكالمات -- تسجيل ومراجعة أنشطة المكالمات مع المدة والنتيجة والتسجيلات وتحليل المشاعر.
- خدمة العملاء (التذاكر) -- إدارة تذاكر الدعم مع الأولوية (عاجل/مرتفع/متوسط/منخفض) والstatus والفئات. محادثات متسلسلة. ملاحظات داخلية.
- اللوجستيات -- نظرة عامة (مؤشرات أداء الأسطول، عدد الشحنات، حالة السائق)، الشحنات (قائمة غير مسنداة مقابل مسنداة)، الخطط (لوحة عمل الموزع)، خرائط التتبع المباشر.
- المالية -- الإيرادات الشهرية والمصروفات وصافي الربح والحسابات المدينة وال.position النقدي والفوترة المتأخرة والتسويات المعلقة وسجل القيود وإدارة الفواتير.
- المستخدمون والتحكم في الوصول -- 8 أدوار محددة مسبقاً مع أذونات تفصيلية. دعوة المستخدمين وإدارة الأدوار وعرض النشاط.
- الإشعارات -- مركز إشعارات في الوقت الحقيقي مع مقروء/غير مقروء، تحديد كمقروء بالجملة.

### 2. تطبيق المبيعات (تطبيق ويب متحرك)
الرابط: https://www.sales.supplyx.space
المستخدمون: مندوبي المبيعات الميدانيون
المنصة: تطبيق ويب متحرك (قابل للتثبيت، يعمل بدون اتصال)

الوحدات:
- لوحة تحكم -- تحية حسب الوقت، إحصائيات اليوم، إجراءات سريعة، الزيارات الأخيرة، العملاء القريبون.
- العملاء -- قائمة عملاء قابلة للبحث/الفلترة مع إجراءات: اتصال، تسجيل مكالمة، واتساب، خريطة، تسجيل وصول.
- معالجة تسجيل الزيارة (3 خطوات): الوصول والمؤقت، تفاصيل الزيارة، الدليل المرئي.
- سجل الزيارات -- جميع الزيارات السابقة مع النتيجة والمدة وحالة السياج الجغرافي والدليل الصوري وتصدير CSV.
- تحسين المسارات -- تخطيط أقرب جار من الموقع الحالي.
- المكالمات -- تسجيل منظم للمكالمات مع ملف العميل والسبب والاستجابة والنتيجة والإجراء التالي.
- بدون اتصال -- يعمل بدون إشارة، تتبع GPS، فرض السياج الجغرافي، دليل بالكاميرا.

### 3. تطبيق السائق (تطبيق ويب متحرك)
الرابط: https://www.drivers.supplyx.space
المستخدمون: سائقو التوصيل
المنصة: تطبيق ويب متحرك (قابل للتثبيت، يعمل بدون اتصال)

الوحدات:
- لوحة تحكم -- إحصائيات اليوم، شريط التقدم، خطوات تدفق المناوبات، خريطة المسار المباشر، إجراءات سريعة.
- قائمة التوصيل -- قائمة شحنات محصورة بالمسار مع شارات الحالة.
- تفاصيل الشحنة -- معلومات كاملة مع إجراءات: بدء التوصيل، تأكيد الوصول، تأكيد التوصيل (إثبات التوصيل)، الإبلاغ عن الفشل.
- المسار -- بطاقات خطة مع جدول زمني توقف توقف توقف. تنقل إلى خرائط جوجل.
- تأكيد الحمولة -- التحقق من الاستلام من المستودع قبل المغادرة.
- التحصيل -- مركز تسوية نقدي مع صورة الإيصال والملاحظات.
- بدون اتصال -- عامل خدمة، مزامنة إجراءات مؤجلة، تخزين مؤقت IndexedDB.

### 4. تطبيق الموزع (تطبيق ويب متحرك/لوحي)
الرابط: https://www.inventory.supplyx.space
المستخدمون: موظفو المستودع والموزعون ومشرفو/مدير المستودع
المنصة: تطبيق ويب متحرك/لوحي (قابل للتثبيت، يعمل بدون اتصال)

الوحدات:
- لوحة تحكم -- إحصائيات الخطط، إجراءات سريعة، الخطط الأخيرة.
- قائمة الخطط -- خطط التوصيل مع الحالة. وضع الطباعة لأوراق A4.
- تفاصيل الخطة ومعالجة التحضير -- استلام الخطة، تأكيد كميات المنتجات، الإبلاغ عن النقص، إكمال التحضير.
- الماسح الضوئي -- أداة باركود شاشة كاملة مع الكاميرا والإدخال اليدوي.
- المخزون -- متصفح مخزون للقراءة فقط مع تفاصيل المنتجات.
- المرتجعات -- استلام شحنات مرتجعة، تأكيد الاستلام الكامل/الجزئي.

## دورة حياة الطلب

العميل > المبيعات (زيارة ميدانية / إنشاء طلب) > الموزع (إنشاء خطة، تعيين سائق، تحضير المستودع) > السائق (تأكيد الحمولة، تنفيذ المسار، إثبات التوصيل، تحصيل النقد) > الإدارة (تسوية، فوترة، تقارير)

### تدفق حالة اللوجستيات
PENDING_ASSIGN > ASSIGNED > CHECK_IN/PICKUP > OUT_FOR_DELIVERY/ARRIVED > DELIVERED/FINISHED/SETTLED > CANCELLED

## الأدوار والصلاحيات

| الدور | مستوى الوصول | الوصف |
|-------|-------------|-------|
| admin | النظام الكامل | وصول كامل لجميع الوحدات والإعدادات |
| manager | الإدارة | رؤية على مستوى الإدارة عبر الوحدات |
| supervisor | إشراف الفريق | وصول إشرافي لأداء الفريق |
| spv | متخصص | وصول إشرافي متخصص |
| dispatcher | عمليات التوزيع | تحضير المستودع، إنشاء الخطط، تعيين السائقين |
| driver | عمليات التوصيل | تنفيذ المسار، إثبات التوصيل، تحصيل النقد |
| sales_agent | مبيعات ميدانية | زيارات العملاء، الطلبات، تتبع العمل المحتمل |
| telesales | مبيعات هاتفية | مبيعات عبر المكالمات وإدارة العملاء |

## نموذج التسعير

تسعير مخصص بناءً على:
- عدد السائقين/المستخدمين
- عدد التطبيقات المطلوبة (الأربعة أو مختارة)
- تكامل Odoo (إضافة اختيارية)
- مستوى الدعم

التواصل: info@supplyx.space

## كلمات المفتاح المستهدفة (الإنجليزية)

منصة إدارة اللوجستيات, نظام إدارة التوصيل, إدارة أسطول التوصيل, تطبيق سائق التوصيل, نظام إدارة المبيعات الميدانية, إدارة المستودع, برنامج توزيع المنتجات, بديل اودو, نظام إثبات التوصيل, إدارة خطة التوصيل, تطبيق مندوب المبيعات, برنامج محاسبة التوصيل

## كلمات المفتاح المستهدفة (العربية)

منصة إدارة اللوجستيات, نظام إدارة التوصيل, إدارة أسطول التوصيل, تطبيق سائق التوصيل, نظام إدارة المبيعات الميدانية, إدارة المستودع, برنامج توزيع المنتجات, بديل اودو, نظام إثبات التوصيل, إدارة خطة التوصيل, تطبيق مندوب المبيعات, برنامج محاسبة التوصيل