# pefiye/roastedgoods architecture

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

## Overview

RoastedGoods is a SvelteKit coffee-shop storefront and operations app backed by Supabase, with Midtrans payments. The main customer journey is menu browsing, cart review, checkout, payment confirmation, and order tracking; separate admin and cashier workflows manage products, accounts, sales, and fulfillment. The graph includes authentication, UI feedback, and Supabase as an internal service layer. Some route implementations were not sampled, so documented capabilities and flows use README evidence; unsampled relationships are omitted where they cannot be established.

Main entry points: [`src/lib/supabase.js`](https://github.com/pefiye/roastedgoods/blob/main/src/lib/supabase.js) (Supabase services), [`src/routes/api/checkout/+server.js`](https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/checkout/%2Bserver.js) (Checkout API), [`src/routes/cashier/+page.svelte`](https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%2Bpage.svelte) (Cashier interface), [`src/routes/menu/+page.server.js`](https://github.com/pefiye/roastedgoods/blob/main/src/routes/menu/%2Bpage.server.js) (Menu browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_menu["Menu browsing<br/>[+page.server.js]"]
  node_product_detail["Product details<br/>[+page.server.js]"]
  node_cart["Shopping cart<br/>[+page.server.js]"]
end

subgraph group_commerce["Orders and payments"]
  node_checkout_page["Checkout page<br/>[+page.server.js]"]
  node_checkout_api["Checkout API<br/>[+server.js]"]
  node_payment_webhook["Payment webhook<br/>[+server.js]"]
  node_order_history["Order tracking<br/>[+page.server.js]"]
end

subgraph group_operations["Shop operations"]
  node_admin_dashboard["Sales dashboard<br/>[+page.server.js]"]
  node_admin_accounts["Account management<br/>[+page.server.js]"]
  node_admin_products["Product management<br/>[+page.server.js]"]
  node_admin_transactions["Transactions<br/>[+page.server.js]"]
  node_cashier_queue["Cashier order queue<br/>[+page.server.js]"]
  node_cashier_ui["Cashier interface<br/>[+page.svelte]"]
  node_cashier_order["Order fulfillment<br/>[+page.server.js]"]
  node_order_status_api["Order status API<br/>[+server.js]"]
  node_image_upload["Product image upload<br/>[+server.js]"]
end

subgraph group_platform["Identity and interface"]
  node_supabase[("Supabase services<br/>[supabase.js]")]
  node_auth["Authentication<br/>[+page.svelte]"]
  node_access_control["Session and access<br/>[hooks.server.js]"]
  node_navbar["Navigation<br/>[Navbar.svelte]"]
  node_notifications["Toast notifications<br/>[toast.js]"]
end

node_customer(("Customer"))
node_admin_actor(("Admin"))
node_cashier_actor(("Cashier"))
node_midtrans["Midtrans"]
node_realtime[("Supabase Realtime")]

node_customer -->|"browses"| node_menu
node_menu -->|"opens item"| node_product_detail
node_customer -->|"adds items"| node_cart
node_cart -->|"continues to"| node_checkout_page
node_checkout_page -->|"submits checkout"| node_checkout_api
node_checkout_api -->|"creates transaction"| node_midtrans
node_checkout_api -->|"stores order"| node_supabase
node_midtrans -->|"sends notification"| node_payment_webhook
node_payment_webhook -->|"updates order status"| node_supabase
node_customer -->|"tracks order"| node_order_history
node_order_history -->|"reads order"| node_supabase
node_customer -->|"signs in"| node_auth
node_auth -->|"establishes session"| node_access_control
node_access_control -->|"loads profile"| node_supabase
node_customer -->|"navigates"| node_navbar
node_admin_actor -->|"views sales"| node_admin_dashboard
node_admin_dashboard -->|"reads sales data"| node_supabase
node_admin_actor -->|"manages accounts"| node_admin_accounts
node_admin_accounts -->|"manages profiles"| node_supabase
node_admin_actor -->|"manages products"| node_admin_products
node_admin_products -->|"reads product data"| node_supabase
node_admin_actor -->|"reviews transactions"| node_admin_transactions
node_cashier_actor -->|"processes orders"| node_cashier_ui
node_cashier_ui -->|"displays queue"| node_cashier_queue
node_cashier_queue -->|"reads active orders"| node_supabase
node_cashier_actor -->|"fulfills order"| node_cashier_order
node_cashier_order -.->|"updates status"| node_order_status_api
node_order_status_api -->|"updates order"| node_supabase
node_admin_actor -->|"uploads image"| node_image_upload
node_image_upload -->|"stores image"| node_supabase
node_realtime -.->|"pushes order updates"| node_cashier_ui
node_notifications -.->|"shows feedback"| node_customer

click node_menu "https://github.com/pefiye/roastedgoods/blob/main/src/routes/menu/%2Bpage.server.js"
click node_product_detail "https://github.com/pefiye/roastedgoods/blob/main/src/routes/menu/%5Bid%5D/%2Bpage.server.js"
click node_cart "https://github.com/pefiye/roastedgoods/blob/main/src/routes/cart/%2Bpage.server.js"
click node_checkout_page "https://github.com/pefiye/roastedgoods/blob/main/src/routes/checkout/%2Bpage.server.js"
click node_checkout_api "https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/checkout/%2Bserver.js"
click node_payment_webhook "https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/midtrans-webhook/%2Bserver.js"
click node_order_history "https://github.com/pefiye/roastedgoods/blob/main/src/routes/profile/orders/%2Bpage.server.js"
click node_supabase "https://github.com/pefiye/roastedgoods/blob/main/src/lib/supabase.js"
click node_auth "https://github.com/pefiye/roastedgoods/blob/main/src/routes/auth/login/%2Bpage.svelte"
click node_access_control "https://github.com/pefiye/roastedgoods/blob/main/src/hooks.server.js"
click node_navbar "https://github.com/pefiye/roastedgoods/blob/main/src/lib/components/Navbar.svelte"
click node_notifications "https://github.com/pefiye/roastedgoods/blob/main/src/lib/stores/toast.js"
click node_admin_dashboard "https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/%2Bpage.server.js"
click node_admin_accounts "https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/accounts/%2Bpage.server.js"
click node_admin_products "https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/products/%2Bpage.server.js"
click node_admin_transactions "https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/transactions/%2Bpage.server.js"
click node_cashier_queue "https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%2Bpage.server.js"
click node_cashier_ui "https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%2Bpage.svelte"
click node_cashier_order "https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%5Bid%5D/%2Bpage.server.js"
click node_order_status_api "https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/cashier/update-status/%2Bserver.js"
click node_image_upload "https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/upload/%2Bserver.js"

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_product_detail,node_cart toneBlue
class node_checkout_page,node_checkout_api,node_payment_webhook,node_order_history,node_realtime toneAmber
class node_admin_dashboard,node_admin_accounts,node_admin_products,node_admin_transactions,node_cashier_queue,node_cashier_ui,node_cashier_order,node_order_status_api,node_image_upload toneMint
class node_supabase,node_auth,node_access_control,node_navbar,node_notifications toneRose
class node_customer,node_admin_actor,node_cashier_actor,node_midtrans toneIndigo
```

## Components

### Customer storefront

- [Menu browsing](https://github.com/pefiye/roastedgoods/blob/main/src/routes/menu/%2Bpage.server.js): `src/routes/menu/+page.server.js`
- [Product details](https://github.com/pefiye/roastedgoods/blob/main/src/routes/menu/%5Bid%5D/%2Bpage.server.js): `src/routes/menu/[id]/+page.server.js`
- [Shopping cart](https://github.com/pefiye/roastedgoods/blob/main/src/routes/cart/%2Bpage.server.js): `src/routes/cart/+page.server.js`

### Orders and payments

- [Checkout page](https://github.com/pefiye/roastedgoods/blob/main/src/routes/checkout/%2Bpage.server.js): `src/routes/checkout/+page.server.js`
- [Checkout API](https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/checkout/%2Bserver.js): `src/routes/api/checkout/+server.js`
- [Payment webhook](https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/midtrans-webhook/%2Bserver.js): `src/routes/api/midtrans-webhook/+server.js`
- [Order tracking](https://github.com/pefiye/roastedgoods/blob/main/src/routes/profile/orders/%2Bpage.server.js): `src/routes/profile/orders/+page.server.js`

### Shop operations

- [Sales dashboard](https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/%2Bpage.server.js): `src/routes/admin/+page.server.js`
- [Account management](https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/accounts/%2Bpage.server.js): `src/routes/admin/accounts/+page.server.js`
- [Product management](https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/products/%2Bpage.server.js): `src/routes/admin/products/+page.server.js`
- [Transactions](https://github.com/pefiye/roastedgoods/blob/main/src/routes/admin/transactions/%2Bpage.server.js): `src/routes/admin/transactions/+page.server.js`
- [Cashier order queue](https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%2Bpage.server.js): `src/routes/cashier/+page.server.js`
- [Cashier interface](https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%2Bpage.svelte): `src/routes/cashier/+page.svelte`
- [Order fulfillment](https://github.com/pefiye/roastedgoods/blob/main/src/routes/cashier/%5Bid%5D/%2Bpage.server.js): `src/routes/cashier/[id]/+page.server.js`
- [Order status API](https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/cashier/update-status/%2Bserver.js): `src/routes/api/cashier/update-status/+server.js`
- [Product image upload](https://github.com/pefiye/roastedgoods/blob/main/src/routes/api/upload/%2Bserver.js): `src/routes/api/upload/+server.js`

### Identity and interface

- [Supabase services](https://github.com/pefiye/roastedgoods/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- [Authentication](https://github.com/pefiye/roastedgoods/blob/main/src/routes/auth/login/%2Bpage.svelte): `src/routes/auth/login/+page.svelte`
- [Session and access](https://github.com/pefiye/roastedgoods/blob/main/src/hooks.server.js): `src/hooks.server.js`
- [Navigation](https://github.com/pefiye/roastedgoods/blob/main/src/lib/components/Navbar.svelte): `src/lib/components/Navbar.svelte`
- [Toast notifications](https://github.com/pefiye/roastedgoods/blob/main/src/lib/stores/toast.js): `src/lib/stores/toast.js`

### Other components

- **Customer**
- **Admin**
- **Cashier**
- **Midtrans**
- **Supabase Realtime**

## Connections

- Customer → Menu browsing: browses
- Menu browsing → Product details: opens item
- Customer → Shopping cart: adds items
- Shopping cart → Checkout page: continues to
- Checkout page → Checkout API: submits checkout (evidence: `src/routes/checkout/+page.server.js`)
- Checkout API → Midtrans: creates transaction (evidence: `src/routes/api/checkout/+server.js`)
- Checkout API → Supabase services: stores order (evidence: `src/routes/api/checkout/+server.js`)
- Midtrans → Payment webhook: sends notification
- Payment webhook → Supabase services: updates order status (evidence: `src/routes/api/midtrans-webhook/+server.js`)
- Customer → Order tracking: tracks order
- Order tracking → Supabase services: reads order (evidence: `src/routes/profile/orders/+page.server.js`)
- Customer → Authentication: signs in
- Authentication → Session and access: establishes session (evidence: `src/hooks.server.js`)
- Session and access → Supabase services: loads profile (evidence: `src/hooks.server.js`)
- Customer → Navigation: navigates
- Admin → Sales dashboard: views sales
- Sales dashboard → Supabase services: reads sales data (evidence: `src/routes/admin/+page.server.js`)
- Admin → Account management: manages accounts
- Account management → Supabase services: manages profiles (evidence: `src/routes/admin/accounts/+page.server.js`)
- Admin → Product management: manages products
- Product management → Supabase services: reads product data (evidence: `src/routes/admin/products/+page.server.js`)
- Admin → Transactions: reviews transactions
- Cashier → Cashier interface: processes orders
- Cashier interface → Cashier order queue: displays queue (evidence: `src/routes/cashier/+page.server.js`)
- Cashier order queue → Supabase services: reads active orders (evidence: `src/routes/cashier/+page.server.js`)
- Cashier → Order fulfillment: fulfills order
- Order fulfillment → Order status API: updates status
- Order status API → Supabase services: updates order (evidence: `src/routes/api/cashier/update-status/+server.js`)
- Admin → Product image upload: uploads image (evidence: `src/routes/api/upload/+server.js`)
- Product image upload → Supabase services: stores image (evidence: `src/routes/api/upload/+server.js`)
- Supabase Realtime → Cashier interface: pushes order updates
- Toast notifications → Customer: shows feedback
