# xtiwby/softengineer_group_project architecture

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

## Overview

CampusMarket is a campus peer-to-peer marketplace. Students browse campus-filtered listings, publish items or purchase requests, and can pursue exchanges; authentication and social features support that activity. The graph separates the Vue client, listing and request handling, transaction flows, and account/community features. Read excerpts show item and purchase controller calls and the authentication implementation; several other feature branches are included from the source tree, but their runtime wiring is not shown, so those links are dashed and unevidenced.

Main entry points: [`CampusMarket/frontend/src/views/ItemDetail.vue`](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/ItemDetail.vue) (Item details), [`CampusMarket/frontend/src/api/item.js`](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/api/item.js) (Item API client), [`CampusMarket/frontend/src/App.vue`](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/App.vue) (Vue application), [`CampusMarket/frontend/src/views/Home.vue`](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Home.vue) (Marketplace browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Vue application<br/>[App.vue]"]
  node_authstore["Auth state<br/>[auth.js]"]
  node_home["Marketplace browsing<br/>[Home.vue]"]
  node_detail["Item details<br/>[ItemDetail.vue]"]
  node_shelf["My listings<br/>[MyShelf.vue]"]
  node_wishlist["Wishlist<br/>[Wishlist.vue]"]
  node_publishitem["Publish item<br/>[PublishItem.vue]"]
  node_publishpurchase["Publish request"]
  node_itemapi["Item API client<br/>[item.js]"]
  node_exchangeview["Exchange history"]
  node_loginview["Login and registration<br/>[Login.vue]"]
end

subgraph group_market["Listings and requests"]
  node_itemcontroller["Item endpoints"]
  node_itemservice["Item operations<br/>[ItemService.java]"]
  node_itemdata[("Item records<br/>[Item.java]")]
  node_purchasecontroller["Purchase endpoints"]
  node_purchaseservice["Purchase operations"]
  node_purchasedata[("Purchase records<br/>[Purchase.java]")]
end

subgraph group_transactions["Transactions"]
  node_exchangecontroller["Exchange endpoints"]
  node_exchangeservice["Exchange operations"]
  node_exchangeimpl["Exchange processing"]
  node_exchangehistory[("Exchange records")]
end

subgraph group_community["Accounts and community"]
  node_authcontroller["Authentication endpoints"]
  node_authimpl["Authentication logic"]
  node_userdata[("User records<br/>[User.java]")]
  node_favorites["Favorites"]
  node_messages["Messaging"]
  node_matching["Matching"]
  node_userprofile["User profile"]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"reads state"| node_authstore
node_app -.->|"routes to"| node_home
node_student -.->|"browses"| node_home
node_home -->|"requests listings"| node_itemapi
node_detail -->|"loads item"| node_itemapi
node_shelf -.->|"manages listings"| node_itemapi
node_publishitem -.->|"publishes item"| node_itemapi
node_itemapi -->|"calls API"| node_itemcontroller
node_itemcontroller -->|"delegates"| node_itemservice
node_itemservice -.->|"manages records"| node_itemdata
node_publishpurchase -.->|"submits request"| node_purchasecontroller
node_purchasecontroller -->|"delegates"| node_purchaseservice
node_purchaseservice -.->|"manages records"| node_purchasedata
node_detail -.->|"starts exchange"| node_exchangecontroller
node_exchangeview -.->|"loads history"| node_exchangecontroller
node_exchangecontroller -->|"delegates"| node_exchangeservice
node_exchangeservice -.->|"implemented by"| node_exchangeimpl
node_exchangeimpl -->|"writes history"| node_exchangehistory
node_loginview -.->|"authenticates"| node_authcontroller
node_authcontroller -.->|"delegates"| node_authimpl
node_authimpl -->|"reads and writes"| node_userdata
node_authstore -.->|"stores session"| node_loginview
node_detail -.->|"manages favorites"| node_favorites
node_detail -.->|"starts messaging"| node_messages
node_detail -.->|"requests matches"| node_matching
node_student -.->|"manages profile"| node_userprofile

click node_app "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/App.vue"
click node_authstore "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/stores/auth.js"
click node_home "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Home.vue"
click node_detail "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/ItemDetail.vue"
click node_shelf "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/MyShelf.vue"
click node_wishlist "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Wishlist.vue"
click node_publishitem "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/PublishItem.vue"
click node_publishpurchase "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/PublishPurchase.vue"
click node_itemapi "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/api/item.js"
click node_itemcontroller "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/ItemController.java"
click node_itemservice "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/ItemService.java"
click node_itemdata "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/Item.java"
click node_purchasecontroller "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/PurchaseController.java"
click node_purchaseservice "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/PurchaseService.java"
click node_purchasedata "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/Purchase.java"
click node_exchangeview "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/ExchangeHistory.vue"
click node_exchangecontroller "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/ExchangeController.java"
click node_exchangeservice "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/ExchangeService.java"
click node_exchangeimpl "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/impl/ExchangeServiceImpl.java"
click node_exchangehistory "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/ExchangeHistory.java"
click node_loginview "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Login.vue"
click node_authcontroller "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/AuthController.java"
click node_authimpl "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/impl/AuthServiceImpl.java"
click node_userdata "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/User.java"
click node_favorites "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/FavoriteController.java"
click node_messages "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/MessageController.java"
click node_matching "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/MatchController.java"
click node_userprofile "https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/UserController.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_app,node_authstore,node_home,node_detail,node_shelf,node_wishlist,node_publishitem,node_publishpurchase,node_itemapi,node_exchangeview,node_loginview toneBlue
class node_itemcontroller,node_itemservice,node_itemdata,node_purchasecontroller,node_purchaseservice,node_purchasedata toneAmber
class node_exchangecontroller,node_exchangeservice,node_exchangeimpl,node_exchangehistory toneMint
class node_authcontroller,node_authimpl,node_userdata,node_favorites,node_messages,node_matching,node_userprofile toneRose
class node_student toneIndigo
```

## Components

### Web client

- [Vue application](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/App.vue): `CampusMarket/frontend/src/App.vue`
- [Auth state](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/stores/auth.js): `CampusMarket/frontend/src/stores/auth.js`
- [Marketplace browsing](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Home.vue): `CampusMarket/frontend/src/views/Home.vue`
- [Item details](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/ItemDetail.vue): `CampusMarket/frontend/src/views/ItemDetail.vue`
- [My listings](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/MyShelf.vue): `CampusMarket/frontend/src/views/MyShelf.vue`
- [Wishlist](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Wishlist.vue): `CampusMarket/frontend/src/views/Wishlist.vue`
- [Publish item](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/PublishItem.vue): `CampusMarket/frontend/src/views/PublishItem.vue`
- [Publish request](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/PublishPurchase.vue): `CampusMarket/frontend/src/views/PublishPurchase.vue`
- [Item API client](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/api/item.js): `CampusMarket/frontend/src/api/item.js`
- [Exchange history](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/ExchangeHistory.vue): `CampusMarket/frontend/src/views/ExchangeHistory.vue`
- [Login and registration](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/frontend/src/views/Login.vue): `CampusMarket/frontend/src/views/Login.vue`

### Listings and requests

- [Item endpoints](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/ItemController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/ItemController.java`
- [Item operations](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/ItemService.java): `CampusMarket/backend/src/main/java/com/campusmarket/service/ItemService.java`
- [Item records](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/Item.java): `CampusMarket/backend/src/main/java/com/campusmarket/entity/Item.java`
- [Purchase endpoints](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/PurchaseController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/PurchaseController.java`
- [Purchase operations](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/PurchaseService.java): `CampusMarket/backend/src/main/java/com/campusmarket/service/PurchaseService.java`
- [Purchase records](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/Purchase.java): `CampusMarket/backend/src/main/java/com/campusmarket/entity/Purchase.java`

### Transactions

- [Exchange endpoints](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/ExchangeController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/ExchangeController.java`
- [Exchange operations](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/ExchangeService.java): `CampusMarket/backend/src/main/java/com/campusmarket/service/ExchangeService.java`
- [Exchange processing](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/impl/ExchangeServiceImpl.java): `CampusMarket/backend/src/main/java/com/campusmarket/service/impl/ExchangeServiceImpl.java`
- [Exchange records](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/ExchangeHistory.java): `CampusMarket/backend/src/main/java/com/campusmarket/entity/ExchangeHistory.java`

### Accounts and community

- [Authentication endpoints](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/AuthController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/AuthController.java`
- [Authentication logic](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/service/impl/AuthServiceImpl.java): `CampusMarket/backend/src/main/java/com/campusmarket/service/impl/AuthServiceImpl.java`
- [User records](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/entity/User.java): `CampusMarket/backend/src/main/java/com/campusmarket/entity/User.java`
- [Favorites](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/FavoriteController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/FavoriteController.java`
- [Messaging](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/MessageController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/MessageController.java`
- [Matching](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/MatchController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/MatchController.java`
- [User profile](https://github.com/xtiwby/softengineer_group_project/blob/main/CampusMarket/backend/src/main/java/com/campusmarket/controller/UserController.java): `CampusMarket/backend/src/main/java/com/campusmarket/controller/UserController.java`

### Other components

- **Student**

## Connections

- Student → Vue application: uses
- Vue application → Auth state: reads state (evidence: `CampusMarket/frontend/src/App.vue`)
- Vue application → Marketplace browsing: routes to
- Student → Marketplace browsing: browses
- Marketplace browsing → Item API client: requests listings (evidence: `CampusMarket/frontend/src/views/Home.vue`)
- Item details → Item API client: loads item (evidence: `CampusMarket/frontend/src/views/ItemDetail.vue`)
- My listings → Item API client: manages listings
- Publish item → Item API client: publishes item
- Item API client → Item endpoints: calls API (evidence: `CampusMarket/frontend/src/api/item.js`)
- Item endpoints → Item operations: delegates (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/controller/ItemController.java`)
- Item operations → Item records: manages records (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/service/ItemService.java`)
- Publish request → Purchase endpoints: submits request
- Purchase endpoints → Purchase operations: delegates (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/controller/PurchaseController.java`)
- Purchase operations → Purchase records: manages records (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/service/PurchaseService.java`)
- Item details → Exchange endpoints: starts exchange
- Exchange history → Exchange endpoints: loads history
- Exchange endpoints → Exchange operations: delegates (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/controller/ExchangeController.java`)
- Exchange operations → Exchange processing: implemented by (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/service/impl/ExchangeServiceImpl.java`)
- Exchange processing → Exchange records: writes history (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/service/impl/ExchangeServiceImpl.java`)
- Login and registration → Authentication endpoints: authenticates
- Authentication endpoints → Authentication logic: delegates
- Authentication logic → User records: reads and writes (evidence: `CampusMarket/backend/src/main/java/com/campusmarket/service/impl/AuthServiceImpl.java`)
- Auth state → Login and registration: stores session
- Item details → Favorites: manages favorites
- Item details → Messaging: starts messaging
- Item details → Matching: requests matches
- Student → User profile: manages profile
