# vionyp/ie4727-f35-dg14 architecture

> Architecture diagram of the GitHub repository vionyp/ie4727-f35-dg14, 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/vionyp/ie4727-f35-dg14
- Repository: https://github.com/vionyp/ie4727-f35-dg14

## Overview

BookNest is an online bookstore and library portal: visitors browse and preview books, members can manage accounts and shelves, purchase books, and reserve study rooms; staff administer the collection and view operational analytics. The graph preserves those product areas and the scripted Paige assistant. Source evidence is partial: the README is empty and many pages and handlers were not excerpted, so unverified cross-feature flows are omitted.

Main entry points: [`booknest/includes/bootstrap.php`](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/bootstrap.php) (Application bootstrap), [`booknest/process/checkout.php`](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/checkout.php) (Order processing), [`booknest/tools/build-seed.php`](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/tools/build-seed.php) (Seed builder), [`booknest/index.php`](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/index.php) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Home page<br/>[index.php]"]
  node_catalogue["Book catalogue<br/>[catalogue.php]"]
  node_book["Book details<br/>[book.php]"]
  node_reader["Book reader<br/>[read.php]"]
  node_account["Account<br/>[account.php]"]
  node_sign_in["Sign in and join<br/>[sign-in.php]"]
end

subgraph group_commerce["Books and commerce"]
  node_cart["Shopping cart<br/>[cart.php]"]
  node_checkout_page["Checkout page<br/>[checkout.php]"]
  node_checkout_handler["Order processing<br/>[checkout.php]"]
  node_payment["Simulated payment"]
  node_orders["Orders and stock<br/>[checkout.php]"]
end

subgraph group_community["Library services"]
  node_rooms_page["Study rooms<br/>[rooms.php]"]
  node_room_booking["Room booking actions<br/>[book-room.php]"]
  node_shelf["Personal shelf<br/>[shelf.php]"]
  node_suggestions["Book suggestions<br/>[add-book.php]"]
  node_assistant["Paige assistant<br/>[assistant.php]"]
end

subgraph group_operations["Staff operations"]
  node_admin["Staff dashboard<br/>[admin.php]"]
  node_admin_actions["Staff actions<br/>[admin-action.php]"]
  node_seed_catalogue["Seed book catalogue<br/>[catalogue.php]"]
  node_seed_builder["Seed builder<br/>[build-seed.php]"]
end

subgraph group_core["Shared runtime"]
  node_database[("Application database<br/>[db.php]")]
  node_mail["Confirmation email<br/>[mail.php]"]
  node_bootstrap["Application bootstrap<br/>[bootstrap.php]"]
  node_auth["Session and access<br/>[auth.php]"]
  node_covers["Generated artwork<br/>[covers.php]"]
  node_views["Shared view helpers<br/>[views.php]"]
  node_configuration["Site configuration<br/>[config.php]"]
end

node_visitor(("Visitor or member"))

node_visitor -.->|"opens"| node_home
node_visitor -.->|"browses"| node_catalogue
node_visitor -.->|"opens"| node_book
node_visitor -.->|"checks out"| node_checkout_page
node_visitor -.->|"views rooms"| node_rooms_page
node_home -->|"loads"| node_bootstrap
node_catalogue -->|"loads"| node_bootstrap
node_book -->|"loads"| node_bootstrap
node_account -->|"loads"| node_bootstrap
node_sign_in -->|"loads"| node_bootstrap
node_checkout_page -->|"loads"| node_bootstrap
node_rooms_page -->|"loads"| node_bootstrap
node_reader -->|"loads"| node_bootstrap
node_suggestions -->|"loads"| node_bootstrap
node_admin -->|"loads"| node_bootstrap
node_checkout_handler -->|"loads"| node_bootstrap
node_room_booking -->|"loads"| node_bootstrap
node_shelf -->|"loads"| node_bootstrap
node_admin_actions -->|"loads"| node_bootstrap
node_bootstrap -->|"loads"| node_configuration
node_bootstrap -->|"loads"| node_database
node_bootstrap -->|"loads"| node_auth
node_bootstrap -->|"loads"| node_covers
node_bootstrap -->|"loads"| node_views
node_checkout_handler -->|"records order"| node_orders
node_checkout_handler -->|"requests outcome"| node_payment
node_checkout_handler -->|"sends confirmation"| node_mail
node_seed_builder -->|"loads data"| node_seed_catalogue
node_seed_builder -->|"uses artwork"| node_covers

click node_home "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/index.php"
click node_catalogue "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/catalogue.php"
click node_book "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/book.php"
click node_reader "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/read.php"
click node_account "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/account.php"
click node_sign_in "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/sign-in.php"
click node_cart "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/cart.php"
click node_checkout_page "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/checkout.php"
click node_checkout_handler "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/checkout.php"
click node_database "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/db.php"
click node_orders "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/checkout.php"
click node_mail "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/mail.php"
click node_rooms_page "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/rooms.php"
click node_room_booking "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/book-room.php"
click node_shelf "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/shelf.php"
click node_suggestions "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/add-book.php"
click node_assistant "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/assistant.php"
click node_admin "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/admin.php"
click node_admin_actions "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/admin-action.php"
click node_bootstrap "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/bootstrap.php"
click node_auth "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/auth.php"
click node_covers "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/covers.php"
click node_views "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/views.php"
click node_configuration "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/config/config.php"
click node_seed_catalogue "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/tools/catalogue.php"
click node_seed_builder "https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/tools/build-seed.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_home,node_catalogue,node_book,node_reader,node_account,node_sign_in toneBlue
class node_cart,node_checkout_page,node_checkout_handler,node_payment,node_orders toneAmber
class node_rooms_page,node_room_booking,node_shelf,node_suggestions,node_assistant toneMint
class node_admin,node_admin_actions,node_seed_catalogue,node_seed_builder toneRose
class node_database,node_mail,node_bootstrap,node_auth,node_covers,node_views,node_configuration,node_visitor toneIndigo
```

## Components

### Web experience

- [Home page](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/index.php): `booknest/index.php`
- [Book catalogue](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/catalogue.php): `booknest/catalogue.php`
- [Book details](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/book.php): `booknest/book.php`
- [Book reader](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/read.php): `booknest/read.php`
- [Account](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/account.php): `booknest/account.php`
- [Sign in and join](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/sign-in.php): `booknest/sign-in.php`

### Books and commerce

- [Shopping cart](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/cart.php): `booknest/includes/cart.php`
- [Checkout page](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/checkout.php): `booknest/checkout.php`
- [Order processing](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/checkout.php): `booknest/process/checkout.php`
- **Simulated payment**
- [Orders and stock](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/checkout.php): `booknest/process/checkout.php`

### Library services

- [Study rooms](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/rooms.php): `booknest/rooms.php`
- [Room booking actions](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/book-room.php): `booknest/process/book-room.php`
- [Personal shelf](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/shelf.php): `booknest/process/shelf.php`
- [Book suggestions](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/add-book.php): `booknest/add-book.php`
- [Paige assistant](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/assistant.php): `booknest/includes/assistant.php`

### Staff operations

- [Staff dashboard](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/admin.php): `booknest/admin.php`
- [Staff actions](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/process/admin-action.php): `booknest/process/admin-action.php`
- [Seed book catalogue](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/tools/catalogue.php): `booknest/tools/catalogue.php`
- [Seed builder](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/tools/build-seed.php): `booknest/tools/build-seed.php`

### Shared runtime

- [Application database](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/db.php): `booknest/includes/db.php`
- [Confirmation email](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/mail.php): `booknest/includes/mail.php`
- [Application bootstrap](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/bootstrap.php): `booknest/includes/bootstrap.php`
- [Session and access](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/auth.php): `booknest/includes/auth.php`
- [Generated artwork](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/covers.php): `booknest/includes/covers.php`
- [Shared view helpers](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/includes/views.php): `booknest/includes/views.php`
- [Site configuration](https://github.com/vionyp/ie4727-f35-dg14/blob/main/booknest/config/config.php): `booknest/config/config.php`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Home page: opens
- Visitor or member → Book catalogue: browses
- Visitor or member → Book details: opens
- Visitor or member → Checkout page: checks out
- Visitor or member → Study rooms: views rooms
- Home page → Application bootstrap: loads (evidence: `booknest/index.php`)
- Book catalogue → Application bootstrap: loads (evidence: `booknest/catalogue.php`)
- Book details → Application bootstrap: loads (evidence: `booknest/book.php`)
- Account → Application bootstrap: loads (evidence: `booknest/account.php`)
- Sign in and join → Application bootstrap: loads (evidence: `booknest/sign-in.php`)
- Checkout page → Application bootstrap: loads (evidence: `booknest/checkout.php`)
- Study rooms → Application bootstrap: loads (evidence: `booknest/rooms.php`)
- Book reader → Application bootstrap: loads (evidence: `booknest/read.php`)
- Book suggestions → Application bootstrap: loads (evidence: `booknest/add-book.php`)
- Staff dashboard → Application bootstrap: loads (evidence: `booknest/admin.php`)
- Order processing → Application bootstrap: loads (evidence: `booknest/process/checkout.php`)
- Room booking actions → Application bootstrap: loads (evidence: `booknest/process/book-room.php`)
- Personal shelf → Application bootstrap: loads (evidence: `booknest/process/shelf.php`)
- Staff actions → Application bootstrap: loads (evidence: `booknest/process/admin-action.php`)
- Application bootstrap → Site configuration: loads (evidence: `booknest/includes/bootstrap.php`)
- Application bootstrap → Application database: loads (evidence: `booknest/includes/bootstrap.php`)
- Application bootstrap → Session and access: loads (evidence: `booknest/includes/bootstrap.php`)
- Application bootstrap → Generated artwork: loads (evidence: `booknest/includes/bootstrap.php`)
- Application bootstrap → Shared view helpers: loads (evidence: `booknest/includes/bootstrap.php`)
- Order processing → Orders and stock: records order (evidence: `booknest/process/checkout.php`)
- Order processing → Simulated payment: requests outcome (evidence: `booknest/process/checkout.php`)
- Order processing → Confirmation email: sends confirmation (evidence: `booknest/process/checkout.php`)
- Seed builder → Seed book catalogue: loads data (evidence: `booknest/tools/build-seed.php`)
- Seed builder → Generated artwork: uses artwork (evidence: `booknest/tools/build-seed.php`)
