rahul24tech/vendor_management

Vendor Management System

This is a Vendor Management System developed using Django and Django REST Framework. The system handles vendor profiles, tracks purchase orders, and calculates vendor performance metrics.

Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/vendor-management-system.git
cd vendor-management-system

2. Create and Activate Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows, use "venv\Scripts\activate"

3. Install Dependencies

pip install -r requirements.txt

4. Run Migrations

python manage.py makemigrations
python manage.py migrate

5. Create Superuser (Optional)

python manage.py createsuperuser

6. Run Development Server

python manage.py runserver

The server will be running at http://127.0.0.1:8000/.

API Endpoints

Vendor Profile Management

Create a new vendor: POST /api/vendors/
List all vendors: GET /api/vendors/
Retrieve a specific vendor's details: GET /api/vendors/{vendor_id}/
Update a vendor's details: PUT /api/vendors/{vendor_id}/
Delete a vendor: DELETE /api/vendors/{vendor_id}/

Purchase Order Tracking

Create a purchase order: POST /api/purchase_orders/
List all purchase orders: GET /api/purchase_orders/
Retrieve details of a specific purchase order: GET /api/purchase_orders/{po_id}/
Update a purchase order: PUT /api/purchase_orders/{po_id}/
Delete a purchase order: DELETE /api/purchase_orders/{po_id}/

Vendor Performance Evaluation

Retrieve a vendor's performance metrics: GET /api/vendors/{vendor_id}/performance

Acknowledge Purchase Order

Acknowledge a purchase order: POST /api/purchase_orders/{po_id}/acknowledge

Superuser Access

To access the Django admin panel for data management:

Visit http://127.0.0.1:8000/admin/
Log in with the superuser credentials created during the setup.

To run the test suite follow below cmd

python manage.py test vendor_app.tests