# leizxc/digitallibrary architecture

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

- Interactive diagram: https://gitdiagram.com/leizxc/digitallibrary
- Repository: https://github.com/leizxc/digitallibrary

## Overview

This is a PHP digital library for students, teachers, librarians, and administrators. Visitors browse and search books; registered users can reserve hardcopies, manage profiles, and access borrowed-book features. Librarians manage books, reservations, and borrowing, while administrators manage librarian accounts, teacher verification, and reports. The sampled code shows direct page-to-database access rather than a separate service layer. Several important endpoints are present in the tree but were not excerpted, so their internal flows are not expanded here.

Main entry points: [`connection.php`](https://github.com/leizxc/digitallibrary/blob/master/connection.php) (Database Connection), [`librarian.php`](https://github.com/leizxc/digitallibrary/blob/master/librarian.php) (Librarian Dashboard), [`index.php`](https://github.com/leizxc/digitallibrary/blob/master/index.php) (Public Catalog), [`homeprofandstud.php`](https://github.com/leizxc/digitallibrary/blob/master/homeprofandstud.php) (Member Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and Access"]
  node_public_catalog["Public Catalog<br/>[index.php]"]
  node_member_catalog["Member Catalog"]
  node_search["Book Search<br/>[searchbarlogic.php]"]
  node_rules["Borrowing Rules<br/>[about.php]"]
  node_book_details["Book Details<br/>[getBookDetails.php]"]
end

subgraph group_accounts["Accounts and Profiles"]
  node_login["Login and Signup<br/>[DigitalLibrary.php]"]
  node_registration["Account Processing<br/>[register.php]"]
  node_profile["User Profile<br/>[profile.php]"]
  node_profile_update["Profile Update<br/>[update_profile.php]"]
end

subgraph group_circulation["Circulation"]
  node_reservation["Reservation<br/>[reservation.php]"]
  node_borrowing["Borrowing Records"]
  node_approval["Reservation Decision"]
end

subgraph group_operations["Library Operations"]
  node_librarian["Librarian Dashboard<br/>[librarian.php]"]
  node_book_add["Book Entry<br/>[add_book.php]"]
  node_admin["Admin Console<br/>[admin.php]"]
end

subgraph group_infrastructure["Persistence and QR"]
  node_database_connection["Database Connection<br/>[connection.php]"]
  node_mysql[("Library Database")]
  node_qr["QR Code Encoder<br/>[qrlib.php]"]
end

node_visitor(("Visitor"))
node_user(("Library User"))
node_staff(("Library Staff"))

node_visitor -->|"browses"| node_public_catalog
node_visitor -->|"signs in"| node_login
node_user -->|"browses"| node_member_catalog
node_user -->|"reserves"| node_reservation
node_user -->|"views profile"| node_profile
node_public_catalog -->|"fetches matches"| node_search
node_member_catalog -->|"fetches matches"| node_search
node_login -->|"submits forms"| node_registration
node_profile -->|"submits edits"| node_profile_update
node_reservation -->|"generates code"| node_qr
node_reservation -->|"opens database"| node_database_connection
node_search -->|"opens database"| node_database_connection
node_public_catalog -->|"opens database"| node_database_connection
node_member_catalog -->|"opens database"| node_database_connection
node_profile -->|"opens database"| node_database_connection
node_librarian -->|"opens database"| node_database_connection
node_admin -->|"opens database"| node_database_connection
node_book_add -->|"opens database"| node_database_connection
node_borrowing -->|"opens database"| node_database_connection
node_approval -->|"opens database"| node_database_connection
node_registration -->|"opens database"| node_database_connection
node_profile_update -->|"opens database"| node_database_connection
node_book_details -->|"opens database"| node_database_connection
node_database_connection -->|"connects to"| node_mysql
node_staff -->|"manages circulation"| node_librarian
node_staff -->|"manages accounts"| node_admin
node_librarian -->|"posts decision"| node_approval
node_librarian -.->|"adds books"| node_book_add
node_user -->|"views borrowings"| node_borrowing

click node_public_catalog "https://github.com/leizxc/digitallibrary/blob/master/index.php"
click node_member_catalog "https://github.com/leizxc/digitallibrary/blob/master/homeprofandstud.php"
click node_search "https://github.com/leizxc/digitallibrary/blob/master/searchbarlogic.php"
click node_rules "https://github.com/leizxc/digitallibrary/blob/master/about.php"
click node_login "https://github.com/leizxc/digitallibrary/blob/master/DigitalLibrary.php"
click node_registration "https://github.com/leizxc/digitallibrary/blob/master/register.php"
click node_profile "https://github.com/leizxc/digitallibrary/blob/master/profile.php"
click node_profile_update "https://github.com/leizxc/digitallibrary/blob/master/update_profile.php"
click node_reservation "https://github.com/leizxc/digitallibrary/blob/master/reservation.php"
click node_borrowing "https://github.com/leizxc/digitallibrary/blob/master/borrowedbooksform.php"
click node_approval "https://github.com/leizxc/digitallibrary/blob/master/approve_reservation.php"
click node_librarian "https://github.com/leizxc/digitallibrary/blob/master/librarian.php"
click node_book_add "https://github.com/leizxc/digitallibrary/blob/master/add_book.php"
click node_admin "https://github.com/leizxc/digitallibrary/blob/master/admin.php"
click node_book_details "https://github.com/leizxc/digitallibrary/blob/master/getBookDetails.php"
click node_database_connection "https://github.com/leizxc/digitallibrary/blob/master/connection.php"
click node_qr "https://github.com/leizxc/digitallibrary/blob/master/phpqrcode/qrlib.php"

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_public_catalog,node_member_catalog,node_search,node_rules,node_book_details,node_user toneBlue
class node_login,node_registration,node_profile,node_profile_update toneAmber
class node_reservation,node_borrowing,node_approval toneMint
class node_librarian,node_book_add,node_admin toneRose
class node_database_connection,node_mysql,node_qr,node_visitor,node_staff toneIndigo
```

## Components

### Discovery and Access

- [Public Catalog](https://github.com/leizxc/digitallibrary/blob/master/index.php): `index.php`
- [Member Catalog](https://github.com/leizxc/digitallibrary/blob/master/homeprofandstud.php): `homeprofandstud.php`
- [Book Search](https://github.com/leizxc/digitallibrary/blob/master/searchbarlogic.php): `searchbarlogic.php`
- [Borrowing Rules](https://github.com/leizxc/digitallibrary/blob/master/about.php): `about.php`
- [Book Details](https://github.com/leizxc/digitallibrary/blob/master/getBookDetails.php): `getBookDetails.php`

### Accounts and Profiles

- [Login and Signup](https://github.com/leizxc/digitallibrary/blob/master/DigitalLibrary.php): `DigitalLibrary.php`
- [Account Processing](https://github.com/leizxc/digitallibrary/blob/master/register.php): `register.php`
- [User Profile](https://github.com/leizxc/digitallibrary/blob/master/profile.php): `profile.php`
- [Profile Update](https://github.com/leizxc/digitallibrary/blob/master/update_profile.php): `update_profile.php`

### Circulation

- [Reservation](https://github.com/leizxc/digitallibrary/blob/master/reservation.php): `reservation.php`
- [Borrowing Records](https://github.com/leizxc/digitallibrary/blob/master/borrowedbooksform.php): `borrowedbooksform.php`
- [Reservation Decision](https://github.com/leizxc/digitallibrary/blob/master/approve_reservation.php): `approve_reservation.php`

### Library Operations

- [Librarian Dashboard](https://github.com/leizxc/digitallibrary/blob/master/librarian.php): `librarian.php`
- [Book Entry](https://github.com/leizxc/digitallibrary/blob/master/add_book.php): `add_book.php`
- [Admin Console](https://github.com/leizxc/digitallibrary/blob/master/admin.php): `admin.php`

### Persistence and QR

- [Database Connection](https://github.com/leizxc/digitallibrary/blob/master/connection.php): `connection.php`
- **Library Database**
- [QR Code Encoder](https://github.com/leizxc/digitallibrary/blob/master/phpqrcode/qrlib.php): `phpqrcode/qrlib.php`

### Other components

- **Visitor**
- **Library User**
- **Library Staff**

## Connections

- Visitor → Public Catalog: browses (evidence: `index.php`)
- Visitor → Login and Signup: signs in
- Library User → Member Catalog: browses (evidence: `homeprofandstud.php`)
- Library User → Reservation: reserves
- Library User → User Profile: views profile
- Public Catalog → Book Search: fetches matches (evidence: `index.php`)
- Member Catalog → Book Search: fetches matches (evidence: `homeprofandstud.php`)
- Login and Signup → Account Processing: submits forms (evidence: `DigitalLibrary.php`)
- User Profile → Profile Update: submits edits (evidence: `profile.php`)
- Reservation → QR Code Encoder: generates code (evidence: `reservation.php`)
- Reservation → Database Connection: opens database (evidence: `reservation.php`)
- Book Search → Database Connection: opens database (evidence: `searchbarlogic.php`)
- Public Catalog → Database Connection: opens database (evidence: `index.php`)
- Member Catalog → Database Connection: opens database (evidence: `homeprofandstud.php`)
- User Profile → Database Connection: opens database (evidence: `profile.php`)
- Librarian Dashboard → Database Connection: opens database (evidence: `librarian.php`)
- Admin Console → Database Connection: opens database (evidence: `admin.php`)
- Book Entry → Database Connection: opens database (evidence: `add_book.php`)
- Borrowing Records → Database Connection: opens database (evidence: `borrowedbooksform.php`)
- Reservation Decision → Database Connection: opens database (evidence: `approve_reservation.php`)
- Account Processing → Database Connection: opens database (evidence: `register.php`)
- Profile Update → Database Connection: opens database (evidence: `update_profile.php`)
- Book Details → Database Connection: opens database (evidence: `getBookDetails.php`)
- Database Connection → Library Database: connects to (evidence: `connection.php`)
- Library Staff → Librarian Dashboard: manages circulation (evidence: `librarian.php`)
- Library Staff → Admin Console: manages accounts (evidence: `admin.php`)
- Librarian Dashboard → Reservation Decision: posts decision (evidence: `librarian.php`)
- Librarian Dashboard → Book Entry: adds books
- Library User → Borrowing Records: views borrowings
