CorporateManagement

This project is a web application developed in Laravel that allows you to manage the inventory of a store.

With it, you can register products, suppliers, customers, and control stock in and out.

Screenshots

More Screenshots here: https://github.com/ThaysonScript/CorporateManagement/tree/main/screenshots

Install and Run the Project

Running the Inventory Manager on your local machine is an extremely simple task.

Global Dependencies

You need to have three main dependencies installed:

• PHP 8.x
• Web server, usually (Apache - Nginx)
• Relational database, usually (Mysql - PostgreSql)

Installing a Quick Environment

The listed services download and install the above dependencies:

• xampp
• laragon (individually download PHP 8.x and configure it in the application)

Local Dependencies

So, after cloning the repository git clone, don't forget to install the project's local dependencies:

composer install

Configure your database

Create a .env file at the root of the project, copying the content from the .env.example file

• Configure the connection to your preferred database

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=InventoryManager-Laravel
DB_USERNAME=configure-your-own-username
DB_PASSWORD=configure-your-own-password

Secure Environment Configuration

• The application uses sensitive information, such as the application's encryption key and the database connection information.

• You can configure these variables in the .env file by creating your own database, user, and password.

• To generate the encryption key, run the command:

php artisan key:generate

Do you want to configure a custom host?

• You can configure a custom host for your environment: create a new .conf file in server/conf/example.conf

<VirtualHost *:80>
    ServerName yourhost.local
    DocumentRoot /path/to/directory
    <Directory /path/to/directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

• ServerName = 'host name';

• DocumentRoot = 'root project directory - configure to point to the public folder of Laravel';

• Directory /path/to/directory = 'point to the public folder of your Laravel app';

• If you are on Linux, enable the custom host with sudo a2ensite myhost.conf

• If you are on Windows, enable the custom host in the httpd.conf file with Include "C:/path/to/yourhost.conf"

• Optionally, add the host to your machine so that it is recognized by the defined name 127.0.0.1 yourhost.local

• Windows: C:\Windows\System32\drivers\etc\hosts

• Linux: /etc/hosts

Start the application in development mode with

• Start your local server and database and type in the project's root: php artisan serve

• or, if a host is configured, enter the URL of your host on the server, for example, yourHost.com

• and migrate your fake data to analyze the initial application with php artisan migrate php artisan db:seed

• your test login will be

• email: usuario@usuario.com

• password: 123456

Technologies Used in the Application

• Laravel as the PHP framework;
• Bootstrap 5 for the interface design;
• MySQL as the relational database.

System Requirements

• PHP 8.1 or higher;
• Laravel 10x;
• Apache or Nginx web server;
• MySQL 8.0 or higher.

Contributing

Contributions are welcome!

To contribute to this project, follow these steps:

• Create a fork of the repository.

• Create a branch with your changes git checkout -b my-new-feature

• Commit your changes git commit -am 'Add some feature'

• Push to your branch git push origin my-new-feature

• Create a new Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for more details.