# greymeridian/cosc236lab architecture

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

- Interactive diagram: https://gitdiagram.com/greymeridian/cosc236lab
- Repository: https://github.com/greymeridian/cosc236lab

## Overview

This coursework repository contains three small Java examples: a restaurant order demo (Lab 3), a GRASP-oriented library system (Lab 4), and a refactored library system using a Book interface (Lab 5). The graphs preserve each distinct runtime example rather than implying they form one application. The Lab 4 README describes availability, lookup, borrowing/returning, and guarded removal; Lab 5 documents interface-based catalog and loan operations. Edges reflect shown calls or explicit README behavior; unexcerpted implementation details are represented only where documented.

Main entry points: [`lab5/src/lab5/LibrarianController.java`](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/LibrarianController.java) (Librarian controller), [`lab4/library/Library.java`](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Library.java) (Catalog and members), [`lab3/restaurant/RestaurantApp.java`](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/RestaurantApp.java) (Restaurant app), [`lab3/restaurant/Customer.java`](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/Customer.java) (Customer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_restaurant["Restaurant demo"]
  node_restaurant_app["Restaurant app<br/>[RestaurantApp.java]"]
  node_customer["Customer<br/>[Customer.java]"]
  node_order["Order<br/>[Order.java]"]
  node_menu_item["Menu item<br/>[MenuItem.java]"]
end

subgraph group_library4["Library Lab 4"]
  node_library4_app["Library demo<br/>[LibraryApp.java]"]
  node_controller4["Librarian controller"]
  node_library4_catalog[("Catalog and members<br/>[Library.java]")]
  node_book4["Book state<br/>[Book.java]"]
  node_member4["Member loans<br/>[Member.java]"]
end

subgraph group_library5["Library Lab 5"]
  node_library5_app["Library demo<br/>[LibraryApp.java]"]
  node_controller5["Librarian controller"]
  node_library5_catalog[("Catalog and members<br/>[Library.java]")]
  node_book_api["Book interface<br/>[Book.java]"]
  node_paper_book["Paper book<br/>[PaperBook.java]"]
  node_member5["Member loans<br/>[Member.java]"]
end

node_restaurant_user(("Demo runner"))
node_library4_user(("Demo runner"))
node_library5_user(("Demo runner"))

node_restaurant_user -->|"runs"| node_restaurant_app
node_restaurant_app -->|"creates"| node_customer
node_restaurant_app -->|"creates"| node_menu_item
node_customer -->|"adds items"| node_order
node_customer -->|"prints details"| node_order
node_order -->|"reads prices"| node_menu_item
node_library4_user -->|"runs"| node_library4_app
node_library4_app -->|"sets up demo"| node_library4_catalog
node_library4_app -->|"issues requests"| node_controller4
node_controller4 -->|"delegates loans"| node_library4_catalog
node_library4_catalog -->|"manages catalog"| node_book4
node_library4_catalog -->|"manages members"| node_member4
node_member4 -->|"borrows or returns"| node_book4
node_library5_user -->|"runs"| node_library5_app
node_library5_app -->|"sends requests"| node_controller5
node_controller5 -->|"searches and delegates"| node_library5_catalog
node_controller5 -->|"creates"| node_paper_book
node_library5_catalog -->|"stores interface"| node_book_api
node_paper_book -->|"implements"| node_book_api
node_controller5 -->|"delegates loans"| node_member5
node_member5 -->|"borrows or returns"| node_book_api

click node_restaurant_app "https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/RestaurantApp.java"
click node_customer "https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/Customer.java"
click node_order "https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/Order.java"
click node_menu_item "https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/MenuItem.java"
click node_library4_app "https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/LibraryApp.java"
click node_controller4 "https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/LibrarianController.java"
click node_library4_catalog "https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Library.java"
click node_book4 "https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Book.java"
click node_member4 "https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Member.java"
click node_library5_app "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/LibraryApp.java"
click node_controller5 "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/LibrarianController.java"
click node_library5_catalog "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Library.java"
click node_book_api "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Book.java"
click node_paper_book "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/PaperBook.java"
click node_member5 "https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Member.java"

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_restaurant_app,node_customer,node_order,node_menu_item toneBlue
class node_library4_app,node_controller4,node_library4_catalog,node_book4,node_member4 toneAmber
class node_library5_app,node_controller5,node_library5_catalog,node_book_api,node_paper_book,node_member5 toneMint
class node_restaurant_user,node_library4_user,node_library5_user toneIndigo
```

## Components

### Restaurant demo

- [Restaurant app](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/RestaurantApp.java): `lab3/restaurant/RestaurantApp.java`
- [Customer](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/Customer.java): `lab3/restaurant/Customer.java`
- [Order](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/Order.java): `lab3/restaurant/Order.java`
- [Menu item](https://github.com/greymeridian/cosc236lab/blob/main/lab3/restaurant/MenuItem.java): `lab3/restaurant/MenuItem.java`

### Library Lab 4

- [Library demo](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/LibraryApp.java): `lab4/library/LibraryApp.java`
- [Librarian controller](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/LibrarianController.java): `lab4/library/LibrarianController.java`
- [Catalog and members](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Library.java): `lab4/library/Library.java`
- [Book state](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Book.java): `lab4/library/Book.java`
- [Member loans](https://github.com/greymeridian/cosc236lab/blob/main/lab4/library/Member.java): `lab4/library/Member.java`

### Library Lab 5

- [Library demo](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/LibraryApp.java): `lab5/src/lab5/LibraryApp.java`
- [Librarian controller](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/LibrarianController.java): `lab5/src/lab5/LibrarianController.java`
- [Catalog and members](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Library.java): `lab5/src/lab5/Library.java`
- [Book interface](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Book.java): `lab5/src/lab5/Book.java`
- [Paper book](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/PaperBook.java): `lab5/src/lab5/PaperBook.java`
- [Member loans](https://github.com/greymeridian/cosc236lab/blob/main/lab5/src/lab5/Member.java): `lab5/src/lab5/Member.java`

### Other components

- **Demo runner**
- **Demo runner**
- **Demo runner**

## Connections

- Demo runner → Restaurant app: runs (evidence: `README.md`)
- Restaurant app → Customer: creates (evidence: `lab3/restaurant/RestaurantApp.java`)
- Restaurant app → Menu item: creates (evidence: `lab3/restaurant/RestaurantApp.java`)
- Customer → Order: adds items (evidence: `lab3/restaurant/Customer.java`)
- Customer → Order: prints details (evidence: `lab3/restaurant/Customer.java`)
- Order → Menu item: reads prices (evidence: `lab3/restaurant/Order.java`)
- Demo runner → Library demo: runs (evidence: `README.md`)
- Library demo → Catalog and members: sets up demo (evidence: `lab4/library/LibraryApp.java`)
- Library demo → Librarian controller: issues requests (evidence: `lab4/library/LibraryApp.java`)
- Librarian controller → Catalog and members: delegates loans (evidence: `lab4/library/LibrarianController.java`)
- Catalog and members → Book state: manages catalog (evidence: `lab4/library/Library.java`)
- Catalog and members → Member loans: manages members (evidence: `lab4/library/Library.java`)
- Member loans → Book state: borrows or returns (evidence: `README.md`)
- Demo runner → Library demo: runs (evidence: `README.md`)
- Library demo → Librarian controller: sends requests (evidence: `lab5/src/lab5/LibraryApp.java`)
- Librarian controller → Catalog and members: searches and delegates (evidence: `lab5/src/lab5/LibrarianController.java`)
- Librarian controller → Paper book: creates (evidence: `lab5/src/lab5/LibrarianController.java`)
- Catalog and members → Book interface: stores interface (evidence: `README.md`)
- Paper book → Book interface: implements (evidence: `README.md`)
- Librarian controller → Member loans: delegates loans (evidence: `lab5/src/lab5/LibrarianController.java`)
- Member loans → Book interface: borrows or returns (evidence: `README.md`)
