README

ERP Integration Hub

Enterprise Integration Platform for ERP Systems

📖 Full Documentation →　　📖 التوثيق بالعربية →

Overview

ERP Integration Hub is a Laravel package that connects your application to multiple ERP systems through a visual no-code interface — no manual API calls, no custom glue code.

ERP Integration Hub
├── Dynamics 365 Business Central  ✓
├── Dynamics 365 Finance            ✓
├── Supply Chain Management         ✓
├── SAP S/4HANA                     ✓
├── Odoo                            ✓
├── ERPNext                         ✓
└── Custom REST / API               ✓

Features

• Visual Field Mapping — drag-and-drop builder with 9 built-in transformers and auto-map
• 6 Sync Modes — manual, scheduled, real-time, incremental, full, event-driven
• Sync Scheduler — cron expressions, per-timezone, without overlapping
• Real-Time Monitoring — live dashboard with queue health and success rates
• Retry Management — per-record, per-profile, or bulk retry of failed jobs
• Role-Based Security — 10 granular permissions, 3 default roles
• REST API — full API layer with Sanctum authentication
• Vue 3 SPA — dark/light mode, Arabic RTL + English i18n
• High Performance — lazy collections + chunked processing, 1M–100M records

Requirements

Installation

composer require mostafax/erp-integration-hub

Run the installer (publishes config, migrations, assets, and seeds default roles):

php artisan erp-integration-hub:install

Start the sync worker:

php artisan queue:work --queue=dynamics-sync

Open the dashboard:

https://your-app.com/erp-integration-hub

Configuration

Publish the config file:

php artisan vendor:publish --tag=erp-integration-hub-config

Key settings in config/erp-integration-hub.php:

'drivers' => [
    'business_central' => [...],
    'dynamics_finance' => [...],
    'supply_chain'     => [...],
    'sap'              => [...],
    'odoo'             => [...],
    'erpnext'          => [...],
    'custom'           => [...],
],

'queue' => [
    'connection' => env('QUEUE_CONNECTION', 'redis'),
    'name'       => 'dynamics-sync',
    'workers'    => env('ERP_SYNC_WORKERS', 3),
],

REST API

All endpoints are prefixed with /api/erp-integration-hub and require Sanctum authentication.

Full API reference in the documentation.

Artisan Commands

# Install the package (first-time setup)
php artisan erp-integration-hub:install

# Run a sync profile manually
php artisan erp-integration-hub:sync {profileId}

# Process due scheduled syncs
php artisan erp-integration-hub:schedule-run

Security & Permissions

The package ships with spatie/laravel-permission integration and 3 default roles:

Architecture

src/
├── Actions/           # Single-responsibility business actions
├── Authentication/    # Microsoft OAuth client + token manager
├── Connections/
│   ├── Drivers/       # ERP-specific drivers (OData, JSON-RPC, REST)
│   └── ErpConnectionManager.php
├── Console/Commands/  # Artisan commands
├── Contracts/         # Interfaces
├── DTOs/              # Data Transfer Objects
├── Events/            # Sync lifecycle events
├── Exceptions/
├── Facades/           # ErpIntegrationHub facade
├── FieldMapping/      # Mapping engine + 9 transformers
├── Http/              # Controllers, Requests, Resources
├── Jobs/              # Queue jobs
├── Models/            # Eloquent models
├── Monitoring/        # Dashboard stats service
├── Notifications/     # Mail / Slack / database
├── Providers/         # Service provider
├── Repositories/
├── Scheduler/
├── Security/          # Policy + permission manager
└── Services/          # Sync orchestrator

Documentation

License

MIT — © Mostafa Elbayyar