Inventory Management & Cart API Using Flask

🛒 Inventory Management & Cart API Using Flask — Full REST API Project

📌 Author: Arooj Amina
📁 GitHub Repo: Inventory-Management-API
🧠 Tech Stack: Python, Flask, Flask-RESTful, SQLAlchemy, Marshmallow

🚀 Project Overview

This project is a full-featured REST API for Inventory & Cart Management, built with Flask. It's ideal for managing products, stock, and a simple e-commerce cart system, all exposed via clean and organized API endpoints.

Whether you're managing a small warehouse or building a foundation for an e-commerce system, this API covers the essential features.

🔧 Features

📦 Inventory Management API

✅ Add, update, and delete products and categories
📊 Track stock quantity per product
🔁 Handle stock changes like:
- Restocking
- Selling
- Returning items
📉 Endpoints to warn when stock is low
📆 Date-based filtering for analytics (e.g., view items sold in last 7 days)

🛍️ E-Commerce Cart API

🛒 Add or remove items from a user’s cart

💰 Checkout system that:

Calculates the total
Deducts inventory
Clears the cart

📂 Project Structure

Inventory-Management-API/
│
├── app/
│   ├── __init__.py
│   ├── models/              # SQLAlchemy models
│   ├── schemas/             # Marshmallow schemas
│   ├── api/
│   │   ├── inventory/       # Product, category, stock APIs
│   │   └── cart/            # Cart APIs
├── config.py
├── requirements.txt
├── run.py                   # Main entry point

🚀 How to Run This Project Locally

🔹 1. Clone the repository

git clone https://github.com/AroojAmina/Inventory-Management-API.git
cd Inventory-Management-API

🔹 2. Create & activate virtual environment

python -m venv env
source env/bin/activate   # On Windows: env\Scripts\activate

🔹 3. Install dependencies

pip install -r requirements.txt

🔹 4. Set environment variables (optional)

If required, configure config.py or use .env file.

🔹 5. Run the Flask app

python run.py

API will be available at http://localhost:5000/

🧪 Sample API Endpoints

🛠️ Product Management

Method	Endpoint	Description
GET	`/api/products/`	List all products
POST	`/api/products/`	Create new product
GET	`/api/products/<id>`	Get single product
PUT	`/api/products/<id>`	Update product
DELETE	`/api/products/<id>`	Delete product

🔁 Stock Movement

Endpoint	Description
`/api/stock/restock`	Add stock to product
`/api/stock/sell`	Sell product
`/api/stock/return`	Return product to stock
`/api/stock/low-stock`	Get low-stock warnings

🛒 Cart System

Method	Endpoint	Description
POST	`/api/cart/add`	Add product to cart
POST	`/api/cart/remove`	Remove product from cart
GET	`/api/cart/view`	View cart contents
POST	`/api/cart/checkout`	Checkout and finalize

📊 What Makes This Project Stand Out?

🔄 Stock Movement Logic: Sell/return flows affect stock intelligently.
📉 Low Stock Alerts: Helps keep stock levels in check.
⏱️ Date Filtering: Track performance with time-based filters.
🧱 Modular Code Structure: Easy to scale or convert to production.

🔚 Conclusion

This project is a great foundation for anyone building an inventory system, POS backend, or basic e-commerce cart using Flask. It uses best practices like:

Class-based views (Flask-RESTful)
Schema validation (Marshmallow)
Clean separation of logic and routing

🔗 Resources

🔗 GitHub Repo: AroojAmina/Inventory-Management-API
💬 Questions? Contact me on GitHub or LinkedIn.

📌 Note: This API is currently not deployed, but you can easily deploy it to platforms like Render, Railway, or Fly.io using free tiers.

TECH PIXEL

Inventory Management & Cart API Using Flask — Full REST API Project