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

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: [email protected]
• Password: 123

Salesperson

• Access: Customer, Animal, Product, and Service Registration, Service Schedule, Open POS
• Username: [email protected]
• Password: 123

Veterinarian

• Access: Customer, Animal, Product, and Service Registration, Service Schedule, Generate Animal Record, Vaccine Registration
• Username: [email protected]
• 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

   • Rename the config.properties.example file inside the resources folder to config.properties.
   • Edit the file with your database information.

2. Database Migration

   • Execute the FlywayMigration inside the br.com.pethub.jdbc package to migrate the database.

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