The project "Pet Store Management Application – Four Little Paws" aims to develop a software application that facilitates the management of pets, orders, customers, and products in pet stores.

The system helps employees and managers track store operations more efficiently, accurately, and conveniently than traditional manual methods. It is designed using Object-Oriented Programming (OOP) principles with a user-friendly interface and clearly defined functionalities.

• Optimize store operations and workflows.
• Save time and minimize human errors.
• Improve customer service quality amid increasing demand for pet care services.

• Login and password recovery.

• Edit personal account information.

• Create orders:

  • View inventory.
  • Add products to orders.
  • Edit order details.
  • Confirm order completion.
  • Export PDF invoices.
  • Cancel orders.

• View invoice history.

• Logout.

• Login.
• Account management: search, add, view details.
• Customer management: search, add, view details.
• Pet & product management: search, add, view details.
• Promotion management: search, add, view details.
• View statistics: number of orders, daily/monthly/yearly revenue.
• Logout.

src/
 └── main/
     ├── java/com/store/app/petstore/
     │   ├── Controllers/
     │   │   ├── Admin/              # Controllers for admin dashboard UI actions
     │   │   └── Staff/              # Controllers for staff dashboard UI actions
     │   ├── DAO/                    # Data Access Objects to handle database operations
     │   │   └── StatisticDAO/       # Specialized DAO classes for statistical data
     │   ├── Models/                 # Data models and related logic
     │   │   ├── Entities/           # Database entity classes mapped to tables (e.g., User, Product)
     │   │   ├── Records/            # Java record types for lightweight data handling
     │   │   └── Seeder/             # Classes used to seed sample/demo data into the database
     │   ├── Sessions/               # Manages user sessions and login status
     │   └── Utils/                  # Utility/helper classes
     │       └── Mappers/           # Classes that map SQL result sets to Java models
     └── resources/
         ├── Font/                   # Custom fonts used in the application (e.g., Inter)
         ├── FXML/                   # FXML files defining UI layout for JavaFX
         │   ├── Admin/              # FXML files for admin dashboard (e.g., user management, reports)
         │   ├── Staff/              # FXML files for staff dashboard (e.g., order management)
         │   └── Statistics/         # FXML files for statistics and charts UI
         ├── Images/                 # Image assets used in the app
         │   ├── Pet/                # Images of pets
         │   ├── Product/            # Images of products
         │   ├── Staff/              # Profile images of staff members
         │   └── User/               # Profile images of customers/users
         └── Styles/                 # CSS stylesheets for customizing JavaFX UI appearance
             ├── Admin/              # Stylesheets specific to the admin dashboard
             └── Staff/              # Stylesheets specific to the staff dashboard

Figure 1. Login interface

Figure 2. Change password screen

Figure 3. Pet management section interface

Figure 4. Pet detail view

Figure 5. Order screen after selecting products

Figure 6. PDF invoice displayed after clicking "OK"

Figure 7. Invoice detail view

Figure 8. Personal information view

Figure 9. Statistical dashboard for managers

Figure 10. Pet management screen

Figure 11. Detailed view of a specific pet

Figure 12. Add new promotion interface

Figure 13. Invoice management interface

Before you begin, make sure the following tools are installed on your machine:

1. Java Development Kit (JDK)

• Version: 21 or higher
• Download: https://jdk.java.net/

2. Apache Maven

• Build tool used to manage dependencies and build the project
• Download: https://maven.apache.org/download.cgi

3. Database Setup

• You can use either:

  • MySQL (recommended for ease of integration)
  • Oracle (optional)

• Create a database named (e.g., petstore_db) and update connection credentials in the environment file.

4. Environment Configuration

• Create a .env file in the root directory to store database connection details.
• The project uses dotenv-java to load environment variables.

Example .env file:

DB_URL=jdbc:mysql://localhost:3306/petstore_db
DB_USERNAME=root
DB_PASSWORD=your_password

git clone <repository_url>
cd PBL3-Petstore

Replace <repository_url> with the actual URL of the GitHub repository.

Make sure you're inside the root project directory (PBL3-Petstore), then run:

mvn clean package

This will compile the code and resolve all dependencies.

You can launch the application using the following Maven command:

mvn clean javafx:run

Make sure your system supports JavaFX runtime or set it up via --module-path if needed.

This project uses the following key libraries and dependencies: