https://github.com/dizzydroid/invman
An Inventory Management App: Efficiently manage inventory, process orders and refunds, and track performance with this sleek PyQt-based application.
https://github.com/dizzydroid/invman
inventory-management inventory-management-system invman pandas pyqt5 python
Last synced: 12 months ago
JSON representation
An Inventory Management App: Efficiently manage inventory, process orders and refunds, and track performance with this sleek PyQt-based application.
- Host: GitHub
- URL: https://github.com/dizzydroid/invman
- Owner: dizzydroid
- License: mit
- Created: 2024-07-10T13:27:10.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-13T22:29:49.000Z (over 1 year ago)
- Last Synced: 2025-06-27T14:05:37.240Z (12 months ago)
- Topics: inventory-management, inventory-management-system, invman, pandas, pyqt5, python
- Language: Python
- Homepage:
- Size: 723 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# InvMan - Inventory Manager 📦
InvMan is a comprehensive inventory management application built with PyQt5. It helps businesses manage their inventory, track performance, and process orders and refunds efficiently.
> [!NOTE]
> InvMan is *currently* tailored for mobile phone shops, but it can be easily adapted for other types of businesses.
## Features ✨
- Add, edit, and remove inventory items
- Track stock levels by item and model
- Process orders and refunds
- Apply discounts to orders
- Track performance over a specified date range
- Filter and search inventory by name, phone model, and category
- User-friendly interface with image support
## Installation ⚙️
### From Executable 💻
To run InvMan from the executable:
1. Download the latest version of `InvMan.rar` from the [releases page](https://github.com/dizzydroid/InvMan/releases).
2. Extract and run the executable `main.exe` located in the `dist` directory.
3. The `dist` folder will hold all the generated files in .xlsx format.
### From Source 🛠️
To install and run InvMan from source, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/dizzydroid/InvMan.git
cd InvMan
```
2. Create and activate a virtual environment (optional but recommended):
```bash
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
```
3. Install the required dependencies:
```bash
pip install -r requirements.txt
```
4. Run the application:
```bash
python main.py
```
## Dependencies 📚
If you are running from source, the following dependencies are required:
- Python (*obviously*)
- PyQt5
- pandas
- openpyxl
## Usage 📖
Upon launching the app, you will be presented with a search bar and filter options to easily manage your inventory. You can add new items, edit existing ones, process orders and refunds, and track performance over time.
### Adding a New Item ➕
1. Click the "Add Item" button.
2. Enter the item details, including name, category, image, and models.
3. Click "Add Item" to save.
### Processing an Order 🛒
1. Click on an item to open its options.
2. Click "Order" and fill in the order details.
3. Click "Order" to generate a receipt and update the inventory.
### Tracking Performance 📈
1. Click the "Track Performance" button.
2. Select the start and end dates.
3. Click "Track Performance" to view the net profit for the selected period.
## Found Bugs? 🐞
If you encounter any bugs, please report them by creating an issue on the [GitHub Issues](https://github.com/dizzydroid/InvMan/issues) page.
## Contributing 🤝
Contributions are welcome! Please fork the repository and create a pull request with your changes.
## License 📄
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgements 🙏
Thanks to the open-source community for providing the tools and libraries that made this project possible.