Back to Aureuserp

README

README.md

1.3.112.5 KB
Original Source
<p align="center"> <a href="https://aureuserp.com"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/aureuserp/temp-media/master/aureus-logo-dark.png"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/aureuserp/temp-media/master/aureus-logo-light.png">
</picture>
</a> </p> <p align="center"> <a href="https://packagist.org/packages/aureuserp/aureuserp"></a> <a href="https://packagist.org/packages/aureuserp/aureuserp"></a> <a href="https://packagist.org/packages/aureuserp/aureuserp"></a> </p> <h1 align="center">Aureus ERP</h1> <p align="center"> <strong>Open-Source Enterprise Resource Planning for Modern Businesses</strong> </p> <p align="center"> Built with Laravel 11 • Powered by FilamentPHP 5 • PHP 8.3+ </p>

šŸ“‹ Table of Contents

  1. Introduction
  2. Key Features
  3. Why Choose Aureus ERP?
  4. Requirements
  5. Quick Start
  6. Plugin System
  7. Plugin Installation & Management
  8. Customization
  9. Contributing
  10. License
  11. Security
  12. Support & Community

šŸš€ Introduction

Aureus ERP is a comprehensive, open-source Enterprise Resource Planning (ERP) solution designed for Small and Medium Enterprises (SMEs) and large-scale organizations. Built on Laravel 11, the most popular PHP framework, and FilamentPHP 5, a cutting-edge admin panel framework, Aureus ERP offers an extensible and developer-friendly platform for managing every aspect of your business operations.

Whether you're managing accounting, inventory, HR, CRM, or projects, Aureus ERP provides a modular approach that grows with your business.


✨ Key Features

  • šŸ—ļø Modern Architecture: Built with Laravel 11 and FilamentPHP 5 for maximum performance and developer experience
  • 🧩 Modular Plugin System: Install only the features you need - from accounting to project management
  • šŸŽØ Beautiful UI/UX: Responsive design with TailwindCSS 4, optimized for desktop and mobile
  • šŸ” Advanced Security: Role-based access control with Filament Shield integration
  • šŸ“Š Business Intelligence: Built-in analytics and reporting tools
  • 🌐 Multi-Language Support: Easily translate and localize for global businesses
  • ⚔ High Performance: Optimized database queries and caching strategies
  • šŸ”§ Developer-Friendly: Clean code, comprehensive documentation, and extensive APIs
  • šŸ”„ Real-Time Updates: LiveWire 4 integration for dynamic interfaces

šŸŽÆ Why Choose Aureus ERP?

FeatureBenefit
Open SourceFree to use, modify, and extend. No vendor lock-in
Modern StackLatest Laravel & FilamentPHP for cutting-edge features
ScalableHandles everything from startups to enterprise operations
CustomizableExtend with your own plugins and modifications
Community-DrivenActive community support and continuous improvements
Production-ReadyBattle-tested with real-world business requirements

šŸ“¦ Requirements

Ensure your development environment meets the following requirements:

Server Requirements

  • PHP: 8.3 or higher
  • Database: MySQL 8.0+ or SQLite 3.8.3+
  • Web Server: Apache 2.4+ or Nginx 1.18+

Development Tools

  • Composer: Latest version (2.0+)
  • Node.js: 18.x or higher
  • NPM/Yarn: Latest stable version

Framework Versions

  • Laravel: 11.x
  • FilamentPHP: 5.x
  • Livewire: 4.x
  • TailwindCSS: 4.x

⚔ Quick Start

Get Aureus ERP up and running in just 4 simple steps:

Step 1: Clone the Repository

bash
git clone https://github.com/aureuserp/aureuserp.git
cd aureuserp

Step 2: Install Dependencies

bash
composer install

Step 3: Run the Installation

bash
php artisan erp:install

What happens during installation:

āœ… Database migrations are executed
āœ… Core seeders populate initial data
āœ… Roles & permissions are generated (via Filament Shield)
āœ… Admin account is created
āœ… Environment configuration is set up

Step 4: Start the Development Server

bash
php artisan serve

Visit http://localhost:8000 and log in with your admin credentials!


🧩 Plugin System

AureusERP features a powerful modular plugin system that allows you to customize your ERP installation based on your business needs. Choose only the modules you need to keep your system lean and efficient.

šŸ“¦ Core Plugins (System Plugins)

These plugins are essential components of the system and are installed by default:

ModuleDescription
AnalyticsBusiness intelligence and reporting tools
ChatterInternal communication and collaboration platform
FieldsCustomizable data structure management
SecurityRole-based access control and authentication
SupportHelp desk and documentation
Table ViewCustomizable data presentation framework

⚔ Installable Plugins

These plugins can be installed as needed to extend system functionality:

šŸ’¼ Financial Management

ModuleDescription
AccountingFinancial accounting and reporting
AccountsCore accounting operations
InvoicesInvoice generation and management
PaymentsPayment processing and tracking

šŸ“¦ Operations

ModuleDescription
InventoriesInventory and warehouse management
ProductsProduct catalog and management
PurchasesProcurement and purchase order management
SalesSales pipeline and opportunity management

šŸ‘„ Human Resources

ModuleDescription
EmployeesEmployee management
RecruitmentsApplicant tracking and hiring
TimeoffsLeave management and tracking
TimesheetEmployee work hour tracking

šŸ¤ Customer & Partner Management

ModuleDescription
ContactsContact management for customers and vendors
PartnersPartner relationship management

šŸ“Š Project & Content Management

ModuleDescription
BlogsContent management and blogging
ProjectsProject planning and management
WebsiteCustomer-facing website module

šŸ”§ Plugin Installation & Management

Installing a Plugin

To install a plugin, use the following Artisan command:

bash
php artisan <plugin-name>:install

Example: Install the Inventories plugin

bash
php artisan inventories:install

During installation, the system automatically checks for dependencies. If dependencies are detected, you'll see:

This package products is already installed. What would you like to do? [Skip]:
  [0] Reseed
  [1] Skip
  [2] Show Seeders

Options:

  • Reseed: Reinstall the plugin's seed data (overwrites existing data)
  • Skip: Continue without modifying the already installed dependency
  • Show Seeders: Display available data seeders for the plugin

Uninstalling a Plugin

To remove a plugin from your system:

bash
php artisan <plugin-name>:uninstall

Example: Uninstall the Inventories plugin

bash
php artisan inventories:uninstall

āš ļø Warning: Uninstalling a plugin will remove its database tables and data. Make sure to backup your data before uninstalling.

Plugin Dependencies

Some plugins require other plugins to function properly. The installation system:

  • āœ… Automatically detects dependencies
  • āœ… Prompts you to install required plugins
  • āœ… Prevents conflicts and missing prerequisites
  • āœ… Validates the installation order

šŸŽØ Customization

AureusERP is designed to be highly customizable, allowing you to tailor the system to your specific business needs:

Plugin Customization

  • šŸ”¹ Install only the plugins you need
  • šŸ”¹ Extend existing plugins with custom functionality
  • šŸ”¹ Create custom plugins using the modular architecture

UI/UX Customization

  • šŸ”¹ Create custom dashboards and reports
  • šŸ”¹ Modify themes and branding
  • šŸ”¹ Design custom forms and views with Filament

Access Control

  • šŸ”¹ Define custom user roles and permissions
  • šŸ”¹ Configure role-based access control (RBAC)
  • šŸ”¹ Set granular permissions using Filament Shield

Business Logic

  • šŸ”¹ Extend models with custom business rules
  • šŸ”¹ Create custom workflows and automations
  • šŸ”¹ Integrate with third-party services via APIs

šŸ¤ Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

How to Contribute

  1. Fork the Repository

    bash
    git clone https://github.com/aureuserp/aureuserp.git
    
  2. Create a Feature Branch

    bash
    git checkout -b feature/your-feature-name
    
  3. Make Your Changes

    • Follow the existing code style and conventions
    • Write tests for new features
    • Update documentation as needed
  4. Commit Your Changes

    bash
    git commit -m "Add: Brief description of your changes"
    
  5. Push to Your Fork

    bash
    git push origin feature/your-feature-name
    
  6. Submit a Pull Request

    • Provide a clear description of the changes
    • Reference any related issues
    • Ensure all tests pass

Development Guidelines

  • Follow Laravel and Filament best practices
  • Maintain code quality with Laravel Pint: vendor/bin/pint
  • Write PHPUnit tests for new functionality
  • Use meaningful commit messages

šŸ“„ License

AureusERP is truly open-source ERP framework that will always be free under the MIT License.

What This Means

  • āœ… Free to use for commercial and personal projects
  • āœ… Modify and distribute as you wish
  • āœ… No licensing fees or restrictions
  • āœ… Community-driven development

šŸ”’ Security

Security is a top priority for AureusERP. We take all security vulnerabilities seriously.

Reporting Security Vulnerabilities

āš ļø Please DO NOT disclose security vulnerabilities publicly.

If you discover a security vulnerability in AureusERP, please report it responsibly:

šŸ“§ Email: [email protected]

What to Include

  • Description of the vulnerability
  • Steps to reproduce the issue
  • Potential impact assessment
  • Suggested fix (if available)

We will acknowledge your email within 48 hours and provide a detailed response within 7 days, including our assessment and a timeline for a fix.


šŸ’¬ Support & Community

Need help or want to connect with other AureusERP users?

šŸ“š Documentation

  • šŸ“– Developer Documentation: devdocs.aureuserp.com - Technical guides, API references, and development resources
  • šŸ“˜ User Guide: docs.aureuserp.com - Step-by-step tutorials and user manuals

šŸ¤ Get Support

  • šŸ’¬ Community Forum: [Coming Soon] - Connect with other users and share experiences
  • šŸ› Issue Tracker: GitHub Issues - Report bugs and request features
  • šŸ“§ Email Support: [email protected] - Direct support from the team

šŸ”” Stay Updated

  • ⭐ Star this repository to show your support
  • šŸ‘ļø Watch for new releases and updates
  • šŸ“ Fork to contribute to the project

<div align="center">

Made with ā¤ļø by Webkul

⬆ Back to Top

</div>