# hendragunadie/sakurasushi architecture

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

- Interactive diagram: https://gitdiagram.com/hendragunadie/sakurasushi
- Repository: https://github.com/hendragunadie/sakurasushi

## Overview

SushiWebAPI is a restaurant point-of-sale API for staff workflows: open a table transaction, manage its cart and orders, track item preparation, and take payment. Controllers use SushiContext to read and persist the workflow’s state; the model layer represents menu, table, transaction, cart, and order data. The supplied excerpts establish cart and transaction persistence and SQL Server configuration. Auth and menu endpoints appear in the source index, but their implementation details were not excerpted, so their specific behavior and links are not asserted.

Main entry points: [`SushiWebAPI/Data/SushiContext.cs`](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Data/SushiContext.cs) (EF data context), [`SushiWebAPI/Controller/CartController.cs`](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/CartController.cs) (Cart endpoints), [`SushiWebAPI/Controller/TransactionController.cs`](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/TransactionController.cs) (Transaction endpoints), [`SushiWebAPI/Models/Order.cs`](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Order.cs) (Order)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_menu_api["Menu endpoints<br/>[ItemController.cs]"]
  node_cart_api["Cart endpoints<br/>[CartController.cs]"]
  node_transaction_api["Transaction endpoints"]
  node_helper["Response helpers<br/>[Helper.cs]"]
end

subgraph group_workflow["Sales workflow"]
  node_cart_item["Cart item<br/>[CartItem.cs]"]
  node_transaction["Transaction<br/>[Transaction.cs]"]
  node_order["Order<br/>[Order.cs]"]
  node_order_item["Order item<br/>[OrderItem.cs]"]
  node_table["Dining table<br/>[Table.cs]"]
end

subgraph group_catalog["Menu and identity"]
  node_item["Menu item<br/>[Item.cs]"]
  node_category["Menu category<br/>[Category.cs]"]
  node_user["Staff user<br/>[User.cs]"]
end

subgraph group_persistence["Persistence"]
  node_context["EF data context<br/>[SushiContext.cs]"]
  node_sql[("SQL Server")]
end

node_staff(("Restaurant staff"))
node_customer(("API client"))

node_staff -.->|"requests access"| node_auth
node_customer -.->|"requests menu"| node_menu_api
node_customer -.->|"manages cart"| node_cart_api
node_staff -.->|"handles transactions"| node_transaction_api
node_cart_api -->|"reads and writes"| node_context
node_transaction_api -->|"reads and writes"| node_context
node_context -->|"configures connection"| node_sql
node_context -->|"maps"| node_cart_item
node_context -->|"maps"| node_category
node_context -->|"maps"| node_item
node_context -->|"maps"| node_order
node_context -->|"maps"| node_order_item
node_context -->|"maps"| node_table
node_context -->|"maps"| node_transaction
node_context -->|"maps"| node_user
node_cart_api -->|"formats responses"| node_helper
node_transaction_api -->|"formats responses"| node_helper
node_cart_api -->|"looks up menu item"| node_item
node_cart_api -->|"looks up transaction"| node_transaction
node_cart_api -->|"creates order"| node_order
node_cart_api -->|"creates order line"| node_order_item
node_transaction_api -->|"looks up table"| node_table
node_transaction_api -->|"reads order totals"| node_order
node_transaction_api -->|"updates status"| node_order_item
node_transaction_api -->|"reads staff claim"| node_user

click node_auth "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/AuthController.cs"
click node_menu_api "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/ItemController.cs"
click node_cart_api "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/CartController.cs"
click node_transaction_api "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/TransactionController.cs"
click node_helper "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Helper.cs"
click node_cart_item "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/CartItem.cs"
click node_transaction "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Transaction.cs"
click node_order "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Order.cs"
click node_order_item "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/OrderItem.cs"
click node_table "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Table.cs"
click node_item "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Item.cs"
click node_category "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Category.cs"
click node_user "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/User.cs"
click node_context "https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Data/SushiContext.cs"

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_auth,node_menu_api,node_cart_api,node_transaction_api,node_helper,node_customer toneBlue
class node_cart_item,node_transaction,node_order,node_order_item,node_table toneAmber
class node_item,node_category,node_user toneMint
class node_context,node_sql toneRose
class node_staff toneIndigo
```

## Components

### API endpoints

- [Authentication](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/AuthController.cs): `SushiWebAPI/Controller/AuthController.cs`
- [Menu endpoints](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/ItemController.cs): `SushiWebAPI/Controller/ItemController.cs`
- [Cart endpoints](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/CartController.cs): `SushiWebAPI/Controller/CartController.cs`
- [Transaction endpoints](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Controller/TransactionController.cs): `SushiWebAPI/Controller/TransactionController.cs`
- [Response helpers](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Helper.cs): `SushiWebAPI/Helper.cs`

### Sales workflow

- [Cart item](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/CartItem.cs): `SushiWebAPI/Models/CartItem.cs`
- [Transaction](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Transaction.cs): `SushiWebAPI/Models/Transaction.cs`
- [Order](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Order.cs): `SushiWebAPI/Models/Order.cs`
- [Order item](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/OrderItem.cs): `SushiWebAPI/Models/OrderItem.cs`
- [Dining table](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Table.cs): `SushiWebAPI/Models/Table.cs`

### Menu and identity

- [Menu item](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Item.cs): `SushiWebAPI/Models/Item.cs`
- [Menu category](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/Category.cs): `SushiWebAPI/Models/Category.cs`
- [Staff user](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Models/User.cs): `SushiWebAPI/Models/User.cs`

### Persistence

- [EF data context](https://github.com/hendragunadie/sakurasushi/blob/main/SushiWebAPI/Data/SushiContext.cs): `SushiWebAPI/Data/SushiContext.cs`
- **SQL Server**

### Other components

- **Restaurant staff**
- **API client**

## Connections

- Restaurant staff → Authentication: requests access
- API client → Menu endpoints: requests menu
- API client → Cart endpoints: manages cart
- Restaurant staff → Transaction endpoints: handles transactions
- Cart endpoints → EF data context: reads and writes (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Transaction endpoints → EF data context: reads and writes (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
- EF data context → SQL Server: configures connection (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Cart item: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Menu category: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Menu item: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Order: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Order item: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Dining table: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Transaction: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- EF data context → Staff user: maps (evidence: `SushiWebAPI/Data/SushiContext.cs`)
- Cart endpoints → Response helpers: formats responses (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Transaction endpoints → Response helpers: formats responses (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
- Cart endpoints → Menu item: looks up menu item (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Cart endpoints → Transaction: looks up transaction (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Cart endpoints → Order: creates order (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Cart endpoints → Order item: creates order line (evidence: `SushiWebAPI/Controller/CartController.cs`)
- Transaction endpoints → Dining table: looks up table (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
- Transaction endpoints → Order: reads order totals (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
- Transaction endpoints → Order item: updates status (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
- Transaction endpoints → Staff user: reads staff claim (evidence: `SushiWebAPI/Controller/TransactionController.cs`)
