EasyERP — Car Dealership Management System

EasyERP is a production-grade, simplified ERP solution built from scratch for car dealerships operating in the UAE market. Inspired by industry leaders like EasyCars, it streamlines every operational aspect of a dealership — from stock acquisition to final sale and reporting — while remaining intuitive enough for non-technical users.

Core Modules

• Inventory Management — Complete vehicle lifecycle tracking with auto-generated stock numbers, multi-image galleries with drag-to-reorder, document uploads, expense tracking, inspection checklists, and insurance/registration expiry alerts. Duplicate VIN detection prevents data entry errors.

• Unified Document Architecture — A single, elegant data model powers Sales Invoices, Purchase Invoices, Quotations, and Credit Notes. Each document supports multiple line items (vehicles + manual fees like transport, registration, commission), with automatic VAT calculation, multi-currency purchases (AED, USD, EUR, JPY), and one-click Quotation → Invoice conversion.

• Contact Management (CRM Lite) — Unified contacts table for customers, suppliers, and consignors, with tags, follow-up reminders, transaction history, and one-click WhatsApp integration.

• Sales Flow — Draft → Confirm → Paid workflow. On confirmation, vehicles auto-transition to "Sold", trade-in vehicles are added back to stock, and profit is calculated. Supports partial/installment payments with live balance tracking.

• Financial Reports — 8 report types (Inventory, Sales, Profit, Expenses, VAT Summary, Salesperson Performance, Aging Stock, Outstanding Payments) with CSV export and date filtering.

• Role-Based Access Control (RBAC) — Fully dynamic system: 57 granular permissions across 14 groups, 4 default system roles (Admin, Manager, Sales Agent, Accountant), plus the ability to create custom roles. Every API route and every UI element (sidebar links, action buttons) is protected by permission checks.

• Bilingual Support — Full English + Arabic UI with RTL layout. Bilingual PDF invoices/quotations/purchase orders generated via DomPDF.

• Global Search — Cmd/Ctrl+K instant search across vehicles, contacts, and documents, with debounced API calls and grouped results.

• Bulk CSV Import — 4-step wizard (download template → upload → validate → execute) for migrating existing data.

• Public Dealership Website — Built-in SEO-friendly public inventory page with vehicle search, detail pages, live finance calculator, and WhatsApp click-to-chat.

• Operational Tools — Test drive scheduling, consignment contracts with auto-commission calculation, expense tracking, activity audit logs, soft deletes with restore/purge, and QR codes per vehicle.

Technical Highlights

• Built on a unified documents + document_items schema, making quotations, invoices, purchases, and credit notes share the same codepath — eliminating duplication and making future additions trivial.

• API-first Laravel 13 backend with 119 versioned endpoints (/api/v1/), all UUID primary keys, soft deletes on every major entity, and Sanctum SPA authentication.

• Next.js 16 SPA with App Router, Server Components where applicable, TanStack Query for server state, Zustand for UI state, and a custom design system with sharp corners, Inter font, and strict monochrome palette.

• Dockerized multi-stage builds — standalone Next.js output and optimized Laravel production image. Shares a reverse-proxy infrastructure (Nginx + Let's Encrypt) with other projects on the same server.

• Fully type-safe with 57 permission strings validated across frontend and backend.

Production Deployment
Live at easyerp.suhaibzia.com with API at api.easyerp.suhaibzia.com. CI/CD-ready with one-command deploy script, SSL via shared Certbot container, and MySQL/Redis on shared infrastructure network.