A Vendor Management System(VMS) apis for efficient vendor profile management, purchase order tracking, and vendor performance metrics calculation.

• Core Features
• Project Plan
• Installation
• API Endpoints
• Testing
• Contributing
• License

1. Vendor Profile Management:

   • Create, retrieve, update, and delete vendor profiles.
   • Track vendor information including name, contact details, address, and a unique vendor code.

2. Purchase Order Tracking:

   • Create, retrieve, update, and delete purchase orders.
   • Track purchase order details such as PO number, vendor reference, order date, items, quantity, and status.

3. Vendor Performance Evaluation:

   • Calculate vendor performance metrics, including on-time delivery rate, quality rating average, average response time, and fulfillment rate.
   • Retrieve performance metrics for a specific vendor.

To access the project plan, please visit the following URL: Vendor Hub API

1. Clone the repository:

   git clone https://github.com/bhaveshdev09/vendor-hub-api.git backend
   cd backend

2. Create a virtual environment and install dependencies:

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
   pip install -r requirements.txt

3. Apply database migrations:

   python manage.py migrate

4. Run the development server:

   python manage.py runserver

5. Set the environment variables

   Please refer .env.example for must have variables

6. Access the application at http://localhost:8000.

Below is a summary of the available API endpoints:

Vendor Profile Management

Purchase Order Tracking

Vendor Performance Evaluation

Additional Docs

Run the tests using the following command:

python manage.py test

To check coverage report of the entire codebases try this command:

coverage run manage.py test

# to get the coverage report on command line
coverage report -m

# To get the html report of code coverage try this
coverage html

Inputs and contributions to this project are appreciated. To make them as transparent and easy as possible, please follow this steps:

• How to contribute:

  1. Fork the repository and create your branch from master with different name.
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request

  Don't:

  • Don't include any license information when submitting your code as this repository is MIT licensed, and so your submissions are understood to be under the same MIT License as well.

• How to report a bug:

  1. Open a new Issue.
  2. Write a bug report with details, background, and when possible sample code. That's it!

This project is licensed under the MIT License.