# burntbasic/petcaresys architecture

> Architecture diagram of the GitHub repository burntbasic/petcaresys, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/burntbasic/petcaresys
- Repository: https://github.com/burntbasic/petcaresys

## Overview

PetCareSys is a Java Swing/MySQL desktop system for pet owners, veterinarians, and administrators. The main flow starts at login or registration, resolves a user role to its dashboard, and routes role-specific pet, appointment, and medical-record work through controllers to DAOs and MySQL. Veterinarians record treatments that inform medical history; all roles also have documented report generation, and administrators can review activity. The excerpts establish controller-to-DAO calls and several view-to-controller links; broader report and dashboard interactions are documented or indexed, not fully sampled.

Main entry points: [`src/com/petcare/dao/DBConnection.java`](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/DBConnection.java) (Database connection), [`src/com/petcare/controller/PetOwnerController.java`](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/PetOwnerController.java) (Owner workflows), [`src/com/petcare/controller/VetController.java`](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/VetController.java) (Vet workflows), [`src/com/petcare/controller/AdminController.java`](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/AdminController.java) (Admin workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and roles"]
  node_app["Application entry<br/>[PetCareSys.java]"]
  node_login["Login screen<br/>[LoginFrame.java]"]
  node_loginlogic["Login logic"]
  node_registration["Registration<br/>[RegisterFrame.java]"]
  node_registerlogic["Registration logic"]
  node_factory["Role dashboard factory"]
end

subgraph group_workflows["Care workflows"]
  node_ownerui["Owner dashboard and panels"]
  node_vetui["Vet dashboard and panels"]
  node_adminui["Admin dashboard and panels"]
  node_ownerlogic["Owner workflows"]
  node_vetlogic["Vet workflows<br/>[VetController.java]"]
  node_adminlogic["Admin workflows"]
end

subgraph group_data["Data access"]
  node_users["User data access<br/>[UserDAO.java]"]
  node_pets["Pet data access<br/>[PetDAO.java]"]
  node_appointments["Appointment data access"]
  node_treatments["Treatment data access<br/>[TreatmentDAO.java]"]
  node_activity["Activity logging"]
  node_connection["Database connection<br/>[DBConnection.java]"]
  node_models["Domain models"]
end

subgraph group_reporting["Reporting and support"]
  node_reports["Report generation"]
  node_error["Error handling<br/>[ErrorHandler.java]"]
end

node_user(("User"))
node_mysql[("MySQL database")]

node_user -->|"signs in"| node_login
node_user -->|"registers"| node_registration
node_app -->|"launches"| node_login
node_login -->|"authenticates"| node_loginlogic
node_loginlogic -->|"checks credentials"| node_users
node_registration -->|"submits details"| node_registerlogic
node_registerlogic -->|"creates account"| node_users
node_login -->|"selects dashboard"| node_factory
node_factory -->|"creates by role"| node_ownerui
node_factory -->|"creates by role"| node_vetui
node_factory -->|"creates by role"| node_adminui
node_ownerui -->|"requests operations"| node_ownerlogic
node_vetui -->|"requests operations"| node_vetlogic
node_adminui -->|"requests operations"| node_adminlogic
node_ownerlogic -->|"manages pets"| node_pets
node_ownerlogic -->|"books appointments"| node_appointments
node_ownerlogic -->|"reads medical history"| node_treatments
node_ownerlogic -->|"records actions"| node_activity
node_vetlogic -->|"handles appointments"| node_appointments
node_vetlogic -->|"finds patients"| node_pets
node_vetlogic -->|"manages treatments"| node_treatments
node_vetlogic -->|"records actions"| node_activity
node_adminlogic -->|"manages users"| node_users
node_adminlogic -->|"manages pets"| node_pets
node_adminlogic -->|"manages appointments"| node_appointments
node_adminlogic -->|"records actions"| node_activity
node_users -->|"opens connection"| node_connection
node_pets -->|"opens connection"| node_connection
node_appointments -->|"opens connection"| node_connection
node_treatments -->|"opens connection"| node_connection
node_activity -->|"opens connection"| node_connection
node_connection -->|"connects to"| node_mysql
node_appointments -->|"maps appointments"| node_models
node_pets -->|"maps pets"| node_models
node_treatments -->|"maps treatments"| node_models
node_reports -->|"loads report data"| node_connection
node_ownerui -.->|"generates reports"| node_reports
node_vetui -.->|"generates reports"| node_reports
node_adminui -.->|"generates reports"| node_reports

click node_app "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/PetCareSys.java"
click node_login "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/view/LoginFrame.java"
click node_loginlogic "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/LoginController.java"
click node_registration "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/view/RegisterFrame.java"
click node_registerlogic "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/RegisterController.java"
click node_factory "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/factory/DashboardFactory.java"
click node_ownerui "https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/petOwnerFrames"
click node_vetui "https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/vetFrames"
click node_adminui "https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/adminFrames"
click node_ownerlogic "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/PetOwnerController.java"
click node_vetlogic "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/VetController.java"
click node_adminlogic "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/AdminController.java"
click node_users "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/UserDAO.java"
click node_pets "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/PetDAO.java"
click node_appointments "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/AppointmentDAO.java"
click node_treatments "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/TreatmentDAO.java"
click node_activity "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/ActivityLogDAO.java"
click node_connection "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/DBConnection.java"
click node_reports "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/util/ReportGenerator.java"
click node_error "https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/util/ErrorHandler.java"
click node_models "https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/model"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_login,node_loginlogic,node_registration,node_registerlogic,node_factory,node_user toneBlue
class node_ownerui,node_vetui,node_adminui,node_ownerlogic,node_vetlogic,node_adminlogic,node_mysql toneAmber
class node_users,node_pets,node_appointments,node_treatments,node_activity,node_connection,node_models toneMint
class node_reports,node_error toneRose
```

## Components

### Access and roles

- [Application entry](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/PetCareSys.java): `src/com/petcare/PetCareSys.java`
- [Login screen](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/view/LoginFrame.java): `src/com/petcare/view/LoginFrame.java`
- [Login logic](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/LoginController.java): `src/com/petcare/controller/LoginController.java`
- [Registration](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/view/RegisterFrame.java): `src/com/petcare/view/RegisterFrame.java`
- [Registration logic](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/RegisterController.java): `src/com/petcare/controller/RegisterController.java`
- [Role dashboard factory](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/factory/DashboardFactory.java): `src/com/petcare/factory/DashboardFactory.java`

### Care workflows

- [Owner dashboard and panels](https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/petOwnerFrames): `src/com/petcare/view/petOwnerFrames`
- [Vet dashboard and panels](https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/vetFrames): `src/com/petcare/view/vetFrames`
- [Admin dashboard and panels](https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/view/adminFrames): `src/com/petcare/view/adminFrames`
- [Owner workflows](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/PetOwnerController.java): `src/com/petcare/controller/PetOwnerController.java`
- [Vet workflows](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/VetController.java): `src/com/petcare/controller/VetController.java`
- [Admin workflows](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/controller/AdminController.java): `src/com/petcare/controller/AdminController.java`

### Data access

- [User data access](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/UserDAO.java): `src/com/petcare/dao/UserDAO.java`
- [Pet data access](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/PetDAO.java): `src/com/petcare/dao/PetDAO.java`
- [Appointment data access](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/AppointmentDAO.java): `src/com/petcare/dao/AppointmentDAO.java`
- [Treatment data access](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/TreatmentDAO.java): `src/com/petcare/dao/TreatmentDAO.java`
- [Activity logging](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/ActivityLogDAO.java): `src/com/petcare/dao/ActivityLogDAO.java`
- [Database connection](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/dao/DBConnection.java): `src/com/petcare/dao/DBConnection.java`
- [Domain models](https://github.com/burntbasic/petcaresys/tree/main/src/com/petcare/model): `src/com/petcare/model`

### Reporting and support

- [Report generation](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/util/ReportGenerator.java): `src/com/petcare/util/ReportGenerator.java`
- [Error handling](https://github.com/burntbasic/petcaresys/blob/main/src/com/petcare/util/ErrorHandler.java): `src/com/petcare/util/ErrorHandler.java`

### Other components

- **User**
- **MySQL database**

## Connections

- User → Login screen: signs in
- User → Registration: registers
- Application entry → Login screen: launches (evidence: `src/com/petcare/PetCareSys.java`)
- Login screen → Login logic: authenticates (evidence: `src/com/petcare/view/LoginFrame.java`)
- Login logic → User data access: checks credentials (evidence: `src/com/petcare/controller/LoginController.java`)
- Registration → Registration logic: submits details (evidence: `src/com/petcare/view/RegisterFrame.java`)
- Registration logic → User data access: creates account (evidence: `src/com/petcare/controller/RegisterController.java`)
- Login screen → Role dashboard factory: selects dashboard (evidence: `src/com/petcare/view/LoginFrame.java`)
- Role dashboard factory → Owner dashboard and panels: creates by role (evidence: `src/com/petcare/factory/DashboardFactory.java`)
- Role dashboard factory → Vet dashboard and panels: creates by role (evidence: `src/com/petcare/factory/DashboardFactory.java`)
- Role dashboard factory → Admin dashboard and panels: creates by role (evidence: `src/com/petcare/factory/DashboardFactory.java`)
- Owner dashboard and panels → Owner workflows: requests operations (evidence: `src/com/petcare/view/petOwnerFrames/BookAppointmentDialog.java`)
- Vet dashboard and panels → Vet workflows: requests operations (evidence: `src/com/petcare/view/vetFrames/AddTreatmentDialog.java`)
- Admin dashboard and panels → Admin workflows: requests operations (evidence: `src/com/petcare/view/adminFrames/AddAppointmentDialog.java`)
- Owner workflows → Pet data access: manages pets (evidence: `src/com/petcare/controller/PetOwnerController.java`)
- Owner workflows → Appointment data access: books appointments (evidence: `src/com/petcare/controller/PetOwnerController.java`)
- Owner workflows → Treatment data access: reads medical history (evidence: `src/com/petcare/controller/PetOwnerController.java`)
- Owner workflows → Activity logging: records actions (evidence: `src/com/petcare/controller/PetOwnerController.java`)
- Vet workflows → Appointment data access: handles appointments (evidence: `src/com/petcare/controller/VetController.java`)
- Vet workflows → Pet data access: finds patients (evidence: `src/com/petcare/controller/VetController.java`)
- Vet workflows → Treatment data access: manages treatments (evidence: `src/com/petcare/controller/VetController.java`)
- Vet workflows → Activity logging: records actions (evidence: `src/com/petcare/controller/VetController.java`)
- Admin workflows → User data access: manages users (evidence: `src/com/petcare/controller/AdminController.java`)
- Admin workflows → Pet data access: manages pets (evidence: `src/com/petcare/controller/AdminController.java`)
- Admin workflows → Appointment data access: manages appointments (evidence: `src/com/petcare/controller/AdminController.java`)
- Admin workflows → Activity logging: records actions (evidence: `src/com/petcare/controller/AdminController.java`)
- User data access → Database connection: opens connection (evidence: `src/com/petcare/dao/UserDAO.java`)
- Pet data access → Database connection: opens connection (evidence: `src/com/petcare/dao/PetDAO.java`)
- Appointment data access → Database connection: opens connection (evidence: `src/com/petcare/dao/AppointmentDAO.java`)
- Treatment data access → Database connection: opens connection (evidence: `src/com/petcare/dao/TreatmentDAO.java`)
- Activity logging → Database connection: opens connection (evidence: `src/com/petcare/dao/ActivityLogDAO.java`)
- Database connection → MySQL database: connects to
- Appointment data access → Domain models: maps appointments (evidence: `src/com/petcare/dao/AppointmentDAO.java`)
- Pet data access → Domain models: maps pets (evidence: `src/com/petcare/dao/PetDAO.java`)
- Treatment data access → Domain models: maps treatments (evidence: `src/com/petcare/dao/TreatmentDAO.java`)
- Report generation → Database connection: loads report data (evidence: `src/com/petcare/util/ReportGenerator.java`)
- Owner dashboard and panels → Report generation: generates reports
- Vet dashboard and panels → Report generation: generates reports
- Admin dashboard and panels → Report generation: generates reports
