# simulationeg/swiftbite architecture

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

- Interactive diagram: https://gitdiagram.com/simulationeg/swiftbite
- Repository: https://github.com/simulationeg/swiftbite

## Overview

SwiftBite is a three-layer food-delivery console lab: the UI presents scenarios, seed data supplies demo domain objects, and Business owns delivery rules and services. The primary workflow builds and places an order, then supports restaurant acceptance, driver assignment, pickup, delivery confirmation, and cancellation. Pricing, payment, promotions, customer/restaurant/driver management, and configurable notifications are distinct supporting capabilities. The source index and excerpts establish the cited links; some UI and seed behavior is only visible by reference, so no storage or external-service layer is inferred.

Main entry points: [`src/SwiftBite.Business/Orders/OrderBuilder.cs`](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderBuilder.cs) (Order builder), [`src/SwiftBite.Data/DemoSeed.cs`](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Data/DemoSeed.cs) (Demo seed), [`src/SwiftBite.Business/Orders/OrderService.cs`](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderService.cs) (Order service), [`src/SwiftBite.UI/Program.cs`](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.UI/Program.cs) (Console UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Console app"]
  node_program["Console UI<br/>[Program.cs]"]
  node_seed["Demo seed<br/>[DemoSeed.cs]"]
end

subgraph group_orders["Order lifecycle"]
  node_order_service["Order service<br/>[OrderService.cs]"]
  node_order_builder["Order builder<br/>[OrderBuilder.cs]"]
  node_order["Order state<br/>[Order.cs]"]
end

subgraph group_catalog["Delivery domain"]
  node_customer["Customer account<br/>[Customer.cs]"]
  node_restaurant["Restaurant menu<br/>[Restaurant.cs]"]
  node_menu_item["Menu item<br/>[MenuItem.cs]"]
  node_driver["Driver assignment<br/>[Driver.cs]"]
  node_address["Delivery address<br/>[Address.cs]"]
  node_location["Location<br/>[Location.cs]"]
end

subgraph group_pricing["Pricing and payment"]
  node_coupon["Coupon<br/>[Coupon.cs]"]
  node_fee_calculator["Fee calculator"]
  node_fee_strategy["Fee strategies"]
  node_payment["Payment methods<br/>[IPaymentMethod.cs]"]
end

subgraph group_support["Shared services"]
  node_notification_service["Notification service"]
  node_notifier_factory["Notifier factory<br/>[NotifierCreator.cs]"]
  node_logger["Console logger<br/>[ILogger.cs]"]
  node_policy["Company policy<br/>[CompanyPolicy.cs]"]
  node_guard["Rule validation<br/>[Guard.cs]"]
end

node_user(("Console user"))

node_user -->|"uses"| node_program
node_program -->|"loads"| node_seed
node_program -->|"invokes"| node_order_service
node_program -->|"configures"| node_notification_service
node_program -->|"configures"| node_policy
node_seed -->|"creates"| node_restaurant
node_seed -->|"creates"| node_customer
node_seed -->|"creates"| node_driver
node_seed -->|"creates"| node_coupon
node_seed -->|"configures"| node_fee_calculator
node_seed -->|"selects"| node_fee_strategy
node_order_service -->|"builds via"| node_order_builder
node_order_service -->|"advances"| node_order
node_order_service -->|"filters and assigns"| node_driver
node_order_service -->|"notifies"| node_notification_service
node_order_service -->|"logs"| node_logger
node_order_builder -->|"creates"| node_order
node_order_builder -->|"calculates fees"| node_fee_calculator
node_order_builder -->|"uses"| node_customer
node_order_builder -->|"checks menu"| node_restaurant
node_order_builder -->|"uses"| node_menu_item
node_order_builder -->|"uses"| node_address
node_order_builder -->|"sets"| node_payment
node_order_builder -->|"applies"| node_coupon
node_fee_calculator -->|"delegates to"| node_fee_strategy
node_order -->|"charges or refunds"| node_payment
node_order -->|"assigns and releases"| node_driver
node_driver -->|"tracks"| node_location
node_restaurant -->|"owns menu"| node_menu_item
node_restaurant -->|"uses"| node_location
node_address -->|"contains"| node_location
node_notification_service -->|"selects notifier"| node_notifier_factory
node_customer -->|"checks limits"| node_policy
node_restaurant -->|"checks limits"| node_policy
node_driver -->|"checks age rule"| node_policy
node_order_builder -->|"validates"| node_guard

click node_program "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.UI/Program.cs"
click node_seed "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Data/DemoSeed.cs"
click node_order_service "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderService.cs"
click node_order_builder "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderBuilder.cs"
click node_order "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/Order.cs"
click node_customer "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Users/Customer.cs"
click node_restaurant "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Restaurants/Restaurant.cs"
click node_menu_item "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Restaurants/MenuItem.cs"
click node_driver "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Users/Driver.cs"
click node_address "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/ValueObjects/Address.cs"
click node_location "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/ValueObjects/Location.cs"
click node_coupon "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Promotions/Coupon.cs"
click node_fee_calculator "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Pricing/DeliveryFeeCalculator.cs"
click node_fee_strategy "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Pricing/IDeliveryFeeStrategy.cs"
click node_payment "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Payments/IPaymentMethod.cs"
click node_notification_service "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Notifications/NotificationService.cs"
click node_notifier_factory "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Notifications/NotifierCreator.cs"
click node_logger "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Logging/ILogger.cs"
click node_policy "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Common/CompanyPolicy.cs"
click node_guard "https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Common/Guard.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_program,node_seed,node_user toneBlue
class node_order_service,node_order_builder,node_order toneAmber
class node_customer,node_restaurant,node_menu_item,node_driver,node_address,node_location toneMint
class node_coupon,node_fee_calculator,node_fee_strategy,node_payment toneRose
class node_notification_service,node_notifier_factory,node_logger,node_policy,node_guard toneIndigo
```

## Components

### Console app

- [Console UI](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.UI/Program.cs): `src/SwiftBite.UI/Program.cs`
- [Demo seed](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Data/DemoSeed.cs): `src/SwiftBite.Data/DemoSeed.cs`

### Order lifecycle

- [Order service](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderService.cs): `src/SwiftBite.Business/Orders/OrderService.cs`
- [Order builder](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/OrderBuilder.cs): `src/SwiftBite.Business/Orders/OrderBuilder.cs`
- [Order state](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Orders/Order.cs): `src/SwiftBite.Business/Orders/Order.cs`

### Delivery domain

- [Customer account](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Users/Customer.cs): `src/SwiftBite.Business/Users/Customer.cs`
- [Restaurant menu](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Restaurants/Restaurant.cs): `src/SwiftBite.Business/Restaurants/Restaurant.cs`
- [Menu item](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Restaurants/MenuItem.cs): `src/SwiftBite.Business/Restaurants/MenuItem.cs`
- [Driver assignment](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Users/Driver.cs): `src/SwiftBite.Business/Users/Driver.cs`
- [Delivery address](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/ValueObjects/Address.cs): `src/SwiftBite.Business/ValueObjects/Address.cs`
- [Location](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/ValueObjects/Location.cs): `src/SwiftBite.Business/ValueObjects/Location.cs`

### Pricing and payment

- [Coupon](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Promotions/Coupon.cs): `src/SwiftBite.Business/Promotions/Coupon.cs`
- [Fee calculator](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Pricing/DeliveryFeeCalculator.cs): `src/SwiftBite.Business/Pricing/DeliveryFeeCalculator.cs`
- [Fee strategies](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Pricing/IDeliveryFeeStrategy.cs): `src/SwiftBite.Business/Pricing/IDeliveryFeeStrategy.cs`
- [Payment methods](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Payments/IPaymentMethod.cs): `src/SwiftBite.Business/Payments/IPaymentMethod.cs`

### Shared services

- [Notification service](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Notifications/NotificationService.cs): `src/SwiftBite.Business/Notifications/NotificationService.cs`
- [Notifier factory](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Notifications/NotifierCreator.cs): `src/SwiftBite.Business/Notifications/NotifierCreator.cs`
- [Console logger](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Logging/ILogger.cs): `src/SwiftBite.Business/Logging/ILogger.cs`
- [Company policy](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Common/CompanyPolicy.cs): `src/SwiftBite.Business/Common/CompanyPolicy.cs`
- [Rule validation](https://github.com/simulationeg/swiftbite/blob/main/src/SwiftBite.Business/Common/Guard.cs): `src/SwiftBite.Business/Common/Guard.cs`

### Other components

- **Console user**

## Connections

- Console user → Console UI: uses (evidence: `README.md`)
- Console UI → Demo seed: loads (evidence: `src/SwiftBite.UI/Program.cs`)
- Console UI → Order service: invokes (evidence: `src/SwiftBite.UI/Program.cs`)
- Console UI → Notification service: configures (evidence: `src/SwiftBite.UI/Program.cs`)
- Console UI → Company policy: configures (evidence: `src/SwiftBite.UI/Program.cs`)
- Demo seed → Restaurant menu: creates (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Demo seed → Customer account: creates (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Demo seed → Driver assignment: creates (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Demo seed → Coupon: creates (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Demo seed → Fee calculator: configures (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Demo seed → Fee strategies: selects (evidence: `src/SwiftBite.Data/DemoSeed.cs`)
- Order service → Order builder: builds via (evidence: `src/SwiftBite.Business/Orders/OrderService.cs`)
- Order service → Order state: advances (evidence: `src/SwiftBite.Business/Orders/OrderService.cs`)
- Order service → Driver assignment: filters and assigns (evidence: `src/SwiftBite.Business/Orders/OrderService.cs`)
- Order service → Notification service: notifies (evidence: `src/SwiftBite.Business/Orders/OrderService.cs`)
- Order service → Console logger: logs (evidence: `src/SwiftBite.Business/Orders/OrderService.cs`)
- Order builder → Order state: creates (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Fee calculator: calculates fees (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Customer account: uses (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Restaurant menu: checks menu (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Menu item: uses (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Delivery address: uses (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Payment methods: sets (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Order builder → Coupon: applies (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
- Fee calculator → Fee strategies: delegates to (evidence: `src/SwiftBite.Business/Pricing/DeliveryFeeCalculator.cs`)
- Order state → Payment methods: charges or refunds (evidence: `src/SwiftBite.Business/Orders/Order.cs`)
- Order state → Driver assignment: assigns and releases (evidence: `src/SwiftBite.Business/Orders/Order.cs`)
- Driver assignment → Location: tracks (evidence: `src/SwiftBite.Business/Users/Driver.cs`)
- Restaurant menu → Menu item: owns menu (evidence: `src/SwiftBite.Business/Restaurants/Restaurant.cs`)
- Restaurant menu → Location: uses (evidence: `src/SwiftBite.Business/Restaurants/Restaurant.cs`)
- Delivery address → Location: contains (evidence: `src/SwiftBite.Business/ValueObjects/Address.cs`)
- Notification service → Notifier factory: selects notifier (evidence: `src/SwiftBite.Business/Notifications/NotificationService.cs`)
- Customer account → Company policy: checks limits (evidence: `src/SwiftBite.Business/Users/Customer.cs`)
- Restaurant menu → Company policy: checks limits (evidence: `src/SwiftBite.Business/Restaurants/Restaurant.cs`)
- Driver assignment → Company policy: checks age rule (evidence: `src/SwiftBite.Business/Users/Driver.cs`)
- Order builder → Rule validation: validates (evidence: `src/SwiftBite.Business/Orders/OrderBuilder.cs`)
