Product Authentication and Supply Chain Management Web Application

The Product Authentication and Supply Chain Management web application is a web-based solution for manufacturer companies to enable manufacturers to provide end-level consumers with the means to verify the authenticity of their products and manage the entire supply chain process. This system ensures transparency, traceability, and reliability throughout the product's journey from manufacturing to sale.

Key Features

Product Authentication: Each product is equipped with two QR codes – one for consumers to verify authenticity and another for sellers to mark the product as sold. By scanning the QR code and visiting the official company website found by scanning QR code, consumers can see basic product information such as product status(manufactured, supplied, distributed, sold), product batch, manufacturing date, expiring date, warranty information etc. Detailed information(seller or product's current holder's information, location, and sold date etc.) are revealed only after the product is marked as sold by the seller after the customer's confirmation to buy in case the product is authentic.
Automatic Warranty Issuance: When a seller marks a product as sold, the system automatically issues the product's warranty, if applicable.
Supply Chain Management: The system allows manufacturers to efficiently manage their supply chain by facilitating interactions between manufacturers, distributors, distributor agents, and sellers. It offers features such as trader registration, product assignment, and real-time tracking of products at every stage of the supply chain.
User Roles: The actual supply chain is a complex thing. Here assuming the manufacturers are the supplier who supply products to the distributors.
- Admin: Administrators have access to an intuitive admin panel where they can manage distributors, generate new products and batches, generate QR codes, monitor product information, see and manage all traders associated with the company's supply chain and view supply chain statistics.
- Distributor: Distributors have a dedicated panel to manage their operations. They can add distributor agents, assign products to agents, track products, and oversee their affiliated products.
- Distributor Agent: Distributor agents have a panel to manage their operations, including adding sellers, assigning products to sellers, and tracking their affiliated products.
- Seller: Sellers can log in to view their assigned products, mark products as sold, and access their sales statistics on a dashboard. After adding a user role the user gets a confirmation mail with a link to complete the account by providing a new account password.

MVC Design Pattern

This project follows the Model-View-Controller (MVC) design pattern for its architecture:

Model: Represents the application's data and business logic. It interacts with the database and provides data to the other components.
View: Handles the presentation layer, rendering data to the user interface and receiving user input.
Controller: Manages the flow of data between the model and the view. It handles user input, processes requests, and updates the model and views accordingly.

Technologies Used

Java EE
JSP (Java Server Pages)
JavaScript and jQuery
HTML and CSS
MySQL
Maven
Apache Tomcat-9
IntelliJ IDEA Ultimate as IDE

Installation and Deployment

Fork and Clone the repository to your local machine.
Import the supplychain.sql file provided in this repository into your MySQL database to create the required schemas.
Open the project in IntelliJ IDEA or your preferred Java development environment.
Configure the database connection parameters in the dbConfig.properties under the resources folder.
Configure the mail settings with the app password in mailConfig.properties under the resources folder to send confirmation mail using Google SMTP Server. Generate your Gmail app password to use the Google SMTP server to send mail. Click here to see how to generate an app password.
Build the project using Maven to resolve dependencies and deploy the application on Tomcat-9 or your preferred servlet container.
Open the admin panel by visiting http://localhost:8080/my_web_app_war_exploded/AdminPanel, use email: admin@supplier password: password@admin for the first time during initialization and later change the password.