# callencaracy/bytebites architecture

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

- Interactive diagram: https://gitdiagram.com/callencaracy/bytebites
- Repository: https://github.com/callencaracy/bytebites

## Overview

ByteBites is a restaurant ordering and operations system with separate customer and employee web clients, a GraphQL gateway, and gRPC microservices. The main customer workflow spans account access, menu selection, cart/order placement, payment, and kitchen fulfillment; employee screens support menu/inventory and order-queue operations. The README documents service responsibilities and gRPC/GraphQL boundaries, but several backend resolver and service implementations were not sampled, so uncertain service links are documented, dashed relationships rather than asserted calls.

Main entry points: [`frontend-client/src/App.tsx`](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/App.tsx) (Customer routes), [`frontend-employee/src/App.tsx`](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/App.tsx) (Employee routes), [`services/Graphql_Service/grpc_clients/grpc_clients.go`](https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/grpc_clients/grpc_clients.go) (gRPC clients), [`frontend-client/src/graphql`](https://github.com/callencaracy/bytebites/tree/main/frontend-client/src/graphql) (Customer queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer Web"]
  node_customer_app["Customer routes<br/>[App.tsx]"]
  node_customer_auth["Customer auth<br/>[AuthContext.tsx]"]
  node_customer_account["Account access<br/>[Account.tsx]"]
  node_customer_menu["Menu browsing<br/>[MenuItems.tsx]"]
  node_customer_cart["Cart and order<br/>[YourCart.tsx]"]
  node_customer_payment["Payment<br/>[PaymentPage.tsx]"]
  node_customer_queries["Customer queries"]
end

subgraph group_employee["Employee Web"]
  node_employee_app["Employee routes<br/>[App.tsx]"]
  node_employee_auth["Employee auth<br/>[AuthContext.tsx]"]
  node_employee_menu["Menu operations<br/>[MenuItems.tsx]"]
  node_employee_addmenu["Add menu items<br/>[AddMenu.tsx]"]
  node_employee_inventory["Inventory updates<br/>[MakeInventory.tsx]"]
  node_employee_queues["Kitchen queues<br/>[OrderQueues.tsx]"]
  node_employee_queries["Employee queries"]
end

subgraph group_gateway["GraphQL Gateway"]
  node_graphql["GraphQL API<br/>[server.go]"]
  node_resolvers["Domain resolvers"]
  node_grpc_clients["gRPC clients<br/>[grpc_clients.go]"]
  node_auth_middleware["Auth middleware<br/>[AuthMiddleware.go]"]
end

subgraph group_services["Restaurant Services"]
  node_menu_service["Menu service<br/>[menu.go]"]
  node_order_service["Order service<br/>[orders.go]"]
  node_payment_service["Payment service<br/>[payments.go]"]
  node_kitchen_service["Kitchen service<br/>[kitchen.go]"]
  node_user_service["User service<br/>[users.go]"]
end

subgraph group_identity["Identity and Storage"]
  node_supabase_auth["Supabase Auth"]
  node_database[("PostgreSQL")]
end

node_customer(("Customer"))
node_employee(("Employee"))

node_customer -->|"uses"| node_customer_app
node_employee -->|"uses"| node_employee_app
node_customer_app -->|"routes to"| node_customer_account
node_customer_app -->|"routes to"| node_customer_menu
node_customer_app -->|"routes to"| node_customer_cart
node_customer_app -->|"routes to"| node_customer_payment
node_employee_app -->|"routes to"| node_employee_menu
node_employee_app -->|"routes to"| node_employee_addmenu
node_employee_app -->|"routes to"| node_employee_inventory
node_employee_app -->|"routes to"| node_employee_queues
node_customer_app -->|"refreshes session"| node_supabase_auth
node_employee_app -->|"refreshes session"| node_supabase_auth
node_customer_auth -->|"queries identity"| node_customer_queries
node_employee_auth -->|"queries identity"| node_employee_queries
node_customer_menu -.->|"uses operations"| node_customer_queries
node_customer_cart -->|"uses operations"| node_customer_queries
node_customer_payment -->|"uses operations"| node_customer_queries
node_employee_menu -->|"uses operations"| node_employee_queries
node_employee_addmenu -->|"uses operations"| node_employee_queries
node_customer_queries -.->|"sends GraphQL"| node_graphql
node_employee_queries -.->|"sends GraphQL"| node_graphql
node_graphql -.->|"authenticates"| node_auth_middleware
node_graphql -.->|"dispatches"| node_resolvers
node_resolvers -.->|"uses clients"| node_grpc_clients
node_grpc_clients -.->|"calls gRPC"| node_menu_service
node_grpc_clients -.->|"calls gRPC"| node_order_service
node_grpc_clients -.->|"calls gRPC"| node_payment_service
node_grpc_clients -.->|"calls gRPC"| node_kitchen_service
node_grpc_clients -.->|"calls gRPC"| node_user_service
node_user_service -.->|"authenticates users"| node_supabase_auth
node_user_service -.->|"accesses user data"| node_database
node_menu_service -.->|"stores menu data"| node_database
node_order_service -.->|"stores orders"| node_database
node_payment_service -.->|"stores payments"| node_database
node_kitchen_service -.->|"fulfills orders"| node_order_service

click node_customer_app "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/App.tsx"
click node_customer_auth "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/components/AuthContext.tsx"
click node_customer_account "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/Account.tsx"
click node_customer_menu "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/MenuItems.tsx"
click node_customer_cart "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/YourCart.tsx"
click node_customer_payment "https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/PaymentPage.tsx"
click node_customer_queries "https://github.com/callencaracy/bytebites/tree/main/frontend-client/src/graphql"
click node_employee_app "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/App.tsx"
click node_employee_auth "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/components/AuthContext.tsx"
click node_employee_menu "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/MenuItems.tsx"
click node_employee_addmenu "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/AddMenu.tsx"
click node_employee_inventory "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/MakeInventory.tsx"
click node_employee_queues "https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/OrderQueues.tsx"
click node_employee_queries "https://github.com/callencaracy/bytebites/tree/main/frontend-employee/src/graphql"
click node_graphql "https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/server.go"
click node_resolvers "https://github.com/callencaracy/bytebites/tree/main/services/Graphql_Service/graph"
click node_grpc_clients "https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/grpc_clients/grpc_clients.go"
click node_auth_middleware "https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/middleware/AuthMiddleware.go"
click node_menu_service "https://github.com/callencaracy/bytebites/blob/main/services/Menu_Service/server/menus/menu.go"
click node_order_service "https://github.com/callencaracy/bytebites/blob/main/services/Order_Service/server/orders/orders.go"
click node_payment_service "https://github.com/callencaracy/bytebites/blob/main/services/Payment_Service/server/payments/payments.go"
click node_kitchen_service "https://github.com/callencaracy/bytebites/blob/main/services/Kitchen_Service/server/kitchen/kitchen.go"
click node_user_service "https://github.com/callencaracy/bytebites/blob/main/services/User_Service/server/users/users.go"

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_customer_app,node_customer_auth,node_customer_account,node_customer_menu,node_customer_cart,node_customer_payment,node_customer_queries toneBlue
class node_employee_app,node_employee_auth,node_employee_menu,node_employee_addmenu,node_employee_inventory,node_employee_queues,node_employee_queries toneAmber
class node_graphql,node_resolvers,node_grpc_clients,node_auth_middleware toneMint
class node_menu_service,node_order_service,node_payment_service,node_kitchen_service,node_user_service toneRose
class node_supabase_auth,node_database,node_customer,node_employee toneIndigo
```

## Components

### Customer Web

- [Customer routes](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/App.tsx): `frontend-client/src/App.tsx`
- [Customer auth](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/components/AuthContext.tsx): `frontend-client/src/components/AuthContext.tsx`
- [Account access](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/Account.tsx): `frontend-client/src/pages/Account.tsx`
- [Menu browsing](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/MenuItems.tsx): `frontend-client/src/pages/MenuItems.tsx`
- [Cart and order](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/YourCart.tsx): `frontend-client/src/pages/YourCart.tsx`
- [Payment](https://github.com/callencaracy/bytebites/blob/main/frontend-client/src/pages/PaymentPage.tsx): `frontend-client/src/pages/PaymentPage.tsx`
- [Customer queries](https://github.com/callencaracy/bytebites/tree/main/frontend-client/src/graphql): `frontend-client/src/graphql`

### Employee Web

- [Employee routes](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/App.tsx): `frontend-employee/src/App.tsx`
- [Employee auth](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/components/AuthContext.tsx): `frontend-employee/src/components/AuthContext.tsx`
- [Menu operations](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/MenuItems.tsx): `frontend-employee/src/pages/MenuItems.tsx`
- [Add menu items](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/AddMenu.tsx): `frontend-employee/src/pages/AddMenu.tsx`
- [Inventory updates](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/MakeInventory.tsx): `frontend-employee/src/pages/MakeInventory.tsx`
- [Kitchen queues](https://github.com/callencaracy/bytebites/blob/main/frontend-employee/src/pages/OrderQueues.tsx): `frontend-employee/src/pages/OrderQueues.tsx`
- [Employee queries](https://github.com/callencaracy/bytebites/tree/main/frontend-employee/src/graphql): `frontend-employee/src/graphql`

### GraphQL Gateway

- [GraphQL API](https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/server.go): `services/Graphql_Service/server.go`
- [Domain resolvers](https://github.com/callencaracy/bytebites/tree/main/services/Graphql_Service/graph): `services/Graphql_Service/graph`
- [gRPC clients](https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/grpc_clients/grpc_clients.go): `services/Graphql_Service/grpc_clients/grpc_clients.go`
- [Auth middleware](https://github.com/callencaracy/bytebites/blob/main/services/Graphql_Service/middleware/AuthMiddleware.go): `services/Graphql_Service/middleware/AuthMiddleware.go`

### Restaurant Services

- [Menu service](https://github.com/callencaracy/bytebites/blob/main/services/Menu_Service/server/menus/menu.go): `services/Menu_Service/server/menus/menu.go`
- [Order service](https://github.com/callencaracy/bytebites/blob/main/services/Order_Service/server/orders/orders.go): `services/Order_Service/server/orders/orders.go`
- [Payment service](https://github.com/callencaracy/bytebites/blob/main/services/Payment_Service/server/payments/payments.go): `services/Payment_Service/server/payments/payments.go`
- [Kitchen service](https://github.com/callencaracy/bytebites/blob/main/services/Kitchen_Service/server/kitchen/kitchen.go): `services/Kitchen_Service/server/kitchen/kitchen.go`
- [User service](https://github.com/callencaracy/bytebites/blob/main/services/User_Service/server/users/users.go): `services/User_Service/server/users/users.go`

### Identity and Storage

- **Supabase Auth**
- **PostgreSQL**

### Other components

- **Customer**
- **Employee**

## Connections

- Customer → Customer routes: uses (evidence: `frontend-client/src/App.tsx`)
- Employee → Employee routes: uses (evidence: `frontend-employee/src/App.tsx`)
- Customer routes → Account access: routes to (evidence: `frontend-client/src/App.tsx`)
- Customer routes → Menu browsing: routes to (evidence: `frontend-client/src/App.tsx`)
- Customer routes → Cart and order: routes to (evidence: `frontend-client/src/App.tsx`)
- Customer routes → Payment: routes to (evidence: `frontend-client/src/App.tsx`)
- Employee routes → Menu operations: routes to (evidence: `frontend-employee/src/App.tsx`)
- Employee routes → Add menu items: routes to (evidence: `frontend-employee/src/App.tsx`)
- Employee routes → Inventory updates: routes to (evidence: `frontend-employee/src/App.tsx`)
- Employee routes → Kitchen queues: routes to (evidence: `frontend-employee/src/App.tsx`)
- Customer routes → Supabase Auth: refreshes session (evidence: `frontend-client/src/App.tsx`)
- Employee routes → Supabase Auth: refreshes session (evidence: `frontend-employee/src/App.tsx`)
- Customer auth → Customer queries: queries identity (evidence: `frontend-client/src/components/AuthContext.tsx`)
- Employee auth → Employee queries: queries identity (evidence: `frontend-employee/src/components/AuthContext.tsx`)
- Menu browsing → Customer queries: uses operations (evidence: `frontend-client/src/pages/MenuItems.tsx`)
- Cart and order → Customer queries: uses operations (evidence: `frontend-client/src/pages/YourCart.tsx`)
- Payment → Customer queries: uses operations (evidence: `frontend-client/src/pages/PaymentPage.tsx`)
- Menu operations → Employee queries: uses operations (evidence: `frontend-employee/src/pages/MenuItems.tsx`)
- Add menu items → Employee queries: uses operations (evidence: `frontend-employee/src/pages/AddMenu.tsx`)
- Customer queries → GraphQL API: sends GraphQL (evidence: `README.md`)
- Employee queries → GraphQL API: sends GraphQL (evidence: `README.md`)
- GraphQL API → Auth middleware: authenticates
- GraphQL API → Domain resolvers: dispatches
- Domain resolvers → gRPC clients: uses clients
- gRPC clients → Menu service: calls gRPC (evidence: `README.md`)
- gRPC clients → Order service: calls gRPC (evidence: `README.md`)
- gRPC clients → Payment service: calls gRPC (evidence: `README.md`)
- gRPC clients → Kitchen service: calls gRPC (evidence: `README.md`)
- gRPC clients → User service: calls gRPC (evidence: `README.md`)
- User service → Supabase Auth: authenticates users
- User service → PostgreSQL: accesses user data (evidence: `README.md`)
- Menu service → PostgreSQL: stores menu data (evidence: `README.md`)
- Order service → PostgreSQL: stores orders (evidence: `README.md`)
- Payment service → PostgreSQL: stores payments (evidence: `README.md`)
- Kitchen service → Order service: fulfills orders (evidence: `README.md`)
