# ash01-forge/uiu-used-textbook-marketplace architecture

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

- Interactive diagram: https://gitdiagram.com/ash01-forge/uiu-used-textbook-marketplace
- Repository: https://github.com/ash01-forge/uiu-used-textbook-marketplace

## Overview

BookBridge is a campus used-textbook marketplace. Its principal workflow is that students browse listings or submit and manage a purchase request; sellers respond and complete the meetup, after which sales and reviews can be tracked. The graph includes the documented guest, buyer, seller, and admin capabilities, plus shared authentication, request protection, response formatting, and database access. The README describes the overall frontend-to-API flow; several endpoint implementations are unsampled, so their detailed internal calls are not inferred.

Main entry points: [`frontend-integration.js`](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/frontend-integration.js) (API-connected behavior), [`config/db.php`](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/config/db.php) (PDO connection), [`api/admin/review-listing.php`](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/admin/review-listing.php) (Moderation and reporting), [`api/auth/login.php`](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/auth/login.php) (Accounts and sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["Marketplace interface<br/>[app.js]"]
  node_auth_ui["Authentication UI<br/>[auth.js]"]
  node_integration["API-connected behavior"]
  node_buyer_ui["Buyer UI<br/>[buyer.js]"]
  node_seller_ui["Seller UI<br/>[seller.js]"]
  node_guest_ui["Guest browsing UI<br/>[guest.js]"]
  node_admin_ui["Admin UI<br/>[admin.js]"]
end

subgraph group_identity["Identity and shared API"]
  node_auth_api["Accounts and sessions<br/>[login.php]"]
  node_auth_helpers["Session and access control<br/>[auth.php]"]
  node_csrf["CSRF protection<br/>[csrf.php]"]
  node_json["JSON request responses<br/>[response.php]"]
end

subgraph group_marketplace["Marketplace and sales"]
  node_catalog["Public catalog and details<br/>[listings.php]"]
  node_listing_common["Catalog query helpers<br/>[_common.php]"]
  node_seller_listings["Seller listings and images<br/>[add-listing.php]"]
end

subgraph group_community["Buyer and seller services"]
  node_purchase["Purchase request lifecycle"]
  node_wishlist["Buyer wishlist<br/>[wishlist.php]"]
  node_messages["Buyer-seller messaging<br/>[send.php]"]
  node_reviews["Seller reviews<br/>[seller-reviews.php]"]
end

subgraph group_operations["Administration and storage"]
  node_admin["Moderation and reporting<br/>[review-listing.php]"]
  node_admin_helpers["Admin validation<br/>[admin.php]"]
  node_sales["Sales and activity reporting<br/>[sales.php]"]
  node_db_access["PDO connection<br/>[db.php]"]
  node_mysql[("MySQL database")]
end

node_student(("Student"))
node_admin_user(("Administrator"))

node_student -->|"uses"| node_app
node_admin_user -->|"uses"| node_admin_ui
node_app -->|"loads"| node_integration
node_auth_ui -.->|"connects through"| node_integration
node_buyer_ui -.->|"connects through"| node_integration
node_seller_ui -.->|"connects through"| node_integration
node_guest_ui -.->|"connects through"| node_integration
node_admin_ui -.->|"connects through"| node_integration
node_integration -->|"requests APIs"| node_auth_api
node_integration -->|"requests APIs"| node_catalog
node_integration -->|"requests APIs"| node_seller_listings
node_integration -->|"requests APIs"| node_purchase
node_integration -->|"requests APIs"| node_wishlist
node_integration -->|"requests APIs"| node_messages
node_integration -->|"requests APIs"| node_reviews
node_integration -->|"requests APIs"| node_admin
node_auth_api -->|"uses sessions"| node_auth_helpers
node_auth_api -->|"uses protection"| node_csrf
node_auth_api -->|"formats responses"| node_json
node_catalog -->|"uses helpers"| node_listing_common
node_listing_common -->|"imports connection"| node_db_access
node_seller_listings -->|"imports connection"| node_db_access
node_purchase -->|"imports connection"| node_db_access
node_wishlist -->|"imports connection"| node_db_access
node_messages -->|"imports connection"| node_db_access
node_reviews -->|"imports connection"| node_db_access
node_admin -->|"uses validation"| node_admin_helpers
node_admin -->|"imports connection"| node_db_access
node_admin -->|"requires token"| node_csrf
node_admin -->|"requires admin role"| node_auth_helpers
node_db_access -->|"opens PDO connection"| node_mysql
node_admin -.->|"uses reporting"| node_sales

click node_app "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/app.js"
click node_auth_ui "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/auth.js"
click node_integration "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/frontend-integration.js"
click node_buyer_ui "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/buyer.js"
click node_seller_ui "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/seller.js"
click node_guest_ui "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/guest.js"
click node_admin_ui "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/admin.js"
click node_auth_api "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/auth/login.php"
click node_auth_helpers "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/auth.php"
click node_csrf "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/csrf.php"
click node_json "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/response.php"
click node_catalog "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/marketplace/listings.php"
click node_listing_common "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/marketplace/_common.php"
click node_seller_listings "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/seller/add-listing.php"
click node_purchase "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/buyer/seller-request-action.php"
click node_wishlist "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/buyer/wishlist.php"
click node_messages "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/messages/send.php"
click node_reviews "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/reviews/seller-reviews.php"
click node_admin "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/admin/review-listing.php"
click node_admin_helpers "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/admin.php"
click node_sales "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/sales.php"
click node_db_access "https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/config/db.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_app,node_auth_ui,node_integration,node_buyer_ui,node_seller_ui,node_guest_ui,node_admin_ui toneBlue
class node_auth_api,node_auth_helpers,node_csrf,node_json toneAmber
class node_catalog,node_listing_common,node_seller_listings toneMint
class node_purchase,node_wishlist,node_messages,node_reviews toneRose
class node_admin,node_admin_helpers,node_sales,node_db_access,node_mysql,node_student,node_admin_user toneIndigo
```

## Components

### Frontend

- [Marketplace interface](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/app.js): `app.js`
- [Authentication UI](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/auth.js): `auth.js`
- [API-connected behavior](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/frontend-integration.js): `frontend-integration.js`
- [Buyer UI](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/buyer.js): `buyer.js`
- [Seller UI](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/seller.js): `seller.js`
- [Guest browsing UI](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/guest.js): `guest.js`
- [Admin UI](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/admin.js): `admin.js`

### Identity and shared API

- [Accounts and sessions](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/auth/login.php): `api/auth/login.php`
- [Session and access control](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/auth.php): `includes/auth.php`
- [CSRF protection](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/csrf.php): `includes/csrf.php`
- [JSON request responses](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/response.php): `includes/response.php`

### Marketplace and sales

- [Public catalog and details](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/marketplace/listings.php): `api/marketplace/listings.php`
- [Catalog query helpers](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/marketplace/_common.php): `api/marketplace/_common.php`
- [Seller listings and images](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/seller/add-listing.php): `api/seller/add-listing.php`

### Buyer and seller services

- [Purchase request lifecycle](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/buyer/seller-request-action.php): `api/buyer/seller-request-action.php`
- [Buyer wishlist](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/buyer/wishlist.php): `api/buyer/wishlist.php`
- [Buyer-seller messaging](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/messages/send.php): `api/messages/send.php`
- [Seller reviews](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/reviews/seller-reviews.php): `api/reviews/seller-reviews.php`

### Administration and storage

- [Moderation and reporting](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/api/admin/review-listing.php): `api/admin/review-listing.php`
- [Admin validation](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/admin.php): `includes/admin.php`
- [Sales and activity reporting](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/includes/sales.php): `includes/sales.php`
- [PDO connection](https://github.com/ash01-forge/uiu-used-textbook-marketplace/blob/main/config/db.php): `config/db.php`
- **MySQL database**

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Marketplace interface: uses (evidence: `README.md`)
- Administrator → Admin UI: uses (evidence: `README.md`)
- Marketplace interface → API-connected behavior: loads (evidence: `README.md`)
- Authentication UI → API-connected behavior: connects through
- Buyer UI → API-connected behavior: connects through
- Seller UI → API-connected behavior: connects through
- Guest browsing UI → API-connected behavior: connects through
- Admin UI → API-connected behavior: connects through
- API-connected behavior → Accounts and sessions: requests APIs (evidence: `README.md`)
- API-connected behavior → Public catalog and details: requests APIs (evidence: `README.md`)
- API-connected behavior → Seller listings and images: requests APIs (evidence: `README.md`)
- API-connected behavior → Purchase request lifecycle: requests APIs (evidence: `README.md`)
- API-connected behavior → Buyer wishlist: requests APIs (evidence: `README.md`)
- API-connected behavior → Buyer-seller messaging: requests APIs (evidence: `README.md`)
- API-connected behavior → Seller reviews: requests APIs (evidence: `README.md`)
- API-connected behavior → Moderation and reporting: requests APIs (evidence: `README.md`)
- Accounts and sessions → Session and access control: uses sessions (evidence: `includes/auth.php`)
- Accounts and sessions → CSRF protection: uses protection (evidence: `includes/csrf.php`)
- Accounts and sessions → JSON request responses: formats responses (evidence: `includes/response.php`)
- Public catalog and details → Catalog query helpers: uses helpers (evidence: `api/marketplace/listings.php`)
- Catalog query helpers → PDO connection: imports connection (evidence: `api/marketplace/_common.php`)
- Seller listings and images → PDO connection: imports connection (evidence: `api/seller/add-listing.php`)
- Purchase request lifecycle → PDO connection: imports connection (evidence: `api/buyer/seller-request-action.php`)
- Buyer wishlist → PDO connection: imports connection (evidence: `api/buyer/wishlist.php`)
- Buyer-seller messaging → PDO connection: imports connection (evidence: `api/messages/send.php`)
- Seller reviews → PDO connection: imports connection (evidence: `api/reviews/seller-reviews.php`)
- Moderation and reporting → Admin validation: uses validation (evidence: `api/admin/review-listing.php`)
- Moderation and reporting → PDO connection: imports connection (evidence: `api/admin/review-listing.php`)
- Moderation and reporting → CSRF protection: requires token (evidence: `api/admin/review-listing.php`)
- Moderation and reporting → Session and access control: requires admin role (evidence: `api/admin/review-listing.php`)
- PDO connection → MySQL database: opens PDO connection (evidence: `config/db.php`)
- Moderation and reporting → Sales and activity reporting: uses reporting
