# phypanha/shppingmall architecture

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

## Overview

This is a Spring Boot event-driven shopping mall demo with a React dashboard. A user submits an order through the frontend; the order service publishes an event to Kafka, which the stock and payment services consume. The dashboard also polls order, stock, and payment endpoints for live data. The README documents the event flow, and the sampled frontend shows its requests and gateway links; service internals and gateway routing were not sampled, so those details are kept minimal or marked unverified.

Main entry points: [`gateway-service/src/main/java/com/example/gateway/GatewayServiceApplication.java`](https://github.com/phypanha/shppingmall/blob/main/gateway-service/src/main/java/com/example/gateway/GatewayServiceApplication.java) (Gateway service), [`frontend/src/App.jsx`](https://github.com/phypanha/shppingmall/blob/main/frontend/src/App.jsx) (Shopping dashboard), [`order-service/src/main/java/com/example/orderservice/controller/OrderController.java`](https://github.com/phypanha/shppingmall/blob/main/order-service/src/main/java/com/example/orderservice/controller/OrderController.java) (Order handling), [`stock-service/src/main/java/com/example/stockservice/consumer/OrderConsumer.java`](https://github.com/phypanha/shppingmall/blob/main/stock-service/src/main/java/com/example/stockservice/consumer/OrderConsumer.java) (Stock consumer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_frontend["Shopping dashboard<br/>[App.jsx]"]
end

subgraph group_ordering["Order service"]
  node_order["Order handling"]
end

subgraph group_events["Event processing"]
  node_kafka["Kafka"]
  node_stock["Stock consumer<br/>[OrderConsumer.java]"]
  node_payment["Payment consumer<br/>[OrderConsumer.java]"]
end

subgraph group_edge["API gateway"]
  node_gateway["Gateway service"]
end

node_user(("Mall user"))

node_user -->|"submits order"| node_frontend
node_frontend -->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_order
node_gateway -.->|"routes requests"| node_stock
node_gateway -.->|"routes requests"| node_payment
node_order -->|"publishes event"| node_kafka
node_kafka -->|"delivers event"| node_stock
node_kafka -->|"delivers event"| node_payment

click node_frontend "https://github.com/phypanha/shppingmall/blob/main/frontend/src/App.jsx"
click node_order "https://github.com/phypanha/shppingmall/blob/main/order-service/src/main/java/com/example/orderservice/controller/OrderController.java"
click node_stock "https://github.com/phypanha/shppingmall/blob/main/stock-service/src/main/java/com/example/stockservice/consumer/OrderConsumer.java"
click node_payment "https://github.com/phypanha/shppingmall/blob/main/payment-service/src/main/java/com/example/paymentservice/consumer/OrderConsumer.java"
click node_gateway "https://github.com/phypanha/shppingmall/blob/main/gateway-service/src/main/java/com/example/gateway/GatewayServiceApplication.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_frontend,node_user toneBlue
class node_order toneAmber
class node_kafka,node_stock,node_payment toneMint
class node_gateway toneRose
```

## Components

### User interface

- [Shopping dashboard](https://github.com/phypanha/shppingmall/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Order service

- [Order handling](https://github.com/phypanha/shppingmall/blob/main/order-service/src/main/java/com/example/orderservice/controller/OrderController.java): `order-service/src/main/java/com/example/orderservice/controller/OrderController.java`

### Event processing

- **Kafka**
- [Stock consumer](https://github.com/phypanha/shppingmall/blob/main/stock-service/src/main/java/com/example/stockservice/consumer/OrderConsumer.java): `stock-service/src/main/java/com/example/stockservice/consumer/OrderConsumer.java`
- [Payment consumer](https://github.com/phypanha/shppingmall/blob/main/payment-service/src/main/java/com/example/paymentservice/consumer/OrderConsumer.java): `payment-service/src/main/java/com/example/paymentservice/consumer/OrderConsumer.java`

### API gateway

- [Gateway service](https://github.com/phypanha/shppingmall/blob/main/gateway-service/src/main/java/com/example/gateway/GatewayServiceApplication.java): `gateway-service/src/main/java/com/example/gateway/GatewayServiceApplication.java`

### Other components

- **Mall user**

## Connections

- Mall user → Shopping dashboard: submits order (evidence: `frontend/src/App.jsx`)
- Shopping dashboard → Gateway service: sends requests (evidence: `frontend/src/App.jsx`)
- Gateway service → Order handling: routes requests
- Gateway service → Stock consumer: routes requests
- Gateway service → Payment consumer: routes requests
- Order handling → Kafka: publishes event (evidence: `README.md`)
- Kafka → Stock consumer: delivers event (evidence: `README.md`)
- Kafka → Payment consumer: delivers event (evidence: `README.md`)
