# filippotaiti/biblioteca-swe- architecture

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

## Overview

Biblioteca universitaria is a command-line library-management application. A user selects a role and signs in; hirers consult the catalogue and their loans or reservations, while administrators manage catalogue items, borrowers, lending and returns. Controllers enforce role and availability rules, then use DAOs to persist library data; authentication can use the university system, and mail sends account and lending notifications. The README also documents catalogue and lending administration and user access to reservations. Some subsystem links are documented or indexed but their full implementations were not excerpted, so those links are marked unverified.

Main entry points: [`src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/CommandLineInterface.java) (Role-based CLI), [`src/main/java/com/progetto_swe/business_logic/HirerController.java`](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/HirerController.java) (Hirer access), [`src/main/java/com/progetto_swe/CLI/HirerCLI.java`](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/HirerCLI.java) (Hirer interface), [`src/main/java/com/progetto_swe/business_logic/LendingController.java`](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/LendingController.java) (Lending management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and entry"]
  node_main["Application entry<br/>[Main.java]"]
  node_cli["Role-based CLI"]
  node_basecli["Catalog interface<br/>[BaseCLI.java]"]
  node_admincli["Admin interface<br/>[AdminCLI.java]"]
  node_hirercli["Hirer interface<br/>[HirerCLI.java]"]
end

subgraph group_services["Library services"]
  node_adminsvc["Admin access"]
  node_hirersvc["Hirer access"]
  node_catalog["Catalog management"]
  node_lending["Lending management"]
  node_reservation["Reservation management"]
  node_hasher["Credential hashing<br/>[Hasher.java]"]
end

subgraph group_domain["Domain model"]
  node_models["Users and items<br/>[Item.java]"]
  node_loanmodel["Loans and reservations<br/>[Lending.java]"]
end

subgraph group_persistence["Persistence and integrations"]
  node_adminstore["Admin records<br/>[AdminDAO.java]"]
  node_hirerstore["Hirer records<br/>[HirerDAO.java]"]
  node_catalogstore["Catalog records<br/>[BookDAO.java]"]
  node_lendingstore["Loan and queue records<br/>[LendingDAO.java]"]
  node_reservationstore["Reservation records"]
  node_db[("Library database")]
  node_university["University authentication"]
  node_mail["Email notifications<br/>[MailSender.java]"]
end

node_user(("Library user"))

node_user -->|"starts"| node_main
node_main -->|"starts"| node_cli
node_user -->|"selects role"| node_cli
node_cli -->|"authenticates"| node_adminsvc
node_cli -->|"authenticates"| node_hirersvc
node_cli -->|"opens"| node_admincli
node_cli -->|"opens"| node_hirercli
node_cli -->|"defaults to"| node_basecli
node_basecli -->|"queries"| node_catalog
node_admincli -->|"manages"| node_catalog
node_admincli -->|"manages"| node_lending
node_admincli -->|"manages"| node_reservation
node_hirercli -.->|"requests"| node_hirersvc
node_hirercli -.->|"searches"| node_catalog
node_hirercli -.->|"views loans"| node_lending
node_hirercli -.->|"manages reservations"| node_reservation
node_adminsvc -.->|"uses"| node_adminstore
node_adminsvc -.->|"authenticates with"| node_university
node_hirersvc -->|"authenticates with"| node_university
node_hirersvc -->|"reads and writes"| node_hirerstore
node_hirersvc -->|"checks credentials"| node_hasher
node_hirersvc -->|"sends credentials"| node_mail
node_catalog -->|"persists items"| node_catalogstore
node_catalog -->|"creates and checks"| node_models
node_lending -->|"records loans"| node_lendingstore
node_lending -->|"notifies borrowers"| node_mail
node_lending -->|"uses loan data"| node_loanmodel
node_reservation -.->|"persists reservations"| node_reservationstore
node_catalogstore -.->|"uses connection"| node_db
node_lendingstore -.->|"uses connection"| node_db
node_reservationstore -.->|"uses connection"| node_db

click node_main "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/Main.java"
click node_cli "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/CommandLineInterface.java"
click node_basecli "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/BaseCLI.java"
click node_admincli "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/AdminCLI.java"
click node_hirercli "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/HirerCLI.java"
click node_adminsvc "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/AdminController.java"
click node_hirersvc "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/HirerController.java"
click node_catalog "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/ItemController.java"
click node_lending "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/LendingController.java"
click node_reservation "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/ReservationController.java"
click node_hasher "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/Hasher.java"
click node_models "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/domain_model/Item.java"
click node_loanmodel "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/domain_model/Lending.java"
click node_adminstore "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/AdminDAO.java"
click node_hirerstore "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/HirerDAO.java"
click node_catalogstore "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/BookDAO.java"
click node_lendingstore "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/LendingDAO.java"
click node_reservationstore "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/ReservationDAO.java"
click node_db "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/ConnectionManager.java"
click node_university "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/university_authentication_system/UniversityAuthenticationSystem.java"
click node_mail "https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/MailSender/MailSender.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_main,node_cli,node_basecli,node_admincli,node_hirercli,node_user toneBlue
class node_adminsvc,node_hirersvc,node_catalog,node_lending,node_reservation,node_hasher toneAmber
class node_models,node_loanmodel toneMint
class node_adminstore,node_hirerstore,node_catalogstore,node_lendingstore,node_reservationstore,node_db,node_university,node_mail toneRose
```

## Components

### CLI and entry

- [Application entry](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/Main.java): `src/main/java/com/progetto_swe/Main.java`
- [Role-based CLI](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/CommandLineInterface.java): `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`
- [Catalog interface](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/BaseCLI.java): `src/main/java/com/progetto_swe/CLI/BaseCLI.java`
- [Admin interface](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/AdminCLI.java): `src/main/java/com/progetto_swe/CLI/AdminCLI.java`
- [Hirer interface](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/CLI/HirerCLI.java): `src/main/java/com/progetto_swe/CLI/HirerCLI.java`

### Library services

- [Admin access](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/AdminController.java): `src/main/java/com/progetto_swe/business_logic/AdminController.java`
- [Hirer access](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/HirerController.java): `src/main/java/com/progetto_swe/business_logic/HirerController.java`
- [Catalog management](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/ItemController.java): `src/main/java/com/progetto_swe/business_logic/ItemController.java`
- [Lending management](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/LendingController.java): `src/main/java/com/progetto_swe/business_logic/LendingController.java`
- [Reservation management](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/ReservationController.java): `src/main/java/com/progetto_swe/business_logic/ReservationController.java`
- [Credential hashing](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/business_logic/Hasher.java): `src/main/java/com/progetto_swe/business_logic/Hasher.java`

### Domain model

- [Users and items](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/domain_model/Item.java): `src/main/java/com/progetto_swe/domain_model/Item.java`
- [Loans and reservations](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/domain_model/Lending.java): `src/main/java/com/progetto_swe/domain_model/Lending.java`

### Persistence and integrations

- [Admin records](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/AdminDAO.java): `src/main/java/com/progetto_swe/orm/AdminDAO.java`
- [Hirer records](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/HirerDAO.java): `src/main/java/com/progetto_swe/orm/HirerDAO.java`
- [Catalog records](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/BookDAO.java): `src/main/java/com/progetto_swe/orm/BookDAO.java`
- [Loan and queue records](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/LendingDAO.java): `src/main/java/com/progetto_swe/orm/LendingDAO.java`
- [Reservation records](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/ReservationDAO.java): `src/main/java/com/progetto_swe/orm/ReservationDAO.java`
- [Library database](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/orm/ConnectionManager.java): `src/main/java/com/progetto_swe/orm/ConnectionManager.java`
- [University authentication](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/university_authentication_system/UniversityAuthenticationSystem.java): `src/main/java/com/progetto_swe/university_authentication_system/UniversityAuthenticationSystem.java`
- [Email notifications](https://github.com/filippotaiti/biblioteca-swe-/blob/master2/src/main/java/com/progetto_swe/MailSender/MailSender.java): `src/main/java/com/progetto_swe/MailSender/MailSender.java`

### Other components

- **Library user**

## Connections

- Library user → Application entry: starts
- Application entry → Role-based CLI: starts (evidence: `src/main/java/com/progetto_swe/Main.java`)
- Library user → Role-based CLI: selects role (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Role-based CLI → Admin access: authenticates (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Role-based CLI → Hirer access: authenticates (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Role-based CLI → Admin interface: opens (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Role-based CLI → Hirer interface: opens (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Role-based CLI → Catalog interface: defaults to (evidence: `src/main/java/com/progetto_swe/CLI/CommandLineInterface.java`)
- Catalog interface → Catalog management: queries (evidence: `src/main/java/com/progetto_swe/CLI/BaseCLI.java`)
- Admin interface → Catalog management: manages (evidence: `src/main/java/com/progetto_swe/CLI/AdminCLI.java`)
- Admin interface → Lending management: manages (evidence: `src/main/java/com/progetto_swe/CLI/AdminCLI.java`)
- Admin interface → Reservation management: manages (evidence: `src/main/java/com/progetto_swe/CLI/AdminCLI.java`)
- Hirer interface → Hirer access: requests (evidence: `src/main/java/com/progetto_swe/CLI/HirerCLI.java`)
- Hirer interface → Catalog management: searches
- Hirer interface → Lending management: views loans (evidence: `src/main/java/com/progetto_swe/CLI/HirerCLI.java`)
- Hirer interface → Reservation management: manages reservations (evidence: `src/main/java/com/progetto_swe/CLI/HirerCLI.java`)
- Admin access → Admin records: uses (evidence: `src/main/java/com/progetto_swe/business_logic/AdminController.java`)
- Admin access → University authentication: authenticates with (evidence: `src/main/java/com/progetto_swe/business_logic/AdminController.java`)
- Hirer access → University authentication: authenticates with (evidence: `src/main/java/com/progetto_swe/business_logic/HirerController.java`)
- Hirer access → Hirer records: reads and writes (evidence: `src/main/java/com/progetto_swe/business_logic/HirerController.java`)
- Hirer access → Credential hashing: checks credentials (evidence: `src/main/java/com/progetto_swe/business_logic/HirerController.java`)
- Hirer access → Email notifications: sends credentials (evidence: `src/main/java/com/progetto_swe/business_logic/HirerController.java`)
- Catalog management → Catalog records: persists items (evidence: `src/main/java/com/progetto_swe/business_logic/ItemController.java`)
- Catalog management → Users and items: creates and checks (evidence: `src/main/java/com/progetto_swe/business_logic/ItemController.java`)
- Lending management → Loan and queue records: records loans (evidence: `src/main/java/com/progetto_swe/business_logic/LendingController.java`)
- Lending management → Email notifications: notifies borrowers (evidence: `src/main/java/com/progetto_swe/business_logic/LendingController.java`)
- Lending management → Loans and reservations: uses loan data (evidence: `src/main/java/com/progetto_swe/business_logic/LendingController.java`)
- Reservation management → Reservation records: persists reservations (evidence: `src/main/java/com/progetto_swe/business_logic/ReservationController.java`)
- Catalog records → Library database: uses connection (evidence: `src/main/java/com/progetto_swe/orm/BookDAO.java`)
- Loan and queue records → Library database: uses connection (evidence: `src/main/java/com/progetto_swe/orm/LendingDAO.java`)
- Reservation records → Library database: uses connection
