# EXIM ERP

A comprehensive Enterprise Resource Planning (ERP) system built with Laravel 12+ for managing export-import operations.

## Tech Stack

- **Backend**: Laravel 12+, PHP 8.3+
- **Database**: MySQL 8.0+
- **Cache/Queue**: Redis 7.0+
- **Web Server**: Nginx
- **Process Manager**: Supervisor
- **OS**: Ubuntu 24.04/26.04

## Requirements

- PHP 8.3 or higher
- MySQL 8.0 or higher
- Redis 7.0 or higher
- Nginx
- Composer 2.0+
- Node.js 18+ (for frontend assets)

## Quick Start

```bash
# Clone the repository
git clone https://github.com/your-org/exim-erp.git
cd exim-erp

# Install dependencies
composer install

# Configure environment
cp .env.example .env
php artisan key:generate

# Setup database
php artisan migrate
php artisan db:seed

# Start development server
php artisan serve
```

Default login: `admin@exim-erp.com` / `password`

## Installation

See [INSTALLATION.md](INSTALLATION.md) for detailed installation instructions.

## Deployment

See the `deployment/` directory for production deployment configurations:

```bash
# Run the setup script
sudo bash deployment/scripts/setup.sh
```

## Documentation

- [Installation Guide](INSTALLATION.md)
- [API Documentation](API.md)
- [Architecture Overview](ARCHITECTURE.md)
- [Contributing Guidelines](CONTRIBUTING.md)

## Modules

- **Dashboard** - Overview and analytics
- **Orders** - Export/Import order management
- **Invoices** - Billing and invoice generation
- **Products** - Product catalog management
- **Customers** - Customer relationship management
- **Suppliers** - Supplier management
- **Shipping** - Logistics and shipping tracking
- **Documents** - Document management
- **Accounting** - Financial management
- **Reports** - Business intelligence reports
- **Settings** - System configuration

## License

Proprietary - All rights reserved.