# hoangtuanqn/market-link architecture

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

- Interactive diagram: https://gitdiagram.com/hoangtuanqn/market-link
- Repository: https://github.com/hoangtuanqn/market-link

## Overview

MarketLink is a pre-order marketplace for Ho Chi Minh City weekend farmers’ markets. Customers browse markets and produce, reserve pickup slots, and receive separate orders for each farmer; farmers process those orders through pickup completion, after which customers can review them. The README also documents near-expiry deals, stall chat, a Claude shopping assistant, farmer approvals, and admin moderation. The graph follows these capabilities at subsystem level; most backend feature paths are represented by their exact enclosing directories because their implementation files were not sampled.

Main entry points: [`frontend/src/App.tsx`](https://github.com/hoangtuanqn/market-link/blob/main/frontend/src/App.tsx) (MarketLink web app), [`backend/src/main/java/com/techx/intervue/modules/order/services/impl/OrderService.java`](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/order/services/impl/OrderService.java) (Order lifecycle), [`backend/src/main/java/com/techx/intervue/modules/farmer`](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/farmer) (Farmer stall and stock), [`backend/src/main/java/com/techx/intervue/IntervueApplication.java`](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/IntervueApplication.java) (Spring API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Browse and discover"]
  node_catalog["Markets and catalog"]
  node_stall["Stall schedules"]
  node_products["Product search"]
  node_deals["Near-expiry deals"]
end

subgraph group_orders["Reservation and pickup"]
  node_cart["Cart and checkout"]
  node_orderservice["Order lifecycle<br/>[OrderService.java]"]
  node_stock["Stock availability"]
end

subgraph group_seller["Farmer operations"]
  node_farmerops["Farmer stall and stock"]
  node_quality["Shelf life and quality"]
  node_achievements["Farmer achievements"]
end

subgraph group_trust["Trust and engagement"]
  node_reviews["Reviews and ratings<br/>[ReviewService.java]"]
  node_chat["Customer chat"]
  node_assistant["Shopping assistant<br/>[ChatService.java]"]
end

subgraph group_platform["Platform services"]
  node_web["MarketLink web app<br/>[App.tsx]"]
  node_adminops["Approvals and moderation"]
  node_api["Spring API"]
  node_mysql[("MySQL")]
end

node_customer(("Customer"))
node_farmer(("Farmer"))
node_admin(("Administrator"))
node_claude["Anthropic Claude"]

node_customer -->|"browses and orders"| node_web
node_farmer -->|"manages stall"| node_web
node_admin -->|"administers platform"| node_web
node_web -->|"browses markets"| node_catalog
node_web -->|"searches products"| node_products
node_web -->|"views deals"| node_deals
node_web -->|"submits cart"| node_cart
node_cart -->|"creates orders"| node_orderservice
node_orderservice -->|"reserves stock"| node_stock
node_orderservice -->|"routes farmer orders"| node_farmerops
node_farmerops -->|"updates order status"| node_orderservice
node_farmerops -->|"sets pickup slots"| node_stall
node_products -->|"reads stall detail"| node_stall
node_deals -->|"checks orderable dates"| node_stall
node_web -->|"writes reviews"| node_reviews
node_orderservice -->|"enables completed-order reviews"| node_reviews
node_web -->|"chats with stall"| node_chat
node_web -->|"asks shopping questions"| node_assistant
node_assistant -.->|"queries assistant"| node_claude
node_web -->|"views achievements"| node_achievements
node_admin -->|"approves and moderates"| node_adminops
node_web -->|"calls REST API"| node_api
node_web -->|"uses chat WebSocket"| node_api
node_api -->|"persists marketplace data"| node_mysql
node_farmerops -->|"manages shelf-life rules"| node_quality

click node_web "https://github.com/hoangtuanqn/market-link/blob/main/frontend/src/App.tsx"
click node_catalog "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/catalog"
click node_stall "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/stall"
click node_products "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductQueryService.java"
click node_deals "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/DealQueryService.java"
click node_cart "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/order"
click node_orderservice "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/order/services/impl/OrderService.java"
click node_stock "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductAvailabilityResolver.java"
click node_farmerops "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/farmer"
click node_quality "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/quality"
click node_reviews "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/review/services/impl/ReviewService.java"
click node_chat "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/conversation"
click node_assistant "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/chat/services/impl/ChatService.java"
click node_achievements "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/achievement"
click node_adminops "https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/farmer"
click node_api "https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/IntervueApplication.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_catalog,node_stall,node_products,node_deals toneBlue
class node_cart,node_orderservice,node_stock toneAmber
class node_farmerops,node_quality,node_achievements toneMint
class node_reviews,node_chat,node_assistant toneRose
class node_web,node_adminops,node_api,node_mysql,node_customer,node_farmer,node_admin,node_claude toneIndigo
```

## Components

### Browse and discover

- [Markets and catalog](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/catalog): `backend/src/main/java/com/techx/intervue/modules/catalog`
- [Stall schedules](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/stall): `backend/src/main/java/com/techx/intervue/modules/stall`
- [Product search](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductQueryService.java): `backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductQueryService.java`
- [Near-expiry deals](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/DealQueryService.java): `backend/src/main/java/com/techx/intervue/modules/product/services/impl/DealQueryService.java`

### Reservation and pickup

- [Cart and checkout](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/order): `backend/src/main/java/com/techx/intervue/modules/order`
- [Order lifecycle](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/order/services/impl/OrderService.java): `backend/src/main/java/com/techx/intervue/modules/order/services/impl/OrderService.java`
- [Stock availability](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductAvailabilityResolver.java): `backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductAvailabilityResolver.java`

### Farmer operations

- [Farmer stall and stock](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/farmer): `backend/src/main/java/com/techx/intervue/modules/farmer`
- [Shelf life and quality](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/quality): `backend/src/main/java/com/techx/intervue/modules/quality`
- [Farmer achievements](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/achievement): `backend/src/main/java/com/techx/intervue/modules/achievement`

### Trust and engagement

- [Reviews and ratings](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/review/services/impl/ReviewService.java): `backend/src/main/java/com/techx/intervue/modules/review/services/impl/ReviewService.java`
- [Customer chat](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/conversation): `backend/src/main/java/com/techx/intervue/modules/conversation`
- [Shopping assistant](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/modules/chat/services/impl/ChatService.java): `backend/src/main/java/com/techx/intervue/modules/chat/services/impl/ChatService.java`

### Platform services

- [MarketLink web app](https://github.com/hoangtuanqn/market-link/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Approvals and moderation](https://github.com/hoangtuanqn/market-link/tree/main/backend/src/main/java/com/techx/intervue/modules/farmer): `backend/src/main/java/com/techx/intervue/modules/farmer`
- [Spring API](https://github.com/hoangtuanqn/market-link/blob/main/backend/src/main/java/com/techx/intervue/IntervueApplication.java): `backend/src/main/java/com/techx/intervue/IntervueApplication.java`
- **MySQL**

### Other components

- **Customer**
- **Farmer**
- **Administrator**
- **Anthropic Claude**

## Connections

- Customer → MarketLink web app: browses and orders
- Farmer → MarketLink web app: manages stall
- Administrator → MarketLink web app: administers platform
- MarketLink web app → Markets and catalog: browses markets
- MarketLink web app → Product search: searches products
- MarketLink web app → Near-expiry deals: views deals
- MarketLink web app → Cart and checkout: submits cart
- Cart and checkout → Order lifecycle: creates orders
- Order lifecycle → Stock availability: reserves stock
- Order lifecycle → Farmer stall and stock: routes farmer orders
- Farmer stall and stock → Order lifecycle: updates order status
- Farmer stall and stock → Stall schedules: sets pickup slots
- Product search → Stall schedules: reads stall detail (evidence: `backend/src/main/java/com/techx/intervue/modules/product/services/impl/ProductQueryService.java`)
- Near-expiry deals → Stall schedules: checks orderable dates (evidence: `backend/src/main/java/com/techx/intervue/modules/product/services/impl/DealQueryService.java`)
- MarketLink web app → Reviews and ratings: writes reviews
- Order lifecycle → Reviews and ratings: enables completed-order reviews
- MarketLink web app → Customer chat: chats with stall
- MarketLink web app → Shopping assistant: asks shopping questions
- Shopping assistant → Anthropic Claude: queries assistant
- MarketLink web app → Farmer achievements: views achievements
- Administrator → Approvals and moderation: approves and moderates
- MarketLink web app → Spring API: calls REST API
- MarketLink web app → Spring API: uses chat WebSocket
- Spring API → MySQL: persists marketplace data
- Farmer stall and stock → Shelf life and quality: manages shelf-life rules
