# mathini25/vlrs architecture

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

- Interactive diagram: https://gitdiagram.com/mathini25/vlrs
- Repository: https://github.com/mathini25/vlrs

## Overview

VLRS is a JavaFX video-library client backed by a Java RMI service and MySQL. The main workflow lets staff maintain genres, movies, and clients, then record rentals and returns and view borrowed/returned titles. The client controller calls the remote service; its JDBC implementation reads and writes the catalog and rental records. Server startup initializes the schema and registers the service. The README gives no further capability details, and the excerpts do not expose every controller connection or UI resource, so only evidenced links are shown.

Main entry points: [`PrimaryController.java`](https://github.com/mathini25/vlrs/blob/main/PrimaryController.java) (Library screens), [`VideoLibraryServiceImpl.java`](https://github.com/mathini25/vlrs/blob/main/VideoLibraryServiceImpl.java) (Service implementation), [`App.java`](https://github.com/mathini25/vlrs/blob/main/App.java) (JavaFX app), [`Database.java`](https://github.com/mathini25/vlrs/blob/main/Database.java) (Database access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_app["JavaFX app<br/>[App.java]"]
  node_controller["Library screens"]
  node_navigation["Screen navigation"]
  node_item["Display item<br/>[NamedItem.java]"]
end

subgraph group_service["Remote service"]
  node_rmi["RMI registry"]
  node_api["Library operations"]
  node_implementation["Service implementation"]
  node_server["Server startup<br/>[Server.java]"]
end

subgraph group_storage["Persistence"]
  node_database["Database access<br/>[Database.java]"]
  node_mysql[("MySQL library data")]
end

node_staff(("Library staff"))

node_staff -->|"uses"| node_app
node_app -->|"loads view"| node_controller
node_controller -->|"looks up service"| node_rmi
node_controller -->|"invokes remotely"| node_api
node_api -->|"implemented by"| node_implementation
node_implementation -->|"opens connections"| node_database
node_database -->|"reads and writes"| node_mysql
node_server -->|"initializes schema"| node_database
node_server -->|"registers service"| node_implementation
node_implementation -->|"returns items"| node_item
node_controller -->|"displays selections"| node_item
node_navigation -->|"switches views"| node_app

click node_app "https://github.com/mathini25/vlrs/blob/main/App.java"
click node_controller "https://github.com/mathini25/vlrs/blob/main/PrimaryController.java"
click node_navigation "https://github.com/mathini25/vlrs/blob/main/SecondaryController.java"
click node_item "https://github.com/mathini25/vlrs/blob/main/NamedItem.java"
click node_api "https://github.com/mathini25/vlrs/blob/main/VideoLibraryService.java"
click node_implementation "https://github.com/mathini25/vlrs/blob/main/VideoLibraryServiceImpl.java"
click node_server "https://github.com/mathini25/vlrs/blob/main/Server.java"
click node_database "https://github.com/mathini25/vlrs/blob/main/Database.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_app,node_controller,node_navigation,node_item toneBlue
class node_rmi,node_api,node_implementation,node_server toneAmber
class node_database,node_mysql toneMint
class node_staff toneIndigo
```

## Components

### Desktop client

- [JavaFX app](https://github.com/mathini25/vlrs/blob/main/App.java): `App.java`
- [Library screens](https://github.com/mathini25/vlrs/blob/main/PrimaryController.java): `PrimaryController.java`
- [Screen navigation](https://github.com/mathini25/vlrs/blob/main/SecondaryController.java): `SecondaryController.java`
- [Display item](https://github.com/mathini25/vlrs/blob/main/NamedItem.java): `NamedItem.java`

### Remote service

- **RMI registry**
- [Library operations](https://github.com/mathini25/vlrs/blob/main/VideoLibraryService.java): `VideoLibraryService.java`
- [Service implementation](https://github.com/mathini25/vlrs/blob/main/VideoLibraryServiceImpl.java): `VideoLibraryServiceImpl.java`
- [Server startup](https://github.com/mathini25/vlrs/blob/main/Server.java): `Server.java`

### Persistence

- [Database access](https://github.com/mathini25/vlrs/blob/main/Database.java): `Database.java`
- **MySQL library data**

### Other components

- **Library staff**

## Connections

- Library staff → JavaFX app: uses (evidence: `App.java`)
- JavaFX app → Library screens: loads view (evidence: `App.java`)
- Library screens → RMI registry: looks up service (evidence: `PrimaryController.java`)
- Library screens → Library operations: invokes remotely (evidence: `PrimaryController.java`)
- Library operations → Service implementation: implemented by (evidence: `VideoLibraryServiceImpl.java`)
- Service implementation → Database access: opens connections (evidence: `VideoLibraryServiceImpl.java`)
- Database access → MySQL library data: reads and writes (evidence: `Database.java`)
- Server startup → Database access: initializes schema (evidence: `Server.java`)
- Server startup → Service implementation: registers service (evidence: `Server.java`)
- Service implementation → Display item: returns items (evidence: `VideoLibraryServiceImpl.java`)
- Library screens → Display item: displays selections (evidence: `PrimaryController.java`)
- Screen navigation → JavaFX app: switches views (evidence: `SecondaryController.java`)
