# redward42/web103_finalproject architecture

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

- Interactive diagram: https://gitdiagram.com/redward42/web103_finalproject
- Repository: https://github.com/redward42/web103_finalproject

## Overview

Borrow Buddy is a community item-sharing app. The main flow is browsing searchable item posts, opening an item, and submitting a borrow request; owners can review requests, whose status can change item availability. Users can also create and edit listings, view profiles, and follow other users. The sampled code shows React routes and Express/PostgreSQL request handling, but several client pages and backend controllers were not excerpted, so some UI-to-API links are left unverified. Reviews and matchmaking are described in the README but have no clear runtime implementation in the provided tree.

Main entry points: [`client/src/App.jsx`](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/App.jsx) (App routing), [`server/server.js`](https://github.com/RedWARd42/web103_finalproject/blob/main/server/server.js) (Express server), [`client/src/pages/ItemDetails.jsx`](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/ItemDetails.jsx) (Item details), [`server/controllers/items.js`](https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/items.js) (Item operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_server["Express server<br/>[server.js]"]
end

subgraph group_listings["Listings"]
  node_browse["Browse listings<br/>[ReadItems.jsx]"]
  node_itemcard["Item cards<br/>[ItemCard.jsx]"]
  node_createitem["Create listing<br/>[CreateItem.jsx]"]
  node_edititem["Edit listing<br/>[EditItem.jsx]"]
  node_itemroutes["Item routes<br/>[items.js]"]
  node_itemcontroller["Item operations<br/>[items.js]"]
end

subgraph group_requests["Borrow requests"]
  node_details["Item details<br/>[ItemDetails.jsx]"]
  node_create_request["Request form<br/>[CreateRequest.jsx]"]
  node_requestcard["Request controls<br/>[RequestCard.jsx]"]
  node_requestroutes["Request routes<br/>[requests.js]"]
  node_requestcontroller["Request operations<br/>[requests.js]"]
end

subgraph group_community["Community"]
  node_profile["User profile<br/>[UserProfile.jsx]"]
  node_followsection["Follow section<br/>[FollowSection.jsx]"]
  node_followbutton["Follow button<br/>[FollowButton.jsx]"]
  node_user_routes["User routes<br/>[users.js]"]
  node_usercontroller["User operations<br/>[users.js]"]
  node_followroutes["Follow routes<br/>[follows.js]"]
  node_followcontroller["Follow operations<br/>[follows.js]"]
end

node_visitor(("Community member"))
node_database[("PostgreSQL pool<br/>[database.js]")]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_createitem
node_app -->|"routes to"| node_edititem
node_app -->|"routes to"| node_details
node_app -->|"routes to"| node_create_request
node_app -->|"routes to"| node_profile
node_browse -->|"renders"| node_itemcard
node_itemcard -->|"links to"| node_details
node_profile -->|"renders"| node_followsection
node_details -->|"renders"| node_requestcard
node_followsection -.->|"uses"| node_followbutton
node_server -->|"mounts"| node_itemroutes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_followroutes
node_server -->|"mounts"| node_requestroutes
node_itemroutes -->|"dispatches"| node_itemcontroller
node_requestroutes -->|"dispatches"| node_requestcontroller
node_user_routes -->|"dispatches"| node_usercontroller
node_followroutes -->|"dispatches"| node_followcontroller
node_itemcontroller -->|"queries"| node_database
node_requestcontroller -->|"queries"| node_database
node_usercontroller -->|"queries"| node_database
node_followcontroller -->|"queries"| node_database
node_details -.->|"calls HTTP"| node_requestcontroller
node_createitem -.->|"calls HTTP"| node_itemcontroller
node_browse -.->|"calls HTTP"| node_itemcontroller
node_profile -.->|"calls HTTP"| node_usercontroller
node_followsection -.->|"calls HTTP"| node_followcontroller

click node_app "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/App.jsx"
click node_browse "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/ReadItems.jsx"
click node_itemcard "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/ItemCard.jsx"
click node_createitem "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/CreateItem.jsx"
click node_edititem "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/EditItem.jsx"
click node_details "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/ItemDetails.jsx"
click node_create_request "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/CreateRequest.jsx"
click node_requestcard "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/RequestCard.jsx"
click node_profile "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/UserProfile.jsx"
click node_followsection "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/FollowSection.jsx"
click node_followbutton "https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/FollowButton.jsx"
click node_itemroutes "https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/items.js"
click node_itemcontroller "https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/items.js"
click node_requestroutes "https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/requests.js"
click node_requestcontroller "https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/requests.js"
click node_user_routes "https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/users.js"
click node_usercontroller "https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/users.js"
click node_followroutes "https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/follows.js"
click node_followcontroller "https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/follows.js"
click node_server "https://github.com/RedWARd42/web103_finalproject/blob/main/server/server.js"
click node_database "https://github.com/RedWARd42/web103_finalproject/blob/main/server/config/database.js"

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_server toneBlue
class node_browse,node_itemcard,node_createitem,node_edititem,node_itemroutes,node_itemcontroller,node_database toneAmber
class node_details,node_create_request,node_requestcard,node_requestroutes,node_requestcontroller toneMint
class node_profile,node_followsection,node_followbutton,node_user_routes,node_usercontroller,node_followroutes,node_followcontroller toneRose
class node_visitor toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Express server](https://github.com/RedWARd42/web103_finalproject/blob/main/server/server.js): `server/server.js`

### Listings

- [Browse listings](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/ReadItems.jsx): `client/src/pages/ReadItems.jsx`
- [Item cards](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/ItemCard.jsx): `client/src/components/ItemCard.jsx`
- [Create listing](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/CreateItem.jsx): `client/src/pages/CreateItem.jsx`
- [Edit listing](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/EditItem.jsx): `client/src/pages/EditItem.jsx`
- [Item routes](https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/items.js): `server/routes/items.js`
- [Item operations](https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/items.js): `server/controllers/items.js`

### Borrow requests

- [Item details](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/ItemDetails.jsx): `client/src/pages/ItemDetails.jsx`
- [Request form](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/CreateRequest.jsx): `client/src/pages/CreateRequest.jsx`
- [Request controls](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/RequestCard.jsx): `client/src/components/RequestCard.jsx`
- [Request routes](https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/requests.js): `server/routes/requests.js`
- [Request operations](https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/requests.js): `server/controllers/requests.js`

### Community

- [User profile](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/pages/UserProfile.jsx): `client/src/pages/UserProfile.jsx`
- [Follow section](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/FollowSection.jsx): `client/src/components/FollowSection.jsx`
- [Follow button](https://github.com/RedWARd42/web103_finalproject/blob/main/client/src/components/FollowButton.jsx): `client/src/components/FollowButton.jsx`
- [User routes](https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/users.js): `server/routes/users.js`
- [User operations](https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/users.js): `server/controllers/users.js`
- [Follow routes](https://github.com/RedWARd42/web103_finalproject/blob/main/server/routes/follows.js): `server/routes/follows.js`
- [Follow operations](https://github.com/RedWARd42/web103_finalproject/blob/main/server/controllers/follows.js): `server/controllers/follows.js`

### Other components

- **Community member**
- [PostgreSQL pool](https://github.com/RedWARd42/web103_finalproject/blob/main/server/config/database.js): `server/config/database.js`

## Connections

- Community member → App routing: uses
- App routing → Browse listings: routes to (evidence: `client/src/App.jsx`)
- App routing → Create listing: routes to (evidence: `client/src/App.jsx`)
- App routing → Edit listing: routes to (evidence: `client/src/App.jsx`)
- App routing → Item details: routes to (evidence: `client/src/App.jsx`)
- App routing → Request form: routes to (evidence: `client/src/App.jsx`)
- App routing → User profile: routes to (evidence: `client/src/App.jsx`)
- Browse listings → Item cards: renders (evidence: `client/src/pages/ReadItems.jsx`)
- Item cards → Item details: links to (evidence: `client/src/components/ItemCard.jsx`)
- User profile → Follow section: renders (evidence: `client/src/pages/UserProfile.jsx`)
- Item details → Request controls: renders (evidence: `client/src/pages/ItemDetails.jsx`)
- Follow section → Follow button: uses
- Express server → Item routes: mounts (evidence: `server/server.js`)
- Express server → User routes: mounts (evidence: `server/server.js`)
- Express server → Follow routes: mounts (evidence: `server/server.js`)
- Express server → Request routes: mounts (evidence: `server/server.js`)
- Item routes → Item operations: dispatches (evidence: `server/routes/items.js`)
- Request routes → Request operations: dispatches (evidence: `server/routes/requests.js`)
- User routes → User operations: dispatches (evidence: `server/routes/users.js`)
- Follow routes → Follow operations: dispatches (evidence: `server/routes/follows.js`)
- Item operations → PostgreSQL pool: queries (evidence: `server/controllers/items.js`)
- Request operations → PostgreSQL pool: queries (evidence: `server/controllers/requests.js`)
- User operations → PostgreSQL pool: queries (evidence: `server/controllers/users.js`)
- Follow operations → PostgreSQL pool: queries (evidence: `server/controllers/follows.js`)
- Item details → Request operations: calls HTTP
- Create listing → Item operations: calls HTTP
- Browse listings → Item operations: calls HTTP
- User profile → User operations: calls HTTP
- Follow section → Follow operations: calls HTTP
