This is a Django-based Inventory Management System built with Django Rest Framework (DRF). The project allows users to manage inventory items, track changes in inventory levels, and manage categories. Additionally, it provides JWT authentication and API views for accessing and interacting with inventory data.

• User Registration & Authentication
  • Custom user model with profile picture.
  • JWT-based authentication for secured endpoints.
• Inventory Management
  • View and manage inventory items, categories, and associated details.
  • Add/edit inventory items, including price and quantity.
  • Upload images for inventory items.
• Change Logs
  • Track changes in inventory, such as price and quantity updates.
  • Automatically log changes with reasons and user details.
• Low Stock Alerts
  • Set thresholds for items and get a view of items below a certain quantity.
• API Documentation
  • Swagger and ReDoc for interactive API documentation.

• Installation
• API Endpoints
• Usage
• Models
• Features
• Technologies Used
• License

• Python 3.9
• Django 5.x
• Virtual Environment (recommended)
• PostgreSQL (optional) or SQLite (default)

1. Clone the Repository:

   git clone https://github.com/your-username/inventory-manager.git
   cd inventory-manager
   

2. Create and Activate a Virtual Environment:

   python -m venv env
   source env/bin/activate  # For Linux/Mac
   .\env\Scripts\activate  # For Windows
   

3. Install Dependencies:

   pip install -r requirements.txt

4. Apply Migrations:

   python manage.py makemigrations
   python manage.py migrate

5. Create Superuser:

   python manage.py createsuperuser
   

6. Run Development Server:

   python manage.py runserver
   
   

• Admin Panel: Visit Admin Panel

• Swagger UI: Visit Swagger UI
• ReDoc: Visit ReDoc

• Admin users can create categories and assign inventory items.
• Each item has a name, price, quantity, and associated category.

• Automatic change logs are maintained for every edit to inventory quantity or price.
• Admins can also add reasons for any change.

• Set low stock thresholds for items.
• View all items that have stock levels below the threshold.

• Custom user model with additional fields like profile picture.

• Categories to organize inventory items.

• Represents each inventory item, with fields for quantity, price, and image.

• Logs changes to inventory such as price or quantity adjustments.

• Backend: Django, Django Rest Framework
• Authentication: JWT Authentication (Simple JWT)
• API Documentation: Swagger UI, ReDoc
• Image Handling: Pillow, ImageKit
• Database: SQLite (default) / PostgreSQL (optional)

This project is licensed under the MIT License