# yogyogi/first-asp.net-core-microservice architecture

> Architecture diagram of the GitHub repository yogyogi/first-asp.net-core-microservice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yogyogi/first-asp.net-core-microservice
- Repository: https://github.com/yogyogi/first-asp.net-core-microservice

## Overview

This is an ASP.NET Core order microservice with a Blazor UI: users create, browse, edit, and delete pizza-delivery orders through the UI, which calls the CommandCenter Web API; the API persists orders in MongoDB. The graph separates UI, API/domain, and persistence responsibilities. UI page-to-service wiring and some settings details were not excerpted, so those relationships are omitted; documented CCUI CRUD use is reflected in the workflow description.

Main entry points: [`First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs) (Mongo Setup), [`First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs`](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs) (Order Controller), [`First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs`](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs) (Mongo Repository), [`First-ASP.NET-Core-Microservice/CommandCenter/Entity/IRepository.cs`](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Entity/IRepository.cs) (Repository Contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Blazor UI"]
  node_order_pages["Order Screens<br/>[Orders.razor]"]
  node_edit_page["Edit Order<br/>[EditOrders.razor]"]
  node_ui_service["Order Client<br/>[OrderService.cs]"]
  node_ui_host["UI Host<br/>[Program.cs]"]
end

subgraph group_api["Order API"]
  node_api_host["API Host<br/>[Program.cs]"]
  node_controller["Order Controller<br/>[OrderController.cs]"]
  node_order["Order Entity<br/>[Order.cs]"]
  node_dto_mapping["DTO Mapping<br/>[Extensions.cs]"]
  node_api_dtos["API DTOs<br/>[Dtos.cs]"]
end

subgraph group_persistence["Mongo Persistence"]
  node_repository_contract["Repository Contract<br/>[IRepository.cs]"]
  node_mongo_setup["Mongo Setup<br/>[Extensions.cs]"]
  node_mongo_repository["Mongo Repository<br/>[MongoRepository.cs]"]
  node_mongo_settings["Mongo Settings<br/>[MongoDbSettings.cs]"]
  node_service_settings["Service Settings<br/>[ServiceSettings.cs]"]
end

node_user(("User"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_order_pages
node_user -->|"edits orders"| node_edit_page
node_ui_host -->|"registers"| node_ui_service
node_ui_service -->|"HTTP CRUD"| node_controller
node_api_host -->|"maps routes"| node_controller
node_controller -->|"calls"| node_repository_contract
node_controller -->|"creates and returns"| node_order
node_controller -->|"maps results"| node_dto_mapping
node_mongo_setup -->|"reads settings"| node_mongo_settings
node_mongo_setup -->|"reads settings"| node_service_settings
node_api_host -->|"registers storage"| node_mongo_setup
node_mongo_setup -->|"registers implementation"| node_repository_contract
node_mongo_setup -->|"constructs"| node_mongo_repository
node_mongo_repository -->|"implements"| node_repository_contract
node_mongo_repository -->|"reads and writes"| node_mongo

click node_order_pages "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Components/Pages/Orders.razor"
click node_edit_page "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Components/Pages/EditOrders.razor"
click node_ui_service "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/OrderService.cs"
click node_ui_host "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Program.cs"
click node_api_host "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Program.cs"
click node_controller "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs"
click node_order "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Entity/Order.cs"
click node_dto_mapping "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Extensions.cs"
click node_api_dtos "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Dtos.cs"
click node_repository_contract "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Entity/IRepository.cs"
click node_mongo_setup "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs"
click node_mongo_repository "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs"
click node_mongo_settings "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Setting/MongoDbSettings.cs"
click node_service_settings "https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Setting/ServiceSettings.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_order_pages,node_edit_page,node_ui_service,node_ui_host,node_user toneBlue
class node_api_host,node_controller,node_order,node_dto_mapping,node_api_dtos,node_mongo toneAmber
class node_repository_contract,node_mongo_setup,node_mongo_repository,node_mongo_settings,node_service_settings toneMint
```

## Components

### Blazor UI

- [Order Screens](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Components/Pages/Orders.razor): `First-ASP.NET-Core-Microservice/CCUI/Components/Pages/Orders.razor`
- [Edit Order](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Components/Pages/EditOrders.razor): `First-ASP.NET-Core-Microservice/CCUI/Components/Pages/EditOrders.razor`
- [Order Client](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/OrderService.cs): `First-ASP.NET-Core-Microservice/CCUI/OrderService.cs`
- [UI Host](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CCUI/Program.cs): `First-ASP.NET-Core-Microservice/CCUI/Program.cs`

### Order API

- [API Host](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Program.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Program.cs`
- [Order Controller](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs`
- [Order Entity](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Entity/Order.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Entity/Order.cs`
- [DTO Mapping](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Extensions.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Extensions.cs`
- [API DTOs](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Dtos.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Infrastructure/Dtos.cs`

### Mongo Persistence

- [Repository Contract](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Entity/IRepository.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Entity/IRepository.cs`
- [Mongo Setup](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs): `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`
- [Mongo Repository](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs): `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs`
- [Mongo Settings](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Setting/MongoDbSettings.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Setting/MongoDbSettings.cs`
- [Service Settings](https://github.com/yogyogi/first-asp.net-core-microservice/blob/main/First-ASP.NET-Core-Microservice/CommandCenter/Setting/ServiceSettings.cs): `First-ASP.NET-Core-Microservice/CommandCenter/Setting/ServiceSettings.cs`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Order Screens: uses (evidence: `README.md`)
- User → Edit Order: edits orders (evidence: `README.md`)
- UI Host → Order Client: registers (evidence: `First-ASP.NET-Core-Microservice/CCUI/Program.cs`)
- Order Client → Order Controller: HTTP CRUD (evidence: `First-ASP.NET-Core-Microservice/CCUI/OrderService.cs`)
- API Host → Order Controller: maps routes (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/Program.cs`)
- Order Controller → Repository Contract: calls (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs`)
- Order Controller → Order Entity: creates and returns (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs`)
- Order Controller → DTO Mapping: maps results (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/Controllers/OrderController.cs`)
- Mongo Setup → Mongo Settings: reads settings (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`)
- Mongo Setup → Service Settings: reads settings (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`)
- API Host → Mongo Setup: registers storage (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/Program.cs`)
- Mongo Setup → Repository Contract: registers implementation (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`)
- Mongo Setup → Mongo Repository: constructs (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/Extensions.cs`)
- Mongo Repository → Repository Contract: implements (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs`)
- Mongo Repository → MongoDB: reads and writes (evidence: `First-ASP.NET-Core-Microservice/CommandCenter/MongoDB/MongoRepository.cs`)
