Skip to content

addin-alt/Sales-and-Inventory-Management-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›’ Sales and Inventory Management System

A powerful Django web application to efficiently manage inventory, sales, billing, vendors, customers, and transactions.


LicenseΒ Β Β Β  Python VersionΒ Β Β Β  Django Version


πŸ“ About

The Sales and Inventory Management System is a full-stack web application built with Django, designed specifically for small and medium-sized businesses. It helps streamline key business processes such as inventory tracking, vendor and customer management, sales processing, and invoice generation.

The system boasts a responsive design, ensuring accessibility on desktops, tablets, and mobile devices. It leverages modern technologies including Bootstrap 5 for sleek UI and Ajax for dynamic, real-time interactions β€” all secured behind robust authentication mechanisms.


βš™οΈ Features

1. Secure Authentication & Authorization

  • Role-based admin login to protect sensitive data.
  • Password hashing and session management to ensure secure access.

2. Inventory Management

  • Add, edit, or delete products with details like SKU, price, quantity, and description.
  • Real-time stock level monitoring and alerts for low inventory.

3. Vendor & Customer Management

  • Maintain detailed profiles with contact info, transaction history, and notes.
  • Easy lookup and management for smooth vendor/customer relationships.

4. Sales & Transaction Processing

  • Create sales orders dynamically with instant validation using Ajax.
  • Support for multiple payment methods and transaction records.

5. Invoice Generation

  • Automatically generate professional, printable invoices upon sale completion.
  • Export invoices as PDFs or print directly.

6. Comprehensive Admin Dashboard

  • Visualize key metrics including sales trends, inventory status, and user activity.
  • Interactive charts and summaries to support business decisions.

7. Responsive UI

  • Built with Bootstrap 5 for seamless use across devices and screen sizes.

πŸ“‹ Prerequisites

Before starting, ensure your development environment meets the following requirements:

  • Python 3.10+ β€” The main programming language used.
  • pip β€” Python package manager to install dependencies.
  • Git β€” To clone and manage the repository.
  • Docker (Optional) β€” For containerized and simplified deployment.

πŸš€ Installation Guide

Step 1: Clone the Repository

git clone https://github.com/shawnazd/Sales-and-Inventory-Management-System.git
cd Sales-and-Inventory-Management-System

Step 2: Choose your installation method


Using Docker (Recommended)

Docker simplifies the setup by packaging the app with all dependencies:

docker build -t inventory-system:1.0 .
docker run -d -p 8000:8000 inventory-system:1.0
  • After running, open your browser and go to http://localhost:8000
  • The app should be up and running inside the container.

Without Docker

If you prefer running locally without containers, follow these instructions:

Linux/macOS

python3 -m venv venv                # Create a virtual environment
source venv/bin/activate            # Activate the virtual environment
pip install -r requirements.txt    # Install required Python packages
python manage.py migrate            # Apply database migrations
python manage.py runserver          # Start the development server

Windows (PowerShell)

python -m venv venv                # Create a virtual environment
venv\Scripts\activate              # Activate the virtual environment
pip install -r requirements.txt   # Install required Python packages
python manage.py migrate           # Apply database migrations
python manage.py runserver         # Start the development server

πŸ”§ Usage Guide

Once the app is running:

  1. Log in using your admin credentials.
  2. Navigate the Dashboard to get an overview of sales, inventory, and activities.
  3. Manage your Inventory: add new products, update quantities, or remove items.
  4. Keep your Vendor and Customer profiles up-to-date.
  5. Process Sales by selecting products, customers, and payment details.
  6. Generate and print Invoices automatically upon completing a sale.
  7. Export reports for accounting or audit purposes.

πŸ“‚ Project Structure Overview

Sales-and-Inventory-Management-System/
β”‚
β”œβ”€β”€ InventoryMS/           # Main inventory management Django app
β”œβ”€β”€ accounts/              # User authentication and profile management
β”œβ”€β”€ bills/                 # Billing and invoice related functionality
β”œβ”€β”€ bin/                   # Possibly scripts or binaries for the project
β”œβ”€β”€ invoice/               # Invoice generation and handling
β”œβ”€β”€ static/                # Static files: CSS, JavaScript, images, etc.
β”œβ”€β”€ store/                 # Product catalog and store management
β”œβ”€β”€ transactions/          # Sales transactions and related logic
β”œβ”€β”€ .dockerignore          # Files to ignore in Docker builds
β”œβ”€β”€ .gitignore             # Files and folders ignored by Git
β”œβ”€β”€ Dockerfile             # Docker image build instructions
β”œβ”€β”€ manage.py              # Django management script
β”œβ”€β”€ requirements.txt       # Python dependencies list
└── run_project.bat        # Windows batch script to run the project
          

πŸ‘€ Author

Addin Al

I welcome feedback, contributions, and collaboration! Feel free to open issues or pull requests.


βš–οΈ License

This project is open source under the MIT License. You are free to use, modify, and distribute it with attribution.


⭐ Support

If this project helps you, please consider starring it on GitHub to show your support!


Thank you for checking out the Sales and Inventory Management System! Happy coding and best wishes for your business growth! πŸ‘¨β€πŸ’»βœ¨

About

A Sales and Inventory Management System built with Python and Django to help businesses track products, manage stock levels, and record sales efficiently. It features user authentication, real-time inventory updates, and sales reporting. Designed for easy management of daily business operations.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors