Skip to content

Training Course ​

This section turns the repository from a good engineering reference into a guided training course for newcomers.

The goal is not to duplicate every requirement, ADR, or lesson. The goal is to create an opinionated learning path that helps a new engineer:

  • run the app and observe realistic behavior
  • understand the domain model and machine workflow
  • connect design decisions to code structure
  • learn the .NET, WPF, MVVM, async, and architecture techniques used in the repo
  • extend the system safely with or without AI coding tools

Course Shape ​

The training track is designed as four connected layers:

  • Course Narrative modules that teach the system end to end.
  • Scenarios Hands-on operator and debugger exercises that require running the app.
  • Architecture Design explanations with class, state, sequence, and dependency diagrams.
  • Lessons Reusable theory pages on industrial systems, OOP, C#, .NET, async, MVVM, diagnostics, and architecture trade-offs.

Start Here ​

If you are new to the repo, use this reading order:

Core Modules ​

These are the main learner-facing course pages:

Supporting Tracks ​

Use these alongside the core modules:

Course Authoring Docs ​

These pages describe how the course itself is planned and maintained:

Design Rules ​

Every major course page should answer these questions:

  1. Why does this topic matter in a real industrial desktop system?
  2. What should the learner do in the app or read in the code?
  3. Which design trade-offs shaped the current implementation?
  4. Which lessons should the learner study next?

Every major module should aim to include:

  • a clear newcomer-oriented explanation
  • a concrete scenario or walkthrough
  • code references
  • a small ASCII diagram when structure or flow is easier to grasp visually
  • one or more diagram briefs for Draw.io
  • exercises or reflection prompts

Suggested Reading Order ​

The current recommended order is:

  1. system tour and happy path
  2. domain and state model
  3. architecture walkthrough
  4. workflow and async runtime
  5. design patterns and .NET techniques
  6. scenarios and architecture pages as needed
  7. extending the system safely

Quick Paths ​

If you want to run the app first ​

If you want to understand the runtime first ​

If you want to contribute safely ​

Docs-first project memory for AI-assisted implementation.