LUX - Agent Instructions

.NET 8 MES (Manufacturing Execution System) for window/door/casing production.

Solutions & Projects

Two solutions:

Lux.All.sln - Main application (build this):

Lux.UI - Blazor Server (identity-secured app), entry point
Lux.UI.Client - Blazor WASM (shared client lib)
Lux.API - REST API (JWD-to-SVG/Engine calls via Redis)
EgwCoreLib.Lux.Core - Core domain/business library (NuGet package)
EgwCoreLib.Lux.Data - EF Core data layer + migrations (NuGet package)

Lux.Report.sln - Reporting:

Lux.Report.Server - Blazor Server report host
Lux.Report.Manager - Blazor Server report manager
Lux.Report.Data - Report domain + EF models

Commands

dotnet restore Lux.All.sln
dotnet build Lux.All.sln
dotnet run --project Lux.UI          # run main app (development)
dotnet run --project Lux.API         # run API

No test project exists. TestDevExpress/ is a Blazor demo app, not unit tests.

Central package management: Directory.Packages.props controls all versions. Edit there, not in individual .csproj files.

Architecture notes

Lux.UI depends on both EgwCoreLib.Lux.Core and EgwCoreLib.Lux.Data
Lux.API depends on Core + Data (no UI layer)
Lux.UI.Client (WASM) shares Components/ Blazor components with Lux.UI
Data layer uses both SQL Server (Identità via ApplicationDbContext) e MySQL (Pomelo, via DataLayerContext)
Redis is used for Engine communication channels and caching
All projects use <Nullable>enable</Nullable> and <ImplicitUsings>enable</ImplicitUsings>
.pubxml IIS publish profiles are version-controlled under Properties/PublishProfiles/
Every project has a post-build.ps1 that runs version stamping

Migrations

Identity migrations: Lux.UI/Data/Migrations/ (SQL Server, ApplicationDbContext)
Domain migrations: EgwCoreLib.Lux.Data/Migrations/ (MySQL, DataLayerContext)

CI/CD

GitLab CI in .gitlab-ci.yml. NuGet sources must be fixed before restore:

dotnet nuget remove source "Steamware Nexus Proxy"
dotnet nuget remove source "nexus-proxy-v3"
dotnet nuget remove source "nexus-hosted"
dotnet nuget add source https://nexus.steamware.net/repository/nuget-proxy-v3/index.json -n nexus-proxy-v3 -u nugetUser -p $NEXUS_PASSWD --store-password-in-clear-text
dotnet nuget add source https://nexus.steamware.net/repository/nuget-hosted/ -n nexus-hosted -u nugetUser -p $NEXUS_PASSWD --store-password-in-clear-text

Frameworks

Radzen.Blazor (UI components)
DevExpress (Blazor reporting, used in Report projects + TestDevExpress)
Newtonsoft.Json, Swashbuckle, NLog, OpenTelemetry (API + UX)
Scrutor (DI extensions)
ZiggyCreatures.FusionCache (L1 memory + L2 Redis caching, used in VocabolarioService)

VocabolarioService (translation/i18n)

Located in EgwCoreLib.Lux.Data\Services\Admin\. Follows Repository + Service pattern:

VocabolarioRepository (EF Core access via IDbContextFactory)
VocabolarioService (Cache orchestration + domain logic)
VocabModel / LinguaModel (EF Core entities, table: admin_vocabolario, admin_lingua)

FusionCache (GetOrFetchAsync helper): L1 Memory (1/3 of total duration) + L2 Redis (fail-safe). Tags used for partial invalidation.

GetAll e GetById usano 10 min expiration
GetByLang e ListLingue usano 5 min expiration
Traduci() usa 5 min L1 + 15 min fail-safe
CRUD operations (Clone/Delete/Upsert/UpsertMany) invalidano la cache Fusion con _cache.ClearAsync()

3.5 KiB Raw Blame History