RetailerOrderPlatform 🛒

RetailerOrderPlatform is a streamlined B2B digital solution designed to simplify the procurement process between retailers and wholesalers. The platform enables retailers to browse product catalogs, manage digital carts, and place bulk orders efficiently, reducing manual paperwork and improving supply chain transparency.

---

🛠️ Tech Stack

• Backend: Python with Flask Framework (RESTful API design)
• Database: MongoDB (for flexible product indexing and order history)
• Authentication: JWT (JSON Web Tokens) for secure session management
• Environment: python-dotenv for managing database credentials and API secrets
• Frontend Integration: Ready for React or Vue.js via JSON-based API responses

---

✨ Key Features

• Digital Catalog: Browse products with real-time stock availability and pricing.
• Order Management: Place, track, and view history of bulk orders.
• Retailer Profiles: Secure account management for store owners.
• Cart System: Add items to a persistent cart for review before final checkout.
• Admin Dashboard: Tools for wholesalers to update inventory and manage order statuses.

---

🚀 Getting Started

1. Prerequisites

• Python 3.10+
• MongoDB instance (local or Atlas)

2. Installation

Clone the repository:

git clone https://github.com/Sundaraj0828/RetailerOrderPlatform.git
cd RetailerOrderPlatform

3. Configuration

Create a .env file in the root folder:

MONGO_URI=mongodb://localhost:27017/retailer_platform_db
SECRET_KEY=your_secure_auth_key
FLASK_APP=app.py
FLASK_DEBUG=1

4. Setup Dependencies

pip install -r requirements.txt

5. Run the Server

flask run

The platform will be accessible at http://127.0.0.1:5000/.

---

📁 Project Structure

├── app/
│   ├── routes/          # API endpoints for orders and products
│   ├── models/          # MongoDB document structures
│   ├── services/        # Business logic for order processing
│   └── utils/           # Database connection and helpers
├── .env                 # Environment variables
├── app.py               # Main Flask application entry
├── requirements.txt     # List of dependencies
└── README.md            # Documentation

---

🔗 API Overview

Method	Endpoint	Description
GET	/api/products	Retrieve all available inventory
POST	/api/orders	Submit a new bulk order
GET	/api/orders/history	View past orders for the logged-in retailer
PUT	/api/inventory/update	Update stock levels (Admin only)

---

📄 License

This project is licensed under the MIT License.

---

Developed with ❤️ by [Sundaraj0828]