# easyquery/dotnetsamples architecture

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

- Interactive diagram: https://gitdiagram.com/easyquery/dotnetsamples
- Repository: https://github.com/easyquery/dotnetsamples

## Overview

This repository is a collection of EasyQuery integration samples, not one deployable application. Its principal workflow lets users configure a search or report, submit query criteria, and inspect filtered or shaped results; a separate filtering scenario adds paging and text search to an existing data page. The samples span ASP.NET MVC, Razor, WebForms, JavaScript frameworks, Blazor, WinForms, and WPF. The graph groups representative runtime components and major documented capabilities; unsampled implementations are represented only at paths supported by the tree or README.

Main entry points: [`AspNetCore/Razor-Mvc/Razor.AdHocReporting`](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting) (Report API), [`AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs`](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs) (Order filtering), [`AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs`](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs) (Saved queries), [`AspNetCore/Razor-Mvc/Razor.AdvancedSearch`](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdvancedSearch) (Search service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Advanced search"]
  node_search_ui["Search interfaces"]
  node_search_web_variants["Framework variants"]
  node_search_service["Search service"]
  node_search_data[("Sample data context<br/>[AppDbContext.cs]")]
end

subgraph group_reporting["Ad-hoc reporting"]
  node_report_ui["Report view"]
  node_report_api["Report API"]
  node_report_generator["Report generator"]
  node_report_store[("Report store<br/>[ReportStore.cs]")]
  node_report_db[("Reporting database<br/>[AppDbContext.cs]")]
end

subgraph group_filtering["Data filtering"]
  node_filter_ui["Filtering interfaces<br/>[site.js]"]
  node_filter_controller["Order filtering<br/>[OrderController.cs]"]
  node_filter_store[("Saved queries<br/>[DbQueryStore.cs]")]
  node_user_query["User query record<br/>[UserQuery.cs]"]
  node_filter_db[("Orders database<br/>[AppDbContext.cs]")]
end

subgraph group_web["Web samples"]
  node_webforms_search["WebForms search"]
end

subgraph group_desktop["Desktop samples"]
  node_desktop_query["WPF query page"]
end

node_user(("End user"))
node_desktop_user(("Desktop user"))

node_user -.->|"sets criteria"| node_search_ui
node_search_ui -.->|"submits query"| node_search_service
node_search_web_variants -.->|"submits query"| node_search_service
node_search_service -.->|"queries data"| node_search_data
node_search_data -.->|"returns matches"| node_user
node_user -.->|"configures report"| node_report_ui
node_report_ui -.->|"requests report"| node_report_api
node_report_api -.->|"generates output"| node_report_generator
node_report_api -.->|"manages reports"| node_report_store
node_report_api -.->|"reads data"| node_report_db
node_report_generator -.->|"renders results"| node_user
node_user -.->|"sets filter"| node_filter_ui
node_filter_ui -.->|"submits filter"| node_filter_controller
node_filter_controller -->|"saves query"| node_filter_store
node_filter_store -->|"persists query"| node_user_query
node_filter_store -->|"reads and writes"| node_filter_db
node_filter_controller -->|"filters orders"| node_filter_db
node_filter_controller -.->|"returns page"| node_user
node_user -.->|"searches records"| node_webforms_search
node_desktop_user -->|"builds query"| node_desktop_query
node_desktop_query -->|"shows results"| node_desktop_user

click node_search_ui "https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Angular/AdvancedSearch/ClientApp/src/app/easyquery"
click node_search_web_variants "https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/React/AdvancedSearch/ClientApp/src/components"
click node_search_service "https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdvancedSearch"
click node_search_data "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdvancedSearch/Data/AppDbContext.cs"
click node_report_ui "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Angular/AdHocReporting/AdHocReporting.%D0%A1lient/src/app/components/report-view/report-view.component.ts"
click node_report_api "https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting"
click node_report_generator "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/DefaultReportGenerator.cs"
click node_report_store "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/ReportStore.cs"
click node_report_db "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Data/AppDbContext.cs"
click node_filter_ui "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/wwwroot/js/site.js"
click node_filter_controller "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs"
click node_filter_store "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs"
click node_user_query "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Models/UserQuery.cs"
click node_filter_db "https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Data/AppDbContext.cs"
click node_webforms_search "https://github.com/easyquery/dotnetsamples/blob/master/AspNet4/WebForms/AdvancedSearch/Controllers/AdvancedSearchController.cs"
click node_desktop_query "https://github.com/easyquery/dotnetsamples/blob/master/Wpf/EqDemoWpfNet6/EasyQueryPage.xaml.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_search_ui,node_search_web_variants,node_search_service,node_search_data,node_user,node_desktop_user toneBlue
class node_report_ui,node_report_api,node_report_generator,node_report_store,node_report_db toneAmber
class node_filter_ui,node_filter_controller,node_filter_store,node_user_query,node_filter_db toneMint
class node_webforms_search toneRose
class node_desktop_query toneIndigo
```

## Components

### Advanced search

- [Search interfaces](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Angular/AdvancedSearch/ClientApp/src/app/easyquery): `AspNetCore/Angular/AdvancedSearch/ClientApp/src/app/easyquery`
- [Framework variants](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/React/AdvancedSearch/ClientApp/src/components): `AspNetCore/React/AdvancedSearch/ClientApp/src/components`
- [Search service](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdvancedSearch): `AspNetCore/Razor-Mvc/Razor.AdvancedSearch`
- [Sample data context](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdvancedSearch/Data/AppDbContext.cs): `AspNetCore/Razor-Mvc/Razor.AdvancedSearch/Data/AppDbContext.cs`

### Ad-hoc reporting

- [Report view](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Angular/AdHocReporting/AdHocReporting.%D0%A1lient/src/app/components/report-view/report-view.component.ts): `AspNetCore/Angular/AdHocReporting/AdHocReporting.Сlient/src/app/components/report-view/report-view.component.ts`
- [Report API](https://github.com/easyquery/dotnetsamples/tree/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting): `AspNetCore/Razor-Mvc/Razor.AdHocReporting`
- [Report generator](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/DefaultReportGenerator.cs): `AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/DefaultReportGenerator.cs`
- [Report store](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/ReportStore.cs): `AspNetCore/Razor-Mvc/Razor.AdHocReporting/Services/ReportStore.cs`
- [Reporting database](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Razor.AdHocReporting/Data/AppDbContext.cs): `AspNetCore/Razor-Mvc/Razor.AdHocReporting/Data/AppDbContext.cs`

### Data filtering

- [Filtering interfaces](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/wwwroot/js/site.js): `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/wwwroot/js/site.js`
- [Order filtering](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs): `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs`
- [Saved queries](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs): `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs`
- [User query record](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Models/UserQuery.cs): `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Models/UserQuery.cs`
- [Orders database](https://github.com/easyquery/dotnetsamples/blob/master/AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Data/AppDbContext.cs): `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Data/AppDbContext.cs`

### Web samples

- [WebForms search](https://github.com/easyquery/dotnetsamples/blob/master/AspNet4/WebForms/AdvancedSearch/Controllers/AdvancedSearchController.cs): `AspNet4/WebForms/AdvancedSearch/Controllers/AdvancedSearchController.cs`

### Desktop samples

- [WPF query page](https://github.com/easyquery/dotnetsamples/blob/master/Wpf/EqDemoWpfNet6/EasyQueryPage.xaml.cs): `Wpf/EqDemoWpfNet6/EasyQueryPage.xaml.cs`

### Other components

- **End user**
- **Desktop user**

## Connections

- End user → Search interfaces: sets criteria
- Search interfaces → Search service: submits query
- Framework variants → Search service: submits query
- Search service → Sample data context: queries data
- Sample data context → End user: returns matches
- End user → Report view: configures report
- Report view → Report API: requests report
- Report API → Report generator: generates output
- Report API → Report store: manages reports
- Report API → Reporting database: reads data
- Report generator → End user: renders results
- End user → Filtering interfaces: sets filter
- Filtering interfaces → Order filtering: submits filter
- Order filtering → Saved queries: saves query (evidence: `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs`)
- Saved queries → User query record: persists query (evidence: `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs`)
- Saved queries → Orders database: reads and writes (evidence: `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Services/DbQueryStore.cs`)
- Order filtering → Orders database: filters orders (evidence: `AspNetCore/Razor-Mvc/Mvc.DataFiltering.Auth/Controllers/OrderController.cs`)
- Order filtering → End user: returns page
- End user → WebForms search: searches records
- Desktop user → WPF query page: builds query (evidence: `Wpf/EqDemoWpfNet6/EasyQueryPage.xaml.cs`)
- WPF query page → Desktop user: shows results (evidence: `Wpf/EqDemoWpfNet6/EasyQueryPage.xaml.cs`)
