Zoo Management System - Design Patterns in Java

University software engineering projects demonstrating Composite and Visitor design patterns, applied to a zoo management domain. Each project builds on the previous one, progressing from a basic hierarchical structure to advanced behavioral patterns.

Important

Class and method names in the source code are in Polish, as required by the course. English translations are provided in parentheses throughout this README.

Projects Overview

Project	Pattern	Focus
zoo-composite-pattern-simple	Composite	Hierarchical zoo structure with recursive area calculation
zoo-composite-pattern	Composite	Extends the above with animals, feed types, and food quantity calculations
zoo-visitor-pattern	Visitor	Zoo employees with role-based salary and leave calculations

---

Project 1: Composite Pattern - Basic

Models a zoo as a tree of exhibitions: Zoo → Zones → Pavilions → Alleys → Enclosures. Each node can calculate its total area recursively through the hierarchy.

classDiagram
    class Ekspozycja {
        <<interface>>
        +obliczPowierzchnieCalkowita() float
        +print(level: int) void
        +getRodzaj() RodzajZbioru
    }

    class Wybieg {
        -nazwa: String
        -powierzchnia: float
        -zakryty: boolean
        -typSrodowiska: String
        +obliczPowierzchnieCalkowita() float
    }

    class ZbiorEkspozycji {
        -ekspozycje: List~Ekspozycja~
        -powierzchniaPozaWybiegami: float
        -rodzaj: RodzajZbioru
        -opis: String
        +dodaj(Ekspozycja) void
        +usun(Ekspozycja) void
        +obliczPowierzchnieCalkowita() float
    }

    class RodzajZbioru {
        <<enumeration>>
        Wybieg
        Alejka
        Pawilon
        Strefa
        OgrodZoologiczny
    }

    Ekspozycja <|.. Wybieg : implements
    Ekspozycja <|.. ZbiorEkspozycji : implements
    ZbiorEkspozycji o-- Ekspozycja : contains
    ZbiorEkspozycji --> RodzajZbioru

Loading

Key classes:

• Exhibition (Ekspozycja) - component interface with area calculation
• Enclosure (Wybieg) - leaf node representing a single animal enclosure
• Exhibition Collection (ZbiorEkspozycji) - composite node that aggregates child exhibitions
• Collection Type (RodzajZbioru) - enum defining hierarchy levels (Enclosure, Alley, Pavilion, Zone, Zoo)

---

Project 2: Composite Pattern - Extended

Builds on the basic version by introducing animals, feed types, and feeding rules. The recursive operation now calculates total food quantity needed across the entire zoo for a given number of days.

Changes from the basic version:

• Component interface renamed from Ekspozycja to Section (Sekcja)
• Composite class renamed from ZbiorEkspozycji to Exhibition (Ekspozycja)
• Added Animal (Zwierze), Feed (Karma), and Feeding Rules (ZasadyKarmienia) domain classes

classDiagram
    class Sekcja {
        <<interface>>
        +obliczIloscKarmy(dni: int) float
        +print(level: int) void
        +getRodzaj() RodzajSekcji
    }

    class Wybieg {
        -nazwa: String
        -powierzchnia: float
        -zakryty: boolean
        -typSrodowiska: String
        -zwierzeta: List~Zwierze~
        +obliczIloscKarmy(dni: int) float
    }

    class Ekspozycja {
        -sekcje: List~Sekcja~
        -rodzaj: RodzajSekcji
        -opis: String
        +dodaj(Sekcja) void
        +usun(Sekcja) void
        +obliczIloscKarmy(dni: int) float
    }

    class Zwierze {
        -imie: String
        -gatunek: String
        -gromada: String
        -zasadyKarmienia: ZasadyKarmienia
        +getIloscKarmyNaDzien() float
    }

    class Karma {
        -nazwa: String
        -jednostka: String
        -przelicznik: float
    }

    class ZasadyKarmienia {
        -zwierze: Zwierze
        -karma: Karma
        -godzinaKarmienia: LocalTime
        -iloscKarmy: int
        +getPrzeliczonaIloscNaDzien() float
    }

    Sekcja <|.. Wybieg : implements
    Sekcja <|.. Ekspozycja : implements
    Ekspozycja o-- Sekcja : contains
    Wybieg o-- Zwierze : contains
    Zwierze --> ZasadyKarmienia
    ZasadyKarmienia --> Karma

Loading

---

Project 3: Visitor Pattern

Models zoo employees with different roles. Uses the Visitor pattern to calculate salaries and determine leave types without modifying employee classes - new operations can be added by implementing a new visitor.

classDiagram
    class Visitor~T~ {
        <<interface>>
        +visit(Ksiegowy) T
        +visit(Przewodnik) T
        +visit(Opiekun) T
        +visit(Kierownik) T
        +visit(AsystentKierownika) T
        +visit(Weterynarz) T
        +visit(Magazynier) T
    }

    class Pracownik {
        <<abstract>>
        #imie: String
        #nazwisko: String
        #dataZatrudnienia: LocalDate
        +accept(Visitor~T~) T*
        +getWynagrodzenie() float
    }

    class ObliczanieWynagrodzeniaVisitor {
        +visit(...) Float
    }

    class TypUrlopuVisitor {
        +visit(...) Urlop
    }

    Pracownik <|-- Ksiegowy
    Pracownik <|-- Przewodnik
    Pracownik <|-- Opiekun
    Pracownik <|-- Kierownik
    Pracownik <|-- AsystentKierownika
    Pracownik <|-- Weterynarz
    Pracownik <|-- Magazynier

    Visitor~T~ <|.. ObliczanieWynagrodzeniaVisitor : implements
    Visitor~T~ <|.. TypUrlopuVisitor : implements

    Pracownik --> Visitor~T~ : accept
    ObliczanieWynagrodzeniaVisitor ..> Faktura : creates
    TypUrlopuVisitor ..> WniosekOUrlop : creates

Loading

Salary Rules

Base salary: 4500. Each role has specific modifiers:

Role	Salary Formula
Accountant (Ksiegowy)	1.1x base + 25 per invoice issued last month
Guide (Przewodnik)	base + 300 if speaks Polish
Caretaker (Opiekun)	1.2x base - 750 if student
Manager (Kierownik)	2.0x base
Assistant Manager (AsystentKierownika)	1.5x base
Veterinarian (Weterynarz)	1.3x base + 150/year outside zoo + degree bonus + 150/specialization
Warehouse Worker (Magazynier)	base + 150/year employed

Leave Rules

Standard leave: 14 days. Each role has specific rules:

Role	Leave Type	Max Days
Accountant (Ksiegowy)	Pracowniczy	14 + years/2
Guide (Przewodnik)	Pracowniczy	14 + years/2
Caretaker (Opiekun)	Opiekuna	14 + 14 if student
Manager (Kierownik)	-	Unlimited (no request needed)
Assistant Manager (AsystentKierownika)	Asystencki	14 + years/2 + 5
Veterinarian (Weterynarz)	Weterynarza	14 + ext. experience + degree bonus
Warehouse Worker (Magazynier)	Nieuprzywilejowany	14

---

Tech Stack

• Java
• IntelliJ IDEA

How to Run

1. Open any project folder in IntelliJ IDEA.
2. Run Main.java - each project has its own main class demonstrating the pattern in action.