# jiraenoone/jino-cafe-shop architecture

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

- Interactive diagram: https://gitdiagram.com/jiraenoone/jino-cafe-shop
- Repository: https://github.com/jiraenoone/jino-cafe-shop

## Overview

Jino Café is a café ordering web application. Customers browse categories and products, add items to a cart, and submit an order; the frontend calls the FastAPI REST API, which validates product availability, calculates totals, saves the order, and publishes an asynchronous message for a worker. The backend also exposes category/product and order-management routes. The README documents Azure SQL and Service Bus integrations; sampled source confirms the order-service publishing call, but worker message-consumption details were not sampled.

Main entry points: [`backend/app/main.py`](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/main.py) (FastAPI Application), [`backend/app/services/order_service.py`](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/services/order_service.py) (Order Service), [`frontend/js/menu.js`](https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/menu.js) (Menu Browser), [`backend/app/api/routes/products.py`](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/products.py) (Product Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer Web"]
  node_menu["Menu Browser<br/>[menu.js]"]
  node_cart["Shopping Cart<br/>[cart.js]"]
  node_webapi["Frontend API Client<br/>[api.js]"]
end

subgraph group_api["API and Domain"]
  node_apiapp["FastAPI Application<br/>[main.py]"]
  node_category_routes["Category Routes<br/>[categories.py]"]
  node_product_routes["Product Routes<br/>[products.py]"]
  node_order_routes["Order Routes<br/>[orders.py]"]
  node_order_service["Order Service<br/>[order_service.py]"]
end

subgraph group_data["Persistence"]
  node_category_repo["Category Repository"]
  node_product_repo["Product Repository"]
  node_order_repo["Order Repository"]
  node_db_session["Database Sessions<br/>[connection.py]"]
  node_sql_db[("SQL Database<br/>[schema.sql]")]
end

subgraph group_async["Async Processing"]
  node_publisher["Order Publisher<br/>[publisher.py]"]
  node_service_bus["Azure Service Bus"]
  node_worker["Background Worker<br/>[main.py]"]
end

node_customer(("Customer"))

node_customer -->|"browses"| node_menu
node_menu -->|"adds items"| node_cart
node_menu -.->|"loads catalog"| node_webapi
node_cart -.->|"submits order"| node_webapi
node_webapi -->|"calls REST"| node_apiapp
node_apiapp -->|"routes requests"| node_category_routes
node_apiapp -->|"routes requests"| node_product_routes
node_apiapp -->|"routes requests"| node_order_routes
node_category_routes -->|"queries categories"| node_category_repo
node_product_routes -->|"queries products"| node_product_repo
node_product_routes -->|"queries categories"| node_category_repo
node_order_routes -->|"creates orders"| node_order_service
node_order_routes -->|"queries orders"| node_order_repo
node_order_service -->|"checks products"| node_product_repo
node_order_service -->|"saves order"| node_order_repo
node_category_repo -->|"reads and writes"| node_sql_db
node_product_repo -->|"reads and writes"| node_sql_db
node_order_repo -->|"reads and writes"| node_sql_db
node_order_service -->|"publishes order"| node_publisher
node_publisher -->|"sends message"| node_service_bus
node_service_bus -->|"delivers message"| node_worker

click node_menu "https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/menu.js"
click node_cart "https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/cart.js"
click node_webapi "https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/api.js"
click node_apiapp "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/main.py"
click node_category_routes "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/categories.py"
click node_product_routes "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/products.py"
click node_order_routes "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/orders.py"
click node_order_service "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/services/order_service.py"
click node_category_repo "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/category_repository.py"
click node_product_repo "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/product_repository.py"
click node_order_repo "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/order_repository.py"
click node_db_session "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/database/connection.py"
click node_sql_db "https://github.com/jiraenoone/jino-cafe-shop/blob/main/database/schema.sql"
click node_publisher "https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/messaging/publisher.py"
click node_worker "https://github.com/jiraenoone/jino-cafe-shop/blob/main/worker/app/main.py"

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_menu,node_cart,node_webapi toneBlue
class node_apiapp,node_category_routes,node_product_routes,node_order_routes,node_order_service toneAmber
class node_category_repo,node_product_repo,node_order_repo,node_db_session,node_sql_db toneMint
class node_publisher,node_service_bus,node_worker toneRose
class node_customer toneIndigo
```

## Components

### Customer Web

- [Menu Browser](https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/menu.js): `frontend/js/menu.js`
- [Shopping Cart](https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/cart.js): `frontend/js/cart.js`
- [Frontend API Client](https://github.com/jiraenoone/jino-cafe-shop/blob/main/frontend/js/api.js): `frontend/js/api.js`

### API and Domain

- [FastAPI Application](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/main.py): `backend/app/main.py`
- [Category Routes](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/categories.py): `backend/app/api/routes/categories.py`
- [Product Routes](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/products.py): `backend/app/api/routes/products.py`
- [Order Routes](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/api/routes/orders.py): `backend/app/api/routes/orders.py`
- [Order Service](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/services/order_service.py): `backend/app/services/order_service.py`

### Persistence

- [Category Repository](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/category_repository.py): `backend/app/repositories/category_repository.py`
- [Product Repository](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/product_repository.py): `backend/app/repositories/product_repository.py`
- [Order Repository](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/repositories/order_repository.py): `backend/app/repositories/order_repository.py`
- [Database Sessions](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/database/connection.py): `backend/app/database/connection.py`
- [SQL Database](https://github.com/jiraenoone/jino-cafe-shop/blob/main/database/schema.sql): `database/schema.sql`

### Async Processing

- [Order Publisher](https://github.com/jiraenoone/jino-cafe-shop/blob/main/backend/app/messaging/publisher.py): `backend/app/messaging/publisher.py`
- **Azure Service Bus**
- [Background Worker](https://github.com/jiraenoone/jino-cafe-shop/blob/main/worker/app/main.py): `worker/app/main.py`

### Other components

- **Customer**

## Connections

- Customer → Menu Browser: browses (evidence: `README.md`)
- Menu Browser → Shopping Cart: adds items (evidence: `README.md`)
- Menu Browser → Frontend API Client: loads catalog
- Shopping Cart → Frontend API Client: submits order
- Frontend API Client → FastAPI Application: calls REST (evidence: `README.md`)
- FastAPI Application → Category Routes: routes requests (evidence: `backend/app/main.py`)
- FastAPI Application → Product Routes: routes requests (evidence: `backend/app/main.py`)
- FastAPI Application → Order Routes: routes requests (evidence: `backend/app/main.py`)
- Category Routes → Category Repository: queries categories (evidence: `backend/app/api/routes/categories.py`)
- Product Routes → Product Repository: queries products (evidence: `backend/app/api/routes/products.py`)
- Product Routes → Category Repository: queries categories (evidence: `backend/app/api/routes/products.py`)
- Order Routes → Order Service: creates orders (evidence: `backend/app/api/routes/orders.py`)
- Order Routes → Order Repository: queries orders (evidence: `backend/app/api/routes/orders.py`)
- Order Service → Product Repository: checks products (evidence: `backend/app/services/order_service.py`)
- Order Service → Order Repository: saves order (evidence: `backend/app/services/order_service.py`)
- Category Repository → SQL Database: reads and writes (evidence: `backend/app/repositories/category_repository.py`)
- Product Repository → SQL Database: reads and writes (evidence: `backend/app/repositories/product_repository.py`)
- Order Repository → SQL Database: reads and writes (evidence: `backend/app/repositories/order_repository.py`)
- Order Service → Order Publisher: publishes order (evidence: `backend/app/services/order_service.py`)
- Order Publisher → Azure Service Bus: sends message (evidence: `README.md`)
- Azure Service Bus → Background Worker: delivers message (evidence: `README.md`)
