EasyERP

Modular ERP System

Built with Laravel 12 · Filament 3 · Tailwind CSS

---

Overview

EasyERP is a modular Enterprise Resource Planning system designed for flexibility. Each business domain lives in its own module using nwidart/laravel-modules, making it easy to enable, disable, or extend functionality as needed.

Module Status

Module	Description	Status
HumanResource	Employee management, attendance, payroll	✅ Production-ready
Accounting	Financial accounting & reporting	🔧 In progress
Email	Email integration & management	🔧 In progress
Inventory	Stock & warehouse management	🔧 In progress
Marketing	Campaigns & lead tracking	🔧 In progress
Profile	User profile & settings	🔧 In progress
Purchasing	Purchase orders & vendor management	🔧 In progress
Recruitment	Applicant tracking & hiring	🔧 In progress
Web	Public-facing website	🔧 In progress

Roadmap

• Record Rules — Per-module access control & record-level permissions (not yet implemented)
• Stabilize remaining modules to production quality
• Comprehensive test coverage across all modules

Note: Only HumanResource is considered complete. Other modules are functional but still under active development. Expect breaking changes.

Tech Stack

Layer	Technology
Backend	PHP 8.3+, Laravel 12
Admin Panel	Filament 3
Frontend	Livewire, Alpine.js, Tailwind CSS
Build	Vite
Database	PostgreSQL 16+ (well-tested)
Queue	Database driver
Caching	Database / Redis

Requirements

• PHP >= 8.2 (with ext-openssl, ext-zip)
• Node.js >= 18
• Composer 2
• PostgreSQL 16+ (recommended, well-tested)

Getting Started

Clone & Install

git clone https://github.com/brainplusplus/easyerp.git
cd easyerp

# PHP dependencies
composer install

# Node dependencies
npm install

Environment Setup

cp .env.example .env
php artisan key:generate

Edit .env — configure your database credentials:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=easyerp
DB_USERNAME=postgres
DB_PASSWORD=secret

Migrate & Build

php artisan migrate
npm run build

Run

composer dev

This starts the dev server, queue worker, log tail, and Vite HMR concurrently.

Development

# Development server (all services)
composer dev

# Build production assets
npm run build

# Run tests
composer test

# Module management
php artisan module:make ModuleName      # Create new module
php artisan module:enable ModuleName    # Enable module
php artisan module:disable ModuleName   # Disable module
php artisan module:list                 # List all modules

Project Structure

easyerp/
├── app/                     # Core application (Models, Providers, etc.)
├── config/                  # Laravel configuration
├── database/                # Migrations, seeders, factories
├── Modules/                 # Business domain modules
│   ├── Accounting/
│   │   ├── app/             # Module models, Filament resources, services
│   │   ├── database/        # Module migrations & seeders
│   │   ├── resources/       # Module views & assets
│   │   └── routes/          # Module routes
│   ├── HumanResource/
│   ├── Inventory/
│   ├── Purchasing/
│   └── .../
├── public/                  # Web root
├── resources/               # Global views, CSS, JS
├── routes/                  # Global route definitions
└── tests/                   # Test suites

Each module follows the same internal structure and is self-contained with its own models, migrations, routes, and Filament resources.

License

Proprietary. All rights reserved.