# mathini25/projects architecture

> Architecture diagram of the GitHub repository mathini25/projects, 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/projects
- Repository: https://github.com/mathini25/projects

## Overview

This is a Java Swing library-management application: patrons and librarians use role-based menus for borrowing, returns, inventory, and account tasks. The main application stores operational records in text files; a separate registration program writes librarian credentials. DatabaseHelper is an independent Oracle JDBC example, with no shown integration into the Swing application. The excerpts omit much of the main class, so links between its menus and individual operations are not asserted. The runner file duplicates the main application excerpt.

Main entry points: [`Java Project/project_lib.java`](https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java) (Swing library app), [`Java Project/project_1_2.java`](https://github.com/mathini25/projects/blob/master/Java%20Project/project_1_2.java) (Credential registration), [`Java Project/DatabaseHelper.java`](https://github.com/mathini25/projects/blob/master/Java%20Project/DatabaseHelper.java) (JDBC helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Library application"]
  node_swing["Swing library app<br/>[project_lib.java]"]
  node_student["Student tasks<br/>[project_lib.java]"]
  node_librarian["Librarian tasks<br/>[project_lib.java]"]
  node_files[("Text-file records<br/>[project_lib.java]")]
  node_runner["Runner copy"]
end

subgraph group_setup["Librarian setup"]
  node_registration["Credential registration<br/>[project_1_2.java]"]
  node_credentials[("Librarian credentials<br/>[project_1_2.java]")]
end

subgraph group_database["Oracle example"]
  node_helper["JDBC helper"]
end

node_patrons(("Patrons"))
node_librarians(("Librarians"))
node_oracle[("Oracle database")]

node_patrons -->|"use menus"| node_swing
node_librarians -->|"use menus"| node_swing
node_swing -->|"offers tasks"| node_student
node_swing -->|"offers tasks"| node_librarian
node_registration -->|"writes credentials"| node_credentials
node_helper -->|"opens JDBC connection"| node_oracle

click node_swing "https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java"
click node_student "https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java"
click node_librarian "https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java"
click node_files "https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java"
click node_runner "https://github.com/mathini25/projects/blob/master/Java%20Project/tempCodeRunnerFile.java"
click node_registration "https://github.com/mathini25/projects/blob/master/Java%20Project/project_1_2.java"
click node_credentials "https://github.com/mathini25/projects/blob/master/Java%20Project/project_1_2.java"
click node_helper "https://github.com/mathini25/projects/blob/master/Java%20Project/DatabaseHelper.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_swing,node_student,node_librarian,node_files,node_runner toneBlue
class node_registration,node_credentials,node_oracle toneAmber
class node_helper toneMint
class node_patrons,node_librarians toneIndigo
```

## Components

### Library application

- [Swing library app](https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java): `Java Project/project_lib.java`
- [Student tasks](https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java): `Java Project/project_lib.java`
- [Librarian tasks](https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java): `Java Project/project_lib.java`
- [Text-file records](https://github.com/mathini25/projects/blob/master/Java%20Project/project_lib.java): `Java Project/project_lib.java`
- [Runner copy](https://github.com/mathini25/projects/blob/master/Java%20Project/tempCodeRunnerFile.java): `Java Project/tempCodeRunnerFile.java`

### Librarian setup

- [Credential registration](https://github.com/mathini25/projects/blob/master/Java%20Project/project_1_2.java): `Java Project/project_1_2.java`
- [Librarian credentials](https://github.com/mathini25/projects/blob/master/Java%20Project/project_1_2.java): `Java Project/project_1_2.java`

### Oracle example

- [JDBC helper](https://github.com/mathini25/projects/blob/master/Java%20Project/DatabaseHelper.java): `Java Project/DatabaseHelper.java`

### Other components

- **Patrons**
- **Librarians**
- **Oracle database**

## Connections

- Patrons → Swing library app: use menus (evidence: `Java Project/project_lib.java`)
- Librarians → Swing library app: use menus (evidence: `Java Project/project_lib.java`)
- Swing library app → Student tasks: offers tasks (evidence: `Java Project/project_lib.java`)
- Swing library app → Librarian tasks: offers tasks (evidence: `Java Project/project_lib.java`)
- Credential registration → Librarian credentials: writes credentials (evidence: `Java Project/project_1_2.java`)
- JDBC helper → Oracle database: opens JDBC connection (evidence: `Java Project/DatabaseHelper.java`)
