Description

petHUB is a pet shop manager designed to facilitate sales and vaccine management for a pet shop.

Features

• Customer management
• Animal management
• Vaccine management
• Sales management
• Product management
• Supplier management
• Employee management with access levels
• Generation of reports and sales orders
• Animal record with all registered vaccines

Dependencies

• Apache Maven
• JDK 17
• json-20160810
• mysql-connector
• jBCrypt
• JasperReports® Library

External Packages

• ViaCEP - Library for querying Brazilian ZIP codes using the ViaCEP API (https://viacep.com.br/)

Screenshots

Login	Dashboard

Customer Registration	Pet Registration

Employee Registration	Supplier Registration

Product Registration	Stock Control

Service Schedule	Service Registration

Vaccine Control	Sales Screen

Total Sales	Sales History

Logins

Administrator (Full Access)

• Username: admin@admin.com
• Password: 123

Salesperson

• Access: Customer, Animal, Product, and Service Registration, Service Schedule, Open POS
• Username: vendedor@vendedor.com
• Password: 123

Veterinarian

• Access: Customer, Animal, Product, and Service Registration, Service Schedule, Generate Animal Record, Vaccine Registration
• Username: veterinario@veterinario.com
• Password: 123

Documentation

All Javadoc documentation can be accessed via this link: petHUB Documentation

Installation

Before you start, ensure you have Java 17/22 and Apache Maven installed on your computer. If not, download and install them from the official websites.

1. Database Configuration

   • Open the config.properties file inside the resources folder.
   • Edit the file with your database information.

2. Database Import

   • Import the database available in the project root (petHUB.sql) into your MySQL server.

3. Running the Project

   • In the project's root directory, execute the following Maven commands to clean and package the project:

     mvn clean package

   • The above command will generate a petHUB-1.0-SNAPSHOT.jar file in the target folder.

4. Starting the Application

   • Execute the generated petHUB-1.0-SNAPSHOT.jar file, which will include all necessary dependencies:

     java -jar target/petHUB-1.0-SNAPSHOT.jar