README.md

Rent Management Interface

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License

About The Project

This web app is designed to streamline the management of rental items. It enables efficient handling of both items and customers. You can manage multiple orders for each customer by specifying the rental end date, which provides you with real-time updates on the order status.

Main functionalities:

• CRUD Operations
• Interactivity with AJAX
• Automatic form validation
• Search Query

(back to top)

Built With

(back to top)

Getting Started

To get a local copy up and running follow be ture to have the following steps checked.

Prerequisites

• Install Homebrew
• Install PHP

  brew install php

• Configure PHP

  php --ini

Installation

1. Clone the repo

   git clone https://github.com/ccrisc/rent_items_management.git

2. Enter your DB credentials in config.php

   define('DB_NAME', '*****');
   define('DB_USER', '*****');
   define('DB_PASSWORD', '*****');
   define('DB_HOST', '*****:3306');;

3. You can create schema and tables by executing the SQL from the demo_dump folder fo getting started
4. Run your local PHP server (if you are using PHPStorm you can set up your server following these instructions)

   php -S localhost:8000

5. Visit http://localhost:8000

(back to top)

Usage

Add new customer

You can add a new customer by clicking the orange button on the main page, the form allows to insert first name and last name

New Order

In a single order you can add multiple items and different quantities for each. At the bottom you have to specify the customer the return date and the order number.

Orders Management

In the order management table you have an overview of all your orders. In the table you see the column state that indicates if the order has been closed (green) or if it still active (orange). At the same time the column return date signal if the return date is past (red) or not yet arrived.

By clicking the DETAIL button you get the order overview. If the order is still active you can proceed to close it, if the customer return all the items or to close it partially.

When you proceed to close an order partially you will be asked to specify for each article the quantity that the user has returned. The difference will be calculated in the backend and added to the not returned items for that specific user.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you think you found a bug in this repo, you can submit an issue.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

For more details see See CONTRIBUTING.md

(back to top)

License

Distributed under the GNU GENERAL PUBLIC License. See LICENSE.txt for more information.

(back to top)