# angelcorr/university-library architecture

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

- Interactive diagram: https://gitdiagram.com/angelcorr/university-library
- Repository: https://github.com/angelcorr/university-library

## Overview

This JavaFX desktop library app lets staff add or clone books, register users, and issue or return loans. Main assembles three tabbed views and their controllers; controllers handle UI events and delegate to in-memory managers/services, with models holding catalog, user, and loan state. LoanService tracks active loans and consults the catalog manager. The README only describes the project as a design-pattern demonstration; unsampled controller, view, and model details are represented at their source paths, with relationships included only where the index or excerpts support them.

Main entry points: [`university-library/src/com/universitylibrary/project/Main.java`](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/Main.java) (App assembly), [`university-library/src/com/universitylibrary/project/services/LoanService.java`](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LoanService.java) (Loan service), [`university-library/src/com/universitylibrary/project/services/LibraryManager.java`](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LibraryManager.java) (Catalog manager), [`university-library/src/com/universitylibrary/project/models/Book.java`](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Book.java) (Book record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_app["App assembly<br/>[Main.java]"]
  node_bookui["Book form<br/>[BookView.java]"]
  node_loanui["Loan form<br/>[LoanView.java]"]
  node_userui["User form<br/>[UserView.java]"]
end

subgraph group_operations["Library Operations"]
  node_bookctl["Book actions"]
  node_loancntl["Loan actions"]
  node_userctl["User actions"]
  node_catalog["Catalog manager"]
  node_loansvc["Loan service<br/>[LoanService.java]"]
  node_usersvc["User manager<br/>[UserManager.java]"]
end

subgraph group_domain["Library Domain"]
  node_book["Book record<br/>[Book.java]"]
  node_loan["Loan record<br/>[Loan.java]"]
  node_user["User record<br/>[User.java]"]
  node_library["Library details<br/>[Library.java]"]
  node_exceptions["Library errors"]
end

node_staff(("Library staff"))

node_staff -->|"starts"| node_app
node_app -->|"creates"| node_bookui
node_app -->|"creates"| node_loanui
node_app -->|"creates"| node_userui
node_app -->|"registers"| node_bookctl
node_app -->|"registers"| node_loancntl
node_app -->|"registers"| node_userctl
node_app -->|"gets singleton"| node_catalog
node_app -->|"gets singleton"| node_usersvc
node_app -->|"constructs"| node_loansvc
node_app -->|"reads details"| node_library
node_bookctl -->|"handles events"| node_bookui
node_bookctl -->|"adds or searches"| node_catalog
node_bookctl -->|"clones"| node_book
node_loancntl -->|"handles events"| node_loanui
node_loancntl -->|"requests loan"| node_loansvc
node_userctl -->|"handles events"| node_userui
node_userctl -->|"adds user"| node_usersvc
node_catalog -->|"builds records"| node_book
node_catalog -->|"builds details"| node_library
node_catalog -->|"throws not found"| node_exceptions
node_loansvc -->|"searches book"| node_catalog
node_loansvc -->|"updates availability"| node_book
node_loansvc -->|"creates and tracks"| node_loan
node_loansvc -->|"throws on loan"| node_exceptions
node_usersvc -->|"builds records"| node_user
node_loan -->|"references"| node_book
node_user -->|"tracks titles"| node_book

click node_app "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/Main.java"
click node_bookui "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/BookView.java"
click node_loanui "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/LoanView.java"
click node_userui "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/UserView.java"
click node_bookctl "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/BookController.java"
click node_loancntl "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/LoanController.java"
click node_userctl "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/UserController.java"
click node_catalog "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LibraryManager.java"
click node_loansvc "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LoanService.java"
click node_usersvc "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/UserManager.java"
click node_book "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Book.java"
click node_loan "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Loan.java"
click node_user "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/User.java"
click node_library "https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Library.java"
click node_exceptions "https://github.com/angelcorr/university-library/tree/main/university-library/src/com/universitylibrary/project/exceptions"

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_bookui,node_loanui,node_userui toneBlue
class node_bookctl,node_loancntl,node_userctl,node_catalog,node_loansvc,node_usersvc toneAmber
class node_book,node_loan,node_user,node_library,node_exceptions toneMint
class node_staff toneIndigo
```

## Components

### Desktop UI

- [App assembly](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/Main.java): `university-library/src/com/universitylibrary/project/Main.java`
- [Book form](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/BookView.java): `university-library/src/com/universitylibrary/project/view/BookView.java`
- [Loan form](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/LoanView.java): `university-library/src/com/universitylibrary/project/view/LoanView.java`
- [User form](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/view/UserView.java): `university-library/src/com/universitylibrary/project/view/UserView.java`

### Library Operations

- [Book actions](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/BookController.java): `university-library/src/com/universitylibrary/project/controller/BookController.java`
- [Loan actions](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/LoanController.java): `university-library/src/com/universitylibrary/project/controller/LoanController.java`
- [User actions](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/controller/UserController.java): `university-library/src/com/universitylibrary/project/controller/UserController.java`
- [Catalog manager](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LibraryManager.java): `university-library/src/com/universitylibrary/project/services/LibraryManager.java`
- [Loan service](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/LoanService.java): `university-library/src/com/universitylibrary/project/services/LoanService.java`
- [User manager](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/services/UserManager.java): `university-library/src/com/universitylibrary/project/services/UserManager.java`

### Library Domain

- [Book record](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Book.java): `university-library/src/com/universitylibrary/project/models/Book.java`
- [Loan record](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Loan.java): `university-library/src/com/universitylibrary/project/models/Loan.java`
- [User record](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/User.java): `university-library/src/com/universitylibrary/project/models/User.java`
- [Library details](https://github.com/angelcorr/university-library/blob/main/university-library/src/com/universitylibrary/project/models/Library.java): `university-library/src/com/universitylibrary/project/models/Library.java`
- [Library errors](https://github.com/angelcorr/university-library/tree/main/university-library/src/com/universitylibrary/project/exceptions): `university-library/src/com/universitylibrary/project/exceptions`

### Other components

- **Library staff**

## Connections

- Library staff → App assembly: starts (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Book form: creates (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Loan form: creates (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → User form: creates (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Book actions: registers (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Loan actions: registers (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → User actions: registers (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Catalog manager: gets singleton (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → User manager: gets singleton (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Loan service: constructs (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- App assembly → Library details: reads details (evidence: `university-library/src/com/universitylibrary/project/Main.java`)
- Book actions → Book form: handles events (evidence: `university-library/src/com/universitylibrary/project/controller/BookController.java`)
- Book actions → Catalog manager: adds or searches (evidence: `university-library/src/com/universitylibrary/project/controller/BookController.java`)
- Book actions → Book record: clones (evidence: `university-library/src/com/universitylibrary/project/controller/BookController.java`)
- Loan actions → Loan form: handles events (evidence: `university-library/src/com/universitylibrary/project/controller/LoanController.java`)
- Loan actions → Loan service: requests loan (evidence: `university-library/src/com/universitylibrary/project/controller/LoanController.java`)
- User actions → User form: handles events (evidence: `university-library/src/com/universitylibrary/project/controller/UserController.java`)
- User actions → User manager: adds user (evidence: `university-library/src/com/universitylibrary/project/controller/UserController.java`)
- Catalog manager → Book record: builds records (evidence: `university-library/src/com/universitylibrary/project/services/LibraryManager.java`)
- Catalog manager → Library details: builds details (evidence: `university-library/src/com/universitylibrary/project/services/LibraryManager.java`)
- Catalog manager → Library errors: throws not found (evidence: `university-library/src/com/universitylibrary/project/services/LibraryManager.java`)
- Loan service → Catalog manager: searches book (evidence: `university-library/src/com/universitylibrary/project/services/LoanService.java`)
- Loan service → Book record: updates availability (evidence: `university-library/src/com/universitylibrary/project/services/LoanService.java`)
- Loan service → Loan record: creates and tracks (evidence: `university-library/src/com/universitylibrary/project/services/LoanService.java`)
- Loan service → Library errors: throws on loan (evidence: `university-library/src/com/universitylibrary/project/services/LoanService.java`)
- User manager → User record: builds records (evidence: `university-library/src/com/universitylibrary/project/services/UserManager.java`)
- Loan record → Book record: references (evidence: `university-library/src/com/universitylibrary/project/models/Loan.java`)
- User record → Book record: tracks titles (evidence: `university-library/src/com/universitylibrary/project/models/User.java`)
