FlowOMS

A multi-tenant Order Management System for Magento 2 stores, built with Laravel 12 and Filament 4.

Repository: https://github.com/florinel-chis/flow-oms

Real-time OMS dashboard with KPIs, order widgets, and SLA monitoring

• Laravel 12 - PHP framework
• Filament 4 - Admin panel framework
• Vite - Frontend build tool
• SQLite/MySQL - Database
• Pest PHP - Testing framework
• Playwright - E2E testing

git clone https://github.com/florinel-chis/flow-oms.git
cd flow-oms

# Install dependencies
composer install
npm install

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

# Generate Filament assets
php artisan filament:assets

# Setup database
php artisan migrate --seed

# Create admin user
php artisan filament:user

After installation, start the application:

# Start development server with queue worker and logs
composer dev

# Or use artisan serve only
php artisan serve

Visit http://127.0.0.1:8000/admin to access the Filament admin panel.

# Initial sync - pull last 30 days
php artisan magento:sync-orders --truncate --backfill --sync

# Incremental sync
php artisan magento:sync-orders --sync

# Test single order
php artisan magento:sync-order 12345

# Unit/Feature tests
composer test
# Or
./vendor/bin/pest

# E2E tests
npm run test:e2e

# Watch E2E tests
npm run test:e2e:watch

• Multi-tenant architecture - Single database with tenant_id scoping
• Magento 2 integration - Real-time order sync via REST API
• Two-phase sync - Raw data storage + normalized transformation
• Automated scheduler - 30min/daily/weekly sync jobs
• Queue processing - Background job handling
• Filament admin - Modern, reactive admin interface
• Real-time logs - Built-in log tailer
• REST API - Sanctum-authenticated API with tenant scoping
• E2E Testing - Comprehensive Playwright test suite

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Comprehensive documentation is available in the documentation/ folder:

• Getting Started - Documentation index
• Architecture - System architecture and patterns
• Configuration - Environment and configuration
• Magento Integration - Connecting to Magento 2
• API Authentication - Sanctum token authentication
• Dashboard - Dashboard widgets and features
• Order Management - Order lifecycle and workflows
• SLA Monitoring - Service level tracking
• Notifications - Email notifications
• API Overview - REST API reference
• Orders API - Orders endpoints
• Invoices API - Invoices endpoints
• Webhooks - Webhook integration

• Issues: GitHub Issues
• Documentation: See the documentation/ folder

FlowOMS is open-sourced software licensed under the MIT license.

• Laravel - The PHP Framework
• Filament - Admin Panel Framework
• Tailwind CSS - Utility-first CSS framework
• Playwright - E2E testing framework

Made with ❤️ by Florinel Chis