Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/danzigerrr/inventory-management-system-using-django

This Django-based web application helps small businesses manage inventory, process sales, and generate reports.
https://github.com/danzigerrr/inventory-management-system-using-django

django inventory-management-system mit-license open-source python reporting sales-management-system user-authentication web-application

Last synced: about 2 months ago
JSON representation

This Django-based web application helps small businesses manage inventory, process sales, and generate reports.

Host: GitHub
URL: https://github.com/danzigerrr/inventory-management-system-using-django
Owner: Danzigerrr
License: mit
Created: 2024-07-29T17:06:49.000Z (6 months ago)
Default Branch: master
Last Pushed: 2024-08-01T20:54:17.000Z (6 months ago)
Last Synced: 2024-08-01T23:07:54.893Z (6 months ago)
Topics: django, inventory-management-system, mit-license, open-source, python, reporting, sales-management-system, user-authentication, web-application
Language: Python
Homepage: https://danzigerrrinventorymanager.pythonanywhere.com/
Size: 1.03 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Inventory and Sales Management System

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
![Build Status](https://github.com/Danzigerrr/Inventory-Management-System-using-Django/actions/workflows/djangoCI.yml/badge.svg)
![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
![Django Version](https://img.shields.io/badge/django-3.2%2B-green)

This is a Django-based web application designed to manage the inventory and sales for a small business that sells handmade crafts and art supplies. The application provides functionalities to track inventory levels, process sales, and generate reports.

**The application is live here: [Demo link](https://danzigerrrinventorymanager.pythonanywhere.com/).** The project is hosted on [PythonAnywhere](https://help.pythonanywhere.com/pages/DeployExistingDjangoProject/) ❤️🐍

## Features

- **Inventory Management**: Track stock levels, receive new inventory, and update inventory levels as items are sold.
- **Sales Processing**: Process sales in both the physical store and the online store, and automatically update inventory levels accordingly.
- **Reporting**: Generate reports on sales, inventory levels, and customer data, such as popular products and customer purchase histories.
- **User-Friendly Interface**: Easy-to-use interface for the business owner and employees.
- **Security**: Password-protected access and regular data backups.
- **Scalability**: Designed to accommodate future business growth.

## Installation

1. **Clone the Repository**
```bash
git clone https://github.com/Danzigerrr/Inventory-Management-System-using-Django.git
cd inventory_management
```

2. **Create and Activate a Virtual Environment**
```bash
python -m venv venv
source source .venv/Scripts/activate

```

3. **Install Dependencies**
```bash
pip install -r requirements.txt
```

4. **Run Migrations**
```bash
python manage.py migrate
```

5. **Insert sample data into database**
```bash
python manage.py populate_db
```

6. **Create a Superuser**
```bash
python manage.py createsuperuser
```

7. **Run the Development Server**
```bash
python manage.py runserver
```

8. **Access the Application**
- Open your browser and go to `http://127.0.0.1:8000/`

## Usage

### Admin Interface

- Visit `http://127.0.0.1:8000/admin/` to access the Django admin interface.
- Log in with the superuser credentials.
- Manage products, inventory transactions, sales, and customer data through the admin interface.

The admin can also log in to the system and manage the inventory, sales, and customer data through the provided interface.

### Main Application for Users

- **Searching products**: Navigate to `/inventory/search/` to search for products by name.

- **Purchase Products**: Selected a product to buy it and specify the quantity.

- **Check Purchased Products**: Navigate to `/users/profile/` to view profile details and purchasing history.

## Testing
To run the tests use the following command:
```bash
python manage.py test
```

## Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

## License

This project is licensed under the [MIT licensed](LICENSE).

## Stay in touch
**Author - Krzysztof Nazar**:
- [Linkedin](https://www.linkedin.com/in/krzysztofnazar/)
- [GitHub](https://github.com/Danzigerrr)