Welcome to the Packing and Dispatch Monitoring System! This project is designed to streamline the process of packing and dispatching items in a warehouse setting by utilizing a responsive React.js web application. The application offers real-time barcode scanning, data entry, and a user-friendly interface for managing and monitoring the packing process.
- Features
- Tech Stack
- Installation
- Usage
- Project Structure
- Environment Variables
- Contributing
- License
- Contact
- Real-time Barcode Scanning: Seamless integration with barcode readers for efficient data entry.
- Redundancy Tracking: Automatically detects and alerts on duplicate entries to prevent errors.
- Station-wise Analytics: Track performance metrics for each station, helping to identify high and low performers.
- Data Export: Easily export collected data as CSV files for further analysis.
- Responsive Design: A user-friendly interface that adapts to various screen sizes.
- Customizable Order Types: Dropdown selection for order types such as Customer (C) or Store (S).
- Frontend: React.js
- Backend: Node.js, Express.js
- Database: MySQL
- Analytics: Grafana
- Containerization: Docker
- Version Control: Git, GitHub
- Node.js (>= 14.x)
- MySQL database
- Docker (optional, for containerization)
- Git for version control
-
Clone the repository:
git clone https://github.com/S-A-I-V/Packing_DispatchReactAPp.git cd Packing_DispatchReactAPp
-
Install the dependencies:
npm install
-
Set up the database:
- Create a MySQL database.
- Configure the environment variables in the
.env
file (see Environment Variables).
-
Start the application:
- For development:
npm start
- Using Docker:
docker-compose up
- For development:
-
Data Entry Mode:
- Use the barcode scanner to scan items.
- The system will automatically log the data and associate it with the correct station.
-
Redundancy Alert:
- If a duplicate entry is scanned, a pop-up will alert with the message: "You are scanning a duplicate entry, hand over to shipping incharge."
-
Analytics Mode:
- Navigate to the analytics section to view station-wise performance metrics.
- CSV Export: Export the current data set as a CSV file for further analysis.
Packing_DispatchReactAPp/ ├── public/ ├── src/ │ ├── components/ │ ├── pages/ │ ├── services/ │ ├── App.js │ ├── index.js ├── .env ├── package.json ├── Dockerfile ├── docker-compose.yml └── README.md
Create a .env
file in the root directory and configure the following variables:
REACT_APP_API_URL=http://localhost:5000/api DB_HOST=localhost DB_USER=root DB_PASSWORD=your_password DB_NAME=packing_dispatch
We welcome contributions! If you'd like to contribute, please fork the repository and submit a pull request.
Steps to Contribute: Fork the repository. Create a new branch (git checkout -b feature-branch). Make your changes. Commit your changes (git commit -m 'Add some feature'). Push to the branch (git push origin feature-branch). Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
For any questions or suggestions, please feel free to reach out:
GitHub: S-A-I-V Email: [email protected] Thank you for using the Packing and Dispatch Monitoring System! We hope it makes your workflow more efficient and error-free.