Lyo.Job.Web.Components 3.0.0

Lyo.Job.Web.Components

Blazor / MudBlazor dashboard for the Lyo job stack. Drop JobManagement on a host page for Statistics, Definitions, Schedules, Runs (progress and SLA breach indicators), worker registry, and workflow views. Uses an injected IApiClient and a configurable base route prefix.

The Workers datagrid uses REST heartbeats plus optional AutoRefresh (on by default) for live registry updates.

Targets server-side or interactive Blazor on net10.0 and pulls in MudBlazor >= 9.3.

This package is a Razor component library. It has no AddXxx DI registration. The host must already register IApiClient.

Examples

Architecture

flowchart LR
    UI[JobManagement tabs] --> API[IApiClient → Job API]
    API --> MQ[job.events exchange]

Top-level entry point

@using Lyo.Job.Web.Components

<JobManagement BaseRoute="Job" StatisticsRoute="api/job-stats/recent" />

MudTabs on JobManagement expose Statistics, Definitions, Schedules, Runs, Workers, and Workflows.

Component catalog

Host a grid or view on its own: each one takes IApiClient plus route parameters and does not require the full shell.

Formatter and condition context

A formatter-typed job parameter is a template, so authors need the keys that will actually resolve.

Definition editor — JobFormatterContext.Build(definition, latestRuns, schedule) builds that key list and matches both runtime stages:

• Scheduler (JobScheduler.BuildTemplateData): Definition, LastRun, LastSuccessfulRun, LastFailedRun, Schedule, plus flattened {prefix}_Result_{key} / {prefix}_Parameter_{key} and Schedule_Parameter_{key} entries.
• Worker (JobWorkerParameterFormatter.SeedJobRun): the jobrun bag (run properties and a Parameters map). {jobrun.parameters.emailTo} reads from that map.

Workflow step editor — JobWorkflowFormatterContext.Build(step, definition, workflow, inputKeys, dependencies) builds the bag for one step of a workflow, which is a different shape: it offers Workflow.*, Input.{key}, CurrentStep.*, Definition.*, and Step.{name}.* for each dependency. It goes through the same JobContextBag.WithWorkflowStep seeder the engine uses at run time, and JobWorkflowFormatterContextTests asserts the editor offers every key the engine seeds, so the two cannot drift. JobWorkflowFormatterContext.Paths walks that bag into the condition editor's field list, sizing the catalog budget to the dependency count so a step with several upstreams is not truncated.

Views receive the bag as FormatterContext. Host-supplied AddContext keys arrive on a separate path through AddLyoFormatterValueEditor. Steps and definitions that have never run still autocomplete on the run paths because LyoSampleShape substitutes for the missing JobRunRes.

UI features

JobColorHelper

One static helper applies the same colors and icons to job state, result, and log level.

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Api.Client (direct, lyo)
• Lyo.Common.Metadata (direct, lyo)
• Lyo.Diagram (direct, lyo)
• Lyo.Formatter (direct, lyo)
• Lyo.Formatter.Web.Components (direct, lyo)
• Lyo.Http.Client (direct, lyo)
• Lyo.Job.Models (direct, lyo)
• Lyo.Parameters (direct, lyo)
• Lyo.Scheduler (direct, lyo)
• Lyo.Web.Components (direct, lyo)
• Lyo.Web.Components.Export (direct, lyo)
• Lyo.Web.Components.Export.Csv (direct, lyo)
• Lyo.Web.Components.Export.Toml (direct, lyo)
• Lyo.Web.Components.Export.Xlsx (direct, lyo)
• Lyo.Web.Components.Export.Xml (direct, lyo)
• Lyo.Web.Components.Export.Yaml (direct, lyo)
• MudBlazor 9.3 (direct, third-party)
• Lyo.Api.Models (transitive, lyo)
• Lyo.Common.Core (transitive, lyo)
• Lyo.DataTable.Models (transitive, lyo)
• Lyo.DateAndTime (transitive, lyo)
• Lyo.Diagnostic (transitive, lyo)
• Lyo.Diagram.Models (transitive, lyo)
• Lyo.Encryption (transitive, lyo)
• Lyo.EntityReference.Models (transitive, lyo)
• Lyo.Exceptions (transitive, lyo)
• Lyo.Hashing (transitive, lyo)
• Lyo.IO.FileSystem (transitive, lyo)
• Lyo.IO.Temp (transitive, lyo)
• Lyo.Json (transitive, lyo)
• Lyo.KeyStore (transitive, lyo)
• Lyo.Metrics (transitive, lyo)
• Lyo.PackageMetadata (transitive, lyo)
• Lyo.Query.Evaluation (transitive, lyo)
• Lyo.Query.Models (transitive, lyo)
• Lyo.Result (transitive, lyo)
• Lyo.Schedule.Models (transitive, lyo)
• Lyo.Streams (transitive, lyo)
• Lyo.Validation (transitive, lyo)
• Lyo.Validation.Models (transitive, lyo)
• Lyo.Web.Primitives (transitive, lyo)
• AngleSharp 1.5.0 (transitive, third-party)
• Blazored.LocalStorage 4.5.0 (transitive, third-party)
• BouncyCastle.Cryptography 2.6.2 (transitive, third-party, netstandard2.0)
• DynamicExpresso.Core 2.19.3 (transitive, third-party)
• Konscious.Security.Cryptography.Argon2 1.3.1 (transitive, third-party)
• Microsoft.Bcl.AsyncInterfaces 10.0.5 (transitive, microsoft, netstandard2.0)
• Microsoft.Extensions.Configuration.Binder 10.0.5 (transitive, microsoft)
• Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 (transitive, microsoft, net10.0, netstandard2.0)
• Microsoft.Extensions.Hosting.Abstractions 10.0.5 (transitive, microsoft)
• Microsoft.Extensions.Http 10.0.5 (transitive, microsoft)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 (transitive, microsoft)
• SmartFormat.NET 3.6.1 (transitive, third-party)
• System.Buffers 4.6.1 (transitive, microsoft, netstandard2.0)
• System.ComponentModel.Annotations 5.0.0 (transitive, microsoft)
• System.Diagnostics.DiagnosticSource 10.0.5 (transitive, microsoft, netstandard2.0)
• System.IO.Hashing 10.0.5 (transitive, microsoft, net10.0)
• System.Memory 4.6.3 (transitive, microsoft, netstandard2.0)
• System.Text.Encoding.CodePages 10.0.5 (transitive, microsoft)
• System.Text.Json 10.0.5 (transitive, microsoft, netstandard2.0)
• System.Threading.RateLimiting 10.0.5 (transitive, microsoft)
• System.Threading.Tasks.Extensions 4.6.3 (transitive, microsoft, netstandard2.0)