# reaper5324/foodbyk_one architecture

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

## Overview

Foodbyk is a food-ordering and fulfilment application. Customers browse products, manage a cart and addresses, preview checkout, select a slot, submit and pay for orders; staff manage fulfilment, while administrators manage catalog, promotions, settings and accounts. The backend routes requests through middleware and controllers to services and domain models. The source index and excerpts show key backend calls, but do not establish how the listed frontend pages and scripts connect to the API, so those links are left unverified.

Main entry points: [`backend/foodbyk/routes.php`](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/routes.php) (Route registration), [`backend/foodbyk/services/OrderService.php`](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/OrderService.php) (Order lifecycle), [`backend/foodbyk/controllers/AdminController.php`](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/AdminController.php) (Admin endpoints), [`backend/foodbyk/core/Router.php`](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Router.php) (Router dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Request runtime"]
  node_entry["HTTP entry<br/>[index.php]"]
  node_routes["Route registration<br/>[routes.php]"]
  node_router["Router dispatch<br/>[Router.php]"]
  node_request["Request parsing<br/>[Request.php]"]
  node_response["Response sending<br/>[Response.php]"]
  node_middleware["Access middleware"]
  node_database[("Database connection<br/>[Database.php]")]
end

subgraph group_customer["Customer ordering"]
  node_browser["Customer interface"]
  node_frontend_api["Customer API scripts"]
  node_auth_controller["Authentication endpoints<br/>[AuthController.php]"]
  node_auth_service["Accounts and sessions<br/>[AuthService.php]"]
  node_cart_checkout["Cart and checkout"]
  node_cart_service["Cart operations<br/>[CartService.php]"]
  node_checkout_service["Checkout processing"]
  node_address_service["Customer addresses<br/>[AddressService.php]"]
  node_catalog["Product and category browsing"]
end

subgraph group_fulfilment["Order fulfilment"]
  node_order_api["Order endpoints"]
  node_order_service["Order lifecycle<br/>[OrderService.php]"]
  node_payment_service["Payment processing<br/>[PaymentService.php]"]
  node_notification_service["Order notifications"]
  node_order_model["Order records<br/>[Order.php]"]
end

subgraph group_management["Catalog and administration"]
  node_product_service["Product management<br/>[ProductService.php]"]
  node_admin_api["Admin endpoints"]
  node_admin_settings["Promotions and settings"]
  node_category_service["Category management"]
end

node_customer_actor(("Customer"))
node_staff_actor(("Staff"))
node_admin_actor(("Administrator"))
node_mysql[("MySQL")]
node_resend["Resend email API"]
node_payment_provider["Payment provider"]

node_customer_actor -.->|"uses"| node_browser
node_browser -.->|"may call"| node_frontend_api
node_frontend_api -.->|"may request"| node_entry
node_entry -->|"loads routes"| node_routes
node_entry -->|"dispatches through"| node_router
node_entry -->|"captures"| node_request
node_routes -->|"registers routes"| node_router
node_routes -->|"routes to"| node_auth_controller
node_routes -->|"routes to"| node_cart_checkout
node_routes -->|"routes to"| node_order_api
node_routes -->|"attaches"| node_middleware
node_router -->|"dispatches"| node_request
node_router -->|"returns"| node_response
node_router -.->|"invokes handler"| node_auth_controller
node_auth_controller -->|"calls"| node_auth_service
node_cart_checkout -->|"calls"| node_checkout_service
node_cart_checkout -.->|"calls"| node_cart_service
node_customer_actor -.->|"orders through"| node_cart_checkout
node_checkout_service -.->|"submits order"| node_order_service
node_order_api -->|"calls"| node_order_service
node_staff_actor -.->|"manages orders"| node_order_api
node_order_service -->|"reads and writes"| node_order_model
node_order_service -->|"calls"| node_payment_service
node_order_service -->|"notifies"| node_notification_service
node_payment_service -.->|"integrates with"| node_payment_provider
node_auth_service -->|"sends email"| node_resend
node_admin_actor -.->|"manages"| node_admin_api
node_admin_api -->|"calls"| node_auth_service
node_admin_api -->|"calls"| node_product_service
node_admin_api -->|"calls"| node_admin_settings
node_admin_api -->|"calls"| node_category_service
node_product_service -->|"uses"| node_database
node_order_service -->|"uses"| node_database
node_database -->|"connects to"| node_mysql
node_catalog -.->|"uses"| node_product_service
node_cart_checkout -.->|"uses"| node_address_service

click node_browser "https://github.com/reaper5324/foodbyk_one/tree/main/frontend/pages/customer"
click node_frontend_api "https://github.com/reaper5324/foodbyk_one/tree/main/frontend/public%20assets/js/api"
click node_entry "https://github.com/reaper5324/foodbyk_one/blob/main/backend/public/index.php"
click node_routes "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/routes.php"
click node_router "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Router.php"
click node_request "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Request.php"
click node_response "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Response.php"
click node_middleware "https://github.com/reaper5324/foodbyk_one/tree/main/backend/foodbyk/middleware"
click node_auth_controller "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/AuthController.php"
click node_auth_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AuthService.php"
click node_cart_checkout "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/CheckoutController.php"
click node_cart_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CartService.php"
click node_checkout_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CheckoutService.php"
click node_address_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AddressService.php"
click node_catalog "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/ProductController.php"
click node_order_api "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/OrderController.php"
click node_order_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/OrderService.php"
click node_payment_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/PaymentService.php"
click node_notification_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/NotificationService.php"
click node_order_model "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/models/Order.php"
click node_product_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/ProductService.php"
click node_admin_api "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/AdminController.php"
click node_admin_settings "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AdminSettingsService.php"
click node_category_service "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CategoryService.php"
click node_database "https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/database/Database.php"

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_entry,node_routes,node_router,node_request,node_response,node_middleware,node_database toneBlue
class node_browser,node_frontend_api,node_auth_controller,node_auth_service,node_cart_checkout,node_cart_service,node_checkout_service,node_address_service,node_catalog,node_mysql toneAmber
class node_order_api,node_order_service,node_payment_service,node_notification_service,node_order_model,node_resend toneMint
class node_product_service,node_admin_api,node_admin_settings,node_category_service toneRose
class node_customer_actor,node_staff_actor,node_admin_actor,node_payment_provider toneIndigo
```

## Components

### Request runtime

- [HTTP entry](https://github.com/reaper5324/foodbyk_one/blob/main/backend/public/index.php): `backend/public/index.php`
- [Route registration](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/routes.php): `backend/foodbyk/routes.php`
- [Router dispatch](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Router.php): `backend/foodbyk/core/Router.php`
- [Request parsing](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Request.php): `backend/foodbyk/core/Request.php`
- [Response sending](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/core/Response.php): `backend/foodbyk/core/Response.php`
- [Access middleware](https://github.com/reaper5324/foodbyk_one/tree/main/backend/foodbyk/middleware): `backend/foodbyk/middleware`
- [Database connection](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/database/Database.php): `backend/foodbyk/database/Database.php`

### Customer ordering

- [Customer interface](https://github.com/reaper5324/foodbyk_one/tree/main/frontend/pages/customer): `frontend/pages/customer`
- [Customer API scripts](https://github.com/reaper5324/foodbyk_one/tree/main/frontend/public%20assets/js/api): `frontend/public assets/js/api`
- [Authentication endpoints](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/AuthController.php): `backend/foodbyk/controllers/AuthController.php`
- [Accounts and sessions](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AuthService.php): `backend/foodbyk/services/AuthService.php`
- [Cart and checkout](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/CheckoutController.php): `backend/foodbyk/controllers/CheckoutController.php`
- [Cart operations](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CartService.php): `backend/foodbyk/services/CartService.php`
- [Checkout processing](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CheckoutService.php): `backend/foodbyk/services/CheckoutService.php`
- [Customer addresses](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AddressService.php): `backend/foodbyk/services/AddressService.php`
- [Product and category browsing](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/ProductController.php): `backend/foodbyk/controllers/ProductController.php`

### Order fulfilment

- [Order endpoints](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/OrderController.php): `backend/foodbyk/controllers/OrderController.php`
- [Order lifecycle](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/OrderService.php): `backend/foodbyk/services/OrderService.php`
- [Payment processing](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/PaymentService.php): `backend/foodbyk/services/PaymentService.php`
- [Order notifications](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/NotificationService.php): `backend/foodbyk/services/NotificationService.php`
- [Order records](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/models/Order.php): `backend/foodbyk/models/Order.php`

### Catalog and administration

- [Product management](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/ProductService.php): `backend/foodbyk/services/ProductService.php`
- [Admin endpoints](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/controllers/AdminController.php): `backend/foodbyk/controllers/AdminController.php`
- [Promotions and settings](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/AdminSettingsService.php): `backend/foodbyk/services/AdminSettingsService.php`
- [Category management](https://github.com/reaper5324/foodbyk_one/blob/main/backend/foodbyk/services/CategoryService.php): `backend/foodbyk/services/CategoryService.php`

### Other components

- **Customer**
- **Staff**
- **Administrator**
- **MySQL**
- **Resend email API**
- **Payment provider**

## Connections

- Customer → Customer interface: uses
- Customer interface → Customer API scripts: may call
- Customer API scripts → HTTP entry: may request
- HTTP entry → Route registration: loads routes (evidence: `backend/public/index.php`)
- HTTP entry → Router dispatch: dispatches through (evidence: `backend/public/index.php`)
- HTTP entry → Request parsing: captures (evidence: `backend/public/index.php`)
- Route registration → Router dispatch: registers routes (evidence: `backend/foodbyk/routes.php`)
- Route registration → Authentication endpoints: routes to (evidence: `backend/foodbyk/routes.php`)
- Route registration → Cart and checkout: routes to (evidence: `backend/foodbyk/routes.php`)
- Route registration → Order endpoints: routes to (evidence: `backend/foodbyk/routes.php`)
- Route registration → Access middleware: attaches (evidence: `backend/foodbyk/routes.php`)
- Router dispatch → Request parsing: dispatches (evidence: `backend/foodbyk/core/Router.php`)
- Router dispatch → Response sending: returns (evidence: `backend/foodbyk/core/Router.php`)
- Router dispatch → Authentication endpoints: invokes handler
- Authentication endpoints → Accounts and sessions: calls (evidence: `backend/foodbyk/controllers/AuthController.php`)
- Cart and checkout → Checkout processing: calls (evidence: `backend/foodbyk/controllers/CheckoutController.php`)
- Cart and checkout → Cart operations: calls
- Customer → Cart and checkout: orders through
- Checkout processing → Order lifecycle: submits order
- Order endpoints → Order lifecycle: calls (evidence: `backend/foodbyk/controllers/OrderController.php`)
- Staff → Order endpoints: manages orders
- Order lifecycle → Order records: reads and writes (evidence: `backend/foodbyk/services/OrderService.php`)
- Order lifecycle → Payment processing: calls (evidence: `backend/foodbyk/services/OrderService.php`)
- Order lifecycle → Order notifications: notifies (evidence: `backend/foodbyk/services/OrderService.php`)
- Payment processing → Payment provider: integrates with
- Accounts and sessions → Resend email API: sends email (evidence: `backend/foodbyk/services/AuthService.php`)
- Administrator → Admin endpoints: manages
- Admin endpoints → Accounts and sessions: calls (evidence: `backend/foodbyk/controllers/AdminController.php`)
- Admin endpoints → Product management: calls (evidence: `backend/foodbyk/controllers/AdminController.php`)
- Admin endpoints → Promotions and settings: calls (evidence: `backend/foodbyk/controllers/AdminController.php`)
- Admin endpoints → Category management: calls (evidence: `backend/foodbyk/controllers/AdminController.php`)
- Product management → Database connection: uses (evidence: `backend/foodbyk/services/ProductService.php`)
- Order lifecycle → Database connection: uses (evidence: `backend/foodbyk/services/OrderService.php`)
- Database connection → MySQL: connects to (evidence: `backend/foodbyk/database/Database.php`)
- Product and category browsing → Product management: uses
- Cart and checkout → Customer addresses: uses
