# l1nehalt/food-delivery architecture

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

- Interactive diagram: https://gitdiagram.com/l1nehalt/food-delivery
- Repository: https://github.com/l1nehalt/food-delivery

## Overview

This repository implements a food-ordering system split into an API gateway and Catalog, Order, Kitchen, and Delivery services. The visible order workflow creates and persists an order, publishes an order-created event for catalog inventory validation, then handles validation by updating the order and publishing confirmation for kitchen processing. Catalog also exposes product operations; Kitchen exposes order retrieval. The source index supports these service and event links, but the README is empty and gateway routing, Delivery behavior, and broker wiring are not shown, so those connections are omitted.

Main entry points: [`src/OrderService/Services/OrdersService.cs`](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Services/OrdersService.cs) (Order workflow), [`src/OrderService/Consumers/InventoryValidatedConsumer.cs`](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Consumers/InventoryValidatedConsumer.cs) (Inventory response), [`src/CatalogService/Consumers/OrderCreatedConsumer.cs`](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Consumers/OrderCreatedConsumer.cs) (Order validation), [`src/CatalogService/Services/ProductsService.cs`](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Services/ProductsService.cs) (Product operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_order["Order management"]
  node_orders_api["Orders API"]
  node_orders_service["Order workflow<br/>[OrdersService.cs]"]
  node_order_store[("Order database<br/>[OrderDbContext.cs]")]
  node_inventory_consumer["Inventory response"]
end

subgraph group_catalog["Catalog and inventory"]
  node_products_api["Products API"]
  node_products_service["Product operations<br/>[ProductsService.cs]"]
  node_catalog_store[("Catalog database")]
  node_order_consumer["Order validation"]
end

subgraph group_kitchen["Kitchen operations"]
  node_kitchen_consumer["Kitchen intake"]
  node_kitchen_service["Kitchen operations<br/>[KitchenService.cs]"]
  node_kitchen_api["Kitchen API"]
  node_kitchen_store[("Kitchen database")]
end

subgraph group_contracts["Event contracts"]
  node_created_event["Order-created event"]
  node_validated_event["Inventory-validated event"]
  node_confirmed_event["Order-confirmed event"]
end

subgraph group_platform["Service entry points"]
  node_gateway["API gateway<br/>[Program.cs]"]
  node_delivery["Delivery service<br/>[Program.cs]"]
end

node_customer(("Ordering client"))

node_customer -.->|"submits order"| node_orders_api
node_orders_api -->|"delegates to"| node_orders_service
node_orders_service -->|"writes and reads"| node_order_store
node_orders_service -->|"publishes"| node_created_event
node_order_consumer -->|"consumes"| node_created_event
node_order_consumer -->|"checks inventory"| node_products_service
node_order_consumer -.->|"publishes"| node_validated_event
node_inventory_consumer -->|"consumes"| node_validated_event
node_inventory_consumer -->|"updates order"| node_orders_service
node_inventory_consumer -->|"publishes"| node_confirmed_event
node_kitchen_consumer -->|"consumes"| node_confirmed_event
node_kitchen_consumer -->|"creates kitchen order"| node_kitchen_service
node_products_api -->|"delegates to"| node_products_service
node_products_service -->|"reads products"| node_catalog_store
node_kitchen_api -->|"delegates to"| node_kitchen_service
node_kitchen_service -->|"reads and writes"| node_kitchen_store

click node_gateway "https://github.com/l1nehalt/food-delivery/blob/main/src/ApiGateway/Program.cs"
click node_orders_api "https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Controllers/OrdersController.cs"
click node_orders_service "https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Services/OrdersService.cs"
click node_order_store "https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Data/OrderDbContext.cs"
click node_inventory_consumer "https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Consumers/InventoryValidatedConsumer.cs"
click node_products_api "https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Controllers/ProductsController.cs"
click node_products_service "https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Services/ProductsService.cs"
click node_catalog_store "https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Data/CatalogDbContext.cs"
click node_order_consumer "https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Consumers/OrderCreatedConsumer.cs"
click node_kitchen_consumer "https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Consumers/OrderConfirmedConsumer.cs"
click node_kitchen_service "https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Services/KitchenService.cs"
click node_kitchen_api "https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Controllers/KitchenController.cs"
click node_kitchen_store "https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Data/KitchenDbContext.cs"
click node_created_event "https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Orders/OrderCreatedEvent.cs"
click node_validated_event "https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Catalog/InventoryValidatedEvent.cs"
click node_confirmed_event "https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Orders/OrderConfirmedEvent.cs"
click node_delivery "https://github.com/l1nehalt/food-delivery/blob/main/src/DeliveryService/Program.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_orders_api,node_orders_service,node_order_store,node_inventory_consumer,node_customer toneBlue
class node_products_api,node_products_service,node_catalog_store,node_order_consumer toneAmber
class node_kitchen_consumer,node_kitchen_service,node_kitchen_api,node_kitchen_store toneMint
class node_created_event,node_validated_event,node_confirmed_event toneRose
class node_gateway,node_delivery toneIndigo
```

## Components

### Order management

- [Orders API](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Controllers/OrdersController.cs): `src/OrderService/Controllers/OrdersController.cs`
- [Order workflow](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Services/OrdersService.cs): `src/OrderService/Services/OrdersService.cs`
- [Order database](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Data/OrderDbContext.cs): `src/OrderService/Data/OrderDbContext.cs`
- [Inventory response](https://github.com/l1nehalt/food-delivery/blob/main/src/OrderService/Consumers/InventoryValidatedConsumer.cs): `src/OrderService/Consumers/InventoryValidatedConsumer.cs`

### Catalog and inventory

- [Products API](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Controllers/ProductsController.cs): `src/CatalogService/Controllers/ProductsController.cs`
- [Product operations](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Services/ProductsService.cs): `src/CatalogService/Services/ProductsService.cs`
- [Catalog database](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Data/CatalogDbContext.cs): `src/CatalogService/Data/CatalogDbContext.cs`
- [Order validation](https://github.com/l1nehalt/food-delivery/blob/main/src/CatalogService/Consumers/OrderCreatedConsumer.cs): `src/CatalogService/Consumers/OrderCreatedConsumer.cs`

### Kitchen operations

- [Kitchen intake](https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Consumers/OrderConfirmedConsumer.cs): `src/KitchenService/Consumers/OrderConfirmedConsumer.cs`
- [Kitchen operations](https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Services/KitchenService.cs): `src/KitchenService/Services/KitchenService.cs`
- [Kitchen API](https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Controllers/KitchenController.cs): `src/KitchenService/Controllers/KitchenController.cs`
- [Kitchen database](https://github.com/l1nehalt/food-delivery/blob/main/src/KitchenService/Data/KitchenDbContext.cs): `src/KitchenService/Data/KitchenDbContext.cs`

### Event contracts

- [Order-created event](https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Orders/OrderCreatedEvent.cs): `src/Contracts/Orders/OrderCreatedEvent.cs`
- [Inventory-validated event](https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Catalog/InventoryValidatedEvent.cs): `src/Contracts/Catalog/InventoryValidatedEvent.cs`
- [Order-confirmed event](https://github.com/l1nehalt/food-delivery/blob/main/src/Contracts/Orders/OrderConfirmedEvent.cs): `src/Contracts/Orders/OrderConfirmedEvent.cs`

### Service entry points

- [API gateway](https://github.com/l1nehalt/food-delivery/blob/main/src/ApiGateway/Program.cs): `src/ApiGateway/Program.cs`
- [Delivery service](https://github.com/l1nehalt/food-delivery/blob/main/src/DeliveryService/Program.cs): `src/DeliveryService/Program.cs`

### Other components

- **Ordering client**

## Connections

- Ordering client → Orders API: submits order
- Orders API → Order workflow: delegates to (evidence: `src/OrderService/Controllers/OrdersController.cs`)
- Order workflow → Order database: writes and reads (evidence: `src/OrderService/Services/OrdersService.cs`)
- Order workflow → Order-created event: publishes (evidence: `src/OrderService/Services/OrdersService.cs`)
- Order validation → Order-created event: consumes (evidence: `src/CatalogService/Consumers/OrderCreatedConsumer.cs`)
- Order validation → Product operations: checks inventory (evidence: `src/CatalogService/Consumers/OrderCreatedConsumer.cs`)
- Order validation → Inventory-validated event: publishes (evidence: `src/CatalogService/Consumers/OrderCreatedConsumer.cs`)
- Inventory response → Inventory-validated event: consumes (evidence: `src/OrderService/Consumers/InventoryValidatedConsumer.cs`)
- Inventory response → Order workflow: updates order (evidence: `src/OrderService/Consumers/InventoryValidatedConsumer.cs`)
- Inventory response → Order-confirmed event: publishes (evidence: `src/OrderService/Consumers/InventoryValidatedConsumer.cs`)
- Kitchen intake → Order-confirmed event: consumes (evidence: `src/KitchenService/Consumers/OrderConfirmedConsumer.cs`)
- Kitchen intake → Kitchen operations: creates kitchen order (evidence: `src/KitchenService/Consumers/OrderConfirmedConsumer.cs`)
- Products API → Product operations: delegates to (evidence: `src/CatalogService/Controllers/ProductsController.cs`)
- Product operations → Catalog database: reads products (evidence: `src/CatalogService/Services/ProductsService.cs`)
- Kitchen API → Kitchen operations: delegates to (evidence: `src/KitchenService/Controllers/KitchenController.cs`)
- Kitchen operations → Kitchen database: reads and writes (evidence: `src/KitchenService/Services/KitchenService.cs`)
