# alnuaimicoder/aspire-hosting-quartz architecture

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

- Interactive diagram: https://gitdiagram.com/alnuaimicoder/aspire-hosting-quartz
- Repository: https://github.com/alnuaimicoder/aspire-hosting-quartz

## Overview

1. **What this repo is**
   - This is a .NET library for integrating Quartz.NET with .NET Aspire.
   - The architecture is split into a reusable runtime package, an Aspire hosting package, and a small abstractions package, with a sample Aspire app proving the end-to-end flow.

2. **Core layering**
   - `Aspire.Quartz.Abstractions` defines the minimal job contract and job metadata types.
   - `Aspire.Quartz` contains the runtime client, serialization, idempotency, validation, and health-check logic.
   - `Aspire.Hosting.Quartz` adds Aspire resource/hosting integration, including migration handling and resource extensions.

3. **Job contract boundary**
   - Jobs implement `IJob` from the abstractions package.
   - `JobContext`, `JobOptions`, and `RetryPolicy` are the cross-layer data model used to describe execution, retries, and scheduling behavior without tying callers to Quartz internals.

4. **Runtime scheduling path**
   - The service-side package exposes `IBackgroundJobClient` and `QuartzClientExtensions` so application code can enqueue or schedule jobs dynamically.
   - `BackgroundJobClient`, `JobSerializer`, and `CronExpressionValidator` form the runtime path from API call to Quartz persistence and trigger creation.
   - `DuplicateJobException` and `IdempotencyStore` enforce “don’t run twice” semantics around job submission.

5. **Quartz persistence and database access**
   - Persistent scheduling is database-backed rather than in-memory.
   - `DbConnectionFactory` abstracts connection creation, while the README and sample indicate support for PostgreSQL, SQL Server, MySQL, and SQLite.
   - The repo treats the Quartz database as a shared infrastructure dependency for scheduling, state, and idempotency.

6. **Aspire hosting integration**
   - `Aspire.Hosting.Quartz` is the boundary where Quartz becomes an Aspire resource.
   - `QuartzResource`, `QuartzHostingExtensions`, and `QuartzResourceExtensions` let an AppHost declare and configure Quartz as part of the distributed application model.
   - `QuartzMigrationService` plus the SQL migration script classes handle automatic schema setup during hosting.

7. **Sample distributed application**
   - `samples/QuartzSample.AppHost` is the orchestration entry point.
   - It composes the infrastructure, references the API service, and wires shared dependencies using Aspire conventions.
   - The README’s sample flow emphasizes that jobs run inside the API service, so there is no separate worker process.

8. **API service role in the sample**
   - `samples/QuartzSample.ApiService` is where Quartz is configured and where jobs execute.
   - It contains Quartz job classes, a job scheduler service, a listener, and a SignalR hub for job-status notifications.
   - It also includes EF Core database context and migrations for the sample’s persistence/demo features.

9. **Web client and user-facing monitoring**
   - `samples/QuartzSample.Web` is a Blazor front end.
   - It talks to the API through `QuartzApiClient`, and the presence of `QuartzDashboard.razor` and the SignalR hub suggests the sample exposes live job-monitoring UI.
   - This web project is not the scheduler itself; it is an observer/control plane for the sample system.

10. **Operational concerns**
   - `QuartzHealthCheck` provides Aspire Dashboard-friendly health reporting for scheduler availability.
   - OpenTelemetry is called out in the README as a first-class concern, so observability is part of the runtime architecture rather than an afterthought.
   - The hosting package’s migration support is another operational boundary: schema readiness is handled alongside app startup.

11. **Testing and release structure**
   - The repo is organized as a typical library workspace with unit-test projects for abstractions, runtime behavior, and hosting behavior.
   - CI/release workflows, versioning docs, and packaging configuration indicate the main deliverable is NuGet packages rather than a standalone application.

12. **How data flows end to end**
   - AppHost declares the infrastructure and service references.
   - The API service configures Quartz with persistence and hosted execution.
   - Application code submits jobs through `IBackgroundJobClient` or schedules them statically.
   - Quartz persists and executes jobs against the shared database, while health checks and the sample UI surface status back to operators.

Main entry points: [`src/Aspire.Quartz/BackgroundJobClient.cs`](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/BackgroundJobClient.cs) (BackgroundJobClient), [`samples/QuartzSample.ApiService/Program.cs`](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Program.cs) (ApiService), [`src/Aspire.Hosting.Quartz/QuartzResource.cs`](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzResource.cs) (QuartzResource), [`src/Aspire.Hosting.Quartz/QuartzMigrationService.cs`](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzMigrationService.cs) (Migration service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_abstractions["Abstractions"]
  node_node_ijob["IJob<br/>job contract<br/>[IJob.cs]"]
  node_node_jobcontext["JobContext<br/>job model<br/>[JobContext.cs]"]
  node_node_joboptions["JobOptions<br/>schedule model<br/>[JobOptions.cs]"]
  node_node_retrypolicy["RetryPolicy<br/>retry model<br/>[RetryPolicy.cs]"]
end

subgraph group_group_runtime["Runtime"]
  node_node_backgroundclient["BackgroundJobClient<br/>submission client"]
  node_node_clientext["QuartzClientExtensions<br/>service extensions"]
  node_node_serializer["JobSerializer<br/>serialization<br/>[JobSerializer.cs]"]
  node_node_validator["CronValidator<br/>validation"]
  node_node_idempotency[("IdempotencyStore<br/>dedup store")]
  node_node_dupjob(("DuplicateJobException<br/>submission error"))
  node_node_dbfactory[("DbConnectionFactory<br/>db access")]
  node_node_health(("QuartzHealthCheck<br/>health check"))
end

subgraph group_group_hosting["Hosting"]
  node_node_quartzresource{{"QuartzResource<br/>aspire resource<br/>[QuartzResource.cs]"}}
  node_node_hostext["Hosting extensions<br/>aspire integration"]
  node_node_resourceext["Resource extensions<br/>resource config"]
  node_node_migrationservice["Migration service<br/>schema setup"]
  node_node_pgscript["PostgreSQL script<br/>migration sql"]
  node_node_sqlscript["SQL Server script<br/>migration sql"]
end

subgraph group_group_sample["Sample app"]
  node_node_apphost["AppHost<br/>orchestration entry<br/>[AppHost.cs]"]
  node_node_apiservice["ApiService<br/>execution service<br/>[Program.cs]"]
  node_node_quartzextensions["Quartz setup<br/>service wiring"]
  node_node_scheduler["Job scheduler<br/>app service"]
  node_node_listener["Job listener<br/>execution observer"]
  node_node_hub(("Quartz hub<br/>signalr hub<br/>[QuartzHub.cs]"))
  node_node_web["Web UI<br/>blazor client<br/>[Program.cs]"]
  node_node_apiclient["Api client<br/>http client<br/>[QuartzApiClient.cs]"]
  node_node_dashboard["Dashboard<br/>monitoring ui"]
end

subgraph group_group_tests["Tests"]
  node_node_absttests["Abstractions tests<br/>test project"]
  node_node_runtimetests["Runtime tests<br/>test project"]
  node_node_hosttests["Hosting tests<br/>test project"]
end

node_node_ijob -->|"executes with"| node_node_jobcontext
node_node_joboptions -->|"contains"| node_node_retrypolicy
node_node_clientext -->|"registers"| node_node_backgroundclient
node_node_backgroundclient -->|"serializes"| node_node_serializer
node_node_backgroundclient -->|"validates"| node_node_validator
node_node_backgroundclient -->|"guards"| node_node_idempotency
node_node_idempotency -->|"throws"| node_node_dupjob
node_node_backgroundclient -->|"persists via"| node_node_dbfactory
node_node_health -->|"checks"| node_node_dbfactory
node_node_hostext -->|"adds"| node_node_quartzresource
node_node_resourceext -->|"configures"| node_node_quartzresource
node_node_migrationservice -->|"uses"| node_node_pgscript
node_node_migrationservice -->|"uses"| node_node_sqlscript
node_node_apphost -->|"wires"| node_node_hostext
node_node_apphost -->|"references"| node_node_apiservice
node_node_apiservice -->|"configures"| node_node_quartzextensions
node_node_quartzextensions -->|"uses"| node_node_backgroundclient
node_node_apiservice -->|"hosts"| node_node_scheduler
node_node_apiservice -->|"observes"| node_node_listener
node_node_apiservice -->|"publishes"| node_node_hub
node_node_web -->|"calls"| node_node_apiclient
node_node_web -->|"renders"| node_node_dashboard
node_node_apiclient -->|"receives updates"| node_node_hub
node_node_absttests -->|"covers"| node_node_ijob
node_node_absttests -->|"covers"| node_node_retrypolicy
node_node_runtimetests -->|"covers"| node_node_dupjob
node_node_hosttests -->|"covers"| node_node_quartzresource

click node_node_ijob "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/IJob.cs"
click node_node_jobcontext "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/JobContext.cs"
click node_node_joboptions "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/JobOptions.cs"
click node_node_retrypolicy "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/RetryPolicy.cs"
click node_node_backgroundclient "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/BackgroundJobClient.cs"
click node_node_clientext "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/QuartzClientExtensions.cs"
click node_node_serializer "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/JobSerializer.cs"
click node_node_validator "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/CronExpressionValidator.cs"
click node_node_idempotency "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/IdempotencyStore.cs"
click node_node_dupjob "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/DuplicateJobException.cs"
click node_node_dbfactory "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/DbConnectionFactory.cs"
click node_node_health "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/QuartzHealthCheck.cs"
click node_node_quartzresource "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzResource.cs"
click node_node_hostext "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzHostingExtensions.cs"
click node_node_resourceext "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzResourceExtensions.cs"
click node_node_migrationservice "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzMigrationService.cs"
click node_node_pgscript "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/PostgreSqlMigrationScript.cs"
click node_node_sqlscript "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/SqlServerMigrationScript.cs"
click node_node_apphost "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.AppHost/AppHost.cs"
click node_node_apiservice "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Program.cs"
click node_node_quartzextensions "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Extensions/QuartzExtensions.cs"
click node_node_scheduler "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Services/QuartzJobScheduler.cs"
click node_node_listener "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Listeners/QuartzJobListener.cs"
click node_node_hub "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Hubs/QuartzHub.cs"
click node_node_web "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Program.cs"
click node_node_apiclient "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Services/QuartzApiClient.cs"
click node_node_dashboard "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Components/Pages/QuartzDashboard.razor"
click node_node_absttests "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests.csproj"
click node_node_runtimetests "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Quartz.Tests/CommunityToolkit.Aspire.Quartz.Tests.csproj"
click node_node_hosttests "https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests.csproj"

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_node_ijob,node_node_jobcontext,node_node_joboptions,node_node_retrypolicy toneBlue
class node_node_backgroundclient,node_node_clientext,node_node_serializer,node_node_validator,node_node_idempotency,node_node_dupjob,node_node_dbfactory,node_node_health toneAmber
class node_node_quartzresource,node_node_hostext,node_node_resourceext,node_node_migrationservice,node_node_pgscript,node_node_sqlscript toneMint
class node_node_apphost,node_node_apiservice,node_node_quartzextensions,node_node_scheduler,node_node_listener,node_node_hub,node_node_web,node_node_apiclient,node_node_dashboard toneRose
class node_node_absttests,node_node_runtimetests,node_node_hosttests toneIndigo
```

## Components

### Abstractions

Shared job contract and execution model.

- [IJob](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/IJob.cs): job contract · Minimal job boundary implemented by app jobs. · `src/Aspire.Quartz.Abstractions/IJob.cs`
- [JobContext](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/JobContext.cs): job model · Cross-layer execution context passed to jobs. · `src/Aspire.Quartz.Abstractions/JobContext.cs`
- [JobOptions](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/JobOptions.cs): schedule model · Metadata for scheduling and execution behavior. · `src/Aspire.Quartz.Abstractions/JobOptions.cs`
- [RetryPolicy](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz.Abstractions/RetryPolicy.cs): retry model · Retry configuration shared across layers. · `src/Aspire.Quartz.Abstractions/RetryPolicy.cs`

### Runtime

Client, serialization, persistence, and health logic.

- [BackgroundJobClient](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/BackgroundJobClient.cs): submission client · Runtime API for enqueueing and scheduling jobs. · `src/Aspire.Quartz/BackgroundJobClient.cs`
- [QuartzClientExtensions](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/QuartzClientExtensions.cs): service extensions · Registers the runtime client in application services. · `src/Aspire.Quartz/QuartzClientExtensions.cs`
- [JobSerializer](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/JobSerializer.cs): serialization · Converts job payloads to Quartz-storable form. · `src/Aspire.Quartz/JobSerializer.cs`
- [CronValidator](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/CronExpressionValidator.cs): validation · Checks cron expressions before persistence. · `src/Aspire.Quartz/CronExpressionValidator.cs`
- [IdempotencyStore](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/IdempotencyStore.cs): dedup store · Prevents duplicate job submissions. · `src/Aspire.Quartz/IdempotencyStore.cs`
- [DuplicateJobException](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/DuplicateJobException.cs): submission error · Raised when a job would be submitted twice. · `src/Aspire.Quartz/DuplicateJobException.cs`
- [DbConnectionFactory](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/DbConnectionFactory.cs): db access · Creates database connections for Quartz persistence. · `src/Aspire.Quartz/DbConnectionFactory.cs`
- [QuartzHealthCheck](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Quartz/QuartzHealthCheck.cs): health check · Reports scheduler readiness to Aspire dashboard. · `src/Aspire.Quartz/QuartzHealthCheck.cs`

### Hosting

Aspire resource integration and schema setup.

- [QuartzResource](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzResource.cs): aspire resource · Represents Quartz in the Aspire app model. · `src/Aspire.Hosting.Quartz/QuartzResource.cs`
- [Hosting extensions](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzHostingExtensions.cs): aspire integration · Adds Quartz resource wiring to AppHost. · `src/Aspire.Hosting.Quartz/QuartzHostingExtensions.cs`
- [Resource extensions](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzResourceExtensions.cs): resource config · Configures the Quartz resource and dependencies. · `src/Aspire.Hosting.Quartz/QuartzResourceExtensions.cs`
- [Migration service](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/QuartzMigrationService.cs): schema setup · Runs Quartz schema migrations during startup. · `src/Aspire.Hosting.Quartz/QuartzMigrationService.cs`
- [PostgreSQL script](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/PostgreSqlMigrationScript.cs): migration sql · PostgreSQL Quartz schema definitions. · `src/Aspire.Hosting.Quartz/PostgreSqlMigrationScript.cs`
- [SQL Server script](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/src/Aspire.Hosting.Quartz/SqlServerMigrationScript.cs): migration sql · SQL Server Quartz schema definitions. · `src/Aspire.Hosting.Quartz/SqlServerMigrationScript.cs`

### Sample app

End-to-end Aspire sample application.

- [AppHost](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.AppHost/AppHost.cs): orchestration entry · Declares the sample distributed application. · `samples/QuartzSample.AppHost/AppHost.cs`
- [ApiService](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Program.cs): execution service · Hosts Quartz and runs scheduled jobs. · `samples/QuartzSample.ApiService/Program.cs`
- [Quartz setup](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Extensions/QuartzExtensions.cs): service wiring · Configures Quartz and runtime integration in the API service. · `samples/QuartzSample.ApiService/Extensions/QuartzExtensions.cs`
- [Job scheduler](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Services/QuartzJobScheduler.cs): app service · Coordinates job submission from the API service. · `samples/QuartzSample.ApiService/Services/QuartzJobScheduler.cs`
- [Job listener](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Listeners/QuartzJobListener.cs): execution observer · Observes job events inside the API service. · `samples/QuartzSample.ApiService/Listeners/QuartzJobListener.cs`
- [Quartz hub](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.ApiService/Hubs/QuartzHub.cs): signalr hub · Pushes job-status updates to the web UI. · `samples/QuartzSample.ApiService/Hubs/QuartzHub.cs`
- [Web UI](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Program.cs): blazor client · User-facing dashboard and control plane. · `samples/QuartzSample.Web/Program.cs`
- [Api client](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Services/QuartzApiClient.cs): http client · Calls the API service from the web app. · `samples/QuartzSample.Web/Services/QuartzApiClient.cs`
- [Dashboard](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/samples/QuartzSample.Web/Components/Pages/QuartzDashboard.razor): monitoring ui · Blazor page for live job monitoring. · `samples/QuartzSample.Web/Components/Pages/QuartzDashboard.razor`

### Tests

Unit tests for the main packages.

- [Abstractions tests](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests.csproj): test project · Validates shared job models and retry policy. · `tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests/CommunityToolkit.Aspire.Quartz.Abstractions.Tests.csproj`
- [Runtime tests](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Quartz.Tests/CommunityToolkit.Aspire.Quartz.Tests.csproj): test project · Covers runtime submission and duplicate detection. · `tests/CommunityToolkit.Aspire.Quartz.Tests/CommunityToolkit.Aspire.Quartz.Tests.csproj`
- [Hosting tests](https://github.com/alnuaimicoder/aspire-hosting-quartz/blob/main/tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests.csproj): test project · Covers Aspire resource behavior. · `tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests/CommunityToolkit.Aspire.Hosting.Quartz.Tests.csproj`

## Connections

- IJob → JobContext: executes with · Jobs receive a shared context.
- JobOptions → RetryPolicy: contains · Job options include retry behavior.
- QuartzClientExtensions → BackgroundJobClient: registers · Extensions expose the submission client.
- BackgroundJobClient → JobSerializer: serializes · Payloads are prepared for Quartz storage.
- BackgroundJobClient → CronValidator: validates · Cron expressions are checked before scheduling.
- BackgroundJobClient → IdempotencyStore: guards · Duplicate submissions are blocked.
- IdempotencyStore → DuplicateJobException: throws · Conflicting submissions raise an exception.
- BackgroundJobClient → DbConnectionFactory: persists via · Jobs are written through database connections.
- QuartzHealthCheck → DbConnectionFactory: checks · Health depends on database-backed scheduler readiness.
- Hosting extensions → QuartzResource: adds · AppHost gets a Quartz resource.
- Resource extensions → QuartzResource: configures · Resource extensions shape deployment settings.
- Migration service → PostgreSQL script: uses · Migration service can apply PostgreSQL schema.
- Migration service → SQL Server script: uses · Migration service can apply SQL Server schema.
- AppHost → Hosting extensions: wires · Sample orchestration composes Quartz hosting.
- AppHost → ApiService: references · AppHost includes the API service.
- ApiService → Quartz setup: configures · API service initializes Quartz.
- Quartz setup → BackgroundJobClient: uses · Service wiring exposes the runtime client.
- ApiService → Job scheduler: hosts · The API service contains job scheduling logic.
- ApiService → Job listener: observes · Job events are monitored in-process.
- ApiService → Quartz hub: publishes · Status updates flow to SignalR clients.
- Web UI → Api client: calls · The web UI talks to the API service.
- Web UI → Dashboard: renders · Dashboard page shows job monitoring.
- Api client → Quartz hub: receives updates · Client consumes live job notifications.
- Abstractions tests → IJob: covers · Tests validate contract behavior.
- Abstractions tests → RetryPolicy: covers · Tests validate retry policy behavior.
- Runtime tests → DuplicateJobException: covers · Runtime tests verify duplicate detection.
- Hosting tests → QuartzResource: covers · Hosting tests verify resource integration.
