Wholtrix - Wholesale Management System

Wholtrix is a comprehensive wholesale management system built with Laravel 8 and modern web technologies. It provides a complete solution for managing wholesale operations, inventory, sales, and financial transactions. The system is designed to streamline operations, improve efficiency, and provide real-time insights into your wholesale business.

Features

Core Features

• User Management
  • Role-based access control
  • User authentication and authorization
• Inventory Management
  • Multi-warehouse support
  • Stock tracking and alerts
  • Product categorization
  • Inventory movement tracking
• Sales Management
  • Sales tracking and reporting
  • Customer management
  • Order processing
  • Invoice generation
• Financial Management
  • Supplier payments tracking
  • Retailer payments management
  • Financial reporting
• Reporting & Analytics
  • Customizable reports
  • Sales analytics
  • Inventory reports
  • Profit-loss report
• Delivery Management
  • Delivery van tracking
  • Delivery personnel management
  • Delivery status tracking
• Supplier Management
  • Supplier database
  • Supplier payment tracking
  • Supplier accounts

Requirements

- PHP >= 8.1 - MySQL >= 5.7 - Composer

Instructions

Installation Guide

This guide will help you install and set up the Inventory Management System.

System Requirements

• PHP >= 8.1
• MySQL >= 5.7
• Composer
• Node.js & NPM
• Web Server (Apache/Nginx)
• SSL Certificate (for production)

Installation Steps

1. Server Setup

Apache Configuration

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /path/to/your/project/public

    <Directory /path/to/your/project/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx Configuration

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/your/project/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

2. Application Setup

1. Download the repository
2. Unzip the repository
3. Install PHP dependencies:

composer install --no-dev --optimize-autoloader

1. Environment Configuration:

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

1. Configure your database in .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

1. Run migrations and seeders:

php artisan migrate
php artisan db:seed

1. Create storage link:

php artisan storage:link

1. Set proper permissions:

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Post-Installation

1. Access the application at <a href="http://yourdomain.com">http://yourdomain.com</a>
2. Login with default credentials:
   • Email: admin@scm.test
   • Password: password
3. Change the default password immediately
4. Configure your application settings

Troubleshooting

Common Issues

1. Permission Denied
   • Check storage and cache directory permissions
   • Ensure web server user has proper access
2. Database Connection Error
   • Verify database credentials
   • Check database server is running
   • Ensure database exists
3. 500 Server Error
   • Check Laravel logs in storage/logs
   • Verify PHP version compatibility
   • Check file permissions

Support

If you encounter any issues during installation, please:

1. Contact support at support@tech2view.com