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.