A powerful Django web application to efficiently manage inventory, sales, billing, vendors, customers, and transactions.
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.
- Role-based admin login to protect sensitive data.
- Password hashing and session management to ensure secure access.
- Add, edit, or delete products with details like SKU, price, quantity, and description.
- Real-time stock level monitoring and alerts for low inventory.
- Maintain detailed profiles with contact info, transaction history, and notes.
- Easy lookup and management for smooth vendor/customer relationships.
- Create sales orders dynamically with instant validation using Ajax.
- Support for multiple payment methods and transaction records.
- Automatically generate professional, printable invoices upon sale completion.
- Export invoices as PDFs or print directly.
- Visualize key metrics including sales trends, inventory status, and user activity.
- Interactive charts and summaries to support business decisions.
- Built with Bootstrap 5 for seamless use across devices and screen sizes.
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.
git clone https://github.com/shawnazd/Sales-and-Inventory-Management-System.git
cd Sales-and-Inventory-Management-SystemDocker 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.
If you prefer running locally without containers, follow these instructions:
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 serverpython -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- Access the application by visiting http://127.0.0.1:8000 in your web browser.
Once the app is running:
- Log in using your admin credentials.
- Navigate the Dashboard to get an overview of sales, inventory, and activities.
- Manage your Inventory: add new products, update quantities, or remove items.
- Keep your Vendor and Customer profiles up-to-date.
- Process Sales by selecting products, customers, and payment details.
- Generate and print Invoices automatically upon completing a sale.
- Export reports for accounting or audit purposes.
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
I welcome feedback, contributions, and collaboration! Feel free to open issues or pull requests.
This project is open source under the MIT License. You are free to use, modify, and distribute it with attribution.
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! π¨βπ»β¨