IndTrace

IndTrace is an industrial manufacturing traceability system: it tracks parts through manufacturing cycles across production lines (PLC ↔ SQL Server ↔ Blazor).

IndTrace tracks; it does not control. The machine, PLC and operator decide what physically happens. IndTrace records what was done and validates whether it was legal (for example, whether a part's arrival at a station is a legal successor in its routing). It never commands equipment.

What is in this repository

This is the community edition, licensed under the GNU AGPL v3.0 or later.

Area	Projects
Core	IndTrace.Domain, IndTrace.Application (CQRS handlers, Result<T> railway)
Persistence & hosting	IndTrace.Persistence (EF Core / SQL Server), IndTrace.Dependencies, IndTrace.Identity
Gateway	IndTrace.Gateway + IndTrace.Communications (host), IndTrace.Hub.Server (SignalR)
UI	IndTrace.Monitor (Blazor), IndTrace.Components, IndTrace.UI.Models
Devices	IndTrace.Devices — vendor-neutral PLC controller and barcode-reader contracts

The community edition ships an in-memory simulated PLC controller and no barcode-reader driver. Hardware drivers (e.g. Siemens S7, Cognex DataMan) are not part of this repository; they plug in through IPlcControllerFactory and IBarCodeReader in IndTrace.Devices.

Getting started

docs/getting-started.md takes you from an empty SQL Server to a running line with a demo database and a signed-in Monitor. docs/simulate-a-part.md then drives parts through that line with the simulated PLC controller.

Build and test

Requires the .NET 10 SDK.

dotnet build Src/IndTrace.sln
dotnet run --project Src/Tests/Core/Aggregation.BoundedTests/Application.AgregationTests.csproj

Warnings are errors. Test projects use Microsoft Testing Platform with xUnit v3; run them with dotnet run --project <test project>.

Run

The gateway refuses real PLCs without a driver. To run it against the simulated controller, enable simulation mode on the gateway host:

export GatewaySimulationOptions__EnableSimulation=true
dotnet run --project Src/Code/Infrastructure/IndTrace.Communications/IndTrace.Communications.csproj
dotnet run --project Src/Code/Infrastructure/IndTrace.Hub/IndTrace.Hub.Server.csproj
dotnet run --project Src/Code/Presentation/IndTrace.Monitor/IndTrace.Monitor.csproj

Connection strings live in each host's appsettings*.json and can be overridden with environment variables (ConnectionStrings__IndTraceDbContext, ConnectionStrings__IndTraceDbIdentity).

License

Copyright (c) Exxerpro Solutions SA de CV. Licensed under the GNU Affero General Public License v3.0 or later.