Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rayan2162/paint_shop
Paint shop management app provides features to manage invoices, inventory, dues, and orders, along with user authentication and authorization.
https://github.com/rayan2162/paint_shop
laravel-10 laravelui-bootstrap4 shop-management-system
Last synced: about 1 month ago
JSON representation
Paint shop management app provides features to manage invoices, inventory, dues, and orders, along with user authentication and authorization.
- Host: GitHub
- URL: https://github.com/rayan2162/paint_shop
- Owner: rayan2162
- Created: 2024-11-14T16:27:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-11-15T04:09:55.000Z (about 1 month ago)
- Last Synced: 2024-11-15T05:19:31.007Z (about 1 month ago)
- Topics: laravel-10, laravelui-bootstrap4, shop-management-system
- Language: PHP
- Homepage:
- Size: 221 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Paint Shop Management System
This is a Paint Shop Management System built with Laravel 10, Bootstrap 4, and Laravel/UI v4.x. It provides features to manage invoices, inventory, dues, and orders, along with user authentication and authorization for a simple yet effective paint shop workflow.
## Features
1. **Invoice Management**: Allows users to generate and print invoices with customer details and itemized products.
2. **Inventory Management**: Enables users to add, view, edit, and delete inventory items.
3. **Due Management**: Helps in tracking dues, adding, updating, and deleting due records.
4. **Order Management**: Facilitates the management of orders, with options to update the order status.
## Prerequisites
- PHP >= 8.1
- Laravel 10
- Composer
- Node.js & npm
- MySQL or another supported database
- Laravel/UI
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/rayan2162/paint_shop.git
cd paint-shop
```
2. **Install Dependencies**
```bash
composer install
npm install
npm run dev
```
3. **Set Up Environment**
Copy `.env.example` to `.env` and update the database credentials and other configurations:
```bash
cp .env.example .env
php artisan key:generate
```
4. **Database Migration**
Run the migrations to create necessary tables:
```bash
php artisan migrate
```
5. **Run the Server**
```bash
php artisan serve
```
Your application should now be running at `http://127.0.0.1:8000`.
6. **Run the server** (Another method)
Use this [laravel_server_start_srcipt](https://github.com/rayan2162/laravel_server_start_srcipt) for automatically starting the server and open the project in your browser
## Usage
### Authentication
- Users can register or log in.
- Authenticated users will have access to the main features (Invoice, Inventory, Due, and Orders).
### Managing Invoices
- Create a new invoice with customer details and an itemized list of purchased products.
- The total, paid, and due amounts are calculated automatically.
### Inventory Management
- Add new products with details such as product name, company name, quantity, buy price, sell price, and description.
- Edit or delete products as necessary.
### Due Management
- Record dues by adding customer information, due amount, and other details.
- Edit or delete existing due records.
### Order Management
- Add orders by specifying product name, company, quantity, and status.
- Update order status to track pending, shipped, or completed orders.
## Dependencies
- **Laravel**: PHP web framework
- **Bootstrap 4**: Front-end styling
- **Laravel/UI v4.x**: For authentication scaffolding
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.