Skip to content

An individual degree final year project to implement an inventory management system.

Notifications You must be signed in to change notification settings

yuanjie8629/FYP-InvMgmtSys

Repository files navigation

Inventory Management System

All Contributors

Overview

Sharifah Food is a food processing company that specialises in the ready meals market. Over the years, Sharifah Food had to manually take orders from its customer through WhatsApp and record the sales data in Excel sheets. Nevertheless, it was discovered that it became difficult to keep track of all sales, orders, and inventory as the company grew. Therefore, this project aims to implement a web-based computerised inventory management system that helps the company streamline the inventory management process.

Multi-level Marketing System

Sharifah Food applies Multi-level Marketing (MLM) system to sell its products. The customers can apply as agents or dropshippers to promote and sell the company's products by purchasing the products at discounts. For instance, an agent and a dropshipper can receive 30 percent and 20 percent discounts, respectively, if they order a large quantity of products.

Demo πŸš€

NOTE: This project is only for demonstration purposes. Please do not enter any sensitive information on the website.

https://fyp-shrf.herokuapp.com/

*Might take some time to wake up the system due to inactivity

Login Credentials

Username: uattester
Password: Testing@123

Features

  1. Login
    The admin is able to log in to the inventory management system by entering their username and password.

  2. Profile Management
    The admins can manage their profiles and change their current password, phone number, email, gender, etc.

  3. Product Stock Management
    The admin can manage the product inventory, such as add new products, add new stocks to the products, modify the product information, remove the existing product, and check the products’ information.

  4. Promotional Packages Management
    The admin can manage the promotions by adding new promotional packages as well as modifying and deleting the existing promotional packages.

  5. Order Management
    The admin can view all orders from direct customers, agents and dropshippers. In addition, the admin can update the status of each order or even cancel the customers’ orders.

  6. Agent and Dropshipper Management
    The admin can view the lists of agents and dropshippers and their respective orders to confirm their sales performance. In addition, the admin can also view, accept and reject the applications of the agents and dropshippers.

  7. Shipping Fee Management
    The admin can add, edit, delete and view the shipping fee in different states. Besides, the admin can customize the shipping fee for different weight ranges. The shipping fees added will be applied to the total order amount when the customers place an order.

  8. Pickup Location Management
    The admin can add the pickup location for the placed orders. This allows the customers to choose whether to ship their orders to their addresses or pick up the order at the pickup location.

  9. Discount Management
    The admin can manage and create discount codes that can be applied while making payments on the e-commerce platform. The discount can be specified either as a percentage or a fixed amount and is customizable for various criteria such as minimum order spend, a maximum discount, customer eligibility, etc.

  10. Business Insights
    The admin can view the sales analysis to gain more insight into the company's business performance. Sales and inventory analyses are crucial for the business as they help cut unnecessary costs and predict the demand for products. There are many inventory analyses such as ABC analysis, HML analysis, SS analysis, EOQ analysis, etc. This system uses these analyses to provide the information for better inventory control on Sharifah Food.

  11. Invoice Generator
    The admin can generate an invoice for each order placed by a customer.

  12. Sales Report Generator
    The system can generate a sales reports in Excel format at the admin’s request.

  13. Email Notification
    Email notifications automatically alert the admin when new orders are placed,products are in low stock, or pending approvals for the registrations for agent and dropshipper.

Tech Stack

System Design

System Architecture


Use Case Diagram


Conceptual ERD


Logical ERD


Physical ERD


Prototype Design

https://tinyurl.com/FYPInvMgmtSysPrototype

Installation

Prerequisites

Installation Steps

  1. Install the frontend packages using yarn.
     yarn install
    
  2. Install the backend packages using pip from requirements.txt.
    pip install -r requirements.txt
    
  3. Create .env to configure environment variables as follows:
    ALLOWED_HOSTS=<any hosts seperated by ","> ('127.0.0.1,localhost')
    CORS_ORIGIN_WHITELIST=<any origin seperated by ","> ('http://localhost:3000,http://127.0.0.1:3000')
    CSRF_TRUSTED_ORIGINS=<any origin seperated by ",">
    CLOUDINARY_NAME=<your cloudinary name>
    CLOUDINARY_API_KEY=<your cloudinary api key>
    CLOUDINARY_API_SECRET=<your cloudinary api secret>
    DATABASE_NAME=<your database name>
    DATABASE_USER=<your database user>
    DATABASE_PASSWORD=<your database password>
    DATABASE_HOST=<your database host>
    DATABASE_PORT=<your database port>'
    DEBUG=True
    EMAIL_HOST_USER=<your email to send notification>
    EMAIL_HOST_PASSWORD=<your email SMTP password>
    REDIS_TLS_URL=<your Redis TLS url>
    REDIS_URL=<your Redis url>
    SECRET_KEY=<django app secret key>
    WKHTMLTOPDF_BINARY='wkhtmltopdf-pack'
    
  4. Migrate your database.
    python manage.py migrate
    
  5. Build the React App using yarn.
    yarn build
    
  6. Run the server.
    python manage.py runserver
    

Preview

  1. Login


  2. Dashboard


  3. Product Management


  4. Promotional Packages Management


  5. Order Management


  6. Customer Management


  7. Agent/Dropshipper Registration Management


  8. Shipping Fee Management


  9. Pickup Location Management


  10. Voucher Management


  11. Business Insights - Statistics


  12. Business Insights - Inventory Analysis


  13. Profile Management


  14. Account Settings


  15. Invoice Generated


  16. Notification


Documentation

Poster

https://tinyurl.com/YJFYPPOSTER

Report

https://tinyurl.com/YJFYP

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Tan Yuan Jie

️️️️♿️ πŸ’¬ πŸ› πŸ’» πŸ”£ 🎨 πŸ“– πŸ“‹ πŸ€” πŸš‡ 🚧 πŸ§‘β€πŸ« πŸ“¦ πŸ”Œ πŸ“† πŸ”¬ πŸ‘€ πŸ›‘οΈ πŸ“’ ⚠️ πŸ”§ πŸ““

This project follows the all-contributors specification. Contributions of any kind welcome!

About

An individual degree final year project to implement an inventory management system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages