From ea19d571a39b87469ca5298b4bc87e0e95f30eff Mon Sep 17 00:00:00 2001 From: Philip V Date: Sun, 18 Aug 2024 15:56:42 -0700 Subject: [PATCH] ReadmeUpdate --- README.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 70 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f59ea7..6ac14a1 100644 --- a/README.md +++ b/README.md @@ -1 +1,70 @@ -This is the intial readme +# PQ Inventory System + +## Overview + +The `pq_inventory_system` is designed to manage and track inventory for businesses. It provides a comprehensive solution for inventory management, including features such as stock tracking, order management, and reporting. The system aims to streamline inventory processes, reduce errors, and improve overall efficiency. + +## Features + +- **Stock Management**: Track inventory levels, manage stock entries and exits. +- **Order Management**: Handle customer orders, supplier orders, and order fulfillment. +- **Reporting**: Generate reports on inventory status, sales, and other key metrics. +- **User Management**: Manage user roles and permissions within the system. + +## Running Version 3 of the Web Dashboard + +### Prerequisites + +Before running the web dashboard, ensure you have the following installed: + +- Node.js (v14.x or later) +- npm (v6.x or later) +- MongoDB (v4.x or later) + +### Installation + +1. **Clone the Repository** + + ```bash + git clone https://github.com/yourusername/pq_inventory_system.git + cd pq_inventory_system + ``` +2. **Install Dependencies** + +Navigate to the web_dashboard_v3 directory and install the necessary dependencies: + + ```cd web_dashboard_v3 + npm install + ``` + +3. **Set Up Environment Variables** + +Create a .env file in the web_dashboard_v3 directory and add the necessary environment variables. For example: + + ```MONGO_URI=mongodb://localhost:27017/pq_inventory + PORT=3000 + ``` + + + +### Running the Web Dashboard + +Ensure MongoDB is running on your machine. You can start it using the following command + +```mongod``` + +1. **Start the Web Dashboard** + +In the web_dashboard_v3 directory, start the web dashboard: + +```npm start``` + +### Access the Dashboard + +Open your web browser and navigate to http://localhost:3000 to access the web dashboard. + +### Contributing +We welcome contributions to the pq_inventory_system. If you would like to contribute, please fork the repository and submit a pull request. + +### License +This project is licensed under the MIT License. See the LICENSE file for details. \ No newline at end of file