https://github.com/ccrisc/rent_items_management
Web app to streamline rental management, allowing easy oversight of items and customers. Manage multiple orders per customer by specifying rental end dates, providing real-time order status updates.
https://github.com/ccrisc/rent_items_management
collaborate php rental-management web-application
Last synced: 5 months ago
JSON representation
Web app to streamline rental management, allowing easy oversight of items and customers. Manage multiple orders per customer by specifying rental end dates, providing real-time order status updates.
- Host: GitHub
- URL: https://github.com/ccrisc/rent_items_management
- Owner: ccrisc
- License: gpl-3.0
- Created: 2024-07-22T22:32:28.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-07-29T07:55:50.000Z (11 months ago)
- Last Synced: 2024-11-13T04:30:55.259Z (7 months ago)
- Topics: collaborate, php, rental-management, web-application
- Language: PHP
- Homepage:
- Size: 425 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Rent Management Interface
Table of Contents
## 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
### Built With
## Getting Started
To get a local copy up and running follow be ture to have the following steps checked.
### Prerequisites
* Install Homebrew
* Install PHP
```sh
brew install php
```
* Configure PHP
```sh
php --ini
```
### Installation
1. Clone the repo
```sh
git clone https://github.com/ccrisc/rent_items_management.git
```
2. Enter your DB credentials in `config.php`
```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)
```sh
php -S localhost:8000
```
5. Visit http://localhost:8000
## 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.
## 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](https://github.com/ccrisc/rent_items_management/issues/new/choose).
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`
## License
Distributed under the GNU GENERAL PUBLIC License. See `LICENSE.txt` for more information.