📦 Warehouse Tracking System

🔹 Overview

Warehouse Tracking System is a Django-based warehouse & logistics management platform designed for companies with multiple subsidiaries.
It helps track inventory, stock transfers, drivers, and accounting with detailed reporting and secure authentication using JWT.

---

🚀 Features

• ✅ Company & Product Management
• ✅ Inventory Tracking per Storage & Company
• ✅ Stock Transfers
  • Intra-company transfers
  • Inter-company transfers
• ✅ Driver & Transport Cost Management
• ✅ Consumption Tracking (recording product usage)
• ✅ Reporting with Filters (by date, company, product, etc.)
• ✅ JWT Authentication
• ✅ Django Admin Panel

---

🛠️ Tech Stack

• Backend: Django 5 + Django REST Framework
• Database: MySQL / SQLite (development)
• Auth: JWT (SimpleJWT)
• Frontend: HTML + JS (Vanilla, fetch API)
• Deployment Ready: Gunicorn + Nginx (Linux)

---

📂 Project Structure

WarehouseTracking/
│── warehousetracking/         # Main Django app
    │── manage.py

│── ManagementApp/            # Web App
    │──templates/         # HTML pages

│── requirements.txt

---

⚡ Installation & Setup

1. Clone Repository

git clone https://github.com/YourUsername/WarehouseTracking.git
cd WarehouseTracking

2. Create Virtual Environment & Install Dependencies

python -m venv .venv
source .venv/bin/activate   # Linux / Mac
.venv\Scripts\activate      # Windows
pip install -r requirements.txt

3. Setup Environment Variables
   Create a .env file in project root:

SECRET_KEY=your_secret_key
DEBUG=True
DATABASE_URL=sqlite:///db.sqlite3

4. Run Migrations

python manage.py migrate

5. Create Superuser

python manage.py createsuperuser

6. Run Server

python manage.py runserver

---

🔑 API Endpoints (Sample)

Method	Endpoint	Description
POST	/api/auth/token/	Obtain JWT token
POST	/api/auth/token/refresh/	Refresh token
GET	/inventories/	List inventories
POST	/intra-transfers/	Create stock transfer (intra company)
POST	/inter-transfers/	Create inter-company transfer
GET	/api/services/	List non-product services

---

📊 Example Usage (Frontend Integration)

const res = await fetch("/api/stock-transfers/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${sessionStorage.getItem("access")}`
  },
  body: JSON.stringify({
    company_id: 1,
    from_storage_id: 2,
    to_storage_id: 3,
    items: [{ product: 5, quantity: 10 }]
  })
});

---

👨‍💻 Author

Arta Danesh
📧 [email protected]
💻 CE Student @ IUST, Tehran
🔭 Interested in Python, Django, Data Science & C++

---

📜 License

This project is licensed under the MIT License. Feel free to use and modify.