# asp-net-core-based-projects/practical-aspnetcore architecture

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

- Interactive diagram: https://gitdiagram.com/asp-net-core-based-projects/practical-aspnetcore
- Repository: https://github.com/asp-net-core-based-projects/practical-aspnetcore

## Overview

This repository is a learning collection of 306 independent ASP.NET Core samples, not one deployable application. A learner chooses a topic, opens a sample, and runs it; the README organizes examples around fundamentals and specialized areas such as MVC, Razor Pages, Blazor, SignalR, security, and framework-version updates. The graph highlights representative runtime capabilities, including guestbook CRUD, Identity account flows, WebSockets, and middleware diagnostics. Sampled source supports the implementation links shown; other branches reflect README categories, not inspected internals.

Main entry points: [`projects/security/authentication-with-identity/src/Controllers/AccountController.cs`](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/Controllers/AccountController.cs) (Account Flows), [`projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs`](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs) (Guestbook Context), [`projects/2-0/razor-pages-mvc/Controllers/EntryController.cs`](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Controllers/EntryController.cs) (Guestbook Actions), [`projects/hello-world-startup-basic/src/Program.cs`](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/hello-world-startup-basic/src/Program.cs) (Hosting and HTTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fundamentals["ASP.NET Fundamentals"]
  node_fundamental_samples["Hosting and HTTP<br/>[Program.cs]"]
  node_middleware_diagnostics["Middleware Diagnostics<br/>[Program.cs]"]
end

subgraph group_webapps["Web Applications"]
  node_mvc_samples["MVC Samples<br/>[Program.cs]"]
  node_razor_pages["Razor Pages<br/>[Index.cshtml.cs]"]
  node_guestbook_controller["Guestbook Actions<br/>[EntryController.cs]"]
  node_guestbook_context["Guestbook Context"]
  node_guestbook_entry["Guestbook Entry<br/>[Entry.cs]"]
  node_blazor_samples["Blazor Samples<br/>[Program.cs]"]
end

subgraph group_realtime["Realtime and APIs"]
  node_signalr_samples["SignalR Samples<br/>[Program.cs]"]
  node_websocket_chat["WebSocket Chat<br/>[Program.cs]"]
  node_grpc_samples["gRPC Samples<br/>[Program.cs]"]
end

subgraph group_identity["Identity and Security"]
  node_identity_account["Account Flows"]
  node_login_model["Login Model<br/>[LoginViewModel.cs]"]
  node_register_model["Registration Model"]
  node_email_sender["Email Sender<br/>[IEmailSender.cs]"]
end

subgraph group_catalog["Sample Catalog"]
  node_sample_collection["Sample Collection"]
end

node_learner(("Learner"))

node_learner -->|"chooses topic"| node_sample_collection
node_learner -->|"runs sample"| node_fundamental_samples
node_sample_collection -->|"includes MVC"| node_mvc_samples
node_sample_collection -->|"includes Razor Pages"| node_razor_pages
node_sample_collection -->|"includes Blazor"| node_blazor_samples
node_sample_collection -->|"includes SignalR"| node_signalr_samples
node_sample_collection -->|"includes security"| node_identity_account
node_guestbook_controller -->|"reads and writes"| node_guestbook_context
node_guestbook_context -->|"stores entries"| node_guestbook_entry
node_identity_account -->|"accepts registration"| node_register_model
node_identity_account -->|"accepts login"| node_login_model
node_identity_account -->|"sends confirmation"| node_email_sender

click node_fundamental_samples "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/hello-world-startup-basic/src/Program.cs"
click node_middleware_diagnostics "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/diagnostics-6/src/Program.cs"
click node_mvc_samples "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/mvc/hello-world/src/Program.cs"
click node_razor_pages "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Pages/RazorPages/Index.cshtml.cs"
click node_guestbook_controller "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Controllers/EntryController.cs"
click node_guestbook_context "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs"
click node_guestbook_entry "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Data/Entry.cs"
click node_blazor_samples "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/blazor/HelloWorld/Program.cs"
click node_signalr_samples "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/signalr/signalr-2/src/Program.cs"
click node_websocket_chat "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/web-sockets-5/src/Program.cs"
click node_grpc_samples "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/3-0/grpc/server/src/Program.cs"
click node_identity_account "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/Controllers/AccountController.cs"
click node_login_model "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/LoginViewModel.cs"
click node_register_model "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/RegisterViewModel.cs"
click node_email_sender "https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/Services/IEmailSender.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_fundamental_samples,node_middleware_diagnostics toneBlue
class node_mvc_samples,node_razor_pages,node_guestbook_controller,node_guestbook_context,node_guestbook_entry,node_blazor_samples toneAmber
class node_signalr_samples,node_websocket_chat,node_grpc_samples toneMint
class node_identity_account,node_login_model,node_register_model,node_email_sender toneRose
class node_sample_collection,node_learner toneIndigo
```

## Components

### ASP.NET Fundamentals

- [Hosting and HTTP](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/hello-world-startup-basic/src/Program.cs): `projects/hello-world-startup-basic/src/Program.cs`
- [Middleware Diagnostics](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/diagnostics-6/src/Program.cs): `projects/diagnostics-6/src/Program.cs`

### Web Applications

- [MVC Samples](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/mvc/hello-world/src/Program.cs): `projects/mvc/hello-world/src/Program.cs`
- [Razor Pages](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Pages/RazorPages/Index.cshtml.cs): `projects/2-0/razor-pages-mvc/Pages/RazorPages/Index.cshtml.cs`
- [Guestbook Actions](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Controllers/EntryController.cs): `projects/2-0/razor-pages-mvc/Controllers/EntryController.cs`
- [Guestbook Context](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs): `projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs`
- [Guestbook Entry](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/2-0/razor-pages-mvc/Data/Entry.cs): `projects/2-0/razor-pages-mvc/Data/Entry.cs`
- [Blazor Samples](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/blazor/HelloWorld/Program.cs): `projects/blazor/HelloWorld/Program.cs`

### Realtime and APIs

- [SignalR Samples](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/signalr/signalr-2/src/Program.cs): `projects/signalr/signalr-2/src/Program.cs`
- [WebSocket Chat](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/web-sockets-5/src/Program.cs): `projects/web-sockets-5/src/Program.cs`
- [gRPC Samples](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/3-0/grpc/server/src/Program.cs): `projects/3-0/grpc/server/src/Program.cs`

### Identity and Security

- [Account Flows](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/Controllers/AccountController.cs): `projects/security/authentication-with-identity/src/Controllers/AccountController.cs`
- [Login Model](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/LoginViewModel.cs): `projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/LoginViewModel.cs`
- [Registration Model](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/RegisterViewModel.cs): `projects/security/authentication-with-identity/src/ViewModels/AccountViewModels/RegisterViewModel.cs`
- [Email Sender](https://github.com/asp-net-core-based-projects/practical-aspnetcore/blob/master/projects/security/authentication-with-identity/src/Services/IEmailSender.cs): `projects/security/authentication-with-identity/src/Services/IEmailSender.cs`

### Sample Catalog

- **Sample Collection**

### Other components

- **Learner**

## Connections

- Learner → Sample Collection: chooses topic (evidence: `README.md`)
- Learner → Hosting and HTTP: runs sample (evidence: `README.md`)
- Sample Collection → MVC Samples: includes MVC (evidence: `README.md`)
- Sample Collection → Razor Pages: includes Razor Pages (evidence: `README.md`)
- Sample Collection → Blazor Samples: includes Blazor (evidence: `README.md`)
- Sample Collection → SignalR Samples: includes SignalR (evidence: `README.md`)
- Sample Collection → Account Flows: includes security (evidence: `README.md`)
- Guestbook Actions → Guestbook Context: reads and writes (evidence: `projects/2-0/razor-pages-mvc/Controllers/EntryController.cs`)
- Guestbook Context → Guestbook Entry: stores entries (evidence: `projects/2-0/razor-pages-mvc/Data/GuestbookContext.cs`)
- Account Flows → Registration Model: accepts registration (evidence: `projects/security/authentication-with-identity/src/Controllers/AccountController.cs`)
- Account Flows → Login Model: accepts login (evidence: `projects/security/authentication-with-identity/src/Controllers/AccountController.cs`)
- Account Flows → Email Sender: sends confirmation (evidence: `projects/security/authentication-with-identity/src/Controllers/AccountController.cs`)
